tencent cloud

Boost Engagement with Tencent RTC Free TrialFree video and chat features await!

Feedback

Compatibility and Tool Configuration Description

Last updated: 2024-01-08 09:37:01

Supported Operating Systems

Operating systems supported by the online migration tool include but not limited to the following:
Linux
Windows
CentOS 5/6/7/8
Windows Server 2008
Windows Server 2012
Windows Server 2016
Windows Server 2019
Windows Server 2022
Ubuntu 10/12/14/16/18/20
Debian 7/8/9/10
SUSE 11/12/15
openSUSE 42
Amazon Linux AMI
Red Hat 5/6/7/8
Oracle Linux 5/6/7/8


Supported Migration Modes

Public network migration mode
Private network migration mode
If both your source server and destination CVM can access the public network, you can use the public network migration mode. In the current public network migration mode, the source server calls Tencent Cloud APIs through the Internet to initiate a migration request, and transfers data to the destination CVM to complete the migration. The public network migration scenario is shown below:


If your source server or destination CVM is located in a private network or Virtual Private Cloud (VPC), the source server cannot directly establish a connection with the destination CVM through the Internet. In this case, you can use the private network migration mode of the tool. You need to establish a connection between the source server and the destination CVM through VPC peering connection, VPN connections, Cloud Connect Network, or Direct Connect.
Scenario 1: This scenario is applicable to the migration via Online Migration Tool. If your source server or the destination CVM cannot access the public network, you can first access the Tencent Cloud API via the internet through a server with public network access (such as a gateway) to initiate a migration request, and then transfer data and migrate to the destination CVM through the connection. This scenario does not require the source server and destination CVM can access the public network.


Scenario 2: If your source server can access the public network, use the source server to call Tencent Cloud APIs through the Internet to initiate a migration request, and then transfer data to the destination CVM through the connection to complete the migration. This scenario requires the source server, but not the destination CVM, to be able to access the public network.


Scenario 3: If your source server can access the public network through a proxy, use the source server to call Tencent Cloud APIs through the network proxy to initiate a migration request, and then transfer data to the destination CVM through the connection to complete the migration. This scenario requires neither the source server nor the destination CVM to be able to access the public network.



Files in the Compressed Package

After go2tencentcloud.zip is decompressed, it contains the following files:
File Name
Description
go2tencentcloud-linux.zip
The migration zip for Linux system.
go2tencentcloud-windows.zip
The migration zip for Windows system.
readme.txt
Directory overview file.
release_notes.txt
Migration tool change log.
After go2tencentcloud-linux.zip is decompressed, it contains the following files:
File Name
Description
go2tencentcloud_x64
Executable program of the migration tool for the 64-bit Linux operating system.
go2tencentcloud_x32
Executable program of the migration tool for the 32-bit Linux operating system.
user.json
User information in the migration.
client.json
Configuration file of the migration tool.
rsync_excludes_linux.txt
rsync configuration file, which excludes files and directories that do not need to be migrated in the Linux system.
After go2tencentcloud-windows.zip is decompressed, it contains the following files:
File Name
Description
go2tencentcloud_x64.exe
Executable program of the migration tool for the 64-bit Windows operating system.
user.json
User information in the migration.
client.json
Configuration file of the migration tool.
client.exe
Executable program of the migration tool for the Windows operating system.
Note:
The configuration files cannot be deleted. You must store them under the same folder as the go2tencentcloud executable program.

Parameters in the user.json file

The user.json configuration file is described as below:
Parameter
Type
Required
Description
SecretId
String
Yes
Secret ID for your account to access APIs. For more information, see Access Key.
SecretKey
String
Yes
Secret key for your account to access APIs. For more information, see Access Key.

Parameters in the client.json file

The client.json configuration file is described as below:
Parameter
API Type
Required
Description
Client.Extra.IgnoreCheck
Bool
No
The default value is false. The default value is false. The migration tool automatically checks the source server environment upon startup by default. To skip the check, set this parameter to true.
Client.Extra.Daemon
Bool
No
The default value is false. If you need the migration tool to run in the background, set this parameter to true.
Client.Net.Proxy.Ip
String
No
The default value is empty. In the private network migration Scenario 3, the IP address of the network proxy needs to be configured.
Client.Net.Proxy.IPv6
Bool
No
It defaults to false. Set it to true if you want to transfer data via IPv6. Otherwise, the migration data will be transferred via IPv4.
Client.Net.Proxy.Port
String
No
The default value is empty. In the private network migration Scenario 3, the port of the network proxy needs to be configured.
Client.Net.Proxy.User
String
No
The default value is empty. In the private network migration Scenario 3, if your network proxy needs to be verified, configure the username of the network proxy.
Client.Net.Proxy.Password
String
No
The default value is empty. In the private network migration Scenario 3, if your network proxy needs to be verified, configure the password of the network proxy.
Note:
Except for the above parameters, other configuration items in the client.json file usually don't need to be entered.

rsync_excludes_linux.txt file description

This file is used to exclude files on the Linux source server or configuration files under specified directories that do not need to be migrated. By default, the rsync_excludes_linux.txt file already excludes the following directories and files. Do not delete or modify the existing configurations.
/dev/*
/sys/*
/proc/*
/var/cache/yum/*
/lost+found/*
/var/lib/lxcfs/*
/var/lib/docker-storage.btrfs/root/.local/share/gvfs-metadata/*
To exclude other directories or files, append them to the rsync_excludes_linux.txt file. For example, to exclude all content on the data disk attached to /mnt/disk1, configure the rsync_excludes_linux.txt file as follows:
/dev/*
/sys/*
/proc/*
/var/cache/yum/*
/lost+found/*
/var/lib/lxcfs/*
/var/lib/docker-storage.btrfs/root/.local/share/gvfs-metadata/*
/mnt/disk1/*

Parameters of the Migration Tool

Parameter
Description
--help
Prints help information.
--check
Checks the source server
--log-file
Configures the log file name, which is log by default.
--log-level
Configures the logging level. Valid values: 1(ERROR level), 2 (INFO level) and 3(DEBUG level). Default value: 2.
--version
Prints the version number.
--clean
Ends the migration task.

Contact Us

Contact our sales team or business advisors to help your business.

Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

7x24 Phone Support