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

1. オプション: 準備

   仮想マシン用のストレージ環境を用意します。ストレージの準備に関する詳細は、13章仮想マシンのストレージ管理 を参照してください。

   重要

   ゲスト仮想マシンの保存には、様々な種類のストレージを使用することができます。しかし、仮想マシンで移行機能を使用できるようにするには、ネットワーク接続されたストレージ上に仮想マシンを作成する必要があります。
   Red Hat Enterprise Linux 7 には、少なくとも 1GB のストレージ領域が必要です。しかし Red Hat は、Red Hat Enterprise Linux 7 のインストールと本ガイドの手順で 5GB 以上のストレージ領域を使用することを推奨しています。

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

   virt-manager を開くには、root で virt-manager コマンドを実行するか、または アプリケーション → システムツール → 仮想マシンマネージャー を開きます。
   

   図3.1 仮想マシンマネージャーのウィンドウ

   オプションとして、ハイパーバイザーを選択し、接続 (Connect) ボタンをクリックしてリモートハイパーバイザーを開きます。
   をクリックして、新規の仮想化ゲストウィザードを開始します。
   新しい仮想マシン ウィンドウが開きます。

3. インストール方法を指定します。

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

   ローカルのインストールメディア (ISO イメージまたは CD-ROM ドライブ)

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

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

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

   ネットワークインストール を選択する場合には、インストール URL およびカーネルオプション (必要な場合) を指定します。

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

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

   ネットワークブート を選択する場合は、ステップ 5 に進みます。すべてのステップが完了すると DHCP 要求は送信され、有効な PXE サーバーが見つかる場合はゲスト仮想マシンのインストールプロセスが開始します。

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

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

   

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

   進む をクリックして先に進みます。

4. インストールソースを選択します。

   1. ローカルのインストールメディア (ISO イメージまたは CD-ROM ドライブ) を選択した場合、目的のローカルインストールメディアを指定します。
      

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

      警告

      現在 GUI にオプションが表示されていますが、ホスト上の物理 CD-ROM または DVD デバイスからインストールすることはできません。そのため、Use CDROM or DVD オプションを選択すると、仮想マシンのインストールは失敗します。詳細は、Red Hat ナレッジベース を参照してください。
      ISO イメージからインストールするには、ISO イメージを使用 を選択し、参照... ボタンをクリックして ISO メディアボリュームの検索 ウィンドウを開きます。
      使用するインストールイメージを選択し、ボリュームの選択 をクリックします。
      ISO メディアボリュームの検索 ウィンドウにイメージが表示されない場合、ローカルを参照 ボタンをクリックしてホストマシンにあるインストールイメージまたはインストールディスクのある DVD ドライブを参照します。インストールイメージまたはインストールディスクのある DVD ドライブを選択して 開く をクリックします。使用するボリュームが選択され、新しい仮想マシンを作成 ウィザードに戻ります。

      重要

      ISO イメージファイルまたはゲストストレージファイルの推奨される場所は、/var/lib/libvirt/images/ です。それ以外の場所を指定する場合、SELinux による追加の設定が必要になる可能性があります。SELinux の設定に関する詳細は、『Red Hat Enterprise Linux 7 仮想化セキュリティーガイド』または『Red Hat Enterprise Linux 7 SELinux ユーザーおよび管理者のガイド』を参照してください。
   2. Network Install を選択した場合には、インストールソースの URL および希望するカーネルオプション (必要な場合) を入力します。URL は、インストールツリーのルートディレクトリーをポイントしている必要があります。また、インストールツリーには、HTTP、FTP、または NFS のいずれかでアクセスできる必要があります。
      キックスタートインストールを実施するには、カーネルのオプション でキックスタートファイルの URL を指定します (ks= で始めます)。
      

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

      注記

      カーネルオプションの全リストは、『Red Hat Enterprise Linux 7 インストールガイド』を参照してください。
   次に、インストールする OS の種類 と バージョン を選びます。仮想マシンに適したオペレーティングシステムの種類を選択することを確認してください。これは、インストールメディアに応じて、仮想マシン内の OS の種類を自動判別する (Automatically detect operating system based on install media) チェックボックスを選択して手動で指定することができます。
   進む をクリックして先に進みます。

