To upgrade Storage Foundation

1. Log in as superuser.

2. If the root disk is encapsulated under VxVM, unmirror and unencapsulate the root disk as described in the following steps, to be performed in the order listed:

   • Use the vxplex command to remove all the plexes of the volumes rootvol, swapvol, usr, var, opt and home that are on disks other than the root disk.

     For example, the following command removes the plexes mirrootvol-01, and mirswapvol-01 that are configured on a disk other than the root disk:

     # vxplex -o rm dis mirrootvol-01 mirswapvol-01

     Warning:

     Do not remove the plexes on the root disk that correspond to the original disk partitions.

   • Enter the following command to convert all the encapsulated volumes in the root disk back to being accessible directly through disk partitions instead of through volume devices.

     # /etc/vx/bin/vxunroot

     Following the removal of encapsulation, the system is rebooted from the unencapsulated root disk.

     If your system is running VxVM 4.1 MP2, the following remnants of encapsulation will still be present:

     • Partition table entries for the private and public regions

     • GRUB or LILO configuration entries for VxVM

3. Unmount any mounted VxFS file systems.

   The installer supports the upgrade of multiple hosts, if each host is running the same version of VxVM and VxFS. Hosts must be upgraded separately if they are running different versions.

   If any VxFS file systems are mounted with the QuickLog feature, QuickLog must be disabled before upgrading. See the "Veritas QuickLog" chapter of the Storage Foundation Administrator's Guide for more information.

4. If your system has separate /opt and /var file systems, make sure they are mounted before proceeding with installation.
5. If replication using VVR is configured, verify that all the Primary RLINKs are up-to-date:

   # /usr/sbin/vxrlink -g diskgroup status rlink_name

   Note:

   Do not continue until the Primary RLINKs are up-to-date.

6. Load and mount the disc. If you downloaded the software, navigate to the top level of the download directory.
7. From the disc, run the installer command. If you downloaded the software, run the ./installer command.

   # cd /cdrom/cdrom0
   # ./installer

8. Enter G to upgrade and select the Full Upgrade.
9. You are prompted to enter the system names (in the following example, "sys1") on which the software is to be installed. Enter the system name or names and then press Return.

   Enter the system names separated by spaces on which to
   install SF: sys1 sys2

   Depending on your existing configuration, various messages and prompts may appear. Answer the prompts appropriately.

10. The installer asks if you agree with the terms of the End User License Agreement. Press y to agree and continue.
11. The installer lists the packages to install or to update. You are prompted to confirm that you are ready to upgrade.
12. The installer discovers if any of the systems that you are upgrading have mirrored and encapsulated boot disks. For each system that has a mirrored boot disk, you have the option to create a backup of the system's book disk group before the upgrade proceeds. If you want to split the boot disk group to create a backup, answer y.
13. The installer then prompts you to name the backup boot disk group. Enter the name for it or press Enter to accept the default.
14. You are prompted to start the split operation. Press y to continue.

    Note:

    The split operation can take some time to complete.

15. Stop the product's processes.

    Do you want to stop SF processes now? [y,n,q] (y) y

    If you select y, the installer stops the product processes and makes some configuration updates before upgrading.

16. The installer stops, uninstalls, reinstalls, and starts specified packages.
17. If the upgrade was done from 5.0 or if the Storage Foundation was done without vxkeyless keys, the installer shows the following warning:

    CPI WARNING V-9-40-5323 SF license version 5.0 is not
    updated to 6.0 on sys1. It's recommended to upgrade to a 6.0 key.
    CPI WARNING V-9-40-5323 SF license version 5.0 is not updated
    to 6.0 on sys2. It's recommended to upgrade to a 6.0 key.
    SF is licensed on the systems.
    Do you wish to enter additional licenses? [y,n,q,b] (n) n

18. The Storage Foundation software is verified and configured.
19. The installer prompts you to provide feedback, and provides the log location for the upgrade.
20. Only perform this step if you have split the mirrored root disk to back it up. After a successful reboot, verify the upgrade and re-join the backup disk group into the upgraded boot disk group. If the upgrade fails, revert the upgrade boot disk group to the backup disk group.

    See Re-joining the backup boot disk group into the current disk group.

    See Reverting to the backup boot disk group after an unsuccessful upgrade.