Contact Us Contact Us

HPjmeter Downloads and Documentation

  Software Depot
Electronic download
Frequently asked questions

» HP-UX Java Home

Use HPjmeter to do the following tasks:

  • Identify and diagnose performance problems in Java™ applications running on HP-UX or on NonStop servers
  • Improve garbage collection performance
  • Analyze Java heap dumps
  • Monitor live Java applications and analyze profiling data
  • Capture extended profiling data with zero preparation when using JDK/JRE 5.0.04 or later
  • Capture detailed garbage collection data with zero preparation when using JDK/JRE 5.0.14 or later or JDK/JRE 6.0.02 or later or JDK/JRE 7.0.00 or later
  • Run the HPjmeter console on HP-UX, Linux, and Windows® systems

HPjmeter features the following functionality:

  • Automatic problem detection and alerts:
    • Memory leak detection alerts for Java collection classes and for arrays
    • Thread deadlock detection
    • Abnormal thread termination detection
    • Expected out of memory error
    • Excessive method compilation
    • System and process CPU utilization thresholds
    • Heap usage thresholds
    • Garbage collection duration
    • Finalizer queue length
  • Dynamic real-time display of application behavior:
    • Java heap size
    • Garbage collection events and percentage time spent in garbage collection
    • CPU usage per method for hottest methods
    • Object allocation percentage by method and by object type
    • Method compilation count in the JVM dynamic compiler
    • Number of classes loaded by the JVM and activity in class loaders
    • Thrown exception statistics
    • Multi-application, multi-node monitoring from a single console
    • Applications are ready to monitor: At application start, no HPjmeter options are required to monitor the application (with Java 6.0.03 or later)
  • Drill down into application profile metrics:
    • Graphic display of profiling data
    • Call graphs with call count, or with CPU or clock time
    • Per-thread display of time spent in nine different states
    • Per-thread or per-process display
    • Reference trees for heap analysis
  • Integrated, in-depth garbage collection analysis:
    • Easy-to-access graphic display of resource utilization by the garbage collector, including visual presentation of the impact of the garbage collector on application performance
    • User-configurable graphs for flexibly presenting the collected GC data in alternate relationships
    • Graphic display of garbage collection behavior that provides insight into thread activity and memory allocation
    • Simple collection of HP GlancePlus data, which can be viewed together with garbage collection data for easy correlation


New in the 4.3 Release