5. メモリー (RAM) および 仮想 CPU を設定します。

   仮想マシンに割り当てる CPU の数とメモリー (RAM) の容量を設定します。ウィザードでは、割り当て可能な CPU の数とメモリー量が表示されます。これらの値はホストとゲストのパフォーマンスに影響を与えます。
   仮想マシンの効率的かつ効果的な実行には、十分な物理メモリー (RAM) が必要です。Red Hat は、仮想マシンの最小 512MB の RAM をサポートします。1 論理コアあたりでは最小 1024MB の RAM を推奨します。
   十分な数の仮想 CPU を仮想マシンに割り当てます。仮想マシンがマルチスレッドアプリケーションを実行する場合は、ゲスト仮想マシンの効果的な実行に必要な数の仮想 CPU を割り当てます。
   ホストシステムで利用可能な物理プロセッサー (またはハイパースレッド) よりも多くの仮想 CPU を割り当てることはできません。利用可能な仮想 CPU 数は、X 個まで使用できます フィールドに表示されます。
   

   図3.5 メモリーと CPU の設定

   メモリーと CPU の設定を行った後に、進む をクリックして次に進みます。

   注記

   メモリーと仮想 CPU はオーバーコミットすることができます。オーバーコミットに関する詳細は、7章KVM でのオーバーコミット を参照してください。

6. ストレージを設定します。

   仮想マシンと必要とされるアプリケーションに十分な領域を有効にし、その割り当てを実行します。デスクトップインストールの場合は少なくとも 5GB を割り当て、最小インストールの場合は少なくとも 1GB を割り当てます。
   

   図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 ディスクを使用すると、スケーラビリティーや最大サイズに影響を与える可能性のある層の数が少なくなります。
      進む をクリックしてローカルのハードドライブにディスクイメージを作成します。または、管理しているストレージか、他の既存のストレージを選択する を選択してから 参照 を選択し、管理しているストレージを設定します。

   2. ストレージプールの使用

      ストレージプールの使用に 管理しているストレージか、他の既存のストレージを選択する を選択し、参照 をクリックすると、ストレージボリュームの検索または作成 ウィンドウが開きます。
      

      図3.7 「ストレージボリュームの選択」ウィンドウ

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

         図3.8 「ストレージボリュームを作成 (Add a Storage Volume)」ウィンドウ

   新規ボリュームを選択し、ボリュームの選択 をクリックします。次に、完了 をクリックして 新しい仮想マシン ウィザードに戻ります。進む をクリックして次に進みます。

