Moving to Jira Data Center
This page outlines the process for migrating an existing Jira Server instance to Jira Data Center.
If you're installing Jira for the first time (you don't have any existing Jira data to migrate), see Installing Jira Data Center.
Before you begin
Things you should know about when setting up your Data Center:
It’s your Jira license that determines the type of Jira you have: Server or Data Center. Jira will auto-detect the license type when you enter your license key, and automatically unlock any license-specific features.
See our Supported platforms page for information on the database, Java, and operating systems you'll be able to use. These requirements are the same for Server and Data Center deployments.
Apps extend what your team can do with Atlassian applications, so it's important to make sure that your team can still use their apps after migrating to Data Center. When you switch to Data Center, you'll be required to switch to the Data Center compatible version of your apps, if one is available.
See Evaluate apps for Data Center migration for more information.
To use Jira Data Center, you must:
Use a supported external database, operating system and Java version
Use OAuth authentication if you have application links to other Atlassian products (such as Confluence)
To run Jira in a cluster, you must also:
Use a load balancer with session affinity and WebSockets support in front of the Jira cluster. Load balancer examples
Have a shared directory accessible to all cluster nodes in the same path (this will be your shared home directory). This must be a separate directory, and not located within the local home or install directory.
Move from Jira Server to Data Center
To move from Jira Server to Jira Data Center:
- Go to > Applications > Versions and licenses.
- Enter your Jira Data Center license key.
- Restart Jira.
Data Center features such as project and issue archiving, rate limiting, and SAML single sign-on will now be available.
Can't update the license?
Your Data Center license must match the one you used for Server. For example, if your Server license included Jira Software and Jira Service Desk, but the new one has Jira Software only, you won't be able to update it and will most likely see the following error:
If you're looking to just evaluate Data Center or change the products in your license, you can work around it by first switching to an evaluation Server license (for example, Jira Software license, which will remove licenses for other products) and then using the Data Center license.
Set up your cluster
If your organization requires continuous uptime, scalability, and performance under heavy load, you’ll want to run Jira Data Center in a cluster.
To find out more about clustering, including infrastructure requirements, see Running Jira Data Center in a cluster.
If you’re ready to set up your cluster now, head to Set up a Jira Data Center cluster.