HP OpenView JMX Metric Builder

Release Notes

April 2005

This document provides an overview of the JMX Metric Builder (JMB). It contains important information not included in the manuals or in online help.

In This Version
Installation Notes
Known Problems, Limitations, and Workarounds
Support
Legal Notices

In This Version

This initial release of the JMB provides a GUI for creating and editing JMX metrics for the HP OpenView Smart Plug-in for BEA WebLogic Server (WLS-SPI) and HP OpenView Smart Plug-in for WebSphere Application Server (WBS-SPI).

Installation Notes

Before you can use the JMB and create user defined metrics, you must install the following:

The WBS-SPI or WLS-SPI
The JMX Metric Builder (JMB) software
The JMX connector if you are using a JMX-compliant MBean server that is not part of the WebLogic or WebSphere application server (such as Tomcat or JBoss).

NOTE: You must also configure your MBean server environment before you can use the JMB and create UDMs. Refer to the JMX Metric Builder online help, Configuring the MBean server environment topic for more information.

Requirements for

Built-in MBean Server JMX-compliant MBean Server

Install and Configure SPI X X

Install JMB Software X X
Install JMX Connector X

	Requirements for
	Built-in MBean Server	JMX-compliant MBean Server
Install and Configure SPI	X	X
Install JMB Software	X	X
Install JMX Connector		X

Built-in MBean server requirements: If you are using the MBean server that is built into the WebLogic or WebSphere application server, you must install and configure the WBS-SPI/WLS-SPI software and the JMB software.

JMX-compliant MBean server requirements: If you are using a JMX-compliant MBean server that is not part of the WebLogic or WebSphere application server (such as Tomcat or JBoss), you must install the WBS-SPI/WLS-SPI software (in order to collect MBean data), JMB software, and JMX connector.

Installing and configuring the WBS-SPI or WLS-SPI

NOTE: You can install the SPI software and the JMB software at the same time.

For more information about installing and configuring the SPIs, refer to the HP OpenView Smart Plug-in for WebSphere Application Server Configuration Guide (WebSphere_AppServer_Config.pdf) or the HP OpenView Smart Plug-in for BEA WebLogic Server Configuration Guide (WebSphere_AppServer_Config.pdf) located in the \Documentation\SPI Guides\ directory on the HP OpenView Smart Plug-ins CD.

Installing the JMB software

NOTE: You can install the SPI software and the JMB software at the same time.

To install the JMB software, do the following:

Insert the HP OpenView Smart Plug-ins CD into the CD drive of the management server. The HP OpenView Operations InstallShield Wizard starts.
From the first screen, select Next.
In the Program Maintenance window, select Install products.
In the Product Selection window, select the check box next to JMX Metric Builder and select Next.
Complete the installation by following the instructions in the windows that display.

The JMB software includes the following:

Item Description Location

Tools Deploy UDM Deploys the UDM file from the management server to the selected managed node(s) JMX Metric Builder/WBSSPI
or
JMX Metric Builder/WLSSPI tool group

Gather MBean Data Gathers MBean information from the selected managed node(s)

JMX Metric Builder Launches the JMB

UDM Graph Enable/Disable Starts/Stops data collection for UDM graphs

Archive Packages RMI_ConnectorPkg.tar RMI_ConnectorPkg.zip JMX connector archive packages <OvOWShareInstallDir>\SPI-Share\wasspi\wbs\jmx\
or
<OvOWShareInstallDir>\SPI-Share\wasspi\wls\jmx\

