Splitting a JIRA instance

Moving or Archiving Individual Projects

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Occasionally an organisation may need to split its existing JIRA instance into two separate instances. For example, there might be a requirement to have some particular projects in one JIRA instance, and other projects in a second instance.

Note

This process requires two separate server licenses.

To split a JIRA instance:

  1. Back up your database, using your database backup procedures, and verify the backup.
  2. Back up your attachments directory and verify the backup.
  3. Install JIRA on your new server.
    (warning) Please Note:
    • The JIRA version number on your new server must be the same as (or higher than) the version number on your existing server.
    • Do not use the same JIRA Home Directory for the two JIRA instances. Specify a new JIRA home directory for the JIRA on your new server.
    • Do not connect the two JIRA instances to the same external database instance.
  4. Create an XML backup from your existing JIRA server, as described in Backing up data.
  5. Import the XML backup file into your new server, as described in Restoring data.
  6. Copy the attachments directory from your existing server to your new server, and configure your new server to use its own directory (for details please see Enabling File Attachments).
  7. At this point you should have two JIRA instances with the same users, projects, issues and attachments. Log in to both instances and perform some random searches to verify that the data is identical in both instances.
  8. Delete the non-required projects from each JIRA instance.
  9. Generate new Server ID for the newly installed JIRA instance as described in the article Changing Server ID. This step is needed if you plan to create Application Links between the JIRA instances.
Last modified on Dec 16, 2012

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.