How to Upgrade Dependency Software Before a Rolling Upgrade (Sun Cluster Software Installation Guide for Solaris OS)

Sun Cluster Software Installation Guide for Solaris OS

How to Upgrade Dependency Software Before a Rolling Upgrade

Perform this procedure on each cluster node to install or upgrade software on which Sun Cluster 3.1 8/05 software has a dependency. The cluster remains in production during this procedure. If you are running SunPlex Manager, status on a node will not be reported during the period that the node's security file agent is stopped. Status reporting resumes when the security file agent is restarted, after the common agent container software is upgraded.

Before You Begin

Perform the following tasks:

Ensure that all steps in How to Prepare a Cluster Node for a Rolling Upgrade are completed.
If you upgraded the Solaris OS to a Maintenance Update release, ensure that all steps in How to Perform a Rolling Upgrade of a Solaris Maintenance Update are completed.
Ensure that you have installed all required Solaris software patches and hardware-related patches.
If the cluster runs Solstice DiskSuite software (Solaris 8), ensure that you have installed all required Solstice DiskSuite software patches.

Steps

Become superuser on the cluster node.

For the Solaris 8 and Solaris 9 OS, ensure that the Apache Tomcat package is at the required patch level, if the package is installed.
1. Determine whether the SUNWtcatu package is installed.
  # pkginfo SUNWtcatu SUNWtcatu Tomcat Servlet/JSP Container
2. If the Apache Tomcat package is installed, determine whether the required patch for the platform is installed.
  - SPARC based platforms require at least 114016-01
  - x86 based platforms require at least 114017-01
  # patchadd -p | grep 114016 Patch: 114016-01 Obsoletes: Requires: Incompatibles: Packages: SUNWtcatu
3. If the required patch is not installed, remove the Apache Tomcat package.
  # pkgrm SUNWtcatu

Insert the Sun Cluster 1 of 2 CD-ROM.

Change to the /cdrom/cdrom0/Solaris_arch/Product/shared_components/Packages/ directory, where arch is sparc or x86 .
# cd Solaris_arch/Product/shared_components/Packages/

Ensure that at least version 4.3.1 of the Explorer packages is installed.

These packages are required by Sun Cluster software for use by the sccheck utility.
1. Determine whether the Explorer packages are installed and, if so, what version.
  # pkginfo -l SUNWexplo | grep SUNW_PRODVERS SUNW_PRODVERS=4.3.1
2. If a version earlier than 4.3.1 is installed, remove the existing Explorer packages.
  # pkgrm SUNWexplo SUNWexplu SUNWexplj
3. If you removed Explorer packages or none were installed, install the latest Explorer packages from the Sun Cluster 1 of 2 CD-ROM.
  - For the Solaris 8 or Solaris 9 OS, use the following command:
    # pkgadd -d . SUNWexpl*
  - For the Solaris 10 OS, use the following command:
    # pkgadd -G -d . SUNWexpl*
    The -G option adds packages to the current zone only. You must add these packages only to the global zone. Therefore, this option also specifies that the packages are not propagated to any existing non-global zone or to any non-global zone that is created later.

Ensure that at least version 5.1,REV=34 of the Java Dynamic Management Kit (JDMK) packages is installed.
1. Determine whether JDMK packages are installed and, if so, what version.
  # pkginfo -l SUNWjdmk-runtime | grep VERSION VERSION=5.1,REV=34
2. If a version earlier than 5.1,REV=34 is installed, remove the existing JDMK packages.
  # pkgrm SUNWjdmk-runtime SUNWjdmk-runtime-jmx
3. If you removed JDMK packages or none were installed, install the latest JDMK packages from the Sun Cluster 1 of 2 CD-ROM.
  - For the Solaris 8 or Solaris 9 OS, use the following command:
    # pkgadd -d . SUNWjdmk*
  - For the Solaris 10 OS, use the following command:
    # pkgadd -G -d . SUNWjdmk*

Change to the Solaris_arch/Product/shared_components/Solaris_ver/Packages/ 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 ../Solaris_ver/Packages

Ensure that at least version 4.5.0 of the Netscape Portable Runtime (NSPR) packages is installed.
1. Determine whether NSPR packages are installed and, if so, what version.
  # cat /var/sadm/pkg/SUNWpr/pkginfo | grep SUNW_PRODVERS SUNW_PRODVERS=4.5.0