Item	Description	Location
Tools	Deploy UDM	Deploys the UDM file from the management server to the selected managed node(s)	JMX Metric Builder/WBSSPI or JMX Metric Builder/WLSSPI tool group
Gather MBean Data	Gathers MBean information from the selected managed node(s)
JMX Metric Builder	Launches the JMB
UDM Graph Enable/Disable	Starts/Stops data collection for UDM graphs
Archive Packages	`RMI_ConnectorPkg.tar RMI_ConnectorPkg.zip`	JMX connector archive packages	`<OvOWShareInstallDir>\SPI-Share\wasspi\wbs\jmx\` or `<OvOWShareInstallDir>\SPI-Share\wasspi\wls\jmx\`

where <OvOWShareInstallDir> is the value of the registry key HKEY_LOCAL_MACHINE\\SOFTWARE\\Hewlett-Packard\\HP OpenView\\OvOWShareInstallDir.

The registry key could be: <drive>:\Program Files\HP OpenView\Data\shared\.

Installing the JMX connector

NOTE: If you are using MBeans registered with the WebLogic or WebSphere MBean server, you do not need to install and configure the JMX connector. The WLS-SPI/WBS-SPI provides this functionality.

The JMX connector allows access to MBeans registered in other non-WebLogic or non-WebSphere MBean servers.

In order to use the JMX connector, you should be familiar with the following topics:

the standard MBeanServer interface
MBean registration
m-let service
JAAS (Java Authentication and Authorization Service)

NOTE: JAAS is applicable if MBean server access requires authentication and/or authorization.

The instructions that follow are for the WLS-SPI. If you are installing the WBS-SPI, replace any occurrence of "WLSSPI" with "WBSSPI" and "wls" with "wbs."

The JMX Connector archive packages are installed with the JMB software. Copy one of the following archive packages to all source and target servers:
<OvOWShareInstallDir>\SPI-Share\wasspi\wls\jmx\RMI_ConnectorPkg.tar (UNIX)
<OvOWShareInstallDir>\SPI-Share\wasspi\wls\jmx\RMI_ConnectorPkg.zip (Windows)
where <OvOWShareInstallDir> is the value of the registry key HKEY_LOCAL_MACHINE\\SOFTWARE\\Hewlett-Packard\\HP OpenView\\OvOWShareInstallDir.
The registry key could be: <drive>:\Program Files\HP OpenView\Data\shared\.
On each server, extract the files from the archive package. The files do not have to be placed in any specific directory.
The following files are extracted from the archive package.
- JMX_RMI_Connector.jar - The JMX connector.
- JMXRMIConnectorConfig - Example JMX connector configuration file.
- OVRMIConnectorMBean.mlet - Example m-let file.
- OVRMIConnectorTrace.tcf - Trace configuration file.

For information about configuring the JMX connector, refer to the JMX Metric Builder online help, Configuring the MBean server environment topic.

Software Requirements

The JMB works with and requires either one or both of the WBS-SPI and the WLS-SPI, which must be installed and configured.

The JMB runs on the OpenView Operations management server and from any remote console system on which the OVO console is installed. Only one console can be run at a time.

Known Problems, Limitations, and Workarounds

Gather Metadata tool takes a long time to complete.

	Problem:	When running the Gather Metadata tool on Windows managed nodes, it may take up to 30 minutes (for each node) to complete.
	Workaround 1:	Run the Gather Metadata tool on UNIX nodes only.
	Workaround 2:	Manually collect the metadata for each managed node and ftp the metadata file to the OVO management server: From the OVO management server system, open a DOS prompt window. Go to the agent instrumentation directory. For example, type cd "C:\Program Files\HP OpenView\Installed Packages\{790...}\bin\instrumentation" Enter the following command to collect the metadata: WBS-SPI: wasspi_wbs_perl -S wasspi_wbs_ca -r -x metadata=on -i <managed_node> WLS-SPI: wasspi_wls_perl -S wasspi_wls_ca -r -x metadata=on -i <managed_node> A message similar to the following appears: `Mbeaninfo for server "<managed_node>" written to <OvAgentDir>\wasspi\wls\tmp\<managed_node>.xml` This file is saved on the specified managed node. From the managed node, ftp the `<OvAgentDir>\wasspi\wbs\tmp\<managed_node>.xml` or `<OvAgentDir>\wasspi\wls\tmp\<managed_node>.xml` file to the management server in the `<OvOWShareInstallDir>\SPI-Share\jmb\wbs\` or `<OvOWShareInstallDir>\SPI-Share\jmb\wls\` directory where `<OvOWShareInstallDir>` is the value of the registry key HKEY_LOCAL_MACHINE\\SOFTWARE\\Hewlett-Packard\\HP OpenView\\OvOWShareInstallDir. The registry key could be: `<drive>:\Program Files\HP OpenView\Data\shared`.

The JMB cannot read a UDM file.

Problem: QXCR1000202519: The JMB cannot read a UDM file that is broken, even if the problem with the file has been corrected.

Workaround:

	Problem:	QXCR1000202519: The JMB cannot read a UDM file that is broken, even if the problem with the file has been corrected.
	Workaround:	Exit the JMB, correct or remove the errant file, and restart the JMB. The UDM files are stored in one of the following directories: `<OvOWShareInstallDir>/SPI-Share\wasspi\wbs\conf\workspace\UDMProject\` or `<OvOWShareInstallDir>/SPI-Share\wasspi\wls\conf\workspace\UDMProject\` where `<OvOWShareInstallDir>` is the value of the registry key HKEY_LOCAL_MACHINE\\SOFTWARE\\Hewlett-Packard\\HP OpenView\\OvOWShareInstallDir. The registry key could be: `<drive>:\Program Files\HP OpenView\Data\shared\`.

Exit the JMB, correct or remove the errant file, and restart the JMB. The UDM files are stored in one of the following directories:

<OvOWShareInstallDir>/SPI-Share\wasspi\wbs\conf\workspace\UDMProject\ or
<OvOWShareInstallDir>/SPI-Share\wasspi\wls\conf\workspace\UDMProject\

where <OvOWShareInstallDir> is the value of the registry key HKEY_LOCAL_MACHINE\\SOFTWARE\\Hewlett-Packard\\HP OpenView\\OvOWShareInstallDir. The registry key could be: <drive>:\Program Files\HP OpenView\Data\shared\.

The JMB cannot read a corrupted MBean data file.

	Problem:	The JMB cannot read an MBean data file that is corrupted.
	Workaround:	Recreate the MBean data file: Exit the JMB. Run the Gather tool.

Cannot run more than one instance of the JMB.

	Problem:	No more than one instance of the JMB can be started at any time.
	Workaround:	Run only one instance of the JMB at a time.

Support

Please visit the HP OpenView web site at: http://www.managementsoftware.hp.com/

This web site provides contact information and details about the products, services, and support that HP OpenView offers.

You can also go directly to the support web site at:

http://support.openview.hp.com/

HP OpenView online software support provides customer self-solve capabilities. It provides a fast and efficient way to access interactive technical support tools needed to manage your business. As a valuable support customer, you can benefit by being able to:

Search for knowledge documents of interest
Submit and track progress on support cases
Manage a support contract
Look up HP support contacts
Review information about available services
Enter discussions with other software customers
Research and register for software training

NOTE: Most of the support areas require that you register as an HP Passport user and log in. Many also require an active support contract. To find more information about support access levels, go to the following URL:

http://support.openview.hp.com/access_level.jsp

To register for an HP Passport ID, go to the following URL:

https://passport2.hp.com/hpp/newuser.do

To view release notes and other documentation:

Click using hp software--> product manuals.

The product manuals search window opens. It is located at:
http://ovweb.external.hp.com/lpe/doc_serv/
In the select product list, click [product name].
In the select version list, click [version number].
In the OS list, click [OS type].
To start the search, click Open or Download.

NOTE: To view files in PDF format (*.pdf), Adobe Acrobat Reader must be installed on your system. To download Adobe Acrobat Reader, go to the following URL:

http://www.adobe.com

Legal Notices

The information contained herein is subject to change without notice.

The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.