Upgrading SFCFS on an alternate disk

Use one of the following options to upgrade SFCFS on an alternate disk:

SMIT interface

See “To upgrade Storage Foundation Cluster File System on an alternate disk using the SMIT interface”.

Manual

See “To upgrade Storage Foundation Cluster File System on an alternate disk manually”.

The procedure provides instructions to clone the primary boot environment to the alternate disk, upgrade SFCFS on the alternate disk, and reboot the system to start from the alternate disk.

Note:

The alternate disk upgrade is a manual procedure that does not require the Veritas installation program. As a result, the installation and uninstallation scripts are not available in the /opt/VRTS/install directory. You can access these scripts from the installation media.

Note:

The instructions in the procedure are valid for all upgrade scenarios.

In the procedure examples, the primary or current boot environment resides on hdisk0 and the alternate or inactive boot environment resides on hdisk1.

To upgrade Storage Foundation Cluster File System on an alternate disk using the SMIT interface

  1. Clone the primary boot disk rootvg to an alternate disk.

    Start the SMIT menu :

    # smit alt_clone

    Provide information for the following fields in the SMIT menu.

    Target disk to install

    Enter the name of the alternate boot disk.

    hdisk1

    Fileset(s) to install

    Enter the following:

    all

    Directory or Device with images

    Enter the full path of the directory that contains the filesets to be upgraded.

    /usr/

    ACCEPT new license agreements?

    Enter yes to accept the license agreements.

    Set bootlist to boot from this disk on next reboot?

    Enter yes to enable the system to boot from the alternate disk on rebooting.

  2. Press Enter to start the upgrade on the alternate disk.

    The upgrade process takes some time.

  3. Use the following command to wake up the volume group on the alternate boot disk (hdisk1) that you cloned.

    # /usr/sbin/alt_rootvg_op -W -d hdisk1
  4. Verify that the alternate disk is created:

    # lspv
    Output similar to the following displays:
    hdisk0         0009710fa9c79877    rootvg             
    hdisk1         0009710f0b90db93    altinst_rootvg
  5. Run the following command to export the root path installation environment variable.

    # export INSTALL_ROOT_PATH=/alt_inst
  6. Run the following command on the alternate root path of any one node in the cluster to configure a Universal Unique Identifier:

    # /alt_inst/opt/VRTSvcs/bin/uuidconfig.pl -clus -configure \
    -use_llthost

    The -use_llthost option indicates that the /etc/llthost file is used to determine the names of the nodes in the cluster. Alternatively, you can specify the node names instead of the file name.

  7. Confirm that the you have created the Universal Unique Identifier:

    # /alt_inst/opt/VRTSvcs/bin/uuidconfig.pl -clus -display \
    -use_llthost

    The output should resemble:

    Finding existing UUID information ...
    
    nodeA .... exist.
    
    nodeB .... exist.
    
    Done
    
    Valid uuid exist on nodeA nodeB
    
    {ef228450-1dd1-11b2-a7bb-5938100f2199}  : nodeA nodeB
  8. Change directory to /alt_inst/etc/VRTSvcs/conf/config.

    # cd /alt_inst/etc/VRTSvcs/conf/config
  9. Open the main.cf file and delete the include vvrtypes.cf line, which is deprecated. The VVR agents are now included in the updated 5.1 types.cf file. The main.cf file is in the /alt_inst/etc/VRTSvcs/conf/config directory.

  10. Back up a copy of the old types.cf file and copy the new one for SFCFS to use.

    # mv types.cf types.cf.ORIG
    
    # cp ../types.cf .
  11. If you have a secure cluster, perform the instructions in the following section:

    See Upgrading a cluster that is in secure mode.

  12. Move to root and run the alt_rootvg_op -S command to put the alternate root to sleep.

    # cd /
    
    # alt_rootvg_op -S
  13. Verify that the normal boot list includes the name of the alternate boot disk.

    # bootlist -m normal -o   
    hdisk1
  14. Restart all the nodes in the cluster. The boot environment on the alternate disk is activated when you restart the nodes.

    # shutdown -r
  15. Verify the upgrade.

    See Verifying the upgrade.

  16. Remove the obsolete filesets from the alternate disk to complete the upgrade.

    You can determine the obsolete packages by comparing the list of installed filesets with the filesets that are displayed on running the following command:

    # ./installsfcfs -install_option

    where install_option is one of the following:

    -minpkgs: Displays the minimum set of packages

    -recpkgs: Displays the recommended packages

    -allpkgs: Displays all packages

    If you find obsolete packages, remove them by running the following command:

    # installp -u pkg_name

    Note:

    Make sure that you do not remove the filesets of other Veritas products, such as Veritas Cluster Server Management Console, that may be installed on your system. If you need assistance, contact Symantec Technical Support.

