Menu
Amazon Elasticsearch Service
Developer Guide (API Version 2015-01-01)

Migrating to a Different Elasticsearch Version

Amazon ES currently supports four Elasticsearch versions: 1.5, 2.3, 5.1, and 5.3. Compared to earlier versions of Elasticsearch, 5.1 and 5.3 offer powerful features that make these later versions faster, more secure, and easier to use. Some of the highlights include the following:

  • Support for Painless scripting - Painless is an Elasticsearch built-in scripting language. Painless lets you run advanced queries against your data and automate operations like partial index updates in a fast, highly secure way.

  • Higher indexing performance - Elasticsearch 5.1 and 5.3 provide better indexing capabilities that significantly increase the throughput of data updates.

  • Improved aggregations - Elasticsearch 5.1 and 5.3 offer several aggregation improvements, such as recalculating aggregations only when the data changes. These versions also deliver faster query performance.

For more information about the differences between Elasticsearch versions, see the Elasticsearch documentation. For information about the Elasticsearch APIs that Amazon ES supports for 1.5, 2.3, 5.1, and 5.3, see Supported Elasticsearch Operations.

If you start a new Elasticsearch project, we strongly recommend that you choose version 5.3. If you have an existing 1.5, 2.3, or 5.1 domain, you can choose to keep the domain or migrate your data to a new 5.3 domain. The migration is necessary because you can't change the version of an existing domain.

Note

Elasticsearch 1.5 snapshots are not compatible with 5.1 or 5.3. If you want to migrate your data from 1.5 to 5.1 or 5.3, you need to migrate to 2.3 first, and then migrate to 5.1 or 5.3.

The following procedures show how to migrate your data to a different version.

To migrate your data from a 5.1 domain to a 5.3 domain

  1. Create a manual snapshot of your 5.1 domain. For more information, see Working with Manual Index Snapshots.

  2. Create a 5.3 domain. For more information, see Creating Amazon ES Domains.

  3. Copy the snapshot data from the 5.1 domain to the 5.3 domain. For more information, see Working with Manual Index Snapshots.

  4. Test your application thoroughly.

  5. (Optional) If you no longer need your 5.1 domain, delete it. Otherwise, you continue to incur charges for the domain.

To migrate your data from a 2.3 domain to a 5.1 or 5.3 domain

  1. Review Breaking changes in 5.0 in the Elasticsearch documentation to find out if you need to make adjustments to your indexing or application.

    Note

    The Elasticsearch migration plugin currently is not available.

  2. Create a manual snapshot of your 2.3 domain. For more information, see Working with Manual Index Snapshots.

  3. Create a 5.1 or 5.3 domain. For more information, see Creating Amazon ES Domains.

  4. Copy the snapshot data from the 2.3 domain to the 5.1 or 5.3 domain. For more information, see Working with Manual Index Snapshots.

  5. Test your application thoroughly.

  6. (Optional) If you no longer need your 2.3 domain, delete it. Otherwise, you continue to incur charges for the domain.

To migrate your data from a 1.5 domain to a 2.3 domain

  1. Use the /_plugin/migration Elasticsearch plugin to find out if you can directly upgrade to version 2.3. You might need to make changes to your data before migration.

    1. In a web browser, open http://Elasticsearch_domain_endpoint/_plugin/migration/.

    2. Choose Run checks now.

    3. Review the results and, if needed, follow the instructions to make changes to your data. For more information, see Elasticsearch breaking changes.

  2. Create a manual snapshot of your 1.5 domain. For more information, see Working with Manual Index Snapshots.

  3. Create a 2.3 domain. For more information, see Creating Amazon ES Domains.

  4. Copy the snapshot data from the 1.5 domain to the 2.3 domain. For more information, see Working with Manual Index Snapshots.

  5. Test your application thoroughly.

  6. (Optional) If you no longer need your 1.5 domain, delete it. Otherwise, you continue to incur charges for the domain.