Liferay Portal Clustering

Liferay Portal can serve everything from the smallest to the largest web sites. Out of the box, it’s configured optimally for a single server environment. If one server isn’t sufficient to serve your site’s high traffic needs, Liferay Portal scales to the size you need.


Liferay Portal works well in clusters of multiple machines (horizontal cluster) or in clusters of multiple VMs on a single machine (vertical cluster), or any mixture of the two. Once you have Liferay Portal installed on more than one application server node, there are several optimizations that must be made. At a minimum, Liferay Portal should be configured in the following way for a clustered environment:

  1. All nodes should point to the same database or database cluster.

  2. Documents and Media repositories must have the same configuration and be accessible to all nodes of the cluster.

  3. Search should be on a separate search server that is optionally clustered.

  4. Cluster Link must be enabled so the cache replicates across all nodes of the cluster.

  5. Applications must be auto-deployed to each node individually.

Many of these configuration changes can be made by adding or modifying properties in your file. Remember that this file overrides the defaults in the file. It’s a best practice to copy the relevant section you want to modify from into your file, and then modify the values there.

Each step defined above is covered below to give you a step by step process for creating your cluster. Start with making all Nodes point to the same database.

Point all Nodes to the Same Liferay Portal Database

Each node should have a data source that points to one Liferay Portal database (or a database cluster) that all the nodes share. This means, of course, Liferay Portal cannot (and should not) use...

Read More

Configure Documents and Media the Same for all Nodes

In a cluster, Documents and Media must use the same document repository configuration on all nodes. Note if you are using the File System or Advanced File System stores, the file system must be...

Read More

Clustering Search

Search should always run on a separate environment from your Liferay Portal server. Liferay Portal supports Elasticsearch, which can also be clustered. For more information on how to cluster...

Read More

Enabling Cluster Link

Enabling Cluster Link automatically activates distributed caching. The cache is distributed across multiple Liferay Portal nodes running concurrently. Cluster Link does Ehcache replication. The...

Read More

Auto Deploy to All Nodes

All modules and WAR files you deploy onto the cluster must be deployed to all cluster nodes. Because Liferay Portal installs applications as OSGi bundles, you cannot rely on your application...

Read More
0 (0 Votes)
Using the DBStore Previous