os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Add missing articles ("the" and "a") in the iSCSI chapter.

Browse source
This commit is contained in:
Ed Maste 2013-10-22 20:37:06 +00:00
parent f9fcd39326
commit a24c8bfb53
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=43023
1 changed files with 15 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

30
en_US.ISO8859-1/books/handbook/network-servers/chapter.xml
View file

@ -5841,7 +5841,7 @@ Logging to FILE /var/log/messages</screen>
<title>iSCSI Target</title> <title>iSCSI Target</title>
<para>Note: the native iSCSI target is supported starting with <para>Note: the native iSCSI target is supported starting with
&os; 10.0-RELEASE. To use iSCSI in older versions, use &os; 10.0-RELEASE. To use iSCSI in older versions, use a
userspace target installed from ports, such as istgt. This userspace target installed from ports, such as istgt. This
chapter only applies to the native target.</para> chapter only applies to the native target.</para>
@ -5886,15 +5886,15 @@ target iqn.2012-06.com.example:target0 {
authentication. Following two lines make <ulink authentication. Following two lines make <ulink
url="http://www.freebsd.org/cgi/man.cgi?query=ctld&amp;sektion=8&amp;manpath=FreeBSD+10-current">ctld(8)</ulink> url="http://www.freebsd.org/cgi/man.cgi?query=ctld&amp;sektion=8&amp;manpath=FreeBSD+10-current">ctld(8)</ulink>
listen on all IPv4 ("listen 0.0.0.0") and IPv6 ("listen listen on all IPv4 ("listen 0.0.0.0") and IPv6 ("listen
[::]") addresses configured on network interfaces, on [::]") addresses configured on network interfaces, on the
default port (3560). One does not always need to define default port (3560). One does not always need to define
a new portal group - there is a default one, called a new portal group - there is a default one, called
"default". Difference between "default" and "pg0" above is "default". The difference between "default" and "pg0" above is
that with the former, the iSCSI SendTargets discovery is that with the former, the iSCSI SendTargets discovery is
always denied, while in the latter it is always always denied, while in the latter it is always
allowed.</para> allowed.</para>
<para>Second entry defines a single target. Target has two <para>The second entry defines a single target. Target has two
meanings - it is a machine serving iSCSI, but it's also meanings - it is a machine serving iSCSI, but it's also
a named group of LUNs. In this example, we use the latter a named group of LUNs. In this example, we use the latter
meaning. The "iqn.2012-06.com.example:target0" is the meaning. The "iqn.2012-06.com.example:target0" is the
@ -5905,21 +5905,21 @@ target iqn.2012-06.com.example:target0 {
"target0" can be pretty much whatever. There can be any "target0" can be pretty much whatever. There can be any
number of targets defined in the config file.</para> number of targets defined in the config file.</para>
<para>First line in the target configuration ("auth-group <para>The first line in the target configuration ("auth-group
no-authentication") allows every initiator to connect to it. no-authentication") allows every initiator to connect to it.
Second line ("portal-group pg0") makes the target reachable The second line ("portal-group pg0") makes the target reachable
through the "pg0" portal group.</para> through the "pg0" portal group.</para>
<para>After that come LUNs. To the initiator, each LUN will <para>After that come LUNs. To the initiator, each LUN will
be visible as a separate disk device - e.g. be visible as a separate disk device - e.g.
<filename>/dev/da0</filename>, <filename>/dev/da1</filename> <filename>/dev/da0</filename>, <filename>/dev/da1</filename>
etc. There may be multiple LUNs defined for each target. etc. There may be multiple LUNs defined for each target.
LUNs are identified by numbers; LUN 0 is mandatory. First LUNs are identified by numbers; LUN 0 is mandatory. The first
line of LUN configuration ("path /data/target0-0") defines line of LUN configuration ("path /data/target0-0") defines the
full path to a file or ZVOL backing the LUN. The file must full path to a file or ZVOL backing the LUN. The file must
exist before starting <ulink exist before starting <ulink
url="http://www.freebsd.org/cgi/man.cgi?query=ctld&amp;sektion=8&amp;manpath=FreeBSD+10-current">ctld(8)</ulink>. url="http://www.freebsd.org/cgi/man.cgi?query=ctld&amp;sektion=8&amp;manpath=FreeBSD+10-current">ctld(8)</ulink>.
Second line is optional and specifies the size.</para> The second line is optional and specifies the size.</para>
<para>To make sure <ulink <para>To make sure <ulink
url="http://www.freebsd.org/cgi/man.cgi?query=ctld&amp;sektion=8&amp;manpath=FreeBSD+10-current">ctld(8)</ulink> url="http://www.freebsd.org/cgi/man.cgi?query=ctld&amp;sektion=8&amp;manpath=FreeBSD+10-current">ctld(8)</ulink>
@ -5976,15 +5976,15 @@ target iqn.2012-06.com.example:target0 {
}</programlisting> }</programlisting>
<para>The auth-group section defines username/password pairs. <para>The auth-group section defines username/password pairs.
Initiator trying to connect to An initiator trying to connect to
iqn.2012-06.com.example:target0 must specify either of iqn.2012-06.com.example:target0 must specify either of
those. The SendTargets discovery is still permitted without those. The SendTargets discovery is still permitted without
any kind of authentication; to change it, set any kind of authentication; to change it, set
"discovery-auth-group" to something else.</para> "discovery-auth-group" to something else.</para>
<para>Common case for iSCSI is to have a single exported <para>A common case for iSCSI is to have a single exported
target for every initiator. As a shorthand for syntax target for every initiator. As a shorthand for syntax
above, one can specify username and password directly in the above, one can specify the username and password directly in the
target entry, like this:</para> target entry, like this:</para>
<programlisting>target iqn.2012-06.com.example:target0 { <programlisting>target iqn.2012-06.com.example:target0 {
@ -6004,7 +6004,7 @@ target iqn.2012-06.com.example:target0 {
<note> <note>
<para>The current iSCSI initiator is supported starting with <para>The current iSCSI initiator is supported starting with
&os; 10.0-RELEASE. To use iSCSI initiator available in &os; 10.0-RELEASE. To use the iSCSI initiator available in
older versions, refer to <ulink older versions, refer to <ulink
url="http://www.freebsd.org/cgi/man.cgi?query=iscontrol&amp;sektion=8&amp;manpath=FreeBSD+10-current">iscontrol(8)</ulink>. url="http://www.freebsd.org/cgi/man.cgi?query=iscontrol&amp;sektion=8&amp;manpath=FreeBSD+10-current">iscontrol(8)</ulink>.
This chapter only applies to the new This chapter only applies to the new
@ -6065,7 +6065,7 @@ iqn.2012-06.com.example:target0 10.10.10.10 Connected: da0</
<programlisting>Target name Target addr State <programlisting>Target name Target addr State
iqn.2012-06.com.example:target0 10.10.10.10 Waiting for iscsid(8)</programlisting> iqn.2012-06.com.example:target0 10.10.10.10 Waiting for iscsid(8)</programlisting>
<para>The following suggests network-level problem, such as <para>The following suggests a network-level problem, such as a
wrong <acronym>IP</acronym> address or port:</para> wrong <acronym>IP</acronym> address or port:</para>
<programlisting>Target name Target addr State <programlisting>Target name Target addr State
@ -6083,7 +6083,7 @@ iqn.2012-06.com.example:atrget0 10.10.10.10 Not found</progr
<programlisting>Target name Target addr State <programlisting>Target name Target addr State
iqn.2012-06.com.example:target0 10.10.10.10 Authentication failed</programlisting> iqn.2012-06.com.example:target0 10.10.10.10 Authentication failed</programlisting>
<para>To specify CHAP username and secret, use the following <para>To specify a CHAP username and secret, use the following
syntax:</para> syntax:</para>
<screen>&prompt.root; <userinput>iscsictl -A -h 10.10.10.10 -t iqn.2012-06.com.example:target0 -u user -s secretsecret</userinput></screen> <screen>&prompt.root; <userinput>iscsictl -A -h 10.10.10.10 -t iqn.2012-06.com.example:target0 -u user -s secretsecret</userinput></screen>