Upgrade Helper¶
The upgrade_helper.js script offers a partial automation of data migration when the upgrading to the next major version of SEAL Elastic Stack.
It checks whether an Elasticsearch cluster is ready for an upgrade to the next major version. It checks:
-
cluster health
-
Elasticsearch version compatibility
-
Upgrade Assistant warnings
-
system-index migration requirements
-
incompatible indices
-
incompatible data streams.
The script uses the Elasticsearch and Kibana REST APIs.
Hint - Node.js version
The scritpt requires Node.js 18 or later.
Instructions¶
-
Change to the
prepare_upgradedirectory:cd "SEAL Elastic Stack - 8.19.24.551 - rpm/server/prepare_upgrade" -
Start Upgrade Helper with the
-dryrunoption:/opt/seal/seal-kibana/node/glibc-217/bin/node ./upgrade_helper.js -dryrun -
Review rollovers, index cleanup, and indices that need re-indexing.
-
Start Upgrade Helper without the
-dryrunoption:/opt/seal/seal-kibana/node/glibc-217/bin/node ./upgrade_helper.jsFor available options, see Elasticsearch Upgrade Helper - Usage
Hint - patience required
It may take some time until the re-indexing process is finished.
-
In a browser, Start Elastic Upgrade Assistant and follow the instructions:
http://localhost:5601/app/management/stack/upgrade_assistant/overview -
In Elastic Upgrade Assistant, complete any reported data-stream or system-index actions.
-
Start Upgrade Helper again, until any upgrade warnings are eliminated.