Migration Toolkit for Virtualization 설치 및 사용

프로세스

1. Red Hat OpenShift 웹 콘솔에서 Operator → OperatorHub 를 클릭합니다.
2. 키워드로 필터링 필드를 사용하여 mtv-operator 를 검색합니다.
3. Migration Toolkit for Virtualization Operator 를 클릭한 다음 설치를 클릭합니다.
4. 버튼이 활성화되면 ForkliftController 생성 을 클릭합니다.

5. 생성을 클릭합니다.

   표시된 목록에 ForkliftController가 표시됩니다.

6. 워크로드 → 포드를 클릭하여 MTV Pod 가 실행 중인지 확인합니다.

7. Operators → 설치된 Operator 를 클릭하여 Migration Toolkit for Virtualization Operator 가 Succeeded 상태로 openshift-mtv 프로젝트에 표시되는지 확인합니다.

   플러그인이 준비되면 페이지를 다시 로드하라는 메시지가 표시됩니다. 마이그레이션 메뉴 항목은 Red Hat OpenShift 웹 콘솔 왼쪽에 표시되는 탐색 모음에 자동으로 추가됩니다.

프로세스

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에 대한 서브스크립션 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.5
     installPlanApproval: Automatic
     name: mtv-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     startingCSV: "mtv-operator.v2.5.7"
   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 웹 콘솔에서 마이그레이션 → 개요 를 클릭합니다. 설정 목록은 페이지 오른쪽에 있습니다.
2. 설정 목록에서 변경할 설정의 편집 아이콘을 클릭합니다.
3. 목록에서 설정을 선택합니다.
4. 저장을 클릭합니다.

프로세스

1. Red Hat OpenShift 웹 콘솔에서 가상화를 위한 마이그레이션 → NetworkMaps를 클릭합니다.
2. NetworkMap 만들기를 클릭합니다.

3. 다음 필드를 지정합니다.

   • name: 네트워크 매핑 목록에 표시할 이름을 입력합니다.
   • 소스 공급자: 소스 공급자를 선택합니다.
   • 대상 공급자: 대상 공급자를 선택합니다.
4. 소스 네트워크와 대상 네임스페이스/네트워크 를 선택합니다.
5. 선택 사항: 추가 네트워크 매핑을 생성하거나 여러 소스 네트워크를 단일 대상 네트워크에 매핑하려면 추가를 클릭합니다.
6. 추가 네트워크 매핑을 생성하는 경우 대상 네트워크로 네트워크 연결 정의를 선택합니다.

7. 생성을 클릭합니다.

   네트워크 매핑이 NetworkMaps 화면에 표시됩니다.

프로세스

1. Red Hat OpenShift 웹 콘솔에서 가상화를 위한 마이그레이션 → 스토리지 맵을 클릭합니다.
2. 스토리지 맵 생성을 클릭합니다.

3. 다음 필드를 지정합니다.

   • name: 스토리지 매핑 목록에 표시할 이름을 입력합니다.
   • 소스 공급자: 소스 공급자를 선택합니다.
   • 대상 공급자: 대상 공급자를 선택합니다.

4. 스토리지 매핑을 생성하려면 스토리지 소스 추가 를 클릭하고 다음과 같이 대상 스토리지 클래스에 매핑합니다.

   1. 소스 공급자가 VMware vSphere인 경우 소스 데이터 저장소와 대상 스토리지 클래스 를 선택합니다.
   2. 소스 공급자가 Red Hat Virtualization인 경우 소스 스토리지 도메인과 대상 스토리지 클래스 를 선택합니다.
   3. 소스 공급자가 OpenStack인 경우 소스 볼륨 유형 과 대상 스토리지 클래스 를 선택합니다.
   4. 소스 공급자가 하나 이상의 OVA 파일 세트인 경우 OVA 파일 내의 모든 가상 디스크에 적용되는 더미 스토리지의 Source 및 Target 스토리지 클래스 를 선택합니다.
   5. 스토리지 공급자가 OpenShift Virtualization인 경우 소스 스토리지 클래스와 대상 스토리지 클래스 를 선택합니다.
   6. 선택 사항: 여러 스토리지 소스를 단일 대상 스토리지 클래스에 매핑하는 등 추가 스토리지 매핑을 생성하려면 추가를 클릭합니다.

