流程

1. 创建并导航到临时目录：

   $ mkdir /tmp/<dir_name> && cd /tmp/<dir_name>

2. 在浏览器中，导航到 VMware VDDK 下载页面。
3. 选择最新的 VDDK 版本并点 Download。
4. 将 VDDK 归档文件保存到临时目录中。

5. 提取 VDDK 归档：

   $ tar -xzf VMware-vix-disklib-<version>.x86_64.tar.gz

6. 创建 Dockerfile：

   $ cat > Dockerfile <<EOF
   FROM registry.access.redhat.com/ubi8/ubi-minimal
   COPY vmware-vix-disklib-distrib /vmware-vix-disklib-distrib
   RUN mkdir -p /opt
   ENTRYPOINT ["cp", "-r", "/vmware-vix-disklib-distrib", "/opt"]
   EOF

7. 构建 VDDK 镜像：

   $ podman build . -t <registry_route_or_server_path>/vddk:<tag>

8. 将 VDDK 镜像推送到 registry：

   $ podman push <registry_route_or_server_path>/vddk:<tag>

9. 确保镜像可以被 OpenShift Virtualization 环境访问。

流程

1. 以 root 用户身份登录 ESXi 主机。

2. 在 /etc/vmware/hostd/config.xml 中将 maxMemory 改为 1000000000:

   ...
         <nfcsvc>
            <path>libnfcsvc.so</path>
            <enabled>true</enabled>
            <maxMemory>1000000000</maxMemory>
            <maxStreamMemory>10485760</maxStreamMemory>
         </nfcsvc>
   ...

3. 重启 hostd ：

   # /etc/init.d/hostd restart

   您不需要重启主机。

流程

1. 将 VDDK 镜像添加到 HyperConverged CR：

   $ cat << EOF | oc apply -f -
   apiVersion: hco.kubevirt.io/v1beta1
   kind: HyperConverged
   metadata:
     name: kubevirt-hyperconverged
     namespace: openshift-cnv
   spec:
     vddkInitImage: <registry_route_or_server_path>/vddk:<tag> 1
   EOF

   1

   指定您创建的 VDDK 镜像。

2. 在 MTV web 控制台中，单击 Providers。
3. 点 Add provider。
4. 从 Type 列表中选择 VMware。

5. 填写以下字段：

   • 名称 ：要在供应商列表中显示的名称
   • 主机名或 IP 地址 ： vCenter 主机名或 IP 地址
   • 用户名 ： vCenter admin 用户，例如 administrator@vsphere.local
   • 密码 ： vCenter admin 密码
   • SHA-1 指纹 ： vCenter SHA-1 指纹

6. 点 Add 添加并保存该提供程序。

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

流程

1. 在 MTV web 控制台中，单击 Providers。
2. 点 Add provider。
3. 从 Type 列表中选择 Red Hat Virtualization。

4. 填写以下字段：

   • 名称 ：要在供应商列表中显示的名称
   • 主机名或 IP 地址 ：管理器主机名或 IP 地址
   • 用户名 ： Manager 用户
   • 密码 ： Manager 密码
   • CA 证书 ： Manager 的 CA 证书

5. 点 Add 添加并保存该提供程序。

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

流程

1. 在 MTV web 控制台中，单击 Providers。
2. 点 Add provider。
3. 从 Type 列表中选择 OpenShift Virtualization。

4. 完成以下字段：

   • Cluster name ：指定要在目标供应商列表中显示的集群名称。
   • URL ：指定集群的 API 端点。
   • Service account token ：指定 cluster-admin 服务帐户令牌。
5. 点 Check connection 来验证凭证。

6. 点击 Add。

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

流程

1. 连接到 Validation pod 的终端：

   $ oc rsh <validation_pod>

2. 进入您的供应商的 OPA 策略目录：

   $ cd /usr/share/opa/policies/io/konveyor/forklift/<provider> 1

   1

   指定 vmware 或 ovirt。

3. 搜索默认策略：

   $ grep -R "default" *

流程

1. 检索 Inventory 服务路由：

   $ oc get route <inventory_service> -n openshift-mtv

