From owner-freebsd-doc@FreeBSD.ORG  Wed Jun  6 04:27:04 2012
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: doc@FreeBSD.org
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 51F141065687;
	Wed,  6 Jun 2012 04:27:04 +0000 (UTC)
	(envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
	by mx1.freebsd.org (Postfix) with ESMTP id 0C9988FC12;
	Wed,  6 Jun 2012 04:27:03 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
	by wonkity.com (8.14.5/8.14.5) with ESMTP id q564R2FA010831;
	Tue, 5 Jun 2012 22:27:02 -0600 (MDT)
	(envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
	by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q564R2VA010828;
	Tue, 5 Jun 2012 22:27:02 -0600 (MDT)
	(envelope-from wblock@wonkity.com)
Date: Tue, 5 Jun 2012 22:27:02 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: Hiroki Sato <hrs@FreeBSD.org>
In-Reply-To: <20120605.051840.668781590183332493.hrs@allbsd.org>
Message-ID: <alpine.BSF.2.00.1206052220390.10777@wonkity.com>
References: <alpine.BSF.2.00.1206040653380.97869@wonkity.com>
	<20120605.005134.320058107548486045.hrs@allbsd.org>
	<alpine.BSF.2.00.1206041331520.945@wonkity.com>
	<20120605.051840.668781590183332493.hrs@allbsd.org>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7
	(wonkity.com [127.0.0.1]); Tue, 05 Jun 2012 22:27:03 -0600 (MDT)
Cc: doc@FreeBSD.org
Subject: Re: Handbook mirroring section
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 06 Jun 2012 04:27:04 -0000

On Tue, 5 Jun 2012, Hiroki Sato wrote:

> Warren Block <wblock@wonkity.com> wrote
>  in <alpine.BSF.2.00.1206041331520.945@wonkity.com>:
>
> wb> It's a little tricky.  What do you think about having two sections,
> wb> one for how to create a standard mirror from scratch, and one for
> wb> converting a single-disk system to a mirror?
>
> It sounds like a good idea.

Here's a pass at it:

http://www.wonkity.com/~wblock/mirror/book.html
http://www.wonkity.com/~wblock/mirror/patch-geom-2.diff

Notes:

I tried to factor out common information to the introduction and 
the Troubleshooting section afterward.

diskinfo(8) was used in place of gpart list because the disk capacity is 
in the first three lines, so the command line is simpler.

There is no entity for gnop(8) yet, but I have one locally.