5. 생성을 클릭합니다.

   매핑은 StorageMaps 페이지에 표시됩니다.

프로세스

1. Red Hat OpenShift 웹 콘솔에서 마이그레이션 → 가상화 계획을 클릭합니다.
2. 계획 생성을 클릭합니다.

3. 다음 필드를 지정합니다.

   • 계획 이름: 마이그레이션 계획 목록에 표시할 마이그레이션 계획 이름을 입력합니다.
   • 계획 설명: 선택 사항: 마이그레이션 계획에 대한 간략한 설명입니다.
   • 소스 공급자: 소스 공급자를 선택합니다.
   • 대상 공급자: 대상 공급자를 선택합니다.

   • 대상 네임스페이스: 다음 중 하나를 수행합니다.

     • 목록에서 대상 네임스페이스 선택
     • 텍스트 상자에 이름을 입력하여 대상 네임스페이스를 만든 다음 만들기 "<the_name_you_entered>"를 클릭합니다.

   • Select a different network 를 클릭하고 목록에서 네트워크를 선택한 다음 Select 를 클릭하여 이 계획에 대한 마이그레이션 전송 네트워크를 변경할 수 있습니다.

     OpenShift Virtualization 공급자의 마이그레이션 전송 네트워크를 정의하고 네트워크가 대상 네임스페이스에 있는 경우 정의한 네트워크가 모든 마이그레이션 계획의 기본 네트워크입니다. 그렇지 않으면 Pod 네트워크가 사용됩니다.

4. 다음을 클릭합니다.
5. 소스 VM 목록을 필터링하는 옵션을 선택하고 다음을 클릭합니다.
6. 마이그레이션할 VM을 선택한 다음 다음을 클릭합니다.
7. 기존 네트워크 매핑을 선택하거나 새 네트워크 매핑을 생성합니다.

8. . 선택 사항: 추가 를 클릭하여 추가 네트워크 매핑을 추가합니다.

   새 네트워크 매핑을 생성하려면 다음을 수행합니다.

   • 각 소스 네트워크의 대상 네트워크를 선택합니다.
   • 선택 사항: 현재 매핑을 템플릿으로 저장하고 네트워크 매핑의 이름을 입력합니다.
9. 다음을 클릭합니다.

10. 기존 스토리지 매핑을 선택하거나 새 스토리지 매핑을 생성할 수 있습니다.

    새 스토리지 매핑을 생성하려면 다음을 수행합니다.

    1. 소스 공급자가 VMware인 경우 소스 데이터 저장소와 대상 스토리지 클래스 를 선택합니다.
    2. 소스 공급자가 Red Hat Virtualization인 경우 소스 스토리지 도메인과 대상 스토리지 클래스 를 선택합니다.
    3. 소스 공급자가 OpenStack인 경우 소스 볼륨 유형 과 대상 스토리지 클래스 를 선택합니다.
11. 선택 사항: 현재 매핑을 템플릿으로 저장하고 스토리지 매핑의 이름을 입력합니다.
12. 다음을 클릭합니다.

13. 마이그레이션 유형을 선택하고 다음을 클릭합니다.

    • 콜드 마이그레이션: 데이터가 복사되는 동안 소스 VM이 중지됩니다.

    • 웜 마이그레이션: 데이터가 증분적으로 복사되는 동안 소스 VM이 실행됩니다. 나중에 컷오버를 실행하여 VM을 중지하고 나머지 VM 데이터 및 메타데이터를 복사합니다.

      참고

      웜 마이그레이션은 vSphere 및 Red Hat Virtualization에서만 지원됩니다.

14. 다음을 클릭합니다.

