Date: Thu, 16 Oct 2003 01:10:35 -0700 (PDT) From: Jack Twilley <jmt@twilley.org> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/58111: Handbook 12.4.3 Rebuilding ATA RAID1 Arrays contains errors Message-ID: <20031016081035.9EE2D3F546@duchess.twilley.org> Resent-Message-ID: <200310160820.h9G8K9O3097659@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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 <MAXTOR 6L080J4/A93.0500> ATA/ATAPI rev 5
Slave: no device present
# atacontrol addspare ar0 ad6
<appropriate output here, stupidly didn't save it>
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:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20031016081035.9EE2D3F546>