Confluence : Confluence Cluster Installation with Existing Data
This page last changed on Dec 29, 2006 by mryall.
OverviewThere are two methods of installing Confluence in a cluster, depending on whether you have existing data. This page describes how to upgrade an existing Confluence instance into a cluster. See also Cluster installation without existing data. Cluster installation from an existing copy of ConfluenceTo upgrade an existing copy of Confluence to run in a two-node cluster, you must do the following:
Each of these steps will be described in detail below. 1. Clustering requirementsYour Confluence cluster installation must meet all the following criteria for clustering:
Clustered licenses are available through the Confluence website. A cluster can run using two copies of Confluence Standalone. However, cluster administrators must understand how to configure an application server and web server with load balancing, so we recommend you are comfortable installing Confluence as a EAR/WAR in your application server before proceeding with a clustered installation. You can follow the instructions to Migrate Confluence to an external database. 2. Upgrade existing instance to clustered licenseOnce you've obtained your clustered license from Atlassian, you can simply update the license in your running Confluence instance:
When you enter a clustered license, you will see a new line appear on this page: Licensed Clustered Nodes. This tells you how many nodes your Confluence license will allow.
3. Enable clustering and select a cluster nameWhen you change Confluence to use a cluster license, a new menu option will be revealed on the left: Cluster Configuration. Open this menu item to configure your cluster. On this page, you need to enter a name for your cluster, and possibly select which network interface on your server will be used for the cluster (only if you have more than one suitable interface). Clicking 'Start cluster' will migrate your attachments to the database, then prevent any access to Confluence until it is restarted.
4. Copy Confluence to second nodeFor the remaining steps in setting up a cluster with existing data, please continue from step 4 in the normal Confluence cluster installation guide. 5. Start Confluence on the first node, wait, then start Confluence on second nodeSee comment in step 4. 6. Test cluster connectivitySee comment in step 4. 7. Configure load balancerSee comment in step 4. TroubleshootingIf you have problems with the above procedure, please see our Cluster Troubleshooting guide. Upgrading a clusterIt is important that upgrades follow the procedure for Upgrading a Confluence Cluster. Related documentationConfluence Cluster Installation |
![]() |
Document generated by Confluence on May 01, 2007 19:28 |