The following new features have been added to HPjmeter 4.3:

  • A minimum of Java 6 is required to run the HPjmeter console.
  • HPjmeter provides a shell script (/opt/hpjmeter/bin/hpjmeter) to easily start the HPjmeter console. In version 4.3, the default Java heap size is increased to 512 MB on Microsoft Windows and 1 GB on UNIX systems. Previously, the default heap size was 256MB. You can continue to specify a different size for the Java heap by passing the size as an argument when running the script, for example: /opt/hpjmeter/bin/hpjmeter -Xmx2g
  • Starting HP JDK/JRE 7.0.04, the -Xverbosegc option supports the G1 garbage collector. HPjmeter 4.3 supports viewing both the -Xverbosegc and -Xloggc output that contain G1 specific fields.
  • Enhanced zero preparation profiling (-Xeprof) is a feature of the HP JDK/JRE 7.0.04. Profiling can now be started from the HPjmeter console while performing real-time monitoring of a running Java application. Further details can be found at 'Collecting Profile Data' in chapter 5 of the HPjmeter 4.3 User's Guide.
  • The new Network/Sockets visualizers display the rate of incoming and outgoing data and socket connections being communicated over the network to and from the monitored application over time. Further details can be found at 'Monitor Network/Sockets Menu' in Chapter 8 of the HPjmeter 4.3 User's Guide.
  • In the Heap Monitor visualizer, the maximum committed Java heap space, shown on the visualizer as committed space, is now displayed in addition to the maximum occupied heap space. Note that the committed space is not the same as the maximum possible heap (-Xmx value). The display of the committed space can be toggled on and off using the View menu.
  • Four new visualizers, Process Resident Memory, Process Virtual Memory, Data Region Resident Memory, and Data Region Virtual Memory, within the Memory/Heap Monitor are introduced in HPjmeter 4.3 release.
  • The new System Call Rate visualizer within the JVM/System Menu Monitor displays the rate of a set of HP-UX system calls over time.
  • Additional command line options for the HPjmeter agent are introduced, which can disable specific metrics. Further details can be found at 'JVM Agent Options' in chapter 2 of the HPjmeter 4.3 User's Guide.

    For specific features in the newest release of HPjmeter, see the HPjmeter 4.3 Release Notes and Installation Guide, under "Getting started" on the HP Support Center (HPSC) at

    For the latest HPjmeter details, including monitoring and profiling options to use for desired metrics, see the HPjmeter 4.3 User's Guide, under 'User guide' on the HPSC.


    HPjmeter on NonStop

    HPjmeter 4.3 is supported on NonStop, and is available for download from Scout.

    For instructions on installing the HPjmeter 4.3 agent (SPR T0866H31^AAD) on NonStop servers, please refer to the T0866H31^AAD Softdoc, available from Scout.

    For information specific to running the HPjmeter agents on NonStop servers, in addition to the HPjmeter 4.3 User's Guide, refer to the NonStop Server for Java 7.0 Programmer's Reference manual (693949), available at the following website:

    Click HP Integrity NonStop H-Series or J-Series, and then do find-on-page for the aforementioned book title.



    Note that the download link below points to a page that provides the following download packages:

    • HPjmeter console and agent components, for installation on HP-UX using Software Distributor (SD)
    • HPjmeter console with web-start support for use with HP Systems Insight Manager — for installation on HP-UX using SD
    • HPjmeter console only, for installation on Microsoft Windows XP/Vista/7
    • HPjmeter console only, for installation on Linux

    HPjmeter Downloads:

    » Version — March 2013

    For instructions on installing HPjmeter on HP-UX using SD, please see the installation chapter of the HPjmeter 4.3 Release Notes and Installation Guide



    » HPjmeter 4.3 Release Notes and Installation Guide (under "Getting started")
    » HPjmeter 4.3 User's Guide (under "User guide")
    » T0866H31^AAD Softdoc - available from Scout.
    » NonStop Server for Java 7.0 Programmer's Reference manual (693949) available at the following website:   Click HP Integrity NonStop H-Series or J-Series, and then do find-on-page for the book title.
    » Support for Your Product


    1. The HPjmeter console is not supported on Windows 8.

    2. Using the -Xeprof switch on HP-UX 11.31

    For best results when using the -Xeprof switch on HP-UX 11.31 on Integrity systems, you should run Java 5.0.14 or later, or 6.0.02 or later or 7.0.00 or later, because the thread timing data generated by earlier releases of Java can be inaccurate on 11.31.

    How to tell when the thread timing data is off:   Because Java can generate an eprof data file with no errors or other indication of a problem in this situation, you may not know the file is inaccurate until you try to open it with HPjmeter.   Then, HPjmeter will either refuse to load the file, or it will load the file, but display unusual results.

    If HPjmeter refuses to load the file, it will display an error message such as
    Number format error at line NNN. Cannot continue.

    If HPjmeter does load the file, you will see unexpected and inaccurate results in the metric displays.   The unexpected results can be seen most easily by examining the Threads Histogram.   If you see many threads spending all their time in an unexpected state, such as "Unknown" or "Lock Contention", then you are experiencing the problem with inaccurate data.   Update your Java installation to one of the versions mentioned above to correct the problem.

    Related Information
    » Java SE 7 Platform at a Glance
    » Java SE 6 Platform at a Glance
    » J2SE 5.0 Platform at a Glance
    » J2SE 1.4.2 Platform at a Glance
    » Programmer's Guide for Java 2
    » HP-UX Java Technical Documentation
    » Patches Information
    » Java Out-of-Box Tool
    » HP-UX Java FAQ
    » Java Troubleshooting Guide for HP-UX Systems

    Java™ and all Java based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates in the United States and other countries. Java compatible logo