安装并使用 Migration Toolkit for Virtualization

流程

1. 在 Red Hat OpenShift Web 控制台中，点 Operators → OperatorHub。
2. 使用 Filter by keyword 字段搜索 mtv-operator。
3. 点 Migration Toolkit for Virtualization Operator，然后点 Install。
4. 当按钮变为 active 时，点 Create ForkliftController。

5. 点 Create。

   您的 ForkliftController 会出现在显示的列表中。

6. 点 Workloads → Pods 来验证 MTV pod 是否正在运行。

7. 点 Operators → Installed Operators 来验证 Migration Toolkit for Virtualization Operator 出现在 openshift-mtv 项目中，状态为 Succeeded。

   当插件就绪时，系统将提示您重新加载页面。Migration 菜单项会自动添加到导航栏中，在 Red Hat OpenShift Web 控制台左侧显示。

流程

1. 创建 openshift-mtv 项目：

   Copy to Clipboard Toggle word wrap

   $ cat << EOF | oc apply -f -
   apiVersion: project.openshift.io/v1
   kind: Project
   metadata:
     name: openshift-mtv
   EOF

2. 创建名为 migration 的 OperatorGroup CR：

   Copy to Clipboard Toggle word wrap

   $ cat << EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: migration
     namespace: openshift-mtv
   spec:
     targetNamespaces:
       - openshift-mtv
   EOF

3. 为 Operator 创建 Subscription CR：

   Copy to Clipboard Toggle word wrap

   $ cat << EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: mtv-operator
     namespace: openshift-mtv
   spec:
     channel: release-v2.8
     installPlanApproval: Automatic
     name: mtv-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     startingCSV: "mtv-operator.v2.8.4"
   EOF

4. 创建一个 ForkliftController CR：

   Copy to Clipboard Toggle word wrap

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: ForkliftController
   metadata:
     name: forklift-controller
     namespace: openshift-mtv
   spec:
     olm_managed: true
   EOF

5. 验证 MTV pod 是否正在运行：

   Copy to Clipboard Toggle word wrap

   $ oc get pods -n openshift-mtv

   输出示例

   Copy to Clipboard Toggle word wrap

   NAME                                                    READY   STATUS    RESTARTS   AGE
   forklift-api-bb45b8db4-cpzlg                            1/1     Running   0          6m34s
   forklift-controller-7649db6845-zd25p                    2/2     Running   0          6m38s
   forklift-must-gather-api-78fb4bcdf6-h2r4m               1/1     Running   0          6m28s
   forklift-operator-59c87cfbdc-pmkfc                      1/1     Running   0          28m
   forklift-ui-plugin-5c5564f6d6-zpd85                     1/1     Running   0          6m24s
   forklift-validation-7d84c74c6f-fj9xg                    1/1     Running   0          6m30s
   forklift-volume-populator-controller-85d5cb64b6-mrlmc   1/1     Running   0          6m36s

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration → Providers for virtualization。
2. 单击 Create Provider。
3. 点 vSphere。

4. 指定以下字段：

   供应商详情

   • Provider resource name ：源提供程序的名称。
   • 端点类型 ：选择 vSphere 供应商端点类型。选项： vCenter 或 ESXi。您可以从 vCenter 中迁移虚拟机、不是由 vCenter 管理的 ESX/ESXi 服务器，或从由 vCenter 管理的 ESX/ESXi 服务器迁移，但不会通过 vCenter 管理。
   • URL ：挂载源虚拟机的 vCenter 的 SDK 端点的 URL。确保 URL 包含 sdk 路径，通常为 /sdk。例如： https://vCenter-host-example.com/sdk。如果指定了 FQDN 的证书，则此字段的值需要与证书中的 FQDN 匹配。
   • VDDK init 镜像 ：VDDKInitImage 路径。强烈建议创建 VDDK init 镜像来加快迁移的速度。如需更多信息，请参阅创建 VDDK 镜像。

   供应商凭证

   • 用户名 ： vCenter 用户或 ESXi 用户。例如： user@vsphere.local。
   • 密码: vCenter 用户密码或 ESXi 用户密码.

5. 选择以下选项之一来验证 CA 证书：

   • 使用自定义 CA 证书 ：验证自定义 CA 证书后迁移。
   • 使用系统 CA 证书 ：验证系统 CA 证书后迁移。

   • 跳过证书验证 ：在不验证 CA 证书的情况下迁移。

     1. 要使用自定义 CA 证书，请将 Skip certificate 验证 开关切换为左，并将 CA 证书拖到 文本框中 或浏览该证书，然后点击 Select。
     2. 要使用系统 CA 证书，请将 Skip 证书验证 开关切换到左侧，并将 CA 证书 文本框留空。
     3. 要跳过证书验证，请将 Skip 证书验证 开关切换到右侧。

6. 可选：从供应商的 API 端点 URL 获取自定义 CA 证书。

   1. 点 来自 URL 的 Fetch 证书。此时会打开 Verify certificate 窗口。

   2. 如果详细信息正确，请选择 I trust the authenticity of this certificate 复选框，然后单击 Confirm。如果没有，请单击 Cancel，然后手动输入正确的证书信息。

      确认后，CA 证书将用于验证与 API 端点的后续通信。

7. 点 Create provider 添加并保存该供应商。

   供应商会出现在提供程序列表中。

   注意

   可能需要过几分钟后，提供商才会变为 Ready 状态。

8. 可选：添加对供应商的 UI 的访问：

   1. 在 Providers 页面上，单击提供程序。

      此时会打开 Provider 详情页面。

   2. 单击 External UI Web 链接 下的 Edit 图标。

   3. 输入链接并单击 保存。

      注意

      如果没有输入链接，则 MTV 会尝试计算正确的链接。

      • 如果 MTV 成功，字段的超链接会指向计算的链接。
      • 如果 MTV 没有成功，该字段会保持为空。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration → Providers for virtualization。
2. 点供应商旁边的 Hosts 列中的主机编号，以查看主机列表。
3. 选择一个或多个主机并点击 Select migration network。

4. 指定以下字段：

   • 网络 ：网络名称
   • ESXi host admin username: 例如，root
   • ESXi host admin password: Password
5. 点击 Save。

6. 验证每个主机的状态是否为 Ready。

   如果主机状态为 Ready，则在迁移网络上可能无法访问主机，或者凭证可能不正确。您可以修改主机配置并保存更改。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration → Providers for virtualization。
2. 单击 Create Provider。
3. 点击 OpenShift Virtualization。

4. 指定以下字段：

   • Provider resource name ：源供应商的名称
   • URL: API 服务器端点的 URL

   • Service account bearer 令牌 ：一个具有 cluster-admin 权限的服务帐户的令牌

     如果 URL 和 Service account bearer 令牌 都留空，则会使用本地 OpenShift 集群。

5. 选择以下选项之一来验证 CA 证书：

   • 使用自定义 CA 证书 ：验证自定义 CA 证书后迁移。
   • 使用系统 CA 证书 ：验证系统 CA 证书后迁移。

   • 跳过证书验证 ：在不验证 CA 证书的情况下迁移。

     1. 要使用自定义 CA 证书，请将 Skip certificate 验证 开关切换为左，并将 CA 证书拖到 文本框中 或浏览该证书，然后点击 Select。
     2. 要使用系统 CA 证书，请将 Skip 证书验证 开关切换到左侧，并将 CA 证书 文本框留空。
     3. 要跳过证书验证，请将 Skip 证书验证 开关切换到右侧。

6. 可选：从供应商的 API 端点 URL 获取自定义 CA 证书。

   1. 点 来自 URL 的 Fetch 证书。此时会打开 Verify certificate 窗口。

   2. 如果详细信息正确，请选择 I trust the authenticity of this certificate 复选框，然后单击 Confirm。如果没有，请单击 Cancel，然后手动输入正确的证书信息。

      确认后，CA 证书将用于验证与 API 端点的后续通信。

7. 点 Create provider 添加并保存该供应商。

   供应商会出现在提供程序列表中。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration > Providers for virtualization。

2. 点您要更改迁移网络的 OpenShift Virtualization 供应商。

   当 Providers 详情页面 打开时：

3. 点 Networks 标签页。
4. 单击 Set default transfer network。
5. 从列表中选择默认传输网络，然后单击 Save。

6. 通过完成以下步骤，在网络中配置用于 MTV 迁移的网关：

   1. 在 Red Hat OpenShift Web 控制台中，点 Networking > NetworkAttachmentDefinitions。
   2. 选择适当的默认传输网络 NAD。
   3. 点 YAML 标签。

   4. 将 forklift.konveyor.io/route 添加到 YAML 的 metadata:annotations 部分，如下例所示：

      Copy to Clipboard Toggle word wrap

      apiVersion: k8s.cni.cncf.io/v1
      kind: NetworkAttachmentDefinition
      metadata:
        name: localnet-network
        namespace: mtv-test
        annotations:
          forklift.konveyor.io/route: <IP address> 

      1

      1

      需要 NetworkAttachmentDefinition 参数，以便从动态主机配置协议(DHCP)或静态配置接口的 IP 地址。配置 IP 地址可让接口访问配置的网关。

   5. 点击 Save。

