第10章 トラブルシューティング

手順

1. MTC Web コンソールで、Migration plans をクリックします。

2. 移行計画の横にある Migrations 番号をクリックし、Migrations ページを表示します。

   Migrations ページには、移行計画に関連する移行タイプ (Stage、Migrationまたは Rollback など) が表示されます。

3. Type リンクをクリックして、Migration details ページを表示します。

4. Migration resources を展開して、移行リソースおよびそれらのステータスを表示します。

   注記

   移行の失敗をトラブルシューティングするには、失敗した高レベルのリソースで開始し、リソースツリーでより低い位置にあるリソースまで堀り下げます。

5. リソースの横にある Options メニュー をクリックし、以下のオプションのいずれかを選択します。

   • copy oc describe コマンド は、コマンドをクリップボードにコピーします。

     • 関連するクラスターにログインしてから、コマンドを実行します。

       リソースの条件およびイベントは YAML 形式で表示されます。

   • Copy oc logs コマンド は、コマンドをクリップボードにコピーします。

     • 関連するクラスターにログインしてから、コマンドを実行します。

       リソースがログフィルターに対応していると、フィルターされたログが表示されます。

   • JSON ビューは、Web ブラウザーで JSON 形式でリソースデータを表示します。

     データは oc get <resource> コマンドの出力と同じです。

手順

1. MTC Web コンソールで、Migration plans をクリックします。

2. 移行計画の横にある Migrations 番号をクリックし、Migrations ページを表示します。

   Migrations ページには、移行計画に関連する移行タイプ (ウォーム移行の場合には Stage または Cutover など) が表示されます。

3. View logs をクリックします。
4. コピーアイコンをクリックして、oc logs コマンドをクリップボードにコピーします。

5. 関連するクラスターにログインし、CLI でコマンドを実行します。

   移行契約の集約ログが表示されます。

手順

1. mig-log-reader Pod を取得します。

   $ oc -n openshift-migration get pods | grep log

2. 以下のコマンドを実行して、単一の移行ログを表示します。

   $ oc -n openshift-migration logs -f <mig-log-reader-pod> -c color 1

   1

   -c plain オプションは、色なしでログを表示します。

手順

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

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

   • 過去 1 時間のデータを収集するには、以下を実行します。

     $ oc adm must-gather --image=registry.redhat.io/rhmtc/openshift-migration-must-gather-rhel8:v1.4

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

   • 過去 24 時間のデータを収集するには、以下を実行します。

     $ oc adm must-gather --image= \
       registry.redhat.io/rhmtc/openshift-migration-must-gather-rhel8: \
       v1.4 -- /usr/bin/gather_metrics_dump

     この操作には長時間かかる場合があります。データは /must-gather/metrics/prom_data.tar.gz として保存されます。このファイルは Prometheus コンソールで表示できます。

Prometheus コンソールでデータを表示するには、以下を実行します。

1. ローカルの Prometheus インスタンスを作成します。

   $ make prometheus-run

   このコマンドでは、Prometheus URL が出力されます。

   出力

   Started Prometheus on http://localhost:9090

2. Web ブラウザーを起動して URL に移動し、Prometheus Web コンソールを使用してデータを表示します。

3. データを確認した後に、Prometheus インスタンスおよびデータを削除します。

   $ make prometheus-cleanup

手順

1. MigMigration CR のステータスを確認します。

   $ oc get migmigration <migmigration> -o yaml

   出力例

   status:
     conditions:
     - category: Warn
       durable: true
       lastTransitionTime: "2021-01-26T20:48:40Z"
       message: 'Final Restore openshift-migration/ccc7c2d0-6017-11eb-afab-85d0007f5a19-x4lbf: partially failed on destination cluster'
       status: "True"
       type: VeleroFinalRestorePartiallyFailed
     - category: Advisory
       durable: true
       lastTransitionTime: "2021-01-26T20:48:42Z"
       message: The migration has completed with warnings, please look at `Warn` conditions.
       reason: Completed
       status: "True"
       type: SucceededWithWarnings

2. Velero describe コマンドを使用して Restore CR のステータスを確認します。

   $ oc exec $(oc get pods -n openshift-migration -o name | grep velero) -n openshift-migration -- ./velero restore describe <restore>

   出力例

   Phase:  PartiallyFailed (run 'velero restore logs ccc7c2d0-6017-11eb-afab-85d0007f5a19-x4lbf' for more information)
   
   Errors:
     Velero:     <none>
     Cluster:    <none>
     Namespaces:
       migration-example:  error restoring example.com/migration-example/migration-example: the server could not find the requested resource

3. Velero logs コマンドを使用して Restore CR ログを確認します。

   $ oc exec $(oc get pods -n openshift-migration -o name | grep velero) -n openshift-migration -- ./velero restore logs <restore>

   出力例

   time="2021-01-26T20:48:37Z" level=info msg="Attempting to restore migration-example: migration-example" logSource="pkg/restore/restore.go:1107" restore=openshift-migration/ccc7c2d0-6017-11eb-afab-85d0007f5a19-x4lbf
   time="2021-01-26T20:48:37Z" level=info msg="error restoring migration-example: the server could not find the requested resource" logSource="pkg/restore/restore.go:1170" restore=openshift-migration/ccc7c2d0-6017-11eb-afab-85d0007f5a19-x4lbf

   Restore CR のログエラーメッセージの the server could not find the requested resource は、部分的に失敗した移行の原因を示します。

手順

1. openshift-migration namespace の MigMigration CR を一覧表示します。

   $ oc get migmigration -n openshift-migration

   出力例

   NAME                                   AGE
   88435fe0-c9f8-11e9-85e6-5d593ce65e10   6m42s

2. MigMigration CR を検査します。

   $ oc describe migmigration 88435fe0-c9f8-11e9-85e6-5d593ce65e10 -n openshift-migration

   出力は以下の例のようになります。