Atlassian Confluence Cluster in the Cloud

| September 19, 2013

You can easily run Atlassian Confluence in a clustered environment instead of a single server in the cloud, so that clients can connect to any copy and see the same information. Such a clustered configuration provides scaling under the load, i.e. a single installation of Confluence cluster serves a much greater number of concurrent requests than a single server. It greatly improves performance for organizations that demand higher availability or have a large number of concurrent users.

But don't confuse Confluence’s clustering ability with High Availability (HA). HA means that your application will be available, without interruption. In this case,  if any given node or few nodes are shut down, the rest of the cluster will continue operating normally as long as at least one node remains. Confluence clustering isn't designed to solve this problem. It provides a certain amount of resilience, and ensures if one node is shutdown, it won't bring the other(s) down.

Atlassian Confluence Clustering

We’ll show how to configure a clustering system in a cloud environment shortly!

Create environment

1. Go to our site and log in with your Jelastic credentials. Then click the Create environment button to set up your environment in Jelastic.

2.  Select two Tomcat 7 application servers, pick MySQL (or PostgreSQL) as the database you want to use. Specify the resource amount for each node and type in the environment name.

Atlassian Confluence Cluster Environment

In a few minutes your environment will be created.

Deploy application

1. Navigate to Confluence download and download Confluence x.x.x Cluster - EAR/WAR (ZIP Archive). We recommend to use version 5.3 (OnDemand release) or higher.

2. Extract the files from the package you've just downloaded and create the WAR package from the Confluence folder contents (just put the contents of the Confluence folder in another zip archive file, for example, and rename it to confluence.war or any name with the .war extension).

3. Upload the created WAR file to any online file storage system that you want because it is too big for Jelastic’s Deployment manager.

4. Go back to the Jelastic dashboard and upload the WAR file to Deployment manager via URL.

Atlassian Confluence Cluster Upload

5. Once it is uploaded,  deploy your application to the clustered environment you've created earlier.

Confluence Cluster Deployment

6. Click on the Config button for Tomcat and create a new folder in the Home directory. Let's name it data.

Atlassian Confluence Cluster Data Directory

7. Navigate to file (webapps/ROOT/WEB-INF/classes/) and define the path to the folder you have just created.

Confluenceс Cluster Data Directory Path

Configure database

1. Click Open in browser button for MySQL and log in using the credentials which Jelastic has sent you while creating the environment.

2. Create a new user and the database. Let's name it confluence.

Atlassian Confluence Cluster Database

3. Go back to the Jelastic dashboard and click Config button for Tomcat.

4. Upload MySQL connector to the lib directory.

Confluence Database Configuration

5. Restart your Tomcat servers in order to apply new settings.

Install Atlassian Confluence cluster

1. Open the application in a web browser.

2. In the Confluence setup wizard window, enter the license key and click on Cluster installation.

Confluence Cluster License Key
Note: Don't  try to generate the evaluation key online, it's not suitable for cluster installation. Buy the clustered license or contact Atlassian support to get Clustered Confluence Evaluation for testing.

2. Enter your cluster name.

3. Configure your external database by choosing direct JDBC connection.

Confluence Cluster Database Connection

We recommend to use the next database URL format:


4. Complete the last two steps of the installation: Load content and Configure user management.

Confluence Cluster Setup Complete

5. Log in and you can start using your Confluence cluster right in the cloud.

Confluence Cluster Dashboard

As you can see, the Jelastic Cloud PaaS is a perfect solution for your Atlassian Confluence cluster hosting. Just give it a try!

Related articles: