Clustering for High Availability

Clustering for High Availability

Liferay DXP can scale to serve everything from the smallest to the largest web sites. Out-of-the-box, it’s configured optimally for a single server environment. If you expect to have high traffic or want to improve the overall fault tolerance of your site, consider clustering DXP.

Liferay DXP is designed to scale to as large an installation as you need.

Liferay DXP works well in clusters of multiple machines (horizontal cluster) or in clusters of multiple VMs on a single machine (vertical cluster), or any combination.

Clustering Requirements

Here is what’s required to create an effectively functional DXP cluster.

  1. Liferay DXP installed on separate application server nodes

  2. A database or database cluster that’s accessible to all nodes

  3. A File Store that’s accessible to all nodes

  4. A search engine (running outside of DXP) that is optionally clustered

  5. Cluster Link configured to enable communication and cache replication across all nodes


To ensure there are no concurrency issues and that the master node is selected correctly, start your nodes sequentially.

After you’ve configured your DXP cluster, you can deploy applications to it and continue improving user experiences. Please see Maintaining Clustered Installations for more information.

What’s Next

Creating a cluster by way of example is a great first step in understanding DXP clustering. Start with Example: Creating a Simple DXP Cluster to learn more. Then address the Clustering Requirements listed above.


This documentation describes DXP-specific cluster configuration without getting into specific implementations of third party software, such as Java EE application servers, HTTP servers, and load balancers. Please consult the documentation for those components to configure them. Before creating a DXP cluster, make sure your OS is not defining the hostname of your system to the local network at