Note: Aiven for OpenSearch replaces Aiven for Elasticsearch after Elasticsearch version 7.10.2 due to licensing changes. In addition, OpenSearch Dashboards replaces Kibana. Starting from September 24th, 2021 until March 23rd, 2022, Aiven supports services running both OpenSearch and Elasticsearch 7.10.2. For more information on Aiven for OpenSearch, see our developer documentation.
Before you begin
Aiven for Elasticsearch versions 2.x and 5.x reach EOL on Oct 30th 2020 and version 6.x on Nov 20th 2020. Therefore, you may want to consider planning the upgrade to the latest available version i.e 7.x.
There are breaking changes in Elasticsearch major versions 6.x and 7.x that you should be aware of to migrate your applications. Please refer to upstream articles Upgrade to Elasticsearch 6.x and Upgrade to Elasticsearch 7.x for breaking changes, known issues and detailed information on the upgrade process.
Updating your applications
By default, deprecation log messages are enabled at the
Upgrading to version 6
The upgrade process to Elasticsearch version 6 is a multi-step process, depending on the starting version of your service.
IF your service is on version 2,
First upgrade your service from version 2 to version 5 from the Aiven Console.
Once on version 5 manually reindex indices that were created in version 2 - Elasticsearch version 6 cannot use indices created in Elasticsearch version 2. Therefore, you must reindex or delete indices from version 2 before upgrading to version 6.
Upgrade further to Elasticsearch version 6 from Aiven Console.
IF your service is currently on version 5 after previously upgrading from version 2,
Manually reindex indices that were created in version 2 before upgrading to version 6.
Upgrade to Elasticsearch version 6 from the Aiven Console.
IF your service is originally created on version 5
Upgrade directly to Elasticsearch version 6 from the Aiven Console.
Upgrading to version 7
Please upgrade first to version 6 before attempting to upgrade to version 7.
IF your service is on version 6 by upgrading from version 5,
Manually reindex indices that were created in version 5 - Elasticsearch version 7 cannot use indices created in Elasticsearch version 5. Therefore, you must reindex or delete indices from version 5 before upgrading to version 7.
Upgrade further to Elasticsearch version 7 from Aiven Console.
How to upgrade from Aiven Console
Go to the Overview page of the affected service, click on "Upgrade Elasticsearch" button as annotated in the screenshot below and follow the instructions.
Note that if you have unapplied maintenance updates your ElasticSearch cluster may be upgraded to a lower minor/point release version than you expect. To ensure you get the latest minor and point release you should first apply any available maintenance updates from the Maintenance updates row with the "Apply now" button.