文档目录

概述

迁移服务用于将源平台中的虚拟机系统及数据迁移至 ZStack ZSphere。本章介绍 VMware vSphere 环境的迁移操作。源平台提供待迁移的虚拟机,数据网关负责迁移过程中的数据传输,目标平台承载迁移后的虚拟机。

使用迁移服务前,先上传迁移服务安装包、完成部署并上传所需的 VDDK 安装包,再添加源平台。创建迁移任务时,检查源虚拟机并配置目标资源;数据同步后,可创建测试虚拟机验证迁移结果,再执行正式割接。迁移结束后,按需清理迁移快照及任务。

第一步 上传迁移服务安装包

上传安装包后,系统将自动解压并获取迁移服务所需文件。

  • 确保平台已安装迁移服务许可证且授权额度充足。
  • 已准备好迁移服务安装包,文件格式为 .tar.gz。
  • 平台已添加镜像存储资源,且镜像存储有足够的存储空间。
  1. 在导航栏中,选择运维管理 > 迁移服务。
  2. 在迁移服务页面,点击去上传。
  3. 在上传迁移服务安装包弹窗中,参考以下示例完成配置:
    配置项 说明
    上传方式 选择上传安装包的方式,包括 URL 和本地上传。本地上传支持在上传中断后继续上传。
    Note:
    • 发生可恢复的上传异常时,系统会自动重试。若任务因网络异常暂停且页面保持打开,网络恢复后系统将自动继续上传。
    • 若页面刷新或重新登录后,浏览器仍保留对原本地文件的访问权限,系统将自动继续因异常暂停的上传任务。浏览器提示是否允许访问此前选择的文件或文件夹时,请根据需要授予访问权限。
    • 若浏览器未获得访问权限或权限已失效,系统无法自动继续上传。请点击页面顶部的上传待处理,在上传任务待处理中找到目标任务,点击选择文件继续并重新选择同一个本地文件。
    • 主动暂停的任务不会自动恢复,请在任务详情中点击继续。
    • 若本地文件已被修改、移动或删除,系统无法继续原上传任务,请重新发起上传。
    • 上传发生异常时,平台最多自动重试 5 次。若 5 次重试均失败,上传任务将失败,系统无法继续原任务,请重新发起上传。
    • 点击查看上传记录,可查看本地文件上传任务。
    URL/安装包 输入 URL 或上传安装包文件。
    缓存路径 指定一个目录路径,用于存放上传的安装包及其解压后的文件。
    Note:
    • 请确保该目录具备充足的可用空间,否则将导致安装失败。
    • 不能使用 /、/dev、/proc、/sys、/usr/bin、/bin、/opt 等系统目录,否则可能导致服务器异常。
  4. 确认配置无误后,点击确定。

第二步 安装部署迁移服务

根据业务需求选择合适的规格,部署迁移服务。部署完成后,还需上传所需的 VDDK 安装包,再使用迁移资源和迁移任务功能。

  1. 在迁移服务页面,点击去安装。
  2. 在安装部署迁移服务弹窗中,参考以下示例完成配置:
    配置项 说明
    迁移服务版本 展示安装部署的服务版本。
    数据中心 迁移服务通过虚拟机数据网关部署,选择数据中心。
    运行位置 选择运行位置。
    CPU 默认 8 核,设置 CPU 数量。
    内存 默认 8 GB,设置内存大小。
    存储位置 指定数据存储。
    存储池 当存储位置为分布式存储时,需指定存储池。
    硬盘 1 默认 100 GB,设置系统盘大小,不得小于 100 GB。
    迁移网络 指定分布式端口组用作迁移网络。需确保所选分布式端口组与源端平台、目标端平台网络互通,以保证数据传输。
    IPv4 地址 指定 IP 地址。
    Note: IP 地址分配方式取决于所选迁移网络的配置:
    • 迁移网络启用 DHCP 时,系统自动分配 IP 地址。
    • 迁移网络未启用 DHCP 时,需手动指定 IP 地址。
    • 迁移网络启用 IP 地址管理后,手动指定 IP 地址时,需确保地址在所选网络段内。
  3. 确认配置无误后,点击确定。

