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.

Rolling 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 one 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 the 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 opendistroforelasticsearch-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 node. The package manager automatically upgrades Open Distro plugins.

  6. Start Elasticsearch on the node:

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

    curl -XGET https://localhost:9200/_nodes/_all?pretty=true -u 'admin:admin' -k
  8. Enable shard allocation:

    PUT _cluster/settings
      "persistent": {
        "cluster.routing.allocation.enable": "all"
  9. Wait for cluster health to return to green:

    curl -XGET https://localhost:9200/_cat/health?v -u 'admin:admin' -k
  10. Repeat steps 1-8 for each node.

  11. Open Kibana, and verify that your data is present.