From owner-svn-doc-head@FreeBSD.ORG Wed Mar 19 13:50:11 2014 Return-Path: Delivered-To: svn-doc-head@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 ESMTPS id 69AFA634; Wed, 19 Mar 2014 13:50:11 +0000 (UTC) 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 4A822928; Wed, 19 Mar 2014 13:50:11 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s2JDoBmh058686; Wed, 19 Mar 2014 13:50:11 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s2JDoBMc058685; Wed, 19 Mar 2014 13:50:11 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201403191350.s2JDoBMc058685@svn.freebsd.org> From: Dru Lavigne Date: Wed, 19 Mar 2014 13:50:11 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44285 - 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-head@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 19 Mar 2014 13:50:11 -0000 Author: dru Date: Wed Mar 19 13:50:10 2014 New Revision: 44285 URL: http://svnweb.freebsd.org/changeset/doc/44285 Log: Finish editorial review of iSCSI chapter. Sponsored by: iXsystems 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 Wed Mar 19 13:23:11 2014 (r44284) +++ head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml Wed Mar 19 13:50:10 2014 (r44285) @@ -5857,83 +5857,75 @@ target iqn.2012-06.com.example:target0 { Configuring an <acronym>iSCSI</acronym> Initiator - The current iSCSI initiator is + The iSCSI initiator described in this section is supported starting with &os; 10.0-RELEASE. To use the iSCSI initiator available in older - versions, refer to &man.iscontrol.8;. - This chapter only applies to the new initiator. + versions, refer to &man.iscontrol.8;. - The iSCSI initiator requires the iscsid(8) - daemon to run. It does not use a configuration file. To + The iSCSI initiator requires that the &man.iscsid.8; + daemon is running. This daemon does not use a configuration file. To start it automatically at boot, add this line to /etc/rc.conf: iscsid_enable="YES" - On a new machine being configured as an - iSCSI initiator, iscsid(8) - can be started by running this command as root: + To start &man.iscsid.8; now, + run this command: &prompt.root; service iscsid start Connecting to a target can be done with or without an - iscsi.conf(8) - configuration file. + /etc/iscsi.conf + configuration file. This section demonstrates both types of + connections. Connecting to a Target Without a Configuration File - To make the initiator connect to a single target, run - this command as root: - - &prompt.root; iscsictl -A -p 10.10.10.10 -t iqn.2012-06.com.example:target0 - - To verify if the connection succeeded, run it without - arguments. The output should look like this: + To connect an initiator to a single target, specify the + IP address of the portal and the name of + the target: + + &prompt.root; iscsictl -A -p 10.10.10.10 -t iqn.2012-06.com.example:target0 + + To verify if the connection succeeded, run + iscsictl without any + arguments. The output should look similar to this: Target name Target portal State iqn.2012-06.com.example:target0 10.10.10.10 Connected: da0 - This shows that the iSCSI session was + In this example, the iSCSI session was successfully established, with /dev/da0 representing the attached LUN. If the iqn.2012-06.com.example:target0 target exports more than one LUN, multiple - device nodes will be shown in the iscictl(8) + device nodes will be shown in that section of the output: Connected: da0 da1 da2. - Any errors are reported in the system logs, and also - visible in the iscictl(8) - output. For example, this usually means the iscsid(8) + Any errors will be reported in the output, as well as the system logs. + For example, this message usually means that the &man.iscsid.8; daemon is not running: Target name Target portal State iqn.2012-06.com.example:target0 10.10.10.10 Waiting for iscsid(8) - The following suggests a network-level problem, such as + The following message suggests a networking problem, such as a wrong IP address or port: Target name Target portal State iqn.2012-06.com.example:target0 10.10.10.11 Connection refused - This means the specified target name was wrong: + This message means that the specified target name is wrong: Target name Target portal State iqn.2012-06.com.example:atrget0 10.10.10.10 Not found - This means the target requires authentication: + This message means that the target requires authentication: Target name Target portal State iqn.2012-06.com.example:target0 10.10.10.10 Authentication failed @@ -5941,7 +5933,7 @@ iqn.2012-06.com.example:target0 To specify a CHAP username and secret, use this syntax: - &prompt.root; iscsictl -A -p 10.10.10.10 -t iqn.2012-06.com.example:target0 -u user -s secretsecret + &prompt.root; iscsictl -A -p 10.10.10.10 -t iqn.2012-06.com.example:target0 -u user -s secretsecret @@ -5960,19 +5952,19 @@ iqn.2012-06.com.example:target0 chapSecret = secretsecret } - t0 specifies a nickname for the - configuration file section, used at the initiator side to - specify which configuration to use. The following lines - specify various parameters used during connection. Target - address and name are mandatory, others are optional. In - this example, CHAP username and secret + The t0 specifies a nickname for the + configuration file section. It will be used by the initiator to + specify which configuration to use. The other lines + specify the parameters to use during connection. The TargetAddress + and TargetName are mandatory, whereas the other options are optional. In + this example, the CHAP username and secret are shown. - To connect to the target defined above, use: + To connect to the defined target, specify the nickname: - &prompt.root; iscsictl -An t0 + &prompt.root; iscsictl -An t0 - To connect to all targets defined in the configuration + Alternately, to connect to all targets defined in the configuration file, use: &prompt.root; iscsictl -Aa