Upgrading Confluence Data Center

This page contains instructions for upgrading an existing Confluence cluster.

If you are not running Confluence in a cluster, follow the instructions in Upgrading Confluence.

If you're running Confluence in a cluster in AWS, follow the instructions in Running Confluence Data Center in AWS.

If you are upgrading to the next bug fix update (for example, 7.9.0 to 7.9.3), you can do so with no downtime. Follow the instructions in Upgrade Confluence without downtime.

Error rendering macro 'excerpt-include'

User 'null' does not have permission to view the page.

Currently using Confluence Server? Learn more about the benefits of Confluence Data Center.

On this page:

Error rendering macro 'excerpt-include'

User 'null' does not have permission to view the page.

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.

2. Download Confluence

Download the appropriate file for your operating system from https://www.atlassian.com/software/confluence/download

3. 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.

4. Upgrade the first node

To upgrade the first node:

Unable to render {include} The included page could not be found.

You should now stop Confluence, and reapply any additional customizations from the old version to the new version, before upgrading the remaining nodes.

5. Upgrade Synchrony (optional)

Unable to render {include} The included page could not be found.

6. Copy Confluence to remaining nodes

The next step is to replicate your upgraded Confluence directories to other nodes in the cluster.  

Unable to render {include} The included page could not be found.

Stop Confluence on this node, then repeat this process for each remaining node. 

7. 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 (starting up multiple nodes simultaneously can lead to serious failures).

The Cluster monitoring console (

Error rendering macro 'excerpt-include'

User 'null' does not have permission to view the page.

> Clustering) includes information about the active cluster nodes. When the cluster is running properly, you should be able to see the details of each node. 

Last modified on Feb 4, 2021

Was this helpful?

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