How to Perform a Rolling Upgrade of Sun Cluster 3.1 8/05 Software (Sun Cluster Software Installation Guide for Solaris OS)

Sun Cluster Software Installation Guide for Solaris OS

How to Perform a Rolling Upgrade of Sun Cluster 3.1 8/05 Software

Perform this procedure to upgrade a node to Sun Cluster 3.1 8/05 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.

Before You Begin

Ensure that dependency software is installed or upgraded. See How to Upgrade Dependency Software Before a Rolling Upgrade.

Steps

Become superuser on the node of the cluster.

Insert the Sun Cluster 2 of 2 CD-ROM in the CD-ROM drive on the node.

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

Change to the Solaris_arch/Product/sun_cluster/Solaris_ver/Tools/ directory, where arch is sparc or x86 and where ver is 8 for Solaris 8, 9 for Solaris 9, or 10 for Solaris 10 .
# cd /cdrom/cdrom0/Solaris_arch/Product/sun_cluster/Solaris_ver/Tools

Start the scinstall utility.
# ./scinstall
Note –
Do not use the /usr/cluster/bin/scinstall command that is already installed on the node. You must use the scinstall command on the Sun Cluster 2 of 2 CD-ROM.

From the Main Menu, choose the menu item, Upgrade this cluster node.

  *** Main Menu ***

    Please select from one of the following (*) options:

      * 1) Install a cluster or cluster node
        2) Configure a cluster to be JumpStarted from this install server
      * 3) Add support for new data services to this cluster node
      * 4) Upgrade this cluster node
      * 5) Print release information for this cluster node

      * ?) Help with menu options
      * q) Quit

    Option:  4

From the Upgrade Menu, choose the menu item, Upgrade Sun Cluster framework on this node.

Follow the menu prompts to upgrade the cluster framework.

During Sun Cluster upgrade, scinstall might make one or more of the following configuration changes:
- Convert NAFO groups to IP Network Multipathing groups but keep the original NAFO-group name.
  
  See one of the following manuals for information about test addresses for IP Network Multipathing:
  - IP Network Multipathing Administration Guide (Solaris 8)
  - Configuring Test Addresses in Administering Multipathing Groups With Multiple Physical Interfaces in System Administration Guide: IP Services (Solaris 9)
  - Test Addresses in System Administration Guide: IP Services (Solaris 10)
  See the scinstall(1M) man page for more information about the conversion of NAFO groups to IP Network Multipathing during Sun Cluster software upgrade.
- Rename the ntp.conf file to ntp.conf.cluster, if ntp.conf.cluster does not already exist on the node.
- Set the local-mac-address? variable to true, if the variable is not already set to that value.
Upgrade processing is finished when the system displays the message Completed Sun Cluster framework upgrade and prompts you to press Enter to continue.

Press Enter.

The Upgrade Menu is displayed.

(Optional) Upgrade Java Enterprise System data services from the Sun Cluster 2 of 2 CD-ROM.
1. From the Upgrade Menu of the scinstall utility, choose the menu item, Upgrade Sun Cluster data service agents on this node.
2. 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.
3. Press Enter.
  
  The Upgrade Menu is displayed.

Quit the scinstall utility.

Change to a directory that does not reside on the CD-ROM and eject the CD-ROM.
# eject cdrom

Upgrade Sun Cluster data services from the Sun Cluster Agents CD.
- If you are using the Sun Cluster HA for NFS data service and you upgrade to the Solaris 10 OS, you must upgrade the data service and migrate the resource type to the new version. See Upgrading the SUNW.nfs Resource Type in Sun Cluster Data Service for NFS Guide for Solaris OS for more information.
- If you are using the Sun Cluster HA for Oracle 3.0 64-bit for Solaris 9 data service, you must upgrade to the Sun Cluster 3.1 8/05 version.
- The upgrade of any other data services to the Sun Cluster 3.1 8/05 version is optional. You can continue to use any other Sun Cluster 3.x data services after you upgrade the cluster to Sun Cluster 3.1 8/05 software.
1. Insert the Sun Cluster Agents CD in the CD-ROM drive on the node.
2. Start the scinstall utility.
  
  For data-service upgrades, you can use the /usr/cluster/bin/scinstall command that is already installed on the node.
  # scinstall
