User Guide

Introduction

What's In the User Guide?

Information About JRockit Compatibility

Finding Additional Information

Starting and Configuring BEA JRockit JVM

Before Starting BEA JRockit

Starting BEA JRockit

Sample Start-up Command

Configuring BEA JRockit

Using Standard Options

Setting the JVM Type

Setting General Information

Providing Information to the User

Using Non-standard Options

Setting Behavioral Options

Displaying Logging Information

Including a Timestamp with Logging Information

Protecting Systems by Using the Security Manager

Preventing BEA JRockit JVM (When Run as a Service) from Shutting Down After Receiving a Logoff Event

Special Instructions for Linux Users

Enabling Core Dumps on Red Hat AS

Overriding NPTL

Using the BEA JRockit Memory Management System

The Mark-and-Sweep Collection Model

Garbage Collector Permutations

Generational

Single-spaced

Concurrent

Parallel

Running the Dynamic Garbage Collector

Using Static Garbage Collection Methods

Using Backward-compatible Garbage Collectors

Pros and Cons

Garbage Collector Selection Matrix

Setting the Default Garbage Collector

Overriding Garbage Collectors

Viewing Garbage Collection Activity

Thread-local Allocation

Using the BEA JRockit Management Console

Console Overhead

Starting the Console

Enable the Management Server

Attaching a Management Client

Start the JRockit Management Console

Starting the Management Server with a Security Manager

Set the Port

Change the Number of Connections

Parts of the Console

Setting Up the Console

Making Connections

Creating a New Folder

Creating a New Connection

Connecting a Connection to BEA JRockit JVM

Disconnecting a Connection from BEA JRockit JVM

Renaming a Connection or Folder

Removing a Connection or Folder

Hiding Disconnected Connections

Enabling Console Settings

Setting the Operation Mode

Setting Other Preferences

Customizing the Display

Using the Settings File

Using the Console

Information Tabs

Overview Tab

Memory Tab

Processor Tab

System Tab

Notification Tab

View Historical Data

Using Advanced Features of the Console

View Thread Stack Dump

Method Profiling Tab

Exception Counting Tab

Creating a JRA Recording

Closing the Console

Starting and Running the Console in the Headless Mode

Running a Headless Management Console

Controlling the Console with Command-line Options

Using the BEA JRockit Memory Leak Detector

Starting the Memory Leak Detector

Using the Memory Leak Detector

Overview of the Memory Leak Detection Process

Getting Started

Memory Leak Detection

An Example of How to Find a Real Memory Leak

Help Us Improve BEA JRockit

How will BEA Systems Use This Feedback

BEA JRockit Support for the Memory Leak Detector

Frequently Asked Questions

Does BEA Systems Guarantee the Accuracy of this tool's output?

Does the Memory Leak Detector Cause Any Overhead?

What Kind of Support is Available for the Memory Leak Detector?

Is There a Forum Where I can Discuss the Memory Leak Detector?

Known Issues

Code Caching with BEA JRockit

Why Is Code Caching Helpful?

What is the Cache?

How to Use Code Caching

Enabling Code Caching

Specifying a Cache Name

Code Caching in the Read/Write Mode

Code Caching in the Read-only Mode

Other Code Caching Arguments

Using Code Caching to Improve Performance

Setting the Verbosity Level

Enabling Code Caching by Using an Environment Variable

How Code Caching Works

What Happens When Code Caching Runs

Dealing with Code Changes

Dealing with Cache Cleanup

Removing Obsolete Methods

Cache File Validity

Error Recovery

Cleaning Up the Cache

Using BEA JRockit JVM with Other WebLogic Applications

Using BEA JRockit JVM with BEA WebLogic Server

Certified Versions

Verifying that BEA JRockit is Your JVM

Starting JRockit from the Node Manager

Enabling the Management Server from the Node Manager

Setting Options by Using the Node Manager

Tuning BEA JRockit for WebLogic Server

Monitoring BEA JRockit JVM from WebLogic Server

Switching to BEA JRockit JVM in WebLogic Server

Switching VMs When WebLogic Server is Running as a Service

Configuring JRockit for BEA WebLogic Workshop

Using Web Start with BEA JRockit

What You Can Do with Web Start

Web Start Security

Installing and Launching Web Start

Windows Implementations

Linux Implementations

Comprehensive Web Start Documentation

Adding Custom Notification Actions and Constraints

Locating consolesettings.xml

Creating a Custom Action

Creating and Implementing an Action: Example

Create the Action (Step 2)

Implementing handleNotificationEvent() (Step 3)

Creating the Action Editor (Step 4)

Implementing the Abstract Methods (Step 5)

Adding the New Action to the Deployment Entries (Step 6)

Displaying the New Action Editor (Steps 7 and 8)

Creating a Custom Constraint

Using the Java Plugin

Supported Operating Systems and Browsers

Installing the Plugin

Note on Installing the BEA JRockit Plugin and Sun Plugin

Implementing the Plugin

Plugin Reference

Tracing Thread Activity With Stack Dumps

Monitoring Information in Stack Dumps

Detecting Deadlocks

What is a "Lock Chain"?

Lock Chain Types

Open Chains

Deadlock Chains

Closed Chains