Elasticsearch:Migrate self-managed Elasticsearch data to Alibaba Cloud over an instance private network

Prerequisites

• Your self-managed Elasticsearch cluster must meet the following requirements:

  • The cluster must be hosted on an ECS instance in the same VPC as your Alibaba Cloud Elasticsearch instance. Connections established by using ClassicLink are not supported.

  • The security group of the ECS instance allows access from all node IP addresses of your Alibaba Cloud Elasticsearch instance over port 9200. You can find the node IP addresses in the Kibana console.

  • You must be able to connect to the Alibaba Cloud Elasticsearch instance. You can verify the connection by running the curl -XGET http://<host>:9200 command on a machine.

    Note

    You can run the script in this guide from any machine that can access both the self-managed Elasticsearch cluster and the Alibaba Cloud Elasticsearch instance over port 9200.

  • The source index data is ready in your self-managed Elasticsearch cluster. This guide uses an index named source as an example.

• Your Alibaba Cloud Elasticsearch instance must meet the following requirements:

  • Enable the automatic index creation feature in advance or create the index mappings and settings on Alibaba Cloud Elasticsearch.

  • Ensure no whitelist restrictions are configured.

Limits

Procedure

1. Step 1: Configure an SLB instance that supports PrivateLink

   You can only use an SLB instance that supports PrivateLink as a service resource for an endpoint service. Before you can establish a private connection between VPCs by using PrivateLink, you must create an SLB instance that supports PrivateLink and configure a listener.

2. Step 2: Create an endpoint service

   An endpoint service allows other VPCs to establish private connections by creating endpoints. After you configure the SLB instance, you must create an endpoint service.

3. Step 3: Configure a private connection for Alibaba Cloud Elasticsearch

   In the Alibaba Cloud Elasticsearch console, associate your Alibaba Cloud Elasticsearch instance with the endpoint service that you created in Step 2.

4. Step 4: Get the endpoint domain name

   After the target instance is associated with the endpoint service, you can obtain the endpoint domain name to configure the reindex whitelist.

5. Step 5: Configure the reindex whitelist

   In the Alibaba Cloud Elasticsearch console, add the domain name that you obtained in Step 4 to the reindex whitelist of the target instance to grant access.

6. Step 6: Migrate data

   After completing the preceding steps, the network connection between the source and target instances is established, and you can start the data migration.

Step 1: Configure an SLB instance for PrivateLink

1. Create an SLB instance.

   Make sure that the SLB instance is in the same region as the ECS instance that is added as a backend server. For more information, see Create an SLB instance that supports PrivateLink.

2. Configure the Protocol and listener. Set the protocol to TCP and the port to 9200.

   

   For more information, see Add a TCP listener.

3. Click Next step. Configure the backend server group by adding the ECS instance that hosts your self-managed Elasticsearch cluster, and set the port to 9200.

   For more information, see Configure backend servers.

4. Click Next step and configure the Configure Health Check as needed. This guide uses the default settings.

5. Click Next step. Review your configuration, click Submit, confirm the configuration details, and then click I Understand. You are returned to the Manage Cluster page, where you can check the health check status of the backend ECS instance.

   A status of Normal means the backend ECS instance can process requests forwarded by the SLB instance.

Step 2: Create an endpoint service

1. Log on to the endpoint service console.

2. In the top navigation bar, select the region where you want to create the endpoint service.

   This guide uses China (Hangzhou) as an example.

3. Click Create Endpoint Service. On the Create Endpoint Service page, configure the parameters as needed.

   For detailed instructions, see Create and manage an endpoint service. In the Service resource section, set Resource type to Classic Load Balancer (CLB). This guide uses the following key configurations. For other parameters, use the default values or configure them as needed.

   Parameter	Description
   Select service resource	Select the availability zone that carries traffic, and then select the SLB instance to associate with the endpoint service. The associated SLB instance accepts network traffic from your service users. The availability zone of the endpoint service is the same as the primary availability zone of the service resource. An SLB instance can be used as a service resource only if it meets the following conditions: The network type is VPC. PrivateLink is supported.
   Automatically Accept Endpoint Connections	Select whether to automatically accept connection requests from endpoints. We recommend that you select Yes. The options are: Yes: The endpoint service automatically accepts connection requests. The endpoint can then access the service. No: The endpoint connection remains in a disconnected state until the service administrator handles the request: If the administrator accepts the connection request, the service can be accessed through the endpoint. If the administrator rejects the connection request, the service cannot be accessed through the endpoint.
   Enable zone affinity	Select whether to enable zone affinity. We recommend that you select Yes.