2. 检索供应商的 UUID ：

   $ GET https://<inventory_service_route>/providers/<provider> 1

   1

   供应商允许的值有 vsphere 和 ovirt。

3. 检索供应商的虚拟机：

   $ GET https://<inventory_service_route>/providers/<provider>/<UUID>/vms

4. 检索虚拟机的详情：

   $ GET https://<inventory_service_route>/providers/<provider>/<UUID>/workloads/<vm>

   输出示例

   {
       "input": {
           "selfLink": "providers/vsphere/c872d364-d62b-46f0-bd42-16799f40324e/workloads/vm-431",
           "id": "vm-431",
           "parent": {
               "kind": "Folder",
               "id": "group-v22"
           },
           "revision": 1,
           "name": "iscsi-target",
           "revisionValidated": 1,
           "isTemplate": false,
           "networks": [
               {
                   "kind": "Network",
                   "id": "network-31"
               },
               {
                   "kind": "Network",
                   "id": "network-33"
               }
           ],
           "disks": [
               {
                   "key": 2000,
                   "file": "[iSCSI_Datastore] iscsi-target/iscsi-target-000001.vmdk",
                   "datastore": {
                       "kind": "Datastore",
                       "id": "datastore-63"
                   },
                   "capacity": 17179869184,
                   "shared": false,
                   "rdm": false
               },
               {
                   "key": 2001,
                   "file": "[iSCSI_Datastore] iscsi-target/iscsi-target_1-000001.vmdk",
                   "datastore": {
                       "kind": "Datastore",
                       "id": "datastore-63"
                   },
                   "capacity": 10737418240,
                   "shared": false,
                   "rdm": false
               }
           ],
           "concerns": [],
           "policyVersion": 5,
           "uuid": "42256329-8c3a-2a82-54fd-01d845a8bf49",
           "firmware": "bios",
           "powerState": "poweredOn",
           "connectionState": "connected",
           "snapshot": {
               "kind": "VirtualMachineSnapshot",
               "id": "snapshot-3034"
           },
           "changeTrackingEnabled": false,
           "cpuAffinity": [
               0,
               2
           ],
           "cpuHotAddEnabled": true,
           "cpuHotRemoveEnabled": false,
           "memoryHotAddEnabled": false,
           "faultToleranceEnabled": false,
           "cpuCount": 2,
           "coresPerSocket": 1,
           "memoryMB": 2048,
           "guestName": "Red Hat Enterprise Linux 7 (64-bit)",
           "balloonedMemory": 0,
           "ipAddress": "10.19.2.96",
           "storageUsed": 30436770129,
           "numaNodeAffinity": [
               "0",
               "1"
           ],
           "devices": [
               {
                   "kind": "RealUSBController"
               }
           ],
           "host": {
               "id": "host-29",
               "parent": {
                   "kind": "Cluster",
                   "id": "domain-c26"
               },
               "revision": 1,
               "name": "IP address or host name of the vCenter host or RHV Engine host",
               "selfLink": "providers/vsphere/c872d364-d62b-46f0-bd42-16799f40324e/hosts/host-29",
               "status": "green",
               "inMaintenance": false,
               "managementServerIp": "10.19.2.96",
               "thumbprint": <thumbprint>,
               "timezone": "UTC",
               "cpuSockets": 2,
               "cpuCores": 16,
               "productName": "VMware ESXi",
               "productVersion": "6.5.0",
               "networking": {
                   "pNICs": [
                       {
                           "key": "key-vim.host.PhysicalNic-vmnic0",
                           "linkSpeed": 10000
                       },
                       {
                           "key": "key-vim.host.PhysicalNic-vmnic1",
                           "linkSpeed": 10000
                       },
                       {
                           "key": "key-vim.host.PhysicalNic-vmnic2",
                           "linkSpeed": 10000
                       },
                       {
                           "key": "key-vim.host.PhysicalNic-vmnic3",
                           "linkSpeed": 10000
                       }
                   ],
                   "vNICs": [
                       {
                           "key": "key-vim.host.VirtualNic-vmk2",
                           "portGroup": "VM_Migration",
                           "dPortGroup": "",
                           "ipAddress": "192.168.79.13",
                           "subnetMask": "255.255.255.0",
                           "mtu": 9000
                       },
                       {
                           "key": "key-vim.host.VirtualNic-vmk0",
                           "portGroup": "Management Network",
                           "dPortGroup": "",
                           "ipAddress": "10.19.2.13",
                           "subnetMask": "255.255.255.128",
                           "mtu": 1500
                       },
                       {
                           "key": "key-vim.host.VirtualNic-vmk1",
                           "portGroup": "Storage Network",
                           "dPortGroup": "",
                           "ipAddress": "172.31.2.13",
                           "subnetMask": "255.255.0.0",
                           "mtu": 1500
                       },
                       {
                           "key": "key-vim.host.VirtualNic-vmk3",
                           "portGroup": "",
                           "dPortGroup": "dvportgroup-48",
                           "ipAddress": "192.168.61.13",
                           "subnetMask": "255.255.255.0",
                           "mtu": 1500
                       },
                       {
                           "key": "key-vim.host.VirtualNic-vmk4",
                           "portGroup": "VM_DHCP_Network",
                           "dPortGroup": "",
                           "ipAddress": "10.19.2.231",
                           "subnetMask": "255.255.255.128",
                           "mtu": 1500
                       }
                   ],
                   "portGroups": [
                       {
                           "key": "key-vim.host.PortGroup-VM Network",
                           "name": "VM Network",
                           "vSwitch": "key-vim.host.VirtualSwitch-vSwitch0"
                       },
                       {
                           "key": "key-vim.host.PortGroup-Management Network",
                           "name": "Management Network",
                           "vSwitch": "key-vim.host.VirtualSwitch-vSwitch0"
                       },
                       {
                           "key": "key-vim.host.PortGroup-VM_10G_Network",
                           "name": "VM_10G_Network",
                           "vSwitch": "key-vim.host.VirtualSwitch-vSwitch1"
                       },
                       {
                           "key": "key-vim.host.PortGroup-VM_Storage",
                           "name": "VM_Storage",
                           "vSwitch": "key-vim.host.VirtualSwitch-vSwitch1"
                       },
                       {
                           "key": "key-vim.host.PortGroup-VM_DHCP_Network",
                           "name": "VM_DHCP_Network",
                           "vSwitch": "key-vim.host.VirtualSwitch-vSwitch1"
                       },
                       {
                           "key": "key-vim.host.PortGroup-Storage Network",
                           "name": "Storage Network",
                           "vSwitch": "key-vim.host.VirtualSwitch-vSwitch1"
                       },
                       {
                           "key": "key-vim.host.PortGroup-VM_Isolated_67",
                           "name": "VM_Isolated_67",
                           "vSwitch": "key-vim.host.VirtualSwitch-vSwitch2"
                       },
                       {
                           "key": "key-vim.host.PortGroup-VM_Migration",
                           "name": "VM_Migration",
                           "vSwitch": "key-vim.host.VirtualSwitch-vSwitch2"
                       }
                   ],
                   "switches": [
                       {
                           "key": "key-vim.host.VirtualSwitch-vSwitch0",
                           "name": "vSwitch0",
                           "portGroups": [
                               "key-vim.host.PortGroup-VM Network",
                               "key-vim.host.PortGroup-Management Network"
                           ],
                           "pNICs": [
                               "key-vim.host.PhysicalNic-vmnic4"
                           ]
                       },
                       {
                           "key": "key-vim.host.VirtualSwitch-vSwitch1",
                           "name": "vSwitch1",
                           "portGroups": [
                               "key-vim.host.PortGroup-VM_10G_Network",
                               "key-vim.host.PortGroup-VM_Storage",
                               "key-vim.host.PortGroup-VM_DHCP_Network",
                               "key-vim.host.PortGroup-Storage Network"
                           ],
                           "pNICs": [
                               "key-vim.host.PhysicalNic-vmnic2",
                               "key-vim.host.PhysicalNic-vmnic0"
                           ]
                       },
                       {
                           "key": "key-vim.host.VirtualSwitch-vSwitch2",
                           "name": "vSwitch2",
                           "portGroups": [
                               "key-vim.host.PortGroup-VM_Isolated_67",
                               "key-vim.host.PortGroup-VM_Migration"
                           ],
                           "pNICs": [
                               "key-vim.host.PhysicalNic-vmnic3",
                               "key-vim.host.PhysicalNic-vmnic1"
                           ]
                       }
                   ]
               },
               "networks": [
                   {
                       "kind": "Network",
                       "id": "network-31"
                   },
                   {
                       "kind": "Network",
                       "id": "network-34"
                   },
                   {
                       "kind": "Network",
                       "id": "network-57"
                   },
                   {
                       "kind": "Network",
                       "id": "network-33"
                   },
                   {
                       "kind": "Network",
                       "id": "dvportgroup-47"
                   }
               ],
               "datastores": [
                   {
                       "kind": "Datastore",
                       "id": "datastore-35"
                   },
                   {
                       "kind": "Datastore",
                       "id": "datastore-63"
                   }
               ],
               "vms": null,
               "networkAdapters": [],
               "cluster": {
                   "id": "domain-c26",
                   "parent": {
                       "kind": "Folder",
                       "id": "group-h23"
                   },
                   "revision": 1,
                   "name": "mycluster",
                   "selfLink": "providers/vsphere/c872d364-d62b-46f0-bd42-16799f40324e/clusters/domain-c26",
                   "folder": "group-h23",
                   "networks": [
                       {
                           "kind": "Network",
                           "id": "network-31"
                       },
                       {
                           "kind": "Network",
                           "id": "network-34"
                       },
                       {
                           "kind": "Network",
                           "id": "network-57"
                       },
                       {
                           "kind": "Network",
                           "id": "network-33"
                       },
                       {
                           "kind": "Network",
                           "id": "dvportgroup-47"
                       }
                   ],
                   "datastores": [
                       {
                           "kind": "Datastore",
                           "id": "datastore-35"
                       },
                       {
                           "kind": "Datastore",
                           "id": "datastore-63"
                       }
                   ],
                   "hosts": [
                       {
                           "kind": "Host",
                           "id": "host-44"
                       },
                       {
                           "kind": "Host",
                           "id": "host-29"
                       }
                   ],
                   "dasEnabled": false,
                   "dasVms": [],
                   "drsEnabled": true,
                   "drsBehavior": "fullyAutomated",
                   "drsVms": [],
                   "datacenter": null
               }
           }
       }
   }