流程

1. 在 Red Hat OpenShift web 控制台中，单击 Plans for virtualization，然后单击 Create Plan。

   Create migration plan 向导会打开 Select source provider 接口。

2. 选择您要迁移的虚拟机的源供应商。

   此时会打开 Select virtual machine 界面。

3. 选择您要迁移的虚拟机，然后点 Next。

   Create migration plan 窗格将打开。它显示目标供应商和命名空间、网络映射和存储映射的源供应商名称和建议。

4. 输入 Plan 名称。
5. 要更改 Target provider、Target namespace 或 Network map 或 Storage map 的元素，请从相关列表中选择一个项目。
6. 要添加 网络映射 或存储映射，请单击 + 符号并添加映射。

7. 点 Create migration plan。

   MTV 验证迁移计划，并打开 Plan 详情页面，指示计划是否准备就绪，或包含错误。

   列出计划的详细信息，您可以编辑在上一页上填写的项目。如果您进行任何更改，则 MTV 会再次验证计划。

8. 检查页面的 Settings 部分中的以下项：

   • 迁移类型 ：迁移类型。默认情况下，MTV 将迁移类型设置为 cold。

     • 对于温迁移，请执行以下操作：

       • 点 Edit 图标。
       • 切换是否是温迁移 开关。
       • 点击 Save。

   • transfer Network: 用于将虚拟机传送到 OpenShift Virtualization 的网络。这是提供程序的默认传输网络。验证传输网络是否在所选目标命名空间中。

     • 要编辑传输网络，请执行以下操作：

       • 点 Edit 图标。
       • 从列表中选择一个不同的传输网络。
       • 点击 Save。

     • 可选： 要在 OpenShift Web 控制台中配置 OpenShift 网络，点 Networking > NetworkAttachmentDefinitions。

       如需了解更多有关 OpenShift 支持的不同类型的网络的信息，请参阅 OpenShift Container Platform 中的 额外网络。

     • 可选： 要调整 OpenShift 传输网络的最大传输单元(MTU)，还必须更改 VMware 迁移网络的 MTU。如需更多信息，请参阅为 VMware 源供应商选择迁移网络。

   • 目标命名空间 ：所有迁移的虚拟机的目标命名空间。默认情况下，目标命名空间是当前或活跃的命名空间。

     • 要编辑命名空间，请执行以下操作：

       • 点 Edit 图标。
       • 从打开的窗口中的列表中选择不同的目标命名空间。
       • 点击 Save。

   • 保留静态 IP ：默认情况下，虚拟网络接口控制器(vNIC)会在迁移过程中更改。因此，使用静态 IP 配置给客户虚拟机中的接口名称的 vNIC 会在迁移过程中丢失其 IP。

     • 要保留静态 IP，请执行以下操作：

       • 点 Edit 图标。
       • 切换 是否保留静态 IP 开关。

       • 点击 Save。

         然后，MTV 会针对缺少 vNIC 属性的任何虚拟机发出警告消息。要检索任何缺少的 vNIC 属性，请在 vSphere 中运行这些虚拟机。这会导致 vNIC 属性报告为 MTV。

   • 磁盘解密密码短语 ：对于使用 Linux 统一密钥设置(LUKS)加密的磁盘。

     • 要为 LUKS 加密设备输入解密密码短语列表，请执行以下操作：

       • 点 Edit 图标。
       • 输入密码短语。

       • 点击 Save。

         您不需要以特定顺序输入密码短语。对于每个 LUKS 加密设备，MTV 会尝试每个密码短语，直到一个解锁该设备为止。

   • Root 设备 ：仅适用于多引导虚拟机迁移。默认情况下，MTV 使用检测到的第一个可引导设备作为 root 设备。

     • 要指定不同的根设备，请执行以下操作：

       • 单击 Root 设备 旁边的 Edit 图标。
       • 从列表中选择设备，或者在文本框中输入设备。

       • 点击 Save。

         MTV 对磁盘位置使用以下格式： /dev/sd<disk_identifier><disk_partition>。例如：如果第二个磁盘是 root 设备，且操作系统位于磁盘的第二个分区中，则格式将是： /dev/sdb2。输入引导设备后，点 Save。

         如果因为提供的引导设备不正确而转换失败，可以通过检查转换 pod 日志来获取正确的信息。

   • 共享磁盘 ：仅适用于冷迁移。共享磁盘是附加到多个虚拟机的磁盘，并使用多写器选项。这些特性使共享磁盘难以迁移。默认情况下，MTV 不会迁移共享磁盘。

     注意

     迁移共享磁盘可能会减慢迁移过程的速度。

     • 要在迁移计划中迁移共享磁盘，请执行以下操作：

       • 点 Edit 图标。
       • 切换 Migrate shared disk 开关。
       • 点击 Save。

   • 可选： PVC 名称模板 ：指定计划中虚拟机的持久性卷声明(PVC)名称的模板。

     模板遵循 Go 模板语法，并可访问以下变量：

     • .vmname: 虚拟机的名称
     • .PlanName: 迁移计划的名称
     • .DiskIndex ：磁盘的初始卷索引

     • .RootDiskIndex: 根磁盘索引

       例子

     • "{{.vmname}}-disk-{{.DiskIndex}}"

     • "{{if eq .DiskIndex .RootDiskIndex}}root{{else}}data{{end}}-{{.DiskIndex}}"

       变量名称不能超过 63 个字符。

     • 要为计划中所有虚拟机指定 PVC 名称模板，请执行以下操作：

       • 点 Edit 图标。
       • 单击 Enter custom naming template。
       • 根据说明输入模板。
       • 点击 Save。

     • 要只为特定虚拟机指定 PVC 名称模板，请执行以下操作：

       • 点 Virtual Machines 标签页。
       • 选择所需的虚拟机。
       • 点击虚拟机的 Options 菜单 。
       • 选择 Edit PVC name template。
       • 根据说明输入模板。

       • 点击 Save。

         重要

         您在 Virtual Machines 选项卡中所做的更改会覆盖 Plan 详情页面中的任何更改。

   • 可选： 卷名称模板 ：指定计划中虚拟机的卷接口名称的模板。

     模板遵循 Go 模板语法，并可访问以下变量：

     • .PVCName: 使用这个卷挂载到虚拟机的 PVC 名称

     • .VolumeIndex: 卷接口(0-based)的 Sequential index

       例子

     • "disk-{{.VolumeIndex}}"

     • "pvc-{{.PVCName}}"

       变量名称不能超过 63 个字符

     • 要为您计划中的所有虚拟机指定卷名称模板，请执行以下操作：

       • 点 Edit 图标。
       • 单击 Enter custom naming template。
       • 根据说明输入模板。
       • 点击 Save。

     • 要只为特定虚拟机指定不同的卷名称模板，请执行以下操作：

       • 点 Virtual Machines 标签页。
       • 选择所需的虚拟机。
       • 点击虚拟机的 Options 菜单 。
       • 选择 Edit Volume name template。
       • 根据说明输入模板。

       • 点击 Save。

         重要

         您在 Virtual Machines 选项卡中所做的更改会覆盖 Plan 详情页面中的任何更改。

   • 可选： Network name template: 指定您计划中虚拟机的网络接口名称模板。

     模板遵循 Go 模板语法，并可访问以下变量：

     • .networkName: 如果目标网络是 multus，请添加 Multus 网络附加定义的名称。否则，将此变量留空。
     • .networkNamespace ：如果目标网络是 multus，请添加 Multus 网络附加定义所在的命名空间。
     • .networkType: Network type。选项： multus 或 pod。

     • .NetworkIndex ：网络接口的序列索引(0-based)。

       例子

     • "net-{{.NetworkIndex}}"

     • {{if eq .NetworkType "pod"}}pod{{else}}multus-{{.NetworkIndex}}{{end}}"

       变量名称不能超过 63 个字符。

     • 要为您计划中的所有虚拟机指定网络名称模板，请执行以下操作：

       • 点 Edit 图标。
       • 单击 Enter custom naming template。
       • 根据说明输入模板。
       • 点击 Save。

     • 要只为特定虚拟机指定不同的网络名称模板，请执行以下操作：

       • 点 Virtual Machines 标签页。
       • 选择所需的虚拟机。
       • 点击虚拟机的 Options 菜单 。
       • 选择 Edit Network name template。
       • 根据说明输入模板。

       • 点击 Save。

         重要

         您在 Virtual Machines 选项卡中所做的更改会覆盖 Plan 详情页面中的任何更改。

9. 如果计划有效，您可以执行以下操作之一：

   1. 现在，点 Start migration 来运行计划。
   2. 稍后，在 Plans for virtualization 页面上选择计划并遵循 运行迁移计划 中的步骤来运行计划。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration > Plans for virtualization。

   Plans 列表显示源和目标供应商、正在迁移的虚拟机数量、状态、迁移的日期以及每个计划的描述。

2. 点迁移计划旁边的 Start 来启用迁移。

