手順3.1 ローカルインストールメディアを使用した virt-manager を使用した Red Hat Enterprise Linux 7 ゲスト仮想マシンの作成

1. オプション： Preparation

   仮想マシン用のストレージ環境を準備します。13章仮想マシンのストレージの管理。
   重要

   各種のストレージタイプは、ゲスト仮想マシンの格納に使用できます。ただし、仮想マシンが移行機能を使用できるようにするには、仮想マシンをネットワークストレージに作成する必要があります。
   Red Hat Enterprise Linux 7 には、1 GB 以上のストレージ領域が必要です。ただし、Red Hat では、Red Hat Enterprise Linux 7 のインストールと、本ガイドの手順には、少なくとも 5 GB のストレージ領域を推奨します。

2. virt-manager を開き、ウィザードを起動します。

   root で virt-manager コマンドを実行するか、または Applications → System Tools → Virtual Machine Manager を開いて virt-manager を開きます。

   図3.1 Virtual Machine Manager ウィンドウ

   
   必要に応じて、ハイパーバイザーを選択して、接続 ボタンをクリックして、リモートハイパーバイザーを開きます。
   をクリックし、新しい仮想化ゲストウィザードを起動します。
   New VM ウィンドウが開きます。

3. インストールタイプを指定します。

   インストールの方法を選択します。

   ローカルインストールメディア（ISO イメージまたは CDROM）

   この方法では、インストールディスクのイメージ （例：.iso）を使用します。ただし、ホストの CD-ROM または DVD-ROM デバイスを使用することはできません。

   ネットワークインストール（HTTP、FTP、または NFS）

   この方法には、ミラー化した Red Hat Enterprise Linux または Fedora インストールツリーを使用して、ゲストをインストールします。インストールツリーは、HTTP、FTP、または NFS のいずれかからアクセスできる必要があります。

   Network Install を選択した場合には、必要に応じてインストール URL とカーネルオプションを指定します。

   ネットワークブート(PXE)

   この方法では、PXE(Preboot eXecution Environment)サーバーを使用してゲスト仮想マシンをインストールします。PXE 『サーバーの設定については、『Red Hat Enterprise Linux 7 インストールガイド』』で説明しています。ネットワークブートを使用してインストールするには、ゲストにはルーティング可能な IP アドレスまたは共有ネットワークデバイスが必要です。

   Network Boot を選択した場合は、STEP 5 に進みます。手順がすべて完了したら、DHCP 要求が送信され、有効な PXE サーバーにゲスト仮想マシンのインストールプロセスが開始します。

   既存のディスクイメージのインポート

   この方法では、新しいゲスト仮想マシンを作成し、そこにディスクイメージ (インストール済みの起動可能なオペレーティングシステムを含む) をインポートできます。

   図3.2 仮想マシンのインストール方法

   
   進む をクリックして続行します。

4. インストールソースの選択

   1. Local install media(ISO image or CDROM) を選択した場合は、目的のローカルインストールメディアを指定します。

      図3.3 ローカル ISO イメージのインストール

      
      警告

      現在、GUI にこのオプションが存在する場合でも、ホスト上の物理 CD-ROM デバイスまたは DVD デバイスからインストールすることはできません。したがって、Use CDROM または DVD オプションを選択すると、仮想マシンのインストールに失敗します。詳細は「Red Hat ナレッジベース」を参照してください。
      ISO イメージからインストールするには、Use ISO image を選択し、Browse... ボタンをクリックして Locate media volume ウィンドウを開きます。
      使用するインストールイメージを選択し、ボリュームの選択 をクリックします。
      Locate メディアボリュームウィンドウにイメージが表示されない場合は 、Browse Local ボタンをクリックして、インストールイメージを含むホストマシン、またはインストールディスクを含む DVD ドライブを参照します。インストールディスクを含むインストールイメージまたは DVD ドライブを選択して Open をクリックします。ボリュームを使用する場合は、Create a new virtual machine ウィザードに戻ります。
      重要

      ISO イメージファイルおよびゲストストレージイメージの場合には、使用する推奨場所は /var/lib/libvirt/images/ です。その他の場所には、SELinux による追加設定が必要になる場合があります。SELinux の設定に関する詳細は、『Red Hat Enterprise Linux Virtualization セキュリティーガイド』または 『Red Hat Enterprise Linux SELinux ユーザーおよび管理者のガイド 』を参照してください。
   2. ネットワークインストール を選択した場合は、インストールソースの URL と必要なカーネルオプション（ある場合）も入力します。URL はインストールツリーのルートディレクトリーを参照する必要があります。これは HTTP、FTP、または NFS のいずれかでアクセスできる必要があります。
      キックスタートインストールを実行するには、ks=から始まる、カーネルオプションにキックスタートファイルの URL を指定します。

      図3.4 ネットワークキックスタートのインストール

      
      注記

      カーネルオプションの完全なリストは『Red Hat Enterprise Linux 7 インストールガイド』を参照してください。
   次に、インストールの OS タイプと バージョンを設定します。仮想マシンに適したオペレーティングシステムタイプを選択します。これは、手動指定するか、インストールメディアに基づいてオペレーティングシステムを自動検出して選択したりできます。
   進む をクリックして続行します。

5. メモリー(RAM)および仮想 CPU の設定

   仮想マシンに割り当てる CPU の数およびメモリー容量(RAM)を指定します。ウィザードには、割り当て可能な CPU の数とメモリー量が表示されます。これらの値は、ホストのパフォーマンスとゲストのパフォーマンスに影響を及ぼします。
   効率的に実行して、十分な物理メモリー(RAM)が必要になります。Red Hat は、仮想マシン用に最小 512MB の RAM をサポートします。Red Hat は、論理コアごとに 1024MB 以上の RAM を推奨します。
   仮想マシン用の十分な仮想 CPU を割り当てます。仮想マシンがマルチスレッドアプリケーションを実行する場合は、ゲスト仮想マシンが効率的に実行するのに必要な仮想 CPU の数を割り当てます。
   ホストシステムで利用可能な物理プロセッサー（またはハイパースレッディング）よりも多くの仮想 CPU を割り当てることはできません。利用可能な仮想 CPU の数は、Up to X available フィールドに記載されています。

   図3.5 メモリーおよび CPU の設定

   
   メモリーおよび CPU 設定を設定したら、Forward をクリックして続行します。
   注記

   メモリーおよび仮想 CPU はオーバーコミットできます。7章KVM を使用したオーバーコミット。