部署完成后,迁移服务页面显示迁移概览和服务管理。在迁移概览中继续上传 VDDK 安装包。

第三步 上传 VDDK 安装包

受 VMware 许可限制,您需自行获取并上传 VDDK 安装包。迁移服务已启用且 VDDK 上传完成后,才能进入迁移资源和迁移任务页面。

  • 迁移服务已部署并启用。
  • 已准备适用于 Linux 的 VDDK 6.7.3 和 8.0.3 两个原始安装包,文件格式均为 .tar.gz。
  1. 在导航栏中,选择运维管理 > 迁移服务 > 迁移概览。
  2. 在 VDDK 提示信息或基本信息的VDDK项中,点击去上传。
  3. 在上传 VDDK弹窗中,为VDDK 安装包选择已准备好的两个原始安装包。
    两个版本均需上传。若已有上传任务正在进行,请等待该任务结束。
  4. 确认文件无误后,点击确定,等待上传完成。
    若上传失败,请重新选择两个原始安装包后重试。若页面提示 VDDK 状态不可用,请刷新页面后重试。

在迁移概览中确认 VDDK 状态为“已上传”。添加源平台前,还需确认所用数据网关的 VDDK 6.7.3 和 8.0.3 均已就绪;安装包上传完成不代表每个数据网关均已完成分发。

升级迁移服务

  • 确保没有正在进行中的迁移任务,否则将无法升级迁移服务。
  • 确保镜像存储有足够的存储空间,再上传迁移服务升级包。
  • 已准备版本高于当前服务版本的升级包,文件格式为 .tar.gz。
  1. 在导航栏中,选择运维管理 > 迁移服务 > 迁移概览。
  2. 在迁移概览页面,点击升级。
  3. 在升级迁移服务弹窗中,参考以下示例完成配置:
    配置项 说明
    迁移服务版本 展示当前部署的服务版本。
    上传方式 选择上传安装包的方式,包括 URL 和本地上传。本地上传支持在上传中断后继续上传。
    Note:
    • 发生可恢复的上传异常时,系统会自动重试。若任务因网络异常暂停且页面保持打开,网络恢复后系统将自动继续上传。
    • 若页面刷新或重新登录后,浏览器仍保留对原本地文件的访问权限,系统将自动继续因异常暂停的上传任务。浏览器提示是否允许访问此前选择的文件或文件夹时,请根据需要授予访问权限。
    • 若浏览器未获得访问权限或权限已失效,系统无法自动继续上传。请点击页面顶部的上传待处理,在上传任务待处理中找到目标任务,点击选择文件继续并重新选择同一个本地文件。
    • 主动暂停的任务不会自动恢复,请在任务详情中点击继续。
    • 若本地文件已被修改、移动或删除,系统无法继续原上传任务,请重新发起上传。
    • 上传发生异常时,平台最多自动重试 5 次。若 5 次重试均失败,上传任务将失败,系统无法继续原任务,请重新发起上传。
    • 点击查看上传记录,可查看本地文件上传任务。
    URL/安装包 输入 URL 或上传安装包文件。
    缓存路径 指定一个目录路径,用于存放上传的升级包及其解压后的文件。
    Note:
    • 请确保该目录具备充足的可用空间,否则将导致安装失败。
    • 不能使用 /、/dev、/proc、/sys、/usr/bin、/bin、/opt 等系统目录,否则可能导致服务器异常。
  4. 点击确定。

在迁移概览中查看升级状态。若升级失败,点击重新升级:

  • 若升级包已上传成功,但执行升级失败,可在升级方式中选择使用现有升级包或重新上传升级包。
  • 若升级包上传失败,需要重新上传升级包。

确认配置后,点击确定,等待重新升级完成。

启用/停用迁移网关

在服务管理中控制迁移网关虚拟机的运行状态。

