使用迁云工具

使用迁云工具前，您需要注意：

• 确保系统本地时间与实际时间一致，否则会报错 IllegalTimestamp 异常。

• 待迁云的源服务器必须能够访问公网，且防火墙入方向必须放行下列通信端口以访问相关公网服务：

  • 通过 HTTP 80 端口访问 ECS 和 VPC：http://ecs-cn-hangzhou.aliyuncs.com 和 http://vpc.aliyuncs.com

  • 通过 HTTPS 443 端口访问 STS：https://sts.aliyuncs.com

  • 通过 8080 和 8703 代理端口访问中转实例的公网 IP 地址

• 迁云工具暂不支持迁移增量数据。对于源服务器上需要保持数据完整的业务，您可以选择一个业务空闲时段，暂时停止这些业务，再迁移数据。

• 为避免迁云失败，请勿停止、重启或者释放中转实例。迁云完成后，该中转实例会自动释放。

• 每成功迁云一次，配置文件 client_data 会自动记录迁云成功后在 ECS 控制台创建的 ECS 实例的相关数据。再次迁云时，您需要使用初始下载的客户端配置文件。

  说明：为避免迁云失败，若您没有 VPC 内网迁云需求，请勿自行修改配置文件 client_data。

• 迁云工具需要使用 AccessKeyID 以及 AccessKeySecret，AccessKey 是您的重要凭证，请妥善保管，防止泄露。

• 如果您使用的是 RAM 子账号，请确保您已被授权云服务器 ECS AliyunECSFullAccess 权限和专有网络 VPC AliyunVPCFullAccess 权限。更多详情，参阅 RAM 文档 授权策略管理。

Linux 服务器注意事项

当您的源服务器为 Linux 系统时，会有以下额外要求：

• 源服务器必须已经安装了 Rsync 库：

  • CentOS：运行 yum install rsync –y。

  • Ubuntu：运行 apt-get install rsync –y。

  • Debian：运行 apt-get install rsync –y。

  • 其他发行版：参考发行版官网安装相关的文档。

• 确保源服务器已关闭 SELinux。您可以运行 setenforce 0 临时关闭 SELinux。同时，建议您在 /etc/selinux/config 中，设置 SELINUX=disabled，禁用 SELinux。

• 确保源服务器已 安装 Virtio（KVM）驱动。

• （可选）对于 CentOS 5、Red Hat 5 和 Debian 7 等系统，需要 更新 GRUB 程序至 1.99 及以上版本。

步骤 1. 下载迁云工具

下载 迁云工具压缩包。解压后包含的文件列表如下：

• Windows 服务器

  文件（夹）名	描述
  Excludes 文件夹	过滤筛选文件夹，设置不迁云的路径，默认包含 rsync_excludes_win.txt
  client_data	迁云过程中的数据文件，包含ECS 中转实例信息、迁移进度等。
  user_config.json	源服务器信息配置文件
  go2aliyun_gui.exe	迁云工具 Windows GUI 版本主程序，详情请参阅 迁云工具 Windows GUI 版本介绍
  go2aliyun_client.exe	迁云工具命令行版本主程序

• Linux 服务器

  文件（夹）名	描述
  Check	检测工具文件夹，默认包含辅助程序 client_check
  client_data	迁云过程中的数据文件
  user_config.json	源服务器信息配置文件
  Excludes文件夹	过滤筛选文件夹，设置不迁云的路径，默认包含rsync_excludes_linux.txt
  go2aliyun_client	迁云工具主程序

步骤 2. 使用迁云工具

1. 登录待迁云的服务器、虚拟机或者云主机。

2. 将下载的迁云工具压缩包解压到您指定的目录。

3. 在控制台 创建 Access Key，用于输出到配置文件 user_config.json 里。

4. 根据您的实际情况，编辑配置文件 user_config.json 和 过滤无需迁云的目录。

5. 以管理员或 root 用户身份运行迁云工具：

   • Windows 服务器：右击 go2aliyun_client.exe，选择 以管理员身份运行。GUI 版本程序操作指南请参阅 迁云工具 Windows GUI 版本介绍。

   • Linux 服务器：

     1. 运行 chmod +x ./go2aliyun_client。

     2. 运行 ./go2aliyun_client。

6. 等待运行结果：

   • 当出现 Goto Aliyun Finished! 提示时，前往 ECS 控制台 镜像详情页查看结果。

   • 当出现 Goto Aliyun Not Finished! 提示时，检查同一目录下 Logs 文件夹下的日志文件 排查故障。修复问题后，重新 运行迁云工具 恢复迁云工作，迁云工具会从上一次执行的进度中继续迁云。

     您需要注意的是，迁云中断后再次执行工具时或者工具会提示迁云已完成时都是从 client_data 文件拉取信息。迁云工作完成后再次运行想重新迁云工具时，您需要使用初始的 client_data 文件或者清空现有的 client_data 文件数据。

     说明：初始化 client_data 文件后，任务进度信息丢失并且迁云工作会从头开始。在诸如中转实例被意外释放释放或者 VPC、VSwitch 和安全组信息错误等原因导致的迁云中断事件中，您可以在排查故障后使用初始化的 client_data 文件。

编辑 user_config.json

user_config.json 是一个以 JSON 语言编写的配置文件，主要包含源服务器的一些必要配置信息，其中包括您的 AccessKey 信息、生成的目标自定义镜像的配置信息等。您需要手动配置部分参数，修改后，仔细检查 JSON 语言格式的规范性，关于 JSON 的语法标准请参阅 RFC 7159。

如果您使用的 Windows GUI 版本主程序，您可以在 GUI 界面完成 user_config 配置。相关参数，更多详情，请参阅 迁云工具 Windows GUI 版本介绍。

user_config.json 模板

以下是配置文件 user_config.json 的模板：

1. {
2. "access_id": "",
3. "secret_key": "",
4. "region_id": "",
5. "image_name": "",
6. "system_disk_size": 40,
7. "platform": "",
8. "architecture": "",
9. "bandwidth_limit":0,
10. "data_disks": []
11.