Elasticsearch 6.5.x is the default, most up-to-date supported version of Elasticsearch for Liferay DXP 7.2. If you’re upgrading Liferay DXP and still running Elasticsearch 6.1, it’s time to upgrade your Elasticsearch servers too. If you’re setting up a new system and not already running a remote Elasticsearch 6.1.x server, follow the installation guide to install Elasticsearch and the configuration guide to configure the Elasticsearch adapter. Here, you’ll learn to upgrade an existing Elasticsearch 6.1.x server (or cluster) to Elasticsearch 6.5.x:
-
Disable X-Pack Security in
elasticsearch.yml
unless you have an Liferay Enterprise Search subscription, which gives you access to the Liferay Enterprise Search Security app:xpack.security.enabled: false
-
Configure the bundled Liferay Connector to Elasticsearch 6.
-
Re-index all search and spell check indexes.
Learn about configuring Elasticsearch here.
Re-index
Once the Elasticsearch adapter is installed and talking to the Elasticsearch cluster, navigate to Control Panel → Configuration → Server Administration, and click Execute for the Reindex all search indexes entry.
You must also re-index the spell check indexes.
Reverting to Elasticsearch 6.1
Stuff happens. If that stuff involves an unrecoverable failure during the upgrade to Elasticsearch 6.5, roll back to Elasticsearch 6.1 and regroup.
Since your 6.1 and 6.5 are currently two separate installations, this procedure is straightforward:
-
Stop the Liferay Connector to Elasticsearch 6.
-
Stop Elasticsearch 6.5 and make sure that the Elasticsearch 6.1
elasticsearch.yml
and the connector app are configured to use the same port (9200 by default). -
Start the Elasticsearch server, and then restart the Liferay Connector to Elasticsearch 6.