6. ストレージの設定

   仮想マシン用の十分な領域と、必要なアプリケーションを有効にして割り当てます。デスクトップのインストールには 5 GB 以上、または最小インストールには 1 GB 以上を割り当てます。

   図3.6 仮想ストレージの設定

   
   注記

   ライブマイグレーションおよびオフラインの移行では、仮想マシンを共有ネットワークストレージにインストールする必要があります。「共有ストレージの例： シンプル移行用 NFS」。

   1. デフォルトのローカルストレージの使用

      コンピューターのハードドライブラジオボタンにディスクイメージの作成 を選択して、デフォルトストレージプール （/var/lib/libvirt/images/ ディレクトリー）でファイルベースのイメージを作成します。作成するディスクイメージのサイズを入力します。ディスク全体の割り当て チェックボックスが選択されると、指定したサイズのディスクイメージがすぐに作成されます。そうでない場合は、ディスクイメージは入力時に拡張されます。
      注記

      ストレージプールは仮想コンテナーですが、qemu-kvm が許容する最大サイズと、ホストの物理マシンのディスクのサイズという 2 つの要素によって制限されます。ストレージプールは、ホストの物理マシンのディスクサイズを超えることはできません。最大サイズは以下のとおりです。

      • virtio-blk = 2^63 バイトまたは 8 つのエクサバイト（raw ファイルまたはディスクを使用）
      • Ext4 = ~ 16 TB (using 4 KB block size)
      • xfs = ~8 Exabytes
      • qcow2 およびホストファイルシステムは独自のメタデータを維持します。イメージサイズの大きさを試する場合には、スケーラビリティーを評価/調整する必要があります。raw ディスクを使用すると、スケーラビリティーや最大サイズに影響を与える可能性のある層が少なくなります。
      Forward をクリックして、ローカルのハードドライブにディスクイメージを作成します。または、Select managed or other existing storage を選択してから 参照 を選択して、管理対象ストレージを設定します。

   2. ストレージプールあり

      Select managed or other existing storage を選択してストレージプールを使用する場合は、Browse をクリックして Locate を開くか、ストレージボリュームウィンドウを作成します。

      図3.7 Choose Storage Volume ウィンドウ

      
      1. ストレージプール リストからストレージプールを選択します。
      2. オプション： をクリックし、新規ストレージボリュームを作成します。Add a Storage Volume 画面が表示されます。新規ストレージボリュームの名前を入力します。
         Format ドロップダウンメニューから format オプションを選択します。フォーマットオプションには、raw、qcow2、および qed が含まれます。必要に応じて、他のフィールドを調整します。ここで使用される qcow2 バージョンは、バージョン 3 であることに注意してください。qcow バージョンを変更するには、を参照してください。 「ターゲット要素の設定」

         図3.8 ストレージボリュームの追加 ウィンドウ。

         
   新しいボリュームを選択し、ボリュームの選択 をクリックします。次に、Finish をクリックして New VM ウィザードに戻ります。進む をクリックして続行します。

7. 名前と最終設定

   仮想マシンに名前を付けます。仮想マシン名には、アンダースコア(_)、ピリオド(.)、およびハイフン(-)の文字を含めることができます。仮想マシンを移行するには、仮想マシンの名前は一意でなければならず、数字のみの名前は使用できません。
   デフォルトでは、仮想マシンは「default」と呼ばれるネットワークのネットワークアドレス変換(NAT)で作成されます。ネットワークの選択を変更するには、ネットワークの選択 をクリックして、ホストデバイスおよびソースモードを選択します。
   仮想マシンの設定を確認し、問題がなければ Finish をクリックします。これにより、指定したネットワーク設定、仮想化タイプ、およびアーキテクチャーで仮想マシンが作成されます。

   図3.9 設定の確認

   
   仮想マシンのハードウェアをさらに設定するには、インストール前に Customize configuration をオンにしてゲストのストレージまたはネットワークデバイスの変更、準仮想化(virtio)ドライバーを使用するか、または追加デバイスを追加します。これにより、仮想マシンのハードウェア設定の追加、削除、設定を可能にする別のウィザードが開きます。
   注記

   Red Hat Enterprise Linux 4 または Red Hat Enterprise Linux 5 のゲスト仮想マシンは、グラフィカルモードでインストールできません。したがって、ビデオカードとして「QXL」ではなく「Cirrus」を選択する必要があります。
   仮想マシンのハードウェアの設定後、適用を クリックします。次に、virt-manager は、指定したハードウェア設定で仮想マシンを作成します。
   警告

   リモートのメディアから Red Hat Enterprise Linux 7 ゲスト仮想マシンをインストールする際に、TCP/IP 接続を設定せずに、インストールに失敗します。ただし、このような状況では、Red Hat Enterprise Linux 5 または 6 のゲスト仮想マシンをインストールすると、「Configure TCP/IP」インターフェースが開きます。

   この違いに関する詳細は、関連するナレッジベースの記事を参照してください。
   Finish をクリックして、Red Hat Enterprise Linux インストールシーケンスに進みます。Red Hat Enterprise Linux 7 のインストール方法は『Red Hat Enterprise Linux 7 インストールガイド』を参照してください。

手順4.2 virt-manager を使用した仮想マシンのクローン作成

