Documentation for JIRA 4.2. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata

JIRA data can be migrated between databases or database servers.

Migrating to a new Database

  1. Create an export of your data as an XML backup (see Backing Up Data). Please note that JIRA's XML backup utility does not back up attachments (if you have attachments enabled). You will need to back up your attachments separately.
  2. Configure your JIRA instance to use the new database, following the steps for your specific database — see Connecting JIRA to a Database for details. When restarted, you should see the JIRA setup screen, indicating a blank database.
  3. On the setup page, click Import your existing data and restore your data from the XML backup (NB: use the default directory for your index).
  4. Once installed, make sure the index, attachment and backup paths are correct. In particular, if you are running more than one JIRA instance on the same server, ensure that each instance uses different paths.

Migrating a Database to a New Server

If you're upgrading to a new version, see Upgrading JIRA. Otherwise, you can use native database tools to migrate to the new database server. After the database is populated, run $JIRA_INSTALL/bin/config.sh (Linux) or %JIRA_INSTALL%/bin/config.bat (Windows). This opens a GUI tool for changing the database URL settings.

If you don't have GUI access or would prefer to do it via the command line, the file is $JIRA_INSTALL/conf/server.xml. Have a look at Connecting JIRA to a Database.