Cluster restart upgrade
The steps on this page are most applicable if you installed Open Distro for Elasticsearch using the RPM or Debian packages. If you used a Docker image, see Docker upgrade.
-
Disable shard allocation to prevent Elasticsearch from replicating shards as you shut down each node:
PUT _cluster/settings { "persistent": { "cluster.routing.allocation.enable": "primaries" } }
-
Stop Elasticsearch on each node:
sudo systemctl stop elasticsearch.service
-
If you use the Debian package, upgrade to the underlying Elasticsearch version of the new Open Distro for Elasticsearch release:
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-oss-x.y.z-amd64.deb sudo dpkg -i elasticsearch-oss-x.y.z-amd64.deb
-
Upgrade packages on each node using
yum
orapt
:sudo yum install opendistroforelasticsearch sudo apt install opendistroforelasticsearch
Alternately,
yum
lets you upgrade to a specific version of Open Distro for Elasticsearch:sudo yum install opendistro-for-elasticsearch-1.11.0
Unfortunately,
apt
upgrades dependencies to their latest versions and thus only supports upgrades to the newest version of Open Distro for Elasticsearch. -
(Optional) Upgrade any additional plugins that you installed on the cluster. The package manager automatically upgrades Open Distro for Elasticsearch plugins.
-
Start Elasticsearch on each node:
sudo systemctl start elasticsearch.service
-
Wait for the cluster to start, and verify that your cluster returns the new version:
curl -XGET https://localhost:9200 -u admin:admin -k
-
Verify cluster health and the expected number of nodes:
curl -XGET https://localhost:9200/_cat/health?v -u admin:admin -k
-
Enable shard allocation:
PUT _cluster/settings { "persistent": { "cluster.routing.allocation.enable": "all" } }
-
Open Kibana, and verify that your data is present.