3. 在打开的确认窗口中，单击 Start。

   计划 的状态更改为 Running，并显示迁移的进度。

   仅限 warm 迁移：

   • precopy 阶段会启动。

   • 点 Cutover 完成迁移。

     警告

     开始迁移后不要对虚拟机进行快照。在迁移启动后进行 snaphot 可能会导致迁移失败。

4. 可选：点迁移的 Status 中的链接查看其整体状态和每个虚拟机的状态：

   • 左侧的链接表示迁移失败、成功还是持续。它还会报告迁移成功、失败或被取消的虚拟机数量。

   • 右侧的链接会打开 Plan Details 页面的 Virtual Machines 选项卡。对于每个虚拟机，标签会显示以下数据：

     • 虚拟机的名称
     • 迁移的开始和结束时间
     • 复制的数据量

     • 虚拟机迁移的进度管道

       警告

       对于正在导入的虚拟机，必须禁用 vMotion，包括 svMotion 和 relocate，以避免数据崩溃。

5. 可选： 要在迁移的运行时或完成后查看迁移的日志，请执行以下操作：

   1. 点 Virtual Machines 标签页。

   2. 点击您要检查的虚拟机左侧的箭头(>)。

      此时会显示虚拟机的详情。

   3. 在 Pod link 列中的 Pods 部分，点 Logs 链接。

      Logs 选项卡将打开。

      注意

      日志并不总是可用。以下是日志不可用的常见原因：

      • 迁移是从 OpenShift Virtualization 迁移到 OpenShift Virtualization。在这种情况下，不涉及 virt-v2v，因此不需要 pod。
      • 没有创建 pod。
      • pod 已被删除。
      • 迁移在运行 pod 前失败。
   4. 要查看原始日志，请点 Raw 链接。
   5. 要下载日志，请点 Download 链接。

流程

1. 在 Red Hat OpenShift web 控制台中，单击 Plans for virtualization。
2. 点正在运行的迁移计划的名称查看迁移详情。
3. 选择一个或多个虚拟机，点 Cancel。

4. 点 Yes, cancel 确认取消。

   在 Migration details by VM 列表中，取消的虚拟机的状态为 Canceled。未迁移且迁移的虚拟机不受影响。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration → Providers for virtualization。
2. 单击 Create Provider。
3. 点 Red Hat Virtualization

4. 指定以下字段：

   • Provider resource name ：源提供程序的名称。
   • URL: 挂载源虚拟机的 Red Hat Virtualization Manager (RHVM)的 API 端点的 URL。确保 URL 包括 RHVM API 服务器（通常为 /ovirt-engine/api ）的路径。例如： https://rhv-host-example.com/ovirt-engine/api。
   • 用户名 ：用户名.
   • 密码 ：密码.

5. 选择以下选项之一来验证 CA 证书：

   • 使用自定义 CA 证书 ：验证自定义 CA 证书后迁移。
   • 使用系统 CA 证书 ：验证系统 CA 证书后迁移。

   • 跳过证书验证 ：在不验证 CA 证书的情况下迁移。

     1. 要使用自定义 CA 证书，请将 Skip certificate 验证 开关切换为左，并将 CA 证书拖到 文本框中 或浏览该证书，然后点击 Select。
     2. 要使用系统 CA 证书，请将 Skip 证书验证 开关切换到左侧，并将 CA 证书 文本框留空。
     3. 要跳过证书验证，请将 Skip 证书验证 开关切换到右侧。

6. 可选：从供应商的 API 端点 URL 获取自定义 CA 证书。

   1. 点 来自 URL 的 Fetch 证书。此时会打开 Verify certificate 窗口。

   2. 如果详细信息正确，请选择 I trust the authenticity of this certificate 复选框，然后单击 Confirm。如果没有，请单击 Cancel，然后手动输入正确的证书信息。

      确认后，CA 证书将用于验证与 API 端点的后续通信。

7. 点 Create provider 添加并保存该供应商。

   供应商会出现在提供程序列表中。

8. 可选：添加对供应商的 UI 的访问：

   1. 在 Providers 页面上，单击提供程序。

      此时会打开 Provider 详情页面。

   2. 单击 External UI Web 链接 下的 Edit 图标。

   3. 输入链接并单击 保存。

      注意

      如果没有输入链接，则 MTV 会尝试计算正确的链接。

      • 如果 MTV 成功，字段的超链接会指向计算的链接。
      • 如果 MTV 没有成功，该字段会保持为空。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration → Providers for virtualization。
2. 单击 Create Provider。
3. 点击 OpenShift Virtualization。

4. 指定以下字段：

   • Provider resource name ：源供应商的名称
   • URL: API 服务器端点的 URL

   • Service account bearer 令牌 ：一个具有 cluster-admin 权限的服务帐户的令牌

     如果 URL 和 Service account bearer 令牌 都留空，则会使用本地 OpenShift 集群。

5. 选择以下选项之一来验证 CA 证书：

   • 使用自定义 CA 证书 ：验证自定义 CA 证书后迁移。
   • 使用系统 CA 证书 ：验证系统 CA 证书后迁移。

   • 跳过证书验证 ：在不验证 CA 证书的情况下迁移。

     1. 要使用自定义 CA 证书，请将 Skip certificate 验证 开关切换为左，并将 CA 证书拖到 文本框中 或浏览该证书，然后点击 Select。
     2. 要使用系统 CA 证书，请将 Skip 证书验证 开关切换到左侧，并将 CA 证书 文本框留空。
     3. 要跳过证书验证，请将 Skip 证书验证 开关切换到右侧。

6. 可选：从供应商的 API 端点 URL 获取自定义 CA 证书。

   1. 点 来自 URL 的 Fetch 证书。此时会打开 Verify certificate 窗口。

   2. 如果详细信息正确，请选择 I trust the authenticity of this certificate 复选框，然后单击 Confirm。如果没有，请单击 Cancel，然后手动输入正确的证书信息。

      确认后，CA 证书将用于验证与 API 端点的后续通信。

7. 点 Create provider 添加并保存该供应商。

   供应商会出现在提供程序列表中。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration > Providers for virtualization。

2. 点您要更改迁移网络的 OpenShift Virtualization 供应商。

   当 Providers 详情页面 打开时：

3. 点 Networks 标签页。
4. 单击 Set default transfer network。
5. 从列表中选择默认传输网络，然后单击 Save。

6. 通过完成以下步骤，在网络中配置用于 MTV 迁移的网关：

   1. 在 Red Hat OpenShift Web 控制台中，点 Networking > NetworkAttachmentDefinitions。
   2. 选择适当的默认传输网络 NAD。
   3. 点 YAML 标签。

   4. 将 forklift.konveyor.io/route 添加到 YAML 的 metadata:annotations 部分，如下例所示：

      Copy to Clipboard Toggle word wrap

      apiVersion: k8s.cni.cncf.io/v1
      kind: NetworkAttachmentDefinition
      metadata:
        name: localnet-network
        namespace: mtv-test
        annotations:
          forklift.konveyor.io/route: <IP address> 

      1

      1

      需要 NetworkAttachmentDefinition 参数，以便从动态主机配置协议(DHCP)或静态配置接口的 IP 地址。配置 IP 地址可让接口访问配置的网关。

   5. 点击 Save。

流程

1. 在 Red Hat OpenShift web 控制台中，单击 Plans for virtualization，然后单击 Create Plan。

   Create migration plan 向导会打开 Select source provider 接口。

2. 选择您要迁移的虚拟机的源供应商。

   此时会打开 Select virtual machine 界面。

3. 选择您要迁移的虚拟机，然后点 Next。

   Create migration plan 窗格将打开。它显示目标供应商和命名空间、网络映射和存储映射的源供应商名称和建议。

4. 输入 Plan 名称。
5. 要更改 Target provider、Target namespace 或 Network map 或 Storage map 的元素，请从相关列表中选择一个项目。
6. 要添加 网络映射 或存储映射，请单击 + 符号并添加映射。

7. 点 Create migration plan。

   MTV 验证迁移计划，并打开 Plan 详情页面，指示计划是否准备就绪，或包含错误。

   列出计划的详细信息，您可以编辑在上一页上填写的项目。如果您进行任何更改，则 MTV 会再次验证计划。

