Migration Toolkit for Virtualization 설치 및 사용

절차

1. 임시 디렉터리를 만들고 해당 디렉터리로 이동합니다.

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

2. 브라우저에서 VMware VDDK 버전 7 다운로드 페이지로 이동합니다.
3. 버전 7.0.3.2를 선택하고 다운로드를 클릭합니다.
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 이미지를 레지스트리로 푸시합니다.

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

9. OpenShift Virtualization 환경에서 이미지에 액세스할 수 있는지 확인합니다.

절차

1. ESXi 호스트에 root로 로그인합니다.

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. 인벤토리 서비스 경로를 검색합니다.

   $ 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. 공급자의 VM을 검색합니다.

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

7. VM의 세부 정보를 검색합니다.

   $ 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

   공급자 패키지 이름을 지정합니다. Red Hat Virtualization의 경우 허용되는 값은 VMware의 경우 io.konveyor.forklift.vmware 및 io.konveyor.forklift.ovirt 입니다.

   2

   concerns name 및 Rego 쿼리를 지정합니다.

   3

   concerns 이름 및 플래그 매개변수 값을 지정합니다.

   4

   허용되는 값은 Critical,Warning 및 Information 입니다.

2. forklift-controller 배포를 0 으로 스케일링하여 유효성 검사 Pod를 중지합니다.

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

3. forklift-controller 배포를 1 로 확장하여 유효성 검사 Pod를 시작합니다.

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

4. 검증 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을 지정합니다(예: vSphere의 경우 https://<vCenter_host>/sdk 또는 RHV의 경우 https://<engine_host>/ovirt-engine/api/ ).

   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. 검증 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을 참조하는 마이그레이션 CR을 생성하여 마이그레이션 계획을 실행합니다.

   어떠한 이유로든 모든 VM을 마이그레이션할 수 없는 경우 모든 VM이 마이그레이션될 때까지 동일한 Plan CR에 대해 여러 개의 Migration CR을 생성할 수 있습니다.

4. Plan CR의 각 VM에 대해 Migration Controller 서비스는 VirtualMachine CR을 생성하고 Migration CR에서 VM 마이그레이션 진행 상황을 기록합니다.

   모든 VM이 마이그레이션되면 Migration Controller 서비스가 Plan CR의 상태를 Completed 로 업데이트합니다. 마이그레이션 후 각 소스 VM의 전원 상태가 유지됩니다.

1. 마이그레이션 계획을 실행하기 위해 Migration CR(사용자 정의 리소스)을 생성할 때 Migration Controller 서비스는 각 소스 VM 디스크에 대한 각 소스 가상 머신(VM) 및 DataVolume CR에 대한 VirtualMachine CR을 생성합니다.

   각 VM 디스크에 대해 다음을 수행합니다.

2. CDI(Containerized Data Importer) 컨트롤러 서비스는 DataVolume CR에 지정된 매개변수를 기반으로 PVC(영구 볼륨 클레임)를 생성합니다.


3. StorageClass 에 동적 프로비저너가 있는 경우 PV(영구 볼륨)는 StorageClass 프로비전 프로그램에 의해 동적으로 프로비저닝됩니다.
4. CDI 컨트롤러 서비스는 가져오기 Pod를 생성합니다.

5. 가져오기 Pod는 VM 디스크를 PV로 스트리밍합니다.

   VM 디스크가 전송된 후 다음을 수행합니다.

6. Migration Controller 서비스는 PVC에 연결된 변환 Pod를 생성합니다.

   변환 Pod는 대상 VM의 PVC에 장치 드라이버를 설치하고 구성하는 virt-v2v 를 실행합니다.

7. 대상 VM의 전원이 켜지면 KubeVirt 컨트롤러 서비스는 virt-launcher Pod 및 VirtualMachineInstance CR을 생성합니다.

   virt-launcher Pod는 VM 디스크로 연결된 PVC와 함께 QEMU-KVM 을 실행합니다.

절차

1. 웹 콘솔에서 마이그레이션 계획을 클릭합니다.
2. 마이그레이션 계획 이름 옆에 있는 로그 가져오기 를 클릭합니다.

3. 로그 가져오기 창에서 로그 가져오기 를 클릭합니다.

   로그가 수집됩니다. 로그 수집 완료 메시지가 표시됩니다.

4. 로그 다운로드를 클릭하여 아카이브 파일을 다운로드합니다.
5. 마이그레이션된 VM의 로그를 다운로드하려면 마이그레이션 계획 이름을 클릭한 다음 VM 옆에 있는 로그 가져오기 를 클릭합니다.

절차

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로 저장됩니다. Red Hat 고객 포털에서 해당 지원 사례에 이 파일을 업로드할 수 있습니다.

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

     Plan CR에 표시된 대로 VM ID가 아닌 VM 이름을 지정해야 합니다.