HPjmeter 4.
© Copyright 2005–2011 Hewlett-Packard Development Company, L.P. Legal Notices Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Table of Contents About This Document.........................................................................................................4 Intended Audience.................................................................................................................................4 Typographic Conventions......................................................................................................................4 Related Information..........................................................
About This Document This document provides updated information about product features, known problems, and workarounds for the 4.2 release of HPjmeter. Intended Audience This document is intended for application administrators and software developers responsible for installing, configuring, and monitoring Java application performance and operation.
Publishing History The document publication date and part number indicate this document's current edition. The publication date changes when a new edition is published. Document updates may be issued between editions to correct errors or document product changes. To ensure that you receive the updated or new editions, subscribe to the appropriate product support service. See your HP sales representative for details. You can find the latest version of this document online at http:// www.hp.
1 Announcement With its application and Java Virtual Machine (JVM) metrics, HPjmeter helps operators and developers work better together to find and solve application performance problems. Using HPjmeter, you can monitor the behavior of running applications and capture profiling data for analyzing the performance of Java applications. HPjmeter helps you diagnose many types of Java application problems that occur only after a product is deployed.
• • When running JDK/JRE 5.0.04 (or later versions of 5.0), capture profiling and verbosegc data with zero preparation. When running JDK/JRE 6.0.03 (or later versions of 6.0), easily attach to JVMs to monitor applications that are already running (without having to stop the application to set HPjmeter options).
2 New in This Version Various enhancements and defect fixes are included in this release. New Features and Enhancements HPjmeter 4.2 provides the following major enhancement: • When viewing an hprof file, you can use the enhanced Reference Sub-Trees by Size metric viewer to display object and primitive values for any selected node object in the tree. These values are displayed in a table on the right side of the viewer.
Table 2-1 Defect Fixes in HPjmeter 4.2 Release (continued) Defect Tracking Number New Behavior in 4.2 Behavior in 4.1 or Older Versions could encounter a ClassNotFoundException. QXCR1001104270 HPjmeter can successfully read Java heap dump files larger than 2GB. Because of a regression, HPjmeter was not able to read a Java heap dump file larger than 2GB.
3 Known Problems and Workarounds • The JVM agent may not be able to instrument and collect metrics for certain methods. Review the JVM agent log file to identify the methods that were not measured. The path to the JVM agent log file is: /var/opt/hpjmeter/log/HPjmeter.jvmagent_pid.log where pid is the process ID of the associated JVM agent.
4 Compatibility Information and Installation Requirements You can install the full software package using Software Distributor on supported HP-UX versions running on an HP 9000 or Integrity system. The depot should be installed only on a system where a JVM has already been installed. You can also install only the console on a Microsoft Windows system or on a Linux system.
Console Requirements These are the requirements for systems running the console. Table 4-2 Console Requirements Operating system and architecture The console is a pure Java application, so it should execute on any platform that supports Java. Java Java 5.x, Java 6.x, or Java 7.x Patches and updates HPjconfig can help you determine which Java patches are recommended or required for best operation of the console on HP-UX. Processor and memory • Minimum 500 MHz processor is recommended.
Uninstalling HPjmeter from HP Systems Insight Manager When uninstalling the console from HP Systems Insight Manager, do the following: 1. Remove HPjmeter files using Software Distributor (SD): $ sudo swremove HPjmeterClient $ sudo swremove HPjmeterMN 2. 3. # removes the console # removes the node agent and JVM agent Check that HP Systems Insight Manager is running.
3. Specify the JVM agent in your java command. On Java 5.0 and later: $ java -agentlib:jmeter[=options] ... On Java 1.4.2.02 or later 1.4.2 versions: $ java -Xrunjmeter[:options] ... NOTE: If you use the 64-bit JVM agent, you will need to add -d64 to the JVM command line. For example, type $ java —d64 HelloWorld when SHLIB_PATH is $JMETER_HOME/lib/$ARCH and where $ARCH equals PA_RISC2.0W or IA64W.
Example Usage Using -agentlib on Java 6.0 to run the JVM agent: $ /opt/java6/bin/java -agentlib:jmeter myapp Using -agentlib on Java 5.0 to run the JVM agent plus options to set minimum and maximum heap size: $ /opt/java1.5/bin/java -Xms256m -Xmx512m -agentlib:jmeter myapp Setting -Xbootclasspath and using -Xrunjmeter on Java 1.4 to run the JVM agent plus options to set minimum and maximum heap size: $ /opt/java1.
Starting the Console On Microsoft Windows Assuming that you used the defaults suggested by the installation wizard, you can do one of the following to launch the console. • Double-click the short-cut icon for HPjmeter on your desktop. • From the Start menu, select Program Files →HPjmeter →Console . Security Awareness Securing Communication Between the HPjmeter Node Agent and the Console IMPORTANT: The data stream between the HPjmeter console and agents is not protected from tampering by a network attacker.
NOTE: The console first attempts to use a port between 9505 and 9515 when arranging a port for its server socket. If it is unable to successfully use a port from this range, it will use an ephemeral port number. IMPORTANT: If you choose to open a port through a firewall to enable communication between a node agent and a console, secure the tunneling port using HP-UX Secure Shell or HP-UX IPSec.
hpjmeter_console_4.2.00.00_*_setup[.exe|.sh] -is:javahome (On Windows, the might be C:\Program Files\jre6.) 2. Generate a log file from the installer: hpjmeter_console_4.2.00.00_*_setup[.exe|.sh] -is:log 3. View the Java console: hpjmeter_console_4.2.00.00_*_setup[.exe|.
5 Support for users Documentation and Support You can find printable PDF versions of the HPjmeter user's guide and the release notes in the installation directory within the doc subdirectory. The latest documentation is also made available at http://www.hp.com/go/hpux-hpjmeter-docs. Problem resolution is available from HP Response Centers worldwide all day every day as part of operating system support contracts. For regional HP Response Center phone numbers, please contact your local HP sales office.
Glossary of Acronyms and Abbreviations CPU Central Processing Unit dynamic attach In HPjmeter, the ability to find and connect to a running JVM on a machine that has the HPjmeter node agent running, but the JVM was started without using HPjmeter options. ephemeral port number a temporary port number assigned from a range of numbers designated for this purpose.
Index Symbols -d64 64-bit JVM agent, 14 A agents requirements, 11 alerts about, 6 application configuring to use JVM agent, 13 C command-line options -d64, 14 compatibility, 11 configure agent library location, 13 JVM agent, 13 configuring library paths, 13 console installing on Linux, 15 installing on Microsoft Windows, 15 launching from HP Systems Insight Manager, 15 requirements, 12 starting from command line on HP-UX, 15 starting on Linux, 15 starting on Microsoft Windows, 16 D data confirming integr
run_simple_jvmagent script, 17 S scripts hpjmeter, 17 run_simple_jvmagent, 17 setup_jvmagent_environment, 17 security, 16 setup_jvmagent_environment script, 17 shared library path Itanium-based systems, 13 SHLIB_PATH configure, 13 support obtaining, 19 T troubleshooting documentation, 19 obtaining support, 19 U user access configuring, 17 X Xbootclasspath configure, 13 22 Index