1. open virt-manager

   virt-manager を起動します。アプリケーションメニューおよび System Tools サブメニューから、Virtual Machine Manager アプリケーションを起動します。または、root で virt-manager コマンドを実行します。
   Virtual Machine Manager のゲスト仮想マシンの一覧から、クローン作成するゲスト仮想マシンを選択します。
   クローンを作成するゲスト仮想マシンを右クリックし、Clone を選択します。Clone Virtual Machine ウィンドウが開きます。

   図4.1 仮想マシンのクローンウィンドウ

   

2. クローンを設定します。

   • クローンの名前を変更するには、クローンの新しい名前を入力します。
   • ネットワーク設定を変更するには、Details をクリックします。
     クローンに新しい MAC アドレスを入力します。
     OK をクリックします。

     図4.2 MAC アドレスウィンドウの変更

     
   • クローン作成されたゲスト仮想マシンのそれぞれのディスクに対して、以下のオプションのいずれかを選択します。
     • このディスクのクローン - クローン作成されたゲスト仮想マシンのディスクのクローン作成
     • ゲスト仮想マシン名と共にディスクを共有します。ディスクは、クローン作成されるゲスト仮想マシンとそのクローンで共有されます。
     • 詳細: ディスクの新しいパスを選択できるストレージパスの変更ウィンドウを開きます。

       図4.3 ストレージパスウィンドウの変更

       

3. ゲスト仮想マシンのクローン作成

   Clone をクリックします。

手順6.1 virt-manager を使用したブリッジの作成

1. virt-manager メインメニューから Edit ⇒ Connection Details をクリックし、Connection Details ウィンドウを開きます。
2. Network Interfaces タブをクリックします。
3. ウィンドウの下部にある + をクリックして、新規ネットワークインターフェースを設定します。
4. インターフェースタイプのドロップダウンメニューで Bridge を選択し、Forward をクリックして続行します。

   図6.1 ブリッジの追加

   
5. 1. 名前 フィールドに、br0 などのブリッジの名前を入力します。
   2. ドロップダウンメニューから Start mode を選択します。以下のいずれかから選択します。
      • none: ブリッジを非アクティブにします。
      • onboot - 次回のゲスト仮想マシンの再起動時にブリッジをアクティブ化します。
      • ホットプラグ - ゲスト仮想マシンが実行中であってもブリッジを有効にします。
   3. Activate now チェックボックスをチェックして、ブリッジをすぐにアクティブにします。
   4. IP 設定またはブリッジ 設定のいずれかを設定するには 、適切な設定 ボタンをクリックします。別のウィンドウが開き、必要な設定を指定します。必要な変更を加え、終了したら OK をクリックします。
   5. 仮想マシンに接続する物理インターフェースを選択します。 このインターフェースが別のゲスト仮想マシンで使用されていると、警告メッセージが表示されます。
6. Finish をクリックすると、ウィザードが閉じ、Connection メニューに戻ります。

   図6.2 ブリッジの追加

   

手順9.1 PXE ブートサーバーの設定

1. PXE ブートイメージと設定を /var/lib/tftpboot に配置します。
2. 以下のコマンドを実行します。

   # virsh net-destroy default
   # virsh net-edit default

3. デフォルトネットワークの設定ファイルで <ip> 要素を編集して、適切なアドレス、ネットワークマスク、DHCP アドレス範囲、ブートファイルを追加します。BOOT_FILENAME は、ゲスト仮想マシンの起動に使用するファイル名を表します。

   <ip address='192.168.122.1' netmask='255.255.255.0'>
      <tftp root='/var/lib/tftpboot' />
      <dhcp>
         <range start='192.168.122.2' end='192.168.122.254' />
         <bootp file='BOOT_FILENAME' />
      </dhcp>
   </ip>

4. 次のコマンドを実行します。

   # virsh net-start default

5. PXE を使用してゲストを起動します（ 「PXE を使用したゲストのブート」）。

手順9.2 PXE およびブリッジネットワークを使用したゲストの起動

1. ブリッジングは、PXE ブートサーバーがネットワークで利用可能になるようにします。
2. PXE ブートが有効な状態でゲスト仮想マシンを起動します。以下の例のコマンドにあるように、virt-install コマンドを使用して、PXE ブートが有効な状態で新しい仮想マシンを作成できます。

   virt-install --pxe --network bridge=breth0 --prompt

   または、ゲストネットワークがブリッジネットワークを使用するように設定されていることを確認してください。以下の例のように、XML ゲスト設定ファイルに <os> 要素内に <boot dev='network'/> 要素があることを確認します。

   <os>
      <type arch='x86_64' machine='pc-i440fx-rhel7.0.0'>hvm</type>
      <boot dev='network'/>
      <boot dev='hd'/>
   </os>
   <interface type='bridge'>
      <mac address='52:54:00:5a:ad:cb'/>
      <source bridge='breth0'/>
      <target dev='vnet0'/>
      <alias name='net0'/>
      <address type='pci' domain='0x0000' bus='0x00' slot='0x03' function='0x0'/>
   </interface>

手順9.3 プライベート libvirt ネットワークの使用

1. に示すように、libvirt で PXE 「プライベート libvirt ネットワークでの PXE ブートサーバーの設定」。
2. PXE ブートを有効にして libvirt を使用してゲスト仮想マシンを起動します。virt-install コマンドを使用して、PXE を使用して新しい仮想マシンを作成、インストールできます。

   virt-install --pxe --network network=default --prompt

手順11.4 Linux ゲストで、virsh でゲストエージェントとホスト間の通信を設定

1. 仮想マシンのシャットダウン

   SPICE エージェントを設定する前に、仮想マシン （この例では rhel7） がシャットダウンされていることを確認します。

   # virsh shutdown rhel7 

2. ゲスト XML 設定に SPICE エージェントチャンネルを追加する

   ゲストの XML ファイルを編集して SPICE エージェントの詳細を追加します。

   # virsh edit rhel7

   以下をゲストの XML ファイルに追加し、変更を保存します。

   <channel type='spicevmc'>
      <target type='virtio' name='com.redhat.spice.0'/>
   </channel>

