Sun Cluster 3.1 8/05 With Sun Java Enterprise System 5 Special Instructions

Upgrading to Sun Cluster 3.1 8/05 Software

For instructions to upgrade a Sun Cluster configuration to the 3.1 8/05 release, see Sun Cluster Software Installation Guide for Solaris OS (part number 819-0420). The upgrade instructions in Sun Cluster Software Installation Guide for Solaris OS apply to the Sun Java Enterprise System 5 distribution of Sun Cluster 3.1 8/05 software except as follows:

Install software packages from the Sun Java Enterprise System 5 DVD-ROM instead of the Sun Cluster 3.1 8/05 CD-ROMs.
Do not perform the procedure to upgrade dependency software (nonrolling upgrade or rolling upgrade). Instead, perform the following task to upgrade shared components.

Note –

Do not use the Sun Java Enterprise System 5 installer utility to install shared components for Sun Cluster software. Not all versions of the shared components that the utility installs are supported for Sun Cluster 3.1 8/05 software.

How to Upgrade Dependency Software

On the cluster node where you are installing the software packages, become superuser.

Load the Sun Java Enterprise System 5 DVD-ROM into the DVD-ROM drive.

If the Volume Management daemon vold(1M) is running and configured to manage DVD-ROM devices, it automatically mounts the DVD-ROM on the /cdrom directory.

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.
  - For the 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.
  - For the Solaris 9 OS, use the following command:
    # pkgadd -d . SUNWjdmk*
  - For the Solaris 10 OS, use the following command:
    # pkgadd -G -d . SUNWjdmk*

Ensure that at least version 4.5.0 of the Netscape^TM 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 SUNWpr SUNWprx
3. If you removed NSPR packages or none were installed, install the latest NSPR packages.
  - The following table lists the location of each package, where arch is sparc or x86 and where ver is 9 for Solaris 9 or 10 for Solaris 10.
    
    Path
    
    Packages
    
    Solaris_arch/Product/shared_components/Packages/
    
    SUNWpr
    
    Solaris_arch/Product/shared_components/Solaris_ver/Packages/
    
    SUNWprx
  - 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
  - For the 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 SUNWtls SUNWtlsu SUNWtlsx
3. If you removed NSS packages or none were installed, install the latest NSS packages.
  - The following table lists the location of each package, where arch is sparc or x86 and where ver is 9 for Solaris 9 or 10 for Solaris 10.
    
    Path
    
    Packages
    
    Solaris_arch/Product/shared_components/Packages/
    
    SUNWtls, SUNWtlsu
    
    Solaris_arch/Product/shared_components/Solaris_ver/Packages/
    
    SUNWtlsx
  - 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
  - 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.1,REV=15 of the common agent container packages is installed.

Note –
Sun Cluster 3.1 8/05 software does not support version 2.0 of the common agent container, which is also supplied with the Sun Java Enterprise System 5 distribution.
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 other than 1.1,REV=15 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 other than 1.1,REV=15 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 version 1.1 common agent container packages.
  - For the Solaris 9 OS, use the following command:
    # pkgadd -d . SUNWcacaocfg SUNWcacao
  - For the Solaris 10 OS, use the following command:
    # pkgadd -G -d . SUNWcacaocfg SUNWcacao

For upgrade from Solaris 8 to Solaris 9 OS, 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.

Unload the Sun Java Enterprise System 5 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.
  # 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.5.0_06 of Java software. If you upgraded Solaris software or in some other way installed an earlier version of Java software, the symbolic link might have been changed to point to that earlier, unsupported version 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_06/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.5.0_06 software.
  # rm /usr/java # ln -s /usr/j2se /usr/java

Path	Packages
`Solaris_arch/Product/shared_components/Packages/`	`SUNWpr`
`Solaris_arch/Product/shared_components/Solaris_ver/Packages/`	`SUNWprx`

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

Path	Packages
`Solaris_arch/Product/shared_components/Packages/`	`SUNWtls`, `SUNWtlsu`
`Solaris_arch/Product/shared_components/Solaris_ver/Packages/`	`SUNWtlsx`

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

Next Steps

Proceed to the Chapter 5, Upgrading Sun Cluster Software, in Sun Cluster Software Installation Guide for Solaris OS to upgrade Sun Cluster software by using the scinstall utility (nonrolling upgrade and rolling upgrade).