Appendix B. Connecting with JConsole

download PDF

B.1. Connect to JDG via JConsole

JConsole is a JMX GUI that allows a user to connect to a JVM, either local or remote, to monitor the JVM, its MBeans, and execute operations.

Procedure B.1. Add Management User to JBoss Data Grid

Before being able to connect to a remote JBoss Data Grid instance a user will need to be created; to add a user execute the following steps on the remote instance.
  1. Navigate to the bin directory
    cd $JDG_HOME/bin
  2. Execute the script.
  3. Accept the default option of ManagementUser by pressing return.
  4. Accept the default option of ManagementRealm by pressing return.
  5. Enter the desired username. In this example jmxadmin will be used.
  6. Enter and confirm the password.
  7. Accept the default option of no groups by pressing return.
  8. Confirm that the desired user will be added to the ManagementRealm by entering yes.
  9. Enter no as this user will not be used for connections between processes.
  10. The following image shows an example execution run.
    Example execution on JBoss Data Grid

    Figure B.1. Execution of

Binding the Management Interface

By default JBoss Data Grid will start with the management interface binding to In order to connect remotely this interface must be bound to an IP address that is visible by the network. Either of the following options will correct this:

  • Option 1: Runtime - By adjusting the property on startup a new IP address can be specified. In the following example JBoss Data Grid is starting with this bound to
    ./ ...
  • Option 2: Configuration - Adjust the in the configuration file. This is found in the interfaces subsystem. A snippet of the configuration file, with the IP adjusted to, is provided below:
        <interface name="management">
            <inet-address value="${}"/>
Running JConsole

A script is provided in the $JDG_HOME/bin directory. Executing this script will launch JConsole.

Procedure B.2. Connecting to a remote JBoss Data Grid instance using JConsole

  1. Execute the $JDG_HOME/bin/ script. This will result in the following window appearing:
    JConsole connecting to remote Data Grid server

    Figure B.2. JConsole

  2. Select Remote Process.
  3. Enter service:jmx:remoting-jmx://$IP:9999 in the text area.
  4. Enter the username and password, created from the script.
  5. Click Connect to initiate the connection.
  6. Once connected ensure that the cache-related nodes may be viewed. The following screenshot shows such a node.
    Viewing cache attributes in JConsole

    Figure B.3. JConsole: Showing a Cache

Red Hat logoGithubRedditYoutubeTwitter


Try, buy, & sell


About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.