3. 仮想マシンの起動

   # virsh start rhel7

4. ゲストへの SPICE エージェントのインストール

   ゲスト仮想マシンに SPICE エージェントがインストールされていない場合はインストールします。

   # yum install spice-vdagent

5. ゲストの SPICE エージェントを起動する

   ゲストで SPICE エージェントサービスを起動します。

   # systemctl start spice-vdagent

手順11.5 実行中の Linux ゲストでの SPICE エージェントとホスト間の通信設定

1. SPICE エージェントの XML ファイルの作成

   # cat agent.xml
   <channel type='spicevmc'>
      <target type='virtio' name='com.redhat.spice.0'/>
   </channel>

2. SPICE エージェントの仮想マシンへの割り当て

   以下のコマンドを使用して、実行中の仮想マシン（この例では rhel7）に SPICE エージェントをアタッチします。

   # virsh attach-device rhel7 agent.xml

3. ゲストへの SPICE エージェントのインストール

   ゲスト仮想マシンに SPICE エージェントがインストールされていない場合はインストールします。

   # yum install spice-vdagent

4. ゲストの SPICE エージェントを起動する

   ゲストで SPICE エージェントサービスを起動します。

   # systemctl start spice-vdagent

手順11.6 virt-managerで SPICE エージェントとホスト間の通信の設定

1. 仮想マシンのシャットダウン

   SPICE エージェントを設定する前に、仮想マシンをシャットダウンしていることを確認します。
   仮想マシンをシャットダウンするには、Virtual Machine Manager の仮想マシンの一覧から選択し、メニューバーから軽量スイッチアイコンをクリックします。

2. ゲストに SPICE エージェントチャンネルを追加する

   ゲストウィンドウの上部にある lightbulb アイコンをクリックして、仮想マシンのハードウェア情報を開きます。
   ハードウェアの追加 ボタンをクリックして Add New Virtual Hardware ウィンドウを開き、Channel を選択します。
   Name ドロップダウンリストから SPICE エージェントを選択し、チャネルアドレスを編集して Finish をクリックします。

   図11.2 SPICE エージェントのチャンネルデバイスの選択

   

3. 仮想マシンの起動

   仮想マシンを起動するには、Virtual Machine Manager の仮想マシンの一覧から選択し、メニューバーの をクリックします。

4. ゲストへの SPICE エージェントのインストール

   ゲスト仮想マシンにまだインストールされていない場合は、virt-manager でゲストを開き、SPICE エージェントをインストールします。

   # yum install spice-vdagent

5. ゲストの SPICE エージェントを起動する

   ゲストで SPICE エージェントサービスを起動します。

   # systemctl start spice-vdagent

1. の説明に従って、libvirtd.conf 手順15.1「libvirtd.conf の設定」。
2. Processing controls セクションを確認します。

   #################################################################
   #
   # Processing controls
   #
   
   # The maximum number of concurrent client connections to allow
   # over all sockets combined.
   #max_clients = 5000
   
   # The maximum length of queue of connections waiting to be
   # accepted by the daemon. Note, that some protocols supporting
   # retransmission may obey this so that a later reattempt at
   # connection succeeds.
   #max_queued_clients = 1000
   
   # The minimum limit sets the number of workers to start up
   # initially. If the number of active clients exceeds this,
   # then more threads are spawned, upto max_workers limit.
   # Typically you'd want max_workers to equal maximum number
   # of clients allowed
   #min_workers = 5
   #max_workers = 20
   
   
   # The number of priority workers. If all workers from above
   # pool will stuck, some calls marked as high priority
   # (notably domainDestroy) can be executed in this pool.
   #prio_workers = 5
   
   # Total global limit on concurrent RPC calls. Should be
   # at least as large as max_workers. Beyond this, RPC requests
   # will be read into memory and queued. This directly impact
   # memory usage, currently each request requires 256 KB of
   # memory. So by default upto 5 MB of memory is used
   #
   # XXX this isn't actually enforced yet, only the per-client
   # limit is used so far
   #max_requests = 20
   
   # Limit on concurrent requests from a single client
   # connection. To avoid one client monopolizing the server
   # this should be a small fraction of the global max_requests
   # and max_workers parameter
   #max_client_requests = 5
   
   #################################################################
   

3. max_clients および max_workers パラメーター設定を変更します。数値は両方のパラメーターで同じである必要があります。max_clients は移行ごとに 2 つのクライアントを使用し、max_workers は実行フェーズに 1 つのワーカーを使用し、実行フェーズ中に宛先に 0 ワーカー、終了フェーズ中に 1 つのワーカーを使用します。
   重要

   max_clients および max_workers パラメーターの設定は、libvirtd サービスへのすべてのゲスト仮想マシン接続の影響を受けます。つまり、同じゲスト仮想マシンを使用しているユーザーであれば、同時に移行が行われているユーザーは max_clients および max_workers パラメーター設定に設定された制限も明確になります。このため、同時ライブマイグレーションを実行する前に、最大値を慎重に検討する必要があります。
   重要

   max_clients パラメーターは、libvirt に接続可能なクライアントの数を制御します。多数のコンテナーを一度に起動すると、この制限から簡単に到達して超過できます。これを回避するために max_clients パラメーターの値が増える可能性がありますが、これにより、インスタンスに対するサービス拒否(DoS)攻撃に対して脆弱となる可能性があります。この問題を軽減するために、Red Hat Enterprise Linux 7.0 に新しい max_anonymous_clients 設定が導入されました。この構成は、受け入れられても認証された接続の制限を指定するものです。max_clients と max_anonymous_clients の組み合わせを実装して、ワークロードに応じて実装できます。
