1. 手順5.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 = 20
   
   
   # 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 worker、移行先で 0 worker を使用し、終了フェーズでは移行先で 1 worker を使用します。

   重要

   max_clients と max_workers のパラメーター設定値は、全ゲスト仮想マシンの libvirtd サービスへの接続により生じます。つまり、同じゲスト仮想マシンを使用し、同時に移行を行なっているユーザーはすべて max_clients と max_workers パラメーターに設定された制限値に影響を受けます。このため、同時ライブマイグレーションを行なう際は、まず最大値を注意深く検討する必要があります。
4. ファイルを保存してサービスを再起動します。

   注記

   移行中に接続が中断される場合がありますが、これは開始後に認証が行なわれていない SSH セッションが多すぎる場合に発生します。デフォルトでは、sshd で認証前の状態が許可されるのは 10 セッションのみです。この設定は sshd 設定ファイル (/etc/ssh/sshd_config) 内の MaxStartups パラメーターで制御されています。このパラメーターは調整する必要がある場合があります。DoS 攻撃 (リソースの過剰な消費) などを防ぐ目的でこの制限が設けられているため、このパラメーターを調整する際は注意が必要です。この値を高く設定しすぎると、当初の目的が意味がなくなってしまいます。パラメーターを変更する場合は、/etc/ssh/sshd_config を編集して MaxStartups 行の先頭にある # を削除し、 10 (デフォルト値) の値をさらに大きな数値に変更します。ファイルを保存して sshd サービスを再起動するのを忘れないようにしてください。詳細は、sshd_config の man ページを参照してください。

手順10.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>

   注記

   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-rhel6-64
   <hostdev mode='subsystem' type='pci' managed='yes'>
     <source>
        <address domain='0' bus='0' slot='25' function='0'/>
     </source>
   </hostdev>

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

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

5. 仮想マシンの開始

   # virsh start guest1-rhel6-64

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

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

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

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

2. PCI デバイスの選択

   左側の ハードウェア リストから PCI Host Device を選択します。
   未使用の PCI デバイスを選択します。別のゲストが使用している PCI デバイスを選択する場合、エラーが発生する可能性があります。以下の例では、予備の 82576 ネットワークデバイスが使用されます。完了 をクリックしてセットアップを終了します。
   

   図10.2 新たな仮想ハードウェア追加ウィザード

3. 新規デバイスの追加

   セットアップが完了し、ゲスト仮想マシンはこれで PCI デバイスに直接アクセスできます。
   

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

手順10.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>

   注記

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

   $ virsh nodedev-detach pci_0000_00_19_1

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

2. デバイスの追加

   virsh nodedev コマンドからの PCI 識別子の出力を --host-device パラメーターの値として使います。

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

3. インストールの完了

   これでゲストインストールが完了しました。PCI デバイスはゲストに割り当てられています。

手順10.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

   これでこのデバイスはホストで使用できます。

手順10.7 virt-manager を使用した PCI デバイスのゲストからの切り離し

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

   virt-manager で、対象のデバイスを含む仮想マシンをダブルクリックします。仮想ハードウェアの詳細表示 ボタンを選択し、仮想ハードウェアのリストを表示させます。
   

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

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

   左パネルの仮想デバイスリストから切り離す PCI デバイスを選択します。
   

   図10.5 切り離す PCI デバイスの選択

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

手順10.8 SR-IOV での PCI デバイス割り当てのための MAC アドレス、vLAN、および仮想ポートの設定

1. ゲスト仮想マシンをシャットダウンします。

   virsh shutdown コマンド (「ゲスト仮想マシンのシャットダウン」 を参照) を使用して、guestVM という名前のゲスト仮想マシンをシャットダウンします。

   # virsh shutdown guestVM

2. 情報を収集します。

   <interface type='hostdev'> を使用するには、SR-IOV 対応ネットワークカード、また Intel VT-d または AMD IOMMU 拡張のいずれかをサポートするホスト物理マシンハードウェアが必要であり、割り当てる VF の PCI アドレスを知っておく必要があります。

3. XML ファイルを開いて編集します。

   編集する XML ファイルを開くには、# virsh save-image-edit コマンドを実行します (詳細は、「ドメイン XML 設定ファイルの編集」 を参照してください)。ゲスト仮想マシンを以前の実行状態に戻したい場合は、--running を使用できます。この例の設定ファイルの名前は、ゲスト仮想マシンの名前が guestVM なので guestVM.xml になります。

    # virsh save-image-edit guestVM.xml --running 

   ユーザーのデフォルトエディターで guestVM.xml が開かれます。

