Legacy Knowledge Base
Published Jul. 2, 2025

License Validation Error During Clustering

Written By

Ryan Najima

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

While we make every effort to ensure this Knowledge Base is accurate, it may not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with any feedback or concerns.

Legacy Article

You are viewing an article from our legacy "FastTrack" publication program, made available for informational purposes. Articles in this program were published without a requirement for independent editing or verification and are provided"as is" without guarantee.

Before using any information from this article, independently verify its suitability for your situation and project.

This article documents a license validation error that takes place when the wrong activation key is deployed during clustering, and lists steps to resolve the issue or avoid it altogether. 

Summary

Deploying a developer activation key will not allow clustering between nodes. 

Error

Portal Development license validation failed

java.lang.Exception: Clustering has been detected. Developer licenses do not allow for clustering.

NOTE: Clustering module is only available for Enterprise Subscriptions to Liferay Digital Enterprise 7.0, and thereby Community Edition users will be unable to access the clustering module in Liferay Digital Enterprise 7.0.

Resolution

Common Causes

In order to perform clustering, cluster.link.enabled needs to be set to true and the license manager will verify the activation key. If the deployed key is not a clustering activation key, it will cause the error Portal Development license validation failed to display. 

Recommended Solution

  • Obtain a clustering activation key
  • Start up the portal
  • Drop the file (activation key) in the deploy folder

Prevention Tips
Determine how Liferay Digital Enterprise 7.0 will be utilized and obtain the appropriate activation key.

  • For clustering, obtain the cluster activation key
  • For testing and development, obtain the developer activation key
Did this article resolve your issue ?

Legacy Knowledge Base