VMWARE VREALIZE END POINT OPERATIONS FOR
IBM WebSphere User Guide
TABLE OF CONTENTS 1. Product Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2. Product Version Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 3. Known Issues/Limitations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 4. System Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 5. Installing End Point Operations for IBM WebSphere. . . . . . . . . . . . . . . . . . . . . . . . . . 4 5.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 5.2 Installing the End Point Operations Management Agent . . . . . . . . . . . . . 4 5.3 Uploading the Installation (.pak) file in vRealize Operations. . . . . . . . . 5 5.4 What to do next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 6. Viewing/Modifying Agent Configuration Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 6.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 6.2 Procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 6.3 What to do next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 7. IBM WebSphere End Point Agent Overview Dashboard . . . . . . . . . . . . . . . . . . . . . 8 8. Metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 9. Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 9.1 Viewing Errors in the Agent Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
NOTE: This document supports the version of each product listed, as well as all subsequent versions, until a new edition replaces it. You can find the most up-to-date technical documentation on the Blue Medora support site at: http://support.bluemedora.com. The Blue Medora website also provides the latest product updates. If you have comments about this documentation, submit your feedback to:
[email protected]. 2
Blue Medora VMware vRealize End Point Operations for IBM WebSphere
1. Product Overview Blue Medora VMware vRealize End Point Operations for IBM WebSphere collects performance data from IBM WebSphere database resources and makes it available within VMware vRealize Operations (vROps).
2. Product Version Information VERSION
RELEASE DATE
DESCRIPTION
6.3.1010008
March 16, 2017
Initial release by Blue Medora
3. Known Issues/Limitations None at this time.
4. System Requirements Before installing the End Point operations for IBM WebSphere, ensure your system meets the following requirements: Table 1: System Requirements
3
Operating System (OS)
• Windows • Linux
vRealize Operations (vRops)
vRealize Operations v6.3+
IBM WebSphere
IBM WebSphere 7.0, 8.5, and 9.0
Blue Medora VMware vRealize End Point Operations for IBM WebSphere
5. Installing End Point Operations for IBM WebSphere To successfully install End Point Operations for IBM WebSphere, you must first install the End Point Operations Management agent on your WebSphere host machines, then upload the EP Ops for IBM WebSphere installation file in vRealize Operations. 5.1 Prerequisites Obtain the End Point Operations for IBM WebSphere installation (.pak) file from the VMware Solution Exchange. 5.2 Installing the End Point Operations Management Agent Install the End Point Operations Management agent on your IBM WebSphere host machines. For instructions, refer to VMware’s online help for your specific version of vRealize Operations: vROps version 6.3: End Point Operations Management Agent Installation and Deployment vROps version 6.4: End Point Operations Management Agent Installation and Deployment vROps version 6.5: End Point Operations Management Agent Installation and Deployment NOTE: When you install the End Point Operations Management agents on a distributed system, ensure that you install the agent on every machine that you would like to monitor. 5.2.1 Exception in logs after installing End Point Operations Management Agent After installing the base agent, the following exception will be present in the Management Agent logs: 08-02-2017 14:02:14,090 EST ERROR [CollectorThread] [WebSphereServerCollector] Error when retrieving metrics: Can’t connect to MBeanServer with url [service:jmx:iiop://localhost/jndi/corbaname:iiop:localhost:9100/ WsnAdminNameService#JMXConnector] and user [null]: java.io.IOException: Failed to retrieve RMIServer stub: javax.naming.ServiceUnavailableException: No initial reference returned by string_to_object(corbaname:iiop:1.0@localhost:9100/ WsnAdminNameService#) There are jars in pdk/lib/mx4j that conflict with IBM’s jars to connect to WebSphere. In order to connect, the base agent must be started without these jars in the classpath. To remove them, perform the following actions: 1. Open
/bundles//conf/wrapper.conf and remove or comment out (#) the line that reads: wrapper.java.classpath.6=../../bundles/%HQ_AGENT_BUNDLE%/pdk/lib/mx4j/*.jar NOTE: Other JMX plugins will conflict with this one, so it is recommended to install a second agent to use only the WebSphere plugin. 2. Run /bin/ep-agent.sh restart to restart the agent.
4
Blue Medora VMware vRealize End Point Operations for IBM WebSphere
5.3 Uploading the Installation (.pak) file in vRealize Operations 1. Save the .pak file in a temporary location. 2. Log in to vRealize Operations as an admin user. 3. In the left pane, select Administration, then click Solutions.
4. In the right panel, the Solutions list will be displayed.
5. Click the Add icon ( click Upload.
). In the dialog that appears, browse to the location of the saved .pak file, then
6. Read and accept the End User License Agreement (EULA) , then click Next. The upload might take several minutes to complete. Status information appears in the Installation Details text box throughout the installation process.
7. Click Finish when the installation process is complete. 5.4 What to do next After End Point Operations for IBM WebSphere has been installed, you may want to find the adapter instance for the agent created in vROps to view (and modify, if needed) the configuration settings. 5
Blue Medora VMware vRealize End Point Operations for IBM WebSphere
6. Viewing/Modifying Agent Configuration Settings After the End Point Operations for IBM WebSphere .pak file has been installed, you can view the configuration settings for the adapter instance through the Inventory Explorer. 6.1 Prerequisites Wait for vRealize Operations Manager to complete one collection cycle so that the installed agent can be discovered. 6.2 Procedure 1. In the left pane of vRealize Operations Manager, click Administration, then Inventory Explorer. 2. Click Adapter Types > EP Ops Adapter. 3. Select the applicable IBM WebSphere server, then click the Edit Object (pencil) icon. The Edit Object dialog box opens.
6
Blue Medora VMware vRealize End Point Operations for IBM WebSphere
4. Under Advanced Settings, the WebSphere host and port information are displayed. NOTE: Once the WebSphere EP Ops agent is running, any changes to Advanced Settings (e.g., port, host) require the Override agent configuration data setting to be set to True.
6.3 What to do next Your End Point Operations for IBM WebSphere agent should now start returning performance metrics for the server(s) on the configured host. Navigate to your Dashboard List and select the IBM WebSphere End Point Agent Overview dashboard.
7
Blue Medora VMware vRealize End Point Operations for IBM WebSphere
7. IBM WebSphere End Point Agent Overview Dashboard End Point Operations for IBM WebSphere includes the following out-of-the-box overview dashboard. Select a server from the IBM WebSphere Selector widget on the left to view its key performance metrics on the right.
8. Metrics The following metrics are collected by the End Point Operations solution for IBM WebSphere. Table 2: IBM WebSphere Metrics
8
RESOURCE KIND
RESOURCE ATTRIBUTE
WebSphere Server
Heap Size
WebSphere Server
Free Memory
WebSphere Server
Used Memory
WebSphere Server
Up Time
WebSphere Server
Process CPU Usage
WebSphere Server
CPU Since Last Measurement
WebSphere Server
CPU Since Server Started
WebSphere Server
Create Count
WebSphere Server
Invalidate Count
WebSphere Server
Average Life Time
WebSphere Server
Active Count
WebSphere Server
Live Count
WebSphere Server
Average Lookup Time
WebSphere Server
Request Count
WebSphere Server
Concurrent Request Count
Blue Medora VMware vRealize End Point Operations for IBM WebSphere
9. Troubleshooting 9.1 Viewing Errors in the Agent Log File You can review EP Ops agent errors in the agent.log file, which can be viewed in the vROps user interface or in an external log viewer. The log file can be found at $VCOPS_BASE/user/log/agent.log.
9
Blue Medora VMware vRealize End Point Operations for IBM WebSphere
You can find the most up-to-date technical documentation on the Blue Medora support site at: http://support.bluemedora.com. The Blue Medora website also provides the latest product updates. If you have comments about this documentation, submit your feedback to: [email protected].
Copyright © 2017 Blue Medora Inc. All rights reserved. U.S. and international copyright and intellectual property laws protect this product. Blue Medora is a registered trademark or trademark of Blue Medora in the United States and/or other jurisdictions. The IBM name (including IBM WebSphere) and logo are trademarks or registered trademarks of International Business Machines, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. Blue Medora 3225 N Evergreen Dr. NE Suite 103 Grand Rapids, MI 49525 bluemedora.com
