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

すべての virt-who インスタンスのステータスを確認することが、トラブルシューティングで最初に推奨される手順です。Satellite Web UI または hammer のいずれかを使用して設定し、デプロイしたすべての virt-who インスタンスは、Satellite Web UI にレポートされます。手動で設定した virt-who インスタンスは、Satellite Web UI では利用できません。

# hammer virt-who-config list

デフォルトでは、virt-who はすべてのアクティビティーを /var/log/rhsm/rhsm.log ファイルにロギングします。ログファイルには役立つ情報が含まれている可能性があるため、トラブルシューティングを行う場合はログファイルを確認するようにしてください。詳細のロギングを有効にするには、グローバル設定ファイル /etc/sysconfig/virt-who のデバッグ行を VIRTWHO_DEBUG=1 に変更します。virt-who をサービスとして実行している場合は、再起動して設定を適用する必要があります。 潜在する問題を解決したら、デバッグ行を VIRTWHO_DEBUG=0 に戻し、virt-who を再起動して、診断ロギングを無効にしてください。

グローバルファイルやハイパーバイザー固有のファイルなど、設定ファイルが複数存在する可能性があるため、設定行が重複すると、virt-who が意図したものとは異なる動作をする可能性があります。

virt-who 設定ファイルの重複行を検出するには、以下のコマンドを使用します。このコマンドの出力は、指定のファイルのすべての行をリストし、行頭に重複回数を追加します。2 回以上記載されている行をすべて確認して重複行を削除し、virt-who サービスを再起動します。使用方法は 「virt-who サービスの再起動」を参照してください。

# cat /etc/sysconfig/virt-who /etc/virt-who.d/* | sort | uniq -c

コメント文字 # は、設定ファイルの行頭に置く必要があります。行頭が空白の場合は、設定に含まれます。

認証情報に誤りがあると、virt-who で問題が発生する可能性があります。できる限り、仮想化マネージャーまたはハイパーバイザーにログインして、virt-who が使用するように設定した認証情報をテストするようにしてください。たとえば、VMware vSphere の管理コンソールにログインし、必要なホストが表示され、認証情報が正しいことを確認します。

トラブルシューティング時に問題の根本原因を判断するためには、変更を加えて結果をテストしていくことを必要に応じて繰り返していくのが一般的な方法です。virt-who エージェントは、この手法を使用しやすいようなオプションを提供します。

virt-who --one-shot コマンドを実行すると、全設定ファイルを読み込み、全ソースから仮想マシン一覧を取得し、すぐに終了します。このように、設定ファイル、認証情報、設定済み仮想化プラットフォームへの接続性をテストします。

# virt-who --one-shot

ハイパーバイザーとホストされているゲスト仮想マシンの一覧が JSON 形式で出力されます。以下は、VMware vSphere インスタンスからの virt-who の出力の抜粋です。ハイパーバイザーからの出力はすべて、以下のような構成になっています。

{
    "guestId": "422f24ed-71f1-8ddf-de53-86da7900df12",
    "state": 5,
    "attributes": {
        "active": 0,
        "virtWhoType": "esx",
        "hypervisorType": "vmware"
    }
},

virt-who 設定ファイルが複数ある場合は、1 回に 1 つの virt-who 設定ファイルを /root ディレクトリーに移動し、各ファイルの移動後にテストを行います。問題が発生しなくなった場合は、直近で移動したファイルに原因があります。この問題の解決後に、virt-who 設定ファイルを元の場所に戻します。