15. 선택 사항: 마이그레이션 전후에 Ansible 플레이북을 실행하기 위해 마이그레이션 후크를 생성할 수 있습니다.

    1. 후크 추가를 클릭합니다.
    2. 후크를 실행할 단계: 사전 마이그레이션 또는 마이그레이션 후를 선택합니다.

    3. 후크 정의를 선택합니다.

       • Ansible Playbook: Ansible 플레이북 검색 또는 필드에 붙여넣습니다.

       • 사용자 정의 컨테이너 이미지 : 기본 hook-runner 이미지를 사용하지 않으려면 이미지 경로 < registry_path>/<image_name>:<tag >를 입력합니다.

         참고

         Red Hat OpenShift 클러스터에서 레지스트리에 액세스할 수 있어야 합니다.

16. 다음을 클릭합니다.

17. 마이그레이션 계획을 검토하고 마침 을 클릭합니다.

    마이그레이션 계획이 계획 페이지에 저장됩니다.

    마이그레이션 계획의 옵션 메뉴 를 클릭하고 세부 정보 보기를 선택하여 마이그레이션 계획 세부 정보를 확인할 수 있습니다.

프로세스

1. Red Hat OpenShift 웹 콘솔에서 마이그레이션 → 가상화 계획을 클릭합니다.

   계획 목록에는 소스 및 대상 공급자, 마이그레이션 중인 VM(가상 머신) 수, 상태 및 각 계획에 대한 설명이 표시됩니다.

2. 마이그레이션 계획 옆에 있는 시작을 클릭하여 마이그레이션을 시작합니다.

3. 열리는 확인 창에서 시작을 클릭합니다.

   VM 화면별 마이그레이션 세부 정보가 열리고 마이그레이션 진행 상황을 표시합니다.

   웜 마이그레이션만 해당:

   • 사전 복사 단계가 시작됩니다.
   • 컷오버 를 클릭하여 마이그레이션을 완료합니다.

4. 마이그레이션이 실패하는 경우:

   1. 로그 가져오기를 클릭하여 마이그레이션 로그를 검색합니다.
   2. 열리는 확인 창에서 로그 가져오기를 클릭합니다.
   3. 로그 가져오기가 로그 다운로드 로 변경될 때까지 기다린 다음 버튼을 클릭하여 로그를 다운로드합니다.

5. 마이그레이션 실패 여부에 관계없이 마이그레이션의 상태를 클릭하여 마이그레이션 세부 정보를 확인합니다.

   VM 화면별 마이그레이션 세부 정보가 열리고 마이그레이션 시작 및 종료 시간, 복사된 데이터 양, 마이그레이션 중인 각 VM의 진행률 파이프라인이 표시됩니다.

6. 개별 VM을 확장하여 해당 단계 및 각 단계의 경과된 시간 및 상태를 확인합니다.

프로세스

1. Red Hat OpenShift 웹 콘솔에서 가상화 계획을 클릭합니다.
2. 실행 중인 마이그레이션 계획의 이름을 클릭하여 마이그레이션 세부 정보를 확인합니다.
3. 하나 이상의 VM을 선택하고 취소 를 클릭합니다.

4. 예, 취소 를 클릭하여 취소를 확인합니다.

   VM별 마이그레이션 세부 정보 목록에서 취소된 VM의 상태가 취소됩니다. 마이그레이션되지 않은 가상 머신 및 마이그레이션된 가상 머신은 영향을 받지 않습니다.

프로세스

1. 프로젝트의 경로를 검색합니다.

   Copy to Clipboard Toggle word wrap

   oc get route -n openshift-mtv

2. 인벤토리 서비스 경로를 검색합니다.

   Copy to Clipboard Toggle word wrap

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

3. 액세스 토큰을 검색합니다.

   Copy to Clipboard Toggle word wrap

   $ TOKEN=$(oc whoami -t)

4. VMware vSphere 공급자의 moRef를 검색합니다.

   Copy to Clipboard Toggle word wrap

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

