Release 5 Monitoring Console Upgrade

This section describes how to perform an upgrade of Monitoring Console from Java ES 5 to Java ES 5 Update 1. This section covers the following topics:

• Pre-Upgrade Tasks

• Upgrading Release 5 Monitoring Console

• Verifying the Upgrade

• Post-Upgrade Tasks

• Rolling Back the Upgrade

Pre-Upgrade Tasks

Before you upgrade Monitoring Console, perform the tasks described below.

• Verify Current Version Information

• Upgrade Monitoring Console Dependencies

• Backing Up Monitoring Console Data

Verify Current Version Information

Verify the current version of Monitoring Console before you upgrade.

To Verify Current Version Information

1. Open the Monitoring Console URL in a web browser:

   https:MonitoringConsole_Host:6789

2. Log in as the Administrator.

3. Click the Sun Java System Monitoring Console link.

4. Click the Version button.

5. The Monitoring Console version information is displayed.

   Release 5U1

   Monitoring Console 1.0 u1

   Release 5

   Monitoring Console 1.0

Upgrade Monitoring Console Dependencies

It is generally recommended that all Java ES components on a computer system (and in a computing environment) be upgraded to Release 5U1. Release 5U1 Monitoring Console has hard upgrade dependencies on MFWK and SJWC shared components, which therefore need to be upgraded before upgrading Monitoring Console. Monitoring Console also requires that Windows Installer patch (126910–02) is already applied.

Backing Up Monitoring Console Data

Upgrade of Monitoring Console to Release 5U1 does not require the reconfiguration of Monitoring Console software. Therefore backup of Monitoring Console data is optional.

Upgrading Release 5 Monitoring Console

This section discusses considerations that impact the upgrade procedure for Monitoring Console, followed by a description of the procedure itself.

Upgrade Considerations

The upgrade of Monitoring Console software to Java ES 5 Update 1 takes into account the following considerations:

• In a maintenance upgrade, you do not have to migrate schema, configuration, security or user data.

• The Release 5U1 Monitoring Console upgrade patches for Windows are shown in the following table:

Table 13–3 Patches to Upgrade Monitoring Console 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.]
Monitoring Console core	125454–07
Monitoring Console localization	The localized patch files are delivered within the core patch.

Upgrade Procedure

The procedure documented below applies to Monitoring Console instances residing locally on the computer where the upgrade is taking place.

To Upgrade Monitoring Console to Java ES 5 Update 1

1. Log in as Administrator.

2. Shut down the Release 5 Monitoring Console instances by stopping SJWC.

   You can stop Monitoring Console by stopping SJWC.

   For example, you can stop the default SJWC instance from the command line.

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

3. Make sure you have upgraded any Java ES components upon which Monitoring Console has hard upgrade dependencies (see Upgrade Monitoring Console Dependencies.

4. Obtain the required Monitoring Console Release 5U1 upgrade patches, based on Table 13–3.

   To obtain the patch, see Accessing Java ES Patches. Patches can be downloaded to \workingDirectory.

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

   The log file is found at: %TEMP%\SUNJAVAES_<patch-id>.log

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 5. For more information, see Identifying Installed Java ES Patches.

8. Start SJWC.

   For example, start the default SJWC instance.

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

9. Undeploy the Release 5 Monitoring Console web application.

   C:\Program Files\Sun\JavaES5\share\webconsole\bin\wcadmin.bat undeploy -a jesmc/ -x \jesmc

10. Deploy the Release 5U1 Monitoring Console web application.

    C:\Program Files\Sun\JavaES5\share\webconsole\bin\wcadmin.bat deploy -a jesmc/ -x \jesmc MonitoringConsole-base

11. Load the Release 5U1 Monitoring Console by restarting SJWC.

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

Verifying the Upgrade

1. Open the Monitoring Console URL in a web browser:

   https:MonitoringConsole_Host:6789

2. Log in as the Administrator.

3. Click the Sun Java System Monitoring Console link.

4. Click the Version button.

   Monitoring Console 1.0u1 indicates that the upgrade to Release 5 is successful.

Post-Upgrade Tasks

No post-upgrade tasks are required when upgrading Release 5 Monitoring Console to Release 5U1.

Rolling Back the Upgrade

This section describes the Release 5U1 upgrade rollback procedure for Monitoring Console.

1. Log in as Administrator.

2. Stop the Monitoring Console.

3. Double-click uniinstall_patch-id.bat to uninstall the patch.

4. Undeploy the Release 5U1 Monitoring Console web application.

   C:\Program Files\Sun\JavaES5\share\webconsole\bin\wcadmin undeploy -a jesmc -x \jesmc

5. Deploy the Release 5 Monitoring Console web application.

   C:\Program Files\Sun\JavaES5\share\webconsole\bin\wcadmin deploy -a jesmc -x \jesmc MonitoringConsole-base

6. Restart Release 5 Monitoring Console.

   C:\Program Files\Sun\JavaES5\share\webconsole\bin\smcwebserver restart