From owner-freebsd-doc@FreeBSD.ORG Tue Jun 30 00:00:16 2009 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id BD5E01065672 for ; Tue, 30 Jun 2009 00:00:16 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id A953F8FC18 for ; Tue, 30 Jun 2009 00:00:16 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id n5U00GkA039575 for ; Tue, 30 Jun 2009 00:00:16 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id n5U00GkG039562; Tue, 30 Jun 2009 00:00:16 GMT (envelope-from gnats) Date: Tue, 30 Jun 2009 00:00:16 GMT Message-Id: <200906300000.n5U00GkG039562@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Dan Naumov Cc: Subject: Re: docs/135983: "The Z File System" - title is misleading and causes search issue X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Dan Naumov List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 30 Jun 2009 00:00:17 -0000 The following reply was made to PR docs/135983; it has been noted by GNATS. From: Dan Naumov To: bug-followup@FreeBSD.org, dan.naumov@gmail.com Cc: Subject: Re: docs/135983: "The Z File System" - title is misleading and causes search issue Date: Tue, 30 Jun 2009 02:53:02 +0300 Patch below, please comment if you disagree or commit if you don't :) ============================================================== diff -ru /DATA/bsdwork/docs/doc/en_US.ISO8859-1/books/handbook/filesystems/chapter.sgml /DATA/bsdwork/docs/doc-mine/en_US.ISO8859-1/books/handbook/filesystems/chapter.sgml --- /DATA/bsdwork/docs/doc/en_US.ISO8859-1/books/handbook/filesystems/chapter.sgml 2008-11-26 06:54:41.000000000 +0200 +++ /DATA/bsdwork/docs/doc-mine/en_US.ISO8859-1/books/handbook/filesystems/chapter.sgml 2009-06-30 02:33:10.786630005 +0300 @@ -108,7 +108,7 @@ - The Z File System + The Z File System (ZFS) The Z file system, developed by &sun;, is a new technology designed to use a pooled storage method. This means @@ -198,19 +198,20 @@ &prompt.root; echo 'zfs_enable="YES"' >> /etc/rc.conf &prompt.root; /etc/rc.d/zfs start - The remainder of this document assumes two + The remainder of this document assumes 3 SCSI disks are available, and their device names - are da0 - and da1 - respectively. Users of IDE hardware may - use the ad + are da0, + da1 + and da2. + Users of IDE hardware may use the + ad devices in place of SCSI hardware. Single Disk Pool - To create a ZFS over a single disk - device, use the zpool command: + To create a simple, non-redundant ZFS pool using a + single disk device, use the zpool command: &prompt.root; zpool create example /dev/da0 @@ -340,13 +341,19 @@ <acronym>ZFS</acronym> RAID-Z As previously noted, this section will assume that - two SCSI exists as devices - da0 and - da1. To create a + 3 SCSI discs exist as devices + da0, da1 + and da2. To create a RAID-Z pool, issue the following command: - &prompt.root; zpool create storage raidz da0 da1 + &prompt.root; zpool create storage raidz da0 da1 da2 + + The recommended amount of devices to be used in a RAID-Z + configuration is 3-9. If your needs call for a single pool to consist of 10 disks or more, + consider breaking it up into groups of smaller RAID-Z. If you only + have 2 disks and require redundancy, consider using a ZFS mirror + configuration. See the &man.zpool.8; manual page for more details. The storage zpool should have been created. This may be verified by using the &man.mount.8; and @@ -432,8 +439,8 @@ /dev/ad0s1a 2026030 235240 1628708 13% / devfs 1 1 0 100% /dev /dev/ad0s1d 54098308 1032826 48737618 2% /usr -storage 17547008 0 17547008 0% /storage -storage/home 17547008 0 17547008 0% /home +storage 26320512 0 26320512 0% /storage +storage/home 26320512 0 26320512 0% /home This completes the RAID-Z configuration. To get status updates about the file systems @@ -477,6 +484,7 @@ raidz1 DEGRADED 0 0 0 da0 ONLINE 0 0 0 da1 OFFLINE 0 0 0 + da2 ONLINE 0 0 0 errors: No known data errors @@ -509,6 +517,7 @@ raidz1 ONLINE 0 0 0 da0 ONLINE 0 0 0 da1 ONLINE 0 0 0 + da2 ONLINE 0 0 0 errors: No known data errors @@ -556,6 +565,7 @@ raidz1 ONLINE 0 0 0 da0 ONLINE 0 0 0 da1 ONLINE 0 0 0 + da2 ONLINE 0 0 0 errors: No known data errors ============================================================== - Sincerely, Dan Naumov