8. 检查页面的 Settings 部分中的以下项：

   • 迁移类型 ：迁移类型。默认情况下，MTV 将迁移类型设置为 cold。

     • 对于温迁移，请执行以下操作：

       • 点 Edit 图标。
       • 切换是否是温迁移 开关。
       • 点击 Save。

   • transfer Network: 用于将虚拟机传送到 OpenShift Virtualization 的网络。这是提供程序的默认传输网络。验证传输网络是否在所选目标命名空间中。

     • 要编辑传输网络，请执行以下操作：

       • 点 Edit 图标。
       • 从列表中选择一个不同的传输网络。
       • 点击 Save。

     • 可选： 要在 OpenShift Web 控制台中配置 OpenShift 网络，点 Networking > NetworkAttachmentDefinitions。

       如需了解更多有关 OpenShift 支持的不同类型的网络的信息，请参阅 OpenShift Container Platform 中的 额外网络。

     • 可选： 要调整 OpenShift 传输网络的最大传输单元(MTU)，还必须更改 VMware 迁移网络的 MTU。如需更多信息，请参阅为 VMware 源供应商选择迁移网络。

   • 目标命名空间 ：所有迁移的虚拟机的目标命名空间。默认情况下，目标命名空间是当前或活跃的命名空间。

     • 要编辑命名空间，请执行以下操作：

       • 点 Edit 图标。
       • 从打开的窗口中的列表中选择不同的目标命名空间。
       • 点击 Save。

   • 保留从 RHV 中迁移的虚拟机 CPU 模型：通常，RHV 虚拟机的 CPU 模型（类型）在集群级别上设置。但是，可以在虚拟机级别上设置 CPU 模型，这称为自定义 CPU 模型。

     默认情况下，MTV 在目标集群上设置 CPU 模型，如下所示： MTV 为具有它们的虚拟机保留自定义 CPU 设置。 对于没有自定义 CPU 设置的虚拟机，MTV 不会设置 CPU 型号。相反，CPU 模型稍后由 OpenShift Virtualization 设置。

     • 要保留 RHV 虚拟机的集群级别 CPU 模型，请执行以下操作：

       • 点 Edit 图标。
       • 切换 是否保留 CPU 模型 开关。
       • 点击 Save。

9. 如果计划有效，您可以执行以下操作之一：

   1. 现在，点 Start migration 来运行计划。
   2. 稍后，在 Plans for virtualization 页面上选择计划并遵循 运行迁移计划 中的步骤来运行计划。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration > Plans for virtualization。

   Plans 列表显示源和目标供应商、正在迁移的虚拟机数量、状态、迁移的日期以及每个计划的描述。

2. 点迁移计划旁边的 Start 来启用迁移。

3. 在打开的确认窗口中，单击 Start。

   计划 的状态更改为 Running，并显示迁移的进度。

   仅限 warm 迁移：

   • precopy 阶段会启动。

   • 点 Cutover 完成迁移。

     警告

     开始迁移后不要对虚拟机进行快照。在迁移启动后进行 snaphot 可能会导致迁移失败。

4. 可选：点迁移的 Status 中的链接查看其整体状态和每个虚拟机的状态：

   • 左侧的链接表示迁移失败、成功还是持续。它还会报告迁移成功、失败或被取消的虚拟机数量。

   • 右侧的链接会打开 Plan Details 页面的 Virtual Machines 选项卡。对于每个虚拟机，标签会显示以下数据：

     • 虚拟机的名称
     • 迁移的开始和结束时间
     • 复制的数据量

     • 虚拟机迁移的进度管道

       警告

       对于正在导入的虚拟机，必须禁用 vMotion，包括 svMotion 和 relocate，以避免数据崩溃。

5. 可选： 要在迁移的运行时或完成后查看迁移的日志，请执行以下操作：

   1. 点 Virtual Machines 标签页。

   2. 点击您要检查的虚拟机左侧的箭头(>)。

      此时会显示虚拟机的详情。

   3. 在 Pod link 列中的 Pods 部分，点 Logs 链接。

      Logs 选项卡将打开。

      注意

      日志并不总是可用。以下是日志不可用的常见原因：

      • 迁移是从 OpenShift Virtualization 迁移到 OpenShift Virtualization。在这种情况下，不涉及 virt-v2v，因此不需要 pod。
      • 没有创建 pod。
      • pod 已被删除。
      • 迁移在运行 pod 前失败。
   4. 要查看原始日志，请点 Raw 链接。
   5. 要下载日志，请点 Download 链接。

流程

1. 在 Red Hat OpenShift web 控制台中，单击 Plans for virtualization。
2. 点正在运行的迁移计划的名称查看迁移详情。
3. 选择一个或多个虚拟机，点 Cancel。

4. 点 Yes, cancel 确认取消。

   在 Migration details by VM 列表中，取消的虚拟机的状态为 Canceled。未迁移且迁移的虚拟机不受影响。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration → Providers for virtualization。
2. 单击 Create Provider。
3. 单击 OpenStack。

4. 指定以下字段：

   • Provider resource name ：源提供程序的名称。
   • URL ：OpenStack 身份(Keystone)端点的 URL。例如： http://controller:5000/v3。

   • 身份验证类型 ：选择以下验证方法之一并提供您选择的信息。例如，如果您选择 Application credential ID 作为身份验证类型，Application credential ID 和 Application credential secret 字段将变为活跃，您需要提供 ID 和 secret。

     • 应用程序凭证 ID

       • 应用凭证 ID ：OpenStack 应用凭证 ID
       • 应用程序凭证 secret ：OpenStack 应用程序凭证 Secret

     • 应用程序凭证名称

       • 应用凭证名称 ：OpenStack 应用凭证名称
       • 应用程序凭证 secret ：OpenStack 应用程序凭证 Secret
       • 用户名 ：OpenStack 用户名
       • 域 ：OpenStack 域名

     • 带有用户 ID 的令牌

       • 令牌 ：OpenStack 令牌
       • 用户 ID ：OpenStack 用户 ID
       • 项目 ID ：OpenStack 项目 ID

     • 使用用户名的令牌

       • 令牌 ：OpenStack 令牌
       • 用户名 ：OpenStack 用户名
       • 项目 ：OpenStack 项目
       • 域名 ：OpenStack 域名

     • 密码

       • 用户名 ：OpenStack 用户名
       • 密码 ：OpenStack 密码
       • 项目 ：OpenStack 项目
       • 域 ：OpenStack 域名

5. 选择以下选项之一来验证 CA 证书：

   • 使用自定义 CA 证书 ：验证自定义 CA 证书后迁移。
   • 使用系统 CA 证书 ：验证系统 CA 证书后迁移。

   • 跳过证书验证 ：在不验证 CA 证书的情况下迁移。

     1. 要使用自定义 CA 证书，请将 Skip certificate 验证 开关切换为左，并将 CA 证书拖到 文本框中 或浏览该证书，然后点击 Select。
     2. 要使用系统 CA 证书，请将 Skip 证书验证 开关切换到左侧，并将 CA 证书 文本框留空。
     3. 要跳过证书验证，请将 Skip 证书验证 开关切换到右侧。

6. 可选：从供应商的 API 端点 URL 获取自定义 CA 证书。

   1. 点 来自 URL 的 Fetch 证书。此时会打开 Verify certificate 窗口。

   2. 如果详细信息正确，请选择 I trust the authenticity of this certificate 复选框，然后单击 Confirm。如果没有，请单击 Cancel，然后手动输入正确的证书信息。

      确认后，CA 证书将用于验证与 API 端点的后续通信。

7. 点 Create provider 添加并保存该供应商。

   供应商会出现在提供程序列表中。

8. 可选：添加对供应商的 UI 的访问：

   1. 在 Providers 页面上，单击提供程序。

      此时会打开 Provider 详情页面。

   2. 单击 External UI Web 链接 下的 Edit 图标。

   3. 输入链接并单击 保存。

      注意

      如果没有输入链接，则 MTV 会尝试计算正确的链接。

      • 如果 MTV 成功，字段的超链接会指向计算的链接。
      • 如果 MTV 没有成功，该字段会保持为空。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration → Providers for virtualization。
2. 单击 Create Provider。
3. 点击 OpenShift Virtualization。

4. 指定以下字段：

   • Provider resource name ：源供应商的名称
   • URL: API 服务器端点的 URL

   • Service account bearer 令牌 ：一个具有 cluster-admin 权限的服务帐户的令牌

     如果 URL 和 Service account bearer 令牌 都留空，则会使用本地 OpenShift 集群。

5. 选择以下选项之一来验证 CA 证书：

   • 使用自定义 CA 证书 ：验证自定义 CA 证书后迁移。
   • 使用系统 CA 证书 ：验证系统 CA 证书后迁移。

   • 跳过证书验证 ：在不验证 CA 证书的情况下迁移。

     1. 要使用自定义 CA 证书，请将 Skip certificate 验证 开关切换为左，并将 CA 证书拖到 文本框中 或浏览该证书，然后点击 Select。
     2. 要使用系统 CA 证书，请将 Skip 证书验证 开关切换到左侧，并将 CA 证书 文本框留空。
     3. 要跳过证书验证，请将 Skip 证书验证 开关切换到右侧。

6. 可选：从供应商的 API 端点 URL 获取自定义 CA 证书。

   1. 点 来自 URL 的 Fetch 证书。此时会打开 Verify certificate 窗口。

   2. 如果详细信息正确，请选择 I trust the authenticity of this certificate 复选框，然后单击 Confirm。如果没有，请单击 Cancel，然后手动输入正确的证书信息。

      确认后，CA 证书将用于验证与 API 端点的后续通信。

7. 点 Create provider 添加并保存该供应商。

   供应商会出现在提供程序列表中。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration > Providers for virtualization。

2. 点您要更改迁移网络的 OpenShift Virtualization 供应商。

   当 Providers 详情页面 打开时：

