Agents Administration - Tests
 

Configuration of JvmFileDescriptorTest

The JvmFileDescriptorTest reports the real-time File Descriptor statistics pertaining to the JVM.

Note:

This test will work only if the target Java application uses the JDK/JRE offered by one of the following vendors only: Oracle, Sun, OpenJDK. IBM JDK/JRE is not supported.

The parameters of this test are as follows:

  • The TEST PERIOD list box helps the user to decide how often this test needs to be executed.

  • In the HOST text box, the host name for which the test is to be configured has to be specified.

  • The PORT text box refers to the port number at which the specified HOST listens.

  • The JMX REMOTE PORT text box appears only if the MODE is set to JMX. Here, specify the port at which the JMX listens for requests from remote hosts. Ensure that you specify the same port that you configured in the management.properties file in the <JAVA_HOME>\jre\lib\management folder used by the target application.

  • The JNDINAME text box appears only if the MODE is set to JMX. The JNDINAME is a lookup name for connecting to the JMX connector. By default, this is jmxrmi. If you have registered the JMX connector in the RMI registry using a different lookup name, then you can change this default value to reflect the same.

  • The USERNAME, PASSWORD and CONFIRM PASSWORD text boxes,appear only if the MODE is set to JMX. If JMX requires authentication only (but no security), then ensure that the USERNAME and PASSWORD parameters are configured with the credentials of a user with read-write access to JMX. To know how to create this user, refer to Section 1.1.1.2 of the Monitoring Java Applications document. Confirm the password by retyping it in the CONFIRM PASSWORD text box.

  • Finally, click the Update button.

When changing the configuration for specific servers, a “*” beside the text box corresponding to the parameter signifies that these values have to be manually configured by the user. The parameter values that require to be configured will typically be prefixed with a “$” or contain a series of “*”. A value of "none" in the parameter value indicates that the corresponding parameter value can be changed if required.