PingDirectory

Monitoring the server using JConsole

Set up JConsole to monitor the server using a remote process.

Steps

  1. Start the server.

    Example:

    $ bin/start-server

  2. Enable the Java Management Extensions (JMX) Connection handler usingdsconfig with the set-connection-handler-prop option.

    The handler is disabled by default.

    Include the LDAP connection parameters, such as host name, port, bindDN, and bindPassword.

    Example:

    $ bin/dsconfig set-connection-handler-prop \
  --handler-name "JMX Connection Handler" --set enabled:true

  3. Assign privileges to a regular user account with the ldapmodify tool.

    Do not use a root user account, as using a root user account would be a security risk.

    Example:

    This example grants jmx-read, jmx-write, and jmx-notify privileges to the user.

    $ bin/ldapmodify --hostname server1.example.com --port 1389 \
  --bindDN "cn=Directory Manager" --bindPassword secret
dn: uid=admin,dc=example,dc=com
changetype: modify
replace: ds-privilege-name
ds-privilege-name: jmx-read
ds-privilege-name: jmx-write
ds-privilege-name: jmx-notify

  4. In the Java Monitoring & Administrative Console, click Remote Process, and enter the following JMX URL using the host and port of your server.

    service:jmx:rmi:///jndi/rmi://<host>:<port>/com.unboundid.directory.server.protocols.jmx.client-unknown

  5. In the Username and Password fields, enter the bind distinguished name (DN) and password for a user that has at least the jmx-read privilege.

  6. Click Connect.

  7. Click com.unboundid.directory.server, and expand the rootDSE node and the cn-monitor sub-node.

  8. Select a monitoring entry.