JMX connection with authentication - JMX connection with authentication - Alfresco - Alfresco Sync Service - Alfresco/Alfresco-Sync-Service/3.0/Alfresco-Sync-Service/Alfresco-Sync-Service/Configure/Connect-to-Sync-Service-through-JMX/JMX-connection-with-authentication - 3.0

Alfresco Sync Service

Platform
Alfresco
Product
Alfresco Sync Service
Release
3.0
ft:lastPublication
2026-05-06T19:49:28.818000
ft:locale
en-US
ArchiveStatus
Archived

Before enabling the authentication, first you need to create a password file. The file name isn't important. Use the following example for guidance.

Note

If you're using an earlier JDK version than 9, then you'll need to specify the role in a separate jmx.access file.

  1. Create the file jmx.password.

    jmx.password is the password file which defines the roles and their passwords.

    To be functional, a role must have an entry in the password file.

  2. In the jmx.password file, add the role and the desired password.

    For example:

    alfrescoSync password
    
  3. Change the jmx.password permission to read-only for the owner:

    For example:

    sudo chown dsync: jmx.password && sudo chmod 600 jmx.password
    
  4. Start the Sync Service by enabling authentication, and pass on the path to the created file:

    -Dcom.sun.management.jmxremote.authenticate=true
    -Dcom.sun.management.jmxremote.password.file=/path/to/jmx.password
    

    For example:

    cd <installLocation>/service-sync
    
    java -Xmx2G -Dcom.sun.management.jmxremote=true -Djava.rmi.server.hostname=34.253.209.238
    -Dcom.sun.management.jmxremote.port=50800 -Dcom.sun.management.jmxremote.rmi.port=50801
    -Dcom.sun.management.jmxremote.authenticate=true
    -Dcom.sun.management.jmxremote.password.file=/path/to/jmx.password
    -Dcom.sun.management.jmxremote.ssl=false -Djava.io.tmpdir=/var/tmp/dsync
    -cp postgresql.jar:service-sync-3.0.x.jar org.alfresco.service.sync.dropwizard.SyncService
    server config.yml
    

    Note

    Replace service-sync-3.0.x.jar with your exact version.

  5. Start JConsole and select Remote Process.

  6. Enter the Sync Service IP, com.sun.management.jmxremote.port value, user name, and password, as shown in the example below.

  7. Click Connect.

    JConsole