Nugget Post: Upgrading an OpenSearch cluster

In this case, from 1.x to 2.1.0…

Upgrading OpenSearch

  1. Download and extract the relevant tar file from the opensearch website
  2. Copy the /config/opensearch.yml from the directory containing your older opensearch to the new directory you just extracted in step (1)
  3. If present, copy all /config/*.pem files from the old directory to the new directory
  4. Copy the opensearch.keystore from the old directory to the new directory
  5. Ensure to modify the jvm.options file, especially Xmx and Xms parameters, to match what you had before
  6. Ensure correct filesystem permission on the new folder, for example: chown opensearch:opensearch -R new_folder
  7. Ensure you change the path.data and path.logs in the opensearch.yml config file to match what you had before

Upgrading OpenSearch Dashboards

  1. Copy the config yml file from the old directory to the new directory
  2. If you DO NOT use opensearch security, remember to change directory to bin and run:
./opensearch-dashboards-plugin --allow-root remove securityDashboards

Restart opensearch dashboards and you’re goo to go

Bonus Tip: NiFi

In nifi any “PutElasticHTTP” processors should have the “Type” setting left empty (i.e. not “_doc” as it was previously)