Skip navigation.
Downloads | Product Documentation | Support

User Guide

# Setting up the BEA JRockit Management Console

Before you start running and using the Management Console, it is a good idea to set up the different connections for the JVMs you want to view. The Management Console is best run remotely on a computer connected to the management server. That way the console is the least intrusive on the JRockit that is running in your system.

Configuring—or "setting up"—the Management Console includes these tasks:

- Managing Connections—deciding which connections to make.
- Enabling Console Settings—various settings about the console.

# Managing Connections

The connection browser (Figure 4-2) displays a collection of saved connections to BEA JRockit JVMs organized in folders. If necessary, you can add your own folders and connection nodes to the tree structure.

### Creating a New Connection

1. Select the folder in which the connection should be placed
2. Click Connection > New Connection.

The Add new connection dialog box (Figure 5-1) appears:

Figure 5-1 Add New Connection Dialog Box

3. Type in a name of the server, the port (the port number of the enabled JMX server), and the new connection in the appropriate text fields or retain the default values.
4. Type in a user name for the connection and a password. If you want to store the password in the settings file, select the store option (the password is stored unencrypted).
5. Type in a connection name.
6. Select or deselect Connect now depending on if you want to monitor your JRockit VM at once or not.
7. Click Add.

The connection will now appear in the Connections folder.

### Creating a New Folder

1. Select the existing Connections folder.
2. Click Connection > New Folder.

The new folder appears in the connection browser (Figure 5-2).

Figure 5-2 New Folders

3. Select the new folder once to activate the folder, then click again to highlight the name.
4. Type in a name for the folder and press Enter.

### Connecting to BEA JRockit

1. From your list of connections, select the BEA JRockit JVM connection you wish to activate.

To connect an entire folder, select the folder.

2. Click Connection > Connect.

When the connection is made, the status bar will read "Connected" and activity on the console will commence.

### Disconnecting from BEA JRockit

1. From your list of connections, select the BEA JRockit JVM connection you want to disconnect.

To disconnect an entire folder, select the folder.

2. Click Connection > Disconnect.

The connection will be lost and the status bar will indicate that you've been disconnected.

### Renaming a Connection or Folder

1. Select the BEA JRockit JVM connection or folder to rename.
2. Click once more to change the name.
3. Type in a new name and press Enter.

### Removing a Connection or Folder

1. Select the connection subfolder you want to remove.
2. Click Connection > Remove.

The selected connection disappears from the connection browser.

### Hiding Disconnected Connections

Sometimes you only want to display information about the active BEA JRockit JVM connections. To hide information about disconnected connections:

- Click the Hide Disconnected button on the toolbar.

To show the information about disconnected connections again, simply deselect Hide Disconnected in same way that you made the selection.

Note: If you have one connection only, it will be visible at all times.

### About the Ignore List

In the Ignore List you hide those connections that you do not want to access. See

# Enabling Console Settings

The Management Console has different preferences that can be set. These preferences are grouped into the following main groups: General, Persistence, and Communication (see Figure 5-3). The Communication preference is only visible in developer mode.

This section is divided into the following subsections:

- Mode of Operation
- Graphics and E-mail Settings
- Persistence Directory
- Communication Settings

## Opening the Preferences Window

- Click Tools > Preferences.

The Preferences dialog box (Figure 5-3) appears.

Figure 5-3 Preferences Window

## Mode of Operation

The Management Console can be run in two different operating modes depending on the type of information you want to access:

- Developer Mode: This is the default mode and provides more features (compared to the Administrator mode) such as a rudimentary method profiler and exception count functionality. Additional tabs are also available: the Method Profiler tab and the Exception Count tab.
- Administrator Mode: This mode is designed for system administrators who are mostly interested in observing the state of the BEA JRockit JVM.

## Graphics and E-mail Settings

In addition to setting the operation mode, you use General Preferences to change the following:

- Turn off the anti-aliasing setting. This is good if you are running the Management Console on a Linux system. Using anti-aliasing over a remote X connection over Linux slows down the GUI considerably.
- Change the default e-mail settings for the notification system, for example, the system sends an e-mail to this address when a certain heap size is reached.

## Persistence Directory

The persistence directory is where the Management Console saves the persisted values of attributes (in the attribute subscription log). Values that are saved are, for example, any changes that you make to MBeans, i.e., name changes or such. The attribute subscription logs are saved upon exiting the Management Console. If there, for some reason, arises problems with the logs, you can clear the logs by deleting them and then have the Management Console create a new one for you (see Clearing All Attribute Subscription Logs).

### Setting the Persistence Directory

1. Click Tools > Preferences.
2. Select the Persistence option.
3. Click Choose to find another location for the attribute subscription logs.
4. Click Yes when you are asked to disconnect JRockit connections.
5. Select a location for the files.

The default location for the files are `<User_Home>\.ManagementConsole\data\`.

6. Click Open.

Every time you exit the Management Console, a new aspect value log is saved in the specified directory. It i not recommended to change these logs by hand.

7. Close the Preferences window.

### Clearing All Attribute Subscription Logs

1. Click Tools > Preferences.
2. Select the Persistence option.
3. Click Clear all attribute subscription logs.
4. Click Yes when you are asked to disconnect JRockit connections.
5. Close the Preferences window.

Note: If you delete all persistence logs by clicking this button, you will also delete any other files stored in the `<User_Home>\.ManagementConsole\data\`.

## Communication Settings

The possibility to change communication settings is on if you have set the Management Console to Developer mode (see Mode of Operation). The available communication settings are:

- Socket timeout
- Reply timeout
- Core update interval

Use precaution when changing these values.

# Console Settings File

For the Management Console to remember your specific settings, for example, your connections, it automatically creates a settings file when you exit. This file is called `consolesettings.xml` and is located in the folder:

>     <user home directory>\.ManagementConsole

The exact path to the user home directory will vary on different platforms. On Windows it is usually something like `\Documents and Settings\<username>`, for example:

`C:\Documents and Settings\<username>\.ManagementConsole`

If you do not currently see such a file in the above directory, one has probably not been created yet. As soon as you exit the Management Console one is created.

Warning: Do not edit the settings file by hand! Doing so may cause the Management Console to crash on startup.

If you are experiencing problems with the settings file, you can always delete it and let the Management Console create a new one for you.

## Locating consolesettings.xml

The `consolesettings.xml` file is located in your home directory, under the `\ManagementConsole` folder. If you are using Windows, the path should be:

>     C:\Documents and Settings\<user_name>\ManagementConsole

(where <user_name> is the user name under which you are running the Management Console)

If you are using Linux, the path will normally be:

>     /home/<user_name>/ManagementConsole

(where <user_name> is the user name under which you are running Management Console)