Using Clusters

How to Set Up a Cluster in Communiqué

Clustering uses two or more live servers, so if one server breaks down, the other can take over. Therefore, even if a node fails, the other nodes are active and accessible for your applications and there is no system interruption. This allows you to recover and re-start failed nodes easily. Also, new nodes can be added to an existing cluster, allowing for simple extensibility.

Clustering is beneficial in the following scenarios.

  • A server breaks down – The cluster agent relays requests to the servers that are still running. Service continues without interruption.

  • A repository breaks down – If the repository breaks down, the server becomes unavailable, and the cluster agent relays the requests to the other servers. Service continues without interruption.

  • Increased performance – clustering enables your system to perform better even when nodes fail.

[Note]Note

As long as both servers are active, you can use their combined computational power. This means that this solution improves performance during normal use. On the other hand, if one server breaks down, you lose its performance, so your overall application performance may suffer.

Following section describes how to set up a cluster in Communiqué with two cluster nodes on two separate networked machines.

The master node is called node 1, the slave node is called node 2.

On the node 1 (master):

  1. In the file system, create a folder /node1.

  2. Install Communiqué under /node1. For a complete description of the installation, please refer to the section called “Installing an Author instance”.

  3. In the file system, share the folder node1/crx-quickstart/repository/shared so that it can be accessed from the node 2.

On the node 2 (slave):

  1. In the file system, create a folder /node2.

  2. Install Communiqué under /node2. For a complete description of the installation, please refer to the section called “Installing an Author instance”.

  3. In the file system, map the folder on node 1 node1/crx-quickstart/repository/shared to a drive, Z: in our case.

  4. In your browser, open the CRX Main Console

  5. Browse to http://localhost:4502/crx to open the CRX Main Console.

  6. Log in as administrator.

  7. Click Repository Configuration.

  8. Under Tools, click Cluster.

  9. Under Join Cluster, as Shared path, enter Z:\ and click Join.

[Note]Note

In order to add more nodes to the cluster, repeat the steps on the slave node as many times as needed.