Up to AIE 4.2, this page was called "JMX Administration."
In order to support remote/automated monitoring of AIE, a Java Management Extensions (JMX) web console and a JMX Remote Method Invocation (RMI) registry are exposed. Tools such as jconsole can be used to connect to the JMX server for monitoring and management.
View incoming links.
Enabling Remote JMX Authentication
By default, the remote JMX connectivity via RMI does not require authentication. In order to authenticate against a selected group of users, go to the <project_dir>\conf\properties\core-app\attivio.core-app.properties file and setting for jmx.auth.provider.bean.name property to identify AuthenticationProvider bean to use with remote clients. If this property is not specified, AIE will attempt to use the default security authentication provider bean, similar to Deploy Webapp feature.
Credentials to JMX Console
Use mx4j.credentials.username and mx4j.credentials.password (see below) to specify credentials to JMX console.
Providing Credentials to acquire ExposedApi
Beside establishing JMX connectivity explicitly to get registered managed bean, AIE Service Factory framework also exposes implementations of ExposedAPI via JMX. Using these services remotely when JMX authentication is turned on thus require credentials. See the following sample code that acquired a ConfigurationAPI for example:
Configuring SSL For JMX
The transport for JMX can be configured to use SSL for an added layer of security. Add jmx.ssl.enable=true to any property file, or uncomment it from <project-dir>/conf/properties/core-app/attivio.core-app.properties. If you have already generated key and certificate information when configuring SSL for the AIE Administrator, there is nothing more to do. If you want JMX configured for SSL but not the AIE Administrator, then generate key and certificate information as described in the first four steps of Enabling SSL HTTPS for AIE Web Applications. (There is no need to configure Jetty in this case).
Note: If JMX SSL is enabled in the application, be aware that connecting to JMX will require a few extra steps than if JMX SSL is not enabled. If you would like to connect using tools such as jconsole you need to add the following system properties when you start up that tool to ensure that you can connect securely:
If you wish to create your own client using java you can set the system properties when you start your process by passing in the arguments you see above (minus the "-J") or simply set the properties in your code before attempting to establish the secure JMX connection:
3rd party JMX Management Tools
Many management tools such as jconsole can connect to remote processes in order to view and manage system configuration and statistics. By default, AIE creates a RMI endpoint for remote JMX management. In order to connect your 3rd party tool to the AIE JMX server, use the following URI to connect. Note: this URI assumes you used the default 17000 baseport.