From owner-svn-doc-all@FreeBSD.ORG Tue Oct 22 20:37:07 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 080F96F3; Tue, 22 Oct 2013 20:37:07 +0000 (UTC) (envelope-from emaste@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id D96A3266E; Tue, 22 Oct 2013 20:37:06 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r9MKb6m2035291; Tue, 22 Oct 2013 20:37:06 GMT (envelope-from emaste@svn.freebsd.org) Received: (from emaste@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r9MKb69t035290; Tue, 22 Oct 2013 20:37:06 GMT (envelope-from emaste@svn.freebsd.org) Message-Id: <201310222037.r9MKb69t035290@svn.freebsd.org> From: Ed Maste Date: Tue, 22 Oct 2013 20:37:06 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r43023 - head/en_US.ISO8859-1/books/handbook/network-servers X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 22 Oct 2013 20:37:07 -0000 Author: emaste (src committer) Date: Tue Oct 22 20:37:06 2013 New Revision: 43023 URL: http://svnweb.freebsd.org/changeset/doc/43023 Log: Add missing articles ("the" and "a") in the iSCSI chapter. Modified: head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml Tue Oct 22 19:39:03 2013 (r43022) +++ head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml Tue Oct 22 20:37:06 2013 (r43023) @@ -5841,7 +5841,7 @@ Logging to FILE /var/log/messagesiSCSI Target 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 chapter only applies to the native target. @@ -5886,15 +5886,15 @@ target iqn.2012-06.com.example:target0 { authentication. Following two lines make ctld(8) 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 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 always denied, while in the latter it is always allowed. - Second entry defines a single target. Target has two + The second entry defines a single target. Target has two meanings - it is a machine serving iSCSI, but it's also a named group of LUNs. In this example, we use the latter 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 number of targets defined in the config file. - First line in the target configuration ("auth-group + The first line in the target configuration ("auth-group 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. After that come LUNs. To the initiator, each LUN will be visible as a separate disk device - e.g. /dev/da0, /dev/da1 etc. There may be multiple LUNs defined for each target. - LUNs are identified by numbers; LUN 0 is mandatory. First - line of LUN configuration ("path /data/target0-0") defines + LUNs are identified by numbers; LUN 0 is mandatory. The first + line of LUN configuration ("path /data/target0-0") defines the full path to a file or ZVOL backing the LUN. The file must exist before starting ctld(8). - Second line is optional and specifies the size. + The second line is optional and specifies the size. To make sure ctld(8) @@ -5976,15 +5976,15 @@ target iqn.2012-06.com.example:target0 { } 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 those. The SendTargets discovery is still permitted without any kind of authentication; to change it, set "discovery-auth-group" to something else. - Common case for iSCSI is to have a single exported + A common case for iSCSI is to have a single exported 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: target iqn.2012-06.com.example:target0 { @@ -6004,7 +6004,7 @@ target iqn.2012-06.com.example:target0 { 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 iscontrol(8). This chapter only applies to the new @@ -6065,7 +6065,7 @@ iqn.2012-06.com.example:target0 Target name Target addr State iqn.2012-06.com.example:target0 10.10.10.10 Waiting for iscsid(8) - The following suggests network-level problem, such as + The following suggests a network-level problem, such as a wrong IP address or port: Target name Target addr State @@ -6083,7 +6083,7 @@ iqn.2012-06.com.example:atrget0 Target name Target addr State iqn.2012-06.com.example:target0 10.10.10.10 Authentication failed - To specify CHAP username and secret, use the following + To specify a CHAP username and secret, use the following syntax: &prompt.root; iscsictl -A -h 10.10.10.10 -t iqn.2012-06.com.example:target0 -u user -s secretsecret