Installs/Configures Atlassian Jira.

• RedHat 6.3

• MySQL
• Postgres

Opscode Cookbooks (http://github.com/opscode-cookbooks/)

• apache2 (if using Apache 2 as proxy)
• database
• java
• mysql (if using MySQL database)
• postgresql (if using Postgres database)

Third-Party Cookbooks

• mysql_connector (if using MySQL database): https://github.com/bflad/chef-mysql_connector

• node['jira']['version'] - Jira version to install (use recipe[jira::upgrade] to upgrade to version defined)
• node['jira']['url'] - URL for Jira installer .bin
• node['jira']['checksum'] - SHA256 checksum for Jira installer .tar.gz
• node['jira']['backup_home'] - backup home directory during upgrade, defaults to true
• node['jira']['backup_install'] - backup install directory during upgrade, defaults to true
• node['jira']['install_backup'] - location of install directory backup during upgrade
• node['jira']['install_path'] - location to install Jira, defaults to /opt/atlassian/jira
• node['jira']['home_backup'] - location of home directory backup during upgrade
• node['jira']['home_path'] - home directory for Jira data, defaults to /var/atlassian/application-data/jira

• node['jira']['jvm']['minimum_memory'] - defaults to "256m"
• node['jira']['jvm']['maximum_memory'] - defaults to "768m"
• node['jira']['jvm']['maximum_permgen'] - defaults to "256m"
• node['jira']['jvm']['java_opts'] - additional JAVA_OPTS to be passed to Jira JVM during startup
• node['jira']['jvm']['support_args'] - additional JAVA_OPTS recommended by Atlassian support for Jira JVM during startup

• node['jira']['tomcat']['port'] - port to run Tomcat HTTP, defaults to 8080
• node['jira']['tomcat']['ssl_port'] - port to run Tomcat HTTPS, defaults to 8443

• recipe[jira] Installs Atlassian Jira with built-in Tomcat
• recipe[jira::apache2] Installs above with Apache 2 proxy (ports 80/443)
• recipe[jira::upgrade] Upgrades Atlassian Jira

Create a jira/jira encrypted data bag with the following information per Chef environment:

required:

• ['database']['type'] - "mysql" or "postgresql"
• ['database']['host'] - FQDN or "localhost" (localhost automatically installs ['database']['type'] server)
• ['database']['name'] - Name of Jira database
• ['database']['user'] - Jira database username
• ['database']['password'] - Jira database username password

optional:

• ['database']['port'] - Database port, defaults to standard database port for ['database']['type']
• ['tomcat']['keyAlias'] - Tomcat HTTPS Java Keystore keyAlias, defaults to self-signed certifcate
• ['tomcat']['keystoreFile'] - Tomcat HTTPS Java Keystore keystoreFile, defaults to self-signed certificate
• ['tomcat']['keystorePass'] - Tomcat HTTPS Java Keystore keystorePass, defaults to self-signed certificate

Repeat for other Chef environments as necessary. Example:

{
  "id": "jira"
  "development": {
    "database": {
      "type": "postgresql",
      "host": "localhost",
      "name": "jira",
      "user": "jira",
      "password": "jira_db_password",
    },
    "tomcat": {
      "keyAlias": "not_tomcat",
      "keystoreFile": "/etc/pki/java/wildcard_cert.jks",
      "keystorePass": "not_changeit"
    }
  }
}

• Create required encrypted data bag
• Add recipe[jira] to your run_list.

PLEASE NOTE: Due to how Jira handles the setup process, you might still be asked for database information when initially setting up the server. I submitted STASH-2687 to fix this.

• Create required encrypted data bag
• Add recipe[jira::apache2] to your run_list.

• Update node['jira']['version'] and node['jira']['checksum'] attributes
• Add recipe[jira::upgrade] to your run_list, such as: knife node run_list add NODE_NAME "recipe[jira::upgrade]" It will automatically remove itself from the run_list after completion.

Please use standard Github issues/pull requests.

Author:: Brian Flad ([email protected])

Copyright:: 2012

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.