External/libvirt
1
0
Fork 0
mirror of https://gitlab.com/libvirt/libvirt.git synced 2025-02-02 18:05:20 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: storage: Document SCSI pools

Browse Source
This commit is contained in:
Cole Robinson 2010-02-22 16:50:04 -05:00
parent e563b3b326
commit c5bad3ad21
2 changed files with 42 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
docs/formatstorage.html.in
View File

@ -84,6 +84,11 @@
only occur once. Contains a single attribute <code>path</code> only occur once. Contains a single attribute <code>path</code>
which is the fully qualified path to the block device node. which is the fully qualified path to the block device node.
<span class="since">Since 0.4.1</span></dd> <span class="since">Since 0.4.1</span></dd>
<dt><code>adapter</code></dt>
<dd>Provides the source for pools backed by SCSI adapters. May
only occur once. Contains a single attribute <code>name</code>
which is the SCSI adapter name (ex. "host1").
<span class="since">Since 0.6.2</span></dd>
<dt><code>host</code></dt> <dt><code>host</code></dt>
<dd>Provides the source for pools backed by storage from a <dd>Provides the source for pools backed by storage from a
remote server. Will be used in combination with a <code>directory</code> remote server. Will be used in combination with a <code>directory</code>

37
docs/storage.html.in
View File

@ -25,6 +25,9 @@ libvirt.
<li> <li>
<a href="#StorageBackendISCSI">iSCSI backend</a> <a href="#StorageBackendISCSI">iSCSI backend</a>
</li> </li>
<li>
<a href="#StorageBackendSCSI">SCSI backend</a>
</li>
</ul> </ul>
<h2><a name="StorageBackendDir" id="StorageBackendDir">Directory pool</a></h2> <h2><a name="StorageBackendDir" id="StorageBackendDir">Directory pool</a></h2>
@ -344,5 +347,39 @@ libvirt.
<p> <p>
The iSCSI volume pool does not use the volume format type element. The iSCSI volume pool does not use the volume format type element.
</p> </p>
<h2><a name="StorageBackendSCSI" id="StorageBackendSCSI">SCSI volume pools</a></h2>
<p>
This provides a pool based on a SCSI HBA. Volumes are preexisting SCSI
LUNs, and cannot be created via the libvirt APIs. Since /dev/XXX names
aren't generally stable, it is recommended to configure the pool
to use <code>/dev/disk/by-path</code> or <code>/dev/disk/by-id</code>
for the target path. These provide persistent stable naming for LUNs
<span class="since">Since 0.6.2</span></dd>
</p>
<h3>Example pool input</h3>
<pre>
&lt;pool type="scsi"&gt;
&lt;name&gt;virtimages&lt;/name&gt;
&lt;source&gt;
&lt;adapter name="host0"/&gt;
&lt;/source&gt;
&lt;target&gt;
&lt;path&gt;/dev/disk/by-path&lt;/path&gt;
&lt;/target&gt;
&lt;/pool&gt;</pre>
<h3>Valid pool format types</h3>
<p>
The SCSI volume pool does not use the pool format type element.
</p>
<h3>Valid volume format types</h3>
<p>
The SCSI volume pool does not use the volume format type element.
</p>
</body> </body>
</html> </html>