4. ファイルを保存して、サービスを再起動します。
   注記

   起動した ssh セッションが多すぎるが、まだ認証されていないため、移行接続がドロップされる場合もあります。デフォルトでは、sshd は、いつでもセッションを「事前認証」するのを許可します。この設定は、sshd 設定ファイル（ここでは /etc/ssh/sshd_config）の MaxStartups パラメーターで制御されます。これには、調整が必要になる場合があります。DoS 攻撃（通常はリソースを過剰に活用）しないように制限があるため、このパラメーターを調整する際には注意してください。この値を高すぎると、その目的がなくなります。このパラメーターを変更するには、/etc/ssh/sshd_config ファイルを編集し、MaxStartups 行の先頭に # を削除し、10 （デフォルト値）を高い数に変更します。ファイルを保存して sshd サービスを再起動します。詳細は、man ページの sshd_config を参照してください。

手順16.3 virsh でゲスト仮想マシンへの PCI デバイスの割り当て

1. デバイスの特定

   まず、仮想マシンへのデバイスの割り当て用に指定された PCI デバイスを特定します。lspci コマンドを使用して、利用可能な PCI デバイスを一覧表示します。lspci の出力を改良できます。
   この例では、以下の出力で強調表示されているイーサネットコントローラーを使用します。

   # lspci | grep Ethernet
   00:19.0 Ethernet controller: Intel Corporation 82567LM-2 Gigabit Network Connection
   01:00.0 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)
   01:00.1 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)

   このイーサネットコントローラーは、ショート識別子 00:19.0 で表示されます。この PCI デバイスを仮想マシンに割り当てるには、virsh で使用される全識別子を検出する必要があります。
   これには、virsh nodedev-list コマンドを使用して、ホストマシンに接続されている特定のタイプ(pci)のデバイスの一覧を表示します。次に、使用するデバイスの短い識別子にマップする文字列の出力を確認します。
   この例は、短い識別子 00:19.0 でイーサネットコントローラーにマップする文字列を示しています。: および. 文字は、完全な識別子のアンダースコアに置き換えられます。

   # virsh nodedev-list --cap pci
   pci_0000_00_00_0
   pci_0000_00_01_0
   pci_0000_00_03_0
   pci_0000_00_07_0
   pci_0000_00_10_0
   pci_0000_00_10_1
   pci_0000_00_14_0
   pci_0000_00_14_1
   pci_0000_00_14_2
   pci_0000_00_14_3
   pci_0000_00_19_0
   pci_0000_00_1a_0
   pci_0000_00_1a_1
   pci_0000_00_1a_2
   pci_0000_00_1a_7
   pci_0000_00_1b_0
   pci_0000_00_1c_0
   pci_0000_00_1c_1
   pci_0000_00_1c_4
   pci_0000_00_1d_0
   pci_0000_00_1d_1
   pci_0000_00_1d_2
   pci_0000_00_1d_7
   pci_0000_00_1e_0
   pci_0000_00_1f_0
   pci_0000_00_1f_2
   pci_0000_00_1f_3
   pci_0000_01_00_0
   pci_0000_01_00_1
   pci_0000_02_00_0
   pci_0000_02_00_1
   pci_0000_06_00_0
   pci_0000_07_02_0
   pci_0000_07_03_0

   使用するデバイスにマップする PCI デバイス番号を記録します。これは他のステップで必要になります。

2. デバイス情報の確認

   ドメイン、バス、および機能に関する情報は、virsh nodedev-dumpxml コマンドの出力から利用できます。

   図16.1 ダンプの内容

   
   # virsh nodedev-dumpxml pci_0000_00_19_0
   <device>
     <name>pci_0000_00_19_0</name>
     <parent>computer</parent>
     <driver>
       <name>e1000e</name>
     </driver>
     <capability type='pci'>
       <domain>0</domain>
       <bus>0</bus>
       <slot>25</slot>
       <function>0</function>
       <product id='0x1502'>82579LM Gigabit Network Connection</product>
       <vendor id='0x8086'>Intel Corporation</vendor>
       <iommuGroup number='7'>
         <address domain='0x0000' bus='0x00' slot='0x19' function='0x0'/>
       </iommuGroup>
     </capability>
   </device>
   

   注記

   IOMMU グループは、IOMMU の観点からデバイスの可視性および分離に基づいて決定されます。各 IOMMU グループには 1 つ以上のデバイスが含まれることがあります。複数のデバイスが存在する場合、IOMMU グループ内のすべてのエンドポイントは、ゲストに割り当てるグループ内のデバイスについて要求する必要があります。これは、追加のエンドポイントをゲストに割り当てるか、virsh nodedev-detach を使用してホストドライバーからデタッチして実行できます。1 つのグループに含まれるデバイスは、複数のゲスト間で分割したり、ホストとゲストに分割したりすることはできません。PCIe ルートポート、スイッチポート、ブリッジなどの非エンドポイントデバイスは、ホストドライバーから切り離してはならず、エンドポイントの割り当てを干渉しません。

   IOMMU グループ内のデバイスは、virsh nodedev-dumpxml 出力の iommuGroup セクションを使用して判断できます。グループの各メンバーは、別個の "address" フィールドで提供されます。この情報は、次の使用による sysfs にも記載されています。

   $ ls /sys/bus/pci/devices/0000:01:00.0/iommu_group/devices/

   以下のような出力があります。

   0000:01:00.0  0000:01:00.1

   ゲストに 0000.01.00.0 のみを割り当てるには、ゲストを起動する前に未使用のエンドポイントをホストからデタッチする必要があります。

   $ virsh nodedev-detach pci_0000_01_00_1

3. 必要な設定情報の確認

   設定ファイルに必要な値は、virsh nodedev-dumpxml pci_0000_00_19_0 コマンドの出力を参照してください。
   デバイスの例の値は bus = 0, slot = 25 および function = 0 です。10 進数設定では、以下の 3 つの値を使用します。

   bus='0'
   slot='25'
   function='0'

