Upgrading JIRA from 6.x to 7.x

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:

  1. We are using Linux (RHEL 6), I might've missed making a few commands generic instead of the Linux ones.
  2. We have JSD installed in the same instance, not a separate server/instance.
  3. This took an ENTIRE weekend to run, Friday night to Sunday night.
  4. DO NOT SKIP ANY STEPS
  5. Please make sure you run this in a Staging/Test environment first

Preparation

  1. Stop JIRA
  2. Backup the database
  3. 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

  1. Start JIRA
  2. Upgrade your plugins to the latest supported version
  3. Restart JIRA and perform a reindex
  4. In the add-ons administration UI, Enter Safe Mode
  5. Shutdown JIRA
  6. Run the JIRA 7.0.11 installer and select upgrade (do not start JIRA at the end)
  7. chown/update permissions on the <JIRA_INSTALL> directory (check that the <JIRA_HOMEdirectory still belongs to jira, or the appropriate user account running JIRA)
  8. Remove the License Storage Plugin (see 'Atlassian Universal Plugin Manager - Plugin License Storage plugin' failed to load.)
  9. Update <JIRA_HOME>dbconfig.xml with the recommended settings (see Health Check: Database Connection Settings)
    1. Or wherever your dbconfig.xml file is located
  10. Update any changed/added files.
    1. IE your oracle DB driver or any specific settings.
  11. Start JIRA
  12. Exit safe mode, don't keep changes
  13. Update and enable plugins one by one
  14. Uninstall JSD 2.5.9 (Keep config)
  15. Restart JIRA
  16. Re-index
  17. Install JSD 3.0.11 by uploading the obr to the Application page.
    1. 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?"
  18. Verify everything is working at this point. If things don't look correct you might need to restore your backups and try again. 

Backup

  1. Stop JIRA
  2. Backup the database
  3. 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

  1. Start JIRA
  2. Uninstall JSD 3.0.11 (Keep config)
  3. In the add-ons administration UI, Enter Safe Mode
  4. Shutdown JIRA
  5. Run the JIRA 7.3.3 installer and select upgrade (do not start JIRA at the end)
  6. chown/update permissions on the <JIRA_INSTALL> directory (check that the <JIRA_HOMEdirectory still belongs to jira, or the appropriate user account running JIRA)
  7. Update any changed/added files.
    1. IE your oracle DB driver or any specific settings.
  8. Start JIRA
  9. Exit safe mode, don't keep changes
  10. Update and enable plugins one by one
  11. Restart JIRA
  12. Re-index
  13. Install JSD <latest supported> by uploading the obr to the Application page.
    1. 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

Word of warning... Please make sure you run this in a Staging/Test environment first. Wish i would've added this in the Notes section at the top of the article.

@Brian, you should be able to edit this to add the info -- the three dots at the bottom of the post.  Also, would you be willing to add an image of some type? Makes it possible to feature :)

Thanks @Monique! not sure how i missed that.

No problem -- on discussions and questions the edit dots are at the top of the post -- a minor UX inconsistency that we will eventually fix but for now... that's probably why you missed it :)

I am seeing a problem where Jira fails to start (Jira Locked) due to Addons not starting.  I think the step of putting Jira into Safe Mode causes this.  In my case - the DB for Addons needs to be set to 'enable' per:

https://confluence.atlassian.com/jirakb/jira-application-does-not-start-due-to-disabled-bundled-plugin-254738702.html

If I skip the put into Safe Mode step, the upgrade script seems run OK, and Jira will start post upgrade.  YMMV, just hope that helps as the fix is a bit tedious.

Another nice thing to do before upgrading is to run the Integrity Checker and fix any error that it finds

Hi, all. I have already reached to 11 item, after the start of jira, in catalina.out the following error:

localhost-startStop-1 ERROR [o.a.c.c.C. [Catalina]. [localhost]. [/]] Error configuring application listener of class com.atlassian.jira.soap.axis.JiraAxisHttpListener.

 I read on the forum that you need to check the version 2 plug-ins in <JIRA_Installation_Home> / atlassian-jira / WEB-INF / lib directory. If there, move them to <jira-home> / installed-plugins.
I can not understand how to determine the version of the plugin in the console. Or where can be an error?

Great post, thank you @Brian Jones!

Two things to add:

  • Check your DB compatibility with JIRA 7.x
    e.g. for MySQL you would need v5.6 newer
  • You might need to update any scripts that you have in your installation
    e.g. due to API changes, etc.

@Yuriy

I hope you managed to fix your error, apologies for not seeing this earlier. If not, do you have anymore more context from that log file? I see a few fixes that could apply to the error you are seeing, but need to see the entire error rather than just that one line.

 

@Ioannis Drositis

Thanks! Always good to check the Supported Platforms before an upgrade to make sure your current infrastructure is supported. 

Comment

Log in or Sign up to comment
Community showcase
Published Aug 21, 2018 in Agile

What's new this quarter in Confluence Server - August 2018

Hello Atlassian Community! My name is Ada , and I'm the Product Marketing Manager for Confluence Server at Atlassian. If you missed   our last post, we're transitioning to quarterly updates&nb...

164 views 0 1
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you