Migration Toolkit for Virtualization のインストールおよび使用

手順

1. Red Hat OpenShift Web コンソールで、Operators → OperatorHub をクリックします。
2. Filter by keyword フィールドを使用して mtv-operator を検索します。
3. Migration Toolkit for Virtualization Operator をクリックしてから Install をクリックします。
4. ボタンがアクティブになったら、Create ForkliftController をクリックします。

5. Create をクリックします。

   ForkliftController が表示されるリストに表示されます。

6. Workloads → Pods をクリックし、MTV Pod が実行されていることを確認します。

7. Operators → Installed Operators をクリックして、Migration Toolkit for Virtualization Operator が Succeeded のステータスで openshift-mtv プロジェクトに表示されることを確認します。

   プラグインの準備が整ったら、ページのリロードが求められます。Migration メニュー項目は、Red Hat OpenShift Web コンソールの左側に表示されるナビゲーションバーに自動的に追加されます。

手順

1. openshift-mtv プロジェクトを作成します。

   Copy to Clipboard Toggle word wrap

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

2. 名前が migration の OperatorGroup CR を作成します。

   Copy to Clipboard Toggle word wrap

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

3. Operator の Subscription CR を作成します。

   Copy to Clipboard Toggle word wrap

   $ cat << EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: mtv-operator
     namespace: openshift-mtv
   spec:
     channel: release-v2.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 Web コンソールで、Migration → Overview をクリックします。Settings リストはページの右側にあります。
2. Settings リストで、変更する設定の Edit アイコンをクリックします。
3. リストから設定を選択します。
4. Save をクリックします。

手順

1. Red Hat OpenShift Web コンソールで、Migration → NetworkMaps for virtualization をクリックします。
2. Create NetworkMap をクリックします。

3. 次のフィールドを指定します。

   • Name: ネットワークマッピングリストに表示する名前を入力します。
   • Source provider: 移行元プロバイダーを選択します。
   • Target provider: 移行先プロバイダーを選択します。
4. Source network および Target namespace/network を選択します。
5. オプション:Add をクリックして追加のネットワークマッピングを作成するか、複数の移行元ネットワークを単一の移行先ネットワークにマッピングします。
6. 追加ネットワークのマッピングを作成する場合は、ネットワークアタッチメント定義を移行先ネットワークとして選択します。

7. Create をクリックします。

   ネットワークマッピングは NetworkMaps 画面に表示されます。

手順

1. Red Hat OpenShift Web コンソールで、Migration → StorageMaps for virtualization をクリックします。
2. Create StorageMap をクリックします。

3. 次のフィールドを指定します。

   • Name: ストレージマッピングリストに表示する名前を入力します。
   • Source provider: 移行元プロバイダーを選択します。
   • Target provider: 移行先プロバイダーを選択します。

4. ストレージマッピングを作成するには、以下のように Add をクリックして、ストレージソースを宛先ストレージクラスにマッピングします。

   1. 移行元プロバイダーが VMware vSphere の場合は、Source datastore および Target storage class を選択します。
   2. 移行元プロバイダーが Red Hat Virtualization の場合は、Source storage domain および Target storage class を選択します。
   3. 移行元プロバイダーが OpenStack の場合は、Source volume type と Target storage class を選択します。
   4. ソースプロバイダーが 1 つ以上の OVA ファイルのセットである場合は、OVA ファイル内のすべての仮想ディスクに適用されるダミーストレージの Source storage class と Target storage class を選択します。
   5. ストレージクラスが OpenShift Virtualization の場合は Source storage class および Target storage class を選択します。
   6. オプション: Add をクリックして、複数のストレージソースを単一のターゲットストレージクラスにマッピングするなど、追加のストレージマッピングを作成します。

5. Create をクリックします。

   マッピングは StorageMaps ページに表示されます。

手順

1. Red Hat OpenShift Web コンソールで、Migration → Plans for virtualization をクリックします。
2. Create Plan をクリックします。

