11.3. CLI を使用した仮想マシンに接続されたデバイスの管理

前提条件

• 仮想マシンに接続するデバイスに必要なオプションを取得します。特定のデバイスで利用可能なオプションを確認するには、virt-xml --device=? コマンドを使用します。以下に例を示します。

  # virt-xml --network=?
  --network options:
  [...]
  address.unit
  boot_order
  clearxml
  driver_name
  [...]

• virsh dumpxml コマンドを実行し、デバイスの XML 定義が、仮想マシンの XML 設定の <devices> セクションに追加されました。

  たとえば、以下の出力は、仮想マシン testguest の設定を表示し、002.004 USB フラッシュディスクドライブが追加されていることを確認します。

  # virsh dumpxml testguest
  [...]
  <hostdev mode='subsystem' type='usb' managed='yes'>
    <source>
      <vendor id='0x4146'/>
      <product id='0x902e'/>
      <address bus='2' device='4'/>
    </source>
    <alias name='hostdev0'/>
    <address type='usb' bus='0' port='3'/>
  </hostdev>
  [...]

• 仮想マシンを実行し、デバイスが存在し、正しく機能しているかどうかをテストします。

前提条件

• 仮想マシンに接続するデバイスに必要なオプションを取得します。特定のデバイスで利用可能なオプションを確認するには、virt-xml --device=? コマンドを使用します。以下に例を示します。

• オプション: virsh dumpxml vm-name を使用して出力をファイルに送信し、仮想マシンの XML 設定をバックアップします。たとえば、以下は、testguest1 仮想マシンの設定のバックアップファイル testguest1.xml を作成します。

• デバイスが存在し、変更を反映する場合は、仮想マシンを実行してテストします。

• virsh dumpxml コマンドを使用して、デバイスの XML 定義が、仮想マシンの XML 設定で変更されているかどうかを確認します。

  たとえば、次の出力は、仮想マシン testguest の設定を表示し、CPU モードが host-model として設定されていることを確認します。

  # virsh dumpxml testguest
  [...]
  <cpu mode='host-model' check='partial'>
    <model fallback='allow'/>
  </cpu>
  [...]

トラブルシューティング

• デバイスを変更すると仮想マシンが起動できなくなる場合は、virsh define ユーティリティーを使用して、バックアップとして作成しておいた XML 設定ファイルを再読み込みして XML 設定を復元します。

  # virsh define testguest.xml

前提条件

• オプション: virsh dumpxml vm-name を使用して出力をファイルに送信し、仮想マシンの XML 設定をバックアップします。たとえば、以下は、testguest1 仮想マシンの設定のバックアップファイル testguest1.xml を作成します。

トラブルシューティング

• デバイスを取り外すと仮想マシンが起動できなくなる場合は、virsh define ユーティリティーを使用して、バックアップとして作成しておいた XML 設定ファイルを再読み込みして XML 設定を復元します。

  # virsh define testguest.xml