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