在线迁移：客户端导入迁移源

本文档介绍如何通过客户端导入迁移源的方式将您的源端服务器在线迁移至 CVM。

迁移流程

通过客户端导入迁移进行在线迁移的流程如下图所示：

迁移步骤

步骤一：迁移前准备

• 在访问管理 > 云API密钥页面中创建并获取 SecretId 和 SecretKey。

• 获取目标环境的云API EndPoint域名地址。

• 建议您暂停主机上的应用程序并进行数据备份，以避免迁移时对现有应用程序可能产生的影响：

  • 源端主机：可以选择源服务器快照功能等方式备份数据，源端主机是指待迁移的主机。
  • 目标云服务器：可以选择 创建快照 等方式备份目标云服务器数据。

• 若您使用子账号进行控制台迁移：

  • 迁移目标为实例时，子账号需要 QcloudCSMFullAccess 和 QcloudCVMFullAccess 权限，您可以使用主账号登录访问管理 > 策略管理授予。
  • 迁移目标为云服务器镜像时，子账号需要 QcloudCSMFullAccess 、QcloudCVMFullAccess 和 QcloudCVMFinanceAccess 权限，您可以使用主账号登录访问管理 > 策略管理授予。

• 迁移前，需根据实际情况进行检查。检查内容如下表：

  • 若迁移目标为云服务器，则需检查源端主机及目标云服务器。

  • 若迁移目标为云服务器镜像，则仅需检查源端主机。

    Linux 源端主机	向云 API 发起迁移请求后，云 API 会使用当前 UNIX 时间检查生成的 Token，请确保当前系统时间无误。
    Windows 源端主机	检查和安装 Virtio，操作详情可参见 Windows 系统检查 Virtio 驱动。 （可选）检查和安装 Cloudbase-Init，详情请参见Windows 操作系统安装 Cloudbase-Init。您可以选择迁移前在源端主机安装，也可迁移后在目标实例安装： 若在迁移前安装，则迁移后将会进行自动配置网络、激活等初始化操作。 若未在迁移前安装，您可能需要使用 VNC 登录实例并手动修改网络配置。 建议您暂时关闭杀毒软件，以免误杀迁移工具而导致迁移失败。
    目标云服务器	存储空间：目标云服务器的云硬盘（包括系统盘和数据盘）的磁盘大小和数量需要大于等于源机器的磁盘配置。 安全组：安全组中开放80、443和3389端口。 带宽设置：建议尽可能调大两端的带宽，以便更快迁移。迁移过程中，会产生约等于数据量的流量消耗，如有必要请提前调整网络计费模式。 网络设置：若您的源段或者目的段主机只有 IPv6，不具备 IPv4，请参见 client.json 文件参数说明。

    说明：

    • 源端主机检查可以使用工具命令自动检查，如 sudo ./go2cloud_x64 --check。
    • go2cloud 迁移工具在开始运行时，默认自动检查是否满足迁移。如果需要略过检查并强制迁移，可以添加参数./go2cloud_x64 -ignore-check。

步骤二：导入迁移源

通过迁移工具导入迁移源

Linux 服务器

1. 联系架构师，获取在线迁移go2cloud.zip工具包。在待迁移的源端主机上传迁移工具 go2cloud.zip，并进入对应目录。

   • 复制
     复制成功

   unzip go2cloud.zip

   • 复制
     复制成功

   cd go2cloud/go2cloud-linux

   说明：

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

2. （可选）排除源端主机上不需迁移的文件或目录。 若 Linux 源端主机中存在不需要迁移的文件或目录，可将文件或目录添加至 rsync_excludes_linux.txt 文件 中。

