Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

12.4. ストレージプールを作成するパラメーター

必要なストレージプールのタイプに基づいて、その XML 設定ファイルを変更し、特定のタイプのストレージプールを定義できます。このセクションは、さまざまなタイプのストレージプールを作成するために必要な XML パラメーターと、例を説明します。

12.4.1. ディレクトリーベースのストレージプールのパラメーター
リンクのコピー

XML 設定ファイルを使用してディレクトリーベースのストレージプールを作成または変更する場合は、必要なパラメーターを指定する必要があります。これらのパラメーターの詳細は、以下の表を参照してください。

virsh pool-define を使用すると、指定したファイルの XML 設定を基にしてストレージプールを作成できます。以下に例を示します。 

# virsh pool-define ~/guest_images.xml
  Pool defined from guest_images_dir

パラメーター

以下の表は、ディレクトリーベースのストレージプールの XML ファイルに必要なパラメーターのリストです。

Expand
表12.1 ディレクトリーベースのストレージプールのパラメーター
説明XML

ストレージプールのタイプ 

<pool type='dir'>

ストレージプールの名前 

<name>name</name>

ターゲットを指定するパス。ストレージプールに使用されるパスになります。 

<target>
   <path>target_path</path>
</target>

例

以下は、/guest_images ディレクトリーに基づいたストレージプールの XML ファイルの例です。 

<pool type='dir'>
  <name>dirpool</name>
  <target>
    <path>/guest_images</path>
  </target>
</pool>

12.4.2. ディスクベースのストレージプールのパラメーター
リンクのコピー

XML 設定ファイルを使用してディスクベースのストレージプールを作成または変更する場合は、必要なパラメーターを指定する必要があります。これらのパラメーターの詳細は、以下の表を参照してください。

virsh pool-define を使用すると、指定したファイルの XML 設定を基にしてストレージプールを作成できます。以下に例を示します。 

# virsh pool-define ~/guest_images.xml
  Pool defined from guest_images_disk

パラメーター

以下の表は、ディスクベースのストレージプールの XML ファイルに必要なパラメーターのリストです。

Expand
表12.2 ディスクベースのストレージプールのパラメーター
説明XML

ストレージプールのタイプ 

<pool type='disk'>

ストレージプールの名前 

<name>name</name>

ストレージデバイスを指定するパス。たとえば、/dev/sdb です。 

<source>
   <path>source_path</path>
</source>

ターゲットデバイスを指定するパス。ストレージプールに使用されるパスになります。 

<target>
   <path>target_path</path>
</target>

例

以下は、ディスクに基づいたストレージプールに対する XML ファイルの例です。 

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

12.4.3. ファイルシステムベースのストレージプールパラメーター
リンクのコピー

XML 設定ファイルを使用してファイルシステムベースのストレージプールを作成または変更する場合は、必要なパラメーターを指定する必要があります。これらのパラメーターの詳細は、以下の表を参照してください。

virsh pool-define を使用すると、指定したファイルの XML 設定を基にしてストレージプールを作成できます。以下に例を示します。 

# virsh pool-define ~/guest_images.xml
  Pool defined from guest_images_fs

パラメーター

次の表は、ファイルシステムベースのストレージプールの XML ファイルに必要なパラメーターのリストです。

Expand
表12.3 ファイルシステムベースのストレージプールパラメーター
説明XML

ストレージプールのタイプ 

<pool type='fs'>

ストレージプールの名前 

<name>name</name>

パーミッションを指定するパス。たとえば、/dev/sdc1 です。 

<source>
   <device path=device_path />

ファイルシステムのタイプ (ext4 など)。 

   <format type=fs_type />
</source>

ターゲットを指定するパス。ストレージプールに使用されるパスになります。 

<target>
   <path>path-to-pool</path>
</target>

例

以下は、/dev/sdc1 パーティションに基づいたストレージプールに対する XML ファイルの例です。 

<pool type='fs'>
  <name>guest_images_fs</name>
  <source>
    <device path='/dev/sdc1'/>
    <format type='auto'/>
  </source>
  <target>
    <path>/guest_images</path>
  </target>
</pool>

12.4.4. GlusterFS ベースのストレージプールパラメーター
リンクのコピー

XML 設定ファイルを使用して GlusterFS ベースのストレージプールを作成または変更する場合は、必要なパラメーターを指定する必要があります。これらのパラメーターの詳細は、以下の表を参照してください。

virsh pool-define を使用すると、指定したファイルの XML 設定を基にしてストレージプールを作成できます。以下に例を示します。 

# virsh pool-define ~/guest_images.xml
  Pool defined from guest_images_glusterfs

パラメーター

以下の表は、GlusterFS ベースのストレージプールの XML ファイルに必要なパラメーターのリストです。

Expand
表12.4 GlusterFS ベースのストレージプールパラメーター
説明XML

