Upgrading the Elasticsearch cluster

If you have a DataServer - Distributed, you must upgrade the Elasticsearch cluster first before you upgrade any data server. If you have only the DataServer - Classic, skip this procedure and proceed to the next topic.

1. Download the release upgrade ISO to the primary node of the Elasticsearch cluster where the installation was initially started.
   Download the latest version from IBM Fix Central. For information about the package names and part numbers and the links to the proper download locations, see the download document.
2. Log on to the primary node from PuTTY by using the builder account and password that were configured during the installation of the cluster. Run the following commands to upgrade the cluster.
3. To prepare the upgrade, run the following commands replacing STOREDIQ-Upgrade.iso with the image name stated in the download document:

   [builder@hostname ˜]# su
   [root@hostname builder]# cd /home/builder
   [root@hostname builder]# mount STOREDIQ-Upgrade.iso /mnt
   [root@hostname builder]# cd /mnt
   [root@hostname mnt]# /usr/bin/python -m SimpleHTTPServer 80 >/dev/null 2>&1 &
   [root@hostname mnt]# export killpid=$! && cd

   Hint: When you change to the root account, you will be prompted for the password. Enter the password for root that was configured during the installation of the cluster.
4. In a second PuTTY session, log in to the primary node by using the builder account and password that were configured during the installation of the cluster.
   Then, run the following commands to upgrade the cluster.

   [builder@hostname ~]$ bootstrap product.set elasticsearch repository http://IP of primary node/products/elasticsearch

   Press Enter to continue for each node.

   [builder@hostname ~]$ bootstrap product.upgrade elasticsearch version+build_number

   Replace version and build_number with the actual values. You can derive these values from the .ova file name or find them in the product release notes (ReadMeFirst file). For example, if the .ova file name is 7.6.0.20-VMWare-Elasticsearch-7-15.ova, the version is 7.6.0.20 and the build number is 7. In this case, you would run this command: bootstrap product.upgrade elasticsearch 7.6.0.20+7

   Press Enter to continue for each node.

5. Go back to the PuTTY session from step 3 where you're logged in as root and run these commands to finish the upgrade:

   [root@hostname ~]$ kill $killpid
   [root@hostname ~]$ umount /mnt