To prepare for the Live Upgrade

1. Make sure that the SFCFSHA installation media and the operating system installation images are available and on hand.
2. On the nodes to be upgraded, select an alternate boot disk that is at least the same size as the root partition of the primary boot disk.

   If the primary boot disk is mirrored, you need to break off the mirror for the alternate boot disk.

3. Before you perform the Live Upgrade, take offline any services that involve non-root file systems. This prevents file systems from being copied to the alternate boot environment that could potentially cause a root file system to run out of space.
4. On the primary boot disk, patch the operating system for Live Upgrade. Patch 137477-01 is required. Verify that this patch is installed.

5. The version of the Live Upgrade packages must match the version of the operating system to which you want to upgrade on the alternate boot disk. If you are upgrading the Solaris operating system, do the following steps:

   • Remove the installed Live Upgrade packages for the current operating system version:

     All Solaris versions: SUNWluu, SUNWlur packages.

     Solaris 10 update 7 or later also requires: SUNWlucfg package.

     Solaris 10 zones or Branded zones also requires: SUNWluzone package.

   • From the new Solaris installation image, install the new versions of the following Live Upgrade packages:

     All Solaris versions: SUNWluu, SUNWlur, and SUNWlucfg packages.

     Solaris 10 zones or Branded zones also requires: SUNWluzone package.

     Note:

     While you can perform Live Upgrade in the presence of branded zones, they must be halted, and the branded zones themselves are not upgraded.

   Solaris installation media comes with a script for this purpose named liveupgrade20. Find the script at /cdrom/solaris_release/Tools/Installers/liveupgrade20. If scripting, you can use:

   # /cdrom/solaris_release/Tools/Installers/liveupgrade20 \
   -nodisplay -noconsole

6. Symantec provides the vxlustart script that runs a series of commands to create the alternate boot disk for the upgrade.

   To preview the commands, specify the vxlustart script with the -V option.

   Symantec recommends that you preview the commands to ensure there are no problems before beginning the Live Upgrade process.

   The vxlustart script is located on the distribution media, in the scripts directory.

   # cd /cdrom/scripts

   # ./vxlustart -V -u targetos_version -s osimage_path -d diskname

   -V	Lists the commands to be executed during the upgrade process without executing them and pre-checks the validity of the command. If the operating system is being upgraded, the user will be prompted to compare the patches that are installed on the image with the patches installed on the primary boot disk to determine if any critical patches are missing from the new operating system image.
   -u	Specifies the operating system version for the upgrade on the alternate boot disk. For example, use 5.10 for Solaris 10.
   -U	Specifies that only the Storage Foundation products are upgraded. The operating system is cloned from the primary boot disk.
   -s	Indicates the path of the operating system image to be installed on the alternate boot disk. If this option is omitted, you are prompted to insert the discs that contain the operating system image. If the -U option is specified, you can omit the -s option. The operating system is cloned from the primary boot disk.
   -d	Indicates the name of the alternate boot disk on which you intend to upgrade. If you do not specify this option with the script, you are prompted for the disk information.
   -v	Indicates verbose, the executing commands display before they run.
   -Y	Indicates a default yes with no questions asked.
   -D	Prints with debug option on, and is for debugging.
   -F	Specifies the rootdisk's file system, where the default is ufs.
   -t	Specifies the number of CDs involved in upgrade.
   -r	Specifies that if the machine crashes or reboots before the vxlufinish command is run, the alternate disk is remounted using this option.

   For example, to preview the commands to upgrade only the Veritas product:

   # ./vxlustart -V -u 5.10 -U -d disk_name

   For example, to preview the commands for an upgrade to Solaris 10 update 6:

   # ./vxlustart -V -u 5.10 -s /mnt/Solaris_10u6 -d c0t1d0

   Note:

   This command prompts you to compare the patches that are installed on the image with the patches installed on the primary boot disk. If any patches are missing from the new operating system's image, note the patch numbers. To ensure the alternate boot disk is the same as the primary boot disk, you will need to install these patches on the alternate boot disk.

7. If the specified image is missing patches that are installed on the primary boot disk, note the patch numbers. To ensure that the alternate boot disk is the same as the primary boot disk, you need to install any missing patches on the alternate boot disk.