3. 点 Networks 标签页。
4. 单击 Set default transfer network。
5. 从列表中选择默认传输网络，然后单击 Save。

6. 通过完成以下步骤，在网络中配置用于 MTV 迁移的网关：

   1. 在 Red Hat OpenShift Web 控制台中，点 Networking > NetworkAttachmentDefinitions。
   2. 选择适当的默认传输网络 NAD。
   3. 点 YAML 标签。

   4. 将 forklift.konveyor.io/route 添加到 YAML 的 metadata:annotations 部分，如下例所示：

      Copy to Clipboard Toggle word wrap

      apiVersion: k8s.cni.cncf.io/v1
      kind: NetworkAttachmentDefinition
      metadata:
        name: localnet-network
        namespace: mtv-test
        annotations:
          forklift.konveyor.io/route: <IP address> 

      1

      1

      需要 NetworkAttachmentDefinition 参数，以便从动态主机配置协议(DHCP)或静态配置接口的 IP 地址。配置 IP 地址可让接口访问配置的网关。

   5. 点击 Save。

流程

1. 在 Red Hat OpenShift web 控制台中，单击 Plans for virtualization，然后单击 Create Plan。

   Create migration plan 向导会打开 Select source provider 接口。

2. 选择您要迁移的虚拟机的源供应商。

   此时会打开 Select virtual machine 界面。

3. 选择您要迁移的虚拟机，然后点 Next。

   Create migration plan 窗格将打开。它显示目标供应商和命名空间、网络映射和存储映射的源供应商名称和建议。

4. 输入 Plan 名称。
5. 要更改 Target provider、Target namespace 或 Network map 或 Storage map 的元素，请从相关列表中选择一个项目。
6. 要添加 网络映射 或存储映射，请单击 + 符号并添加映射。

7. 点 Create migration plan。

   MTV 验证迁移计划，并打开 Plan 详情页面，指示计划是否准备就绪，或包含错误。

   列出计划的详细信息，您可以编辑在上一页上填写的项目。如果您进行任何更改，则 MTV 会再次验证计划。

8. 检查页面的 Settings 部分中的以下项：

   • transfer Network: 用于将虚拟机传送到 OpenShift Virtualization 的网络。这是提供程序的默认传输网络。验证传输网络是否在所选目标命名空间中。

     • 要编辑传输网络，请执行以下操作：

       • 点 Edit 图标。
       • 从列表中选择一个不同的传输网络。
       • 点击 Save。

     • 可选： 要在 OpenShift Web 控制台中配置 OpenShift 网络，点 Networking > NetworkAttachmentDefinitions。

       如需了解更多有关 OpenShift 支持的不同类型的网络的信息，请参阅 OpenShift Container Platform 中的 额外网络。

     • 可选： 要调整 OpenShift 传输网络的最大传输单元(MTU)，还必须更改 VMware 迁移网络的 MTU。如需更多信息，请参阅为 VMware 源供应商选择迁移网络。

   • 目标命名空间 ：所有迁移的虚拟机的目标命名空间。默认情况下，目标命名空间是当前或活跃的命名空间。

     • 要编辑命名空间，请执行以下操作：

       • 点 Edit 图标。
       • 从打开的窗口中的列表中选择不同的目标命名空间。
       • 点击 Save。

9. 如果计划有效，您可以执行以下操作之一：

   1. 现在，点 Start migration 来运行计划。
   2. 稍后，在 Plans for virtualization 页面上选择计划并遵循 运行迁移计划 中的步骤来运行计划。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration > Plans for virtualization。

   Plans 列表显示源和目标供应商、正在迁移的虚拟机数量、状态、迁移的日期以及每个计划的描述。

2. 点迁移计划旁边的 Start 来启用迁移。

3. 在打开的确认窗口中，单击 Start。

   计划 的状态更改为 Running，并显示迁移的进度。

   警告

   开始迁移后不要对虚拟机进行快照。在迁移启动后进行 snaphot 可能会导致迁移失败。

4. 可选：点迁移的 Status 中的链接查看其整体状态和每个虚拟机的状态：

   • 左侧的链接表示迁移失败、成功还是持续。它还会报告迁移成功、失败或被取消的虚拟机数量。

   • 右侧的链接会打开 Plan Details 页面的 Virtual Machines 选项卡。对于每个虚拟机，标签会显示以下数据：

     • 虚拟机的名称
     • 迁移的开始和结束时间
     • 复制的数据量

     • 虚拟机迁移的进度管道

       警告

       对于正在导入的虚拟机，必须禁用 vMotion，包括 svMotion 和 relocate，以避免数据崩溃。

5. 可选： 要在迁移的运行时或完成后查看迁移的日志，请执行以下操作：

   1. 点 Virtual Machines 标签页。

   2. 点击您要检查的虚拟机左侧的箭头(>)。

      此时会显示虚拟机的详情。

   3. 在 Pod link 列中的 Pods 部分，点 Logs 链接。

      Logs 选项卡将打开。

      注意

      日志并不总是可用。以下是日志不可用的常见原因：

      • 迁移是从 OpenShift Virtualization 迁移到 OpenShift Virtualization。在这种情况下，不涉及 virt-v2v，因此不需要 pod。
      • 没有创建 pod。
      • pod 已被删除。
      • 迁移在运行 pod 前失败。
   4. 要查看原始日志，请点 Raw 链接。
   5. 要下载日志，请点 Download 链接。

流程

1. 在 Red Hat OpenShift web 控制台中，单击 Plans for virtualization。
2. 点正在运行的迁移计划的名称查看迁移详情。
3. 选择一个或多个虚拟机，点 Cancel。

4. 点 Yes, cancel 确认取消。

   在 Migration details by VM 列表中，取消的虚拟机的状态为 Canceled。未迁移且迁移的虚拟机不受影响。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration → Providers for virtualization。
2. 单击 Create Provider。
3. 单击 Open Virtual Appliance (OVA)。

4. 指定以下字段：

   • Provider resource name ：源供应商的名称
   • URL ：提供 OVA 的 NFS 文件共享的 URL

5. 点 Create provider 添加并保存该供应商。

   供应商会出现在提供程序列表中。

   注意

   可能会出现错误消息，指出发生了错误。您可以忽略此消息。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration → Providers for virtualization。
2. 单击 Create Provider。
3. 点击 OpenShift Virtualization。

4. 指定以下字段：

   • Provider resource name ：源供应商的名称
   • URL: API 服务器端点的 URL

   • Service account bearer 令牌 ：一个具有 cluster-admin 权限的服务帐户的令牌

     如果 URL 和 Service account bearer 令牌 都留空，则会使用本地 OpenShift 集群。

5. 选择以下选项之一来验证 CA 证书：

   • 使用自定义 CA 证书 ：验证自定义 CA 证书后迁移。
   • 使用系统 CA 证书 ：验证系统 CA 证书后迁移。

   • 跳过证书验证 ：在不验证 CA 证书的情况下迁移。

     1. 要使用自定义 CA 证书，请将 Skip certificate 验证 开关切换为左，并将 CA 证书拖到 文本框中 或浏览该证书，然后点击 Select。
     2. 要使用系统 CA 证书，请将 Skip 证书验证 开关切换到左侧，并将 CA 证书 文本框留空。
     3. 要跳过证书验证，请将 Skip 证书验证 开关切换到右侧。

6. 可选：从供应商的 API 端点 URL 获取自定义 CA 证书。

   1. 点 来自 URL 的 Fetch 证书。此时会打开 Verify certificate 窗口。

   2. 如果详细信息正确，请选择 I trust the authenticity of this certificate 复选框，然后单击 Confirm。如果没有，请单击 Cancel，然后手动输入正确的证书信息。

      确认后，CA 证书将用于验证与 API 端点的后续通信。

7. 点 Create provider 添加并保存该供应商。

   供应商会出现在提供程序列表中。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration > Providers for virtualization。

2. 点您要更改迁移网络的 OpenShift Virtualization 供应商。

   当 Providers 详情页面 打开时：

3. 点 Networks 标签页。
4. 单击 Set default transfer network。
5. 从列表中选择默认传输网络，然后单击 Save。

6. 通过完成以下步骤，在网络中配置用于 MTV 迁移的网关：

   1. 在 Red Hat OpenShift Web 控制台中，点 Networking > NetworkAttachmentDefinitions。
   2. 选择适当的默认传输网络 NAD。
   3. 点 YAML 标签。

   4. 将 forklift.konveyor.io/route 添加到 YAML 的 metadata:annotations 部分，如下例所示：

      Copy to Clipboard Toggle word wrap

      apiVersion: k8s.cni.cncf.io/v1
      kind: NetworkAttachmentDefinition
      metadata:
        name: localnet-network
        namespace: mtv-test
        annotations:
          forklift.konveyor.io/route: <IP address> 

      1

      1

      需要 NetworkAttachmentDefinition 参数，以便从动态主机配置协议(DHCP)或静态配置接口的 IP 地址。配置 IP 地址可让接口访问配置的网关。

   5. 点击 Save。

流程

1. 在 Red Hat OpenShift web 控制台中，单击 Plans for virtualization，然后单击 Create Plan。

   Create migration plan 向导会打开 Select source provider 接口。