2. If a version earlier than 4.5.0 is installed, remove the existing NSPR packages.
  # pkgrm packages
  The following table lists the applicable packages for each hardware platform.
  
  Note –
  Install packages in the order in which they are listed in the following table.
  
  Hardware Platform
  
  NSPR Package Names
  
  SPARC
  
  SUNWpr SUNWprx
  
  x86
  
  SUNWpr
3. If you removed NSPR packages or none were installed, install the latest NSPR packages.
  - For the Solaris 8 or Solaris 9 OS, use the following command:
    # pkgadd -d . packages
  - For the Solaris 10 OS, use the following command:
    # pkgadd -G -d . packages

Ensure that at least version 3.9.4 of the Network Security Services (NSS) packages is installed.
1. Determine whether NSS packages are installed and, if so, what version.
  # cat /var/sadm/pkg/SUNWtls/pkginfo | grep SUNW_PRODVERS SUNW_PRODVERS=3.9.4
2. If a version earlier than 3.9.4 is installed, remove the existing NSS packages.
  # pkgrm packages
  The following table lists the applicable packages for each hardware platform.
  
  Note –
  Install packages in the order in which they are listed in the following table.
  
  Hardware Platform
  
  NSS Package Names
  
  SPARC
  
  SUNWtls SUNWtlsu SUNWtlsx
  
  x86
  
  SUNWtls SUNWtlsu
3. If you removed NSS packages or none were installed, install the latest NSS packages from the Sun Cluster 1 of 2 CD-ROM.
  - For the Solaris 8 or Solaris 9 OS, use the following command:
    # pkgadd -d . packages
  - For the Solaris 10 OS, use the following command:
    # pkgadd -G -d . packages

Change back to the Solaris_arch/Product/shared_components/Packages/ directory.
# cd ../../Packages

Ensure that at least version 1.0,REV=25 of the common agent container packages is installed.
1. Determine whether the common agent container packages are installed and, if so, what version.
  # pkginfo -l SUNWcacao | grep VERSION VERSION=1.0,REV=25
2. If a version earlier than 1.0,REV=25 is installed, stop the security file agent for the common agent container on each cluster node.
  # /opt/SUNWcacao/bin/cacaoadm stop
3. If a version earlier than 1.0,REV=25 is installed, remove the existing common agent container packages.
  # pkgrm SUNWcacao SUNWcacaocfg
4. If you removed the common agent container packages or none were installed, install the latest common agent container packages from the Sun Cluster 1 of 2 CD-ROM.
  - For the Solaris 8 or Solaris 9 OS, use the following command:
    # pkgadd -d . SUNWcacao*
  - For the Solaris 10 OS, use the following command:
    # pkgadd -G -d . SUNWcacao*

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

Insert the Sun Cluster 2 of 2 CD-ROM.

Install or upgrade Sun Java Web Console packages.
1. Change to the Solaris_arch/Product/sunwebconsole/ directory, where arch is sparc or x86.
2. Install the Sun Java Web Console packages.
  # ./setup
  The setup command installs or upgrades all packages to support Sun Java Web Console.

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

Ensure that the /usr/java/ directory is a symbolic link to the minimum or latest version of Java software.

Sun Cluster software requires at least version 1.4.2_03 of Java software.
1. Determine what directory the /usr/java/ directory is symbolically linked to.
  # ls -l /usr/java lrwxrwxrwx 1 root other 9 Apr 19 14:05 /usr/java -> /usr/j2se/
2. Determine what version or versions of Java software are installed.
  
  The following are examples of commands that you can use to display the version of their related releases of Java software.
  # /usr/j2se/bin/java -version # /usr/java1.2/bin/java -version # /usr/jdk/jdk1.5.0_01/bin/java -version
3. If the /usr/java/ directory is not symbolically linked to a supported version of Java software, recreate the symbolic link to link to a supported version of Java software.
  
  The following example shows the creation of a symbolic link to the /usr/j2se/ directory, which contains Java 1.4.2_03 software.
  # rm /usr/java # ln -s /usr/j2se /usr/java

Hardware Platform	NSPR Package Names
SPARC	`SUNWpr SUNWprx`
x86	`SUNWpr`

Hardware Platform	NSS Package Names
SPARC	`SUNWtls SUNWtlsu SUNWtlsx`
x86	`SUNWtls SUNWtlsu`

Next Steps

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