ストレージプールのタイプ 

<pool type='gluster'>

ストレージプールの名前 

<name>name</name>

Gluster サーバーのホスト名または IP アドレス 

<source>
   <name=gluster-name />

ストレージプールに使用される Gluster サーバーのパス。 

   <dir path=gluster-path />
</source>

例

以下は、111.222.111.222 の Gluster ファイルシステムに基づいたストレージプールに対する XML ファイルの例です。 

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

12.4.5. iSCSI ベースのストレージプールパラメーター
リンクのコピー

XML 設定ファイルを使用して iSCSI ベースのストレージプールを作成または変更する場合は、必要なパラメーターを指定する必要があります。これらのパラメーターの詳細は、以下の表を参照してください。

virsh pool-define を使用すると、指定したファイルの XML 設定を基にしてストレージプールを作成できます。以下に例を示します。 

# virsh pool-define ~/guest_images.xml
  Pool defined from guest_images_iscsi

パラメーター

以下の表は、iSCSI ベースのストレージプールの XML ファイルに必要なパラメーターのリストです。

Expand
表12.5 iSCSI ベースのストレージプールパラメーター
説明XML

ストレージプールのタイプ 

<pool type='iscsi'>

ストレージプールの名前 

<name>name</name>

ホストの名前 

<source>
   <host name=hostname />

iSCSI IQN 

   <device path=iSCSI_IQN />
</source>

ターゲットを指定するパス。ストレージプールに使用されるパスになります。 

<target>
   <path>/dev/disk/by-path</path>
</target>

[オプション] iSCSI イニシエーターの IQN。これは、ACL が LUN を特定のイニシエーターに制限する場合に限り必要です。 

<initiator>
   <iqn name='initiator0' />
</initiator>
注記

iSCSI イニシエーターの IQN は、virsh find-storage-pool-sources-as iscsi コマンドを使用して指定できます。

例

以下は、指定した iSCSI に基づいたストレージプールに対する XML ファイルの例です。 

<pool type='iscsi'>
  <name>iSCSI_pool</name>
  <source>
    <host name='server1.example.com'/>
    <device path='iqn.2010-05.com.example.server1:iscsirhel7guest'/>
  </source>
  <target>
    <path>/dev/disk/by-path</path>
  </target>
</pool>

12.4.6. LVM ベースのストレージプールパラメーター
リンクのコピー

XML 設定ファイルを使用して LVM ベースのストレージプールを作成または変更する場合は、必要なパラメーターを指定する必要があります。これらのパラメーターの詳細は、以下の表を参照してください。

virsh pool-define を使用すると、指定したファイルの XML 設定を基にしてストレージプールを作成できます。以下に例を示します。 

# virsh pool-define ~/guest_images.xml
  Pool defined from guest_images_logical

パラメーター

以下の表は、LVM ベースのストレージプールの XML ファイルに必要なパラメーターのリストです。

Expand
表12.6 LVM ベースのストレージプールパラメーター
説明XML

ストレージプールのタイプ 

<pool type='logical'>

ストレージプールの名前 

<name>name</name>

ストレージプールのデバイスのパス 

<source>
   <device path='device_path' />

ボリュームグループの名前 

   <name>VG-name</name>

仮想グループの形式 

   <format type='lvm2' />
</source>

ターゲットパス 

<target>
   <path=target_path />
</target>
注記

論理ボリュームグループが複数のディスクパーティションで構成されている場合は、複数のソースデバイスがリストされることがあります。以下に例を示します。 

<source>
  <device path='/dev/sda1'/>
  <device path='/dev/sdb3'/>
  <device path='/dev/sdc2'/>
  ...
</source>

例

以下は、指定した LVM に基づいたストレージプールに対する XML ファイルの例です。 

<pool type='logical'>
  <name>guest_images_lvm</name>
  <source>
    <device path='/dev/sdc'/>
    <name>libvirt_lvm</name>
    <format type='lvm2'/>
  </source>
  <target>
    <path>/dev/libvirt_lvm</path>
  </target>
</pool>

12.4.7. NFS ベースのストレージプールパラメーター
リンクのコピー

XML 設定ファイルを使用して NFS ベースのストレージプールを作成または変更する場合は、必要なパラメーターを指定する必要があります。これらのパラメーターの詳細は、以下の表を参照してください。

virsh pool-define を使用すると、指定したファイルの XML 設定を基にしてストレージプールを作成できます。以下に例を示します。 

# virsh pool-define ~/guest_images.xml
  Pool defined from guest_images_netfs

パラメーター

以下の表は、NFS ベースのストレージプールの XML ファイルに必要なパラメーターのリストです。

Expand
表12.7 NFS ベースのストレージプールパラメーター
説明XML

ストレージプールのタイプ 

