Upgrade from Search Guard 8 to 9 (FLX only!)
Upgrading Search Guard from 8.19.x to 9.x.x can be done while you upgrade Elasticsearch from 8.19.x to 9.x.x. You can do this by performing a full cluster restart, or by doing a rolling restart:
Search Guard supports running a mixed cluster of 8.19.x and 9.x.x nodes and is thus compatible with the Elasticsearch upgrade path.
If you have not already done so, make yourself familiar with Elastic’s own upgrade instructions for the Elastic Stack:
Review breaking changes
- Breaking Changes in Elasticsearch 9
- No breaking changes in Search Guard FLX for Elasticsearch 9 but please refer to the
Notes and Troubleshootingsection below
Prerequisites
To perform an upgrade from 8.x to 9.x, you need to run at least:
- Elasticsearch 8.19.x (Elasticsearch requirement)
- Search Guard FLX 3.1.2 (Search Guard requirement)
- Upgrading directly from Search Guard classic (i.e., Search Guard versions 53 and before) is not supported
If you run older versions of Elasticsearch and/or Search Guard, please upgrade first.
Upgrading Search Guard
After upgrading a node from ES 8 to 9, simply install the correct version of Search Guard on this node.
No changes in elasticsearch.yml are required.
Reindex Search Guard Indices
The Search Guard Upgrade Tool can be used to reindex Search Guard indices. It is experimental and should only be used as advised by your support engineer.
Please refer also to our Blog Post Upgrading to Elasticsearch 9: Why your read-only 7.x indices still block the boot