5. VMware vSphere 소스 공급자의 데이터 저장소를 검색합니다.

   Copy to Clipboard Toggle word wrap

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

   출력 예

   Copy to Clipboard Toggle word wrap

   [
     {
       "id": "datastore-11",
       "parent": {
         "kind": "Folder",
         "id": "group-s5"
       },
       "path": "/Datacenter/datastore/v2v_general_porpuse_ISCSI_DC",
       "revision": 46,
       "name": "v2v_general_porpuse_ISCSI_DC",
       "selfLink": "providers/vsphere/01278af6-e1e4-4799-b01b-d5ccc8dd0201/datastores/datastore-11"
     },
     {
       "id": "datastore-730",
       "parent": {
         "kind": "Folder",
         "id": "group-s5"
       },
       "path": "/Datacenter/datastore/f01-h27-640-SSD_2",
       "revision": 46,
       "name": "f01-h27-640-SSD_2",
       "selfLink": "providers/vsphere/01278af6-e1e4-4799-b01b-d5ccc8dd0201/datastores/datastore-730"
     },
    ...

프로세스

1. 소스 공급자 인증 정보에 대한 시크릿 매니페스트를 생성합니다.

   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: <provider_type> 

   2

   
       createdForResourceType: providers
   type: Opaque
   stringData: 

   3

   
     user: <user> 

   4

   
     password: <password> 

   5

   
     insecureSkipVerify: <true/false> 

   6

   
     domainName: <domain_name> 

   7

   
     projectName: <project_name> 

   8

   
     regionName: <region name> 

   9

   
     cacert: | 

   10

   
       <ca_certificate>
     url: <api_end_point> 

   11

   
     thumbprint: <vcenter_fingerprint> 

   12

   
     token: <service_account_bearer_token> 

   13

   
   EOF

   1

   ownerReferences 섹션은 선택 사항입니다.

   2

   소스 공급자 유형을 지정합니다. 허용되는 값은 ovirt,vsphere,openstack,ova, openshift 입니다. 이 레이블은 원격 시스템에 액세스할 수 있을 때 인증 정보가 올바른지 확인하고 타사 인증서가 지정되면 RHV의 경우 Manager CA 인증서를 검색하는 데 필요합니다.

   3

   OVA의 stringData 섹션은 다르며 Secret 매니페스트에 대한 설명에 설명되어 있습니다.

   4

   vCenter 사용자, RHV Manager 사용자 또는 OpenStack 사용자를 지정합니다.

   5

   사용자 암호를 지정합니다.

   6

   비보안 마이그레이션을 진행하는 인증서 확인을 건너뛰려면 < true >를 지정한 다음 인증서가 필요하지 않습니다. 비보안 마이그레이션은 전송된 데이터가 안전하지 않은 연결을 통해 전송되고 잠재적으로 민감한 데이터가 노출될 수 있음을 의미합니다. < false> 를 지정하면 인증서가 확인됩니다.

   7

   OpenStack만 해당: 도메인 이름을 지정합니다.

   8

   OpenStack만 해당: 프로젝트 이름을 지정합니다.

   9

   OpenStack만 해당: OpenStack 리전의 이름을 지정합니다.

   10

   RHV 및 OpenStack만 해당: RHV의 경우 타사 인증서로 대체되지 않는 한 Manager CA 인증서를 입력합니다. 이 경우 Manager Apache CA 인증서를 입력합니다. https://<engine_host>/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA에서 Manager CA 인증서를 검색할 수 있습니다. OpenStack의 경우 소스 환경에 연결하기 위해 CA 인증서를 입력합니다. insecureSkipVerify 가 < true>로 설정된 경우 인증서가 사용되지 않습니다.

   11

   API 엔드포인트 URL을 지정합니다(예: vSphere의 경우 https://<vCenter_host>/sdk, RHV의 경우 https://<engine_host>/ovirt-engine/api 또는 OpenStack의 경우 https://<identity_service>/v 3).

   12

   VMware만 해당: vCenter SHA-1 지문을 지정합니다.

   13

   OpenShift만 해당: cluster-admin 권한이 있는 서비스 계정의 토큰입니다.

   참고

   OVA Secret 매니페스트의 stringData 섹션은 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

   stringData:
     url: <nfs_server:/nfs_path>

   여기서:
   nfs_server: 공유가 생성된 서버의 IP 또는 호스트 이름
   OVA 파일이 저장된 서버의 경로입니다.

2. 소스 공급자에 대한 공급자 매니페스트를 생성합니다.

   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: <provider_type> 

   1

   
     url: <api_end_point> 

   2

   
     settings:
       vddkInitImage: <registry_route_or_server_path>/vddk:<tag> 

   3

   
     secret:
       name: <secret> 

   4

   
       namespace: <namespace>
   EOF

   1

   소스 공급자 유형을 지정합니다. 허용되는 값은 ovirt,vsphere,openstack,ova, openshift 입니다.

   2

   API 엔드포인트 URL을 지정합니다(예: vSphere의 경우 https://<vCenter_host>/sdk, RHV의 경우 https://<engine_host>/ovirt-engine/api 또는 OpenStack의 경우 https://<identity_service>/v 3).

   3

   VMware만 해당: 생성한 VDDK 이미지를 지정합니다.

   4

   공급자 Secret CR의 이름을 지정합니다.

3. VMware만 해당: 호스트 매니페스트를 생성합니다.

   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 Provider CR의 이름을 지정합니다.

   2

   VMware 호스트의 관리형 오브젝트 참조(moRef)를 지정합니다. moRef를 검색하려면 VMware vSphere moRef 검색을 참조하십시오.

   3

   VMware 마이그레이션 네트워크의 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> 

   3

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

   4

   
           namespace: <network_attachment_definition_namespace> 

   5

   
           type: multus
         source:
           name: <network_attachment_definition> 

   6

   
           namespace: <network_attachment_definition_namespace> 

   7

   
           type: multus 

   8

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

   1

   허용되는 값은 pod 및 multus 입니다.

   2

   id 또는 name 매개변수를 사용하여 소스 네트워크를 지정할 수 있습니다.

   3

   VMware 네트워크 moRef, RHV 네트워크 UUID 또는 OpenStack 네트워크 UUID를 지정합니다. moRef를 검색하려면 VMware vSphere moRef 검색을 참조하십시오.

   4

   각 추가 OpenShift Virtualization 네트워크에 대한 네트워크 연결 정의를 지정합니다.

   5

   type 이 multus 인 경우에만 필요합니다. OpenShift Virtualization 네트워크 연결 정의의 네임스페이스를 지정합니다.

   6

   각 추가 OpenShift Virtualization 네트워크에 대한 네트워크 연결 정의를 지정합니다.

   7

   type 이 multus 인 경우에만 필요합니다. 여기에서 namespace 속성은 네임스페이스 속성을 사용하거나 다음과 같이 빌드된 이름으로 지정할 수 있습니다. < network_namespace>/<network_name > .

   8

   OpenShift만 해당.

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

   
       - destination:
           storageClass: <storage_class>
           accessMode: <access_mode>
         source:
           id: <source_datastore>
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   1

   허용되는 값은 ReadWriteOnce 및 ReadWriteMany 입니다.

   2

   VMware datastore moRef, RHV 스토리지 도메인 UUID 또는 OpenStack volume_type UUID를 지정합니다. 예를 들면 f2737930-b567-451a-9ceb-2887f6207009 입니다. moRef를 검색하려면 VMware vSphere moRef 검색을 참조하십시오.

   참고

   OVA의 경우 StorageMap 은 OVA의 모든 디스크가 연결된 단일 스토리지만 대상의 스토리지 클래스에 매핑할 수 있습니다. 이러한 이유로 UI에서 "Dummy storage for source provider <provider_name>"이라고 합니다.

6. 선택 사항: Plan CR에 지정된 단계에서 VM에서 사용자 정의 코드를 실행하려면 후크 매니페스트를 생성합니다.

   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/konveyor/hook-runner 

   1

   
     playbook: | 

   2

   
       LS0tCi0gbmFtZTogTWFpbgogIGhvc3RzOiBsb2NhbGhvc3QKICB0YXNrczoKICAtIG5hbWU6IExv
       YWQgUGxhbgogICAgaW5jbHVkZV92YXJzOgogICAgICBmaWxlOiAiL3RtcC9ob29rL3BsYW4ueW1s
       IgogICAgICBuYW1lOiBwbGFuCiAgLSBuYW1lOiBMb2FkIFdvcmtsb2FkCiAgICBpbmNsdWRlX3Zh
       cnM6CiAgICAgIGZpbGU6ICIvdG1wL2hvb2svd29ya2xvYWQueW1sIgogICAgICBuYW1lOiB3b3Jr
       bG9hZAoK
   EOF

   1

   기본 hook-runner 이미지를 사용하거나 사용자 정의 이미지를 지정할 수 있습니다. 사용자 지정 이미지를 지정하는 경우 플레이북을 지정할 필요가 없습니다.

   2

   선택 사항: base64로 인코딩된 Ansible Playbook. 플레이북을 지정하는 경우 이미지는 hook-runner 여야 합니다.

7. 마이그레이션을 위한 계획 매니페스트를 생성합니다.

   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: true 

   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>
     targetNamespace: <target_namespace>
     vms: 

   8

   
       - id: <source_vm> 

   9

   
       - name: <source_vm>
         namespace: <namespace> 

   10

   
         hooks: 

   11

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

   12

   
             step: <step> 

   13

   
   EOF

   1

   Plan CR의 이름을 지정합니다.

   2

   마이그레이션이 워밍인지 또는 콜드인지를 지정합니다. 마이그레이션 매니페스트에서 cutover 매개변수 값을 지정하지 않고 웜 마이그레이션 을 지정하면 사전 복사 단계만 실행됩니다.

   3

   계획당 하나의 네트워크 맵과 하나의 스토리지 맵만 지정합니다.

   4

   마이그레이션할 VM이 네트워크에 할당되지 않은 경우에도 네트워크 매핑을 지정합니다. 이 경우 매핑이 비어 있을 수 있습니다.

   5

   NetworkMap CR의 이름을 지정합니다.

   6

   마이그레이션할 VM이 디스크 이미지로 할당되지 않은 경우에도 스토리지 매핑을 지정합니다. 이 경우 매핑이 비어 있을 수 있습니다.

   7

   StorageMap CR의 이름을 지정합니다.

   8

   OpenShift Virtualization을 제외한 모든 소스 공급자의 경우 id 또는 name 매개변수를 사용하여 소스 VM을 지정할 수 있습니다.
   OpenShift Virtualization 소스 공급자만 해당: id. 매개변수가 아닌 name 매개변수만 사용하여 소스 VM을 지정할 수 있습니다.

   9

   VMware VM moRef, RHV VM UUID 또는 OpenStack VM UUID를 지정합니다. moRef를 검색하려면 VMware vSphere moRef 검색을 참조하십시오.

   10

   OpenShift Virtualization 소스 공급자만 사용할 수 있습니다.

   11

   선택 사항: VM에 대해 최대 두 개의 후크를 지정할 수 있습니다. 각 후크는 별도의 마이그레이션 단계에서 실행되어야 합니다.

   12

   Hook CR의 이름을 지정합니다.

   13

   허용되는 값은 마이그레이션 계획이 시작되기 전에 PreHook 이거나 마이그레이션이 완료된 후 postHook 입니다.

8. Plan CR을 실행할 마이그레이션 매니페스트를 생성합니다.

   Copy to Clipboard Toggle word wrap

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

   1

   
     namespace: <namespace>
   spec:
     plan:
       name: <plan> 

   2

   
       namespace: <namespace>
     cutover: <cutover_time> 

   3

   
   EOF

   1

   Migration CR의 이름을 지정합니다.

   2

   실행 중인 Plan CR의 이름을 지정합니다. Migration CR은 마이그레이션되는 각 VM에 대해 VirtualMachine CR을 생성합니다.

   3

   선택 사항: UTC 시간 오프셋을 사용하여 ISO 8601 형식에 따라 컷오버 시간을 지정합니다(예: 2021-04-04T01:23:45.678+09:00 ).

   여러 마이그레이션 CR을 단일 계획 CR과 연결할 수 있습니다. 마이그레이션이 완료되지 않으면 Plan CR을 변경하지 않고 새 마이그레이션 CR을 생성하여 나머지 VM을 마이그레이션할 수 있습니다.

9. Migration CR을 검색하여 마이그레이션 진행 상황을 모니터링합니다.

   Copy to Clipboard Toggle word wrap

   $ oc get migration/<migration> -n <namespace> -o yaml

개별 VM 마이그레이션 취소

1. 마이그레이션 매니페스트의 spec.cancel 블록에 개별 VM을 추가합니다.

   Copy to Clipboard Toggle word wrap

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Migration
   metadata:
     name: <migration>
     namespace: <namespace>
   ...
   spec:
     cancel:
     - id: vm-102 

   1

   
     - id: vm-203
     - name: rhel8-vm
   EOF

   1

   id 키 또는 name 키를 사용하여 VM을 지정할 수 있습니다.

   id 키의 값은 RHV VM의 관리 오브젝트 참조, VMware VM 또는 VM UUID 입니다.

2. Migration CR을 검색하여 나머지 VM의 진행 상황을 모니터링합니다.

   Copy to Clipboard Toggle word wrap

   $ oc get migration/<migration> -n <namespace> -o yaml

프로세스

1. 프로젝트의 경로를 검색합니다.

   Copy to Clipboard Toggle word wrap

   oc get route -n openshift-mtv

2. 인벤토리 서비스 경로를 검색합니다.

   Copy to Clipboard Toggle word wrap

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

3. 액세스 토큰을 검색합니다.

   Copy to Clipboard Toggle word wrap

   $ TOKEN=$(oc whoami -t)

4. HTTP GET 요청을 트리거합니다(예: Curl 사용).

   Copy to Clipboard Toggle word wrap

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

5. 공급자의 UUID 를 검색합니다.

   Copy to Clipboard Toggle word wrap

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

   1

   1 1 1

   공급자에 허용되는 값은 vsphere,ovirt, openstack 입니다.

6. 공급자의 VM을 검색합니다.

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   출력 예

   Copy to Clipboard Toggle word wrap

   {
       "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. 홈 → 프로젝트를 클릭합니다.
2. openshift-mtv 프로젝트를 찾습니다.
3. 프로젝트 오른쪽에 있는 옵션 메뉴 에서 프로젝트 삭제 를 선택합니다.
4. 프로젝트 삭제 창에서 프로젝트 이름을 입력하고 삭제 를 클릭합니다.
5. Administration → CustomResourceDefinitions 를 클릭합니다.
6. 검색 필드에 포크리를 입력하여 forklift.konveyor.io 그룹에서 CRD를 찾습니다.
7. 각 CRD 오른쪽에 있는 옵션 메뉴 에서 Delete CustomResourceDefinition 을 선택합니다.

프로세스

1. 프로젝트를 삭제합니다.

   Copy to Clipboard Toggle word wrap

   $ oc delete project openshift-mtv

2. CRD를 삭제합니다.

   Copy to Clipboard Toggle word wrap

   $ oc get crd -o name | grep 'forklift' | xargs oc delete

3. OAuthClient를 삭제합니다.

   Copy to Clipboard Toggle word wrap

   $ oc delete oauthclient/forklift-ui

로그 및 CR 정보 수집

1. must-gather 데이터를 저장하려는 디렉터리로 이동합니다.

2. oc adm must-gather 명령을 실행합니다.

   Copy to Clipboard Toggle word wrap

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

   데이터는 /must-gather/must-gather.tar.gz로 저장됩니다. Red Hat 고객 포털에서 해당 지원 사례에 이 파일을 업로드할 수 있습니다.

3. 선택 사항: oc adm must-gather 명령을 다음 옵션과 함께 실행하여 필터링된 데이터를 수집합니다.

   • namespace:

     Copy to Clipboard Toggle word wrap

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

   • 마이그레이션 계획:

     Copy to Clipboard Toggle word wrap

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

   • 가상 머신:

     Copy to Clipboard Toggle word wrap

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

     1

     1

     Plan CR에 표시되는 대로 VM ID 를 지정합니다.