3. 次のフィールドを指定します。

   • Plan name: 移行計画一覧に表示する移行計画名を入力します。
   • Plan description: (オプション) 移行計画の簡単な説明。
   • Source provider: 移行元プロバイダーを選択します。
   • Target provider: 移行先プロバイダーを選択します。

   • Target namespace: 次のいずれかを実行します。

     • リストからターゲット namespace を選択します。
     • テキストボックスに名前を入力し、create "<the_name_you_entered>" をクリックして、ターゲット namespace を作成します。

   • このプランの移行転送ネットワークを変更するには、Select a different network をクリックし、リストからネットワークを選択し、Select をクリックします。

     OpenShift Virtualization プロバイダーの移行転送ネットワークを定義し、ネットワークがターゲット namespace にある場合、定義したネットワークは、すべての移行計画のデフォルトネットワークです。それ以外の場合には、pod ネットワークが使用されます。

4. Next をクリックします。
5. ソース仮想マシンのリストをフィルタリングするオプションを選択し、Next をクリックします。
6. 移行する仮想マシンを選択し、Next をクリックします。
7. 既存のネットワークマッピングを選択するか、新しいネットワークマッピングを作成します。

8. .オプション: Add をクリックして、追加のネットワークマッピングを追加します。

   新規ネットワークマッピングを作成するには、以下を実行します。

   • 各移行元ネットワークに対する移行先ネットワークを選択します。
   • オプション: Save current mapping as a template を選択し、ネットワークマッピングの名前を入力します。
9. Next をクリックします。

10. 変更可能な既存のストレージマッピングを選択するか、新しいストレージマッピングを作成します。

    新規ストレージマッピングを作成するには、以下を実行します。

    1. 移行元プロバイダーが VMware の場合は、Source datastore および Target storage class を選択します。
    2. 移行元プロバイダーが Red Hat Virtualization の場合は、Source storage domain および Target storage class を選択します。
    3. 移行元プロバイダーが OpenStack の場合は、Source volume type と Target storage class を選択します。
11. オプション: Save current mapping as a template を選択し、ストレージマッピングの名前を入力します。
12. Next をクリックします。

13. 移行のタイプを選択し、Next をクリックします。

    • コールド移行: データのコピー中にソース仮想マシンは停止します。

    • ウォーム移行: データが段階的にコピーされる間、ソース仮想マシンは実行します。後でカットオーバーを実行し、仮想マシンを停止し、残りの仮想マシンデータとメタデータをコピーします。

      注記

      ウォーム移行は、vSphere および Red Hat Virtualization でのみサポートされます。

14. Next をクリックします。

15. オプション: 移行フックを作成して、移行前または移行後に Ansible Playbook を実行できます。

    1. Add hook をクリックします。
    2. Step when the hook will be run (移行前または移行後) を選択します。

    3. Hook definition を選択します。

       • Ansible Playbook: Ansible Playbook を参照するか、フィールドに貼り付けます。

       • Custom container image: デフォルトの hook-runner イメージを使用しない場合は、イメージパス <registry_path>/<image_name>:<tag> を入力します。

         注記

         レジストリーは、Red Hat OpenShift クラスターからアクセスできる必要があります。

16. Next をクリックします。

17. 移行計画を確認し、Finish をクリックします。

    移行計画は Plans ページに保存されます。

    移行計画の Options メニュー をクリックし、View details を選択すると、移行計画の詳細を確認できます。

手順

1. Red Hat OpenShift Web コンソールで、Migration → Plans for virtualization をクリックします。

   Plans リストには、移行元プロバイダーとターゲットプロバイダー、移行中の仮想マシン (VM) の数、ステータス、および各プランの説明が表示されます。

2. 移行計画の横にある Start をクリックして移行を開始します。

3. 開いた確認ウィンドウで Start をクリックします。

   Migration details by VM 画面が開いて、移行の進行状況が表示されます。

   ウォーム移行のみ:

   • プレコピー段階が開始します。
   • Cutover クリックして移行を完了します。