流程

1. 根据以下示例创建配置映射 CR：

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: <forklift-validation-config>
     namespace: openshift-mtv
   data:
     vmware_multiple_disks.rego: |-
       package <provider_package> 1
   
       has_multiple_disks { 2
         count(input.disks) > 1
       }
   
       concerns[flag] {
         has_multiple_disks 3
           flag := {
             "category": "<Information>", 4
             "label": "Multiple disks detected",
             "assessment": "Multiple disks detected on this VM."
           }
       }
   EOF

   1

   指定供应商软件包名称。允许的值是 VMware 的 io.konveyor.forklift.vmware 和 io.konveyor.forklift.ovirt。

   2

   指定 问题 名称和 Rego 查询。

   3

   指定 concerns 名称和 标志 参数值。

   4

   允许的值是 Critical、警告 和信息 。

2. 通过将 forklift-controller 部署扩展到 0 来停止 Validation pod：

   $ oc scale -n openshift-mtv --replicas=0 deployment/forklift-controller

3. 通过将 forklift-controller 部署扩展到 1：

   $ oc scale -n openshift-mtv --replicas=1 deployment/forklift-controller

4. 检查 Validation pod 日志，以验证 pod 是否已启动：

   $ oc logs -f <validation_pod>

   如果自定义规则与默认规则冲突，则 Validation pod 将不会启动。

