Sun Cluster Upgrade Guide for Solaris OS

ProcedureHow to Perform a Rolling Upgrade of Sun Cluster 3.2 2/08 Software

Perform this procedure to upgrade a node that runs Sun Cluster 3.2 software to Sun Cluster 3.2 2/08 software while the remaining cluster nodes are in cluster mode.


Note –

Until all nodes of the cluster are upgraded and the upgrade is committed, new features that are introduced by the new release might not be available.


  1. Become superuser on the node of the cluster.

  2. Ensure that the applicable Sun Cluster 3.2 Core Patch is installed before you begin to upgrade to Sun Cluster software.

    • Solaris 9 OS - 125510–02

    • Solaris 10 OS on SPARC - 125511–02

    • Solaris 10 OS on x86 - 125512–02

    This patch contains the versioning functionality that is needed to support coexistence of different Sun Cluster software versions during the rolling upgrade process.

  3. Load the Sun Java Availability Suite DVD-ROM into the DVD-ROM drive.

    If the volume management daemon vold(1M) is running and is configured to manage CD-ROM or DVD devices, the daemon automatically mounts the media on the /cdrom/cdrom0/ directory.

  4. Change to the installation wizard directory of the DVD-ROM.

    • If you are installing the software packages on the SPARC platform, type the following command:


      phys-schost# cd /cdrom/cdrom0//Solaris_sparc
      
    • If you are installing the software packages on the x86 platform, type the following command:


      phys-schost# cd /cdrom/cdrom0//Solaris_x86
      
  5. Start the installation wizard program.


    phys-schost# ./installer
    
  6. Follow the instructions on the screen to select and upgrade Shared Components software packages on the node.


    Note –

    Do not use the installation wizard program to upgrade Sun Cluster software packages.


    The installation wizard program displays the status of the installation. When the installation is complete, the program displays an installation summary and the installation logs.

  7. Exit the installation wizard program.

  8. Change to the /cdrom/suncluster_3_0Tools/ directory, where arch is sparc or x86 (Solaris 10 only) and where ver is 9 for Solaris 9 or 10 for Solaris 10 .


    phys-schost# cd /cdrom/cdrom0//cdrom/suncluster_3_0Tools
    
  9. Start the scinstall utility.


    phys-schost# ./scinstall
    

    Note –

    Do not use the /usr/cluster/bin/scinstall command that is already installed on the node. You must use the scinstall command that is located on the Sun Java Availability Suite DVD-ROM.


    The scinstall Main Menu is displayed.

  10. Type the option number for Upgrade This Cluster Node and press the Return key.


      *** Main Menu ***
    
        Please select from one of the following (*) options:
    
            1) Create a new cluster or add a cluster node
            2) Configure a cluster to be JumpStarted from this install server
          * 3) Manage a dual-partition upgrade
          * 4) Upgrade this cluster node
          * 5) Print release information for this cluster node
     
          * ?) Help with menu options
          * q) Quit
    
        Option:  4
    

    The Upgrade Menu is displayed.

  11. Type the option number for Upgrade Sun Cluster Framework On This Cluster Node and press the Return key.

  12. Follow the menu prompts to upgrade the cluster framework.

    Upgrade processing is finished when the system displays the message Completed Sun Cluster framework upgrade and prompts you to press Enter to continue.

  13. Quit the scinstall utility.

  14. (Optional) Upgrade data service packages.


    Note –

    For Sun Cluster HA for SAP Web Application Server, if you are using a J2EE engine resource or a web application server component resource or both, you must delete the resource and recreate it with the new web application server component resource. Changes in the new web application server component resource includes integration of the J2EE functionality. For more information, see Sun Cluster Data Service for SAP Web Application Server Guide for Solaris OS.


    1. Start the upgraded interactive scinstall utility.


      phys-schost# /usr/cluster/bin/scinstall
      

      Note –

      Do not use the scinstall utility that is on the installation media to upgrade data service packages.


      The scinstall Main Menu is displayed.

    2. Type the option number for Upgrade This Cluster Node and press the Return key.

      The Upgrade Menu is displayed.

    3. Type the option number for Upgrade Sun Cluster Data Service Agents On This Node and press the Return key.

    4. Follow the menu prompts to upgrade Sun Cluster data service agents that are installed on the node.

      You can choose from the list of data services that are available to upgrade or choose to upgrade all installed data services.

      Upgrade processing is finished when the system displays the message Completed upgrade of Sun Cluster data services agents and prompts you to press Enter to continue.

    5. Press Enter.

      The Upgrade Menu is displayed.

  15. Quit the scinstall utility.

  16. Unload the Sun Java Availability Suite DVD-ROM from the DVD-ROM drive.

    1. To ensure that the DVD-ROM is not being used, change to a directory that does not reside on the DVD-ROM.

    2. Eject the DVD-ROM.


      phys-schost# eject cdrom
      
  17. If you have Sun Cluster HA for NFS configured on a highly available local file system, ensure that the loopback file system (LOFS) is disabled.


    Note –

    If you have non-global zones configured, LOFS must remain enabled. For guidelines about using LOFS and alternatives to disabling it, see Cluster File Systems in Sun Cluster Software Installation Guide for Solaris OS.


    As of the Sun Cluster 3.2 release, LOFS is no longer disabled by default during Sun Cluster software installation or upgrade. To disable LOFS, ensure that the /etc/system file contains the following entry:


    exclude:lofs

    This change becomes effective at the next system reboot.

  18. As needed, manually upgrade any custom data services that are not supplied on the product media.

  19. Verify that each data-service update is installed successfully.

    View the upgrade log file that is referenced at the end of the upgrade output messages.

  20. Install any Sun Cluster 3.2 2/08 framework and software patches.

    See Patches and Required Firmware Levels in Sun Cluster 3.2 2/08 Release Notes for Solaris OS for the location of patches and installation instructions.

  21. Upgrade software applications that are installed on the cluster.

    Ensure that application levels are compatible with the current versions of Sun Cluster and Solaris software. See your application documentation for installation instructions.

  22. Shut down the node.


    phys-schost# shutdown -g0 -y
    
  23. Reboot the node into the cluster.

    • On SPARC based systems, perform the following command:


      ok boot
      
    • On x86 based systems, perform the following commands:

      When the GRUB menu is displayed, select the appropriate Solaris entry and press Enter. The GRUB menu appears similar to the following:


      GNU GRUB version 0.95 (631K lower / 2095488K upper memory)
      +-------------------------------------------------------------------------+
      | Solaris 10 /sol_10_x86                                                  |
      | Solaris failsafe                                                        |
      |                                                                         |
      +-------------------------------------------------------------------------+
      Use the ^ and v keys to select which entry is highlighted.
      Press enter to boot the selected OS, 'e' to edit the
      commands before booting, or 'c' for a command-line.
  24. Return to How to Prepare a Cluster Node for a Rolling Upgrade and repeat all upgrade procedures on the next node to upgrade.

    Repeat this process until all nodes in the cluster are upgraded.


Example 5–1 Rolling Upgrade From Sun Cluster 3.2 to Sun Cluster 3.2 2/08 Software

The following example shows the process of a rolling upgrade of a cluster node from Sun Cluster 3.2 to Sun Cluster 3.2 2/08 software on a SPARC based system that runs the Solaris 9 OS. The example includes the upgrade of all installed data services that have new versions in the Sun Cluster 3.2 2/08 release. The cluster node name is phys-schost-1.


(Upgrade framework software)
phys-schost-1# cd /cdrom/cdrom0/Solaris_sparc/Product/sun_cluster/Solaris_9/Tools/
phys-schost-1# ./scinstall
(Follow menu prompts to upgrade Sun Cluster framework on this node)
 
(Upgrade data services)
phys-schost-1# scinstall
(Follow menu prompts to upgrade Sun Cluster data services on this node)

(Reboot the node into the cluster)
phys-schost-1# shutdown -g0 -y
ok> boot

Next Steps

When all nodes in the cluster are upgraded, go to Chapter 6, Completing the Upgrade.