Link Search Menu Expand Document

The Open Distro project is archived. Open Distro development has moved to OpenSearch. The Open Distro plugins will continue to work with legacy versions of Elasticsearch OSS, but we recommend upgrading to OpenSearch to take advantage of the latest features and improvements.

Cluster restart upgrade

The steps on this page are most applicable if you installed Open Distro using the RPM or Debian packages. If you used a Docker image, see Docker upgrade.

  1. Disable shard allocation to prevent Elasticsearch from replicating shards as you shut down each node:

    PUT _cluster/settings
      "persistent": {
        "cluster.routing.allocation.enable": "primaries"
  2. Stop Elasticsearch on each node:

    sudo systemctl stop elasticsearch.service
  3. If you use the Debian package, upgrade to the underlying Elasticsearch version of the new Open Distro release:

    sudo dpkg -i elasticsearch-oss-x.y.z-amd64.deb
  4. Upgrade packages on each node using yum or apt:

    sudo yum install opendistroforelasticsearch
    sudo apt install opendistroforelasticsearch

    Alternately, yum lets you upgrade to a specific version of Open Distro:

    sudo yum install opendistro-for-elasticsearch-1.13.3

    Unfortunately, apt upgrades dependencies to their latest versions and thus only supports upgrades to the newest version of Open Distro.

  5. (Optional) Upgrade any additional plugins that you installed on the cluster. The package manager automatically upgrades Open Distro plugins.

  6. Start Elasticsearch on each node:

    sudo systemctl start elasticsearch.service
  7. Wait for the cluster to start, and verify that your cluster returns the new version:

    curl -XGET https://localhost:9200 -u 'admin:admin' -k
  8. Verify cluster health and the expected number of nodes:

    curl -XGET https://localhost:9200/_cat/health?v -u 'admin:admin' -k
  9. Enable shard allocation:

    PUT _cluster/settings
      "persistent": {
        "cluster.routing.allocation.enable": "all"
  10. Open Kibana, and verify that your data is present.