操作指南

最佳实践

故障处理

API 文档

诚邀爱技术、爱分享的你,成为文档内容共建者> HOT

本文介绍如何使用 go2tencentcloud 迁移工具,进行 Linux 系统服务器在线迁移。

准备事项

  • 已具备腾讯云账号,及目标云服务器。
  • 建议暂停源端服务器上的应用程序,以避免迁移时对现有应用程序可能产生的影响。
  • 下载 迁移工具压缩包。
  • API密钥管理 页面中创建并获取 SecretIdSecretKey
  • 检查源端主机和目标云服务器是否满足迁移条件。例如,目标云服务器的云硬盘必须具备足够的存储空间用来装载源端的数据。
  • 建议您在迁移前,通过下方式进行数据备份:
    • 源端主机:可以选择源服务器快照功能等方式备份数据。
    • 目标云服务器:可以选择 创建快照 等方式备份目标云服务器数据。

迁移工具包说明

压缩包文件说明

go2tencentcloud.zip 解压后,文件说明如下:

文件名说明
go2tencentcloud-linux.zipLinux 系统的迁移压缩包。
readme.txt目录简介文件。
release_notes.txt迁移工具变更日志。

go2tencentcloud-linux.zip 解压后,文件说明如下:

文件名说明
go2tencentcloud_x6464位 Linux 系统的迁移工具可执行程序。
go2tencentcloud_x3232位 Linux 系统的迁移工具可执行程序。
user.json迁移时的用户信息。
client.json迁移工具的配置文件。
rsync_excludes_linux.txtrsync 配置文件,排除 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 打印版本号。

迁移步骤

备份数据

  • 源端主机:可以选择源服务器快照功能等方式备份数据。
  • 目标云服务器:可以选择 创建快照 等方式备份数据。

迁移前的检查

迁移前,需要分别检查源端主机和目标云服务器。检查内容如下表:

目标云服务器
  1. 存储空间:目标云服务器的云硬盘(包括系统盘和数据盘)必须具备足够的存储空间用来装载源端的数据。
  2. 安全组:安全组中不能限制443端口和80端口。
  3. 带宽设置:建议尽可能调大两端的带宽,以便更快迁移。迁移过程中,会产生约等于数据量的流量消耗,如有必要请提前调整网络计费模式。
  4. 目标云服务器和源端主机的操作系统类型是否一致:操作系统不一致会造成后续制作的镜像的信息与实际操作系统不符,建议目标云服务器的操作系统尽量和源端主机的操作系统类型一致。例如,CentOS 7 系统的对源端主机迁移时,选择一台 CentOS 7 系统的云服务器作为迁移目标。
Linux 源端主机
  1. 检查和安装 Virtio,操作详情可参考 Linux 系统检查 Virtio 驱动
  2. 执行 which rsync 命令检查是否安装了 rsync。如未安装,请参考 如何安装 Rsync 进行安装。
  3. 检查 SELinux 是否已打开。如果 SELinux 已打开,请参考 如何关闭 SELinux 进行关闭。
  4. 向腾讯云 API 发起迁移请求后,云 API 会使用当前 UNIX 时间检查生成的 Token,请确保当前系统时间无误。
说明
  • 源端主机检查可以使用工具命令自动检查,如 ./go2tencentcloud_x64 --no-console --check
  • go2tencentcloud 迁移工具在开始运行时,默认自动检查。如果需要略过检查强制迁移,请将 client.json 文件中的 Client.Extra.IgnoreCheck 字段配置为 true

开始迁移

腾讯云提供的 go2tencentcloud 迁移工具支持断点传输,并将整个迁移过程主要划分为以下三个阶段,用户可以在工具运行过程中直观的了解迁移的进度。

  • 阶段1:目标云服务器进入迁移模式,准备迁移
  • 阶段2:目标云服务器处于迁移模式,迁移数据中
  • 阶段3:目标云服务器退出迁移模式,迁移完成

每个阶段均会产生一些子任务去执行相关操作,部分耗时的子任务还将具有默认的最大超时时间。由于传输数据耗时受源端数据大小,网络带宽等因素影响,请耐心等待迁移流程的完成。

注意

开始迁移后目标云服务器将进入迁移模式,请不要对目标云服务器进行重装系统、关机、销毁、重置密码等操作,直至迁移完成退出迁移模式。

  1. 将迁移工具 go2tencentcloud.zip 下载或上传至源端主机,并执行以下命令进入对应目录。
    1. 依次执行以下命令,解压 go2tencentcloud.zip 并进入目录。
      unzip go2tencentcloud.zip
      cd go2tencentcloud
    2. 依次执行以下命令,解压 go2tencentcloud-linux.zip 并进入目录。
      unzip go2tencentcloud-linux.zip
      cd go2tencentcloud-linux
      说明

      go2tencentcloud 目录下的文件将不会被迁移,请勿将需迁移的文件放置在该目录下。

  2. user.json 文件配置目标云服务器。
    请按照 user.json 文件参数说明 配置必填项和所需项的值。
  3. client.json 文件配置迁移模式和其他项。
    client.json 文件里的 Client.ToolMode 值设置为 true,即标识工具模式迁移。此外,如果还需要进行其他项设置,请按照 client.json 文件参数说明 进行配置。
  4. (可选)排除源端主机上不需迁移的文件或目录。
    若 Linux 源端主机中存在不需要迁移的文件或目录,可将文件或目录添加至 rsync_excludes_linux.txt 文件
  5. 运行工具。
    例如,在64位 Linux 源端主机下,以 root 权限执行以下命令运行工具。
    sudo ./go2tencentcloud_x64 
    注意

    若您未修改 client.json 中的 Client.ToolModetrue ,则运行工具时需要添加参数 --no-console,如下:

    sudo ./go2tencentcloud_x64 --no-console


    工具运行后,请耐心等待迁移流程的完成。一般公网迁移模式下,迁移成功的控制台输出如下图所示:

迁移后的检查

  • 若迁移结果失败,则请检查日志文件(默认为迁移工具目录下的 log 文件)的错误信息输出、指引文档或者 服务迁移类常见问题 进行排查和修复问题。
  • 若迁移结果成功,则请检查目标云服务器能否正常启动、目标云服务器数据与源端主机是否一致、网络是否正常或者其他系统服务是否正常等。

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

目录