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

Check the Elasticsearch 6.8 deprecation log and Elasticsearch 7.x release notes to see if you’re using any deprecated features and update your code accordingly.

By default, deprecation log messages are enabled at the WARN level.

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,

  1. First upgrade your service from version 2 to version 5 from the Aiven Console.
  2. 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.
  3. Upgrade further to Elasticsearch version 6 from Aiven Console.

IF your service is currently on version 5 after previously upgrading from version 2,

  1. Manually reindex indices that were created in version 2 before upgrading to version 6.
  2. Upgrade to Elasticsearch version 6 from the Aiven Console.

IF your service is originally created on version 5

  1. 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,

  1. 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.
  2. 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.

Did this answer your question?