OpenSolaris

1. Community: OS/Net (ON)
   1. Blogs
   2. Development Process
   3. Developer's Reference
      1. Introduction
      2. Prerequisites
      3. The Source Tree, part 1
      4. The Source Tree, part 2
      5. Building OpenSolaris
      6. Installing and Testing OpenSolaris
      7. Integration Procedure
      8. Best Practices and Requirements
      9. Glossary
   4. Discussions
   5. Installation (from source) Quickstart
      1. Annotated nightly(1) Mail Example
   6. Currently Known Issues
   7. CRT
      1. Advocates & Sponsors
      2. Becoming a CRT Advocate
      3. Charter
      4. RTI nits to avoid
      5. Sponsor Tasks
      6. Becoming a Sponsor
   8. Schedule
   9. ONNV Flag Days, Heads Ups, and Project Integration History
      1. All
      2. Builds 106-110
      3. Builds 101-105
      4. Builds 96-100
      5. Builds 91-95
      6. Builds 86-90
      7. Builds 81-85
      8. Builds 76-80
      9. Builds 71-75
      10. Builds 66-70
      11. Builds 61-65
      12. Builds 56-60
      13. Builds 51-55
      14. Builds 46-50
      15. Builds 41-45
      16. Builds 36-40
      17. Builds 31-35
      18. Builds 26-30
      19. Builds 21-25
   10. Leaders
   11. Observers
   12. Putback Logs
   13. Developing Solaris
       1. Quality Death Spiral
   14. wx
   15. findunref and unreferenced files
   16. Bourne/Korn Shell Coding Conventions

Heads up: use gate's bfu on x86 zfs-root machines

Date: Mon, 07 Jul 2008 13:40:11 -0700
From: Matthew Ahrens <Matthew.Ahrens at sun dot com>
To: on-all at eng dot sun dot com, onnv-gate at onnv dot eng dot sun dot com
Subject: Heads up: use gate's bfu on x86 zfs-root machines

If you use BFU on an x86 machine with ZFS root, be sure to use the latest 
version of BFU which includes the fix for 6722838 "bfu does not update grub".

If you don't use the latest BFU, be sure to run /boot/solaris/bin/update_grub 
before running "zpool upgrade".

Details:

My putback for 6343667 "scrub/resilver has to start over when a snapshot is 
taken" introduces a new zpool on-disk version number, and updates the GRUB 
stage2 zfs module to know about the new version.  However, the BFU bug 
(6722838) causes the new GRUB module to not be installed when the machine is 
BFU'ed.

You will hit the bug if you do the following sequence:

1. Use an old version of BFU (without the fix for 6722838) to load bits 
supporting a new zpool on-disk version (eg, snv_94 with 6343667 fixed and 
version 11 supported).

2. Run "zpool upgrade" on your root pool.

3. Reboot.

The system will not boot up, and you will get a cryptic error message from 
GRUB.  To fix the problem, you must boot from alternate media (eg, network or 
cdrom) and run "/boot/solaris/bin/update_grub -R <root mountpoint>".

If you have inadvertently performed step 1, you can workaround the bug by 
manually running /boot/solaris/bin/update_grub.  Then you can zpool update 
and reboot successfully.

--matt