Chapter 13 Monitoring Console
This chapter describes how to upgrade Monitoring Console to Java ES
5 Update 1 (Release 5U1): Monitoring Console 1.0 u1.
The chapter provides a general overview of upgrade issues and procedures
for the different upgrade paths supported by Release 5U1. This chapter covers
the following sections:
Note –
File locations in this chapter are specified with respect to a
directory path referred to as MonitoringConsole-base.
This path was set by the Java ES installer when Monitoring Console was installed.
The default value of these directory paths are:
-
MonitoringConsole-base
-
C:\Program Files\Sun\JavaES5\jesmc\jesmc
-
MonitoringConsoleConfig-base
-
C:\Program Files\Sun\JavaES5\share\mfwk\config
-
MonitoringConsoleData-base
-
C:\Program Files\Sun\JavaES5\share\mfwk
Overview of Monitoring Console Upgrades
The following sections describe general aspects of Monitoring Console
that impact upgrading to Java ES 5 Update 1 :
About Release 5U1 Monitoring Console
Monitoring Console Web GUI is an application in SJWC. Release 5U1 Monitoring
Console is a maintenance release that fixes bugs in Java ES 5 (Release 5)
Monitoring Console and adds a few new features. See the Monitoring
Console Release Notes for details. Monitoring Console was first
introduced into Java ES with Release 5.
Release 5U1 Upgrade Roadmap
The following table shows the supported Monitoring Console upgrade paths
to Java ES 5 Update 1.
Table 13–1 Upgrade Paths to Java ES 5 Monitoring
Console 1.0 u1
|
Java ES Release
|
Monitoring Console Release
|
General Approach
|
Reconfiguration Required
|
|
Release 5
|
Monitoring Console 1.0
|
Maintenance upgrade. Apply patches.
|
None
|
Monitoring Console Data
The following table shows the type of data that could be impacted by
an upgrade of Monitoring Console software.
Table 13–2 Monitoring Console Data Usage
|
Type of Data
|
Location
|
Usage
|
|
Master Agent configuration data
|
MonitoringConsoleConfig-base\masteragent.properties
|
Configuration of Monitoring Framework Master Agent.
|
|
Console node list
|
MonitoringConsoleConfig-base\nodelist
|
List of the hosts displayed in the console.
|
|
Console user preferences
|
MonitoringConsoleData-base\userPrefs/master_agent
|
User preferences
|
|
Monitoring rules
|
MonitoringConsoleData-base\persistence/threshold/ma
|
Monitoring rules
|
Monitoring Console Compatibility Issues
Java ES 5 Update 1 Monitoring Console is backward compatible with the
Release 5 version.
Monitoring Console Dependencies
Monitoring Console has dependency on a number of shared components Java
ES components (see Table 1–8).
Upgrading Monitoring Console from Java ES 5
This section includes information about upgrading Monitoring Console
from Java ES 5 to Java ES 5 Update 1 . The section covers the following topics:
Introduction
When upgrading Release 5 Monitoring Console to Release 5U1, consider
the following aspects of the upgrade process:
-
General Upgrade Approach. The
upgrade is achieved by patching Release 5 Monitoring Console.
-
Upgrade Dependencies. Monitoring
Console has dependencies on a number of Java ES shared components (see Table 1–8), two of are hard upgrade dependencies
and need to be upgraded when you perform a maintenance upgrade of Monitoring
Console: MFWK and SJWC.
-
Backward Compatibility. Release
5UI Monitoring Console is backwardly compatible with the Release 5 version.
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
Before you upgrade Monitoring Console, perform the tasks described below.
Verify Current Version Information
Verify the current version of Monitoring Console before you upgrade.
To Verify Current Version Information
-
Open the Monitoring Console URL in a web browser:
https:MonitoringConsole_Host:6789
-
Log in as the Administrator.
-
Click the Sun Java System Monitoring Console link.
-
Click the Version button.
-
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
-
Log in as Administrator.
-
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
-
Make sure you have upgraded any Java ES components upon which
Monitoring Console has hard upgrade dependencies (see Upgrade Monitoring Console Dependencies.
-
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.
-
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.
-
Verify the patch log file.
The log file is found
at: %TEMP%\SUNJAVAES_<patch-id>.log
-
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, start the default SJWC instance.
C:\Program Files\Sun\JavaES\share\webconsole\bin\smcwebserver.bat
start
-
Undeploy the Release 5 Monitoring Console web application.
C:\Program Files\Sun\JavaES5\share\webconsole\bin\wcadmin.bat
undeploy -a jesmc/ -x \jesmc
-
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
-
Load the Release 5U1 Monitoring Console by restarting SJWC.
C:\Program Files\Sun\JavaES5\share\webconsole\bin\smcwebserver.bat
restart
Verifying the Upgrade
-
Open the Monitoring Console URL in a web browser:
https:MonitoringConsole_Host:6789
-
Log in as the Administrator.
-
Click the Sun Java System Monitoring Console link.
-
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.
-
Log in as Administrator.
-
Stop the Monitoring Console.
-
Double-click uniinstall_patch-id.bat to uninstall the patch.
-
Undeploy the Release 5U1 Monitoring Console web application.
C:\Program Files\Sun\JavaES5\share\webconsole\bin\wcadmin undeploy
-a jesmc -x \jesmc
-
Deploy the Release 5 Monitoring Console web application.
C:\Program Files\Sun\JavaES5\share\webconsole\bin\wcadmin deploy
-a jesmc -x \jesmc MonitoringConsole-base
-
Restart Release 5 Monitoring Console.
C:\Program
Files\Sun\JavaES5\share\webconsole\bin\smcwebserver restart
以 PDF 格式下载本书 (1108 KB)