已停用的迁移网关支持启用,运行中的迁移网关支持停用。
  1. 在导航栏中,选择运维管理 > 迁移服务 > 服务管理。
  2. 在服务管理页面,选择目标迁移网关,在操作中按需点击启用或停用。
    停用网关后,该网关将无法处理新的迁移任务。选择停用时,请阅读确认弹窗中的风险信息,再点击确定。

删除迁移网关

从服务管理中删除不再使用的迁移网关虚拟机。

  • 仅已停用的迁移网关支持删除操作。
  1. 在导航栏中,选择运维管理 > 迁移服务 > 服务管理。
  2. 在服务管理页面,选择目标迁移网关,然后点击操作 > 删除。
    Note: 删除迁移网关后无法恢复,相关迁移任务可能受到影响,请谨慎操作。
  3. 阅读并确认风险信息后,点击确定。

卸载迁移服务

不再使用迁移服务时,可以从迁移概览卸载服务,清理迁移服务安装包及代理配置。

  1. 在导航栏中,选择运维管理 > 迁移服务 > 迁移概览。
  2. 点击卸载服务。
    Note: 卸载服务会清理迁移服务安装包及代理配置,请谨慎操作。
  3. 阅读确认弹窗中的风险提示,输入 uninstall,然后点击确定。

卸载完成后,迁移服务页面返回安装部署入口。

添加源平台

迁移服务已启用且已上传所需的 VDDK 安装包。用于连接源平台的数据网关应可用,且 VDDK 6.7.3 和 8.0.3 均已就绪。

  1. 在导航栏中,选择运维管理 > 迁移资源 > 源平台。
  2. 在源平台页面,点击添加源平台。
  3. 在添加源平台弹窗中,参考以下示例完成配置:
    配置项 说明
    名称 设置源平台名称。
    数据网关配置方式 选择选择已有或输入服务器 IP 地址,指定用于连接源平台的数据网关。
    数据网关 选择已有数据网关。列表仅显示可用且 VDDK 已就绪的网关。若找不到目标网关,请先检查该网关的连接和 VDDK 状态。
    数据网关IP 选择已有网关时,确认所选网关的 IP 地址;选择输入服务器 IP 地址时,填写数据网关的 IP 地址。
    平台类型 VMware。
    vCenter/ESXi 地址 输入 VMware 环境地址。
    用户名 输入登录用户名。
    密码 输入用户名对应的密码。
    连通性测试 点击检测,检查是否可以通过指定网关连接源平台。检测通过后才能确认添加。修改网关、地址、用户名或密码等连接信息后,需要重新检测。
  4. 确认配置无误后,点击确定。

检查 ESXi 主机

添加源平台后,可以通过ESXi 主机预检排查数据网关与各 ESXi 主机之间的连接问题:

  1. 在源平台页面,选择目标源平台,然后点击操作 > ESXi 主机预检。
  2. 在预检弹窗中,展开相应主机,查看 DNS 解析、HTTPS 端口连通性和 NFC 端口连通性的检查结果及说明。
  3. 若检查不通过,处理对应的网络或 DNS 问题后,点击重新检查。

删除源平台

  1. 在导航栏中,选择运维管理 > 迁移资源 > 源平台。
  2. 在源平台页面,选择目标源平台,然后点击操作 > 删除。
  3. 核对所选源平台及风险提示,确认删除后点击确定。

添加数据网关

通过新建虚拟机部署数据网关,为源平台连接和迁移数据传输提供网关资源。

  1. 在导航栏中,选择运维管理 > 迁移资源 > 数据网关。
  2. 在数据网关页面,点击添加数据网关。
  3. 在添加数据网关弹窗中,参考以下示例完成配置:
    配置项 说明
    名称 设置数据网关名称。

    配置网关虚拟机的资源和网络:

    配置项 说明
    数据中心 选择虚拟机所在数据中心。
    运行位置 选择运行位置。
    CPU 默认 8 核,设置 CPU 数量。
    内存 默认 8 GB,设置内存大小。
    存储位置 指定数据存储。
    存储池 所选存储位置为 Ceph 分布式存储时,选择存储池。
    硬盘 1 默认 100 GB,设置系统盘大小。
    网络 指定分布式端口组,需确保所选分布式端口组与源端平台、目标端平台网络互通,以保证数据传输。
    IPv4 地址 指定 IP 地址。
    Note: IP 地址分配方式取决于所选迁移网络的配置:
    • 迁移网络启用 DHCP 时,系统自动分配 IP 地址。
    • 迁移网络未启用 DHCP 时,需手动指定 IP 地址。
    • 迁移网络启用 IP 地址管理后,手动指定 IP 地址时,需确保地址在所选网络段内。
    子网掩码、IPv4 网关 网络未启用 DHCP 时,填写网关虚拟机使用的子网掩码和 IPv4 网关。
  4. 确认配置无误后,点击确定。

