HPjmeter 4.2 User's Guide

Table of Contents
About This Document.......................................................................................................10
Intended Audience................................................................................................................................10
Typographic Conventions.....................................................................................................................10
Additional HPjmeter Documents.........................................................................................................10
Related Information..............................................................................................................................10
Publishing History................................................................................................................................11
HP Encourages Your Comments..........................................................................................................11
1 Introducing HPjmeter 4.2.00.00 ...............................................................................12
Features.................................................................................................................................................12
Concepts................................................................................................................................................13
JVM Agent.......................................................................................................................................13
Node Agent.....................................................................................................................................13
2 Completing Installation of HPjmeter .........................................................................14
Platform Support and System Requirements.......................................................................................14
Agent Requirements........................................................................................................................14
Console Requirements.....................................................................................................................14
Completing the installation..................................................................................................................15
File Locations........................................................................................................................................15
Attaching to the JVM Agent of a Running Application.......................................................................15
Configuring your Application to Use HPjmeter Command Line Options..........................................15
Preparing to run Java.......................................................................................................................15
Example Usage...........................................................................................................................16
JVM Agent Options.........................................................................................................................17
Showing Version Information....................................................................................................17
Selecting Other JVM Agent Options..........................................................................................17
JVM Options Usage Examples...................................................................................................21
Security Awareness...............................................................................................................................21
Securing Communication Between the HPjmeter Node Agent and the Console...........................21
Ensuring the Integrity of HPjmeter Console/Node Agent Data Transfer..................................21
Protecting Data Confidentiality During HPjmeter Console/Node Agent Communication......21
Working with Firewalls .............................................................................................................21
Configuring User Access............................................................................................................22
Securing Communication Between the JVM and the HPjmeter Node Agent ................................22
3 Getting Started ............................................................................................................23
Are You Monitoring an Application or Analyzing Collected Data?....................................................23
Using HPjmeter to Monitor Applications.............................................................................................23
Configure and Start Your Application............................................................................................23
Confirm that the Node Agent is Running.......................................................................................23
Start the Console..............................................................................................................................23
Connect to the Node Agent from the Console................................................................................23
Set Session Preferences....................................................................................................................26
Changing Session Preferences During a Session.............................................................................29
View Monitoring Metrics During Your Open Session....................................................................29
Using HPjmeter to Analyze Profiling Data..........................................................................................29
Using HPjmeter to Analyze Garbage Collection Data.........................................................................31
Monitoring Demonstration Instructions...............................................................................................32
Memory Leak Applications.............................................................................................................33
Thread Deadlock Sample.................................................................................................................34
Table of Contents 3