Upgrading and Moving Elasticsearch from one machine to another

Please perform backup (take snapshot) of the current Elasticsearch data prior to moving any assets from one machine to another.

Prerequisites

Install Elasticsearch on a new machine according to the KM02494295

Both old and new Elasticsearch environments should be up and running before the migration.

Migration Steps

1. On the new Elasticsearch machine, add new parameter to the elasticsearch.yml

(Linux: /etc/elasticsearch/elasticsearch.yml, Windows: %ES_HOME% \config/elasticsearch.yml)

reindex.remote.whitelist: 'MyOldElasticMachine:9200'

2. Restart Elasticsearch
    
3. Stop Octane service if it is still running
    
4. Change the Elasticsearch configuration in the setup.xml file:

<Octane Installation folder>/conf/setup.xml

Update the elastic host parameter to new one: <elasticHost>NewElasticHost</elasticHost>

if cluster name changed, please update as follows: <elasticClusterName>NewClusterName</elasticClusterName>

Elasticsearch port stays the same - 9300

5. Get the logical name of the space from the database by executing this SQL query:

select sp_logical_name from <octane_site_admin schema>.shared_space

NOTE: if you have many spaces in your Octane environment, you can get multiple lines in response

6. Octane indexes in Elasticsearch are kept in the form of mqm_<logical name>_index
7. Run these command FOR EACH logical space name from the existing Elasticsearch to copy the index to the new Elasticsearch environment:

curl –XPOST "MyNewElasticMachine:9200/_reindex?pretty" -H 'Content-Type: application/json' -d'

{

  "source": {

    "remote": {

      "host": "http://MyOldElasticMachine:9200"

    },

    "index": "mqm_<Logical name from DB>_index"

  },

  "dest": {

    "index": "mqm_<Logical name from DB>_index"

  }

}

'

8. Afterwards, need to configure the alias in the new Elasticsearch FOR EACH logical space name:

curl -XPOST "MyNewElasticMachine:9200/_aliases?pretty" -H 'Content-Type: application/json' -d'

{

    "actions" : [

        { "add" : { "index" : "mqm_<Logical name from DB>_index", "alias" : "mqm_<Logical name from DB>" } }

    ]

}

'

9. Restart Octane