Upgrading Confluence Data Center
This page contains instructions for upgrading an existing Confluence cluster.
If you are not yet running a clustered instance of Confluence, see Moving to Confluence Data Center.
In this guide we'll use the following terminology:
- installation directory - this is the directory where you installed Confluence on each node.
- local home directory - this is the home or data directory on each node (in non-clustered Confluence this is simply known as the home directory).
- shared home directory - this is a directory that is accessible to all nodes in the cluster via the same path. If you're upgrading from Confluence 5.4 or earlier you'll create this directory as part of the upgrade.
On this page:
Before you start
- Check your Confluence licence is valid.
To check go to > General Configuration > Atlassian Support Tools > Health Check and make sure the license support period has not expired. If your support period has expired renew your licence and reapply it before proceeding with the upgrade.
- Read the Release Notes and Upgrade Notes for both the version you are upgrading to, and any versions you are skipping.
- Check that your Java version, application server, operating system, database and browsers are supported.
See Supported Platforms and End of Support Announcements for Confluence to confirm latest requirements.
- Check the latest database setup guide for your database and ensure that the database is configured correctly. There may be new configuration requirements. See Database Configuration.
- Check the compatibility of any add-ons.
Some add-ons may not yet be compatible with the latest version of Confluence. See Checking add-on compatibility with application updates to find out how to check this in the Universal Plugin Manager.
- Check for any known issues that might affect your instance.
See the Confluence Knowledge Base for known issues for the version you are upgrading to and Database Troubleshooting for known issues related to supported external databases.
- Make a note of any modifications to your Confluence instance (for example layouts or a custom theme).
Any customisation you wish to maintain will need to be reapplied after upgrading. See Additional steps where customisations are present.
Step 1 Back up
We strongly recommend that you backup your Confluence home and install directories and your database before proceeding.
More information on specific files and directories to backup can be found in Upgrading Confluence.
Step 2 Stop the cluster
You must stop all the nodes in the cluster before upgrading.
We recommend configuring your load balancer to redirect traffic away from Confluence until the upgrade is complete on all nodes.
Step 3 Create a shared home directory
If you are upgrading an existing Confluence Data Center instance (Confluence 5.6 or later), you can skip this step, as you already have a Shared Home directory.
To set up your Shared Home directory:
- Create a directory that is accessible to all cluster nodes via the same path. This will be your shared home directory.
confluence.cfg.xmlin the home directory on the first node and add a new property called
confluence.cluster.homewith the path of the shared home directory as the value. Example:
Move all the files/directories from the local home directory the first node to the new shared home directory except for the following:
Remove the moved files/directories from the local home directories on all other nodes.
Step 4 Upgrade the first node
To upgrade the first node:
- Extract (unzip) the files to a directory (this will be your new installation directory, and must be different to your existing installation directory)
- Update the following line in the
<Installation-Directory>\confluence\WEB-INF\classes\confluence-init.propertiesfile to point to the existing local home directory on that node.
- Copy the jdbc driver jar file from your existing Confluence installation directory to
confluence/WEB-INF/libin your new installation directory.
The jdbc driver will be located in either the
- Copy any other immediately required customisations from the old version to the new one (for example if you are not running Confluence on the default ports or if you manage users externally, you'll need to update / copy the relevant files - find out more in Upgrading Confluence Manually)
- Start Confluence, and and confirm that you can log in and view pages before continuing to the next step.
You should now reapply any additional customisations from the old version to the new version, before upgrading the remaining nodes.
Step 5 Upgrade the other nodes
To upgrade the next node in your cluster:
- Stop Confluence on the first node.
- Copy the installation directory and home directory from the first node to the next node.
If the path to the local home directory is different on this node, edit the
confluence-init.propertiesto point to the correct location.
- Start Confluence, and and confirm that you can log in and view pages before continuing with the next node.
Repeat this process for each remaining node.
Step 6 Start Confluence and check cluster connectivity
Once all nodes have been upgraded you can start Confluence Data Center on each node, one at a time.
The Cluster Administration page ( > General Configuration > Cluster Configuration) includes information about the active cluster. When the cluster is running properly, this page displays:
- a correct count of the nodes in the cluster
- a status display for each node in the cluster
- uptime for each node.
Was this helpful?
Thanks for your feedback!