The blog post is a summary of the well-known best practice process for updating Jira software. I created this little step-by-step instruction because I do not do full-time Jira administration, so that helps me each time for installing new updates.
Before you do an upgrade, make sure all used Add-ons are supporting the new Version. Do not upgrade to a new Version to early, because it can end up in some compatibility problems. Give the developers of the third-party software some time for their updates.
Please note: Allways do a Backup of your Jira instances and test the upgrade process in a non-productive environment.
Step 1 – Backup Files:
Before saving the Jira files, its required to stop the service.
1 2 |
cd /opt/atlassian/jira/bin # Path ./stop-jira.sh # stop jira |
Now copy the content from the installation path to a backup folder (You can use WinSCP to connect to the server, and copy the files with SFTP to a secure backup destination.)
1 |
/opt/atlassian/jira/* |
Step 2 – Update System:
Now prepare for the installation and update the system.
1 |
sudo apt-get update && sudo apt-get upgrade |
Step 3 – Download Jira:
Download the Version, you want to upgrade to.
1 |
sudo wget https://downloads.atlassian.com/software/jira/downloads/atlassian-jira-software-7.3.4-x64.bin |
Step 4 – Start Upgrade:
Make the downloaded binary files executable and execute it.
1 2 |
chmod a+x atlassian-jira-software-7.3.4-x64.bin sudo ./atlassian-jira-software-7.3.4-x64.bin |
It will ask you to continue and backup jira.
1 2 3 4 |
OK [o, Enter] Upgrade an existing JIRA installation [3, Enter] Backup Jira Yes [y, Enter] |
After this step the installer shows all changes, please check them all before continuing with the upgrade process!
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
Note down changes: Modified files: atlassian-jira/WEB-INF/classes/templates/email/html/issueresolved.vm atlassian-jira/WEB-INF/classes/templates/email/html/issuecommentedited.vm atlassian-jira/WEB-INF/classes/templates/email/html/issuecommented.vm conf/server.xml conf/context.xml Removed files: (none) Added files: lib/mysql-connector-java-5.1.40-bin.jar config.bat digest.bat service.bat setup_user.sh startup.bat tomcat8.exe.x64 tool-wrapper.sh |
You now will be asked to keep
1 |
Upgrade [u, Enter] |
wait….
That’s it, hopefully it works 🙂