[virtualization-guide] final iSCSI commit fix up

Chris Curran tsagadai at fedoraproject.org
Mon Jul 5 02:17:41 UTC 2010


commit 21c837c750bb72286813f838fa218d9a19e7f19c
Author: Chris Curran <ccurran at redhat.com>
Date:   Mon Jul 5 12:17:33 2010 +1000

    final iSCSI commit fix up

 en-US/Storage_Pools_iSCSI.xml |   13 +++++++++----
 1 files changed, 9 insertions(+), 4 deletions(-)
---
diff --git a/en-US/Storage_Pools_iSCSI.xml b/en-US/Storage_Pools_iSCSI.xml
index 5191a21..292654a 100644
--- a/en-US/Storage_Pools_iSCSI.xml
+++ b/en-US/Storage_Pools_iSCSI.xml
@@ -324,13 +324,18 @@ Pool trial1 defined
 </screen>
 			</step>
 			<step>
-				<title><emphasis role="bold">Alternative step:</emphasis> Use pool-define-as from command line</title>
+				<title><emphasis role="bold">Alternative step:</emphasis> Use pool-define-as to define the pool from the command line</title>
 				<para>
-					Use the <command>virsh pool-define-as</command> command to define a new storage pool. There are two options required for creating directory-based storage pools:
+					Storage pool definitions can be created with the <command>virsh</command> command line tool. Creating storage pools with <command>virsh</command> is useful for systems administrators using scripts to create multiple storage pools.</para><para>
+					The <command>virsh pool-define-as</command> command has several parameters which are accepted in the following format:</para>
+					<screen>virsh pool-define-as <parameter>name type source-host source-path source-dev source-name</parameter> <replaceable>target</replaceable></screen>
+					The type, <parameter>iscsi</parameter>, defines this pool as an iSCSI based storage pool. The <parameter>name</parameter> parameter must be unique and sets the name for the storage pool. The <parameter>source-host</parameter> and <parameter>source-path</parameter> parameters are the hostname and iSCSI IQN respectively. The <parameter>source-dev</parameter> and <parameter>source-name</parameter> parameters are not required for iSCSI-based pools, use a <keycap>-</keycap> character to leave the field blank. The <replaceable>target</replaceable> parameter defines the location for mounting the iSCSI device on the host.
 				</para>
-				<screen> # virsh pool-define-as <replaceable>trial1</replaceable> iscsi - - - - "<replaceable>/dev/disk/by-path</replaceable>"
+				<para>The example below creates the same iSCSI-based storage pool as the previous step.</para>
+				<screen># virsh pool-define-as <replaceable>trial1</replaceable> iscsi server1.example.com iqn.2010-05.com.example.server1:trial1 - - /dev/disk/by-path
 Pool trial1 defined</screen>
-			</step>
+
+</step>
 			<step>
 				<title>Verify the storage pool is listed</title>
 				<para>


More information about the docs-commits mailing list