7. 名前を付けて最終設定を行います。

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

   図3.9 設定の確認

   または、仮想マシンのハードウェアをさらに設定する場合は、インストールの前に設定をカスタマイズする チェックボックスにチェックを入れます。これによりゲストのストレージまたはネットワークデバイスの変更や、準仮想化 (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 (TCP/IP の設定)」インターフェースを開きます。

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

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

1. virt-manager を開きます。

   virt-manager を開始します。アプリケーション メニューを開き、システムツール サブメニューから 仮想マシンマネージャー アプリケーションを起動します。または、root で virt-manager コマンドを実行します。
   Virtual Machine Manager のゲスト仮想マシンの一覧からクローン作成するゲスト仮想マシンを選択します。
   クローン作成するゲスト仮想マシンを右クリックして、クローン を選択します。「仮想マシンのクローンを作成」ウィンドウが開きます。
   

   図4.1 「仮想マシンのクローンを作成」ウィンドウ

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

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

     図4.2 「MAC アドレスを変更」ウィンドウ

   • クローン作成されたゲスト仮想マシンのそれぞれのディスクについて、以下のオプションのいずれかを選択します。
     • Clone this disk - ディスクのクローンはクローン作成されたゲスト仮想マシンから作成されます。
     • Share disk with guest virtual machine name - ディスクは、クローン作成されるゲスト仮想マシンとそのクローンによって共有されます。
     • Details - 「ストレージパスを変更」ウィンドウが開きます。ここからディスクの新規パスを選択できます。
       

       図4.3 「storage pathを変更」ウィンドウ

3. ゲスト仮想マシンのクローンを作成します。

   クローン をクリックします。

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

1. virt-manager メインメニューから、編集 ⇒ 接続の詳細 をクリックして 接続の詳細 ウィンドウを開きます。
2. ネットワークインターフェース タブをクリックします。
3. ウィンドウの下部にある + をクリックして、新規ネットワークインターフェースを設定します。
4. インターフェースの種類 ドロップダウンメニューで、Bridge を選択してから 進む をクリックして継続します。
   

   図6.1 ブリッジの追加

5. 1. 名前 フィールドに、br0 などのブリッジの名前を入力します。
   2. ドロップダウンメニューから 開始モード を選択します。以下のいずれかから選択します。
      • none - ブリッジを非アクティブ化します。
      • onboot - 次回のゲスト仮想マシンの再起動時にブリッジをアクティブ化します。
      • hotplug - ゲスト仮想マシンが実行中の場合でもブリッジをアクティブ化します。
   3. 今すぐ有効に チェックボックスにチェックを入れ、ブリッジをただちにアクティブにします。
   4. IP の設定 または ブリッジの設定 のいずれかを設定するには、該当する 設定 ボタンをクリックします。別のウィンドウが開き、ここで必要な設定を指定することができます。必要な変更を加えてから OK をクリックします。
   5. 仮想マシンに接続する物理インターフェースを選択します。インターフェースが別のゲスト仮想マシンで使用されている場合には、警告メッセージが送信されます。
6. 完了 をクリックするとウィザードが閉じます。これにより、Connections (接続) メニューに戻ります。
   

   図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 ゲスト設定ファイルの <boot dev='network'/> 要素内に <os> 要素があることを確認します。

   <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. SPICE エージェントチャンネルをゲスト XML 設定に追加します。

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

   # 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 エージェントを仮想マシンに割り当てます。

   以下のコマンドを実行して、SPICE エージェントを実行中の仮想マシン (この例では rhel7) に割り当てます。

   # 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 エージェントチャンネルをゲストに追加します。

   ゲストウインドウの上部にある電球アイコンをクリックして仮想マシンのハードウェアの詳細画面を開きます。
   ハードウェアを追加 ボタンをクリックして 新しい仮想ハードウェアを追加 ウインドウを開き、チャンネル を選択します。
   名前 ドロップダウンリストから SPICE エージェントを選択し、チャンネルアドレスを編集して 完了 をクリックします。
   

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

3. 仮想マシンを起動します。

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

4. ゲストに SPICE エージェントをインストールします。

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

   # yum install spice-vdagent

5. ゲスト内の SPICE エージェントを起動します。

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

   # systemctl start spice-vdagent

1. 手順15.1「libvirtd.conf の設定」 の手順に従って 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 パラメーターの設定値を変更します。この 2 つのパラメーターの値は同一にすることをお勧めします。max_clients は移行ごと 2 つのクライアントを使用し (移行元と移行先で 1 つずつ)、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 で認証前の状態が許可されるのは 10 セッションのみです。この設定は sshd 設定ファイル内の MaxStartups パラメーターで制御されます (/etc/ssh/sshd_config 内)。場合によっては、このパラメーターを調整する必要があります。DoS 攻撃 (また一般的にはリソースの過剰使用) を防ぐ目的でこの制限が設けられているため、このパラメーターを調整するには注意が必要です。値を高く設定しすぎると、当初の目的を達成することができなくなります。このパラメーターを変更するには、/etc/ssh/sshd_config を編集して MaxStartups 行の先頭にある # を削除し、10 (デフォルト値) をより大きな値に変更します。その後は必ずファイルを保存して sshd サービスを再起動してください。詳細は、sshd_config の man ページを参照してください。

手順16.3 virsh を使用した PCI デバイスのゲスト仮想マシンへの割り当て

1. デバイスを特定します。

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

   # 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 コマンドの出力を参照してください。

   
   # 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>
   

   図16.1 内容のダンプ

   注記

   IOMMU グループは、IOMMU から見たデバイスの可視性と分離度に基づいて決定されます。それぞれの IOMMU グループには、1 つ以上のデバイスが含まれる可能性があります。複数のデバイスが表示される場合、すべてのエンドポイントが、ゲストに割り当てられるIOMMU グループ内のすべてのデバイスに対して要求される必要があります。これは、追加のエンドポイントをゲストに割り当てるか、または virsh nodedev-detach を使用してエンドポイントをホストドライバーから分離するかのいずれかの方法で実行できます。単一グループに含まれるデバイスは、複数のゲスト間で分割したり、ホストとゲストの間で分割したりすることができないことがあります。PCIe ルートポート、スイッチポート、およびブリッジなどエンドポイント以外のデバイスはホストドライバーから分離することはできません。これらはエンドポイントの割り当てを妨げることはありません。

   IOMMU グループ内のデバイスは、virsh nodedev-dumpxml 出力の iommuGroup セクションを使用して判別できます。グループの各メンバーは別個の「アドレス」フィールドで指定されます。この情報は、以下を使用して 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 進法の設定では、これらの値を使用します。

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

4. 設定の詳細を追加します。

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

   # virsh edit guest1-rhel7-64

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

   図16.2 PCI デバイスの追加

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

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

   注記

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

   ただし、場合によっては、オプション ROM が不要になり、仮想マシンの起動が遅くなる可能性があります。または、デバイスが提供するプリブートドライバーが仮想化と互換性がなく、ゲスト OS が起動できなくなる場合があります。そのような場合、Red Hat は仮想マシンのオプション ROM をマスクすることを推奨します。これには、以下を行います。

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

      拡張 ROM

   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 デバイスを選択するとエラーが発生するので注意してください。以下の例では、予備のオーディオコントローラーが使用されます。完了 をクリックしてセットアップを終了します。
   

   図16.4 新しい仮想ハードウェアを追加ウィザード

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

   
   <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>
   

   図16.6 PCI デバイスファイルの内容

   注記

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

   $ virsh nodedev-detach pci_0000_00_19_1

   IOMMU グループの詳細は、「virsh を使用した PCI デバイスの割り当て」の 注記 を参照してください。

2. デバイスを追加します。

   virsh nodedev コマンドの PCI 識別子の出力を --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 デバイスを削除することで、ゲストから 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 で、デバイスを含む仮想マシンをダブルクリックします。仮想マシンの情報を表示 ボタンを選択し、仮想ハードウェアの一覧を表示します。
   

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

2. デバイスを選択し、削除します。

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

   図16.8 接続解除する PCI デバイスの選択

   削除 ボタンをクリックします。これでデバイスがホストで使用可能になります。

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

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

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

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. 仮想機能を永続化します。

   再起動後も仮想機能を存続させるためには、任意のエディターを使って以下のような 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. 新たな仮想機能を検査します。

   lspci コマンドを使用して、Intel 82576 ネットワークデバイスに割り当てられ、新たに追加された仮想機能を一覧表示します。(または、grep を使って 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 デバイスの ID は、-n コマンドの lspci パラメーターを使って確認します。物理機能は、0b:00.0 および 0b:00.1 に対応します。仮想機能にはすべて 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

   この一覧には、仮想機能と物理機能の PCI アドレスが表示されます。

7. virsh を使用してデバイスの詳細情報を取得します。

   pci_0000_0b_00_0 は物理機能の 1 つであり、pci_0000_0b_10_0 はこの物理機能に対応する最初の仮想機能です。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>

   この例では、仮想機能 pci_0000_03_10_2 をステップ 8 の仮想マシンに追加します。仮想機能の 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> 要素は、ゲストのデバイスを 42 とタグ付けされた VLAN に透過的に配置します。

8. 仮想機能を仮想マシンに追加します。

   直前のステップで作成された一時ファイルで以下のコマンドを使用して、仮想機能を仮想マシンに追加します。これで新規デバイスは即時に割り当てられ、これ以降のゲストの再起動に備えて保存されます。

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

   --live で virsh attach-device を指定することで、新規デバイスを実行中のゲストに割り当てます。--config オプションを使うと、これ以降のゲストの再起動後も新規デバイスが確実に利用可能となります。

   注記

   --live オプションはゲストが実行中の場合にのみ受け入れられます。virsh オプションが実行中ではないゲストで使用されると、--live はエラーを返します。