4. Click OK.

Step 3: Configure a private connection

1. Log on to the Alibaba Cloud Elasticsearch console.

2. In the left navigation menu, choose Elasticsearch Clusters.

3. Navigate to the target cluster.

   1. In the top navigation bar, select the resource group to which the cluster belongs and the region where the cluster resides.

   2. On the Elasticsearch Clusters page, find the cluster and click its ID.

4. Click Add Private Connection and select the endpoint service created in the previous step.

5. Wait until the connection status is Connected. This means the ES cluster VPC and your VPC are connected.

6. In the Configure Private Connection panel, click Add Private Connection. Select the endpoint service that you created in Step 2 and the target availability zone, and then select the checkbox for the system prompt.

   

7. Click OK. The endpoint service actively connects to the endpoint. After the connection is established, the status changes to Connected.

   

Step 4: Get the endpoint domain name

After completing the preceding steps, you must obtain the endpoint domain name to configure the reindex whitelist.

1. In the Configure Private Connection panel, click the target Endpoint ID.

   

2. On the Endpoint connections tab, click the expand icon () next to the target endpoint ID to view the corresponding domain name of the endpoint.

   

Step 5: Configure the reindex whitelist

1. Log on to the Alibaba Cloud Elasticsearch console.

2. In the left navigation menu, choose Elasticsearch Clusters.

3. Navigate to the target cluster.

   1. In the top navigation bar, select the resource group to which the cluster belongs and the region where the cluster resides.

   2. On the Elasticsearch Clusters page, find the cluster and click its ID.

4. In the left navigation menu, choose Configuration and Management > Cluster Configuration.

5. In the YML File Configuration section, click Modify Configuration on the right.

6. In the YML File Configuration panel, click Modify Configuration and add the domain name that you obtained in Step 4.

   Example:

   reindex.remote.whitelist: 'ep-bp1nitq0krp8yhcf****-cn-hangzhou-i.epsrv-bp1zczi0fgoc5qtv****.cn-hangzhou.privatelink.aliyuncs.com:9200'

   

7. Click OK.

Step 6: Migrate data

1. In the Dev Tools of the Kibana console, run the following command to migrate data.

   Note

   For information about how to log on to the Kibana console, see Log on to the Kibana console.

   POST /_reindex?pretty
   {
     "source": {
       "remote": {
         "host": "http://ep-bp1nitq0krp8yhcf****-cn-hangzhou-i.epsrv-bp1zczi0fgoc5qtv****.cn-hangzhou.privatelink.aliyuncs.com:9200",
         "username": "elastic",
         "password": "Elastic@123***"
       },
       "index": "source",
       "size": 5000
     },
     "dest": {
       "index": "dest"
     }
   }

   If the Kibana console is unavailable, you can also run a cURL command on a machine that can access your Alibaba Cloud Elasticsearch instance to perform the reindex operation:

   curl -u <username>:<password> -XPOST "http://<Alibaba Cloud Elasticsearch domain name>:9200/_reindex?pretty" -H "Content-Type: application/json" -d '{
     "source": {
       "remote": {
         "host": "http://<endpoint domain name>:9200",
         "username": "<self-managed Elasticsearch username>",
         "password": "<self-managed Elasticsearch password>"
       },
       "index": "source",
       "size": 5000
     },
     "dest": {
       "index": "dest"
     }
   }'

   Note

   If security is not enabled for your self-managed Elasticsearch cluster, remove the username and password fields from source.remote.

   For more information, see reindex API.

2. Optional: To check the status of running reindex tasks, run the following command.

   GET _tasks?detailed=true&actions=*reindex

3. Verify the migration result.

   After the migration is complete, run the following command to verify the result.

   GET _cat/indices?v

   If the health status of the destination index is normal and the data size is as expected, the migration is successful.

FAQ

Q: How do I speed up data synchronization for a large index?