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

Migrating to a Different Elasticsearch Version

The following table shows how to migrate your data to a newer Elasticsearch version. Most of the steps require you to create and restore manual index snapshots. To learn more about this process, see Working with Amazon Elasticsearch Service Index Snapshots.

Migrating to a newer Elasticsearch version also requires creating a new domain. To learn more, see Creating and Configuring Amazon Elasticsearch Service Domains.

From Version To Version Migration Process
5.x 6.0
  1. Review Breaking changes in 6.0 to see if you need to make adjustments to your indices or application.

    Important

    Indices created in version 6.0 no longer support multiple mapping types. Indices created in version 5.x still support multiple mapping types when restored into a 6.0 cluster.

    If you use services like Amazon Kinesis Firehose or Amazon CloudWatch Logs to stream data to Amazon ES, check that these services support Elasticsearch 6.0 before migrating.

    If you use AWS Lambda, check that your code only creates a single mapping type per index.

  2. Create a manual snapshot of the 5.x domain.

  3. Create a new 6.0 domain.

  4. Restore the snapshot from the original domain to the 6.0 domain.

  5. If you no longer need your original domain, delete it. Otherwise, you continue to incur charges for the domain.

2.3 6.0 Elasticsearch 2.3 snapshots are not compatible with 6.0. To migrate your data directly from 2.3 to 6.0, you must manually recreate your indices in the new domain.

Alternately, you can follow the 2.3 to 5.x steps in this table, perform _reindex operations in the new 5.x domain to convert your 2.3 indices to 5.x indices, and then follow the 5.x to 6.0 steps.

5.1 or 5.3 5.5
  1. Create a manual snapshot of the 5.1 or 5.3 domain.

  2. Create a new 5.5 domain.

  3. Restore the snapshot from the original domain to the 5.5 domain.

  4. If you no longer need your original domain, delete it. Otherwise, you continue to incur charges for the domain.

2.3 5.x
  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 the 2.3 domain.

  3. Create a new 5.x domain.

  4. Restore the snapshot from the 2.3 domain to the 5.x domain.

  5. If you no longer need your 2.3 domain, delete it. Otherwise, you continue to incur charges for the domain.

1.5 5.x Elasticsearch 1.5 snapshots are not compatible with 5.x. To migrate your data from 1.5 to 5.x, you must manually recreate your indices in the new domain.

Important

1.5 snapshots are compatible with 2.3, but Amazon ES 2.3 domains do not support the _reindex operation. Because you cannot reindex them, indices that originated in a 1.5 domain still fail to restore from 2.3 snapshots to 5.x domains.

1.5 2.3
  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://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 the 1.5 domain.

  3. Create a new 2.3 domain.

  4. Restore the snapshot from the 1.5 domain to the 2.3 domain.

  5. If you no longer need your 1.5 domain, delete it. Otherwise, you continue to incur charges for the domain.