Migrating Jira applications to another server
This document describes how to migrate/upgrade to Jira applications on different server hardware, or in a different server environment that entails one or more of the following:
- a new operating system that will run Jira applications,
- new locations for storing your index and/or attachments, or
- a new database or database system that will store Jira application data.
Migrating Jira to another server
To migrate Jira to a new server or location, you'll need to install a new Jira instance. Once you've completed the installation, you'll migrate your existing data between the databases, and then move your home directory and all existing customizations.
1. Back up
Create an XML backup of your database.
Back up your installation directory and home directory.
As soon as the backup is complete, delete the
<home-directory>/dbconfig.xml
file from the copy of your home directory that you'll be using for the new installation. This will allow you to connect Jira to a new database.
2. Download Jira
Download the zip
or tar.gz
archive – Jira Core or Jira Software.
3. Extract the file and upgrade Jira
- Extract (unzip) the files to a new directory.
- Edit the
<installation-directory>\atlassian-jira\WEB-INF\classes\jira-application.properties
file to point to your existing Jira home directory. Make sure that you deleted thedbconfig.xml
file, otherwise Jira will try to connect to your existing database. - Copy your jdbc driver jar file from your existing Jira installation directory to
jira-atlassian/WEB-INF/lib
in your new installation directory.
- There are some additional steps you may need to take if:
you use Crowd for user management
4. Start Jira and connect it to the database
- Start Jira to launch the setup wizard. Go to
<installation-directory>/bin
, and run thestart-jira.sh
/start-jira.bat
file. - Access Jira through your browser, and choose I'll set it up myself to get access to more setup options.
- Select My own database, and provide details of a new, empty database.
On the next screen, click Import your data, and select the file with your XML backup.
Avoid passing through a proxy when performing an XML restore, especially if your Jira instance is very large. Using a proxy may cause timeout errors.- Follow instructions on the screen to complete the setup.
- Take a quick look around your Jira site to confirm that your projects and issues are present and everything looks normal. You should see the new Jira version number in the page footer.
After the migration
5. Re-apply any modifications
If you have customized Jira (such as an SSL configuration in the server.xml
file, or additional memory allocation in the setenv.sh
/ setenv.bat
file ), you'll need to reapply the customizations to the relevant files in the newly upgraded Jira installation directory.
Troubleshooting
Did something go wrong?
Check the resources on our Support page, or raise an issue so we can help you resolve your problem.
Your existing Jira installation should be intact. You can restart it and resume your work.