Bug 123400

Summary: gvinum startup in handbook
Product: Documentation Reporter: Jed Clear <clear>
Component: Books & ArticlesAssignee: Tom Rhodes <trhodes>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Jed Clear 2008-05-04 19:10:00 UTC 
To decomission my last 4.11R machine I needed to figure out how to bring over my non-root vinum volumes to gvinum.  Turned out to be much easier than I thought it would be, except for I couldn't get gvinum to start at boot time.  Manually it started flawlessly.  After more searching than I'm used to with FreeBSD, I found the the loader.conf knob.  

The reason for the PR is that the critical bit for boot time starting of gvinum is only listed in the handbook in chapter "20.9 Using Vinum for the Root Filesystem", a chapter I thought I had no need to read since I wasn't dealing with the root filesystem.  Chapter 20.8, which was the one I was looking at, does have a section on automatic startup, but only refers to the old vinum rc.conf setting.

Fix: 

At a minimum the 20.9.1 paragraphs on gvinum startup need to be copied to 20.8.1.1.      

There is probably some more work that could be done to segregate what is 4.x vinum and 5+ gvinum, but the above seems the most important "fix".
How-To-Repeat: Ignore the handbook chapter on vinum root filesystems when not dealing with root filesystems.
Comment 1 Federico GDB 2008-08-18 17:59:10 UTC 
There is a proposal (pending revision) to update Chapter 20:
http://www.freebsd.org/cgi/query-pr.cgi?pr=docs/122052
It can be browsed here:
http://del.ufrj.br/~federico.besnard/FreeBSD/apocrypha/handbook/vinum-vinum.html

also related:
http://www.freebsd.org/cgi/query-pr.cgi?pr=docs/122053

I hope it helps to alleviate the present situation.

One can see activity here:
http://lists.freebsd.org/pipermail/freebsd-geom/

So, I guess that part of the manual might change significantly or just disappear.

Fico
Comment 2 dfilter service freebsd_committer freebsd_triage 2008-12-22 21:51:38 UTC 
trhodes     2008-12-22 21:51:29 UTC

  FreeBSD doc repository

  Modified files:
    en_US.ISO8859-1/books/handbook/vinum chapter.sgml 
  Log:
  Fill out a <note> a bit better by mentioning the loader.conf method of
  loading a module in place of just hinting toward it.
  
  PR:     123400
  
  Revision  Changes    Path
  1.46      +4 -1      doc/en_US.ISO8859-1/books/handbook/vinum/chapter.sgml
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
Comment 3 Tom Rhodes freebsd_committer freebsd_triage 2008-12-22 21:51:44 UTC 
State Changed
From-To: open->closed

I have added a bit of extra text in the note so people 
remember to load the module.  Thanks!
Comment 4 Tom Rhodes freebsd_committer freebsd_triage 2008-12-22 21:51:44 UTC 
Responsible Changed
From-To: freebsd-doc->trhodes

Over to me.