4. 移行が失敗した場合:

   1. Get logs をクリックして、移行ログを取得します。
   2. 開いた確認ウィンドウで Get logs をクリックします。
   3. Get logs が Download logs に変わるまで待ってから、ボタンをクリックして、ログをダウンロードします。

5. 移行が失敗したか、成功したか、または進行中かを問わず、移行の ステータス をクリックして、移行の詳細を表示します。

   Migration details by VM 画面が開いて、移行の開始時刻と終了時刻、コピーされたデータの量、および移行中の各仮想マシンの進行状況パイプラインが表示されます。

6. 個別の仮想マシンを拡張して、そのステップと各ステップの経過時間と状態を表示します。

手順

1. Red Hat OpenShift Web コンソールで、Plans for virtualization をクリックします。
2. 実行中の移行計画の名前をクリックし、移行の詳細を表示します。
3. 1 つ以上の仮想マシンを選択し、Cancel をクリックします。

4. Yes, cancel をクリックしてキャンセルを確定します。

   Migration details by VM リストでは、キャンセルした仮想マシンのステータスは Canceled になります。移行されていない仮想マシンと移行された仮想マシンは影響を受けません。

手順

1. プロジェクトのルートを取得します。

   Copy to Clipboard Toggle word wrap

   oc get route -n openshift-mtv

2. Inventory サービスルートを取得します。

   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. 移行元プロバイダーの認証情報の Secret マニフェストを作成します。

   Copy to Clipboard Toggle word wrap

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

   1

   
       - apiVersion: forklift.konveyor.io/v1beta1
         kind: Provider
         name: <provider_name>
         uid: <provider_uid>
     labels:
       createdForProviderType: <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 証明書を入力します。Manager CA 証明書は、https://<engine_host>/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA で取得できます。OpenStack の場合は、ソース環境に接続するための CA 証明書を入力します。insecureSkipVerify が <true> に設定されている場合、証明書は使用されません。

   11

   API エンドポイント URL を指定します。たとえば、vSphere の場合は https://<vCenter_host>/sdk、RHV の場合は https://<engine_host>/ovirt-engine/api、OpenStack の場合は https://<identity_service>/v3 です。

   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 またはホスト名。
   nfs_path: OVA ファイルが保存されているサーバー上のパス。

2. 移行元プロバイダーの Provider マニフェストを作成します。

   Copy to Clipboard Toggle word wrap

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Provider
   metadata:
     name: <source_provider>
     namespace: <namespace>
   spec:
     type: <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>/v3 です。

   3

   VMware のみ: 作成した VDDK イメージを指定します。

   4

   プロバイダー Secret CR の名前を指定します。

3. VMware のみ: Host マニフェストを作成します。

   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 ホストのマネージドオブジェクト参照 (MOR) を指定します。moRef を取得するには、Retrieving a 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 ネットワーク MOR、RHV ネットワーク UUID、または OpenStack ネットワーク UUID を指定します。moRef を取得するには、Retrieving a VMware vSphere moRef を参照してください。

   4

   追加の OpenShift Virtualization ネットワークごとにネットワークアタッチメント定義を指定します。

   5

   type が multus の場合に限り必要です。OpenShift Virtualization のネットワークアタッチメント定義の namespace を指定します。

   6

   追加の OpenShift Virtualization ネットワークごとにネットワークアタッチメント定義を指定します。

   7

   type が multus の場合に限り必要です。ここで、namespace は、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 データストア moRef、RHV ストレージドメイン UUID、または OpenStack volume_type UUID を指定します。たとえば、f2737930-b567-451a-9ceb-2887f6207009 です。moRef を取得するには、Retrieving a VMware vSphere moRef を参照してください。

   注記

   OVA の場合、StorageMap は、OVA のすべてのディスクが関連付けられている単一のストレージのみを移行先のストレージクラスにマップできます。このため、ストレージは UI では "Dummy storage for source provider <provider_name>" と呼ばれます。