5. 删除源供应商：

   $ oc delete provider <provider> -n openshift-mtv

6. 添加源供应商以应用新规则：

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Provider
   metadata:
     name: <provider>
     namespace: openshift-mtv
   spec:
     type: <provider_type> 1
     url: <api_end_point> 2
     secret:
       name: <secret> 3
       namespace: openshift-mtv
   EOF

   1

   允许的值是 ovirt 和 vsphere。

   2

   指定 API 端点 URL，例如： https://<vCenter_host>/sdk for vSphere 或 https://<engine_host>/ovirt-engine/api/ for RHV。

   3

   指定供应商 Secret CR 的名称。

流程

1. 检索当前的规则版本：

   $ GET https://forklift-validation/v1/data/io/konveyor/forklift/<provider>/rules_version 1

   输出示例

   {
      "result": {
          "rules_version": 5
      }
   }

2. 连接到 Validation pod 的终端：

   $ oc rsh <validation_pod>

3. 更新 /usr/share/opa/policies/io/konveyor/forklift/<provider>/rules_version.rego 文件中的规则 版本。
4. 从 Validation pod 终端注销。

5. 验证更新的规则版本：

   $ GET https://forklift-validation/v1/data/io/konveyor/forklift/<provider>/rules_version 1

   输出示例

   {
      "result": {
          "rules_version": 6
      }
   }