4. 設定の詳細の追加

   virsh edit を実行して仮想マシン名を指定し、<devices> セクションにデバイスエントリーを追加します。PCI デバイスをゲスト仮想マシンに割り当てます。以下に例を示します。

   # virsh edit guest1-rhel7-64

   図16.2 PCI デバイスの追加

   
   <devices>
   	[...]
    <hostdev mode='subsystem' type='pci' managed='yes'>
      <source>
         <address domain='0' bus='0' slot='25' function='0'/>
      </source>
    </hostdev>
    [...]
   </devices>
   

   または、virsh attach-device を実行して、仮想マシン名とゲストの XML ファイルを指定します。

   virsh attach-device guest1-rhel7-64 file.xml

   注記

   PCI デバイスには、オプションの読み取り専用メモリー(ROM)モジュール （オプション ROM または拡張 ROM とも呼ばれる）が含まれており、デバイスのファームウェアやブートドライバー（PXE など）を配信することができます。通常、PCI デバイスの割り当てを使用して物理 PCI デバイスを仮想マシンに割り当てる際に、このオプション ROM も仮想化環境で機能します。

   ただし、オプション ROM は不要な場合があり、これにより仮想マシンが起動速度が遅くなったり、デバイスが提供するブート前のドライバーが仮想化と互換性のない可能性があります。これにより、ゲスト OS の起動が失敗する可能性があります。このような場合、Red Hat は、仮想マシンから ROM オプションをマスクさせることを推奨します。これを行うには、以下の手順を実施します。

   1. ホストで、割り当てるデバイスに BAR（拡張 ROM ベースアドレスレジスター）があることを確認します。これには、デバイスの lspci -v コマンドを使用して、以下を含む行の出力を確認します。

      Expansion ROM at

   2. <rom bar='off'/> 要素をゲストの XML 設定の <hostdev> 要素の子として追加します。

      <hostdev mode='subsystem' type='pci' managed='yes'>
        <source>
           <address domain='0' bus='0' slot='25' function='0'/>
        </source>
        <rom bar='off'/>
      </hostdev>
      

5. 仮想マシンの起動

   # virsh start guest1-rhel7-64

手順16.4 virt-manager でゲスト仮想マシンへの PCI デバイスの割り当て

1. ハードウェア設定を開く

   ゲスト仮想マシンを開き、ハードウェアの追加 ボタンをクリックして、新しいデバイスを仮想マシンに追加します。

   図16.3 仮想マシンのハードウェア情報ウィンドウ

   

2. PCI デバイスの選択

   左側のハードウェア一覧から PCI Host Device を選択します。
   未使用の PCI デバイスを選択します。別のゲストから現在使用されている PCI デバイスを選択すると、エラーが発生することに注意してください。この例では、予備のオーディオコントローラーを使用しています。Finish をクリックして設定を完了します。

   図16.4 Add new virtual hardware ウィザード

   

3. 新規デバイスの追加

   設定が完了し、ゲスト仮想マシンが PCI デバイスに直接アクセスできるようになりました。

   図16.5 仮想マシンのハードウェア情報ウィンドウ

   

手順16.5 virt-install で PCI デバイスの仮想マシンへの割り当て

1. デバイスの特定

   ゲスト仮想マシンへのデバイス割り当てに指定される PCI デバイスを特定します。

   # lspci | grep Ethernet
   00:19.0 Ethernet controller: Intel Corporation 82567LM-2 Gigabit Network Connection
   01:00.0 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)
   01:00.1 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)

   virsh nodedev-list コマンドは、システムに接続されているすべてのデバイスを一覧表示し、文字列とともに各 PCI デバイスを識別します。出力を PCI デバイスのみに制限するには、以下のコマンドを入力します。

   # virsh nodedev-list --cap pci
   pci_0000_00_00_0
   pci_0000_00_01_0
   pci_0000_00_03_0
   pci_0000_00_07_0
   pci_0000_00_10_0
   pci_0000_00_10_1
   pci_0000_00_14_0
   pci_0000_00_14_1
   pci_0000_00_14_2
   pci_0000_00_14_3
   pci_0000_00_19_0
   pci_0000_00_1a_0
   pci_0000_00_1a_1
   pci_0000_00_1a_2
   pci_0000_00_1a_7
   pci_0000_00_1b_0
   pci_0000_00_1c_0
   pci_0000_00_1c_1
   pci_0000_00_1c_4
   pci_0000_00_1d_0
   pci_0000_00_1d_1
   pci_0000_00_1d_2
   pci_0000_00_1d_7
   pci_0000_00_1e_0
   pci_0000_00_1f_0
   pci_0000_00_1f_2
   pci_0000_00_1f_3
   pci_0000_01_00_0
   pci_0000_01_00_1
   pci_0000_02_00_0
   pci_0000_02_00_1
   pci_0000_06_00_0
   pci_0000_07_02_0
   pci_0000_07_03_0

   PCI デバイス番号を記録します。この数字は他のステップで必要になります。
   ドメイン、バス、および機能に関する情報は、virsh nodedev-dumpxml コマンドの出力から確認できます。

   # virsh nodedev-dumpxml pci_0000_01_00_0

   図16.6 PCI デバイスファイルのコンテンツ

   
   <device>
     <name>pci_0000_01_00_0</name>
     <parent>pci_0000_00_01_0</parent>
     <driver>
       <name>igb</name>
     </driver>
     <capability type='pci'>
       <domain>0</domain>
       <bus>1</bus>
       <slot>0</slot>
       <function>0</function>
       <product id='0x10c9'>82576 Gigabit Network Connection</product>
       <vendor id='0x8086'>Intel Corporation</vendor>
       <iommuGroup number='7'>
         <address domain='0x0000' bus='0x00' slot='0x19' function='0x0'/>
       </iommuGroup>
     </capability>
   </device>
   

   注記

   IOMMU グループに複数のエンドポイントがあり、それらすべてがゲストに割り当てられていない場合は、ゲストを起動する前に以下のコマンドを実行して、ホストから他のエンドポイントを手動でデタッチする必要があります。

   $ virsh nodedev-detach pci_0000_00_19_1

   IOMMU 注記 「virsh を使用した PCI デバイスの割り当て」 を参照してください。

