Activate Oracle JMX Agent and Local JMX Connectivity - Alfresco Content Services - 23.4 - 23.4 - Ready - Alfresco - external

Alfresco Content Services

Platform
Alfresco
Product
Alfresco Content Services
Release
23.4
License

When using Tomcat and an Oracle JVM together for monitoring, you can configure Content Services and Tomcat to share the JVM’s own platform MBean server. The pre-registered MXBeans give a detailed view of the JVM’s health, usage and throughput; in areas including class loading, hot spot compilation, garbage collection, and thread activity.

Oracle’s MBean server also provides a convenient local connection method, allowing the process to be automatically ‘discovered’ by a JMX client such as JConsole without manual configuration of connection details.

The Oracle JMX agent can also be activated in remote mode (where a connection is made through an RMI lookup). However, since Content Services is always pre-configured to allow a secure remote JMX connection on any JVM, it is most likely that you will choose to activate the Oracle JMX agent in local mode. This means the platform MBean Server is shared by Content Services and still be available for remote connections through the RMI connector.

CAUTION: The JMX connection provides full access to the JVM and the Alfresco system running within it, including the ability to execute code. You should consider this connection the same level of access like an SSH connection with the user account running Tomcat.
  • To activate the Oracle JMX agent in local mode, ensure that the following system property is set:
      com.sun.management.jmxremote

    For example, in your Tomcat startup script, you could use the following line:

      export JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote"
  • Refer to the Oracle documentation for more information on all the possible configuration options.