<pool type='netfs'>

ストレージプールの名前 

<name>name</name>

マウントポイントがあるネットワークサーバーのホスト名。これは、ホスト名または IP アドレスになります。 

<source>
   <host name=hostname />

ストレージプールの形式

次のいずれかになります。 

   <format type='nfs' />
 
   <format type='glusterfs' />
 
   <format type='cifs' />

ネットワークサーバーで使用されるディレクトリー 

   <dir path=source_path />
</source>

ターゲットを指定するパス。ストレージプールに使用されるパスになります。 

<target>
   <path>target_path</path>
</target>

例

以下は、NFS サーバー file_server の /home/net_mount ディレクトリーでのストレージプールの XML ファイルの例です。 

<pool type='netfs'>
  <name>nfspool</name>
  <source>
    <host name='file_server'/>
    <format type='nfs'/>
    <dir path='/home/net_mount'/>
  </source>
  <target>
    <path>/var/lib/libvirt/images/nfspool</path>
  </target>
</pool>

12.4.8. vHBA デバイスを使用した SCSI ベースのストレージプールのパラメーター
リンクのコピー

仮想ホストアダプターバス (vHBA) デバイスを使用する SCSi ベースのストレージプール用の XML 設定ファイルを作成または変更する場合は、XML 設定ファイルに必要な特定のパラメーターを含める必要があります。必要なパラメーターの詳細は、以下の表を参照してください。

virsh pool-define を使用すると、指定したファイルの XML 設定を基にしてストレージプールを作成できます。以下に例を示します。 

# virsh pool-define ~/guest_images.xml
  Pool defined from guest_images_vhba

パラメーター

次の表は、vHBA を使用した SCSI ベースのストレージプールの XML ファイルに必要なパラメーターのリストを示しています。

Expand
表12.8 vHBA デバイスを使用した SCSI ベースのストレージプールのパラメーター
説明XML

ストレージプールのタイプ 

<pool type='scsi'>

ストレージプールの名前 

<name>name</name>

vHBA の識別子。parent 属性はオプションです。 

<source>
   <adapter type='fc_host'
   [parent=parent_scsi_device]
   wwnn='WWNN'
   wwpn='WWPN' />
</source>

ターゲットパス。ストレージプールに使用されるパスになります。 

<target>
   <path=target_path />
</target>
重要

<path> フィールドが /dev/ の場合、libvirt は、ボリュームデバイスパスで一意の短いデバイスパスを生成します。たとえば、/dev/sdc です。それ以外の場合は、物理ホストパスが使用されます。たとえば、/dev/disk/by-path/pci-0000:10:00.0-fc-0x5006016044602198-lun-0 などです。一意の短いデバイスパスを使用すると、複数のストレージプールで、同じボリュームを複数の仮想マシン (VM) にリスト表示できます。物理ホストのパスを複数の仮想マシンで使用すると、デバイスタイプが重複していることを示す警告が発生することがあります。

注記

parent 属性は、パスを変更して NPIV LUN の使用元となる物理 HBA の親を識別する <adapter> フィールドで使用できます。scsi_hostN フィールドは、vports 属性および max_vports 属性と合わせて、親 ID を作成します。parent、parent_wwnn、parent_wwpn、または parent_fabric_wwn の属性は、ホストの再起動後に同じ HBA が使用されることを保証するさまざまなレベルを提供します。

  • 親 を指定しないと、libvirt は、NPIV に対応する最初の scsi_hostN アダプターを使用します。
  • 親 のみを指定し、設定に SCSI ホストアダプターを追加すると、問題が発生する可能性があります。
  • parent_wwnn または parent_wwpn を指定すると、ホストの再起動後に同じ HBA が使用されます。
  • ホストの再起動後、parent_fabric_wwn を使用すると、scsi_hostN が使用されたかどうかにかかわらず、同じファブリックの HBA が選択されます。

例

以下は、vHBA を使用する SCSI ベースのストレージプールの XML ファイルの例です。

  • HBA にある唯一のストレージプール 

    <pool type='scsi'>
  <name>vhbapool_host3</name>
  <source>
    <adapter type='fc_host' wwnn='5001a4a93526d0a1' wwpn='5001a4ace3ee047d'/>
  </source>
  <target>
    <path>/dev/disk/by-path</path>
  </target>
</pool>

  • parent 属性を使用して SCSI ホストデバイスを識別し、vHBA を 1 つ使用する複数のストレージプールの 1 つ。 

    <pool type='scsi'>
  <name>vhbapool_host3</name>
  <source>
    <adapter type='fc_host' parent='scsi_host3' wwnn='5001a4a93526d0a1' wwpn='5001a4ace3ee047d'/>
  </source>
  <target>
    <path>/dev/disk/by-path</path>
  </target>
</pool>
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hatトップに戻る