2. デバイスの追加

   virsh nodedev コマンドの出力を --host-device パラメーターの値として使用します。

   virt-install \
   --name=guest1-rhel7-64 \
   --disk path=/var/lib/libvirt/images/guest1-rhel7-64.img,size=8 \
   --vcpus=2 --ram=2048 \
   --location=http://example1.com/installation_tree/RHEL7.0-Server-x86_64/os \
   --nonetworks \
   --os-type=linux \
   --os-variant=rhel7
   --host-device=pci_0000_01_00_0

3. インストールを完了する

   ゲストインストールを完了します。PCI デバイスがゲストに接続されている。

手順16.6 virsh でゲストから PCI デバイスのデタッチ

1. デバイスの接続を解除します。

   ゲストの XML ファイルを削除して、以下のコマンドで PCI デバイスをゲストから切断します。

   # virsh detach-device name_of_guest file.xml

2. ホストへのデバイスの再接続（オプション）

   デバイスが managed モードの場合は、この手順を省略します。デバイスは、自動的にホストに戻ります。
   デバイスが managed モードを使用していない場合は、以下のコマンドを使用して PCI デバイスをホストマシンに再接続します。

   # virsh nodedev-reattach device

   たとえば、pci_0000_01_00_0 デバイスをホストに再アタッチするには、以下のコマンドを実行します。

   # virsh nodedev-reattach pci_0000_01_00_0

   デバイスがホストで利用できるようになりました。

手順16.7 virt-manager を使用した PCI デバイスのゲストからの接続解除

1. 仮想ハードウェアの詳細画面を開く

   virt-manager で、デバイスが含まれる仮想マシンをダブルクリックします。Show virtual hardware details ボタンを選択して、仮想ハードウェアの一覧を表示します。

   図16.7 仮想ハードウェアの詳細ボタン

   

2. デバイスの選択および削除

   左側パネルの仮想デバイスの一覧より、接続を解除する PCI デバイスを選択します。

   図16.8 デタッチする PCI デバイスの選択

   
   削除 ボタンをクリックして確定します。デバイスがホストで利用できるようになりました。

手順16.8 SR-IOV ネットワークデバイスをIntel または AMD システムに割り当てる

1. BIOS およびカーネルで Intel VT-d または AMD IOMMU 仕様を有効にする

   Intel システムで、BIOS で Intel VT-d を有効にしていない場合は有効にします。BIOS およびカーネルで Intel VT-d 手順16.1「PCI デバイス割り当て用の Intel システムの準備」 を参照してください。
   Intel VT-d がすでに有効で動作している場合は、この手順を省略します。
   AMD システムで、BIOS の AMD IOMMU 仕様がまだ有効にされていない場合は有効にします。手順16.2「PCI デバイス割り当て用の AMD システムの準備」 で IOMMU の有効化に関する手順を参照してください。

2. サポートの確認

   SR-IOV 機能のある PCI デバイスが検出されているかどうかを確認します。以下の例では、SR-IOV をサポートする Intel 82576 ネットワークインターフェースカードを一覧表示します。lspci コマンドを使用して、デバイスが検出されているかどうかを確認します。

   # lspci
   03:00.0 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)
   03:00.1 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)

   出力が変更され、他のすべてのデバイスが削除されることに注意してください。

3. 仮想機能をアクティブにします。

   以下のコマンドを実行します。

   # echo ${num_vfs} > /sys/class/net/enp14s0f0/device/sriov_numvfs

4. Virtual Function を永続化する

   リブート全体で Virtual Function を永続化するには、選択したエディターを使用して、以下のような udev ルールを作成します。ここで、ネットワークインターフェースカードでサポートされる VF の数（この例では ）を指定します。2以下の例では、enp14s0f0 を PF ネットワークデバイス名に、ENV{ID_NET_DRIVER} の値を、使用中のドライバーに合わせて調整します。

   # vim /etc/udev/rules.d/enp14s0f0.rules

   ACTION=="add", SUBSYSTEM=="net", ENV{ID_NET_DRIVER}=="ixgbe",
   ATTR{device/sriov_numvfs}="2"
   

   これにより、システムの起動時に機能が有効になります。

5. 新しい Virtual Function の検証

   lspci コマンドを使用して、Intel 82576 ネットワークデバイスに接続された、新しく追加した Virtual Function を一覧表示します。（代わりに grep を使用して Virtual Function を検索し、Virtual Function に対応するデバイスを検索します）。

   # lspci | grep 82576
   0b:00.0 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)
   0b:00.1 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)
   0b:10.0 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
   0b:10.1 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
   0b:10.2 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
   0b:10.3 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
   0b:10.4 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
   0b:10.5 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
   0b:10.6 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
   0b:10.7 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
   0b:11.0 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
   0b:11.1 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
   0b:11.2 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
   0b:11.3 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
   0b:11.4 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
   0b:11.5 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)

   PCI デバイスの識別子は、lspci コマンドの -n パラメーターと共に確認することができます。Physical Function は、0b:00.0 および 0b:00.1 に対応します。この説明では、すべての Virtual Function の Virtual Function があります。

