misc/124434: [PATCH]: Missing updating entry for geom mirror metadata version rev

[Philip M. Gollucci]

>Number:         124434
>Category:       misc
>Synopsis:       [PATCH]: Missing updating entry for geom mirror metadata version rev
>Confidential:   no
>Severity:       non-critical
>Priority:       high
>Responsible:    freebsd-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jun 10 05:20:00 UTC 2008
>Closed-Date:
>Last-Modified:
>Originator:     Philip M. Gollucci
>Release:        FreeBSD 8.0-CURRENT i386
>Organization:
Apache Software Foundation (ASF)
>Environment:
System: FreeBSD vegeta.p6m7g8.net 8.0-CURRENT FreeBSD 8.0-CURRENT #0: Sat Mar 1 22:09:51 EST 2008 root at krillin.p6m7g8.net:/usr/obj/usr/src/sys/VEGETA i386
>Description:
since I was talking to nox on #bsddev about it, I've cc'ed him here.
Hope he doesn't mind.

>How-To-Repeat:
>Fix:

--- UPDATING.diff begins here ---
Index: UPDATING
===================================================================
RCS file: /home/ncvs/src/UPDATING,v
retrieving revision 1.531
diff -u -r1.531 UPDATING
--- UPDATING	3 Jun 2008 18:09:10 -0000	1.531
+++ UPDATING	10 Jun 2008 04:27:18 -0000
@@ -395,6 +395,20 @@
 	reference these structures be recompiled.. Especially the
 	linux module.
 
+20061122: 
+	geom(4)'s gmirror(8) class metadata structure has been 
+	rev'd from v3 to v4. If you update across this point and 
+	your metadata is converted for you, you will not be easily 
+	able to downgrade since the /boot/kernel.old/geom_mirror.ko 
+	kernel module will be unable to read the v4 metadata.  You 
+	can resolve this by doing from the loader(8) prompt:
+
+		set vfs.root.mountfrom="ufs:/dev/XXX" 
+
+	where XXX is the root slice of one of the disks that composed
+	the mirror (i.e.: /dev/ad0s1a). You can can than rebuild 
+	the array the same way you built it originally.
+
 20061126:
 	Sound infrastructure has been updated with various fixes and
 	improvements. Most of the changes are pretty much transparent,
--- UPDATING.diff ends here ---


>Release-Note:
>Audit-Trail:
>Unformatted: