From owner-svn-doc-projects@FreeBSD.ORG Mon Oct 14 01:12:46 2013 Return-Path: Delivered-To: svn-doc-projects@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 ESMTP id 220E9C16; Mon, 14 Oct 2013 01:12:46 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-4.mit.edu (dmz-mailsec-scanner-4.mit.edu [18.9.25.15]) by mx1.freebsd.org (Postfix) with ESMTP id 9171C211A; Mon, 14 Oct 2013 01:12:45 +0000 (UTC) X-AuditID: 1209190f-b7fa08e0000009c6-f2-525b4506da7b Received: from mailhub-auth-4.mit.edu ( [18.7.62.39]) by dmz-mailsec-scanner-4.mit.edu (Symantec Messaging Gateway) with SMTP id 0B.9F.02502.6054B525; Sun, 13 Oct 2013 21:12:38 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-4.mit.edu (8.13.8/8.9.2) with ESMTP id r9E1Cbq5014091; Sun, 13 Oct 2013 21:12:38 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r9E1CZFb029838 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sun, 13 Oct 2013 21:12:37 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id r9E1CZl9019511; Sun, 13 Oct 2013 21:12:35 -0400 (EDT) Date: Sun, 13 Oct 2013 21:12:35 -0400 (EDT) From: Benjamin Kaduk To: Benedict Reuschling Subject: Re: svn commit: r42795 - projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs In-Reply-To: <201310012034.r91KYluV017135@svn.freebsd.org> Message-ID: References: <201310012034.r91KYluV017135@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFnrDIsWRmVeSWpSXmKPExsUixG6nrsvmGh1kcHWqtsX5I+oWPz4eYrJY eGY1swOzx4xP81kCGKO4bFJSczLLUov07RK4Mm5ePclacFe+4vOsl4wNjJckuhg5OSQETCQ6 v95ngbDFJC7cW88GYgsJ7GOUaG4K7mLkArI3Mko0/X3ECuEcYpJYfb2dEcJpYJS4NfUEWDuL gLbExOVnwNrZBFQkZr7ZCGaLCGhKzG5bzQRiMwvYSEx4sIAdxBYWSJBY0bqCGcTmFLCS+LGn gxHE5hVwlDh4egYjxBmWEt9XzACbIyqgI7F6/xQWiBpBiZMzn7BAzLSU+Lf2F+sERsFZSFKz kKQWMDKtYpRNya3SzU3MzClOTdYtTk7My0st0jXRy80s0UtNKd3ECApUTkn+HYzfDiodYhTg YFTi4RVwig4SYk0sK67MPcQoycGkJMorDxLiS8pPqcxILM6ILyrNSS0+xCjBwawkwiv1LSpI iDclsbIqtSgfJiXNwaIkznuTwz5ISCA9sSQ1OzW1ILUIJivDwaEkwcvhAjRUsCg1PbUiLTOn BCHNxMEJMpwHaPhCZ6Aa3uKCxNzizHSI/ClGRSlxXjGQZgGQREZpHlwvLJG8YhQHekWY9wVI Ow8wCcF1vwIazAQ0+OfbCJDBJYkIKakGxpKlE4pKS+0DIpNnKP93T5mdKSA2K17CzvXVppw3 t3iOXzm1YWtwcHzpsZ++D+p+/FsrYHC32+Ll122LriVef8Fybeq8XYsXXa+1knCWndISsLTf cb9nl9LUCQGcNg+1LC5ySb7YNGGnu7pVvXvSNMM76UlG+W6fHUR/OykbPdr9/Om26ZPmNCqx FGckGmoxFxUnAgAXcEUy/wIAAA== Cc: svn-doc-projects@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 14 Oct 2013 01:12:46 -0000 On Tue, 1 Oct 2013, Benedict Reuschling wrote: > Author: bcr > Date: Tue Oct 1 20:34:47 2013 > New Revision: 42795 > URL: http://svnweb.freebsd.org/changeset/doc/42795 > > Log: > Add a section about zpool iostat with a few examples. > > Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml > ============================================================================== > --- projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Tue Oct 1 19:30:26 2013 (r42794) > +++ projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Tue Oct 1 20:34:47 2013 (r42795) > @@ -506,8 +506,51 @@ errors: No known data errors > > Performance Monitoring > > - > - > + ZFS has a built-in monitoring isystem that can display > + statistics about I/O happening on the pool in real-time. > + Additionally, it shows the free and used space on the pool and > + how much I/O bandwidth are currently utilized for read and I think "bandwidth" is singular and would take "is" accordingly. > + write operations. By default, all pools in the system will be > + monitored and displayed. A pool name can be provided to just > + monitor one pool. A basic example is provided below: > + > +&prompt.root; zpool iostat > + capacity operations bandwidth > +pool alloc free read write read write > +---------- ----- ----- ----- ----- ----- ----- > +data 288G 1.53T 2 11 11.3K 57.1K > + > + To monitor I/O activity on the pool continuously, a > + number indicating the seconds after which to refresh the > + display can be specified. ZFS will then print the next > + statistic line after each intervall has been reached. Press 'interval' takes only a single 'l'. > + + action="simul">CtrlC > + to stop this continuous monitoring. Alternatively, a second > + whole number can be provided on the command line after the > + intervall to indicate how many of these statistics should be (here, too) > + displayed in total. > + > + An even more detailed pool I/O statistic can be I think the plural form ("Even more detailed pool I//O statistics") would flow more naturally here. > + displayed using the -v parameter. For > + each storage device that is part of the pool ZFS will > + provide a separate statistic line. This is helpful to > + determine reads and writes on devices that slow down I/O on > + the whole pool. In the following example, we have a > + mirrored pool consisting of two devices. For each of these, > + a separate line is shown with the current I/O > + activity. > + > @@ -564,12 +607,12 @@ Filesystem Size Used Avail Cap > > > > - It is possible to set user-defined properties in ZFS. They > - become part of the pool configuration and can be used to provide > - additional information about the pool or it's contents. To > - distnguish these custom properties from the ones supplied by > - ZFS by default, the colon (:) is used in the > - property name. > + It is possible to set user-defined properties in ZFS. > + They become part of the pool configuration and can be used to > + provide additional information about the pool or it's Just "its" (no apostrophe). Oh, but this is fied already. -Ben > + contents. To distnguish these custom properties from the ones > + supplied by ZFS by default, the colon (:) > + is used in the property name. > > &prompt.root; zfs set custom:costcenter=1234 > &prompt.root; zfs get custom:costcenter > From owner-svn-doc-projects@FreeBSD.ORG Mon Oct 14 15:58:31 2013 Return-Path: Delivered-To: svn-doc-projects@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 ESMTP id 946A5EDA; Mon, 14 Oct 2013 15:58:31 +0000 (UTC) (envelope-from bcr@FreeBSD.org) 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 67F992275; Mon, 14 Oct 2013 15:58:31 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r9EFwVPj092540; Mon, 14 Oct 2013 15:58:31 GMT (envelope-from bcr@svn.freebsd.org) Received: (from bcr@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r9EFwVEd092539; Mon, 14 Oct 2013 15:58:31 GMT (envelope-from bcr@svn.freebsd.org) Message-Id: <201310141558.r9EFwVEd092539@svn.freebsd.org> From: Benedict Reuschling Date: Mon, 14 Oct 2013 15:58:31 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r42952 - projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs X-SVN-Group: doc-projects MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 14 Oct 2013 15:58:31 -0000 Author: bcr Date: Mon Oct 14 15:58:30 2013 New Revision: 42952 URL: http://svnweb.freebsd.org/changeset/doc/42952 Log: Correct some grammar mistakes and typos. Submitted by: Benjamin Kaduk Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml ============================================================================== --- projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Mon Oct 14 13:12:45 2013 (r42951) +++ projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Mon Oct 14 15:58:30 2013 (r42952) @@ -515,7 +515,7 @@ errors: No known data errors ZFS has a built-in monitoring isystem that can display statistics about I/O happening on the pool in real-time. Additionally, it shows the free and used space on the pool and - how much I/O bandwidth are currently utilized for read and + how much I/O bandwidth is currently utilized for read and write operations. By default, all pools in the system will be monitored and displayed. A pool name can be provided to just monitor one pool. A basic example is provided below: @@ -529,15 +529,15 @@ data 288G 1.53T 2 11 To monitor I/O activity on the pool continuously, a number indicating the seconds after which to refresh the display can be specified. ZFS will then print the next - statistic line after each intervall has been reached. Press + statistic line after each interval has been reached. Press CtrlC to stop this continuous monitoring. Alternatively, a second whole number can be provided on the command line after the - intervall to indicate how many of these statistics should be + interval to indicate how many of these statistics should be displayed in total. - An even more detailed pool I/O statistic can be + Even more detailed pool I/O statistics can be displayed using the -v parameter. For each storage device that is part of the pool ZFS will provide a separate statistic line. This is helpful to