3. 导入迁移源。

   1. 以64位 Linux 源端主机为例，以 root 权限依次执行以下命令运行工具。注意目标地域region和目标环境endpoint参数值需要自行替换。

      • 复制
        复制成功

      chmod +x go2cloud_x64

      • 复制
        复制成功

      sudo ./go2cloud_x64 -region xxxx -endpoint api3.xxxxxx.fsphere.cn

   2. 根据提示输入已在迁移前准备中获取的账户 API 访问密钥的 SecretId 和 SecretKey，并按 Enter。

      

      • 复制
        复制成功

      如果想免交互输入访问密钥，可以在命令行参数加上-secret-id和-secret-key，例如：

      • 复制
        复制成功

      sudo ./go2cloud_x64 -region xxxx -endpoint api3.xxxxx.fsphere.cn -secret-id xxxx -secret-key xxxxx

      当迁移工具界面出现如下图所示信息时，表示迁移源已经成功导入控制台，可前往控制台查看迁移源。

      

Windows 服务器

4. 将迁移工具包 go2cloud.zip 上传至源端主机，解压得到 go2cloud 文件夹，打开其中的 go2cloud-windows，得到如下所示的目录：

   

5. 以管理员身份打开 cmd 或 powershell 命令行 ：cd /d go2cloud_x64.exe 所在目录的绝对路径，运行 go2cloud_x64.exe 应用程序。注意目标地域region和目标环境endpoint参数值需要自行替换。

   • 复制
     复制成功

      .\go2cloud_x64.exe -region xxxx -endpoint api3.xxxxxx.fsphere.cn

6. 在弹窗中输入云API 访问密钥（SecretId 和 SecretKey）。如果想免交互输入访问密钥，可以在命令行参数加上-secret-id和-secret-key。

   

   

7. 当迁移工具界面出现如下图所示信息时，表示迁移源已经成功导入控制台，可前往控制台查看迁移源。

   

   说明：

   若未提示 Import source server successfully， 表示导入迁移源失败， 可查看日志（默认为迁移工具目录下的 logs/log 文件）解决问题之后重新运行迁移工具导入迁移源。

通过控制台查看迁移源

登录在线迁移控制台即可查看已导入的迁移源，状态为在线。

注意：

迁移源导入成功之后，请勿关闭实例中的迁移工具直至迁移任务完成。否则，迁移源离线之后，将无法完成迁移任务。迁移任务的操作依赖迁移源在线，请勿关闭迁移工具进程。

步骤三：创建迁移任务

1. 创建迁移任务

登录在线迁移控制台，单击目标迁移源所在行右侧的创建迁移任务。在弹出的创建迁移任务窗口中，参见以下信息进行配置。

迁移任务详细配置说明如下表：

• 基本选项：

  配置选项	是否必填	说明
  目的地域	是	源端主机要迁入的地域。地域请参见 地域和可用区。
  任务名称	是	迁移任务的名称。
  任务描述	否	迁移任务的描述。
  目标类型	是	设置迁移源迁移至该云平台的目标类型。 云服务器镜像：迁移任务完成之后将为迁移源生成目标该云平台镜像。 镜像名称：为迁移源生成的目标云平台镜像名称。镜像名称在目标地域重复时，迁移任务会自动添加任务 ID 到镜像名称中。 云服务器实例：选择一台目标地域的云服务器实例作为迁移目标。 目标实例：建议目标云服务器的操作系统尽量和源端主机的操作系统类型一致。例如，CentOS 7 系统的对源端主机迁移时，选择一台 CentOS 7 系统的云服务器作为迁移目标。
  镜像名称	是	迁移任务的目标类型为云服务器镜像时，您将得到一个自定义镜像，此处为镜像命名。镜像名称在目标地域重复时，迁移任务会自动添加任务 ID 到镜像名称中。
  网络模式	是	设置迁移传输数据时使用的网络类型。 公网传输：迁移传输数据到目标云服务器或中转实例时使用公网传输。 内网传输：迁移传输数据到目标云服务器或中转实例时使用内网传输。 私有网络：迁移到云服务器镜像时，中转实例将创建在该私有网络 VPC 中。 子网：迁移到云服务器镜像时，中转实例将创建在该子网中。
  迁移方式	是	设置 Linux 实例迁移数据的迁移方式类型，不同迁移方式的区别。 Linux 文件级迁移：迁移颗粒度为文件级，高兼容性，相对较低的传输效率。 Linux 块级迁移：迁移颗粒度为磁盘逻辑存储单位块级，高传输效率，相对较低的兼容性。
  		Windows 块级迁移：迁移颗粒度为磁盘逻辑存储单位块级，Windows 迁移默认采用块级迁移，具备高兼容性和高传输效率。
  配置增量同步	否	自定义配置增量同步时长，持续同步数据，灵活控制迁移交割时间。 不开启：由迁移工具自动识别并执行增量迁移，通常执行一次。 开启后：您可自主选择增量同步执行时长。开启后，工具在全量数据迁移完成后进入增量迁移，在您设置的时长内进行多轮增量数据同步，直至设置的时长到期，自动结束迁移。您也可以在任务列表手动停止增量同步，提前结束迁移。 增量同步开始后，您可在在线迁移 > 迁移任务控制台任务详情页查看增量同步记录。
  预约执行时间	否	创建迁移任务后，在设置的时间自动启动迁移任务。预约执行时间最早可设置为当前时间后10分钟。

