23.18.2. 源元素
<在池> 元素内，可以定义单一 <源> 元素（只能一个）。<源的子元素> 取决于存储池类型。以下是可以使用的 XML 的一些示例：
图 23.80. 源元素选项 1
...
<source>
<host name="iscsi.example.com"/>
<device path="demo-target"/>
<auth type='chap' username='myname'>
<secret type='iscsi' usage='mycluster_myname'/>
</auth>
<vendor name="Acme"/>
<product name="model"/>
</source>
...
图 23.81. 源元素选项 2
...
<source>
<adapter type='fc_host' parent='scsi_host5' wwnn='20000000c9831b4b' wwpn='10000000c9831b4b'/>
</source>
...
源接受的子元素在 表 23.28 “源子元素命令” 中阐述。
<>
| 元素 | 描述 |
|---|---|
<device> | 为由主机物理机器设备支持的存储池提供源（基于 <池 type=> （如 第 23.18 节 “存储池” 所示）。根据后端驱动程序，可以重复多次。包含一个属性 路径，它是块设备节点的完全限定路径。 |
<dir> | 为由目录（<池类型='dir'）支持的存储池>提供源，或选择基于文件系统的存储池中的子目录（<池类型='gluster'>）。此元素可能仅每一次（<池>）。此元素接受单个属性（<路径>），这是到后备目录的完整路径。 |
<adapter> | 为 SCSI 适配器支持的存储池提供源（<池 type='scsi'>）。此元素可能仅每一次（<池>）。属性名称是 SCSI 适配器名称（ex. "scsi_host1"。虽然 "host1" 仍支持向后兼容，但不建议这样做。属性 类型 指定适配器类型。有效值为 'fc_host'| 'scsi_host'。如果省略并指定了 name 属性，则默认为 type='scsi_host'。为保持向后兼容性， 适配器的属性类型是可选的，但 type='fc_host' adapter 是必需的。属性 wwn (Word Wide Node Name)和 wwpn (Word Wide Port Name)由 type='fc_host' 适配器用来唯一标识光纤通道存储结构中的设备（该设备可以是 HBA 或 vHBA）。必须指定 wwn 和 wwpn。有关如何获得(v)HBA 的 wwn/wwpn 的说明，请参考 第 20.27.11 节 “收集设备配置设置”。可选属性 parent 指定 type='fc_host' adapter 的父设备。 |
<主机> | 为从远程服务器存储支持的存储池提供源(type='netfs'|'iscsi'|'sheepdog'|'gluster'|'sheepdog'|'gluster')。此元素应当与 <目录或> <设备元素组合使用>。包含属性名称，即 服务器的主机名或 IP 地址。可以选择性地包含协议特定端口号的 port 属性。 |
<auth> | 如果存在，<auth> 元素通过设置 type 属性(pool type='iscsi'|'rbd')提供访问源所需的身份验证凭证。类型 必须是 ='chap' 或 type='ceph'。将"ceph"用于 Ceph RBD（Rados 块设备）网络源，将 "iscsi" 用于 CHAP(Challenge-Handshake Authentication Protocol)iSCSI 目标。另外，必需属性 username 可识别在身份验证期间使用的用户名以及带有强制属性类型的子元素 secret，以将其绑定到含有实际密码或其他凭证的 libvirt secret 对象。域 XML 有意不会公开密码，只向管理密码的对象的引用。secret 元素需要带有 secret 对象的 UUID 的 uuid 属性，或者与 secret 对象中指定的密钥匹配的用法属性。 |
<名称> | 从指定元素类型提供由存储设备支持的存储池源，它可取值：（ ）。 |
<format> | 提供有关存储池类型格式的信息，它可采用以下值： ）。请注意，此值特定于后端。这通常用来指示文件系统类型或网络文件系统类型，或者分区表类型或者 LVM 元数据类型。因为所有驱动程序都需要具有默认值，所以该元素是可选的。 |
<vendor> | 提供有关存储设备供应商的可选信息。它包含单一 <属性名称>，其值特定于后端。 |
<product> | 提供有关存储设备产品名称的可选信息。它包含单一 <属性名称>，其值特定于后端。 |