6. virsh でデバイスが存在することを確認します。

   libvirt サービスは、デバイスを仮想マシンに追加する前にデバイスを認識する必要があります。libvirt は、lspci の出力と同様の表記を使用します。 lspci の出力では、すべての句読点はアンダースコア(_)に変更されます。
   virsh nodedev-list コマンドおよび grep コマンドを使用して、利用可能なホストデバイスの一覧から Intel 82576 ネットワークデバイスをフィルタリングします。0b この例の Intel 82576 ネットワークデバイスのフィルターです。これはシステムによって異なる場合があります。これにより、デバイスが追加されます。

   # virsh nodedev-list | grep 0b
   pci_0000_0b_00_0
   pci_0000_0b_00_1
   pci_0000_0b_10_0
   pci_0000_0b_10_1
   pci_0000_0b_10_2
   pci_0000_0b_10_3
   pci_0000_0b_10_4
   pci_0000_0b_10_5
   pci_0000_0b_10_6
   pci_0000_0b_11_7
   pci_0000_0b_11_1
   pci_0000_0b_11_2
   pci_0000_0b_11_3
   pci_0000_0b_11_4
   pci_0000_0b_11_5

   Virtual Function および Physical Function の PCI アドレスは、一覧にする必要があります。

7. virsh でデバイスの詳細を取得

   pci_0000_0b_00_0 は Physical Function の 1 つであり、pci_0000_0b_10_0 はその Physical Function 向けに最初に対応する Virtual Function です。virsh nodedev-dumpxml コマンドを使用して、両方のデバイスのデバイス情報を取得します。

   # virsh nodedev-dumpxml pci_0000_03_00_0
   <device>
     <name>pci_0000_03_00_0</name>
     <path>/sys/devices/pci0000:00/0000:00:01.0/0000:03:00.0</path>
     <parent>pci_0000_00_01_0</parent>
     <driver>
       <name>igb</name>
     </driver>
     <capability type='pci'>
       <domain>0</domain>
       <bus>3</bus>
       <slot>0</slot>
       <function>0</function>
       <product id='0x10c9'>82576 Gigabit Network Connection</product>
       <vendor id='0x8086'>Intel Corporation</vendor>
       <capability type='virt_functions'>
         <address domain='0x0000' bus='0x03' slot='0x10' function='0x0'/>
         <address domain='0x0000' bus='0x03' slot='0x10' function='0x2'/>
         <address domain='0x0000' bus='0x03' slot='0x10' function='0x4'/>
         <address domain='0x0000' bus='0x03' slot='0x10' function='0x6'/>
         <address domain='0x0000' bus='0x03' slot='0x11' function='0x0'/>
         <address domain='0x0000' bus='0x03' slot='0x11' function='0x2'/>
         <address domain='0x0000' bus='0x03' slot='0x11' function='0x4'/>
       </capability>
       <iommuGroup number='14'>
         <address domain='0x0000' bus='0x03' slot='0x00' function='0x0'/>
         <address domain='0x0000' bus='0x03' slot='0x00' function='0x1'/>
       </iommuGroup>
     </capability>
   </device>

   # virsh nodedev-dumpxml pci_0000_03_11_5
   <device>
     <name>pci_0000_03_11_5</name>
     <path>/sys/devices/pci0000:00/0000:00:01.0/0000:03:11.5</path>
     <parent>pci_0000_00_01_0</parent>
     <driver>
       <name>igbvf</name>
     </driver>
     <capability type='pci'>
       <domain>0</domain>
       <bus>3</bus>
       <slot>17</slot>
       <function>5</function>
       <product id='0x10ca'>82576 Virtual Function</product>
       <vendor id='0x8086'>Intel Corporation</vendor>
       <capability type='phys_function'>
         <address domain='0x0000' bus='0x03' slot='0x00' function='0x1'/>
       </capability>
       <iommuGroup number='35'>
         <address domain='0x0000' bus='0x03' slot='0x11' function='0x5'/>
       </iommuGroup>
     </capability>
   </device>

   この例では、ステップ 8 の仮想マシンに Virtual Function pci_0000_03_10_2 を追加します。Virtual Function の bus、slot、および function のパラメーターに注意してください。これらは、デバイスを追加するために必要です。
   これらのパラメーターを、/tmp/new-interface.xml などの一時的な XML ファイルにコピーします。以下に例を示します。

      <interface type='hostdev' managed='yes'>
        <source>
          <address type='pci' domain='0x0000' bus='0x03' slot='0x10' function='0x2'/>
        </source>
      </interface>

   注記

   仮想マシンが起動すると、設定された MAC アドレスで、物理アダプターが提供するタイプのネットワークデバイスが表示されるはずです。この MAC アドレスは、ホストおよびゲストの再起動時に変更されません。

   以下の <interface> の例は、オプションの <mac address>、<virtualport>、および <vlan> 要素の構文を示しています。実際には、<vlan> または <virtualport> 要素のいずれかを使用しますが、この例では両方を同時に使用することはできません。

   ...
    <devices>
      ...
      <interface type='hostdev' managed='yes'>
        <source>
          <address type='pci' domain='0' bus='11' slot='16' function='0'/>
        </source>
        <mac address='52:54:00:6d:90:02'>
        <vlan>
           <tag id='42'/>
        </vlan>
        <virtualport type='802.1Qbh'>
          <parameters profileid='finance'/>
        </virtualport>
      </interface>
      ...
    </devices>

   MAC アドレスを指定しない場合、これは自動的に生成されます。<virtualport> 要素は、802.11Qbh ハードウェアスイッチに接続する場合にのみ使用されます。<vlan> 要素は、ゲストのデバイスを VLAN タグが 42 に透過的に設定します。

8. 仮想マシンへの Virtual Function の追加

   直前の手順で作成した一時ファイルで以下のコマンドを使用して、Virtual Function を仮想マシンに追加します。これにより、新規デバイスが直ちにアタッチされ、その後のゲスト再起動が保存されます。

   virsh attach-device MyGuest /tmp/new-interface.xml --live --config
   

   virsh attach-device で --live オプションを指定すると、新しいデバイスを実行中のゲストにアタッチします。--config オプションを使用すると、ゲストを今後再起動した後に新しいデバイスが利用できるようになります。
   注記

   --live オプションは、ゲストが実行している場合にのみ許可されます。実行中ゲストで --live オプションを使用する場合は、virsh によりエラーが返されます。