ライブマイグレーションが失敗してしまう事象の調査

目次

(本記事はマイクロソフト社員によって公開されております)

こんにちは、日本マイクロソフトの Windows プラットフォーム サポートです。

ここではライブマイグレーションが失敗してしまう事象が発生した際に採取すべき資料についてご紹介します。まずは調査の初動に有効な以下の 2 パターンをご案内させていただきます。

[A] 事象の再現性がある場合

  1. 追跡型のトレース ログをエラー発生時間帯に採取する
  2. トレース ログ採取後、サポート情報ログ (イベント ログやシステム情報等) を採取する

[B] 過去に発生したエラーであり、再現性が無い場合

  1. サポート情報ログ (イベント ログやシステム情報等) を採取する

[A] 事象の再現性がある場合

(取得対象 : マイグレーション元と先のHyper-V ホスト)

  1. 以下の URL から TSS.zip をダウンロードし、Zip を展開します。

    ※ 2024年7月8日以降ツールの入手方法の変更が計画されています。該当 URL にアクセスできない場合、サポート リクエストを発行の上、担当エンジニアまでご連絡ください。

    https://aka.ms/getTSS

  2. 展開した TSS フォルダーを調査対象となる端末上の任意のパスに配置します。

  3. Windows PowerShell (powershell.exe) を [管理者として実行] にて開始します。

  4. “cd” コマンドで TSS フォルダーを配置したパスにカレント フォルダーを移動します。例として、“C:\Test” フォルダーに TSS フォルダーを配置した場合は以下のように実行します。

    cd C:\Test\TSS
    
  5. マイグレーション元の Hyper-V ホストとマイグレーション先の Hyper-V ホストで以下のコマンドを実行し、ログ取得を開始します。

    Set-ExecutionPolicy bypass -Scope Process -Force  
    .\TSS.ps1 -Start -SHA_HypVmBus -SHA_HypVmms -SHA_HypVmWp -SHA_VHDMP -SHA_VmConfig -SHA_VML -SHA_VMM -Netsh -noBasicLog -StartNoWait -noUpdate
    
    • 使用許諾の確認 (End User License Agreement) が表示された場合は内容を読んでいただき、[Accept] ボタンで同意していただきますようお願い申し上げます。
    • ログファイルは既定で C:\MS_DATA に出力されます。もし、別の場所に出力されたい場合には -LogFolderPath オプションを付与してください。 (実行例)
      .\TSS.ps1 -Start -SHA_HypVmBus -SHA_HypVmms -SHA_HypVmWp -SHA_VHDMP -SHA_VmConfig -SHA_VML -SHA_VMM -Netsh -noBasicLog -StartNoWait -noUpdate -LogFolderPath D:\MS_DATA
  6. 事象を再現させます。

  7. 事象発生後、マイグレーション元の Hyper-V ホストとマイグレーション先の Hyper-V ホストで
    以下のコマンドを実行し、ログ取得を停止します。

    .\TSS.ps1 -Stop
    

    正常に停止ができない場合について

    • エラー内容が確認できるスクリーン ショットもしくは、エラー内容をコピーした情報をお寄せください。
    • 実行状況の確認のため .\TSS.ps1 -Status コマンドの実行結果をお知らせください。
    • 再度 .\TSS.ps1 -Stop コマンドを実行し、情報採取を停止していただきますようお願いいたします。
  8. サポート情報ログを採取するため、マイグレーション元の Hyper-V ホストとマイグレーション先の Hyper-V ホストで以下のコマンドを実行します。

    .\TSS.ps1 -CollectLog SHA_support-all -noBasicLog -noUpdate
    
  9. 出力先フォルダー(既定は C:\MS_DATA) を zip で圧縮いただき、アップロード サイトへご提供ください。

[B] 過去に発生したエラーであり、再現性が無い場合

(取得対象 : マイグレーション元と先のHyper-V ホスト)

  1. 以下の URL から TSS.zip をダウンロードし、Zip を展開します。

    ※ 2024年7月8日以降ツールの入手方法の変更が計画されています。該当 URL にアクセスできない場合、サポート リクエストを発行の上、担当エンジニアまでご連絡ください。

    https://aka.ms/getTSS

  2. 展開した TSS フォルダーを調査対象となる端末上の任意のパスに配置します。

  3. Windows PowerShell (powershell.exe) を [管理者として実行] にて開始します。

  4. “cd” コマンドで TSS フォルダーを配置したパスにカレント フォルダーを移動します。例として、“C:\Test” フォルダーに TSS フォルダーを配置した場合は以下のように実行します。

    cd C:\Test\TSS
    
  5. サポート情報ログを採取するため、マイグレーション元の Hyper-V ホストとマイグレーション先の Hyper-V ホストで以下のコマンドを実行します。

    Set-ExecutionPolicy bypass -Scope Process -Force  
    .\TSS.ps1 -CollectLog SHA_support-all -noBasicLog -noUpdate
    
    • 使用許諾の確認 (End User License Agreement) が表示された場合は内容を読んでいただき、[Accept] ボタンで同意していただきますようお願い申し上げます。
    • ログファイルは既定で C:\MS_DATA に出力されます。もし、別の場所に出力されたい場合には -LogFolderPath オプションを付与してください。 (実行例)
      .\TSS.ps1 -CollectLog SHA_support-all -noBasicLog -noUpdate -LogFolderPath D:\MS_DATA
  6. 出力先フォルダー(既定は C:\MS_DATA) を zip で圧縮いただき、アップロード サイトへご提供ください。

情報採取ツール TSS に関してよく寄せられる質問

情報採取を行うツール TSS に関する一般的なご質問を以下のページにお纏めしています。必要に応じてご参照ください。

TSS に関するご質問

TSS 実行時のエラー関するご質問

以上です。 本情報が少しでも皆様のお役に立てば幸いです。

本情報の内容(添付文書、リンク先などを含む)は、作成日時点でのものであり、予告なく変更される場合があります。