流程

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

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

2. 在浏览器中，进入 VMware VDDK 版本 7 下载页面。
3. 选择版本 7.0.3.2 并点 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
   USER 1001
   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. 连接到 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. 为项目检索路由：

   oc get route -n openshift-mtv

2. 检索 Inventory 服务路由：

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

3. 检索访问令牌：

   $ TOKEN=$(oc whoami -t)

4. 触发 HTTP GET 请求（例如，使用 Curl）：

   $ curl -H "Authorization: Bearer $TOKEN" https://<inventory_service_route>/providers -k

5. 检索供应商的 UUID ：

   $ curl -H "Authorization: Bearer $TOKEN"  https://<inventory_service_route>/providers/<provider> -k 1

   1

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

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

   $ curl -H "Authorization: Bearer $TOKEN"  https://<inventory_service_route>/providers/<provider>/<UUID>/vms -k

7. 检索虚拟机的详情：

   $ curl -H "Authorization: Bearer $TOKEN"  https://<inventory_service_route>/providers/<provider>/<UUID>/workloads/<vm> -k

   输出示例

   {
       "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

   指定 concerns 名称和 Rego 查询。

   3

   指定 concerns 名称和 flag 参数值。

   4

   允许的值是 Critical, Warning, 和 Information。

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

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

3. 通过将 forklift-controller 部署扩展到 1 来启动 Validation pod：

   $ 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 用于 vSphere，或 https://<engine_host>/ovirt-engine/api/ 用于 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 有动态置备程序，则 StorageClass 置备程序会动态置备持久性卷(PV)。
4. CDI Controller 服务创建一个 importer pod。

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

   虚拟机磁盘传输后：

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

   conversion 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 logs。

流程

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

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

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

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

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

   • 命名空间：

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

   • 迁移计划：

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

   • 虚拟机：

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

     1

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