2. 选择您要迁移的虚拟机的源供应商。

   此时会打开 Select virtual machine 界面。

3. 选择您要迁移的虚拟机，然后点 Next。

   Create migration plan 窗格将打开。它显示目标供应商和命名空间、网络映射和存储映射的源供应商名称和建议。

4. 输入 Plan 名称。
5. 要更改 Target provider、Target namespace 或 Network map 或 Storage map 的元素，请从相关列表中选择一个项目。
6. 要添加 网络映射 或存储映射，请单击 + 符号并添加映射。

7. 点 Create migration plan。

   MTV 验证迁移计划，并打开 Plan 详情页面，指示计划是否准备就绪，或包含错误。

   列出计划的详细信息，您可以编辑在上一页上填写的项目。如果您进行任何更改，则 MTV 会再次验证计划。

8. 检查页面的 Settings 部分中的以下项：

   • transfer Network: 用于将虚拟机传送到 OpenShift Virtualization 的网络。这是提供程序的默认传输网络。验证传输网络是否在所选目标命名空间中。

     • 要编辑传输网络，请执行以下操作：

       • 点 Edit 图标。
       • 从列表中选择一个不同的传输网络。
       • 点击 Save。

     • 可选： 要在 OpenShift Web 控制台中配置 OpenShift 网络，点 Networking > NetworkAttachmentDefinitions。

       如需了解更多有关 OpenShift 支持的不同类型的网络的信息，请参阅 OpenShift Container Platform 中的 额外网络。

     • 可选： 要调整 OpenShift 传输网络的最大传输单元(MTU)，还必须更改 VMware 迁移网络的 MTU。如需更多信息，请参阅为 VMware 源供应商选择迁移网络。

   • 目标命名空间 ：所有迁移的虚拟机的目标命名空间。默认情况下，目标命名空间是当前或活跃的命名空间。

     • 要编辑命名空间，请执行以下操作：

       • 点 Edit 图标。
       • 从打开的窗口中的列表中选择不同的目标命名空间。
       • 点击 Save。

9. 如果计划有效，您可以执行以下操作之一：

   1. 现在，点 Start migration 来运行计划。
   2. 稍后，在 Plans for virtualization 页面上选择计划并遵循 运行迁移计划 中的步骤来运行计划。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration > Plans for virtualization。

   Plans 列表显示源和目标供应商、正在迁移的虚拟机数量、状态、迁移的日期以及每个计划的描述。

2. 点迁移计划旁边的 Start 来启用迁移。

3. 在打开的确认窗口中，单击 Start。

   计划 的状态更改为 Running，并显示迁移的进度。

   警告

   开始迁移后不要对虚拟机进行快照。在迁移启动后进行 snaphot 可能会导致迁移失败。

4. 可选：点迁移的 Status 中的链接查看其整体状态和每个虚拟机的状态：

   • 左侧的链接表示迁移失败、成功还是持续。它还会报告迁移成功、失败或被取消的虚拟机数量。

   • 右侧的链接会打开 Plan Details 页面的 Virtual Machines 选项卡。对于每个虚拟机，标签会显示以下数据：

     • 虚拟机的名称
     • 迁移的开始和结束时间
     • 复制的数据量

     • 虚拟机迁移的进度管道

       警告

       对于正在导入的虚拟机，必须禁用 vMotion，包括 svMotion 和 relocate，以避免数据崩溃。

5. 可选： 要在迁移的运行时或完成后查看迁移的日志，请执行以下操作：

   1. 点 Virtual Machines 标签页。

   2. 点击您要检查的虚拟机左侧的箭头(>)。

      此时会显示虚拟机的详情。

   3. 在 Pod link 列中的 Pods 部分，点 Logs 链接。

      Logs 选项卡将打开。

      注意

      日志并不总是可用。以下是日志不可用的常见原因：

      • 迁移是从 OpenShift Virtualization 迁移到 OpenShift Virtualization。在这种情况下，不涉及 virt-v2v，因此不需要 pod。
      • 没有创建 pod。
      • pod 已被删除。
      • 迁移在运行 pod 前失败。
   4. 要查看原始日志，请点 Raw 链接。
   5. 要下载日志，请点 Download 链接。

流程

1. 在 Red Hat OpenShift web 控制台中，单击 Plans for virtualization。
2. 点正在运行的迁移计划的名称查看迁移详情。
3. 选择一个或多个虚拟机，点 Cancel。

4. 点 Yes, cancel 确认取消。

   在 Migration details by VM 列表中，取消的虚拟机的状态为 Canceled。未迁移且迁移的虚拟机不受影响。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration → Providers for virtualization。
2. 单击 Create Provider。
3. 点击 OpenShift Virtualization。

4. 指定以下字段：

   • Provider resource name ：源供应商的名称
   • URL: API 服务器端点的 URL

   • Service account bearer 令牌 ：一个具有 cluster-admin 权限的服务帐户的令牌

     如果 URL 和 Service account bearer 令牌 都留空，则会使用本地 OpenShift 集群。

5. 选择以下选项之一来验证 CA 证书：

   • 使用自定义 CA 证书 ：验证自定义 CA 证书后迁移。
   • 使用系统 CA 证书 ：验证系统 CA 证书后迁移。

   • 跳过证书验证 ：在不验证 CA 证书的情况下迁移。

     1. 要使用自定义 CA 证书，请将 Skip certificate 验证 开关切换为左，并将 CA 证书拖到 文本框中 或浏览该证书，然后点击 Select。
     2. 要使用系统 CA 证书，请将 Skip 证书验证 开关切换到左侧，并将 CA 证书 文本框留空。
     3. 要跳过证书验证，请将 Skip 证书验证 开关切换到右侧。

6. 可选：从供应商的 API 端点 URL 获取自定义 CA 证书。

   1. 点 来自 URL 的 Fetch 证书。此时会打开 Verify certificate 窗口。

   2. 如果详细信息正确，请选择 I trust the authenticity of this certificate 复选框，然后单击 Confirm。如果没有，请单击 Cancel，然后手动输入正确的证书信息。

      确认后，CA 证书将用于验证与 API 端点的后续通信。

7. 点 Create provider 添加并保存该供应商。

   供应商会出现在提供程序列表中。

8. 可选：添加对供应商的 UI 的访问：

   1. 在 Providers 页面上，单击提供程序。

      此时会打开 Provider 详情页面。

   2. 单击 External UI Web 链接 下的 Edit 图标。

   3. 输入链接并单击 保存。

      注意

      如果没有输入链接，则 MTV 会尝试计算正确的链接。

      • 如果 MTV 成功，字段的超链接会指向计算的链接。
      • 如果 MTV 没有成功，该字段会保持为空。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration → Providers for virtualization。
2. 单击 Create Provider。
3. 点击 OpenShift Virtualization。

4. 指定以下字段：

   • Provider resource name ：源供应商的名称
   • URL: API 服务器端点的 URL

   • Service account bearer 令牌 ：一个具有 cluster-admin 权限的服务帐户的令牌

     如果 URL 和 Service account bearer 令牌 都留空，则会使用本地 OpenShift 集群。

5. 选择以下选项之一来验证 CA 证书：

   • 使用自定义 CA 证书 ：验证自定义 CA 证书后迁移。
   • 使用系统 CA 证书 ：验证系统 CA 证书后迁移。

   • 跳过证书验证 ：在不验证 CA 证书的情况下迁移。

     1. 要使用自定义 CA 证书，请将 Skip certificate 验证 开关切换为左，并将 CA 证书拖到 文本框中 或浏览该证书，然后点击 Select。
     2. 要使用系统 CA 证书，请将 Skip 证书验证 开关切换到左侧，并将 CA 证书 文本框留空。
     3. 要跳过证书验证，请将 Skip 证书验证 开关切换到右侧。

6. 可选：从供应商的 API 端点 URL 获取自定义 CA 证书。

   1. 点 来自 URL 的 Fetch 证书。此时会打开 Verify certificate 窗口。

   2. 如果详细信息正确，请选择 I trust the authenticity of this certificate 复选框，然后单击 Confirm。如果没有，请单击 Cancel，然后手动输入正确的证书信息。

      确认后，CA 证书将用于验证与 API 端点的后续通信。

7. 点 Create provider 添加并保存该供应商。

   供应商会出现在提供程序列表中。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration > Providers for virtualization。

2. 点您要更改迁移网络的 OpenShift Virtualization 供应商。

   当 Providers 详情页面 打开时：

3. 点 Networks 标签页。
4. 单击 Set default transfer network。
5. 从列表中选择默认传输网络，然后单击 Save。

