Link Search Menu Expand Document

Open Distro for Elasticsearch development has moved to OpenSearch. The ODFE 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 for Elasticsearch 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 for Elasticsearch 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 for Elasticsearch:

    sudo yum install opendistroforelasticsearch-1.13.2

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

  5. (Optional) Upgrade any additional plugins that you installed on the node. The package manager automatically upgrades Open Distro for Elasticsearch 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.