vxlustart, vxlufinish - perform a live upgrade of Veritas Volume Manager

vxlustart [-V] [-U] [-m] [-v] [-F] [-D] [-g diskgroup]
    [-d diskname] [-u Solaris_release] [-f filesystem]
    [-t number_of_discs] [-s Solaris_install_image_path]

vxlustart [-V] [-v] [-D] [-r] [-u Solaris_release]

vxlufinish [-V] [-v] [-g diskgroup] [-u Solaris_release]

The live upgrade feature of Veritas Volume Manager (VxVM) uses the Solaris (TM) Live Upgrade software to simplify the process of upgrading the Solaris Operating System (OS) and VxVM. It allows the system to continue running under the current Solaris Operating Environment and VxVM while you upgrade and patch an inactive duplicate of the boot environment.

An outline of the steps to perform a live upgrade is as follows:

1.	Install the Live Upgrade software if it is not already present.
2.	Run vxlustart to start the live upgrade. This creates the alternate boot environment on a different disk from the root disk, and upgrades the Solaris OS if required.
3.	If the Veritas software is to be upgraded, remove the existing software from the alternate boot environment.
4.	If the Veritas software is being upgraded, install the new Veritas software on the alternate boot environment.
5.	Run vxlufinish to activate the alternate boot environment, and complete the Live Upgrade process.
	Shut down the system. This is rebooted from the alternate boot environment automatically.

Note: The system is unavailable only during the final step. If a problem is experienced with the new boot environment, shut down the system and reboot it from the old boot disk.

For full details of the upgrade procedure, see the Storage Foundation Installation Guide.

-D	Sets the debug flag to obtain diagnostic set -x output from the script.
-d diskname	Specifies the device name of the disk that is to be set up with the alternate boot environment for the upgrade. If this option is not specified, the script prompts for the name. If a spare disk is not available, a mirror of the root disk can be used instead.
-F	Forces operations to be performed that would not otherwise be permitted. For example, this option permits the disk alignment to be corrected.
-f filesystem
	Specifies the file system type to be used on the root disk. The default type is ufs.
-g diskgroup	For vxlustart, specifies the disk group to which the root disk belongs (this is usually aliased as bootdg). If not specified, bootdg is assumed by default.
	For vxlufinish, specifies the disk group to which the new root disk is to be added during encapsulation.
-m	Specifies that you have used the format command to set up the VTOC on the alternate root disk before running vxlustart. This allows you to change the partition sizes that are used for the upgrade.
-r	Remounts all alternate partitions that are needed to upgrade Veritas products on the alternate boot environment. This may be necessary if the system crashes or is rebooted between running vxlustart and vxlufinish, which unmounts the partitions on the alternate root disk. Rerun vxlustart with this option to remount those partitions.
-s Solaris_install_image_path
	Specifies the path to the image of the new version of the Solaris software. The path must be a network or directory path to a complete Solaris OS image (such as a path used for JumpStart).
	If this option is not specified, the script assumes the upgrade is from CDs, and prompts you to load these one at a time by specifying the CD-ROM path. When all the CDs have been loaded, enter "NONE" to complete the upgrade.
-t number_of_discs
	Specifies the number of CDs that are required for the upgrade. If more than one CD is specified, the script prompts for the path to the next CD after upgrading from the first. When the specified number of CDs has been loaded, the script completes the upgrade automatically.
-U	Specifies that only Veritas packages are to be upgraded, and that the version of the Solaris OS is to stay the same.
-u Solaris_release
	Specifies the release of the Solaris OS that is to be installed during the upgrade (for example, 5.8, 5.9 or 5.10).
-V	Prints the commands that would be executed by vxlustart or vxlufinish. This option is used to check the operations that would be performed without invoking the commands themselves.
-v	Prints the commands as they are being executed by vxlustart or vxlufinish.

Start a live upgrade from a JumpStart image, setting up disk c1t1d0s2 as the alternate boot environment:

vxlustart -v -F -d c1t1d0s2 -u 5.9 \
  -s /net/jumpstart/solaris9

Remount the partitions on the alternate root disk following a system crash or reboot that occurred before running vxlufinish:

vxlustart -v -r -u 5.9

Upgrade from a set of 5 CDs:

vxlustart -v -F -d c1t1d0s2 -u 5.9 -t 5

Finish a live upgrade:

vxlufinish -v -g newrtdg -u 5.9

format(1M), vxbootsetup(1M), vxmirror(1M), vxunroot(1M)

Storage Foundation Installation Guide