In this section of the documentation we will explain some general notions of how to migrate between ElasticSearch versions, as well as present specific migration steps to migrate from one version of ElasticSearch used by Apache Unomi to another, if it is needed.

General steps and notions

Depending on the type of ElasticSearch install you may have, the migration steps will differ. Basically when dealing with a single node (standalone) installation, a simple procedure may be used that simply copies some directories over, while in the case of a cluster installation ElasticSearch Snapshot and Restore functionality must be used.

Standalone (one node migration)

In the case of a standalone install, it is generally sufficient, provided the versions are compatible (meaning that only one major version seperates the two installs), to simply copy over the data directory over to the new version. Also you will need to make sure that you copy over any custom settings from the config/elasticsearch.yml file over to the new version.

Cluster migration

Here we recommend you read the official upgrading documentation.

Migrating between versions used by Apache Unomi.

ElasticSearch 5.1.2 to 5.6.3 (Unomi 1.2.0 -> 1.3.0)


  1. Depending on your install, perform either the standalone or cluster migration
  2. That’s it !

Back to top

Reflow Maven skin by Andrius Velykis.