云服务器
有奖：语音产品征文挑战赛火热进行中> HOT
文档中心 > 云服务器 > 操作指南 > 服务器迁移 > 在线迁移 > 迁移工具说明 > 兼容性与工具配置说明

兼容性与工具配置说明

最近更新时间：2024-05-29 17:02:41

我的收藏

本页目录：

支持的操作系统

目前在线迁移工具支持的源端主机操作系统包括但不限于以下操作系统：
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

支持的迁移模式

公网迁移模式
内网迁移模式
如果您的源端主机和目标云服务器都具有公网访问能力，则可以使用公网迁移模式进行迁移。 在目前的公网迁移模式中，源端主机通过互联网访问腾讯云 API 发起迁移请求，并向目标云服务器传输数据，将源端主机迁移至腾讯云的目标云服务器。公网迁移场景如下图所示：
?
?
?
如果您的源端主机或目标云服务器处于某个内网或 VPC 中，源端主机不能通过互联网直接与目标云服务器建立连接，则可以使用工具的内网迁移模式进行迁移。内网迁移模式需要通过使用如 VPC 对等连接、VPN 连接、云联网 或者 专线接入 等方式建立源端主机与目标云服务器的连接通道。
?
场景1
：（该场景仅支持 使用工具迁移）如果您的源端主机或目标云服务器不能访问公网，则可以先通过一台拥有公网访问能力的主机（如网关）以互联网方式访问腾讯云 API 发起迁移请求，再通过连接通道向目标云服务器传输数据进行迁移。此场景不要求对源端主机和目标云服务器具有公网访问能力。
?
?
?
场景2
：如果您的源端主机可以访问公网，则可以先在源端主机上通过互联网访问腾讯云 API 发起迁移请求，再通过连接通道向目标云服务器传输数据进行迁移。此场景要求对源端主机具有公网访问能力，而目标云服务器则不要求。
?
?
?
场景3
：如果您的源端主机可以通过代理访问公网，则可以先在源端主机上通过网络代理访问腾讯云 API 发起迁移请求，再通过连接通道向目标云服务器传输数据进行迁移。此场景不要求对源端主机和目标云服务器具有公网访问能力。
?
?

压缩包文件说明

go2tencentcloud.zip 解压后，文件说明如下：
文件名
说明
go2tencentcloud-linux.zip
Linux 系统的迁移压缩包。
go2tencentcloud-windows.zip
Windows 系统的迁移压缩包。
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-windows.zip 解压后，文件说明如下：
文件名
说明
go2tencentcloud_x64.exe
64位 Windows 系统的迁移工具可执行程序。
user.json
迁移时的用户信息。
client.json
迁移工具的配置文件。
client.exe
Windows 系统的迁移可执行程序。
注意：
不能删除配置文件，并请将配置文件存放在和 go2tencentcloud 可执行程序同级目录下。

user.json 文件参数说明

