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

手順

1. OpenShift Container Platform Web コンソールで、Operators → OperatorHub の順にクリックします。
2. Filter by keyword フィールドを使用して mtv-operator を検索します。
3. MTV Operator をクリックしてから、Install をクリックします。
4. Install Operator ページで、Install をクリックします。
5. Operators → Installed Operators の順にクリックし、MTV Operator が Succeeded のステータスで openshift-mtv プロジェクトに表示されることを確認します。
6. MTV Operator をクリックします。
7. Provided APIs で ForkliftController を見つけ、Create Instance をクリックします。
8. 作成 をクリックします。
9. Workloads → Pods の順にクリックし、MTV Pod が実行されていることを確認します。

手順

1. OpenShift Container Platform Web コンソールにログインします。
2. Networking → Routes の順にクリックします。
3. Project: 一覧で openshift-mtv プロジェクトを選択します。
4. forklift-ui サービスの URL をクリックして、MTV Web コンソールのログインページを開きます。

手順

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

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

2. migration という OperatorGroup CR を作成します。

   $ 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 を作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: mtv-operator
     namespace: openshift-mtv
   spec:
     channel: release-v2.1.0
     installPlanApproval: Automatic
     name: mtv-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     startingCSV: "mtv-operator.2.1.0"
   EOF

4. ForkliftController CR を作成します。

   $ 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 が実行中であることを検証します。

   $ oc get pods -n openshift-mtv

   出力例

   NAME                                  READY  STATUS   RESTARTS  AGE
   forklift-controller-788bdb4c69-mw268  2/2    Running  0         2m
   forklift-operator-6bf45b8d8-qps9v     1/1    Running  0         5m
   forklift-ui-7cdf96d8f6-xnw5n          1/1    Running  0         2m

手順

1. MTV Web コンソール URL を取得します。

   $ oc get route virt -n openshift-mtv \
     -o custom-columns=:.spec.host

   出力例

   https://virt-openshift-mtv.apps.cluster.openshift.com.

2. ブラウザーを起動し、MTV Web コンソールに移動します。

手順

1. Mappings をクリックします。
2. Network タブをクリックしてから、Create mapping をクリックします。

3. 以下のフィールドに入力します。

   • Name: ネットワークマッピング一覧に表示する名前を入力します。
   • Source provider: ソースプロバイダーを選択します。
   • Target provider: ターゲットプロバイダーを選択します。
   • Source networks: ソースネットワークを選択します。
   • ターゲット namespaces/ネットワーク: ターゲットネットワークを選択します。
4. オプション: Add をクリックして追加のネットワークマッピングを作成するか、複数のソースネットワークを単一のターゲットネットワークにマッピングします。
5. 追加ネットワークのマッピングを作成する場合は、ネットワーク接続定義をターゲットネットワークとして選択します。

6. 作成 をクリックします。

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

手順

1. Mappings をクリックします。
2. Storage タブをクリックし、Create mapping をクリックします。
3. ストレージマッピングの Name を入力します。
4. Source provider および Target provider を選択します。
5. ソースプロバイダーが VMware の場合は、Source datastore および Target storage class を選択します。
6. ソースプロバイダーが Red Hat Virtualization の場合は、Source storage domain および Target storage class を選択します。
7. オプション: Add をクリックして追加のストレージマッピングを作成するか、複数のデータストアまたはストレージドメインを単一のストレージクラスにマッピングします。

8. 作成 をクリックします。

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

手順

1. Web コンソールで、Migration plans をクリックしてから Create migration plan を クリックします。

2. 以下のフィールドに入力します。

   • Plan name: 移行計画一覧に表示する移行計画名を入力します。
   • Plan description: オプション: 移行計画の簡単な説明。
   • Source provider: ソースプロバイダーを選択します。
   • Target provider: ターゲットプロバイダーを選択します。
   • ターゲット namespace: 既存のターゲット namespace 入力して検索するか、新しい namespace を作成することができます。

   • Select a different network をクリックして、一覧からネットワークを選択し、Select をクリックして、この計画の移行転送ネットワークを変更できます。

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

3. Next をクリックします。
4. ソース仮想マシンのリストをフィルタリングするオプションを選択し、Next をクリックします。
5. 移行する仮想マシンを選択し、次へ をクリックします。

6. 既存のネットワークマッピングを選択するか、新しいネットワークマッピングを作成します。

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

   • ソースネットワークごとに、ターゲットネットワークを選択します。
   • オプション: マッピングを保存して再度使用する を選択し、ネットワークマッピング名を入力します。
