Migrate from Server to Data Center

This page outlines the process for upgrading an existing Confluence Server site to Confluence Data Center.

If you're installing Confluence for the first time (you don't have any existing Confluence data to migrate), see Installing Confluence Data Center.

On this page:

Before you begin

Things you should know about when setting up your Data Center:

License

Your Confluence license determines the type of Confluence you have: Server or Data Center. Confluence will auto-detect the license type when you enter your license key, and automatically unlock any license-specific features.

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 Confluence Data Center you must:

If you plan to run Confluence Data Center in a cluster there are some additional infrastructure requirements. See Clustering with Confluence Data Center for more information.

There’s a known issue during setup where a load balancer (or proxy) pings the server and breaks Confluence installation or migration to Data Center. See CONFSERVER-61189 - Getting issue details... STATUS
During installation, you need to disable load balancer health checks and make sure you don’t open multiple tabs that point to the same Confluence URL.

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 Confluence Data Center license key. Learn more about Upgrading Server apps when you migrate to Data Center.

Upgrade your Confluence license

To move from Confluence Server to Confluence Data Center:

  1. Go to  > General Configuration
  2. Choose License Details from the sidebar under the Administration heading
  3. Enter your Confluence Data Center license key. 

There's no need to restart Confluence. Data Center features such as read-only mode, SAML single sign-on, and CDN will now be available. 

Set up your cluster

If your organisation requires continuous uptime, scalability, and performance under heavy load, you'll want to run Confluence Data Center in a cluster.

To find out more about clustering, including infrastructure requirements see Clustering with Confluence Data Center

If you're ready to set up your cluster now, head to Set up a Confluence Data Center cluster.  

Last modified on Apr 20, 2021

Was this helpful?

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