To upgrade Storage Foundation Cluster File System on an alternate disk manually

  1. Clone the primary boot disk rootvg to an alternate disk.

    # /usr/sbin/alt_disk_copy -I "acNgXY" -P "all" -l "/usr" -w \
    "all" -d "hdisk1"

    Where:

    • -d indicates the name of the target disk on which you clone the primary disk.

    • -l indicates the full path of the directory that contains the filesets to be upgraded

    • -w indicates the list of SFCFS filesets that you want to upgrade on the alternate boot disk. The option all indicates that all the filesets contained in the directory you specified (using option -l) must be installed to the alternate boot disk.

  2. Use the following command to wake up the volume group on the alternate boot disk (hdisk1) that you cloned.

    # alt_rootvg_op -W -d hdisk1
  3. Verify that the alternate disk is created:

    # lspv
    hdisk0         0009710fa9c79877    rootvg             
    hdisk1         0009710f0b90db93    altinst_rootvg
  4. Run the following command to export the root path installation environment variable.

    # export INSTALL_ROOT_PATH=/alt_inst
  5. Run the following command on the alternate root path of any one node in the cluster to configure a Universal Unique Identifier:

    # /alt_inst/opt/VRTSvcs/bin/uuidconfig.pl -clus -configure \
    -use_llthost

    The -use_llthost option indicates that the /etc/llthost file is used to determine the names of the nodes in the cluster. Alternatively, you can specify the node names instead of the file name.

  6. Confirm that the you have created the Universal Unique Identifier:

    # /alt_inst/opt/VRTSvcs/bin/uuidconfig.pl -clus -display \
    -use_llthost

    The output should resemble:

    Finding existing UUID information ...
    
    nodeA .... exist.
    
    nodeB .... exist.
    
    Done
    
    Valid uuid exist on nodeA nodeB
    
    {ef228450-1dd1-11b2-a7bb-5938100f2199}  : nodeA nodeB
  7. Change directory to cd /alt_inst/etc/VRTSvcs/conf/config.

    # cd /alt_inst/etc/VRTSvcs/conf/config
  8. Open the main.cf file and delete the include vvrtypes.cf line, which is deprecated. The VVR agents are now included in the updated 5.1 types.cf file. The main.cf file is in the /alt_inst/etc/VRTSvcs/conf/config directory.

  9. Back up a copy of the old types.cf file and copy the new one for SFCFS to use.

    # mv types.cf types.cf.ORIG
    
    # cp ../types.cf .
  10. If you have a secure cluster, perform the instructions in the following section:

    See Upgrading a cluster that is in secure mode.

  11. Move to root and run the alt_rootvg_op -S command to put the alternate root to sleep.

    # cd /
    
    # alt_rootvg_op -S
  12. Verify that the normal boot list includes the name of the alternate boot disk. By default, the alternate disk installation process changes the boot list to enable the system to boot from the alternate disk.

    # bootlist -m normal -o   
    hdisk1
  13. Restart all the nodes in the cluster. The boot environment on the alternate disk is activated when you restart the nodes.

    # shutdown -r
  14. Verify the upgrade.

    See Verifying the upgrade.

  15. Remove the obsolete filesets from the alternate disk to complete the upgrade.

    You can determine the obsolete packages by comparing the list of installed filesets with the filesets that are displayed on running the following command:

    # ./installsfcfs -install_option

    where install_option is one of the following:

    -minpkgs: Displays the minimum set of packages

    -recpkgs: Displays the recommended packages

    -allpkgs: Displays all packages

    If you find obsolete packages, remove them by running the following command:

    # installp -u pkg_name

    Note:

    Make sure that you do not remove the filesets of other Veritas products, such as Veritas Cluster Server Management Console, that may be installed on your system. If you need assistance, contact Symantec Technical Support.