cookbook 'openfire', '~> 0.2.0'
openfire (1) Versions 0.2.0 Follow4
Installs Openfire Jabber server
cookbook 'openfire', '~> 0.2.0', :supermarket
knife supermarket install openfire
knife supermarket download openfire
Description
Install the Openfire Jabber server from source.
Requirements
The following Chef cookbooks should be installed:
- java
- database
- postgresql
Supported Platforms
- CentOS, Red Hat
- Ubuntu (likely, but untested)
Database
This should still work using the built-in OpenFire database instead of using PostGreSQL. However this needs to be tested.
Attributes
All attributes are optional
Version
-
node[:openfire][:source_tarball]: currently defaults toopenfire_3_8_1.tar.gz- This tarball will automatically be downloaded and installed
Installation
-
node[:openfire][:user]: the local user account to create and use to run the openfire process; defaults toopenfire- also see
node[:openfire][:group], which also defaults toopenfire
- also see
-
node[:openfire][:base_dir]: the location on the file system to install openfire -
node[:openfire][:config][:admin_console][:port]: Use your web browser to connect to this port while you are first setting up openfire. Defaults to 9090. -
node[:openfire][:config][:admin_console][:secure_port]: Use your web browser to connect to this port after you have set up openfire for further configuration. This will require an https/SSL connection. Defaults to 9091. -
node[:openfire][:config][:locale]: Defaults toen. -
node[:openfire][:config][:network][:interface]: Defaults tonil(listen on all interfaces).
Database
-
node[:openfire][:database][:type]: currently only works with 'postgresql'. If you want to use the built-in database (untested), do not set this. -
node[:openfire][:database][:password]: the database password for the Openfire user (required if database type is specified) -
node[:openfire][:database][:name]: defaultopenfire- also see
[:database][:user],[:database][:host],[:database][:port], which have sane defaults
- also see
Usage
- Optionally set the attributes mentioned in the
Attributessection. - Add this to your node's run list:
recipe[openfire], then run Chef. - Startup configuration is in the file
/etc/openfire/openfire.xml - Java certificates are in the
/etc/openfire/securitydirectory.
New Installation
If you are configuring a new installation of Openfire, use your web browser to connect to your host, port 9091 (or whatever port you chose for node[:openfire][:config][:admin_console][:port] above). Run through the "wizard", and accept all defaults.
Import
If you are importing an existing installation of Openfire:
- Optionally import the database
- Within
/etc/openfire/openfire.xml, right before the line</jive>, add the following:<setup>true</setup>.
Upgrading
This cookbook is not yet capable of automatically handling upgrades. To upgrade, follow the official instructions.
Download and untar into /opt/openfire. Then set symbolic links:
* ln -s /etc/openfire /opt/openfire/conf
* ln -s /var/log/openfire /opt/openfire/logs
* ln -s /etc/openfire/security /opt/openfire/resources/security
Also copy your plugins:
* rsync -av /opt/openfire_old/plugins/ /opt/openfire/plugins/
Dependent cookbooks
| java >= 0.0.0 |
| database >= 0.0.0 |
| postgresql >= 0.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
Collaborator Number Metric
0.2.0 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
0.2.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
0.2.0 failed this metric
FC064: Ensure issues_url is set in metadata: openfire/metadata.rb:1
FC065: Ensure source_url is set in metadata: openfire/metadata.rb:1
FC066: Ensure chef_version is set in metadata: openfire/metadata.rb:1
FC069: Ensure standardized license defined in metadata: openfire/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
0.2.0 passed this metric
Testing File Metric
0.2.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
0.2.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
0.2.0 failed this metric
0.2.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
0.2.0 failed this metric
FC064: Ensure issues_url is set in metadata: openfire/metadata.rb:1
FC065: Ensure source_url is set in metadata: openfire/metadata.rb:1
FC066: Ensure chef_version is set in metadata: openfire/metadata.rb:1
FC069: Ensure standardized license defined in metadata: openfire/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
0.2.0 passed this metric
Testing File Metric
0.2.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
0.2.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
0.2.0 failed this metric
FC065: Ensure source_url is set in metadata: openfire/metadata.rb:1
FC066: Ensure chef_version is set in metadata: openfire/metadata.rb:1
FC069: Ensure standardized license defined in metadata: openfire/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
0.2.0 passed this metric
Testing File Metric
0.2.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
0.2.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
0.2.0 failed this metric
0.2.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number