Migration from JIRA 4.0.1 to 5.1.8

Good day,

We have a JIRA production installation (version 4.0.1) running on linux on a dedicated server running tomcat (6.0.18).

For the moment our Confluence instance is running on the same tomcat.

We want to follow your new requirements and separate our confluence and jira installation.

During this process, we have to upgrade JIRA from 4.0.1 to 5.1.8.

The confluence upgrade will be done later.

What's the safest and fastest procedure tu upgrade this instance as the documentation lists several options.

Do we have to go through an other installation (4.3, 4.4?) or can we proceed the upgrade directly?

Thank you

1 answer

1 accepted

Accepted Answer
0 votes

Here is what I suggest you:

  1. Install JIRA 5.1.8 from scratch (without customize any file), according to this documentation: https://confluence.atlassian.com/display/JIRA/Installing+JIRA+from+an+Archive+File+on+Windows%2C+Linux+or+Solaris
    using a clean HOME and INSTALL directory;
  2. Install the needed plugins;
  3. Shutdown your JIRA 5.1.8 instance;
  4. Copy the attachments directory from the old JIRA home (from 4.0.1) to the new JIRA 5.1.8 home folder (JIRA_HOME/data/attachments);
  5. Create a new XML backup (https://confluence.atlassian.com/display/JIRA040/Backing+Up+Data#BackingUpData-UsingJIRAsXMLbackuputility) in your 4.0.1 instance and copy it to the <JIRA_5.1.8_HOME>/import folder;
  6. If you have a LDAP or other external user management integrated to your instance, copy the osuser.xml file located on <JIRA_4.0.1_INSTALL>/atlassian-jira/WEB-INF/classes folder to the <JIRA_5.1.8_INSTALL>/atlassian-jira/WEB-INF/classes folder;
  7. And if you have Crowd as an user management, you also need to copy the crowd.properties file located on <JIRA_4.0.1_INSTALL>/atlassian-jira/WEB-INF/classes folder to the <JIRA_5.1.8_INSTALL>/atlassian-jira/WEB-INF/classes folder;
  8. Start JIRA 5.1.8;
  9. Restore the XML backup of JIRA 4.0.1 in your new JIRA by going to Administration > System > Import & Export > Restore System;

After that, you will have your JIRA 5.1.8 working like a charm.

Hope that helps.

I tried the direct upgrade with xml import and was stuck at some point. We already use LDAP on 4.0.1 and missed https://confluence.atlassian.com/display/JIRA043/JIRA+4.3+Upgrade+Guide#JIRA4.3UpgradeGuide-WhathappenswhenupgradingtoJIRA4.3 so it didn't work...

Finally it worked for a migration to 5.2

Suggest an answer

Log in or Sign up to answer
Community showcase
Published 2 hours ago in Jira Ops

Jira Ops Early Access Program Update #2: Let’s talk severity levels

Welcome to your weekly Jira Ops Early access program update, where we’re sharing news and updates on Jira Ops' progress as we work toward our 1.0 release. If you ever want to drop us feedback or idea...

13 views 0 0
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