网关虚拟机创建并连接后,系统为其分发 VDDK。在数据网关列表中确认连接状态,以及 VDDK 6.7.3 和 8.0.3 的就绪情况。

VDDK 显示“分发中”时,请等待完成;显示“未就绪”或“安装失败”时,可点击重试。若版本显示为“-”,并提示查询失败或超时,可点击刷新重新查询。

删除数据网关

  1. 在导航栏中,选择运维管理 > 迁移资源 > 数据网关。
  2. 在数据网关页面,选择目标数据网关,然后点击操作 > 删除。
  3. 阅读并确认风险信息后,点击确定。

新建迁移任务

已添加源平台,并确保迁移服务许可证的可用授权额度及容量授权满足本次迁移需求。
  1. 在导航栏中,选择运维管理 > 迁移任务 > 所有任务。
  2. 在所有任务页面,点击新建迁移任务。
  3. 在新建迁移任务弹窗中,参考以下示例完成源平台配置:
    配置项 说明
    源平台 选择源平台。
    源虚拟机 添加要迁移的源虚拟机。
    Note: 每台源虚拟机的硬盘容量超过以下额度时,超出部分需有足够的容量授权:
    • 测试授权:1 TB。
    • 正式授权:5 TB。
    迁移授权类型 选择授权类型,检查可用点数。已有有效授权的源虚拟机在授权有效期内重新创建迁移任务,不重复消耗点数。
  4. 点击检查,查看所选源虚拟机的预检结果。

    预检失败、结果不完整或存在“不通过”项时,无法继续;仅存在“风险”项时可以继续,但请先阅读相应说明。

    检查项结果说明
    快照检查源虚拟机存在快照时,提示风险。
    快照数量(少于 5 个)快照数量达到或超过 5 个时,提示风险。
    快照和 CBT 检查源虚拟机存在快照且未启用 CBT 时,提示风险。
    硬盘数量检查硬盘数量为 0 时,不通过。
    网卡数量检查网卡数量为 0 时,不通过。

    处理问题后,点击重新检查。更换源平台或新增待迁移虚拟机后,请检查当前所选虚拟机,再进入下一步。

  5. 点击下一步。
  6. 配置目标平台。
    1. 参考以下示例完成虚拟机配置:
      配置项 说明
      数据中心 选择虚拟机迁移后所在的数据中心。
      集群 选择虚拟机迁移后所在的集群。
      主机 选择虚拟机迁移后所在的主机。
      存储位置 选择虚拟机迁移后使用的数据存储。
      总线类型 选择虚拟机硬盘设备的总线类型。
      CPU 模式 选择虚拟机迁移后的 CPU 模式。
      目标网络端口组 选择虚拟机要使用的分布式端口组。
      安全组 选择安全组。

      配置目标网络端口组时,可参考以下参数:

      配置项 说明
      CIDR 所选目标网络启用 IPAM 时,选择对应的 CIDR。
      网卡配置 选择是否克隆源虚拟机的网络配置及 MAC 地址。
      • 克隆网络配置:目标 IP 地址沿用源虚拟机 IP。仅在所选源虚拟机均有 IP 地址,且目标网络未启用 DHCP 时支持选择。
      • 克隆 MAC 地址:虚拟机的目标 MAC 地址与源虚拟机保持一致。
      Note:
      • 逐台虚拟机的目标 IP、子网掩码、默认网关和临时网络在后续确认页面中配置。
      • 克隆网络配置后,请在启动目标虚拟机或正式割接前关闭源虚拟机,避免 IP 地址冲突。
    2. 参考以下示例完成割接配置:
      配置项 说明
      立即割接 启用后,系统将在数据初始同步完成后,自动执行割接任务。
      创建回滚快照 启用后,系统将在发起割接任务时为目标虚拟机创建回滚快照。

      回滚快照的作用:

      • 启用后,可对“割接中”或“割接失败”的任务选择“删除割接程序并回滚目标实例”,将目标实例恢复至割接前状态。
      • “割接成功”的任务不提供该回滚策略。
      源虚拟机自动关机 启用后,系统将在执行割接任务前关闭源虚拟机。按提示确认启用,并选择关机方式:
      • 正常关机:需源虚拟机已安装并运行 VMTools,操作系统正常关闭进程后断电。
      • 立即断电:强制终止运行中的进程并关闭电源,可能导致数据丢失或文件系统损坏,请谨慎使用。
      自动安装VMTools 启用后,系统将在目标虚拟机操作系统转换完成后,自动安装VMTools。
  7. 点击下一步。
  8. 在确认页面,检查每台虚拟机的配置;如需调整,点击相应虚拟机的修改配置。

    逐台核对资源、网络和割接配置。网络参数按以下条件填写:

    配置项说明
    目标 IP 地址克隆网络配置时,沿用源虚拟机 IP 地址;未克隆时,确认或修改目标 IP。目标网络未启用 DHCP 时必须指定,启用 DHCP 时可自动分配。启用 IPAM 的网络中,地址应在所选 CIDR 的可用范围内。
    子网掩码、默认网关克隆网络配置或目标网络未启用 DHCP 时,检查并补齐这两项配置。
    临时网络端口组克隆网络配置时,选择临时网络端口组,用于迁移过程中的临时网络连接。
    临时 IP 地址临时网络启用 DHCP 时可自动分配;未启用 DHCP 时,需指定临时 IP、子网掩码和临时默认网关。若临时网络启用 IPAM,请选择 CIDR,并确保地址在可用范围内。

    保存逐台配置后,检查确认列表中的提示,补齐缺失项并处理无效地址等问题。

  9. 确认配置信息无误后,点击确定,提交迁移任务。

