From owner-svn-doc-all@FreeBSD.ORG Mon Feb 11 21:50:50 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id C81BD517; Mon, 11 Feb 2013 21:50:50 +0000 (UTC) (envelope-from dru@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id AC50B96; Mon, 11 Feb 2013 21:50:50 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.5/8.14.5) with ESMTP id r1BLoorl058973; Mon, 11 Feb 2013 21:50:50 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.5/8.14.5/Submit) id r1BLooZY058972; Mon, 11 Feb 2013 21:50:50 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201302112150.r1BLooZY058972@svn.freebsd.org> From: Dru Lavigne Date: Mon, 11 Feb 2013 21:50:50 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r40951 - head/en_US.ISO8859-1/books/handbook/geom 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: Mon, 11 Feb 2013 21:50:50 -0000 Author: dru Date: Mon Feb 11 21:50:50 2013 New Revision: 40951 URL: http://svnweb.freebsd.org/changeset/doc/40951 Log: Patch to address wblock's comments. Approved by: gjb (mentor) Modified: head/en_US.ISO8859-1/books/handbook/geom/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/geom/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/geom/chapter.xml Mon Feb 11 21:36:00 2013 (r40950) +++ head/en_US.ISO8859-1/books/handbook/geom/chapter.xml Mon Feb 11 21:50:50 2013 (r40951) @@ -316,13 +316,13 @@ Done. used to replace the old single disk. &man.gmirror.8; requires a kernel module, - geom_mirror.ko, either compiled into a - custom kernel or loaded at boot- or run-time. To manually - load the kernel module now: + geom_mirror.ko, either built into the + kernel or loaded at boot- or run-time. Manually load the + kernel module now: &prompt.root; gmirror load - To create the mirror with the two new drives. + Create the mirror with the two new drives: &prompt.root; gmirror label -v gm0 /dev/ada1 /dev/ada2 @@ -336,8 +336,8 @@ Done. split-filesystem layout, with partitions for /, swap, /var, /tmp, and /usr. A - single / and a swap partition will also - work. + single / filesystem and a swap partition + will also work. Partitions on the mirror do not have to be the same size as those on the existing disk, but they must be large enough @@ -431,15 +431,15 @@ Done. Creating a Mirror with an Existing Drive - In this example, &os; has been installed on a single - disk, ada0. A new disk, + In this example, &os; has already been installed on a + single disk, ada0. A new disk, ada1, has been connected to the system. A one-disk mirror will be created on the new disk, the existing system copied onto it, and then the old disk will be inserted into the mirror. This slightly complex procedure is required because &man.gmirror.8; needs to put a 512-byte block of metadata at the end of each disk, and the existing - ada0 usually has all of its space + ada0 has usually had all of its space already allocated. Load the &man.gmirror.8; kernel module: @@ -463,8 +463,8 @@ Done. gzero.nop, even if the new drive (ada1) has more space. Note that the 1000204821504 in the second line - should be equal to the size of ada0 - as shown by &man.diskinfo.8;. + should be equal to ada0's media size + as shown by &man.diskinfo.8; above. &prompt.root; geom zero load &prompt.root; gnop create -s 1000204821504 gzero @@ -501,7 +501,7 @@ Done. be explained later. In either case, partition tables on the primary disk - should be copied first using the &man.gpart.8; + should be copied first with the &man.gpart.8; backup and restore subcommands. @@ -526,11 +526,12 @@ BSD 8 6 freebsd-ufs 130023424 838860800 7 freebsd-ufs 968884224 984640881 - If the whole disk shows as used in the output of - gpart show, the capacity in these partition - tables must be reduced by one sector. Edit the two files, - reducing the size of both the slice and last partition by one. - These are the last numbers in each listing. + If the output of gpart show shows no + free space at the end of the disk, the size of both the slice + and the last partition must be reduced by one sector. Edit + the two files, reducing the size of both the slice and last + partition by one. These are the last numbers in each + listing. &prompt.root; cat table.ada0 MBR 4 @@ -706,7 +707,7 @@ mirror/gm0 COMPLETE ada1 (ACTIVE) BIOS settings may have to be changed to boot from one of the new mirrored drives. Either mirror drive can be - used for booting as they contain identical data. + used for booting, as they contain identical data. @@ -764,7 +765,7 @@ mountroot> incorrect. Press the Enter key at the prompt. Undo the modifications so far by reverting /etc/fstab, mounting filesystems from - the original ada0 instead + the original disk (ada0) instead of the mirror. Reboot the system and try the procedure again.