user.json 配置文件说明如下表：
参数名称
类型
是否必填
说明
SecretId
String
是
账户 API 访问密钥 SecretId，详细信息请参见 访问密钥。
SecretKey
String
是
账户 API 访问密钥 SecretKey，详细信息请参见 访问密钥。
Region
String
是
目标云服务器的地域，只需填写地域，无需填写可用区，取值请参见 地域 列表。
InstanceId
String
是
目标云服务器 CVM 的实例 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.Extra.IgnoreCheck
Bool
否
默认值为 false，迁移工具默认在工具开始运行时自动检查源端主机环境，如果需要略过检查，请设置为 true。
Client.Extra.Daemon
Bool
否
默认值为 false，如果需要迁移工具后台运行，请设置为 true。
Client.Net.Proxy.Ip
String
否
默认值为空，若迁移场景为内网迁移 场景3 时，需要配置网络代理的 IP 地址。
Client.Net.Proxy.IPv6
Bool
否
默认值为 false，若您期望使用 IPv6（例如迁移场景中源端或对端只有 IPv6 IP 的情况下）传输数据，需要您将此选项设置为 true，否则，迁移流量将通过 IPv4 传输。
Client.Net.Proxy.Port
String
否
默认值为空，若迁移场景为内网迁移 场景3 时，需要配置网络代理的端口。
Client.Net.Proxy.User
String
否
默认值为空，若迁移场景为内网迁移 场景3 ，且您的网络代理还需认证时，需要配置网络代理的用户名。
Client.Net.Proxy.Password
String
否
默认值为空，若迁移场景为内网迁移 场景3 ，且您的网络代理还需认证时，需要配置网络代理的密码。
说明：
除上述参数，client.json 文件剩余配置项通常无需填写。

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
打印帮助信息。
--check
对源端主机进行检查
--log-file
设置日志文件名称，默认为 log。
--log-level
日志输出级别，取值范围为1（ERROR 级别），2（INFO 级别）和3（DEBUG 级别），默认值为2。
--version
打印版本号。
--clean
终止迁移任务。

迁移失败指引

在控制台服务器迁移操作后，会因为一些原因导致任务失败。在任务失败的情况下，您可以在 控制台 查看错误码，并根据以下内容进行排查。
错误码
错误说明
指引
ERROR_REMOTE_INSTANCE_STATUS_NOT_VALID
当前迁移目标实例状态不允许迁移
仅支持运行中和已关机的实例作为迁移目标实例。
ERROR_SAME_INSTANCE
源实例和目标实例相同，不允许迁移
请更换目标实例后重新发起迁移任务。
ERROR_NO_IPV6
目标实例 IPV6 地址缺失
目标实例没有 IPv6 地址，您可以使用 IPv4 地址进行迁移。
ERROR_NO_PUBLIC_IP
目标实例没有公网 IP，无法使用公网模式迁移
目标实例没有公网 IP，无法使用公网模式迁移，您可以将云上的目标实例分配一个弹性公网IP，或者使用内网模式迁移。
ERROR_SAME_IP
内网迁移模式下，源实例内网 ip 和目标实例内网 ip 相同，无法建立连接
您可以采用公网模式进行迁移；或者更换目标实例的内网 IP。
ERROR_OS_NOT_MATCH
Windows 与 Linux 实例不能互相迁移
Windows 系统的实例只能迁移到 Windows 实例上。Linux 系统的实例只能迁移到 Linux 的实例上。您可以更换目标实例重新迁移。
ERROR_INSTANCE_TYPE_NOT_SUPPORTED
目标实例的实例类型暂不支持作为迁移目标
方法一：您可以将迁移目标设置为镜像，得到自定义镜像后，再选择您需要的实例类型基于此自定义镜像创建实例。
方法二：您可以先迁移到另一台支持的类型（例如标准型 SA5 等）的实例上，迁移后创建自定义镜像，再选择您需要的实例类型基于此自定义镜像创建实例。
ERROR_SEC_GROUP_PORT_NOT_OPEN3
目标实例安全组80、443、3389端口未开放
您可在控制台开放您相应的安全组端口。
ERROR_ADD_MORE_DISK
目标实例数据盘数量不够
您可以增加目标实例的数据盘数量，以达到迁移的要求。
ERROR_SYSTEM_DISK_SIZE_NOT_ENOUGH
目标实例系统盘空间不足
您可以扩容系统盘，以达到迁移的要求。
ERROR_ENTER_MIGRATE_MODE
目标实例进入迁移模式失败
请您联系客服协助。
ERROR_HOST_TO_HOST_CONNECTION
迁移源无法连接到目标实例
请您联系客服协助。
ERROR_INIT_SERVER
初始化目标服务器失败
请您联系客服协助。
ERROR_DATA_TRANSMISSION
数据传输失败
请您联系客服协助。
中国站
http://www.vxiaotou.com