Software AG Infrastructure 10.5 | Running Web Applications | About the Predefined JMX Connector | Creating a JMX Connector
 
Creating a JMX Connector
In addition to using the predefined JMX connector, you can also create a JMX connector to monitor Software AG Runtime. You can copy the predefined JMX connector and modify it as described in the following procedure.
*To create a JMX connector
1. Go to the Software AG_directory \profiles\CTP\configuration\com.softwareag.platform.config.propsloader directory.
2. Copy the com.softwareag.jmx.connector.pid-port_number.properties file and open the copy in a text editor.
3. Modify any of the properties in the following table, as required:
Property
Description
host
The name of the local interface on which the connector listens. If you do not specify a host, the connector is open on all local interfaces.
port
Required. The port number on which the connector creates a server socket and waits for incoming connections. The port number must be unique among all connectors.
jaasRealm
Required. The JAAS realm to use for login.
secure
Whether to use SSL for the Remote Method Invocation (RMI) connection. Valid values are true or false. The default value is false.
enabled
Whether to enable or disable the connector. Valid values are true or false. The default value is true.
permission
The name of the permission that the authenticated user must have to establish a JMX connection. If you specify*, no permission check is executed.
truststoreFile
The absolute path to a valid truststore file. You specify a value for truststoreFile only if you set secure to true.
truststoreType
The Java truststore type. Software AG Runtime supports the JKS (default) and PKCS12 truststores. You specify a value for truststoreType only if you set secure to true and specified a value for truststoreFile.
truststorePass
The password for the truststore. You specify a value for truststorePass only if you set secure to true and specified a value for truststoreFile.
keystoreFile
The absolute path to a valid keystore file. You specify a value for keystoreFile only if you set secure to true.
keystoreType
The Java keystore type. Software AG Runtime supports the JKS (default) and PKCS12 keystores. You specify a value for keystoreType only if you set secure to true and specified a value for keystoreFile.
keystorePass
The password for the keystore. You specify a value for keystorePass only if you set secure to true and specified a value for keystoreFile.
internalPort
The port number that the connector uses for internal calls by RMI. The default value is the value that you specified for the port property. However, if SSL is enabled, you must specify a different value from the value of port.
4. Save the file.
5. Modify the port_number in the properties file name to match the value that you specified for the port property.
6. Reopen the properties file.
7. Add a @secure. prefix to the keys of the keystorePass and truststorePass properties.
For example, for keystorePass, specify @secure.keystorePass=change_this_password.
The next time the properties file configuration is loaded, Software AG Runtime moves the value of the keystorePass property to an encrypted secure storage on the file system under the Software AG_directory \profiles\CTP\configuration\security\passman directory and the configuration is written back, replacing the value with a secure token that contains a handle from the secure storage instead of the original plaintext value.
8. Save the file.