6. 通过完成以下步骤，在网络中配置用于 MTV 迁移的网关：

   1. 在 Red Hat OpenShift Web 控制台中，点 Networking > NetworkAttachmentDefinitions。
   2. 选择适当的默认传输网络 NAD。
   3. 点 YAML 标签。

   4. 将 forklift.konveyor.io/route 添加到 YAML 的 metadata:annotations 部分，如下例所示：

      Copy to Clipboard Toggle word wrap

      apiVersion: k8s.cni.cncf.io/v1
      kind: NetworkAttachmentDefinition
      metadata:
        name: localnet-network
        namespace: mtv-test
        annotations:
          forklift.konveyor.io/route: <IP address> 

      1

      1

      需要 NetworkAttachmentDefinition 参数，以便从动态主机配置协议(DHCP)或静态配置接口的 IP 地址。配置 IP 地址可让接口访问配置的网关。

   5. 点击 Save。

流程

1. 在 Red Hat OpenShift web 控制台中，单击 Plans for virtualization，然后单击 Create Plan。

   Create migration plan 向导会打开 Select source provider 接口。

2. 选择您要迁移的虚拟机的源供应商。

   此时会打开 Select virtual machine 界面。

3. 选择您要迁移的虚拟机，然后点 Next。

   Create migration plan 窗格将打开。它显示目标供应商和命名空间、网络映射和存储映射的源供应商名称和建议。

4. 输入 Plan 名称。
5. 要更改 Target provider、Target namespace 或 Network map 或 Storage map 的元素，请从相关列表中选择一个项目。
6. 要添加 网络映射 或存储映射，请单击 + 符号并添加映射。

7. 点 Create migration plan。

   MTV 验证迁移计划，并打开 Plan 详情页面，指示计划是否准备就绪，或包含错误。

   列出计划的详细信息，您可以编辑在上一页上填写的项目。如果您进行任何更改，则 MTV 会再次验证计划。

8. 检查页面的 Settings 部分中的以下项：

   • transfer Network: 用于将虚拟机传送到 OpenShift Virtualization 的网络。这是提供程序的默认传输网络。验证传输网络是否在所选目标命名空间中。

     • 要编辑传输网络，请执行以下操作：

       • 点 Edit 图标。
       • 从列表中选择一个不同的传输网络。
       • 点击 Save。

     • 可选： 要在 OpenShift Web 控制台中配置 OpenShift 网络，点 Networking > NetworkAttachmentDefinitions。

       如需了解更多有关 OpenShift 支持的不同类型的网络的信息，请参阅 OpenShift Container Platform 中的 额外网络。

     • 可选： 要调整 OpenShift 传输网络的最大传输单元(MTU)，还必须更改 VMware 迁移网络的 MTU。如需更多信息，请参阅为 VMware 源供应商选择迁移网络。

   • 目标命名空间 ：所有迁移的虚拟机的目标命名空间。默认情况下，目标命名空间是当前或活跃的命名空间。

     • 要编辑命名空间，请执行以下操作：

       • 点 Edit 图标。
       • 从打开的窗口中的列表中选择不同的目标命名空间。
       • 点击 Save。

9. 如果计划有效，您可以执行以下操作之一：

   1. 现在，点 Start migration 来运行计划。
   2. 稍后，在 Plans for virtualization 页面上选择计划并遵循 运行迁移计划 中的步骤来运行计划。

流程

1. 在 Red Hat OpenShift web 控制台中，点 Migration > Plans for virtualization。

   Plans 列表显示源和目标供应商、正在迁移的虚拟机数量、状态、迁移的日期以及每个计划的描述。

2. 点迁移计划旁边的 Start 来启用迁移。

3. 在打开的确认窗口中，单击 Start。

   计划 的状态更改为 Running，并显示迁移的进度。

   警告

   开始迁移后不要对虚拟机进行快照。在迁移启动后进行 snaphot 可能会导致迁移失败。

4. 可选：点迁移的 Status 中的链接查看其整体状态和每个虚拟机的状态：

   • 左侧的链接表示迁移失败、成功还是持续。它还会报告迁移成功、失败或被取消的虚拟机数量。

   • 右侧的链接会打开 Plan Details 页面的 Virtual Machines 选项卡。对于每个虚拟机，标签会显示以下数据：

     • 虚拟机的名称
     • 迁移的开始和结束时间
     • 复制的数据量

     • 虚拟机迁移的进度管道

       警告

       对于正在导入的虚拟机，必须禁用 vMotion，包括 svMotion 和 relocate，以避免数据崩溃。

5. 可选： 要在迁移的运行时或完成后查看迁移的日志，请执行以下操作：

   1. 点 Virtual Machines 标签页。

   2. 点击您要检查的虚拟机左侧的箭头(>)。

      此时会显示虚拟机的详情。

   3. 在 Pod link 列中的 Pods 部分，点 Logs 链接。

      Logs 选项卡将打开。

      注意

      日志并不总是可用。以下是日志不可用的常见原因：

      • 迁移是从 OpenShift Virtualization 迁移到 OpenShift Virtualization。在这种情况下，不涉及 virt-v2v，因此不需要 pod。
      • 没有创建 pod。
      • pod 已被删除。
      • 迁移在运行 pod 前失败。
   4. 要查看原始日志，请点 Raw 链接。
   5. 要下载日志，请点 Download 链接。

流程

1. 在 Red Hat OpenShift web 控制台中，单击 Plans for virtualization。
2. 点正在运行的迁移计划的名称查看迁移详情。
3. 选择一个或多个虚拟机，点 Cancel。

4. 点 Yes, cancel 确认取消。

   在 Migration details by VM 列表中，取消的虚拟机的状态为 Canceled。未迁移且迁移的虚拟机不受影响。

流程

1. 为源供应商凭证创建 Secret 清单：

   Copy to Clipboard Toggle word wrap

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: Secret
   metadata:
     name: <secret>
     namespace: <namespace>
     ownerReferences: 

   1

   
       - apiVersion: forklift.konveyor.io/v1beta1
         kind: Provider
         name: <provider_name>
         uid: <provider_uid>
     labels:
       createdForProviderType: vsphere
       createdForResourceType: providers
   type: Opaque
   stringData:
     user: <user> 

   2

   
     password: <password> 

   3

   
     insecureSkipVerify: <"true"/"false"> 

   4

   
     cacert: | 

   5

   
       <ca_certificate>
     url: <api_end_point> 

   6

   
   EOF

   1

   ownerReferences 部分是可选的。

   2

   指定 vCenter 用户或 ESX/ESXi 用户。

   3

   指定 vCenter 用户或 ESX/ESXi 用户的密码。

   4

   指定 "true" 以跳过证书验证，并指定 "false" 来验证证书。如果没有指定，则默认为 "false "。跳过证书验证会进行不安全的迁移，然后不需要证书。不安全的迁移意味着传输的数据通过安全连接发送，并可能会公开敏感数据。

   5

   如果没有设置此字段并禁用 跳过证书验证 时，MTV 会尝试使用系统 CA。

   6

   指定 vCenter 的 API 端点 URL 或 ESX/ESXi，例如 https://<vCenter_host>/sdk。

2. 为源供应商创建 Provider 清单：

   Copy to Clipboard Toggle word wrap

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Provider
   metadata:
     name: <source_provider>
     namespace: <namespace>
   spec:
     type: vsphere
     url: <api_end_point> 

   1

   
     settings:
       vddkInitImage: <VDDK_image> 

   2

   
       sdkEndpoint: vcenter 

   3

   
     secret:
       name: <secret> 

   4

   
       namespace: <namespace>
   EOF

   1

   指定 API 端点的 URL，例如 https://<vCenter_host>/sdk。

   2

   可选，但强烈建议创建一个 VDDK 镜像来加快迁移。按照 OpenShift 文档指定您创建的 VDDK 镜像。

   3

   选项： vcenter 或 esxi。

   4

   指定供应商 Secret CR 的名称。

3. 创建 主机清单 ：

   Copy to Clipboard Toggle word wrap

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Host
   metadata:
     name: <vmware_host>
     namespace: <namespace>
   spec:
     provider:
       namespace: <namespace>
       name: <source_provider> 

   1

   
     id: <source_host_mor> 

   2

   
     ipAddress: <source_network_ip> 

   3

   
   EOF

   1

   指定 VMware vSphere Provider CR 的名称。

   2

   指定 VMware vSphere 主机的 Managed Object Reference (moRef)。要检索 moRef，请参阅 检索 VMware vSphere moRef。

   3

   指定 VMware vSphere 迁移网络的 IP 地址。

4. 创建 NetworkMap 清单来映射源和目标网络：

   Copy to Clipboard Toggle word wrap

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: NetworkMap
   metadata:
     name: <network_map>
     namespace: <namespace>
   spec:
     map:
       - destination:
           name: <network_name>
           type: pod 

   1

   
         source: 

   2

   
           id: <source_network_id>
           name: <source_network_name>
       - destination:
           name: <network_attachment_definition> 

   3

   
           namespace: <network_attachment_definition_namespace> 

   4

   
           type: multus
         source:
           id: <source_network_id>
           name: <source_network_name>
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   1

   允许的值有 pod、multus，并忽略。使用 忽略 以避免在此迁移中将虚拟机附加到这个网络。

   2

   您可以使用 id 或 name 参数来指定源网络。对于 id，指定 VMware vSphere 网络受管对象参考(moRef)。要检索 moRef，请参阅 检索 VMware vSphere moRef。

   3

   为每个额外 OpenShift Virtualization 网络指定网络附加定义。

   4

   仅在 类型 multus 时才需要。指定 OpenShift Virtualization 网络附加定义的命名空间。

