Deploy OMS on a single node

This topic describes how to deploy OceanBase Migration Service (OMS) on a single node by using deployment tools.

Prerequisites

• The installation environment meets the system requirements. For more information, see System requirements.

• The MetaDB cluster is prepared as the OMS MetaDB.

• The OMS installation package is obtained. Generally, the package is a tar.gz file whose name starts with oms.

• The downloaded OMS image file has been loaded to the local image repository of the Docker container.

  docker load -i <Storage path of the OMS image>

  In this example, the name of the loaded image file is OMS_IMAGE. You need to replace it with the actual name of your image file.

Deploy OMS without the configuration file

1. Log on to the server where OMS is to be deployed.

2. Optional. Deploy a time-series database.

   If you need to collect and display OMS monitoring data, deploy a time-series database. Otherwise, you can skip this step. For more information, see Deploy a time-series database.

3. Run the following command to obtain the deployment script from the loaded image:

   sudo docker run -d --net host --name oms-config-tool <OMS_IMAGE> bash && sudo docker cp oms-config-tool:/root/docker_remote_deploy.sh . && sudo docker rm -f oms-config-tool
   

4. Use the deployment script to start the deployment tool.

   sh docker_remote_deploy.sh -o <deploy_tool_workdir> -i <IP address of the server> -d <OMS_IMAGE>
   

5. Follow the prompts to complete the deployment. After you set each parameter, press Enter to move on to the next parameter.

   1. Select the deployment mode.

      Select Single Node in Single Region.

   2. Select the task.

      Select No Configuration File. Deploy OMS Starting from Configuration File Generation.

   3. Specify the following MetaDB information:

      1. IP address of the MetaDB

      2. Port number of the MetaDB

      3. Username used to connect to the MetaDB

      4. Password used to connect to the MetaDB

      5. Prefix for names of databases in the MetaDB

         For example, if you set the prefix to oms, the final database names are oms_rm, oms_cm, and oms_cm_hb.

   4. Confirm your settings.

      If the settings are correct, enter y and press Enter to proceed. Otherwise, enter n and press Enter to modify the settings.

   5. If the system displays "The specified database names already exist in the metadatabase. Are you sure that you want to continue?", it indicates that the database names you specified already exist in the MetaDB. This may be caused by repeated deployment or upgrade of OMS. You can enter y and press Enter to proceed, or enter n and press Enter to re-specify the settings.

   6. Perform the following operations to configure the Cluster Manager (CM) service of OMS:

      1. Check whether the obtained default IP address is correct.

         The displayed IP address must be the same as the vale of the field that you specified when you start the deployment tool. If the IP address is correct, enter y and press Enter to proceed. Otherwise, enter n and press Enter to modify it.

      2. The page displays the OMS cluster settings. Note that the value of the cm_url field must the IP address of the server. If the settings are correct, enter y and press Enter to proceed. Otherwise, enter n and press Enter to modify the settings.

   7. Confirm whether to enable OMS historical data monitoring.

      • If you have deployed a time-series database, enter y and press Enter to go to the next step to configure the time-series database and enable the monitoring of OMS historical data.

      • If you did not deploy a time-series database, enter n and press Enter to go to the step of "determining whether to enable the audit log feature and setting Simple Log Service (SLS) parameters". In this case, OMS does not monitor the historical data after deployment.

   8. Configure the time-series database.

      Perform the following operations:

      1. Confirm whether you have deployed a time-series database.

         If yes, enter y and press Enter. If not, enter n and press Enter to go to the step of "determining whether to enable the audit log feature and setting SLS parameters".

      2. Set the type of the time-series database to INFLUXDB.

         Notice:

         At present, only INFLUXDB is supported.

      3. Enter the URL of the time-series database.

         You can separately enter the IP address and port number in the URL, or use a colon (:) to join the IP address and port number in the : format.

      4. Enter the username used to connect to the time-series database.

      5. Enter the password used to connect to the time-series database.

      6. Confirm whether the displayed settings are correct.

         If the settings are correct, enter y and press Enter to proceed. Otherwise, enter n and press Enter to modify the settings.

   9. Determine whether to enable the audit log feature and set SLS parameters.

      To enable the audit log feature, enter y and press Enter to go to the next step to specify the SLS parameters.

      Otherwise, enter n and press Enter to start the deployment. In this case, OMS does not audit the logs after deployment.

   10. Specify the following SLS parameters:

   11. URL of the SLS domain

   12. access-key used to access SLS

   13. secret-key used to access SLS

   14. user-site-topic of SLS

   15. ops-site-topic of SLS

   16. Confirm whether the displayed settings are correct.

   If the settings are correct, enter y and press Enter to proceed. Otherwise, enter n and press Enter to modify the settings.

   11. Perform the following operations to specify additional information that is required in the single-node deployment:

   12. Specify the username used to connect to the server.

   13. Specify the password used to connect to the server.

   14. Specify the path of the config.yaml file, which must end with a slash (/).

   15. Specify the root directory to which the OMS container is mounted in the host.

       Use a directory with a large capacity.

   16. Confirm whether the OMS image file can be named as OMS_IMAGE.

       If yes, enter y and press Enter to proceed. Otherwise, enter n and press Enter to modify it.

   17. Confirm whether to install a Secure Sockets Layer (SSL) certificate for the OMS container.

       If yes, enter y, press Enter, and specify the https_key and https_crt directories as prompted. If not, enter n and press Enter.

   18. Start the deployment.

