Splitting Jira applications

Moving or archiving individual projects

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

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


Note

This process requires two separate server licenses.


  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 the needed Jira applications (e.g. Jira Software) on your new server.
    (warning) Please Note:
    • The Jira application 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 application instances. Specify a new Jira application home directory for the Jira application on your new server.
    • Do not connect the two Jira application instances to the same external database instance.
  4. Create an XML backup from your existing Jira server application , 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. See Configuring file attachments for more information.
  7. At this point you should have two Jira application 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 application.
  9. Generate new Server ID for the newly installed Jira application, as described in the article Changing Server ID. This step is needed if you plan to create Application Links between the two instances.
Last modified on Jul 1, 2021

Was this helpful?

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