5. 创建 StorageMap 清单来映射源和目标存储：

   Copy to Clipboard Toggle word wrap

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: StorageMap
   metadata:
     name: <storage_map>
     namespace: <namespace>
   spec:
     map:
       - destination:
           storageClass: <storage_class>
           accessMode: <access_mode> 

   1

   
         source:
           id: <source_datastore> 

   2

   
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   1

   允许的值有 ReadWriteOnce 和 ReadWriteMany。

   2

   指定 VMware vSphere 数据存储 moRef。例如，f2737930-b567-451a-9ceb-2887f6207009。要检索 moRef，请参阅 检索 VMware vSphere moRef。

6. 可选：在 Plan CR 中指定的阶段创建一个 Hook 清单以在虚拟机中运行自定义代码：

   Copy to Clipboard Toggle word wrap

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Hook
   metadata:
     name: <hook>
     namespace: <namespace>
   spec:
     image: quay.io/kubev2v/hook-runner
     serviceAccount:<service account> 

   1

   
     playbook: |
       LS0tCi0gbm... 

   2

   
   EOF

   1

   可选： Red Hat OpenShift 服务帐户。使用 serviceAccount 参数修改任何集群资源。

   2

   base64 编码的 Ansible Playbook.如果指定了 playbook，镜像 必须包含 ansible-runner。

   注意

   您可以使用默认 hook-runner 镜像或指定自定义镜像。如果指定自定义镜像，则不需要指定 playbook。

7. 输入以下命令为 MTV 迁移创建传输网络的网络附加定义(NAD)。

   您可以使用此定义为接口配置 IP 地址，可以从 Dynamic Host Configuration Protocol (DHCP)或静态方式配置。

   配置 IP 地址可让接口访问配置的网关。

   Copy to Clipboard Toggle word wrap

   $ oc edit NetworkAttachmentDefinitions <name_of_the_NAD_to_edit>
   apiVersion: k8s.cni.cncf.io/v1
   kind: NetworkAttachmentDefinition
   metadata:
     name: <name_of_transfer_network>
     namespace: <namespace>
     annotations:
       forklift.konveyor.io/route: <IP_address>

8. 为迁移创建 Plan 清单：

   Copy to Clipboard Toggle word wrap

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Plan
   metadata:
     name: <plan> 

   1

   
     namespace: <namespace>
   spec:
     warm: false 

   2

   
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
     map: 

   3

   
       network: 

   4

   
         name: <network_map> 

   5

   
         namespace: <namespace>
       storage: 

   6

   
         name: <storage_map> 

   7

   
         namespace: <namespace>
     preserveStaticIPs: 

   8

   
     networkNameTemplate: <network_interface_template> 

   9

   
     pvcNameTemplate: <pvc_name_template> 

   10

   
     pvcNameTemplateUseGenerateName: true 

   11

   
     targetNamespace: <target_namespace>
     volumeNameTemplate: <volume_name_template> 

   12

   
     vms: 

   13

   
       - id: <source_vm1> 

   14

   
       - name: <source_vm2>
         networkNameTemplate: <network_interface_template_for_this_vm> 

   15

   
         pvcNameTemplate: <pvc_name_template_for_this_vm> 

   16

   
         volumeNameTemplate: <volume_name_template_for_this_vm> 

   17

   
         targetName: <target_name> 

   18

   
         hooks: 

   19

   
           - hook:
               namespace: <namespace>
               name: <hook> 

   20

   
             step: <step> 

   21

   
   
   EOF

   1

   指定 Plan CR 的名称。

   2

   指定迁移是 warm - true - 或 cold - false。如果您指定了 warm 迁移，且没有为 Migration 清单中的 cutover 参数指定一个值，则只有 precopy 阶段将运行。

   3

   每个计划仅指定一个网络映射和一个存储映射。

   4

   指定一个网络映射，即使要迁移的虚拟机没有分配给网络。在这种情况下，映射可以为空。

   5

   指定 NetworkMap CR 的名称。

   6

   指定一个存储映射，即使要迁移的虚拟机没有使用磁盘镜像分配。在这种情况下，映射可以为空。

   7

   指定 StorageMap CR 的名称。

   8

   默认情况下，虚拟网络接口控制器(vNIC)在迁移过程中会改变。因此，使用链接到客户端虚拟机中接口名称的静态 IP 地址的 vNIC 会丢失其 IP 地址。
   要避免这种情况，请将 preserveStaticIPs 设置为 true。MTV 对缺少 vNIC 属性的任何虚拟机发出警告消息。要检索任何缺少的 vNIC 属性，请在 vSphere 中运行这些虚拟机，以便向 MTV 报告 vNIC 属性。

   9

   可选。在计划中为虚拟机指定网络接口模板。模板遵循 Go 模板语法，并可访问以下变量：

   • .networkName: 如果目标网络是 multus，请添加 Multus 网络附加定义的名称。否则，将此变量留空。
   • .networkNamespace ：如果目标网络是 multus，请添加 Multus 网络附加定义所在的命名空间。
   • .networkType ：指定网络类型。选项： multus 或 pod。

   • .NetworkIndex ：网络接口的序列索引(0-based)。

     例子

   • "net-{{.NetworkIndex}}"

   • {{if eq .NetworkType "pod"}}pod{{else}}multus-{{.NetworkIndex}}{{end}}"

     变量名称不能超过 63 个字符。此规则适用于网络名称网络模板、PVC 名称模板、虚拟机名称模板和卷名称模板。

   10

   可选。为计划指定持久性卷声明(PVC)名称模板。模板遵循 Go 模板语法，并可访问以下变量：

   • .vmname: 虚拟机的名称。
   • .PlanName: 迁移计划的名称。
   • .DiskIndex ：磁盘的初始卷索引。
   • .RootDiskIndex ：根磁盘索引。

   • . shared : Options: true，用于非共享卷的共享卷为 false。

     例子

   • "{{.vmname}}-disk-{{.DiskIndex}}"
   • "{{if eq .DiskIndex .RootDiskIndex}}root{{else}}data{{end}}-{{.DiskIndex}}"
   • "{{if .Shared}}shared-{{end}}{{.VmName}}-{{.DiskIndex}}"

   11

   可选：

   • 当设置为 true 时，MTV 会将一个或多个 rundonly 生成的字母数字字符添加到 PVC 名称中，以确保所有 PVC 都有唯一的名称。

   • 当设置为 false 时，如果您指定了 pvcNameTemplate，则 MTV 不会将此类 charchter 添加到 PVC 的名称中。

     警告

     如果将 pvcNameTemplateUseGenerateName 设置为 false，则生成的 PVC 名称可能不是唯一的，并可能导致冲突。

   12

   可选：在计划中为虚拟机指定卷接口名称模板。模板遵循 Go 模板语法，并可访问以下变量：

   • .PVCName: 使用这个卷挂载到虚拟机的 PVC 名称。

   • .VolumeIndex ：卷接口(0)的 Sequential 索引。

     例子

   • "disk-{{.VolumeIndex}}"
   • "pvc-{{.PVCName}}"

   13

   您可以使用 id 或 name 参数指定源虚拟机。

   14

   指定 VMware vSphere VM moRef。要检索 moRef，请参阅 检索 VMware vSphere moRef。

   15

   可选：指定特定虚拟机的网络接口名称。覆盖 spec:networkNameTemplate 中设置的值。变量和示例，如调用 9 所示。

   16

   可选：指定特定虚拟机的 PVC 名称。覆盖 spec:pvcNameTemplate 中设置的值。变量和示例如调用 10 所示。

   17

   可选：指定特定虚拟机的卷名称。覆盖 spec:volumeNameTemplate 中设置的值。变量和示例，如调用 12 所示。

   18

   可选： MTV 会自动为目标虚拟机的名称。您可以使用此参数并输入新名称来覆盖此名称。您输入的名称必须是唯一的，且必须是有效的 Kubernetes 子域。否则，迁移会自动失败。

   19

   可选：为虚拟机指定最多两个 hook。每个 hook 必须在不同的迁移步骤中运行。

   20

   指定 Hook CR 的名称。

   21

   在迁移完成后，允许的值是 PreHook、在迁移计划启动前或 PostHook。

   重要

   当您将 VMware 7 虚拟机迁移到使用 CentOS 7.9 的 OpenShift 4.13+ 平台时，网络接口的名称会改变，虚拟机的静态 IP 配置无法正常工作。

9. 创建运行 Plan CR 的 Migration 清单：

   Copy to Clipboard Toggle word wrap

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Migration
   metadata:
     name: <name_of_migration_cr>
     namespace: <namespace>
   spec:
     plan:
       name: <name_of_plan_cr>
       namespace: <namespace>
     cutover: <optional_cutover_time>
   EOF

   注意

   如果您指定了一个截止时间，请使用 ISO 8601 格式以及 UTC 时间偏移，例如 2024-04-04T01:23:45.678+09:00。