Migrating Data from OBS to CSS

Scenario

CDM supports data migration between cloud services. This section describes how to use CDM to migrate data from OBS to CSS. The procedure is as follows:

1. Creating a CDM Cluster
2. Creating a Cloud Search Service Link
3. Creating an OBS Link
4. Creating a Migration Job

Prerequisites

• You have obtained the domain name, port number, AK, and SK for accessing OBS.
• You have subscribed to Cloud Search Service and obtained the IP address and port number of the Cloud Search Service cluster.

Creating a CDM Cluster

If CDM is used an independent service, create a CDM cluster by following the instructions in Creating a CDM Cluster. If CDM is used as a module of DataArts Studio, create a CDM cluster by following the instructions in Creating a CDM Cluster.

Creating a Cloud Search Service Link

1. Click Job Management in the Operation column of the CDM cluster. On the displayed page, click the Links tab and then Create Link. The Select Connector page is displayed.
   Figure 1 Selecting a connector
   

2. Select Cloud Search Service and click Next. On the page that is displayed, configure the CSS link parameters.
   • Name: Enter a custom link name, for example, csslink.
   • Elasticsearch Server List: Enter the IP address and port number of the Cloud Search Service cluster (cluster later than 5.x). The format is ip:port. Use semicolons to separate multiple addresses. For example, 192.168.0.1:9200;192.168.0.2:9200.
   • Username and Password: Enter the username and password used for logging in to the Cloud Search Service cluster. The user must have the read and write permissions on the database.
   Figure 2 Creating a CSS link
   

3. Click Save. The Link Management page is displayed.

Creating an OBS Link

1. Click Job Management in the Operation column of the CDM cluster. On the displayed page, click the Links tab and then Create Link. The Select Connector page is displayed.
   Figure 3 Selecting a connector type
   

2. Select Object Storage Service (OBS) and click Next to configure parameters for the OBS link.
   • Name: Enter a custom link name, for example, obslink.
   • OBS Server and Port: Enter the actual OBS address information.
   • AK and SK: Enter the AK and SK used for logging in to OBS.
     To obtain an access key, perform the following steps:

     1. Log in to the management console, move the cursor to the username in the upper right corner, and select My Credentials from the drop-down list.
     2. On the My Credentials page, choose Access Keys, and click Create Access Key. See Figure 4.
        Figure 4 Clicking Create Access Key
        
     3. Click OK and save the access key file as prompted. The access key file will be saved to your browser's configured download location. Open the credentials.csv file to view Access Key Id and Secret Access Key.
        

        • Only two access keys can be added for each user.
        • To ensure access key security, the access key is automatically downloaded only when it is generated for the first time and cannot be obtained from the management console later. Keep them properly.
   Figure 5 Creating an OBS link
   

3. Click Save. The Link Management page is displayed.

Creating a Migration Job

1. Choose Table/File Migration > Create Job to create a job for exporting data from OBS to Cloud Search Service.
   Figure 6 Creating a job for migrating data from OBS to Cloud Search Service
   
   • Job Name: Enter a unique name.
   • Source Job Configuration
     • Source Link Name: Select the obslink link created in Creating an OBS Link.
     • Bucket Name: Select the bucket from which the data will be migrated.
     • Source Directory/File: Set this parameter to the path of the data to be migrated. You can migrate all directories and files in the bucket.
     • File Format: Select CSV for migrating files to a data table.
     • Retain the default values of the optional parameters in Show Advanced Attributes.
   • Destination Job Configuration
     • Destination Link Name: Select the csslink link created in Creating a Cloud Search Service Link.
     • Index: Select the Elasticsearch index of the data to be written. You can also enter a new index. CDM automatically creates the index on Cloud Search Service.
     • Type: Select the Elasticsearch type of the data to be written. You can enter a new type. CDM automatically creates a type at the migration destination.
     • Retain the default values of the optional parameters in Show Advanced Attributes.

2. Click Next. The Map Field page is displayed. CDM automatically matches the source and destination fields. See Figure 7.
   • If the field mapping is incorrect, you can drag the fields to adjust the mapping.
   • If the type is automatically created at the migration destination, you need to configure the type and name of each field.
   • CDM supports field conversion during the migration. For details, see Converting Fields.
   Figure 7 Field mapping of Cloud Search Service
   

3. Click Next and set task parameters. Generally, retain the default values of all parameters.
   In this step, you can configure the following optional functions:

   • Retry If Failed: Determine whether to automatically retry the job if it fails. Retain the default value Never.
   • Group: Select the group to which the job belongs. The default group is DEFAULT. On the Job Management page, jobs can be displayed, started, or exported by group.
   • Schedule Execution: Determine whether to automatically execute the job at a scheduled time. Retain the default value No in this example.
   • Concurrent Extractors: Enter the number of concurrent extractors. An appropriate value improves migration efficiency. For details, see Performance Tuning. Retain the default value 1.
   • Write Dirty Data: Specify this parameter if data that fails to be processed or filtered out during job execution needs to be written to OBS for future viewing. Before writing dirty data, create an OBS link on the CDM console. Retain the default value No so that dirty data is not recorded.

   Figure 8 Configuring the task
   

4. Click Save and Run. The Job Management page is displayed, on which you can view the job execution progress and result.
5. After the job is successfully executed, in the Operation column of the job, click Historical Record to view the job's historical execution records and read/write statistics.

   On the Historical Record page, click Log to view the job logs.