文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>购买指导

迁移工具 go2tencentcloud 说明

最近更新时间：2024-11-22 17:34:42

我的收藏

本页目录：

本文对迁移工具go2tencentcloud进行说明，您可以执行以下命令 下载 迁移工具压缩包 go2tencentcloud.zip。
wget https://go2tencentcloud-1251783334.cos.ap-guangzhou.myqcloud.com/latest/go2tencentcloud.zip

压缩包文件说明

go2tencentcloud.zip 解压后，文件说明如下：
文件名
说明
go2tencentcloud-linux.zip
Linux 系统的迁移压缩包。
readme.txt
目录简介文件。
release_notes.txt
迁移工具变更日志。
go2tencentcloud-linux.zip 解压后，文件说明如下：
文件名
说明
go2tencentcloud_x64
64位 Linux 系统的迁移工具可执行程序。
go2tencentcloud_x32
32位 Linux 系统的迁移工具可执行程序。
user.json
迁移时的用户信息。
client.json
迁移工具的配置文件。
rsync_excludes_linux.txt
rsync 配置文件，排除 Linux 系统下不需要迁移的文件目录。
注意
不能删除配置文件，并请将配置文件存放在和 go2tencentcloud 可执行程序同级目录下。

user.json 文件参数说明

user.json 配置文件说明如下表：
参数名称
类型
是否必填
说明
SecretId
String
是
账户 API 访问密钥 SecretId，详细信息请参见 访问密钥。
SecretKey
String
是
账户 API 访问密钥 SecretKey，详细信息请参见 访问密钥。
Region
String
是
目标云服务器的地域，只需填写地域，无需填写可用区，取值请参见 地域 列表。
InstanceId
String
是
目标云服务器的实例 ID，形如 ins-xxxxxxxx。
DataDisks
Array
否
源端主机待迁移数据盘列表，每一个元素代表一块数据盘，最多支持20块数据盘。
DataDisks.Index
Integer
否
数据盘序号，取值范围[1,20]，值为1代表该块数据盘将迁移至目标云服务器挂载的第一块数据盘，值为2代表迁移至目标云服务器挂载的第二块数据盘，以此类推。
DataDisks.Size
Integer
否
源端数据盘大小，单位 GB，取值范围[10,16000]。
DataDisks.MountPoint
String
否
源端数据盘挂载点，如 "/mnt/disk1"。
您可参考以下的示例，结合实际业务场景修改配置文件。
示例1：将一台 Linux 源端主机迁移至腾讯云广州地域的一台云服务器中，user.json 文件配置为以下内容：
{  
 "SecretId": "your secretId",
 "SecretKey": "your secretKey",  
 "Region": "ap-guangzhou",  
 "InstanceId": "your instance id"
}
示例2：将一台 Linux 源端主机（包含一块数据盘，挂载点为 /mnt/disk1，大小为10GB）迁移至腾讯云广州地域的一台目标云服务器（至少挂载一块数据盘），user.json 文件配置为以下内容：
{  
 "SecretId": "your secretId",
 "SecretKey": "your secretKey",  
 "Region": "ap-guangzhou",  
 "InstanceId": "your instance id",
 "DataDisks": [
     {
         "Index": 1,
         "Size": 10,
         "MountPoint": "/mnt/disk1"
     }
 ]
}
示例3：将一台 Linux 源端主机（包含两块数据盘，盘1挂载点为 /mnt/disk1，大小为10GB，欲迁移至目标云服务器的第一块数据盘，盘2挂载点为 /mnt/disk2，大小为20GB，欲迁移至目标云服务器的第二块数据盘）迁移至腾讯云广州地域的一台目标云服务器（至少挂载两块数据盘），user.json 文件配置为以下内容：
{  
 "SecretId": "your secretId",
 "SecretKey": "your secretKey",  
 "Region": "ap-guangzhou",  
 "InstanceId": "your instance id",
 "DataDisks": [
     {
         "Index": 1,
         "Size": 10,
         "MountPoint": "/mnt/disk1"
     },
     {
         "Index": 2,
         "Size": 20,
         "MountPoint": "/mnt/disk2"
     }
 ]
}

client.json 文件参数说明

client.json 配置文件说明如下表：
参数名称
类型
是否必填
说明
Client.ToolMode
bool
否
工具迁移模式标识参数，默认值为 false。若使用工具模式迁移，请修改为 true 或运行工具时添加 --no-console 参数。
Client.Net.Mode
Integer
是
迁移模式参数，默认使用公网传输，值为0，取值范围：0（公网迁移模式）、1（内网迁移模式：场景1）、2（内网迁移模式：场景2）、3（内网迁移模式：场景3）。
Client.Extra.IgnoreCheck
Bool
否
默认值为 false，迁移工具默认在工具开始运行时自动检查源端主机环境，如需要跳过检查，请设置为 true。
Client.Rsync.BandwidthLimit
String
否
限速配置项，单位为 KBytes/s，默认值为空，即默认传输时不限速。
Client.Rsync.Checksum
Bool
否
传输校验项，设为 true 后可加强传输一致性校验，但会提高源端主机 CPU 负载和减慢传输速度。默认值为 false，即默认不校验。
如果源端主机和目标云服务器任何一方不能直接访问公网，则可以选择先通过 VPC 对等连接、VPN 连接、云联网 或者 专线接入 等方式建立连接通道，再进行内网模式迁移。请根据您的源端主机和目标云服务器的网络环境，确定适合的迁移模式。

rsync_excludes_linux.txt 文件说明

排除 Linux 源端主机中不需要迁移传输的文件，或指定目录下的配置文件。该文件中已经默认排除以下目录和文件，请勿删改。
/dev/*
/sys/*
/proc/*
/var/cache/yum/*
/lost+found/*
/var/lib/lxcfs/*
/var/lib/docker-storage.btrfs/root/.local/share/gvfs-metadata/*
如果您需要排除其他目录和文件，请在该文件尾部追加内容。例如，排除挂载在 /mnt/disk1 的数据盘的所有内容。
/dev/*
/sys/*
/proc/*
/var/cache/yum/*
/lost+found/*
/var/lib/lxcfs/*
/var/lib/docker-storage.btrfs/root/.local/share/gvfs-metadata/*
/mnt/disk1/*

工具运行参数说明

参数选项
说明
--help
打印帮助信息。
--no-console
仅使用工具模式迁移（非控制台模式迁移）。
--check
对源端主机进行检查
--log-file
设置日志文件名称，默认为 log。
--log-level
日志输出级别，取值范围为1（ERROR 级别），2（INFO 级别）和3（DEBUG 级别），默认值为2。
--clean
目标云服务器强制退出迁移模式，清理现场。例如，如果控制台提示 Please execute '--clean' option manually.，则需要使用此选项执行工具使目标云服务器退出迁移模式。
--version
打印版本号。

如有任何疑问、迁移异常等问题请查看 服务器迁移类常见问题 或者 联系我们 解决。
中国站
目录