We had a fun (not really) time upgrading from JIRA 6.4 to 7.3 at our company. So we wanted to share our notes for everyone else in case you are working on the same task.
Big thanks to Sebastien Jacques for documenting all of this for us over the course of a weekend and to Daniel Eads for sending us his notes on the same.
Couple of notes:
- We are using Linux (RHEL 6), I might've missed making a few commands generic instead of the Linux ones.
- We have JSD installed in the same instance, not a separate server/instance.
- This took an ENTIRE weekend to run, Friday night to Sunday night.
- DO NOT SKIP ANY STEPS
- Please make sure you run this in a Staging/Test environment first
Preparation
- Stop JIRA
- Backup the database
- rsync/copy <JIRA_INSTALL> and <JIRA_HOME> to a backup directory (e.g. upgrade-2017)
This is the initial rollback checkpoint.
Upgrade instance to JIRA 7.0.11 and JSD 3.0.11
- Start JIRA
- Upgrade your plugins to the latest supported version
- Restart JIRA and perform a reindex
- In the add-ons administration UI, Enter Safe Mode
- Shutdown JIRA
- Run the JIRA 7.0.11 installer and select upgrade (do not start JIRA at the end)
- chown/update permissions on the <JIRA_INSTALL> directory (check that the <JIRA_HOME> directory still belongs to jira, or the appropriate user account running JIRA)
- Remove the License Storage Plugin (see 'Atlassian Universal Plugin Manager - Plugin License Storage plugin' failed to load.)
- Update <JIRA_HOME>dbconfig.xml with the recommended settings (see Health Check: Database Connection Settings)
- Or wherever your dbconfig.xml file is located
- Update any changed/added files.
- IE your oracle DB driver or any specific settings.
- Start JIRA
- Exit safe mode, don't keep changes
- Update and enable plugins one by one
- Uninstall JSD 2.5.9 (Keep config)
- Restart JIRA
- Re-index
- Install JSD 3.0.11 by uploading the obr to the Application page.
- You can download the obr on Atlassians website by going to download JSD, select "All server Versions", and then select "Already have JIRA Software or Core?"
- Verify everything is working at this point. If things don't look correct you might need to restore your backups and try again.
Backup
- Stop JIRA
- Backup the database
- rsync/copy <JIRA_INSTALL> and <JIRA_HOME> to a backup directory (e.g. upgrade-2017_2)
This is the JIRA 7.0 rollback checkpoint.
Upgrade instance to JIRA 7.3.3 and JSD 3.4.0
- Start JIRA
- Uninstall JSD 3.0.11 (Keep config)
- In the add-ons administration UI, Enter Safe Mode
- Shutdown JIRA
- Run the JIRA 7.3.3 installer and select upgrade (do not start JIRA at the end)
- chown/update permissions on the <JIRA_INSTALL> directory (check that the <JIRA_HOME> directory still belongs to jira, or the appropriate user account running JIRA)
- Update any changed/added files.
- IE your oracle DB driver or any specific settings.
- Start JIRA
- Exit safe mode, don't keep changes
- Update and enable plugins one by one
- Restart JIRA
- Re-index
- Install JSD <latest supported> by uploading the obr to the Application page.
- You can download the obr on Atlassians website by going to download JSD, select "All server Versions", and then select "Already have JIRA Software or Core?"
9 comments