Jira recipe

Install or upgrade Atlassian Jira with the binary installer on Linux.

This instruction assumes that Jira is installed in /opt/jira and the data directory is /var/jira. The installation is on Ubuntu Linux but should also work on other flavours of Linux. Jira requires a supported database, in this instruction I assume that the database is already configured.

Preparation

Check if the requirements in the supported platforms are met.

Please read the release notes, adjust the version number in the URL.

Download binary Jira installer from Atlassian (replace the JIRA version with the required one). Go to the Jira download page to find the correct version.

cd /opt/download
curl -vvkL https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-software-M.m.p-x64.bin > atlassian-jira-software-M.m.p-x64.bin
# M = major version
# m = minor version
# p = patch level
# e.g. 7.5.3
chmod u+x atlassian-jira-software-M.m.p-x64.bin

/opt needs at least 800M of free space, clean-up or extend filesystem

Perform these steps

If on a virtual host, take a snapshot of VM
If upgrading, check if last backup was succesfull ls -l /var/pgbackup
In the Add-ons section upgrade all plugins
Then do the Jira upgrade test
Perform a reindex
Run an integrity check

Upgrade / Install

cd /opt
./download/atlassian-jira-software-M.m.p-x64.bin

Press o for OK
if new, install choose 2 for Custom Installl; if upgrade, choose 3 Upgrade an existing JIRA installation
installation directory is /opt/jira
if upgrade, answer n to ‘Back up JIRA home diretory’
if upgrade and modified files were found, copy modified files to /var/tmp
if upgrade, press u; if new install press i
choose n on Start JIRA Software M.m.p now?

If JIRA is started at the end of the installation, please shutdown via /opt/jira/bin/shutdown.sh.

If installation is not in the desired location move installation from /opt/atlassian/jira/ to /opt/jira.

Postinstall

check if the file and directory permission are correct
check /etc/init/jira.conf or /etc/init.d/jira to ensure JIRA is run as user JIRA
check the settings in /opt/jira/bin/setenv.sh (check with saved file from previous version). For SDMC add the required JAVA Arguments.
edit /opt/jira/conf/server.xml enable AJP (Uncomment the AJP connector on port 8009)
only if exists (JIRA 5 / 6) edit /opt/jira/bin/permgen.sh (No longer applicable , we can Skip this step)
disable password autocompletion
start JIRA and monitor the log file with tail -f /var/jira/log/atlassian-jira.log

Finalizing

check Add-ons for possible updates and execute the updates.
perform a re-index. (System Advanced)
do a integrity check. (System Troubleshooting and support)
run the support tool and check any issues. (System Troubleshooting and support)
if new install, add the machine to your backup routine.