Sun and OracleChannel SunHow to BuyLog In日本語

Sun Java Enterprise System 5 Update 1 Upgrade Guide for Microsoft Windows
この本のみを検索
検索のヘルプ
内に含ま
その他のドキュメント
サポート リソース
 PDF 文書ファイルをダウンロードする (1108 KB)

Chapter 2 Upgrading Java ES Shared Components

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:

Shared Component Upgrade Overview

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.

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.

手順To 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:

  • SJWC

  • CAC

手順To 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

手順To 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.

手順To 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

手順To 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.