7. Next をクリックします。

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

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

   • VMware データストアまたは Red Hat Virtualization ストレージドメインにターゲットストレージクラスを選択します。
   • オプション: マッピングを保存して再度使用する を選択し、ストレージマッピング名を入力します。
9. Next をクリックします。

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

    • コールド移行: データのコピー中にソースの仮想マシンが停止します。
    • ウォーム移行: データが増分コピーされる間にソース仮想マシンが実行されます。後に、仮想マシンを停止し、残りの仮想マシンデータとメタデータをコピーするカットオーバーを実行します。ウォーム移行は、Red Hat Virtualization ではサポートされません。

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

    1. Add hook をクリックします。
    2. フックの実行時のステップを選択します。

    3. フック定義を選択します。

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

       • カスタムコンテナーイメージ: デフォルトの hook-runner イメージを使用しない場合は、イメージパス <registry_path>/<image_name>:<tag> を入力します。

         注記

         レジストリーは OpenShift Container Platform クラスターからアクセスできる必要がある。

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

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

    移行計画は移行計画の一覧に保存されます。

14. 移行計画の Options メニュー をクリックし、View details を選択して移行計画の詳細を確認します。

手順

1. 移行計画 をクリックします。

   Migration plans リストには、移行元プロバイダーと移行先プロバイダー、移行する仮想マシン (VM) の数、および計画のステータスが表示されます。

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

   ウォーム移行のみ:

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

3. 移行計画を展開して、移行の詳細を表示します。

   移行の詳細画面では、移行の開始時間、終了時間、コピーされたデータ量、移行中の各仮想マシンの進捗パイプラインが表示されます。

4. VM を展開して、移行ステップ、各ステップの経過時間、およびその状態を表示します。

手順

1. 移行計画 をクリックします。
2. 実行中の移行プランの名前をクリックし、移行の詳細を表示します。
3. 1 つ以上の仮想マシンを選択し、Cancel をクリックします。

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

   Migration details by VM 一覧では、キャンセルした仮想マシンのステータスは Canceled になります。移行していない仮想マシンと移行済みの仮想マシンへの影響はありません。

手順

1. VMware のみ: VDDK イメージを HyperConverged CR に追加します。

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

   1

   作成した VDDK イメージを指定します。

2. ソースプロバイダーの認証情報の Secret CR マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: Secret
   metadata:
     name: <secret>
     namespace: openshift-mtv
   type: Opaque
   stringData:
     user: <user> 1
     password: <password> 2
     cacert: <RHV_ca_certificate> 3
     thumbprint: <vcenter_fingerprint> 4
   EOF

   1

   base64 でエンコードされた vCenter 管理ユーザーまたは RHV Manager ユーザーを指定します。

   2

   base64 でエンコードされたパスワードを指定します。

   3

   RHV のみ: Manager の base64 でエンコードされた CA 証明書を指定します。https://<www.example.com>/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA で取得できます。

   4

   VMware のみ: vCenter SHA-1 フィンガープリントを指定します。

3. ソースプロバイダーの Provider CR マニフェストを作成します。

   $ 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://<www.example.com>/sdk、RHV の場合は https://<www.example.com>/ovirt-engine/api/)。

   3

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

4. VMware のみ: ホスト CR マニフェストを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Host
   metadata:
     name: <vmware_host>
     namespace: openshift-mtv
   spec:
     provider:
       namespace: openshift-mtv
       name: <source_provider> 1
     id: <source_host_mor> 2
     ipAddress: <source_network_ip> 3
   EOF

   1

   VMware の Provider CR の名前を指定します。

   2

   VMware ホストの 管理対象オブジェクト参照 (MOR) を指定します。

   3

   VMware 移行ネットワークの IP アドレスを指定します。

5. 移行元および宛先ネットワークをマッピングする NetworkMap CR マニフェストを作成します。

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: NetworkMap
   metadata:
     name: <network_map>
     namespace: openshift-mtv
   spec:
     map:
       - destination:
           name: <pod>
           namespace: openshift-mtv
           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:
           id: <source_network_id>
           name: <source_network_name>
     provider:
       source:
         name: <source_provider>
         namespace: openshift-mtv
       destination:
         name: <destination_cluster>
         namespace: openshift-mtv
   EOF

   1

   使用できる値は Pod および multus です。

   2

   id パラメーター または name パラメーターのいずれかを使用して、ソースネットワークを指定することができます。

   3

   VMware ネットワーク MOR または RHV ネットワークの UUID を指定します。

   4

   それぞれの追加の OpenShift Virtualization ネットワークのネットワーク接続定義を指定します。

   5

   OpenShift Virtualization ネットワーク割り当て定義の namespace を指定します。