6. オプション: Hook マニフェストを作成し、Plan CR で指定されたフェーズ中に仮想マシンでカスタムコードを実行します。

   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 イメージを使用するか、カスタムイメージを指定することができます。カスタムイメージを指定する場合は、Playbook を指定する必要はありません。

   2

   オプション: base64 でエンコードされた Ansible Playbook。Playbook を指定する場合は、image が hook-runner である必要があります。

7. 移行の Plan マニフェストを作成します。

   Copy to Clipboard Toggle word wrap

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

   1

   
     namespace: <namespace>
   spec:
     warm: 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

   移行がウォームまたはコールドであるかどうかを指定します。Migration マニフェストで cutover パラメーターの値を指定せずにウォーム移行を指定すると、プレコピーステージのみが実行します。

   3

   プランごとにネットワークマップとストレージマップを 1 つだけ指定します。

   4

   移行する仮想マシンがネットワークに割り当てられていない場合でも、ネットワークマッピングを指定します。この場合、マッピングは空にできます。

   5

   NetworkMap CR の名前を指定します。

   6

   移行する仮想マシンにディスクイメージが割り当てられていない場合でも、ストレージマッピングを指定します。この場合、マッピングは空にできます。

   7

   StorageMap CR の名前を指定します。

   8

   OpenShift Virtualization を除くすべてのソースプロバイダーでは、id パラメーター または name パラメーターを使用してソース VM を指定できます。
   OpenShift Virtualization 移行元プロバイダーのみ: 移行元仮想マシンを指定するには、id. パラメーターではなく name パラメーターのみが使用できます。

   9

   VMware VM MOR、RHV VM UUID、または OpenStack VM UUID を指定します。moRef を取得するには、Retrieving a VMware vSphere moRef を参照してください。

   10

   OpenShift Virtualization 移行元プロバイダーのみ。

   11

   オプション: 仮想マシンのフックを最大 2 つ指定できます。各フックは個別の移行ステップで実行する必要があります。

   12

   Hook CR の名前を指定します。

   13

   使用できる値は、移行計画が開始される前の PreHook、または移行が完了した後の PostHook です。

8. Plan CR を実行するための Migration マニフェストを作成します。

   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

   オプション: 2021-04-04T01:23:45.678+09:00 などの UTC 時間オフセットで、ISO 8601 形式に応じたカットオーバー時間を指定します。

   複数の Migration CR を単一の Plan CR に関連付けることができます。移行が完了しない場合は、Plan CR を変更せずに新規 Migration CR を作成して残りの仮想マシンを移行できます。

9. 移行の進捗をモニタリングするための Migration CR を取得します。

   Copy to Clipboard Toggle word wrap

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

個別の仮想マシンの移行のキャンセル

1. Migration マニフェストの spec.cancel ブロックに個別の仮想マシンを追加します。

   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 キーを使用して仮想マシンを指定できます。

   id キーの値は、VMware 仮想マシンの場合は Managed Object Reference、RHV 仮想マシンの場合は VM UUID です。

2. 残りの仮想マシンの進捗をモニタリングするための Migration CR を取得します。

   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. Inventory サービスルートを取得します。

   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. プロバイダーの仮想マシンを取得します。

   Copy to Clipboard Toggle word wrap

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

7. 仮想マシンの詳細を取得します。

   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. Home → Projects をクリックします。
2. openshift-mtv プロジェクトを作成します。
3. プロジェクトの右側の Options メニュー から Delete Project を選択します。
4. Delete Project ペインで、プロジェクト名を入力し、Delete をクリックします。
5. Administration → CustomResourceDefinitions をクリックします。
6. 検索 フィールドに forklift を入力し、forklift.konveyor.io グループで CRD を見つけます。
7. 各 CRD の右側で、Options メニュー から 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 に表示される仮想マシンの ID を指定します。