From owner-svn-doc-all@FreeBSD.ORG Fri Mar 7 22:02:49 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id C9A52560; Fri, 7 Mar 2014 22:02:49 +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 A3BE236F; Fri, 7 Mar 2014 22:02:49 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s27M2n14072691; Fri, 7 Mar 2014 22:02:49 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s27M2njW072690; Fri, 7 Mar 2014 22:02:49 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201403072202.s27M2njW072690@svn.freebsd.org> From: Dru Lavigne Date: Fri, 7 Mar 2014 22:02:49 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44191 - 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.17 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: Fri, 07 Mar 2014 22:02:50 -0000 Author: dru Date: Fri Mar 7 22:02:49 2014 New Revision: 44191 URL: http://svnweb.freebsd.org/changeset/doc/44191 Log: Add a bit to the iSCSI intro. Slight tightening of section headings. 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 Fri Mar 7 21:38:19 2014 (r44190) +++ head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml Fri Mar 7 22:02:49 2014 (r44191) @@ -5657,30 +5657,44 @@ Logging to FILE /var/log/messagesiSCSI Initiator and Target Configuration - iSCSI is a way to share storage, to make - disk space at one machine (the server, in iSCSI nomenclature - known as the target) available to others - (clients, called initiators in - iSCSI). The main difference when compared to - NFS is that NFS works at a - filesystem level, while iSCSI works at the - block device level. To initiators, remote disks served via - iSCSI are just like physical disks. Their - device nodes appear in /dev/, and must be - separately mounted. + iSCSI is a way to share storage over a + network. Unlike + NFS, which works at the + file system level, iSCSI works at the + block device level. + + In iSCSI terminology, the system that + shares the storage is + known as the target. The storage can be a + physical disk, or an area representing multiple disks or a + portion of a physical disk. For example, if the disk(s) are + formatted with ZFS, a zvol can be created to + use as the iSCSI storage. + + The clients which access the iSCSI + storage are called initiators. + To initiators, the storage available through + iSCSI appears as a raw, unformatted disk + known as a LUN. + Device nodes for the disk appear in /dev/ and the device must be + separately formatted and mounted. + + Beginning with 10.0-RELEASE, &os; provides a native, + kernel-based iSCSI target and initiator. + This section describes how to configure a &os; system as a + target or an initiator. - <acronym>iSCSI</acronym> Target + Configuring an <acronym>iSCSI</acronym> Target + Note: the native iSCSI target is supported starting with &os; 10.0-RELEASE. To use iSCSI in older versions of &os;, install a userspace target from the Ports Collection, such as net/istgt. This chapter only describes the native target. - - - Basic Operation + Configuring an iSCSI target is straightforward: create the @@ -5793,7 +5807,6 @@ target iqn.2012-06.com.example:target0 { to reread it: &prompt.root; service ctld reload - Authentication @@ -5849,7 +5862,7 @@ target iqn.2012-06.com.example:target0 { - <acronym>iSCSI</acronym> Initiator + Configuring an <acronym>iSCSI</acronym> Initiator The current iSCSI initiator is