Moving from Data Center to Server
This page outlines how to switch from a clustered Confluence Data Center deployment to a Confluence Server deployment. In these instructions we'll assume that you'll use one of your existing cluster nodes as your new, non-clustered installation.
The steps involved will depend on whether you're running Confluence in a cluster.
If you no longer need clustering, but still want access to Data Center features, we recommend you can go back to a non-clustered (standalone) Data Center installation. See Moving to a standalone Data Center installation
Requirements
- You need a Confluence Server license to switch back to Server.
- Read-only mode must be turned off before you apply your Server license.
Move from non-clustered Data Center to Server
If you are not running Confluence in a cluster, all you need to do is update your license to switch to Confluence Server. Not sure? Go to > General Configuration > Clustering. If you see your cluster nodes listed, then Confluence is running in a cluster.
- Make sure read-only mode is turned off.
- Go to > General Configuration> General Configuration
- Choose License Details from the sidebar under the Administration heading
- Enter your Confluence Server license key.
There's no need to restart Confluence. Data Center specific features such as read-only mode, SAML single sign-on, and CDN will no longer be available.
How will the Data Center-only features be affected?
After changing from Data Center to Server, you’ll lose any features exclusive to Data Center. Here’s a summary of how this will affect your current Confluence site:
Feature | Result |
---|---|
No longer available What happens:
| |
No longer available What happens:
| |
No longer available What happens:
| |
No longer available What happens:
| |
No longer available
| |
Audit log | Some coverage levels and areas will not be available.
|
Rolling upgrades | No longer available The rolling upgrades feature will no longer be available. |
Move from clustered Data Center to Server
If you are running Confluence in a cluster, you'll need to make some infrastructure changes as part of the switch.
In these instructions we'll assume that you'll use one of your existing cluster nodes as your new, non-clustered installation. This process applies to any clustered installation, including clusters with just one node.
1. Stop Confluence on all nodes except node 1
First, you must stop Confluence on every node except one, we'll refer to this as node 1. Don't make any other changes at this stage.
Your home directory (configured in confluence\WEB-INF\classes\confluence-init.properties
) should still point to your local home directory.
2. Enter your Confluence Server license
- Go to > General Configuration
- Choose License Details from the sidebar under the Administration heading
- Enter your Confluence Server license key
2. Stop Confluence on node 1
Stop Confluence on node 1. Confluence should not be running on any nodes.
At this point we also recommend configuring your load balancer to redirect traffic away from Confluence, as Confluence will not be accessible until you complete the migration.
3. Move items in the cluster shared home back to local home
- Create a directory called
/shared-home
in the<local home>
directory on one node (if you removed this directory when installing Data Center) - Move the following directories and files from your
<shared home>
directory to the <local home>/shared-home
directory- config
- confluence.cfg.xml
- dcl-document
- dcl-document_hd
- dcl-thumbnail
- Move the remaining contents of your
<shared home>
directory to the root of your<local home>
directory
Your cluster's shared home directory should now be empty.
Make sure you don't accidentally overwrite the confluence.cfg.xml
in your local home directory. The confluence.cfg.xml
file from your shared home directory doesn't contain the same parameters as the one in your local home directory.
4. Start Confluence
Start Confluence. The setup wizard will prompt you to start the migration process.
Once migration is complete, you can make any changes to your load balancer or proxy to allow people to access Confluence again.
To confirm you're now running the non-clustered edition, go to > General Configuration. The 'Cluster Configuration' page should not appear. Instead you'll see information about Confluence Data Center.