6. StorageMap CR マニフェストを作成し、ソースおよび宛先ストレージをマッピングします。

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: StorageMap
   metadata:
     name: <storage_map>
     namespace: openshift-mtv
   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: openshift-mtv
       destination:
         name: <destination_cluster>
         namespace: openshift-mtv
   EOF

   1

   許可される値は ReadWriteOnce および ReadWriteMany です。

   2

   VMware データストレージ MOR または RHV ストレージドメインの UUID を指定します (例: f2737930-b567-451a-9ceb-2887f6207009)。

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

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Hook
   metadata:
     name: <hook>
     namespace: openshift-mtv
   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 である必要があります。

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

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Plan
   metadata:
     name: <plan> 1
     namespace: openshift-mtv
   spec:
     warm: true 2
     provider:
       source:
         name: <source_provider>
         namespace: openshift-mtv
       destination:
         name: <destination_cluster>
         namespace: openshift-mtv
     map:
       network: 3
         name: <network_map> 4
         namespace: openshift-mtv
       storage:
         name: <storage_map> 5
         namespace: openshift-mtv
     targetNamespace: openshift-mtv
     vms: 6
       - id: <source_vm> 7
       - name: <source_vm>
         hooks: 8
           - hook:
               namespace: openshift-mtv
               name: <hook> 9
             step: <step> 10
   EOF

   1

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

   2

   VMware のみ: 移行がウォームまたはコールドであるかどうかを指定します。Migration CR マニフェストで cutover パラメーターの値を指定せずにウォーム移行を指定する場合は、precopy ステージのみが実行します。ウォーム移行は RHV ではサポートされていません。

   3

   複数のネットワークマッピングを追加することができます。

   4

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

   5

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

   6

   id パラメーター または name パラメーターのいずれかを使用して、ソース仮想マシンを指定することができます。

   7

   VMware 仮想マシン MOR または RHV 仮想マシンの UUID を指定します。

   8

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

   9

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

   10

   移行完了後の移行プランの開始前または PostHook の前の許容値は、PreHook です。

9. VMware のみの場合のオプション: ウォーム移行の CBT スナップショットの間隔を変更するには、vm-import-controller-config 設定マップにパッチを適用します。

   $ oc patch configmap/vm-import-controller-config \
     -n openshift-cnv -p '{"data": \
     {"warmImport.intervalMinutes": "<interval>"}}' 1

   1

   時間間隔を分単位で指定します。デフォルト値は 60 です。

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

    $ cat << EOF | oc apply -f -
    apiVersion: forklift.konveyor.io/v1beta1
    kind: Migration
    metadata:
      name: <migration> 1
      namespace: openshift-mtv
    spec:
      plan:
        name: <plan> 2
        namespace: openshift-mtv
      cutover: <cutover_time> 3
    EOF

    1

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

    2

    実行している Plan CR の名前を指定します。Migration CR は、移行する各仮想マシンに VirtualMachineImport CR を作成します。

    3

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

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

11. VirtualMachineImport Pod を表示し、移行の進捗を監視します。

    $ oc get pods -n openshift-mtv

個別の仮想マシンの移行の取り消し

1. 個別の仮想マシンを Migration CR マニフェストに追加します。

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

   1 1

   id または name のいずれかを使用して、キャンセルした仮想マシンを指定できます。

   2

   VMware 仮想マシン管理オブジェクト参照または RHV 仮想マシンの UUID

2. VirtualMachineImport Pod を表示し、残りの仮想マシンの進捗をモニターします。

   $ oc get pods -n openshift-mtv

手順

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. プロジェクトを削除します。

   $ oc delete project openshift-mtv

2. CRD を削除します。

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

3. OAuthClient を削除します。

   $ oc delete oauthclient/forklift-ui

ログおよび CR 情報の収集

1. must-gather データを保存するディレクトリーに移動します。

2. oc adm must-gather コマンドを実行します。

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

   データは /must-gather/must-gather.tar.gz として保存されます。このファイルを Red Hat カスタマーポータル で作成したサポートケースにアップロードすることができます。

3. オプション: oc adm must-gather コマンドに以下のオプションを指定して実行し、フィルターされたデータを収集します。

   • Namespace:

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

   • 移行計画:

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

   • 仮想マシン:

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

     1

     Plan CR に表示される仮想マシンの ID を指定します。