---
title: Configuring the JMX connection handler
description: To enable the JMX connection handler:
component: pingdirectory
version: 11.0
page_id: pingdirectory:pingdirectory_server_administration_guide:pd_ds_configure_jmx_connection_handler
canonical_url: https://docs.pingidentity.com/pingdirectory/11.0/pingdirectory_server_administration_guide/pd_ds_configure_jmx_connection_handler.html
revdate: July 4, 2024
section_ids:
  about-this-task: About this task
  steps: Steps
  example: Example:
  example-2: Example:
---

# Configuring the JMX connection handler

## About this task

To enable the JMX connection handler:

## Steps

1. Run `dsconfig`.

   ### Example:

   ```shell
   $ bin/dsconfig set-connection-handler-prop \
     --handler-name "JMX Connection Handler" \
     --set enabled:true \
     --set listen-port:1689
   ```

2. Add a new non-root user account with the `jmx-read` and `jmx-notify` privileges using the `ldapmodify` tool using an LDIF representation.

   ### Example:

   ```
   dn: cn=JMX User,cn=Root DNs,cn=config
   changetype: add
   objectClass: top
   objectClass: person
   objectClass: organizationalPerson
   objectClass: inetOrgPerson
   objectClass: ds-cfg-root-dn-user
   givenName: JMX
   sn: User
   cn: JMX User
   userPassword: password
   ds-cfg-inherit-default-root-privileges: false
   ds-cfg-alternate-bind-dn: cn=JMX User
   ds-privilege-name: jmx-read
   ds-privilege-name: jmx-notify
   ```