Updating from Developer Preview 1

Updating Guidelines

Note: You cannot update from Preview 1 to the OpenSolaris 2008.05 release.

 Updates to the Preview 1 release are available, fixing a number of key critical issues that have been reported by our users. A simple update is easy through the use of ZFS and its snapshot and clone functionality. Follow the following set of steps and reboot your system to update your version of Project Indiana -

How to Upgrade the October Release With the Preview 2 IPS Bits

Before upgrading your system to the current IPS bits, snapshot your existing root and opt filesystems. You will clone the root and opt filesystems to create your new boot environment.

1. Perform the following steps to snapshot the root and opt filesystems:
   1. # zfs snapshot zpl_slim/root@3
   2. # zfs snapshot zpl_slim/opt@3

Note - If you have upgraded the OpenSolaris Developer Preview 1 bits at any time, the root and opt filesystems will have different names.

1. Execute the following steps if you have not upgraded the OpenSolaris Developer Preview 1 bits before.
   1. Add this line to your /etc/vfstab to mount /opt in legacy mode :
      zpl_slim/opt - /opt zfs - yes -
   2. Fix the current /opt mount point :
      # zfs set mountpoint=legacy zpl_slim/opt
2. Update the IPS software in the current boot environment:
   1. # cd /
   2. # pkg refresh
   3. # pkg install SUNWipkg@0.5.11,5.11-0.75

Note - The version string for SUNWipkg mentioned in sub-step 3 is mandatory to prevent IPS from attempting to upgrade all packages.

1. Clone the snapshots created in step 1, and mount them spliced together under the following:
   1. # zfs clone zpl_slim/root@3 zpl_slim/root3
   2. # zfs set mountpoint=legacy zpl_slim/root3
   3. # zfs clone zpl_slim/opt@3 zpl_slim/root3/opt
   4. # zfs set mountpoint=legacy zpl_slim/root3/opt

Note - As noted in Step 1, if you have upgraded the OpenSolaris Developer Preview 1 bits at any time, the root and opt filesystems will have different names.

1. Edit your /zpl_slim/boot/grub/menu.lst file, to prepend the following lines:
   1. title OpenSolaris Developer Preview 2 snv_79b X86
   2. bootfs zpl_slim/root3
   3. kernel$ /platform/i86pc/kernel/$ISADIR/unix -B $ZFS-BOOTFS
   4. module$ /platform/i86pc/$ISADIR/boot_archive
2. Mount the new filesystems :
   1. mount -F zfs zpl_slim/root3 /mnt
   2. mkdir /mnt/opt
   3. mount -F zfs zpl_slim/root3/opt /mnt/opt
3. Add or edit the new mount points in /mnt/etc/vfstab:
   1. zpl_slim/root3 - / zfs - no -
   2. zpl_slim/root3/opt - /opt zfs - yes -
4. Update the software in the new boot environment under /mnt:
   1. # pkg -R /mnt refresh
   2. # pkg -R /mnt image-update
5. Update the boot archive in the new boot environment.
   # bootadm update-archive -R /mnt
6. Reboot and select your new OpenSolaris Developer Preview 2 version from the GRUB menu.