Bug 124716

Summary: [patch] GEOM RAID1 handbook example only covers boot partition
Product: Documentation Reporter: Hywel Mallett <hywel>
Component: Books & ArticlesAssignee: Dru Lavigne <dru>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
geom.txt.diff.txt none

Description Hywel Mallett 2008-06-18 15:10:02 UTC 
In the handbook the section on RAID0 is very clear, and gives a good example of how to configure a new RAID0 array and newfs it. This section assumes that the new array is an additional array to be added to /etc/fstab.
By contrast the section on RAID1 assumes that you want a mirrored root partition on a newly-installed system. The extra complexities mean that the section is confusing to a beginner.

Fix: 

Move the existing RAID1 section to a new section - "How to mirror your boot partition" (or similar).
Create a new RAID1 section covering how to add a RAID1 array as an additional filesystem, in the same vein as the current RAID0 section.
Comment 1 Hywel Mallett 2008-06-18 15:27:35 UTC 
Patch attached for perusal. It is to be applied to chapter.sgml in the  
geom directory.
I've merely copied the sgml from the existing article - it may not be  
standards-compliant.
Comment 2 Tom Rhodes freebsd_committer freebsd_triage 2008-09-10 06:41:07 UTC 
State Changed
From-To: open->analyzed

Working on a new gmirror section, would like to further 
investigate this idea.  Take the PR.
Comment 3 Tom Rhodes freebsd_committer freebsd_triage 2008-09-10 06:41:07 UTC 
Responsible Changed
From-To: freebsd-doc->trhodes

Working on a new gmirror section, would like to further 
investigate this idea.  Take the PR.
Comment 4 Dru Lavigne freebsd_committer freebsd_triage 2014-04-11 17:27:13 UTC 
Responsible Changed
From-To: trhodes->dru

I'll take this one.
Comment 5 Dru Lavigne freebsd_committer freebsd_triage 2014-04-11 17:27:46 UTC 
State Changed
From-To: analyzed->closed

Looking through the source of this doc, it looks like it only 
contained one example when the bug was reported. It has had 
two examples for some time now, which should address the 
submitter's request.