3. From the Main Menu, choose the menu item, Upgrade this cluster node.
4. From the Upgrade Menu, choose the menu item, Upgrade Sun Cluster data service agents on this node.
5. 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.
6. Press Enter.
  
  The Upgrade Menu is displayed.
7. Quit the scinstall utility.
8. Change to a directory that does not reside on the CD-ROM and eject the CD-ROM.
  # eject cdrom

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

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.

Install any Sun Cluster 3.1 8/05 software patches, if you did not already install them by using the scinstall command.

Install any Sun Cluster 3.1 8/05 data-service software patches.

See Patches and Required Firmware Levels in Sun Cluster 3.1 8/05 Release Notes for Solaris OS for the location of patches and installation instructions.

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. In addition, follow these guidelines to upgrade applications in a Sun Cluster 3.1 8/05 configuration:

If the applications are stored on shared disks, you must master the relevant disk groups and manually mount the relevant file systems before you upgrade the application.

If you are instructed to reboot a node during the upgrade process, always add the -x option to the command.

The -x option ensures that the node reboots into noncluster mode. For example, either of the following two commands boot a node into single-user noncluster mode:

On SPARC based systems, perform the following commands:
# reboot -- -xs ok boot -xs

On x86 based systems, perform the following commands:

# reboot -- -xs
…
                    <<< Current Boot Parameters >>>
Boot path: /pci@0,0/pci-ide@7,1/ata@1/cmdk@0,0:b
Boot args:

Type  b [file-name] [boot-flags] <ENTER>   to boot with options
or    i <ENTER>                            to enter boot interpreter
or    <ENTER>                              to boot with defaults

                <<< timeout in 5 seconds >>>
Select (b)oot or (i)nterpreter: b -xs

Note –

Do not upgrade an application if the newer version of the application cannot coexist in the cluster with the older version of the application.

Reboot the node into the cluster.
# reboot

Run the following command on the upgraded node to verify that Sun Cluster 3.1 8/05 software was installed successfully.
# scinstall -pv
The first line of output states which version of Sun Cluster software the node is running. This version should match the version you just upgraded to.

From any node, verify the status of the cluster configuration.
% scstat % scrgadm -pv[v]
Output should be the same as for Step 5 in How to Prepare a Cluster Node for a Rolling Upgrade.

If you have another node to upgrade, return to How to Prepare a Cluster Node for a Rolling Upgrade and repeat all upgrade procedures on the next node to upgrade.

Example 5–2 Rolling Upgrade From Sun Cluster 3.1 to Sun Cluster 3.1 8/05 Software

The following example shows the process of a rolling upgrade of a cluster node from Sun Cluster 3.1 to Sun Cluster 3.1 8/05 software on the Solaris 8 OS. The example includes the upgrade of all installed data services that have new versions on the Sun Cluster Agents CD. The cluster node name is phys-schost-1.

(Upgrade framework software from the Sun Cluster 2 of 2 CD-ROM)
phys-schost-1# cd /cdrom/cdrom0/Solaris_sparc/Product/sun_cluster/Solaris_8/Tools/
phys-schost-1# ./scinstall
 
(Upgrade data services from the Sun Cluster Agents CD)
phys-schost-1# scinstall

(Reboot the node into the cluster)
phys-schost-1# reboot

(Verify that software upgrade succeeded)
# scinstall -pv

(Verify cluster status)
# scstat
# scrgadm -pv

Next Steps

When all nodes in the cluster are upgraded, go to How to Finish a Rolling Upgrade to Sun Cluster 3.1 8/05 Software.