Viewing JVM Information from an Agent

You can configure TIBCO Enterprise Administrator to detect JVMs running on a machine on which TIBCO Enterprise Administrator Agent is running. When configured, the Machine View displays the JVM Processes pane. The JVM Processes pane shows process ids with display names (if present) of the JVMs in a drop-down list.

By default, the JVM details are not displayed. To view the JVM details, you must configure a property either on the server or on the machines on which the agents are running. When you choose to view the JVM details, the JAR files provided by the server loads on the external JVM. Once loaded on an external JVM, these JAR files cannot be unloaded.

Prerequisites

To view the JVM details on the server side, in the tea.conf file, set the tea.jvminfo.enabled to true. To view the JVM details of the machine on which the agents are running, set the tea.agent.jvminfo.enabled to true.

Procedure

  1. On the menu, click The View icon on the main menu. and select Machines.
    Note: Alternatively, you can click on the Machines card on the landing page, or the Machines option on side navigation bar.
  2. Click a machine of your choice.
  3. Scroll down to see the JVM processes pane. Remember that the JVM information is not displayed if the corresponding JVM returned empty values or if the process ids are empty.
    Warning: You might not see the JVM details if you started the server as an NT service on boot up. To avoid this, start the NT service under a particular user by configuring the NT service with user name and password. In this case, you can only see the details of the TIBCO software installed for the specific user.
  4. Click the drop-down list and select a JVM process entry.
  5. You will be prompted with the following message: Do you want to install cloud op agent jar with an external JVM. Click OK.
    The JAR files provided by the server loads on the external JVM. This prompt is displayed only in the beginning of a once for a browser tab.
    JVM Processes Drop-Down List
    The details of the selected JVM process are displayed.
    Note: If there are two agents running on the same machine, one with JVM details enabled and the other with JVM details disabled, the JVM details might or might not be displayed depending on the agent selected by the server to fetch the JVM information. The behavior would be random in this case.
    JVM Processes
    Attention:
    • For the JVM that corresponds to a TIBCO Enterprise Administrator Agent, the information displayed is of that instant in time.
    • For rest of the JVMs, the information displayed is as it was captured in time; which is displayed by Agent.Time field's value. The JVM information is periodically collected by the remote JVMs in a file. The interval of collecting the information for all such JVMs is currently set to 60 seconds (not configurable).
    • If an agent is running on the same machine as the TIBCO Enterprise Administrator server, the timestamp for that agent won't be instantaneous and will update every 60 seconds.
    • If an agent is running on a remote machine, then the timestamp will be instantaneous for that agent.