Liferay Enterprise Search
- [LES]: How to install and run the Elastic Support Diagnostics Troubleshooting Utility
 - [LES] About Elasticsearch License expiration
 - [LES] Elasticsearch Virtual Machine Considerations
 - [LES] Getting Started with Liferay Enterprise Search
 - [LES] How to use a load balancer with Elasticsearch?
 - [LES] Installing the Learning-to-Rank plugin on Elasticsearch fails with "IllegalStateException: ltr requires Java 14"
 - [LES] What is the recommended Java heap size for Elasticsearch?
 - [LES] Which node types are charged as part of the Liferay Enterprise Search Subscription
 - Easily customize Liferay's search behavior with Blueprints
 - Elasticsearch 7.17 End of Life (EOL) Timeline and Liferay DXP Elasticsearch Compatibility Update & FAQ
 - Liferay Enterprise Search Experiences (Blueprints) 1.1.0 for DXP 7.3 Release Highlights & Upgrade Instructions
 
[LES] About Elasticsearch License expiration
- How can I check my current Elasticsearch license status?
 - Is there any notification that the license expiration is approaching?
 - When will Liferay Support provide a new license to replace the expiring one?
 - What happens to my cluster when the license expires?
 - How can I install a new license when my current one is expired?
 - What happens to other products when the license expires?
 
Q: How can I check my current Elasticsearch license status?
You can use the GET license API endpoint to query all of your currently active licenses.
Q: Is there any notification that the license expiration is approaching?
Elasticsearch will begin logging ERROR level messages, notifying you of the upcoming license expiration, and the behavior to expect when the license expires. These messages will be logged on this schedule:
- 30 Days - 7 Days Remaining: Daily, and on startup.
 - 7 Days - 0 Days remaining: Every 10 minutes, and on startup
 - License Expired: Every 10 minutes, and on startup, with a License Expired message
 
Monitoring the Elasticsearch log for these errors should give you plenty of warning close to the expiration date.
Q: When will Liferay Support provide a new license to replace the expiring one?
Enterprise Search activation is typically available for subscriptions with a start date in the current quarter or previous quarters. Please refer to How do I activate my Enterprise Search product? (Video Tutorial) for more information.
Q: What happens to my cluster when the license expires?
Calls to indices:monitor/stats and cluster:monitor/stats API will be blocked:
[2015-07-13 14:51:07,169][ERROR][shield.action ] [node1] blocking [cluster:monitor/stats] operation due to
expired license. Cluster health, cluster stats and indices stats operations are blocked on shield license
expiration. All data operations (read and write) continue to work.If you have a new license, please update it.
Otherwise, please reach out to your support contact.
As a consequence of the above, no new data will be drawn into marvel dashboards as the marvel agent will fail to collect results:
[2015-07-13 14:51:07,169][ERROR][marvel.agent ] [node1] error while collecting indices stats org.elasticsearch.license.plugin.core.LicenseExpiredException: license expired for feature [shield] at org.elasticsearch.shield.action.ShieldActionFilter.apply(ShieldActionFilter.java:95) at org.elasticsearch.action.support.TransportAction$RequestFilterChain.proceed(TransportAction.java:165) at org.elasticsearch.action.support.TransportAction.execute(TransportAction.java:82) at org.elasticsearch.client.node.NodeIndicesAdminClient.execute(NodeIndicesAdminClient.java:77) at org.elasticsearch.client.support.AbstractIndicesAdminClient.stats(AbstractIndicesAdminClient.java:562) at org.elasticsearch.action.admin.indices.stats.IndicesStatsRequestBuilder.doExecute(IndicesStatsRequestBuilder.java:178) at org.elasticsearch.action.ActionRequestBuilder.execute(ActionRequestBuilder.java:91) at org.elasticsearch.action.ActionRequestBuilder.execute(ActionRequestBuilder.java:65) at org.elasticsearch.action.ActionRequestBuilder.get(ActionRequestBuilder.java:80) at org.elasticsearch.marvel.agent.AgentService$ExportingWorker.exportIndicesStats(AgentService.java:293) at org.elasticsearch.marvel.agent.AgentService$ExportingWorker.run(AgentService.java:260) at java.lang.Thread.run(Thread.java:745)
All read and write operation to your indices will continue to work.
Please reach out to Liferay Support or your Account Executive to get a new license.
Q: How can I install a new license when my current one is expired?
If you have the new license already, you can install it following the steps described in these articles:
- For Elasticsearch 6.2: Update Elasticsearch license (6.2)
 - For Elasticsearch 7.2: Update Elasticsearch license (7.2)
 
If you are using a different Elasticsearch version, listed in the compatibility matrix, please look for it's specific instructions on https://www.elastic.co/guide/index.html
Q: What happens to other products when the license expires?
Commercial plugins operate with reduced functionality on license expiration:
- Security - cluster health, cluster and indices stats are blocked, read and write will work
 - Watcher - Watches will execute and write to history but the actions do not execute
 - Monitoring - stops collecting cluster and index metrics and will stop cleaning older indices
 - Graph - explore APIs are disabled
 
See Elastic documentation for full details.