同步迁移任务

迁移任务处于“同步已停止”或“可割接”状态。
  1. 在导航栏中,选择运维管理 > 迁移任务 > 所有任务。
  2. 在所有任务页面,选择要同步的迁移任务,然后点击操作 > 同步。
  3. 在同步迁移任务弹窗中,选择同步模式。
    支持以下两种同步模式:
    • 增量同步:仅同步自上次同步后发生变更的数据。
    • 全量同步:同步虚拟机的全部数据。对于已完成初始同步的迁移任务,系统在执行全量同步前会默认进行对比扫描,此过程耗时较长。
  4. 点击确定,提交同步任务。

同步任务提交后,在任务列表中查看进度,等待同步完成。

创建测试虚拟机

迁移任务处于“可割接”状态。
  1. 在导航栏中,选择运维管理 > 迁移任务 > 所有任务。
  2. 在所有任务页面,选择目标迁移任务,然后点击操作 > 测试 > 创建测试虚拟机。
  3. 在创建测试虚拟机弹窗中,参考以下示例完成配置:
    配置项 说明
    CPU 设置虚拟机的 CPU 数量。
    内存 设置虚拟机的内存大小。
    网络 选择虚拟机要使用的分布式端口组。
    CIDR 所选网络启用 DHCP 时,选择可用的 CIDR。
    IPv4 地址 指定测试虚拟机使用的 IPv4 地址。
    • 网络启用 DHCP 时,在地址选择框中选择或指定可用地址。
    • 网络未启用 DHCP 时,手动输入 IPv4 地址。
    • 网络已配置地址范围时,指定的地址必须在可用范围内。
    子网掩码、默认网关 网络未启用 DHCP 时,检查并填写子网掩码和默认网关。
    系统转换策略 指定虚拟机启动前的系统转换策略。
    数据恢复点 使用某个时间的快照或副本,进行虚拟机恢复测试。

    配置系统转换策略时,可参考以下选项:

    配置项 说明
    执行系统转换 执行完整的系统转换,包括:驱动替换或注入、目标虚拟机网卡名称与 IP 地址配置、后置脚本执行。
    执行系统转换但不加载目标驱动程序 不执行驱动替换,仅配置目标虚拟机网卡名称与 IP 地址,并执行后置脚本。
    跳过系统转换 不执行驱动替换,不配置网卡名称与 IP 地址,不执行后置脚本。您需要登录目标虚拟机系统手动完成上述配置。
  4. 确认配置无误后,点击确定。

