Upgrading Elasticsearch

Edit online

Update an external (customer-installed) installation of Elasticsearch version 5.x/6.x to version 7.x with an update of IBM Spectrum LSF Explorer to version 10.2 Fix Pack 9 or Fix Pack 10.

About this task

Important: IBM Spectrum LSF Explorer 10.2 Fix Pack 9 and older bundled Elasticsearch versions that did not support https and authentication. To use these features, you need to install external versions of Elasticsearch with basic 7.2.1 version (or newer, but less than version 8) and migrate the data by following the Elasticsearch documentation: https://www.elastic.co/guide/en/elasticsearch/reference/7.2/restart-upgrade.html

Versions of IBM Spectrum LSF Explorer older than 10.2 Fix Pack 10 include an optional installation of Elasticsearch version 7.2.1. However, customers who installed Elasticsearch 5.x or 6.x on their own, a backup is recommended and there are special steps for upgrading.

This task is not applicable if you installed the version of Elasticsearch included with Explorer or are already using Elasticsearch 7.x.

Upgrading Elasticsearch from 5.x/6.x to 7.2.1 requires a shutdown of all Explorer services. Therefore, Explorer will be out of service during this upgrade.

Procedure

  1. Back up Elasticsearch data.

    In case of a failed upgrade, a backup of Elasticsearch data is recommended. A snapshot is a backup taken from a running Elasticsearch cluster. You can take a snapshot of individual indices or of the entire cluster and store it in a repository on a shared filesystem.

    For directions on how to take a snapshot in Elasticsearch 5.4: https://www.elastic.co/guide/en/elasticsearch/reference/5.4/modules-snapshots.html

    For directions on how to take a snapshot in Elasticsearch 6.6: https://www.elastic.co/guide/en/elasticsearch/reference/6.6/modules-snapshots.html

  2. Upgrade Elasticsearch from version 5.x to 7.x.
    1. Update the "model" index by running the following commands after setting the ES_IP and ES_PORT parameters in the commands. 
      cd explorer10.2.0.9_server_linux-x64
  ./es5Update.sh $ES_IP $ES_PORT
    2. Follow the steps to upgrade Elasticsearch to 6.x: https://www.elastic.co/guide/en/elasticsearch/reference/6.6/restart-upgrade.html
  3. Upgrade Elasticsearch from version 6.x to 7.x.
    1. Ensure Elasticsearch 6.x is started.
    2. Run the reindexIncompatibleIndices.sh script after setting ES_IP and ES_PORT parameters in the script.
    3. Follow the steps in below link to upgrade Elasticsearch from version 6.6.1 to 7.2.1: https://www.elastic.co/guide/en/elasticsearch/reference/7.2/restart-upgrade.html
  4. Optional: If Elasticsearch upgrade failed, restore data.

    Reinstall the old version of Elasticsearch and restore the data. Follow:

    https://www.elastic.co/guide/en/elasticsearch/reference/5.4/modules-snapshots.html

    or

    https://www.elastic.co/guide/en/elasticsearch/reference/6.6/modules-snapshots.html