From owner-freebsd-doc@FreeBSD.ORG Sun Jul 12 18:34:01 2009 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 801F7106566B for ; Sun, 12 Jul 2009 18:34:01 +0000 (UTC) (envelope-from minimarmot@gmail.com) Received: from mail-ew0-f227.google.com (mail-ew0-f227.google.com [209.85.219.227]) by mx1.freebsd.org (Postfix) with ESMTP id 097358FC16 for ; Sun, 12 Jul 2009 18:34:00 +0000 (UTC) (envelope-from minimarmot@gmail.com) Received: by ewy27 with SMTP id 27so1128095ewy.43 for ; Sun, 12 Jul 2009 11:34:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:in-reply-to:references :date:message-id:subject:from:to:cc:content-type :content-transfer-encoding; bh=k6ZizUIwIKljlTwSwyi/CGnHVw1G/C05UXwqt+aFGXw=; b=FBe7ahPtD5nrRB8pboBBPUIrX8izJPIV3hvAHv9N02rFbKfNxLJNPMw+FtssRYFaiH NSxFJN3iHirQno9+Cm4N4G/SCX+dzlbXVOckhYpKkoervj8FS5p26FvaXs8FcYfk6+5Q YJCF5TPtZNq+oDJZ+MkpBGLEwlXzGsZVGG1iQ= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type:content-transfer-encoding; b=D6YvMmtg3sd66TBEJL60rUjyN5b7UEaIBsSpwDBW3PbQoaZXZ99paclj+esJUQRYe7 xH3d8spbycXhlcGDNZiQet/RhNO+f6JCXkXpzAr9KPNs8lH9OyCLfFScr3SU2WqQUVjC Ags++N0kLOjd5u4IqBxu1FJGP1iPM8q5nzXSY= MIME-Version: 1.0 Received: by 10.211.194.9 with SMTP id w9mr3769543ebp.57.1247423640040; Sun, 12 Jul 2009 11:34:00 -0700 (PDT) In-Reply-To: <200906300020.n5U0K204054643@freefall.freebsd.org> References: <200906300020.n5U0K204054643@freefall.freebsd.org> Date: Sun, 12 Jul 2009 14:34:00 -0400 Message-ID: <47d0403c0907121134y4f38f0f2ldd05d3623f3bf5b8@mail.gmail.com> From: Ben Kaduk To: Dan Naumov Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Cc: freebsd-doc@freebsd.org 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 List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 12 Jul 2009 18:34:01 -0000 On Mon, Jun 29, 2009 at 8:20 PM, Dan Naumov wrote: > The following reply was made to PR docs/135983; it has been noted by GNAT= S. > > From: Dan Naumov > To: bug-followup@FreeBSD.org, trhodes@FreeBSD.org > Cc: > Subject: Re: docs/135983: "The Z File System" - title is misleading and c= auses > =A0 =A0 =A0 =A0search issue > Date: Tue, 30 Jun 2009 03:13:17 +0300 > > =A0In case I managed to screw up formatting using gmail, here is a direct > =A0link to the patch file: > =A0http://jago.pp.fi/temp/filesystems.chapter.sgml.patch.txt For future > =A0reference, when submitting patches, am I supposed to include them into > =A0the email body of replying to the PR or am I supposed to include the > =A0patch file(s) as an attachment? I usually post the patchfile on a website as well as including it inline (which is easier for people to make comments on) I'll comment on the patch inline: 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/chap= ter.sgml --- /DATA/bsdwork/docs/doc/en_US.ISO8859-1/books/handbook/filesystems/chapt= er.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=3D"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 The rule of thumb that sticks in my head is to write out "three", etc. for numbers less than ten, and use the numerals for larger numbers. 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 I might wrap it as "pool", since I don't think the term has been introduced, yet. + 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 "three", here, as well. + 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 Hm, it may be worth creating an entity for ZFS, so that it will be expanded at first appearance and only appear as an acronym for later appearances. Maybe someone else has an opinion ... Thanks for the patch! -Ben Kaduk + 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