From owner-freebsd-doc@FreeBSD.ORG Thu Oct 16 01:20:11 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 330B416A4B3 for ; Thu, 16 Oct 2003 01:20:11 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id D211643FD7 for ; Thu, 16 Oct 2003 01:20:09 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h9G8K9FY097660 for ; Thu, 16 Oct 2003 01:20:09 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h9G8K9O3097659; Thu, 16 Oct 2003 01:20:09 -0700 (PDT) (envelope-from gnats) Resent-Date: Thu, 16 Oct 2003 01:20:09 -0700 (PDT) Resent-Message-Id: <200310160820.h9G8K9O3097659@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Jack Twilley Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id DA72816A4B3 for ; Thu, 16 Oct 2003 01:10:36 -0700 (PDT) Received: from duchess.twilley.org (dsl092-188-219.sfo1.dsl.speakeasy.net [66.92.188.219]) by mx1.FreeBSD.org (Postfix) with ESMTP id C762F43FBD for ; Thu, 16 Oct 2003 01:10:35 -0700 (PDT) (envelope-from jmt@duchess.twilley.org) Received: by duchess.twilley.org (Postfix, from userid 1001) id 9EE2D3F546; Thu, 16 Oct 2003 01:10:35 -0700 (PDT) Message-Id: <20031016081035.9EE2D3F546@duchess.twilley.org> Date: Thu, 16 Oct 2003 01:10:35 -0700 (PDT) From: Jack Twilley To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/58111: Handbook 12.4.3 Rebuilding ATA RAID1 Arrays contains errors X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Jack Twilley List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 16 Oct 2003 08:20:11 -0000 >Number: 58111 >Category: docs >Synopsis: Handbook 12.4.3 Rebuilding ATA RAID1 Arrays contains errors >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Thu Oct 16 01:20:09 PDT 2003 >Closed-Date: >Last-Modified: >Originator: Jack Twilley >Release: FreeBSD 5.1-RELEASE i386 >Organization: self >Environment: System: FreeBSD duchess.twilley.org 5.1-RELEASE FreeBSD 5.1-RELEASE #0: Mon Jun 16 07:00:17 PDT 2003 root@:/usr/obj/usr/src/sys/DUCHESS i386 >Description: Section 12.4.3 of the FreeBSD Handbook discusses rebuilding ATA RAID1 arrays. The example case is of a Promise IDE RAID card. I have one of these, and recently had the need to rebuild the RAID array. During this process, I discovered two errors in the documentation: * step 3 is incomplete "Reattach the disk as a spare:" has a command to reattach the disk, but no command to attach the new disk to the array as a spare disk. * step 5 is obsolete The documentation reports that the rebuild command hangs until complete. In fact, the rebuild command returns immediately and the disk is rebuilt in the background. >How-To-Repeat: >Fix: Replace the old step 3 with something like this: 3. Reattach the disk as a spare: # atacontrol attach 3 Master: ad6 ATA/ATAPI rev 5 Slave: no device present # atacontrol addspare ar0 ad6 Replace the old step 5 with something like this: 5. The rebuild command returns immediately. You can check on the progress by issuing the following command: >Release-Note: >Audit-Trail: >Unformatted: