Migrate from Server to Data Center

Installing Jira Data Center

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

This page outlines the process for migrating 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:

License

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.

You can purchase a Data Center license or create an evaluation license at my.atlassian.com

Supported platforms

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.

App compatibility

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. 

Requirements

To use Jira Data Center, you must:

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.

Migrate to non-clustered Data Center

Review and upgrade your apps

If you have any apps installed on your site, you'll need to upgrade to the Data Center app version, if one is available. To avoid any impact to your apps, we recommend you do this before you enter your Jira Data Center license key. Lear more about upgrading server apps when you migrate to Data Center.

Upgrade your Jira license

To move from Jira Server to Jira Data Center:

  1. Go to Administration (> Applications > Versions and licenses.
  2. Enter your Jira Data Center license key.
  3. 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 Management, 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.

Looking to migrate all your Atlassian applications to Data Center? We’ve got you covered:

Considering moving to cloud? Plan your cloud migration.

Last modified on Nov 3, 2020

Was this helpful?

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