Deploy OMS with the configuration file available

1. Log on to the server where OMS is to be deployed.

2. Optional. Deploy a time-series database.

   If you need to collect and display OMS monitoring data, deploy a time-series database. Otherwise, you can skip this step. For more information, see Deploy a time-series database.

3. Run the following command to obtain the deployment script from the loaded image:

   sudo docker run --name oms-config-tool <OMS_IMAGE> bash && sudo docker cp oms-config-tool:/root/docker_remote_deploy.sh . && sudo docker rm -f oms-config-tool
   

4. Use the deployment script to start the deployment tool.

   sh docker_remote_deploy.sh -o <deploy_tool_workdir> -c <directory of the config.yaml file> -i <IP address of the server> -d <OMS_IMAGE>
   

   Note:

   For more information about settings of the config.yaml file, see the "Template and example of the configuration file" section.

5. Follow the prompts to complete the deployment. After you set each parameter, press Enter to move on to the next parameter.

   1. Select the deployment mode.

      Select Single Node in Single Region.

   2. Select the task.

      Select Use Configuration File Uploaded with Script Option [-c].

   3. If the system displays "The specified database names already exist in the metadatabase. Are you sure that you want to continue?", it indicates that the database names you specified already exist in the MetaDB. This may be caused by repeated deployment or upgrade of OMS. You can enter y and press Enter to proceed, or enter n and press Enter to re-specify the settings.

   4. If the configuration file passes the check, all the settings are displayed. If the settings are correct, enter y and press Enter to proceed. Otherwise, enter n and press Enter to modify the settings.

      If the configuration file fails the check, modify the configuration information as prompted.

   5. Perform the following operations to specify additional information that is required in the single-node deployment:

      1. Specify the username used to connect to the server.

      2. Specify the password used to connect to the server.

      3. Specify the path of the config.yaml file, which must end with a slash (/).

      4. Specify the root directory to which the OMS container is mounted in the host.

         Use a directory with a large capacity.

      5. Confirm whether the OMS image file can be named as OMS_IMAGE.

         If yes, enter y and press Enter to proceed. Otherwise, enter n and press Enter to modify it.

      6. Confirm whether to install an SSL certificate for the OMS container.

         If yes, enter y, press Enter, and specify the https_key and https_crt directories as prompted. If not, enter n and press Enter.

   6. Start the deployment.

Template and example of the configuration file

Configuration file template

Notice:

• You must replace the sample values of required parameters based on your actual deployment environment. Optional parameters are commented in this example. You can modify the optional parameters or uncomment the parameters as needed.

• In the config.yaml file, you must specify the parameters in the key: value format, with a space after the colon (:).

# Information about the OMS MetaDB
oms_meta_host: ${oms_meta_host}
oms_meta_port: ${oms_meta_port}
oms_meta_user: ${oms_meta_user}
oms_meta_password: ${oms_meta_password}

# You can customize the names of the following three databases, which are created in the MetaDB when you deploy OMS.
drc_rm_db: ${drc_rm_db}
drc_cm_db: ${drc_cm_db}
drc_cm_heartbeat_db: ${drc_cm_heartbeat_db}

# The user that consumes the incremental data of OceanBase Database.
# To read incremental logs of OceanBase Database, create the user in the sys tenant.
# You must create the drc_user in the sys tenant of the OceanBase cluster to be migrated and specify the drc_user in the config.yaml file.
drc_user: ${drc_user}
drc_password: '${drc_password}'

# Configurations of the OMS cluster
# In single-node deployment mode, the IP address of the server where OMS is deployed is used. We recommend that you use an internal IP address.
cm_url: ${cm_url}
cm_location: ${cm_location}
# The cm_region parameter is not required for single-node deployment.
# cm_region: ${cm_region}
cm_is_default: true
cm_nodes:
 - ${cm_nodes}

# Configurations of the time-series database
# Default value: false. To enable metric reporting, set the parameter to `true`.
# tsdb_enabled: false
# If the `tsdb_enabled` parameter is set to `true`, delete comments for the following parameters and specify the values based on your actual configurations.
# tsdb_service: 'INFLUXDB'
# tsdb_url: '${tsdb_url}'
# tsdb_username: ${tsdb_user}
# tsdb_password: ${tsdb_password}

Example

oms_meta_host: xxx.xxx.xxx.1
oms_meta_port: 2883
oms_meta_user: root@oms#obcluster
oms_meta_password: oms
drc_rm_db: oms_rm
drc_cm_db: oms_cm
drc_cm_heartbeat_db: oms_cm_heartbeat
drc_user: drc_user_name
drc_password: 'OceanBase#oms'
cm_url: http://xxx.xxx.xxx.2:8088
cm_location: 100
cm_region: cn-anhui
cm_is_default: true
cm_nodes:
  - xxx.xxx.xxx.2
tsdb_service: 'INFLUXDB'
tsdb_enabled: true
tsdb_url: 'xxx.xxx.xxx.4:8086'
tsdb_username: username
tsdb_password: 123456