From owner-freebsd-doc@FreeBSD.ORG Sun May 4 18:10:01 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 5BB041065677 for ; Sun, 4 May 2008 18:10:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 516F88FC18 for ; Sun, 4 May 2008 18:10:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.2/8.14.2) with ESMTP id m44IA1ZH050401 for ; Sun, 4 May 2008 18:10:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.2/8.14.1/Submit) id m44IA1Ce050400; Sun, 4 May 2008 18:10:01 GMT (envelope-from gnats) Resent-Date: Sun, 4 May 2008 18:10:01 GMT Resent-Message-Id: <200805041810.m44IA1Ce050400@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, Jed Clear Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 80ED01065675 for ; Sun, 4 May 2008 18:04:34 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 885B38FC0A for ; Sun, 4 May 2008 18:04:34 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.2/8.14.2) with ESMTP id m44I3kPW074829 for ; Sun, 4 May 2008 18:03:46 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.2/8.14.1/Submit) id m44I3k9f074827; Sun, 4 May 2008 18:03:46 GMT (envelope-from nobody) Message-Id: <200805041803.m44I3k9f074827@www.freebsd.org> Date: Sun, 4 May 2008 18:03:46 GMT From: Jed Clear To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/123400: gvinum startup in handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 04 May 2008 18:10:01 -0000 >Number: 123400 >Category: docs >Synopsis: gvinum startup in handbook >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: Sun May 04 18:10:00 UTC 2008 >Closed-Date: >Last-Modified: >Originator: Jed Clear >Release: 6.3R >Organization: dis >Environment: Handbook on www.freebsd.org as of this date >Description: 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. >How-To-Repeat: Ignore the handbook chapter on vinum root filesystems when not dealing with root filesystems. >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". >Release-Note: >Audit-Trail: >Unformatted: