4.9. JMX Client Access

You configure Java Management Extensions (JMX) client access by using the command-line tool, dsconfig.

Procedure 4.9. To Set Up JMX Access

  1. Configure the server to activate JMX access.

    $ dsconfig
     set-connection-handler-prop
     --hostname opendj.example.com
     --port 4444
     --bindDN "cn=Directory Manager"
     --bindPassword password
     --handler-name "JMX Connection Handler"
     --set enabled:true
     --trustAll
     --no-prompt

    This example uses the default port number, 1689.

  2. Restart the server so the change takes effect.

    $ stop-ds --restart

Procedure 4.10. To Configure Access To JMX

After you set up OpenDJ directory server to listen for JMX connections, you must assign privileges in order to allow a user to connect over protocol.

  1. Assign the privileges, jmx-notify, jmx-read, and jmx-write as necessary to the user who connects over JMX.

    See the section on Configuring Privileges for details.

  2. Connect using the service URI, user name, and password.

    Service URI

    Full URI to the service including the hostname or IP address and port number for JMX where OpenDJ directory server listens for connections. For example, if the server IP is 192.168.0.10 and you configured OpenDJ to listen for JMX connections on port 1689, then the service URI is service:jmx:rmi:///jndi/rmi://192.168.0.10:1689/org.opends.server.protocols.jmx.client-unknown.

    User name

    The full DN of the user with privileges to connect over JMX such as uid=kvaughan,ou=People,dc=example,dc=com.

    Password

    The bind password for the user.