This chapter provides information on upgrading Java ES shared components from Java ES 5 (Release 5) to Java ES 5 Update 1 (Release 5U1).
Each Java ES product component depends on one or more locally shared libraries known as Java ES shared components. These shared components are upgraded from Release 5 to Release 5U1 by applying the appropriate patches to the Release 5 versions.
The chapter contains the following sections:
Upgrading shared components to Java ES 5 Update 1 should be done as part of a larger upgrade plan, as discussed in Chapter 1, Planning for Upgrades. To ensure that you have a successful upgrade, prepare an upgrade plan that meets your needs.
The procedure for upgrading shared components can depend upon whether you are performing a feature upgrade or a maintenance upgrade of Java ES product components, as described in the following sections.
The general approach for upgrading the shared components needed when performing a feature upgrade is described in the following section.
The approach for upgrading the shared components needed when performing a feature upgrade of a particular Java ES product component is to determine all the shared components required and manually install or upgrade these to their Release 5 versions.
The general approach and specific procedure for upgrading shared components when performing a maintenance upgrade are described in the following sections.
In the case of maintenance upgrades of product components within a Java ES release family, shared components do not have to be synchronized to the same release version. If you perform a maintenance upgrade of a product component, you only need to upgrade those shared components upon which that product component has hard upgrade dependencies.
You can patch the selected shared components to satisfy Release 5U1 hard upgrade dependencies. See Table 1–8.
Following are the shared components which have Java ES 5 Update 1 versions:
Table 2–1 Patches to Upgrade Shared Components on Windows
This section provides the maintenance upgrade procedure for shared components that provide libraries.
For information about how to check the versions of the library files currently installed, see Checking the version of DLLs.
Shared components providing libraries include MFWK, JDMK, and NSS.
Log in as administrator.
Obtain the latest upgrade patches for the shared component, as shown in Table 2–1.
Patches can be downloaded to \workingDirectory.
Stop any processes that are using the shared component.
Some components like NSS are widely used by Java ES components. It is recommended to stop all installed Java ES 5 components before updating.
Stop Monitoring Console and CAC before updating MFWK.
Make sure you have applied Windows Installer patch.
Patches for the shared components providing libraries require that Windows Installer patch (126910–02) is already applied.
Install the patch.
Installation is generally performed by running patch-id.exe, however, be sure to consult the README.patch-id file in the patch directory for installation instructions.
If you are prompted to restart the system, select No. Wait till the patch installation process is completed and then restart and re-login as the same user to complete the patch installation.
Verify the patch installation with the utility ListJavaESPatches.exe.
Run ListJavaESPatches.exe and check that the output includes the patch id of the patch that you have installed in Step 5. For more information, see Identifying Installed Java ES Patches.
Start the processes that use the shared component.
Start the components stopped in step 3.
This section provides the maintenance upgrade procedure for shared components that provide services.
Shared components providing services include:
SJWC
CAC
Log in as administrator.
Obtain the latest upgrade patches for SJWC, as shown in Table 2–1. Patches can be downloaded to \workingDirectory
Stop SJWC.
For example,
C:\Program Files\Sun\Java ES5\share\webconsole\bin\smcwebserver.bat stop
Make sure you have upgraded any hard upgrade dependencies.
SJWC patch requires that Windows Installer patch (126910–02) is already applied.
Install the patch.
Installation is generally performed by running patch-id.exe, however, be sure to consult the README.patch-id file in the patch directory for installation instructions.
If you are prompted to restart the system, select No. Wait till the patch installation process is completed and then restart and re-login as the same user to complete the patch installation.
Verify the patch installation with the utility ListJavaESPatches.exe.
Run ListJavaESPatches.exe and check that the output includes the patch id of the patch that you have installed in Step 5. For more information, see Identifying Installed Java ES Patches.
Start SJWC.
For example,
C:\Program Files\Sun\JavaES5\share\webconsole\bin\smcwebserver.bat start
Check the version from command line.
For example,
C:\Program Files\Sun\JavaES5\share\webconsole\bin\smcwebserver.bat --version
The messages that indicates the SJWC release version are:
Sun Java Web Console 3.0.3
Sun Java Web Console 3.0.2
Stop SJWC.
C:\Program Files\Sun\Java ES5\share\webconsole\bin\smcwebserver.bat stop
Double-click Uninstall_patch-id.bat.
This will restore the SJWC to its previous version.
Log in as administrator.
Obtain the latest upgrade patches for the shared component, as shown in Table 2–1. Patches can be downloaded to \workingDirectory
Stop any component that is using CAC services.
For example,
Stop Monitoring Console by stopping SJWC.
JavaES5InstallDir\share\webconsole\bin\smcwebserver.bat stop
Shut down CAC and prepare it for upgrade.
JavaES5InstallDir\share\cacao_2\bin\cacaoadm.bat prepare-uninstall
Make sure you have upgraded any hard upgrade dependencies.
CAC patch requires that Windows Installer patch (126910–02) is already applied.
The following software dependencies are required to be present in the host before starting the container: JDK (1.4.2_03 or higher), JDMK 5.1.
NSS 3.11 is the optional dependency, required for using the command stream feature.
JDK, JDMK, and NSS are not hard dependencies. The minimal versions specified here are sufficient for upgrading CAC to 2.1.
Install the patch.
Installation is generally performed by running patch-id.exe, however, be sure to consult the README.patch-id file in the patch directory for installation instructions.
If you are prompted to restart the system, select No. Wait till the patch installation process is completed and then restart and re-login as the same user to complete the patch installation.
Verify the patch installation with the utility ListJavaESPatches.exe.
Run ListJavaESPatches.exe and check that the output includes the patch id of the patch that you have installed in Step 6. For more information, see Identifying Installed Java ES Patches.
Post-configure the CAC by running the following two commands:
JavaES5InstallDir\share\cacao_2\configure.bat
JavaES5InstallDir\share\cacao_2\bin\cacaoadm.bat rebuild-dependencies
Be sure to consult the README.patch-id file for additional patch installation instructions.
The CAC dependencies are JDK, JDMK, and NSS. The location of Java is automatically retrieved from the registry.
The location of JDMK is set to default installation value. To modify it, execute the following command:
JavaES5InstallDir\share\cacao_2\bin\cacaoadm set-param jdmk-home=path to-jdmk-home
The location of NSS is unknown as it is delivered as an optional zip file. If you require the command stream feature of the CAC, then NSS is required. You can provide the paths to the NSS tools and libraries by executing the following commands:
JavaES5InstallDir\share\cacao_2\bin\cacaoadm set-param nss-lib-home=path-to-nss-lib-home
JavaES5InstallDir\share\cacao_2\bin\cacaoadm set-param nss-tools-home=path-to-nss-tools-home
Start CAC.
JavaES5InstallDir\share\cacao_2\cacaoadm.bat start
Check that all the CAC agents are loaded correctly.
JavaES5InstallDir\share\cacao_2\cacaoadm.bat list-modules
List of modules registered:
com.sun.cacao.agent_logging 1.0
com.sun.cacao.command_stream_adaptor 1.0
com.sun.cacao.efd 2.0
com.sun.cacao.instrum 1.0
com.sun.cacao.invoker 1.0
com.sun.cacao.mib2simple 1.0
com.sun.cacao.rmi 1.0
com.sun.cacao.snmpv3_adaptor 1.0
com.sun.cacao.webserver 2.1
com.sun.cmm.am 1.0
com.sun.cmm.as 1.0
com.sun.cmm.ds 1.0
com.sun.cmm.ps 1.0
com.sun.cmm.ws 1.0
com.sun.directory.nquick 1.0
com.sun.mfwk 2.0
com.sun.portal.admin.server.module 1.1
Start components using CAC.
Check the CAC version.
JavaES5InstallDir\share\cacao_2\cacaoadm.bat –version
The messages that indicate the CAC release versions are:
2.1.0
2.0, REV=13
Stop and remove the configuration for CAC.
JavaES5InstallDir\share\cacao_2\bin\cacaoadm.bat prepare-uninstall
Double-click Uninstall_patch-id.bat.
This will restore the CAC version 2.0. To use this version, configure again.
Java ES 5 Update 1 continues to support the same versions of Java SE 5 that were supported by Java ES 5. Namely Java SE 5.0 Update 9 or later and any Java SE 6 release. Java SE is not distributed with this release. Java SE can be downloaded from http://java.sun.com.
HADB does not currently support Java SE 6.