test

Sun Java Enterprise System 5 Update 1 Upgrade Guide for Microsoft Windows

Performing Shared Component Upgrades

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.

Feature Upgrades of Shared Components

The general approach for upgrading the shared components needed when performing a feature upgrade is described in the following section.

General Approach

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.

Maintenance Upgrades

The general approach and specific procedure for upgrading shared components when performing a maintenance upgrade are described in the following sections.

General Approach

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

Description 

Patch ID [Patch revision numbers are the minimum required for upgrade to Release 5U1. If newer revisions become available, use the newer ones instead of those shown in the table.]

MFWK (Sun Java Monitoring Framework) 

125449–09 

JDMK (Java Dynamic Management Kit) 

126822–03 

NSS, JSS, NSPR (Network Security Services, Java Security Services, Netscape Portable Runtime) 

125923–03 
   

SJWC (Sun Java Web Console) 

125955–05 

CAC runtime (Common Agent Container) 

126183–04 

CAC webserver 

126183–04 

CAC monitoring 

126183–04 
   

Upgrading Shared Components Providing Libraries (MFWK, JDMK, and NSS)

This section provides the maintenance upgrade procedure for shared components that provide libraries.

Note –

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.

ProcedureTo Upgrade Shared Components Providing Libraries

  1. Log in as administrator.

  2. Obtain the latest upgrade patches for the shared component, as shown in Table 2–1.

    Patches can be downloaded to \workingDirectory.

    See Accessing Java ES Patches.

  3. Stop any processes that are using the shared component.

    Note –

    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.

  4. 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.

  5. 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.

    Note –

    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.

  6. 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.

  7. Start the processes that use the shared component.

    Start the components stopped in step 3.

Upgrading Shared Components Providing Services

This section provides the maintenance upgrade procedure for shared components that provide services.

Shared components providing services include:

ProcedureTo Upgrade Sun Java Web Console (SJWC)

  1. Log in as administrator.

  2. Obtain the latest upgrade patches for SJWC, as shown in Table 2–1. Patches can be downloaded to \workingDirectory

    See Accessing Java ES Patches.

  3. Stop SJWC.

    For example,

    C:\Program Files\Sun\Java ES5\share\webconsole\bin\smcwebserver.bat stop

  4. Make sure you have upgraded any hard upgrade dependencies.

    SJWC patch requires that Windows Installer patch (126910–02) is already applied.

  5. 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.

    Note –

    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.

  6. 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.

  7. Start SJWC.

    For example,

    C:\Program Files\Sun\JavaES5\share\webconsole\bin\smcwebserver.bat start

  8. 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:

    Release 5U1

    Sun Java Web Console 3.0.3

    Release 5

    Sun Java Web Console 3.0.2

ProcedureTo Roll-back the SJWC Upgrade

  1. Stop SJWC.

    C:\Program Files\Sun\Java ES5\share\webconsole\bin\smcwebserver.bat stop

  2. Double-click Uninstall_patch-id.bat.

    This will restore the SJWC to its previous version.

ProcedureTo Upgrade Common Agent Container (CAC)

  1. Log in as administrator.

  2. Obtain the latest upgrade patches for the shared component, as shown in Table 2–1. Patches can be downloaded to \workingDirectory

    See Accessing Java ES Patches.

  3. Stop any component that is using CAC services.

    For example,

    Stop Monitoring Console by stopping SJWC.

    JavaES5InstallDir\share\webconsole\bin\smcwebserver.bat stop

  4. Shut down CAC and prepare it for upgrade.

    JavaES5InstallDir\share\cacao_2\bin\cacaoadm.bat prepare-uninstall

  5. 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.

    Note –

    JDK, JDMK, and NSS are not hard dependencies. The minimal versions specified here are sufficient for upgrading CAC to 2.1.

  6. 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.

    Note –

    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.

  7. 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.

  8. 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.

    Note –

    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

  9. Start CAC.

    JavaES5InstallDir\share\cacao_2\cacaoadm.bat start

  10. 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

  11. Start components using CAC.

    Check the CAC version.

    JavaES5InstallDir\share\cacao_2\cacaoadm.bat –version

    The messages that indicate the CAC release versions are:

    Release 5U1

    2.1.0

    Release 5

    2.0, REV=13

ProcedureTo Roll-back the Common Agent Container Upgrade

  1. Stop and remove the configuration for CAC.

    JavaES5InstallDir\share\cacao_2\bin\cacaoadm.bat prepare-uninstall

  2. Double-click Uninstall_patch-id.bat.

    This will restore the CAC version 2.0. To use this version, configure again.

Java SE Upgrade

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.

Note –

HADB does not currently support Java SE 6.