1. 您可以创建一个源供应商、目标供应商、网络映射和存储映射。

2. 您可以创建一个包含以下资源的 Plan 自定义资源(CR)：

   • 源供应商
   • 目标供应商，如果目标集群上没有安装 MTV
   • 网络映射
   • 存储映射
   • 一个或多个虚拟机(VM)

3. 您可以通过创建一个引用 Plan CR 的 Migration CR 来运行迁移计划。

   如果出于某种原因无法迁移所有虚拟机，则可以为同一 Plan CR 创建多个 Migration CR，直到虚拟机迁移为止。

4. 对于 Plan CR 中的每个虚拟机，Migration Controller 服务会创建一个 VirtualMachine CR，并在 Migration CR 中记录虚拟机迁移进度。

   当迁移所有虚拟机时，Migration Controller 服务会将 Plan CR 的状态更新为 Completed。每个源虚拟机的电源状态在迁移后会被维护。

1. 当您创建一个 Migration 自定义资源(CR)来运行迁移计划时，Migration Controller 服务为每个源虚拟机(VM)和 DataVolume CR 创建一个 VirtualMachine CR。

   对于每个 VM 磁盘：

2. Containerized Data Importer(CDI) 控制器服务根据 DataVolume CR 中指定的参数创建一个持久性卷声明(PVC)。
3. 如果 StorageClass 有一个动态置备程序，则持久性卷(PV)由 StorageClass 置备程序动态置备。
4. CDI Controller 服务创建一个 导入程序 pod。

5. importer pod 将虚拟机磁盘流传输到 PV。

   虚拟机磁盘传输后：

6. Migration Controller 服务创建一个 转换 pod，并附加了 PVC。

   转换 pod 运行 virt-v2v，它会在目标虚拟机的 PVC 中安装和配置设备驱动程序。

7. 当目标虚拟机开机时，KubeVirt Controller 服务会创建一个 virt-launcher pod 和 VirtualMachineInstance CR。

   virt-launcher pod 运行 QEMU-KVM，并附加了作为 VM 磁盘的 PVC。

流程

1. 在 web 控制台中点 Migration Plan。
2. 点迁移计划名称旁的 Get logs。

3. 在 Get logs 窗口中点击 Get logs。

   日志会被收集。此时会显示 Log collection complete 信息。

4. 点 Download logs 下载存档文件。
5. 要下载迁移的虚拟机的日志，请点击迁移计划名称，然后点击 VM 的 Get 日志。

流程

1. 进入要存储 must-gather 数据的目录。

2. 运行 oc adm must-gather 命令：

   $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.2.0

   数据被保存为 /must-gather/must-gather.tar.gz。您可以将此文件上传到红帽客户门户网站中的支持问题单中。

3. 可选：使用以下选项运行 oc adm must-gather 命令来收集过滤的数据：

   • Namespace：

     $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.2.0 \
       -- NS=<namespace> /usr/bin/targeted

   • 迁移计划：

     $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.2.0 \
       -- PLAN=<migration_plan> /usr/bin/targeted

   • 虚拟机：

     $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.2.0 \
       -- VM=<vm_name> NS=<namespace> /usr/bin/targeted 1

     1

     您必须指定 虚拟机名称，而不是虚拟机 ID，因为它出现在 Plan CR 中。