Using agent actions in the BMC TrueSight Infrastructure Management operator console

When you use an agent action, it is issued from your local console, but executed on the computer where the PATROL Agent is installed. 

The TrueSight console gives you access to the BMC TrueSight Infrastructure Management operator console where you can select an agent action to be performed on a device using the BMC PATROL for Apache Tomcat and Generic Java Server KM. These agent actions include:

  • KM administration
  • Verifying the monitor configuration
  • Enabling logging of PSL and Java activities
  • Force discovery of the KM environment

The information about using agent actions includes the following:



Related topic

Using

Navigating the operator console

Before you begin

You can only use an agent action when the following conditions are met:

  • You must have appropriate permissions required to execute agent actions.
  • The TrueSight Infrastructure Management Server must be registered as a component with the TrueSight. .
  • The application class to which the monitor belongs has the menu commands defined in the KMs for PATROL Agent.

To select an agent action 

  1. Launch the BMC TrueSight Infrastructure Management operator console from the TrueSight console by selecting Monitoring > Devices.
  2. Select a device and in the Device Details page click on the action menu next to the device name.
  3. Select Launch Infrastructure Management Operator console from the menu.
  4. Click Devices in the console's Navigation tree and click Grid View.
    Devices grid view
  5. Choose a monitor and click the blue wrench icon in the Tools Menu.
  6. Click Agent Actions, and select an agent action.
  7. If any input is required for the agent action, a dialog box is displayed. You must provide the values that are required for the action to be executed

A confirmation message is displayed after any agent action is executed.

Top level agent action functions

The following agent actions are available when you select a system at the top level of the hierarchy in the devices grid view.

KM Administration

Select either of the following options:

  • Restart the Java Collector process
    Agent Action Output for restart the Java collector

  • Discovery Information
    Displays the information for the monitored environments connected to the device.
    Agent Action Output for discovery information

Verify monitor configuration

This agent action identifies connectivity issues between the PATROL Agent, the communication channel, and the JAVA process.

This action is similar to using the environment checker utility.

When you select this agent action, the following is shown:

Apache Tomcat input form for verify monitor configuration agent action


FieldDescription
Apache Tomcat Host/IPEnter the host name or the IP address of a local or remote host. The IP addresses can be in the IPv4 or IPv6 format.
Apache Tomcat PortEnter the port number used to connect to the host or IP address.
UsernameEnter the user name for the monitored JVM.
PasswordEnter the password for the monitored JVM.
SSL Certificate Details

TrustStore file 

Truststore password

For one-way or two-way SSL key connections, enter the truststore file path and password.

KeyStore file

KeyStore password

For two-way SSL key connections, enter the keystore file path and password.

Generic JVM input form for verify monitor configuration agent action


FieldDescription
Host/IPEnter the host name or the IP address of a local or remote host. The IP addresses can be in the IPv4 or IPv6 format.
PortEnter the port number used to connect to the host or IP address.
RMI Server Type

Enter the server type used to monitor the environment.

  • jmxrmi (default)
  • ARServer  (Remedy server)
UsernameEnter the user name for the monitored JVM.
PasswordEnter the password for the monitored JVM.
SSL Certificate Details

TrustStore file 

Truststore password

For one-way or two-way SSL key connections, enter the truststore file path and password

KeyStore file

KeyStore password

For two-way SSL key connections, enter the keystore file path and password.

After you enter the parameters to verify the monitor configuration, click Execute.

Logging

This agent action enables the logging for PSL and Java activities.

Agent Action Output for enable logging

Force Discovery

This agent action rediscovers the device hierarchy to refresh the console display.

Agent Action Output for force discovery

Environment level agent action functions

The following agent actions are available when you select an environment under the top level of the hierarchy in the devices grid view.

Diagnostic report

This agent action generates a diagnostic reports for environment and stores it at the displayed location.

Force Discovery

As in the top level agent action, this agent action rediscovers the device hierarchy to refresh the console display.

Agent Action Output for force discovery


Was this page helpful? Yes No Submitting... Thank you

Comments