执行割接

  • 迁移任务处于“可割接”状态。
  • 若克隆了源虚拟机的网络配置,请在割接前关闭源虚拟机,或确认已配置源虚拟机自动关机,避免 IP 地址冲突。
  1. 在导航栏中,选择运维管理 > 迁移任务 > 所有任务。
  2. 在所有任务页面,选择目标迁移任务,然后点击操作 > 割接。
    割接开始后,虚拟机业务将正式切换至目标平台。若迁移任务已启用"源虚拟机自动关机",系统将按照您选择的关机方式关闭源虚拟机。
  3. 阅读并确认风险信息,按提示输入 割接,然后点击确定割接。

割接请求提交后,在任务列表中查看割接进度和结果。

查看和删除迁移快照

迁移任务割接成功或失败后,您可以按硬盘查看该任务产生的迁移快照,并在不再需要时清理。

迁移任务处于“割接成功”或“割接失败”状态。每次只能查看一个迁移任务的快照。

  1. 在导航栏中,选择运维管理 > 迁移任务 > 所有任务。
  2. 选择目标迁移任务,然后点击操作 > 快照。
  3. 在快照弹窗中,按硬盘查看快照名称、快照时间和快照大小。
    若只需查看,查看完成后点击关闭。
  4. 如需清理,点击全部删除。
    Note: 此操作将删除当前任务快照列表中的全部迁移快照。请先确认不再需要这些快照。
  5. 核对确认弹窗中的快照及数量,点击删除。

等待快照删除任务完成后,检查列表中的剩余快照。若提示无法确认删除结果,请等待列表刷新后再检查。

删除迁移任务

  • “待同步”“同步中”“同步已停止”“同步失败”或“可割接”状态的任务,直接进入删除确认,删除迁移任务及关联的目标实例。
  • “割接中”“割接成功”或“割接失败”状态的任务,需要先选择删除策略。
  • 上述两类任务不能混在一起批量删除,请分别选择后操作。
  1. 在导航栏中,选择运维管理 > 迁移任务 > 所有任务。
  2. 在所有任务页面,选择目标迁移任务,然后点击操作 > 删除。
  3. 若弹出删除策略窗口,选择适用的策略后点击确定;若直接进入删除确认,则继续下一步。
    配置项 说明
    保留目标实例,删除迁移任务 保留目标实例,删除迁移任务及相关记录,并清理该任务关联的迁移快照。删除后,目标实例需由您单独管理。
    删除目标实例,删除迁移任务 删除迁移任务记录及其关联的目标实例。后续可重新配置源虚拟机并执行新的迁移任务。
    删除割接程序并回滚目标实例 删除割接程序,将目标实例恢复至割接前状态,并保留关联的迁移快照。割接过程中产生的状态和数据变更将丢失,请谨慎操作。

    此策略仅适用于已启用创建回滚快照的“割接中”或“割接失败”任务。批量选择中包含“割接成功”任务时,不提供此策略;存在未启用回滚快照的任务时,此策略不可选。

  4. 核对删除确认弹窗中的任务、风险提示及关联快照;若要求输入确认文字,输入 delete,然后点击确定。
    选择保留目标实例的策略时,确认弹窗会列出将一并删除的迁移快照。请检查删除范围后再确认。