4. XML ファイルを編集します。

   以下のような <devices> エントリーを持たせるように設定ファイル (guestVM.xml) を更新します。

   
    <devices>
      ...
      <interface type='hostdev' managed='yes'>
        <source>
          <address type='pci' domain='0x0' bus='0x00' slot='0x07' function='0x0'/> <!--these values can be decimal as well-->
        </source>
        <mac address='52:54:00:6d:90:02'/>                                         <!--sets the mac address-->
        <virtualport type='802.1Qbh'>                                              <!--sets the virtual port for the 802.1Qbh switch-->
          <parameters profileid='finance'/>
        </virtualport>
        <vlan>                                                                     <!--sets the vlan tag-->
         <tag id='42'/>
        </vlan>
      </interface>
      ...
    </devices>

   図10.7 hostdev interface type のドメイン XML のサンプル

   MAC アドレスを指定しない場合、それ以外のタイプのインターフェースデバイスと同様に、そのアドレスは自動的に生成されます。さらに、<virtualport> 要素は、802.11Qgh ハードウェアスイッチ (802.11Qbg (別名「VEPA」) に接続される場合にのみ使用されます。これらのスイッチは現在サポートされていません。

5. ゲスト仮想マシンを再起動します。

   最初のステップでシャットダウンしたゲスト仮想マシンを再開するために virsh start コマンドを実行します (例では、ゲスト仮想マシンのドメイン名として guestVM を使用しています)。詳細は、「定義されたドメインの起動」 を参照してください。

    # virsh start guestVM 

   ゲスト仮想マシンが起動すると、設定済みの MAC アドレスと共に、物理ホストマシンのアダプターによって指定されたネットワークデバイスが表示されます。この MAC アドレスは、ゲスト仮想マシンと物理ホストマシンの起動時に変更されることはありません。

手順10.9 デバイスプールの作成

1. ゲスト仮想マシンをシャットダウンします。

   virsh shutdown コマンド (「ゲスト仮想マシンのシャットダウン、再起動および強制終了」 を参照) を使用して、guestVM という名前のゲスト仮想マシンをシャットダウンします。

   # virsh shutdown guestVM

2. 設定ファイルの作成

   任意のエディターを使用して、/tmp ディレクトリーに XML ファイル (例:passthrough.xml という名前のファイル) を作成します。pf dev='eth3' は、各自の SR-IOV デバイスの物理機能 (PF) に置き換えるようにしてください。
   以下は、物理機能 (PF) がホスト物理マシンの「eth3」に設定された、SR-IOV アダプターのすべての VF のプールを利用可能にするネットワーク定義のサンプルです。

               
   <network>
      <name>passthrough</name>                                                <!--This is the name of the file you created-->
      <forward mode='hostdev' managed='yes'>
        <pf dev='myNetDevName'/>                                              <!--Use the netdev name of your SR-IOV devices PF here-->
      </forward>
   </network>
   

   図10.8 ネットワーク定義ドメインの サンプル XML

3. 新しい XML ファイルをロードします。

   /tmp/passthrough.xml を直前のステップで作成した XML ファイルの名前と場所に置き換え、以下のコマンドを実行します。

   # virsh net-define /tmp/passthrough.xml

4. ゲストの再起動

   passthrough.xml を直前のステップで作成した XML ファイルの名前に置き換え、以下を実行します。

    # virsh net-autostart passthrough # virsh net-start passthrough 

5. ゲスト仮想マシンを再起動します。

   最初のステップでシャットダウンしたゲスト仮想マシンを再開するために virsh start コマンドを実行します (例では、ゲスト仮想マシンのドメイン名として guestVM を使用しています)。詳細は、「定義されたドメインの起動」 を参照してください。

    # virsh start guestVM 

6. デバイスのパススルーの開始

   単一デバイスのみが表示されていますが、libvirt は、ゲスト仮想マシンの初回起動時に、PF に関連付けられたすべての VF の一覧を自動的に派生させます。この起動には、以下のようなドメイン XML 内のインターフェース定義が使用されます。

            
   <interface type='network'>
      <source network='passthrough'>
   </interface>
   

   図10.9 インターフェースネットワーク定義のサンプルドメイン XML

7. 検証

   検証は、ネットワークを使用する最初のゲストの起動後に virsh net-dumpxml passthrough コマンドで実行できます。以下のような出力が得られます。

         
   <network connections='1'>
      <name>passthrough</name>
      <uuid>a6b49429-d353-d7ad-3185-4451cc786437</uuid>
      <forward mode='hostdev' managed='yes'>
        <pf dev='eth3'/>
        <address type='pci' domain='0x0000' bus='0x02' slot='0x10' function='0x1'/>
        <address type='pci' domain='0x0000' bus='0x02' slot='0x10' function='0x3'/>
        <address type='pci' domain='0x0000' bus='0x02' slot='0x10' function='0x5'/>
        <address type='pci' domain='0x0000' bus='0x02' slot='0x10' function='0x7'/>
        <address type='pci' domain='0x0000' bus='0x02' slot='0x11' function='0x1'/>
        <address type='pci' domain='0x0000' bus='0x02' slot='0x11' function='0x3'/>
        <address type='pci' domain='0x0000' bus='0x02' slot='0x11' function='0x5'/>
      </forward>
   </network>
   

   図10.10 XML ダンプファイル passthrough の内容

手順11.1 ゲストエージェントとホスト間の通信設定

1. ゲスト XML を開きます

   QEMU ゲストエージェント設定でゲスト XML を開きます。ファイルを開くにはゲスト名が必要になります。認識可能なゲストを一覧表示するには、ホスト物理マシン上でコマンド # virsh list を実行します。この例では、ゲスト名は rhel6 になります。

   # virsh edit rhel6

2. ゲスト XML ファイルを編集します

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

   <channel type='unix'>
      <source mode='bind' path='/var/lib/libvirt/qemu/rhel6.agent'/>
      <target type='virtio' name='org.qemu.guest_agent.0'/>
   </channel>

   図11.1 QEMU ゲストエージェント設定のためのゲスト XML の編集

3. ゲスト内の QEMU ゲストエージェントを起動します

   まだ実行していない場合は、yum install qemu-guest-agent を使用してゲスト仮想マシン内にゲストエージェントをダウンロードし、これをインストールします。いったんインストールしたら、以下のようにサービスを開始します。

   # service start qemu-guest-agent

1. ディスク上で GPT ディスクラベルを作成する

   ディスクには、GPT (GUID Partition Table) ディスクラベルによる再ラベル付けが必要になります。GPT ディスクラベルの使用により、各デバイス上に最大 128 個の大量のパーティションを作成することができます。MS-DOS パーティションテーブルに比べ、GPT のパーティションテーブルはより多くのパーティションでパーティションデータを格納することができます。

   # parted /dev/sdb
   GNU Parted 2.1
   Using /dev/sdb
   Welcome to GNU Parted! Type 'help' to view a list of commands.
   (parted) mklabel                                                          
   New disk label type? gpt                                                  
   (parted) quit                                                             
   Information: You may need to update /etc/fstab.                           
   #

2. ストレージプールの設定ファイルを作成する

   新規デバイスに必要となるストレージプール情報が含まれた一時 XML テキストファイルを作成します。
   このファイルは、以下のような形式にし、また以下のフィールドを含める必要があります。

   <name>guest_images_disk</name>

   name パラメーターでストレージプールの名前を指定します。この例では、guest_images_disk という名前を使用しています。

   <device path='/dev/sdb'/>

   path 属性を持つ device パラメーターは、ストレージデバイスのデバイスパスを指定します。この例では、デバイス /dev/sdb を使用しています。

   <target> <path>/dev</path></target>

   path サブパラメーターを持つファイルシステム target パラメーターは、ホスト物理ファイルシステム上の位置を判別して、このストレージプールで作成されたボリュームを追加します。

   たとえば sdb1、 sdb2、 sdb3 などです。この例のように /dev/ を使用すると、このストレージプールから作成したボリュームは /dev/sdb1、/dev/sdb2、/dev/sdb3 としてアクセスできることになります。

   <format type='gpt'/>

   format パラメーターは、パーティションテーブルのタイプを指定します。この例では、前述のステップで作成した GPT ディスクラベルのタイプと一致するよう gpt を使用しています。

   テキストエディターでストレージプールデバイス用の XML ファイルを作成します。

   例13.2 ディスクベースのストレージデバイスのストレージプール

   <pool type='disk'>
     <name>guest_images_disk</name>
     <source>
       <device path='/dev/sdb'/>
       <format type='gpt'/>
     </source>
     <target>
       <path>/dev</path>
     </target>
   </pool>

3. デバイスを割り当てる

   前述のステップで作成した XML 設定ファイルで virsh pool-define コマンドを使用しストレージプールの定義を追加します。

   # virsh pool-define ~/guest_images_disk.xml
   Pool guest_images_disk defined from /root/guest_images_disk.xml
   # virsh pool-list --all
   Name                 State      Autostart 
   -----------------------------------------
   default              active     yes       
   guest_images_disk    inactive   no

4. ストレージプールを起動する

   virsh pool-start コマンドを使用してストレージプールを起動します。virsh pool-list --all コマンドを使用すると、プールが起動したかどうかを確認できます。

   # virsh pool-start guest_images_disk
   Pool guest_images_disk started
   # virsh pool-list --all
   Name                 State      Autostart 
   -----------------------------------------
   default              active     yes       
   guest_images_disk    active     no

5. autostart をオンにする

   ストレージプールの autostart をオンにします。autostart は、サービスが開始するとストレージプールも起動するように libvirtd サービスを設定します。

   # virsh pool-autostart guest_images_disk
   Pool guest_images_disk marked as autostarted
   # virsh pool-list --all
   Name                 State      Autostart 
   -----------------------------------------
   default              active     yes       
   guest_images_disk    active     yes

6. ストレージプールの設定を確認する

   ストレージプールが正しく作成されたこと、サイズが正しく報告されたこと、および状態が running として報告されていることを確認します。

   # virsh pool-info guest_images_disk
   Name:           guest_images_disk
   UUID:           551a67c8-5f2a-012c-3844-df29b167431c
   State:          running
   Capacity:       465.76 GB
   Allocation:     0.00 
   Available:      465.76 GB
   # ls -la /dev/sdb
   brw-rw----. 1 root disk 8, 16 May 30 14:08 /dev/sdb
   # virsh vol-list guest_images_disk
   Name                 Path
   -----------------------------------------

7. オプション: 一時設定ファイルを削除する

   必要がない場合は、一時的なストレージプール XML 設定ファイルを削除します。

   # rm ~/guest_images_disk.xml

1. 同じプールを使用する他のゲスト仮想マシンとの問題を避けるには、ストレージプールを停止してから使用中のリソースをすべて解放するのが最良の方法です。

   # virsh pool-destroy guest_images_disk

2. ストレージプールの定義を削除します。

   # virsh pool-undefine guest_images_disk

手順13.1 virt-manager を使用してパーティションベースのストレージプールを作成する

1. ストレージプールのセッティングを開く

   1. virt-manager グラフィカルインターフェースで、メインウィンドウからホスト物理マシンを選択します。
      編集 メニューを開いて、 接続の詳細 を選択します。
      

      図13.1 接続の詳細

   2. 接続の詳細 ウィンドウで ストレージ タブをクリックします。
      

      図13.2 ストレージタブ

2. 新規ストレージプールを作成する

   1. 新規のプールを追加します (パート１)

      + ボタン (プールの追加ボタン) を押します。 新規ストレージプールの追加 ウィザードが表示されます。
      ストレージプールの 名前 を選択します。 この例では、 guest_images_fs という名前を使用しています。 種類 を fs: Pre-Formatted Block Device に変更します。
      

      図13.3 ストレージプールの名前と種類

      進む ボタンをクリックして次に進みます。

   2. 新規のプールを追加します (パート２)

      ターゲットパス、 フォーマット、 ソースパス の各フィールドを変更します。
      

      図13.4 ストレージプールのパスとフォーマット

      ターゲットパス

      ストレージプール用のソースデバイスのマウント先となる場所を ターゲットパス フィールドに入力します。 その場所がまだ存在しない場合は、 virt-manager によりそのディレクトリーが作成されます。

      フォーマット

      フォーマット 一覧からフォーマットを選択します。 デバイスはこの選択したフォーマットでフォーマット化されます。

      この例では、ext4 ファイルシステムを使用しています。これは Red Hat Enterprise Linux のデフォルトのファイルシステムです。

      ソースパス

      ソースパス フィールドにデバイスを入力します。

      この例では、/dev/sdc1 デバイスを使用しています。

      詳細を確認して、完了 ボタンを押すと、ストレージプールが作成されます。

3. 新規ストレージプールを確認する

   数秒後に、左側のストレージ一覧に新規ストレージプールが出現します。 期待通りのサイズが報告されていることを確認します。 この例では、458.20 GB Free です。 状態 フィールドで新規ストレージが Active と報告されていることを確認します。
   ストレージプールを選択します。 自動起動 フィールドで、 起動時 のチェックボックスをクリックします。これで libvirtd サービスの起動時には常にストレージデバイスも起動されるようになります。
   

   図13.5 ストレージ一覧を確認する

   これでストレージプールが作成されました。 接続の詳細 ウィンドウを閉じます。

1. 同じプールを使用する他のゲスト仮想マシンとの問題を避けるには、ストレージプールを停止して使用中のリソースをすべて解放するのが最良の方法です。これを実行するには、停止するストレージプールを選択して、ストレージウィンドウの下部にある赤い X アイコンをクリックします。
   

   図13.6 停止アイコン

2. ゴミ箱アイコンをクリックしてストレージプールを削除します。このアイコンが使用できるのは、ストレージプールが停止している場合のみです。

手順13.2 virsh を使用して事前フォーマット済みのブロックデバイスのストレージプールを作成する

1. ストレージプールの定義を作成します

   virsh pool-define-as コマンドを使用して、 新規のストレージプールの定義を作成します。 事前フォーマット済みディスクをストレージプールとして定義するには、 入力を必要とするオプションが 3 つあります。

   パーティション名

   name パラメーターでストレージプールの名前を指定します。 この例では、 guest_images_fs という名前を使用しています。

   デバイス

   device パラメーターに path 属性を持たせストレージデバイスのデバイスパスを指定します。 この例では、 /dev/sdc1 パーティションを使用しています。

   マウントポイント

   フォーマット済みのデバイスをマウントするローカルファイルシステム上の mountpoint です。 マウントポイントのディレクトリーが存在しない場合は、virsh コマンドによりそのディレクトリーが作成されます。

   この例では、 /guest_images ディレクトリーを使用しています。

   # virsh pool-define-as guest_images_fs fs - - /dev/sdc1 - "/guest_images"
   Pool guest_images_fs defined

   これで、新規のプールとマウントポイントが作成されました。

2. 新規のプールを確認する

   現在のストレージプールを一覧表示させます

   # virsh pool-list --all
   Name                 State      Autostart
   -----------------------------------------
   default              active     yes
   guest_images_fs      inactive   no

3. マウントポイントを作成する

   virsh pool-build コマンドを使用して、 事前フォーマット済みファイルシステムのストレージプール用のマウントポイントを作成します。

   # virsh pool-build guest_images_fs
   Pool guest_images_fs built
   # ls -la /guest_images
   total 8
   drwx------.  2 root root 4096 May 31 19:38 .
   dr-xr-xr-x. 25 root root 4096 May 31 19:38 ..
   # virsh pool-list --all
   Name                 State      Autostart
   -----------------------------------------
   default              active     yes
   guest_images_fs      inactive   no

4. ストレージプールを起動する

   virsh pool-start コマンドを使用して、 ファイルシステムをマウントポイントにマウントし、 プールを使用可能にします。

   # virsh pool-start guest_images_fs
   Pool guest_images_fs started
   # virsh pool-list --all
   Name                 State      Autostart
   -----------------------------------------
   default              active     yes
   guest_images_fs      active     no

5. autostart をオンにする

   デフォルトでは、virsh で定義されているストレージプールは、libvirtd が開始する度に自動的に開始するようには設定されていません。virsh pool-autostart コマンドを使用して自動開始をオンにします。そうすると、ストレージプールは libvirtd が開始する度に自動的に開始されます。

   # virsh pool-autostart guest_images_fs
   Pool guest_images_fs marked as autostarted
   
   # virsh pool-list --all
   Name                 State      Autostart
   -----------------------------------------
   default              active     yes
   guest_images_fs      active     yes

6. ストレージプールを確認する

   ストレージプールが正しく作成されたこと、 期待通りのサイズが報告されていること、 状態が running として報告されていることを確認します。 ファイルシステム上のマウントポイントに "lost+found" ディレクトリーがあるか確認します。 このディレクトリーがあればデバイスはマウントされていることになります。

   # virsh pool-info guest_images_fs
   Name:           guest_images_fs
   UUID:           c7466869-e82a-a66c-2187-dc9d6f0877d0
   State:          running
   Persistent:     yes
   Autostart:      yes
   Capacity:       458.39 GB
   Allocation:     197.91 MB
   Available:      458.20 GB
   # mount | grep /guest_images
   /dev/sdc1 on /guest_images type ext4 (rw)
   # ls -la /guest_images
   total 24
   drwxr-xr-x.  3 root root  4096 May 31 19:47 .
   dr-xr-xr-x. 25 root root  4096 May 31 19:38 ..
   drwx------.  2 root root 16384 May 31 14:18 lost+found

1. 同じプールを使用する他のゲスト仮想マシンとの問題を避けるには、ストレージプールを停止してから使用中のリソースをすべて解放するのが最良の方法です。

   # virsh pool-destroy guest_images_disk

2. また、 ストレージプールがあるディレクトリーを削除したい場合は、 次のコマンドを使用します。

   # virsh pool-delete guest_images_disk

3. ストレージプールの定義を削除する

   # virsh pool-undefine guest_images_disk

1. ローカルのディレクトリーを作成します

   1. オプション: ストレージプール用に新規のディレクトリーを作成します

      ホスト物理マシン上にストレージプール用のディレクトリーを作成します。この例では、/guest virtual machine_images という名前のディレクトリーを作成しています。

      # mkdir /guest_images

   2. ディレクトリーの所有権を設定します

      ディレクトリーのユーザーとグループの所有権を変更します。ティレクトリーは root ユーザーが所有する必要があります。

      # chown root:root /guest_images

   3. ディレクトリーのアクセス権を設定します

      ディレクトリーのファイルアクセス権を変更します。

      # chmod 700 /guest_images

   4. 変更を確認します

      アクセス権が修正されていることを確認します。出力は正しく設定された空のディレクトリーを表示しています。

      # ls -la /guest_images
      total 8
      drwx------.  2 root root 4096 May 28 13:57 .
      dr-xr-xr-x. 26 root root 4096 May 28 13:57 ..

2. SELinux のファイルコンテキストを設定します。

   SELinux の適切なコンテキストを新しいディレクトリーに設定します。プール名とディレクトリー名を一致させる必要はありませんが、ゲスト仮想マシンをシャットダウンする際に libvirt ではコンテキストをデフォルト値に戻さなければなりません。このデフォルト値はディレクトリーのコンテキストによって決定されます。したがって、ディレクトリーに「virt_image_t」のラベルを明示的に付けておくと、ゲスト仮想マシンがシャットダウンした際、そのイメージに「virt_image_t」のラベルが付けられるため、ホスト物理マシンで実行されている他のプロセスと区別できるようになります。

   # semanage fcontext -a -t virt_image_t '/guest_images(/.*)?'
   # restorecon -R /guest_images

3. ストレージプール設定を開きます

   1. virt-manager グラフィカルインターフェースで、メインウィンドウからホスト物理マシンを選択します。
      編集 メニューを開き、接続の詳細 を選択します。
      

      図13.7 接続の詳細ウィンドウ

   2. 接続の詳細 ウィンドウの ストレージ タブをクリックします。
      

      図13.8 ストレージタブ

4. 新しいストレージプールを作成します

   1. 新規のプールを追加します (パート１)。

      + ボタンを押します (プールの追加ボタン)。新規ストレージプールを追加 のウィザードが表示されます。
      ストレージプールの 名前 を選択します。この例では guest_images という名前を使用しています。種類 を dir: ファイルシステムディレクトリー にします。
      

      図13.9 ストレージプールに名前を付ける

      進む ボタンを押して先に進みます。

   2. 新規のプールを追加します (パート２)。

      ターゲットパス フィールドを /guest_images などに変更します。
      詳細を確認して、完了 ボタンを押すと、ストレージプールが作成されます。

5. 新しいストレージプールを確認します

   数秒後に、左側のストレージ一覧に新しいストレージプールが表示されます。予想通りのサイズが表示されていることを確認します。この例では、36.41 GB Free と表示されています。状態 フィールドに新しいストレージが Active と表示されていることを確認します。
   ストレージプールを選択します。自動起動 のフィールドで 起動時 のチェックボックスにチェックマークが付いていることを確認します。チェックマークが付いていると、libvirtd サービスの起動時は常にストレージプールも起動されます。
   

   図13.10 ストレージプールの詳細を確認

   これでストレージプールが作成されました。接続の詳細 ウィンドウを閉じます。

1. 同じプールを使用する他のゲスト仮想マシンとの問題を避けるには、ストレージプールを停止して使用中のリソースをすべて解放するのが最良の方法です。これを実行するには、停止するストレージプールを選択して、ストレージウィンドウの下部にある赤い X アイコンをクリックします。
   

   図13.11 停止アイコン

2. ゴミ箱アイコンをクリックしてストレージプールを削除します。このアイコンが使用できるのは、ストレージプールが停止している場合のみです。

1. ストレージプールの定義を作成します

   新規のストレージプールを定義するには、virsh pool-define-as コマンドを使用します。ディレクトリーベースのストレージプールの作成には 2 つのオプションが必要になります。
   • ストレージプールの 名前
     この例では guest_images という名前を使用しています。以下の例のこれ以降の virsh コマンドはすべてこの名前を使用します。
   • ゲストイメージファイル格納用のファイルシステムディレクトリーへの パス (このディレクトリーが存在しない場合は、virsh により作成されます)
     この例では /guest_images ディレクトリーを使用しています。

    # virsh pool-define-as guest_images dir - - - - "/guest_images"
   Pool guest_images defined

2. ストレージプールが一覧表示されていることを確認します。

   ストレージプールが正しく作成されていること、また状態が inactive で表示されることを確認します。

   # virsh pool-list --all
   Name                 State      Autostart 
   -----------------------------------------
   default              active     yes       
   guest_images     inactive   no

3. ローカルのディレクトリーを作成します

   以下のように、virsh pool-build コマンドを使用し、guest_images ディレクトリー (例) にディレクトリーベースのストレージプールをビルドします。

   # virsh pool-build guest_images
   Pool guest_images built
   # ls -la /guest_images
   total 8
   drwx------.  2 root root 4096 May 30 02:44 .
   dr-xr-xr-x. 26 root root 4096 May 30 02:44 ..
   # virsh pool-list --all
   Name                 State      Autostart 
   -----------------------------------------
   default              active     yes       
   guest_images     inactive   no

4. ストレージプールを起動します

   virsh コマンドの pool-start を使ってディレクトリーストレージプールを有効にします。これにより、プールのボリュームがゲストのディスクイメージとして使用されます。

   # virsh pool-start guest_images
   Pool guest_images started
   # virsh pool-list --all
   Name                 State      Autostart 
   -----------------------------------------
   default             active     yes       
   guest_images    active     no

5. autostart をオンにします

   ストレージプールに対して autostart をオンにします。Autostart は、サービスが開始する際にストレージプールを開始するように libvirtd サービスを設定します。

   # virsh pool-autostart guest_images
   Pool guest_images marked as autostarted
   # virsh pool-list --all
   Name                 State      Autostart 
   -----------------------------------------
   default              active     yes       
   guest_images         active     yes

6. ストレージプール設定を確認します

   ストレージプールが正しく作成されたこと、サイズが正しく表示されていること、および状態が running と表示されていることなどを確認します。ゲスト仮想マシンが実行されていない場合でもプールにアクセスできるようにしておきたい場合には、Persistent に yes が表示されていることを確認します。サービスの起動時にプールを自動的に起動させる場合は、Autostart に yes が表示されていることを確認します。

   # virsh pool-info guest_images
   Name:           guest_images
   UUID:           779081bf-7a82-107b-2874-a19a9c51d24c
   State:          running
   Persistent:     yes
   Autostart:      yes
   Capacity:       49.22 GB
   Allocation:     12.80 GB
   Available:      36.41 GB
   
   # ls -la /guest_images
   total 8
   drwx------.  2 root root 4096 May 30 02:44 .
   dr-xr-xr-x. 26 root root 4096 May 30 02:44 ..
   #

1. 同じプールを使用する他のゲスト仮想マシンとの問題を避けるには、ストレージプールを停止してから使用中のリソースをすべて解放するのが最良の方法です。

   # virsh pool-destroy guest_images_disk

2. また、ストレージプールがあるディレクトリーを削除したい場合は、次のコマンドを使用します。

   # virsh pool-delete guest_images_disk

3. ストレージプールの定義を削除します。

   # virsh pool-undefine guest_images_disk

1. オプション: LVM ボリューム用に新規のパーティションを作成します

   以下のステップでは、新しいハードディスクドライブ上に新規のパーティション、および LVM ボリュームグループを作成する方法を説明します。

   警告

   以下の手順を実行すると、選択したストレージデバイスからすべてのデータが削除されます。

   1. 新規パーティションを作成します

      fdisk コマンドを使用して、コマンドラインから新しいディスクパーティションを作成します。以下の例では、ストレージデバイス /dev/sdb 上のディスク全体を使用する新しいパーティションを作成しています。

      # fdisk /dev/sdb
      Command (m for help):

      n を入力して、新規のパーティションを作成します。
   2. p を入力してプライマリーパーティションを選択します。

      Command action
         e   extended
         p   primary partition (1-4)

   3. 選択可能なパーティション番号を選択します。この例では、1 が入力され、1 番目のパーティションが選択されています。

      Partition number (1-4): 1

   4. Enter を押して、デフォルトの 1 番目のシリンダーを入力します。

      First cylinder (1-400, default 1):

   5. パーティションのサイズを選択します。この例では、Enter を押すことで、ディスク全域が割り当てられます。

      Last cylinder or +size or +sizeM or +sizeK (2-400, default 400):

   6. t を入力してパーティションのタイプを設定します。

      Command (m for help): t

   7. 前のステップで作成したパーティションを選択します。この例では、パーティション番号は 1 です。

      Partition number (1-4): 1

   8. Linux LVM パーティションの 8e を入力します。

      Hex code (type L to list codes): 8e

   9. 変更をディスクに書き込んで終了します。

      Command (m for help): w 
      Command (m for help): q

   10. 新規の LVM ボリュームガイドを作成します

       vgcreate コマンドで新しい LVMボリュームグループを作成します。この例では、guest_images_lvm という名前のボリュームグループを作成しています。

       # vgcreate guest_images_lvm /dev/sdb1
         Physical volume "/dev/vdb1" successfully created
         Volume group "guest_images_lvm" successfully created

   これで新規の LVM ボリュームグループ guest_images_lvm が LVM ベースのストレージプールに使用できるようになりました。

2. ストレージプールの設定を開きます

   1. virt-manager グラフィカルインターフェースで、メインウィンドウからホストを選択します。
      編集 メニューを開いて、接続の詳細 を選択します。
      

      図13.12 接続の詳細

   2. ストレージ タブをクリックします。
      

      図13.13 ストレージタブ

3. 新しいストレージプールを作成します

   1. ウィザードを開始します

      + ボタン (プールの追加ボタン) を押します。新規ストレージプールの追加 ウィザードが表示されます。
      ストレージプール用に 名前 を選択します。この例では、guest_images_lvm を使用しています。 種類 を logical: LVM ボリュームグループ に変更します。
      

      図13.14 LVM ストレージプールの追加

      進む ボタンを押して先に進みます。

   2. 新規プールを追加します (パート 2)

      ターゲットパス フィールドを変更します。この例では、/guest_images を使用しています。
      次に、ターゲットパス フィールドと ソースパス フィールドに入力してから、プールを構築 のチェックボックスにチェックマークを付けます。
      • ターゲットパス フィールドを使用して、既存の LVM ボリュームグループか、または新規ボリュームグループの名前の いずれか を選択します。デフォルト形式は、/dev/storage_pool_name になります。
        この例では、/dev/guest_images_lvm という名前の新しいボリュームグループを使用しています。
      • 既存の LVM ボリュームグループが ターゲットパス で使用されている場合は、ソースパス フィールドはオプションになります。
        新規の LVM ボリュームグループの場合には、ストレージデバイスの場所を ソースパス フィールドに入力します。この例では、空のパーティション /dev/sdc を使用しています。
      • プールを構築 のチェックボックスにチェックマークを付けて、virt-manager に新規の LVM ボリュームグループを作成するよう指示します。既存のボリュームグループを使用する場合は、プールを構築 のチェックボックスは選択しないでください。
        この例では、空のパーティションを使用して新規のボリュームグループを作成しているため、プールを構築 のチェックボックスを選択しておく必要があります。
      

      図13.15 ターゲットとソースの追加

      詳細を確認して 完了 ボタンを押すと、LVM ボリュームグループがフォーマットされ、ストレージプールが作成されます。

   3. フォーマットするデバイスを確認します

      警告メッセージが表示されます。
      

      図13.16 警告メッセージ

      はい ボタンを押すと、ストレージデバイス上のすべてのデータが消去され、ストレージプールが作成されます。

4. 新規のストレージプールを確認します

   数秒後に新しいストレージプールが左側の一覧に表示されます。詳細が予想通りであることを確認します。この例では、465.76 GB Free です。また、状態フィールドで新規ストレージプールが Active と報告されていることを確認します。
   通常は、自動起動 のチェックボックスにチェックマークを付けて有効にし、libvirtd でストレージプールが自動的に起動されるようにしておくと便利です。
   

   図13.17 LVM ストレージプールの詳細確認

   これで作業は完了です。ホストの詳細ダイアログを閉じます。

1. 同じプールを使用する他のゲスト仮想マシンとの問題を避けるには、ストレージプールを停止して使用中のリソースをすべて解放するのが最良の方法です。これを実行するには、停止するストレージプールを選択して、ストレージウィンドウの下部にある赤い X アイコンをクリックします。
   

   図13.18 停止アイコン

2. ゴミ箱アイコンをクリックして、ストレージプールを削除します。このアイコンが使用できるのは、ストレージプールが停止している場合のみです。

手順13.3 virsh を使用した LVM ベースのストレージプールの作成

1. プール名 guest_images_lvm を定義します。

   # virsh pool-define-as guest_images_lvm logical - - /dev/sdc libvirt_lvm \ /dev/libvirt_lvm
   Pool guest_images_lvm defined

2. 指定した名前に応じてプールを構築します。既存のボリュームグループをすでに使用している場合は、このステップを飛ばします。

   # virsh pool-build guest_images_lvm
   
   Pool guest_images_lvm built

3. 新規のプールを初期化します。

   # virsh pool-start guest_images_lvm
   
   Pool guest_images_lvm started

4. vgs コマンドを使用して、ボリュームグループ情報を表示します。

   # vgs
   VG          #PV #LV #SN Attr   VSize   VFree  
   libvirt_lvm   1   0   0 wz--n- 465.76g 465.76g

5. プールが自動的に起動するよう設定します。

   # virsh pool-autostart guest_images_lvm
   Pool guest_images_lvm marked as autostarted

6. virsh コマンドを使用して、利用可能なプールを一覧表示します。

   # virsh pool-list --all
   Name                 State      Autostart 
   -----------------------------------------
   default              active     yes       
   guest_images_lvm     active     yes

7. 以下の一連のコマンドで、このプール内に 3 つのボリュームが作成されます (volume1、volume2、volume3)。

   # virsh vol-create-as guest_images_lvm volume1 8G
   Vol volume1 created
   
   # virsh vol-create-as guest_images_lvm volume2 8G
   Vol volume2 created
   
   # virsh vol-create-as guest_images_lvm volume3 8G
   Vol volume3 created

8. virsh コマンドを使用して、このプール内の利用可能なボリュームを一覧表示します。

   # virsh vol-list guest_images_lvm
   Name                 Path
   -----------------------------------------
   volume1              /dev/libvirt_lvm/volume1
   volume2              /dev/libvirt_lvm/volume2
   volume3              /dev/libvirt_lvm/volume3

9. 以下の 2 つのコマンド (lvscan と lvs) を使用して、新たに作成されたボリュームに関する詳細情報を表示します。

   # lvscan
   ACTIVE            '/dev/libvirt_lvm/volume1' [8.00 GiB] inherit
   ACTIVE            '/dev/libvirt_lvm/volume2' [8.00 GiB] inherit
   ACTIVE            '/dev/libvirt_lvm/volume3' [8.00 GiB] inherit
   
   # lvs
   LV       VG            Attr     LSize   Pool Origin Data%  Move Log Copy%  Convert
   volume1  libvirt_lvm   -wi-a-   8.00g
   volume2  libvirt_lvm   -wi-a-   8.00g
   volume3  libvirt_lvm   -wi-a-   8.00g

1. 同じプールを使用する他のゲストとの問題を避けるには、ストレージプールを停止してから使用中のリソースをすべて解放するのが最良の方法です。

   # virsh pool-destroy guest_images_disk

2. また、ストレージプールがあるディレクトリーを削除したい場合は、次のコマンドを使用します。

   # virsh pool-delete guest_images_disk

3. ストレージプールの定義を削除します。

   # virsh pool-undefine guest_images_disk

手順13.4 iSCSI ターゲットを作成します

1. 必要なパッケージをインストールします

   scsi-target-utils パッケージおよび依存するすべてのパッケージをインストールします。

   # yum install scsi-target-utils

2. tgtd サービスを起動します

   tgtd サービスは、ホスト物理マシンの SCSI ターゲットを提供し、ホスト物理マシンのターゲットに対して iSCSI プロトコルを使用します。tgtd サービスを起動してから、chkconfig コマンドで再起動すると、そのサービスを永続化することができます。

   # service tgtd start
   # chkconfig tgtd on

3. オプション: LVM ボリュームを作成します

   LVM ボリュームは、iSCSI のバッキングイメージに役に立ちます。LVM のスナップショットやサイズ変更は、ゲスト仮想マシンにとって便利な機能です。この例では、iSCSI でゲスト仮想マシンをホストするために RAID5 アレイ上の virtstore という名前の新規ボリュームグループ上に virtimage1 という名前の LVM イメージを作成しています。

   1. RAID アレイを作成する

      ソフトウェア RAID5 アレイの作成については 『Red Hat Enterprise Linux 導入ガイド』 を参照してください。

   2. LVM ボリュームグループを作成する

      vgcreate コマンドを使用して virtstore という名前のボリュームグループを作成します。

      # vgcreate virtstore /dev/md1

   3. LVM 論理ボリュームを作成する

      lvcreate コマンドを使用して、 virtimage1 という名前の論理ボリュームグループを 20GB のサイズで virtstore ボリュームグループ上に作成します。

      # lvcreate --size 20G -n virtimage1 virtstore

      これで、新規論理ボリュームの virtimage1 を iSCSI に使用する準備が整いました。

4. オプション: ファイルベースのイメージを作成します

   ファイルベースのストレージはテスト用としては十分ですが、実稼働環境や I/O アクティビティーが活発な環境には推奨できません。このオプションの手順では、iSCSI ターゲット用に virtimage2.img という名前のファイルベースイメージを作成します。

   1. イメージ用の新規のディレクトリーを作成する

      イメージを格納するための新規ディレクトリーを作成します。このディレクトリーには適切な SELinux コンテキストを設定する必要があります。

      # mkdir -p /var/lib/tgtd/virtualization

   2. イメージファイルを作成する

      virtimage2.img という名前のイメージを 10GB のサイズで作成します。

      # dd if=/dev/zero of=/var/lib/tgtd/virtualization/virtimage2.img bs=1M seek=10000 count=0

   3. SELinux ファイルコンテキストを設定する

      新規のイメージとディレクトリーに適切な SELinux コンテキストを設定します。

      # restorecon -R /var/lib/tgtd

      これで、新規のファイルベースのイメージ virtimage2.img を iSCSI に使用する準備が整いました。

5. ターゲットを作成します

   ターゲットは、/etc/tgt/targets.conf ファイルに XML エントリーを追加することで作成できます。target 属性には IQN (iSCSI Qualified Name) が必要になります。IQN は以下の形式になります。

   iqn.yyyy-mm.reversed domain name:optional identifier text

   ここで、
   • yyyy-mm は、デバイスが起動された年と月を示します (例: 2010-05)。
   • reversed domain name は、ホスト物理マシンの逆になったドメイン名 (たとえば、IQN の server1.example.com の場合は com.example.server1) です。
   • optional identifier text は、テキストの文字列になります。空白は入れません。管理者がデバイスやハードウェアの特定を行なう場合に便利です。
   この例では、オプションの手順で server1.example.com 上に作成した 2 種類のイメージ用に iSCSI ターゲットを作成し、オプションの識別子 trial を設定しています。以下の行を /etc/tgt/targets.conf ファイルに追加します。

   <target iqn.2010-05.com.example.server1:iscsirhel6guest>
      backing-store /dev/virtstore/virtimage1  #LUN 1
      backing-store /var/lib/tgtd/virtualization/virtimage2.img  #LUN 2
      write-cache off
   </target>

   ドライバータイプが iSCSI に設定されるよう、/etc/tgt/targets.conf ファイルに default-driver iscsi の行が含まれていることを確認してください。ドライバーはデフォルトで iSCSI を使用します。

   重要

   この例では、アクセス制御を持たないグローバルにアクセス可能なターゲットを作成します。安全なアクセスの実装に関しては、scsi-target-utils を参照してください。

6. tgtd サービスを再起動します

   tgtd サービスを再起動して、設定の変更を再読み込みします。

   # service tgtd restart

7. iptables の設定を行います

   iptables を使用して iSCSI アクセス用にポート 3260 を開きます。

   # iptables -I INPUT -p tcp -m tcp --dport 3260 -j ACCEPT
   # service iptables save
   # service iptables restart

8. 新規のターゲットを確認します

   tgt-admin --show コマンドを使用して、新規ターゲットを表示させ、セットアップが正しく行なわれていることを確認します。

   # tgt-admin --show
   Target 1: iqn.2010-05.com.example.server1:iscsirhel6guest
   System information:
   Driver: iscsi
   State: ready
   I_T nexus information:
   LUN information:
   LUN: 0
       Type: controller
       SCSI ID: IET     00010000
       SCSI SN: beaf10
       Size: 0 MB
       Online: Yes
       Removable media: No
       Backing store type: rdwr
       Backing store path: None
   LUN: 1
       Type: disk
       SCSI ID: IET     00010001
       SCSI SN: beaf11
       Size: 20000 MB
       Online: Yes
       Removable media: No
       Backing store type: rdwr
       Backing store path: /dev/virtstore/virtimage1
   LUN: 2
       Type: disk
       SCSI ID: IET     00010002
       SCSI SN: beaf12
       Size: 10000 MB
       Online: Yes
       Removable media: No
       Backing store type: rdwr
       Backing store path: /var/lib/tgtd/virtualization/virtimage2.img
   Account information:
   ACL information:
   ALL

   警告

   ACL 一覧はすべて (all) にセットされています。これにより、ローカルネットワーク上のすべてのシステムがこのデバイスにアクセス可能になります。実稼働環境には、ホスト物理マシンのアクセス ACL を設定することが推奨されています。

9. オプション: 検出テスト

   新規の iSCSI デバイスが検出可能かどうかを検証します。

   # iscsiadm --mode discovery --type sendtargets --portal server1.example.com
   127.0.0.1:3260,1 iqn.2010-05.com.example.server1:iscsirhel6guest

10. オプション: デバイス接続テスト

    新規デバイス (iqn.2010-05.com.example.server1:iscsirhel6guest) を接続して、デバイスの接続が可能かどうかを検証します。

    # iscsiadm -d2 -m node --login
    scsiadm: Max file limits 1024 1024
    
    Logging in to [iface: default, target: iqn.2010-05.com.example.server1:iscsirhel6guest, portal: 10.0.0.1,3260]
    Login to [iface: default, target: iqn.2010-05.com.example.server1:iscsirhel6guest, portal: 10.0.0.1,3260] successful.

    デバイスを切り離します。

    # iscsiadm -d2 -m node --logout
    scsiadm: Max file limits 1024 1024
    
    Logging out of session [sid: 2, target: iqn.2010-05.com.example.server1:iscsirhel6guest, portal: 10.0.0.1,3260
    Logout of [sid: 2, target: iqn.2010-05.com.example.server1:iscsirhel6guest, portal: 10.0.0.1,3260] successful.

手順13.5 iSCSI デバイスを virt-manager に追加する

1. ホスト物理マシンのストレージタブを開きます

   接続の詳細 ウィンドウ内の ストレージ タブを開きます。
   1. virt-manager を開きます
   2. メイン virt-manager ウィンドウからホスト物理マシンを選択します。編集 メニューをクリックして、接続の詳細 を選択します。
      

      図13.19 接続の詳細

   3. ストレージ タブをクリックします。
      

      図13.20 ストレージメニュー

2. 新規のプールを追加します (パート 1)

   + ボタン (プールの追加ボタン) を押します。新規ストレージプールの追加 ウィザードが表示されます。
   

   図13.21 iscsi ストレージプールの名前と種類を追加

   ストレージプールの名前を選択して、種類を iscsi に変更し、進む を押して先に進みます。

3. 新規のプールを追加します (パート 2)

   このメニューのフィールドに記載する情報として、「iSCSI ベースのストレージプール」 および ステップ 5 で使用した情報が必要になります。
   1. iSCSI ソースおよびターゲットを入力します。フォーマットはゲスト仮想マシンが処理するため、フォーマット オプションは選択できません。さらに、ターゲットパス を編集することは推奨されていません。デフォルトのターゲットパスの値 /dev/disk/by-path/ は、ドライブパスをそのディレクトリーに追加します。ターゲットパスは、移行に関してすべてのホスト物理マシン上で同一である必要があります。
   2. iSCSI ターゲットのホスト名、または IP アドレスを入力します。この例では、host1.example.com を使用します。
   3. ソースパス フィールドには、iSCSI ターゲット IQN を入力します。「iSCSI ベースのストレージプール」 の ステップ 5 を参照すると、これは /etc/tgt/targets.conf file に追加した情報であることが分かります。この例では、iqn.2010-05.com.example.server1:iscsirhel6guest を使用しています。
   4. IQN チェックボックスにチェックを入れて、イニシエーターの IQN を入力します。この例では、iqn.2010-05.com.example.server1:iscsirhel6guest を使用しています。
   5. 完了 をクリックすると、新規のストレージプールが作成されます。
   

   図13.22 iscsi ストレージプールの作成

1. 同じプールを使用する他のゲスト仮想マシンとの問題を避けるには、ストレージプールを停止して使用中のリソースをすべて解放するのが最良の方法です。これを実行するには、停止するストレージプールを選択して、ストレージウィンドウの下部にある赤い X アイコンをクリックします。
   

   図13.23 停止アイコン

2. ゴミ箱アイコンをクリックしてストレージプールを削除します。このアイコンが使用できるのは、ストレージプールが停止している場合のみです。

1. pool-define-as を使用してコマンドラインからプールを定義します

   ストレージプールの定義は、virsh コマンドラインツールで作成できます。virsh を使ったストレージプール作成は、複数のストレージプールをスクリプトで作成しているシステム管理者にとって便利です。
   virsh pool-define-as コマンドにはパラメーターがいくつかあり、以下の形式で使用します。

   virsh pool-define-as name type source-host source-path source-dev source-name target

   以下でパラメーターについて説明します。

   type

   iscsi などの、特定のタイプでプールを定義します。

   name

   ストレージプールの名前を指定し、固有の名前にしてください。

   source-host と source-path

   ホスト名と iSCSI IQN です。

   source-dev と source-name

   iSCSI ベースのプールにはこれらのパラメーターは必要ありません、 - 文字を使ってこのフィールドは空白にします。

   target

   ホスト物理マシン上に iSCSI デバイスをマウントする場所を定義します。

   以下の例では、以前のステップと同じ iSCSI ベースのストレージプールを作成しています。

   #   virsh pool-define-as --name scsirhel6guest --type iscsi \
        --source-host server1.example.com \
        --source-dev iqn.2010-05.com.example.server1:iscsirhel6guest
        --target /dev/disk/by-path
   Pool iscsirhel6guest defined

2. ストレージプールが一覧表示されていることを確認します

   ストレージプールオブジェクトが正しく作成されたことや、状態が inactive として報告されることを確認します。

   # virsh pool-list --all
   Name                 State      Autostart 
   -----------------------------------------
   default              active     yes       
   iscsirhel6guest      inactive   no

3. ストレージプールを起動します

   これには virsh コマンド pool-start を使用します。pool-start はディレクトリーストレージプールを有効にして、ボリュームとゲスト仮想マシン用に使用できるようにします。

   # virsh pool-start guest_images_disk
   Pool guest_images_disk started
   # virsh pool-list --all
   Name                 State      Autostart 
   -----------------------------------------
   default              active     yes       
   iscsirhel6guest      active     no

4. autostart をオンにします

   ストレージプールの autostart をオンにします。 Autostart により、libvirtd サービスの起動時にストレージプールも起動するよう設定されます。

   # virsh pool-autostart iscsirhel6guest
   Pool iscsirhel6guest marked as autostarted

   iscsirhel6guest プールに autostart が設定されていることを確認します。

   # virsh pool-list --all
   Name                 State      Autostart 
   -----------------------------------------
   default              active     yes       
   iscsirhel6guest      active     yes

5. ストレージプールの設定を確認します

   ストレージプールが正しく作成されたことや、サイズが正しく報告されていること、および状態が running として報告されていることを確認します。

   # virsh pool-info iscsirhel6guest
   Name:           iscsirhel6guest
   UUID:           afcc5367-6770-e151-bcb3-847bc36c5e28
   State:          running
   Persistent:     unknown
   Autostart:      yes
   Capacity:       100.31 GB
   Allocation:     0.00
   Available:      100.31 GB

1. 同じプールを使用する他のゲスト仮想マシンとの問題を避けるには、ストレージプールを停止してから使用中のリソースをすべて解放するのが最良の方法です。

   # virsh pool-destroy guest_images_disk

2. ストレージプールの定義を削除します。

   # virsh pool-undefine guest_images_disk

1. ホスト物理マシンのストレージタブを開きます

   接続の詳細 ウィンドウ内の ストレージ タブを開きます。
   1. virt-manager を開きます
   2. メイン virt-manager ウィンドウからホスト物理マシンを選択します。編集 メニューをクリックして、接続の詳細 を選択します。
      

      図13.24 接続の詳細

   3. ストレージタブをクリックします。
      

      図13.25 ストレージタブ

2. 新規のプールを作成します (パート 1)

   + ボタン (プールの追加ボタン) を押します。新規ストレージプールの追加 ウィザードが表示されます。
   

   図13.26 NFS の名前と種類を追加

   ストレージプールの名前を選択して、進む を押して先に進みます。

3. 新規のプールを作成します (パート 2)

   デバイスのターゲットパス、ホスト名、および NFS 共有パスを入力します。フォーマット オプションを NFS または auto (タイプの検出) に設定します。ソースパスは移行に関連するすべてのホスト物理マシン上で同一でなければなりません。
   NFS サーバーのホスト名または IP アドレスを入力します。この例では、server1.example.com を使用しています。
   NFS パスを入力します。この例では、/nfstrial を使用しています。
   

   図13.27 NFS ストレージプールの作成

   完了 を押すと、新規のストレージプールが作成されます。

1. 同じプールを使用する他のゲストとの問題を避けるため、ストレージプールを停止して使用中のリソースをすべて解放するのが最適です。停止するストレージプールを選択して、ストレージウィンドウの下部にある赤い X アイコンをクリックします。
   

   図13.28 停止アイコン

2. ゴミ箱アイコンをクリックしてストレージプールを削除します。このアイコンが使用できるのは、ストレージプールが停止している場合のみです。

手順13.6 Gluster サーバーとアクティブな Gluster ボリュームの準備

1. 次のコマンドを使って、状態を一覧表示し、Gluster サーバーの IP アドレスを取得します。

   # gluster volume status
   Status of volume: gluster-vol1
   Gluster process						Port	Online	Pid
   ------------------------------------------------------------------------------
   Brick 222.111.222.111:/gluster-vol1 			49155	Y	18634
    
   Task Status of Volume gluster-vol1
   ------------------------------------------------------------------------------
   There are no active volume tasks

2. まだこれを実行していない場合は、glusterfs-fuse をインストールしてから virt_use_fusefs を有効にします。次に、以下のコマンドを実行して、Gluster サーバーに接続する 1 つのホストを用意します。

   # setsebool virt_use_fusefs on
   # getsebool virt_use_fusefs
   virt_use_fusefs --> on
   

3. pool type を gluster に指定し、Gluster ストレージプール (以下の例では glusterfs-pool.xml) を設定するために新しい XML ファイルを作成し、以下のデータを追加します。

   			
   <pool type='gluster'>
   	<name>glusterfs-pool</name>
   	<source>
   		<host name='111.222.111.222'/>
   		<dir path='/'/>
   		<name>gluster-vol1</name>
   	</source>
   </pool>
   
   

   図13.29 GlusterFS XML ファイルの内容

4. 次のコマンドを使って、Gluster プールを定義し、これを開始します。

   # virsh pool-define glusterfs-pool.xml 
   Pool gluster-pool defined from glusterfs-pool.xml
   
   # virsh pool-list --all
   Name                 State      Autostart 
   -----------------------------------------       
   gluster-pool         inactive   no              
   
   # virsh pool-start gluster-pool
   Pool gluster-pool started
   
   # virsh pool-list --all
   Name                 State      Autostart 
   -----------------------------------------      
   gluster-pool         active     no  
   
   # virsh vol-list gluster-pool
   Name                 Path                                    
   -----------------------------------------
   qcow2.img            gluster://111.222.111.222/gluster-vol1/qcow2.img
   raw.img              gluster://111.222.111.222/gluster-vol1/raw.img

手順13.7 GlusterFS ストレージプールの削除

1. 次のコマンドを使って、ストレージプールの状態を非アクティブに設定します。

   
    # virsh pool-destroy gluster-pool
   Pool gluster-pool destroyed

2. 次のコマンドを使って、プールが非アクティブの状態であることを確認します。

   # virsh pool-list --all
   Name                 State      Autostart 
   -----------------------------------------     
   gluster-pool         inactive   no

3. 次のコマンドを使って GlusterFS ストレージプールの定義を解除します。

   # virsh pool-undefine gluster-pool
   Pool gluster-pool has been undefined

4. 次のコマンドを使ってプールの定義が解除されていることを確認します。

   # virsh pool-list --all
   Name                 State      Autostart 
   -----------------------------------------
   

手順13.8 vHBA の作成

1. ホストシステム上で HBA を見つける

   ホストシステム上で HBA を見つけるには、ホストシステム上の SCSI デバイスを調べて、vport 機能のある scsi_host を探します。
   以下のコマンドを実行して scsi_host リストを表示します。

   # virsh nodedev-list --cap scsi_host
   scsi_host0
   scsi_host1
   scsi_host2
   scsi_host3
   scsi_host4

   各 scsi_host で以下のコマンドを実行し、デバイス XML で <capability type='vport_ops'> の行を調べます。これは、vport 機能のある scsi_host を示します。

   # virsh nodedev-dumpxml scsi_hostN

2. HBA の詳細を確認する

   virsh nodedev-dumpxml HBA_device コマンドを使って HBA の詳細をチェックします。
   virsh nodedev-dumpxml コマンドからの XML 出力では、<name>、<wwnn>、および <wwpn> のフィールドが一覧表示されます。これらは vHBA の作成に使用されます。<max_vports> の値は、サポートされる vHBA の最大数を示します。

    # virsh nodedev-dumpxml scsi_host3
   <device>
     <name>scsi_host3</name>
     <path>/sys/devices/pci0000:00/0000:00:04.0/0000:10:00.0/host3</path>
     <parent>pci_0000_10_00_0</parent>
     <capability type='scsi_host'>
       <host>3</host>
       <capability type='fc_host'>
         <wwnn>20000000c9848140</wwnn>
         <wwpn>10000000c9848140</wwpn>
         <fabric_wwn>2002000573de9a81</fabric_wwn>
       </capability>
       <capability type='vport_ops'>
         <max_vports>127</max_vports>
         <vports>0</vports>
       </capability>
     </capability>
   </device>

   この例では、<max_vports> 値は HBA 設定で使用できる 127 の仮想ポートがあることを示しています。<vports> 値は、現在使用中の仮想ポートの数を示します。これらの値は、vHBA 作成後に更新されます。

3. vHBA ホストデバイスの作成

   vHBA ホスト用に以下のような XML ファイルを作成します (この例では、ファイル名 vhba_host3.xml)。

   # cat vhba_host3.xml
      <device>
        <parent>scsi_host3</parent>
        <capability type='scsi_host'>
          <capability type='fc_host'>
          </capability>
        </capability>
      </device>

   <parent> フィールドでは、この vHBA デバイスに関連付ける HBA デバイスを指定します。<device> タグ内の詳細は、ホスト用の vHBA デバイスを作成するために次のステップで使用します。nodedev XML 形式についての詳細は、http://libvirt.org/formatnode.html を参照してください。

4. vHBA ホストデバイス上で新規 vHBA を作成する

   vhba_host3 上で vHBA を作成するには、virsh nodedev-create コマンドを使用します。

   # virsh nodedev-create vhba_host3.xml
   Node device scsi_host5 created from vhba_host3.xml

5. vHBA の確認

   新規 vHBA (scsi_host5) の詳細を virsh nodedev-dumpxml コマンドで確認します。

   # virsh nodedev-dumpxml scsi_host5
   <device>
     <name>scsi_host5</name>
     <path>/sys/devices/pci0000:00/0000:00:04.0/0000:10:00.0/host3/vport-3:0-0/host5</path>
     <parent>scsi_host3</parent>
     <capability type='scsi_host'>
       <host>5</host>
       <capability type='fc_host'>
         <wwnn>5001a4a93526d0a1</wwnn>
         <wwpn>5001a4ace3ee047d</wwpn>
         <fabric_wwn>2002000573de9a81</fabric_wwn>
       </capability>
     </capability>
   </device>

1. SCSI ストレージプールの作成

   vHBA 設定を作成するには、まず以下の形式を使用して vHBA に基づく libvirt 'scsi' ストレージプールの XML ファイルを作成します。

   注記

   ストレージプール設定では、ホスト名に 手順13.8「vHBA の作成」 で作成した vHBA を使用し、vHBA 名 scsi_hostN を hostN に修正してください。ここの例では vHBA の名前は scsi_host5 となり、これは Red Hat Enterprise Linux 6 libvirt ストレージプールでは <adapter name='host5'/> と指定されます。
   <path> の値には、ご使用のシステム上の /dev/disk/by-{path|id|uuid|label} のいずれかなど、安定した場所を使用することが推奨されます。 <path> と <target> 内の要素についての詳細は、http://libvirt.org/formatstorage.html を参照してください。
   以下の例では、'scsi' ストレージプールの名前は vhbapool_host3.xml となっています。

     <pool type='scsi'>
        <name>vhbapool_host3</name> 
        <uuid>e9392370-2917-565e-692b-d057f46512d6</uuid>
        <capacity unit='bytes'>0</capacity>
        <allocation unit='bytes'>0</allocation>
        <available unit='bytes'>0</available>
        <source>
          <adapter name='host5'/> 
        </source>
         <target>
           <path>/dev/disk/by-path</path>
           <permissions>
             <mode>0700</mode>
             <owner>0</owner>
             <group>0</group>
           </permissions>
         </target>
       </pool>

2. プールの定義

   ストレージプール (この例では vhbapool_host3 という名前) を定義するには、virsh pool-define コマンドを使用します。

            # virsh pool-define vhbapool_host3.xml
            Pool vhbapool_host3 defined from vhbapool_host3.xml

3. プールの起動

   以下のコマンドでストレージプールを起動します。

   # virsh pool-start vhbapool_host3
   Pool vhbapool_host3 started

4. autostart の有効化

   最後に、この後のホストの起動で仮想マシンで使用される vHBA が自動的に定義されるようにするために、ストレージプールの autostart 機能を設定します (この例では、プールの名前は vhbapool_host3 です)。

   # virsh pool-autostart vhbapool_host3

1. 利用可能な LUN を探す

   まず、virsh vol-list コマンドを使用して、vHBA 上で利用可能な LUN を一覧表示します。

   # virsh vol-list vhbapool_host3
    Name                 Path                                    
   ------------------------------------------------------------------------------
    unit:0:4:0           /dev/disk/by-path/pci-0000:10:00.0-fc-0x5006016844602198-lun-0
    unit:0:5:0           /dev/disk/by-path/pci-0000:10:00.0-fc-0x5006016044602198-lun-0

   表示された LUN 名の一覧は、仮想マシン設定内でディスクボリュームとして使用できます。

2. vHBA LUN を仮想マシンに追加する

   仮想マシンの XML で以下を指定して、vHBA LUN を仮想マシンに追加します。
   • <disk> パラメーターでデバイスタイプを lun または disk に指定します。
   • さらに、ソースデバイスを <source> パラメーターで指定します。これは、/dev/sdaN とするか、/dev/disk/by-path|by-id|by-uuid|by-label 内の udev が生成したシンボリックリンクとすることができます。virsh vol-list pool コマンドを実行するとこれが見つかります。
   以下に例を示します。

      <disk type='block' device='lun'>
        <driver name='qemu' type='raw'/>
        <source dev='/dev/disk/by-path/pci-0000\:04\:00.1-fc-0x203400a0b85ad1d7-lun-0'/>
        <target dev='sda' bus='scsi'/>
      </disk>
   
   

手順14.1 ファイルベースのストレージを追加する

1. ストレージファイルを作成するか、または既存のファイルを使用します (IMG ファイルなど)。以下のコマンドはどちらもゲスト用の追加ストレージとして使用できる 4GB のファイルを作成します。
   • ファイルベースのストレージイメージには、事前割り当てのファイルを使用することを推奨します。以下のように dd コマンドを使って事前割り当てのファイルを作成します。

     # dd if=/dev/zero of=/var/lib/libvirt/images/FileName.img bs=1M count=4096

   • または、事前割り当てファイルの代わりにスパースファイルを作成することもできます。スパースファイルの方が作成にかかる時間が短く、テストなどに適しています。ただし、データの整合性やパフォーマンス関連の問題があるため、実稼働環境には推奨できません。

     # dd if=/dev/zero of=/var/lib/libvirt/images/FileName.img bs=1M seek=4096 count=0

2. 新しいファイルに <disk> 要素を記述して追加のストレージを作成します。この例では、このファイル名は NewStorage.xml になります。
   <disk> 要素は、ディスクのソースと仮想ブロックデバイスのデバイス名を記述します。デバイス名はゲスト内のすべてのデバイスに対して固有の名前にしてください。このデバイス名によってゲストが仮想ブロックデバイスを検索するバスが特定されます。以下の例では、FileName.img という名前のファイルベースのストレージコンテナーがソースとなる virtio ブロックデバイスを定義しています。

   <disk type='file' device='disk'>
      <driver name='qemu' type='raw' cache='none'/>
      <source file='/var/lib/libvirt/images/FileName.img'/>
      <target dev='vdb'/>
   </disk>

   デバイス名は、IDE や SCSI ディスクを指定する「hd」や「sd」から始まる名前にすることもできます。設定ファイルには <address> サブ要素を含め、バス上の新しいデバイスの位置を指定することもできます。virtio ブロックデバイスの場合に、これは PCI アドレスになるはずです。<address> サブ要素を省略すると、livbirt により次に使用できる PCI スロットの検索および割り当てが行なわれます。
3. 以下のように CD-ROM を割り当てます。

   <disk type='file' device='cdrom'>
      <driver name='qemu' type='raw' cache='none'/>
      <source file='/var/lib/libvirt/images/FileName.img'/>
      <readonly/>
      <target dev='hdc'/>
   </disk >

4. NewStorage.xml に定義されているデバイスをゲスト (Guest1) に追加します。

   # virsh attach-device --config Guest1 ~/NewStorage.xml

   注記

   この変更は、ゲストが破棄され、再起動した後にしか反映されません。また、永続デバイスを追加できるのは永続ドメインに対してのみになります。永続ドメインとは、その設定が virsh define コマンドを使って保存されているドメインのことです。
   ゲストが実行中で、そのゲストが破棄されるまでの間に新しいデバイスを一時的に追加したい場合は --config オプションを省略します。

   # virsh attach-device Guest1 ~/NewStorage.xml

   注記

   virsh コマンドでは attach-disk コマンドを使用することができます。このコマンドでは、より簡単な構文で限定された数のパラメーターを設定でき、XML ファイルを作成する必要がありません。以下に示すように、attach-disk コマンドは前述の attach-device コマンドと同じように使用されます。

   # virsh attach-disk Guest1 /var/lib/libvirt/images/FileName.img vdb --cache none

   virsh attach-disk コマンドも --config オプションを受け入れることに注意してください。
5. ゲストマシンを開始します (まだ稼働していない場合):

   # virsh start Guest1

   注記

   以下のステップは Linux ゲストに固有なステップです。他のオペレーティングシステムでは、異なる方法で新規のストレージデバイスを処理します。他のシステムについては、そのオペレーティングシステムのドキュメントを参照してください。

6. ディスクドライブのパーティション設定

   ここでゲストには /dev/vdb というハードディスクデバイスが設定されています。必要であれば、このディスクドライブにパーティションを設定し、パーティションをフォーマットします。追加したデバイスが表示されない場合、それはゲストのオペレーティングシステムにディスクのホットプラグに関する問題が発生していることを示します。
   1. 新規デバイスに対して fdisk を開始します。

      # fdisk /dev/vdb
      Command (m for help):

   2. 新規パーティション作成の n を入力します。
   3. 次のように出力されます。

      Command action
      e   extended
      p   primary partition (1-4)

      プライマリパーティションを作成するために p を入力します。
   4. 使用できるパーティション番号を選択します。この例では、1 が入力され、１ 番目のパーティションが選択されています。

      Partition number (1-4): 1

   5. Enter を押して、デフォルトとなる 1 番目のシリンダーを選択します。

      First cylinder (1-400, default 1):

   6. パーティションのサイズを選択します。この例では、Enter を押して、ディスク全体が割り当てられています。

      Last cylinder or +size or +sizeM or +sizeK (2-400, default 400):

   7. t を入力して、パーティションタイプを設定します。

      Command (m for help): t

   8. 前のステップで作成したパーティションを選択します。この例では、パーティション番号が 1 のパーティションを選択しています。この例で作成されたパーティションは 1 つのみのため、fdisk によって自動的にパーティション 1 が選択されています。

      Partition number (1-4): 1

   9. Linux パーティションの 83 を入力します。

      Hex code (type L to list codes): 83

   10. w を入力して、変更を書き込み、終了します。

       Command (m for help): w

   11. ext3 ファイルシステムで新しいパーティションをフォーマットします。

       # mke2fs -j /dev/vdb1

7. マウントディレクトリーを作成して、ゲスト上にディスクをマウントします。この例では、ディレクトリーは myfiles にあります。

   # mkdir /myfiles
   # mount /dev/vdb1 /myfiles

   これで、ゲストは仮想化されたファイルベースの追加ストレージデバイスを持つことになります。ただし、このストレージはゲストの /etc/fstab ファイルで定義されない限り、再起動後にも永続化するようにマウントされない点に注意してください。

   /dev/vdb1    /myfiles    ext3     defaults    0 0

手順14.2 ゲストに物理ブロックデバイスを追加する

1. この手順は、ホスト物理マシン上のハードドライブをゲストに追加する方法を説明しています。これは、CD-ROM、DVD、およびフロッピーデバイスを含むすべてての物理ブロックデバイスに適用されます。
   ホスト物理マシンにハードディスクデバイスを物理的に接続します。ドライブにデフォルトでアクセスできない場合、ホスト物理マシンを設定します。
2. 次のいずれかを行ないます。
   1. 新しいファイル内に disk 要素を記述して追加のストレージを作成します。この例では、このファイル名は NewStorage.xml です。次の例は、ホスト物理マシンのパーティション /dev/sr0: 用のデバイスベースの追加ストレージコンテナーが含まれる設定ファイルのセクションになります。

      <disk type='block' device='disk'>
            <driver name='qemu' type='raw' cache='none'/>
            <source dev='/dev/sr0'/>
            <target dev='vdc' bus='virtio'/>
      </disk>

   2. 直前のセクションの指示に従って、デバイスをゲスト仮想マシンにアタッチします。または、以下のように virsh attach-disk コマンドを使用することもできます。

      # virsh attach-disk Guest1 /dev/sr0 vdc

      次のオプションが利用できます。
      • 以下のように、virsh attach-disk コマンドも --config、--type、および --mode オプションを受け入れます。

        # virsh attach-disk Guest1 /dev/sr0 vdc --config --type cdrom --mode readonly

      • また、デバイスがハードドライブの場合には、 --type は --type disk も受け入れます。
3. これで、ゲスト仮想マシンは、Linux では /dev/vdc など (ゲスト仮想マシンの OS の選択によって異なる)、Windows では D: ドライブ という名前の新しいハードディスクデバイスを持つことになり、ゲスト仮想マシンのオペレーティングシステムに適した標準的な手順に従ってゲスト仮想マシンからディスクを初期化できるようになります。例については、手順14.1「ファイルベースのストレージを追加する」 および ステップ 6 を参照してください。

   警告

   ホスト物理マシンでは、ファイルシステムを特定するために、fstab ファイルや、initrd ファイルままたはカーネルコマンドラインなどでファイルシステムのラベルを使用しないようにしてください。ゲスト仮想マシンなど特権を持たないユーザーがパーティションや LVM ボリューム全体への書き込みアクセス権を持つ場合、ファイルシステムのラベルを使用するとセキュリティー上のリスクが発生します。ゲスト仮想マシンが、ホスト物理マシンに属するファイルシステムのラベルを、自らのブロックデバイスストレージに書き込む可能性があるためです。これにより、ホスト物理マシンの再起動時に、ホスト物理マシンがこのゲスト仮想マシンのディスクをシステムディスクとして誤って使用してしまう可能性があり、ホスト物理マシンシステムが危険にさらされる可能性があります。

   fstab ファイルや、initrd ファイルまたはカーネルコマンドラインなどでデバイスを特定するにはその UUID を使用した方がよいでしょう。ただし、特定のファイルシステムでは UUID の使用が完全に安全である訳ではありませんが、UUID を使用した場合には同様のセキュリティー上のリスクは確実に低くなります。

   重要

   ゲスト仮想マシンはディスク全域、またはブロックデバイス全域 (例: /dev/sdb) に書き込みアクセスを持つべきではありません。ブロックデバイス全域にアクセスを持つゲスト仮想マシンはボリュームラベルを修正できる場合があり、これがホスト物理マシンシステムの攻撃に使用される可能性があります。パーティション (例: /dev/sdb1) または LVM ボリュームを使用して、この問題を回避してください。

手順15.2 virsh blockcommit

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

  # virsh blockcommit $dom $disk -base snap1 -top snap2 -wait -verbose

  snap2 のコンテンツが snap1 に移行します。以下のようになります。
  base ← snap1 ← active。Snap2 は無効になり、削除することができません。

  警告

  blockcommit は、-base オプションに依存するすべてのファイル を破損させます (-top オプションに依存するファイルを除く。これらは base を指しているため)。これを防ぐには、複数のゲストが共有するファイルへの変更をコミットしないでください。-verbose オプションを使用すると、進捗状況が画面に出力されます。

手順15.3 blockpull を使用したバッキングチェーンの短縮化

1. blockpull を実行する前に以下のコマンドを実行すると便利です。

   # virsh snapshot-create-as $dom $name - disk-only

2. チェーンが base ← snap1 ← snap2 ← active となっている場合、以下を実行します。

   # virsh blockpull $dom $disk snap1

   このコマンドは、データを snap2 から active にプルしてから base ← snap1 ← active の状態にすることにより、'snap1' を active のバッキングファイルにします。
3. blockpull が完了すると、チェーン内の追加イメージを作成したスナップショットの libvirt 追跡は役に立たなくなります。以下のコマンドを使って、古くなったスナップショットの追跡を削除します。

   # virsh snapshot-delete $dom $name - metadata

• 以下のコマンドを実行します: blockresize [domain] [path size] ここで、
  • ドメインは、サイズを変更するドメインのファイルの固有のターゲット名またはソースファイルです。
  • サフィックスがない場合、パスサイズはデフォルトで KiB (1024 バイトブロック単位) になる単位付き整数です。バイトについては、「B」のサフィックスを使用する必要があります。

1. virsh edit [guestname] コマンドを実行して、ゲスト仮想マシンの XML 設定ファイルを編集します。
2. address type タグ内の function='0x0' に multifunction='on' のエントリーを追加します。
   これでゲスト仮想マシンが多機能 PCI デバイスを使用できるようになります。

   <disk type='file' device='disk'>
   <driver name='qemu' type='raw' cache='none'/>
   <source file='/var/lib/libvirt/images/rhel62-1.img'/>
   <target dev='vda' bus='virtio'/>
   <address type='pci' domain='0x0000' bus='0x00' slot='0x05' function='0x0' multifunction='on'/
   </disk>

   2 種類の機能を備えた PCI デバイスの場合、XML 設定ファイルを修正して、2 番目のデバイスに 1 番目のデバイスと同じスロット番号と、function='0x0' などの異なる機能番号を持たせます。
   例:

   <disk type='file' device='disk'>
   <driver name='qemu' type='raw' cache='none'/>
   <source file='/var/lib/libvirt/images/rhel62-1.img'/>
   <target dev='vda' bus='virtio'/>
   <address type='pci' domain='0x0000' bus='0x00' slot='0x05' function='0x0' multifunction='on'/>
   </disk>
   <disk type='file' device='disk'>
   <driver name='qemu' type='raw' cache='none'/>
   <source file='/var/lib/libvirt/images/rhel62-2.img'/>
   <target dev='vdb' bus='virtio'/>
   <address type='pci' domain='0x0000' bus='0x00' slot='0x05' function='0x1'/>
   </disk>

3. KVM ゲスト仮想マシンで lspci を実行すると次のような出力になります。

   $ lspci
   
   00:05.0 SCSI storage controller: Red Hat, Inc Virtio block device
   00:05.1 SCSI storage controller: Red Hat, Inc Virtio block device

手順15.4 Red Hat Enterprise Linux 6 ゲストの回避策

1. acpid パッケージをインストールします

   acpid サービスによって ACPI 要求のリッスンと処理が行われます。
   ゲスト仮想マシンにログインし、ゲスト仮想マシンに acpid パッケージをインストールします。

   # yum install acpid

2. acpid サービスを有効にします

   acpid サービスがゲスト仮想マシンのブートシーケンスで起動され、サービスを開始するよう設定します。

   # systemctl enable acpid
   # service acpid start

3. ゲストドメイン xml を準備します。

   以下の要素を組み込むようにドメイン XML ファイルを編集します。virtio シリアルポートを org.qemu.guest_agent.0 に置き換え、$guestname の代わりにゲストの名前を使用します。

   
   <channel type='unix'>
      <source mode='bind' path='/var/lib/libvirt/qemu/{$guestname}.agent'/>
      <target type='virtio' name='org.qemu.guest_agent.0'/>
   </channel>
   

   図15.2 ゲスト XML の置き換え

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

   QEMU ゲストエージェント (QEMU-GA) をインストールし、11章QEMU-img および QEMU ゲストエージェントで指示されるようにサービスを起動します。Windows ゲストを実行している場合、この章ではこれに関する方法も記載されています。

5. ゲストをシャットダウンします。

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

      # virsh list --all  - this command lists all of the known domains 
         Id Name              State
      ----------------------------------
         rhel6                running

   2. ゲスト仮想マシンをシャットダウンします。

      # virsh shutdown rhel6
      
      Domain rhel6 is being shutdown

   3. ゲスト仮想マシンがシャットダウンするまで数秒間待機します。

      # virsh list --all
       Id Name                 State
      ----------------------------------
        . rhel6                shut off

   4. 編集した XML ファイルを使用して、rhel6 という名前のドメインを起動します。

      # virsh start rhel6

   5. rhel6 ゲスト仮想マシンで acpi をシャットダウンします。

      # virsh shutdown --mode acpi rhel6 

   6. すべてのドメインを再度一覧表示します。rhel6 が一覧にまだ表示されますが、電源が切れていることが示されるはずです。

      # virsh list --all
         Id Name                 State
      ----------------------------------
         rhel6                shut off

   7. 編集した XML ファイルを使用して、rhel6 という名前のドメインを起動します。

      # virsh start rhel6

   8. rhel6 ゲスト仮想マシンのゲストエージェントをシャットダウンします。

      # virsh shutdown --mode agent rhel6

   9. ドメインを一覧表示します。rhel6 がまだリストにあり、shut off 状態になっています。

      # virsh list --all
         Id Name                 State
      ----------------------------------
         rhel6                shut off

手順15.5 ゲストを正しくシャットダウンできるよう libvirt-guests サービスパラメーターを変更する

1. 設定ファイルを開きます。

   設定ファイルは /etc/sysconfig/libvirt-guests にあります。ファイルを編集し、コメントマーク (#) を削除し、ON_SHUTDOWN=suspend を ON_SHUTDOWN=shutdown に変更します。変更は必ず保存してください。

   $ vi /etc/sysconfig/libvirt-guests
   
   # URIs to check for running guests
   # example: URIS='default xen:/// vbox+tcp://host/system lxc:///'
   #URIS=default 
   
   # action taken on host boot
   # - start   all guests which were running on shutdown are started on boot
   #           regardless on their autostart settings                                 
   # - ignore  libvirt-guests init script won't start any guest on boot, however,     
   #           guests marked as autostart will still be automatically started by      
   #           libvirtd                                                               
   #ON_BOOT=start                                                                     
   
   # Number of seconds to wait between each guest start. Set to 0 to allow            
   # parallel startup.
   #START_DELAY=0
   
   # action taken on host shutdown
   # - suspend   all running guests are suspended using virsh managedsave
   # - shutdown  all running guests are asked to shutdown. Please be careful with
   #             this settings since there is no way to distinguish between a
   #             guest which is stuck or ignores shutdown requests and a guest
   #             which just needs a long time to shutdown. When setting
   #             ON_SHUTDOWN=shutdown, you must also set SHUTDOWN_TIMEOUT to a
   #             value suitable for your guests.
   ON_SHUTDOWN=shutdown
   
   # If set to non-zero, shutdown will suspend guests concurrently. Number of
   # guests on shutdown at any time will not exceed number set in this variable.
   #PARALLEL_SHUTDOWN=0
   
   # Number of seconds we're willing to wait for a guest to shut down. If parallel
   # shutdown is enabled, this timeout applies as a timeout for shutting down all
   # guests on a single URI defined in the variable URIS. If this is 0, then there
   # is no time out (use with caution, as guests might not respond to a shutdown
   # request). The default value is 300 seconds (5 minutes).
   #SHUTDOWN_TIMEOUT=300
   
   # If non-zero, try to bypass the file system cache when saving and
   # restoring guests, even though this may give slower operation for
   # some file systems.
   #BYPASS_CACHE=0

   	URIS - 実行中のゲストの指定された接続をチェックします。Default 設定は、明示的な URI が設定されていない場合に virsh と同じように機能します。さらに、URI は /etc/libvirt/libvirt.conf から明示的に設定できます。libvirt 設定ファイルのデフォルト設定を使用する場合、プロービングは使用されないことに注意してください。
   	ON_BOOT - ホストの起動時にゲストに対して実行される、またはゲスト上で実行されるアクションを指定します。 start オプションは、autostart の設定にかかわらず、シャットダウンの前に実行されているすべてのゲストを起動します。ignore オプションは、起動時に正式に実行されているゲストを起動しませんが、autostart というマークが付けられたゲストは libvirtd によって自動的に起動されます。
   	START_DELAY - ゲストが起動する間の遅延期間を設定します。この期間は秒単位で設定されます。遅延がないようにし、かつすべてのゲストを同時に起動させるには時間設定の 0 を使用します。
   	ON_SHUTDOWN - ホストがシャットダウンする際に取られるアクションを指定します。設定できるオプションには、以下が含まれます。virsh managedsave を使用して実行中のすべてのゲストを一時停止する suspend と、実行中のすべてのゲストをシャットダウンする shutdown です。shutdown オプションの場合、注意して使用するのは最良の策です。それは、停止した状態のゲストか、またはシャットダウン要求を無視するゲストと、シャットダウンにより長い時間がかかっているだけのゲストとを区別する方法がないためです。ON_SHUTDOWN=shutdown を設定する際には、SHUTDOWN_TIMEOUT をゲストに適した値に設定する必要もあります。
   	PARALLEL_SHUTDOWN 任意に行なわれるシャットダウン時のゲストの数がこの変数で設定される数を超えず、ゲストが同時に中断されることを定めます。0 に設定される場合、ゲストは同時にシャットダウンしません。
   	ゲストがシャットダウンするのを待機する秒数です。SHUTDOWN_TIMEOUT が有効な場合、このタイムアウトが、変数 URIS で定義される単一 URI 上のすべてのゲストをシャットダウンするタイムアウトとして適用されます。SHUTDOWN_TIMEOUT が 0 に設定される場合、タイムアウトはありません (ゲストがシャットダウン要求に応答しない可能性があるため注意して使用してください)。デフォルトの値は 300 秒 (5 分) です。
   	BYPASS_CACHE には、無効にするためには 0、有効にするには 1 と 2 つの値を使用することができます。有効にされている場合、ゲストが復元するとファイルシステムのキャッシュをバイパスします。この設定はパフォーマンスに影響を与え、一部のファイルシステムの操作の速度を低下させる可能性があることに注意してください。

2. libvirt-guests サービスを開始します。

   サービスをまだ開始していない場合は、libvirt-guests サービスを開始します。サービスの再起動により、実行中のすべてのドメインがシャットダウンする可能性があるので実行しないでください。