• 高级配置(可选)：

  配置选项	是否必填	说明
  传输限制（KB/s）	否	迁移过程中，数据传输的带宽上限限制，单位为 KB/s，范围为[0, 25600]， 默认不限速。Windows 迁移暂不支持该选项。
  Checksum 验证	否	开启后，可增强数据一致性校验，但是可能会降低传输速度。Windows 迁移暂不支持该选项。

2. 启动迁移任务。

说明：

预约执行的任务可跳过本步骤，到达预约执行时间后，迁移任务将会自动开始执行。

创建迁移任务后，可单击迁移任务页签，查看迁移任务。

单击任务所在行右侧的开始/重试，并在弹出确认窗口中单击确定，即可开始迁移任务。此时任务状态变更为迁移中。

注意：

• 迁移目标是云服务器时，开始迁移后目标云服务器将进入迁移模式，请不要对目标云服务器进行重装系统、关机、销毁、重置密码等操作，直至迁移完成退出迁移模式。
• 迁移目标是云服务器镜像时，开始迁移后将在您的账户下创建一台名为 do_not_delete_csm_instance 的中转实例，请不要对中转实例进行重装系统、关机、销毁、重置密码等操作，直至迁移完成系统会自动销毁本次创建的中转实例。中转实例将会产生一定的费用，包含实例费用和云盘费用，需要您账户余额大于10元，前往计费管理充值。

步骤四：迁移后检查

1. 控制台查看迁移进度

当迁移任务状态为成功时，表示成功完成迁移。

说明：

• 由于传输数据耗时受源端数据大小，网络带宽等因素影响，请耐心等待迁移流程的完成。
• 迁移任务开始之后，支持在数据传输阶段暂停任务，您可在迁移任务所在行单击暂停，等待一段时间后，系统将停止迁移任务。
• 迁移工具支持断点续传，暂停任务之后，重新点击开始/重试即可从上次暂停点继续迁移。
• 如果迁移过程耗时太长，且需停止本次迁移，您可以先暂停迁移任务，并单击删除，即可取消本次迁移任务。

2. 迁移后检查

• 迁移结果失败：
  • 您可以在在线迁移控制台查看错误码，并查看文档 迁移失败指引 寻找对应解决指引；
  • 或者检查日志文件（默认为迁移工具logs目录下的 log 文件）的错误信息输出或者 服务器迁移类常见问题 进行排查和修复问题。修复后在迁移任务操作列单击开始/重试，即可重新开始迁移任务。
• 迁移结果成功：
  • 若迁移目标为云服务器，请检查目标云服务器能否正常启动、目标云服务器数据与源端主机是否一致、网络是否正常或者其他系统服务是否正常。
  • 若迁移目标为云服务器镜像，可单击迁移任务所在行的云服务器镜像 ID，进入云服务器 > 镜像页面 查看该镜像信息，您可使用该镜像创建云服务器。