Upgrading to Elasticsearch 6.5

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 6 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:

  1. Install and configure Elasticsearch 6.5.x.

  2. Disable X-Pack Security in elasticsearch.yml unless you have an Liferay Enterprise Search Premium subscription, which gives you access to Liferay’s X-Pack Security connector:

    xpack.security.enabled: false
    
  3. Configure the bundled Liferay Connector to Elasticsearch 6.

  4. 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 PanelConfigurationServer 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:

  1. Stop the Liferay Connector to Elasticsearch 6.

  2. 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).

  3. Start the Elasticsearch server, and then restart the Liferay Connector to Elasticsearch 6.

« Backing Up ElasticsearchUpgrading to Elasticsearch 6.8 »
Was this article helpful?
0 out of 0 found this helpful