One of the reasons for running JConsole remotely is to minimize the effect of JConsole on server performance, since JConsole does consume a lot of system resources. However, you should be aware of the security impact of running JConsole remotely and take appropriate measures to guard against unauthorized access.

This procedure tells you how to enable JMX remote access to a PAS for OpenEdge instance, which is a prerequisite for running the JConsole administrative tool remotely.

  1. Open the $CATALINA_BASE/conf/catalinaopts.properties file and add com.sun.management.jmxremote.port=<port number> and com.sun.management.jmxremote.rmi.port=<port number> parameters to it.
    For example:
    com.sun.management.jmxremote.port=10001
com.sun.management.jmxremote.rmi.port=10002
  2. Add the name of the instance's host to its /conf/appserver.properties file.

    Add and set the following property in appserver.properties:

    java.rmi.server.hostname=hostname
    Note: If you do not set java.rmi.server.hostname, the default localhost will be used.
  3. Restrict read/write access to the instance's /conf/jmxremote.password file to the user with owner privileges.
    Important: jmxremote.password is a plain-text file that contains the username/password combination that you need in order to log in to the instance from a remote JConsole. The default username and password (jmxadmin, jmxadmin) should be changed for security reasons.

    On Windows, you can change permissions on the Security tab of the file's Properties dialog. On a UNIX system, you would run the following command:

    chmod 600 jmxremote.password
  4. Restart the Progress Application Server (PAS) for OpenEdge server.
  5. On a remote machine, browse to $JAVA_HOME/bin and run jconsole.exe.
    The JConsole New Connection dialog appears.
    jconsole
    1. Click the Remote Process button.
    2. Specify hostname and port of the instance that you want to manage.
    3. Enter the credentials that are specified in the instance's jmxremote.password file.
      Upon successful login, the Java Monitoring & Management Console appears.