Registering an Apache Tomcat environment in PATROL


Providing configuration information that defines your Apache Tomcat environment to the PATROL monitoring environment includes registering the Apache Tomcat environment.

Before you begin

  • You must have installed and loaded PATROL for Apache Tomcat.
  • You enable a JMX port for monitoring through JMX commands.
  • The operating system user account must have read and execute permissions for the Java Home directory, and full access to the ../Patrol3/TCT directory.

To register an Apache Tomcat environment

  1. Choose Apache Tomcat > KM Commands > Register...
    The Register Apache Tomcat Environment  dialog box is displayed, as shown in the following figure:
    Register Apache Tomcat Environment dialog box
    • Register_Tomcat.png

Enter the following environment details.

Field

Description

Connection Details

Host/IP

Enter the host name or the IP address of a local or remote host. The IP addresses can be in the IPv4 or IPv6 format.

Note: An example of an IPv6 address is [2001:db8:28:3:f98a:5b31:67b7:67ef].

Port

Enter the JVM monitor port number.

User Name

(Optional) Enter a valid Apache Tomcat account user name.

Password

Enter the password for the Apache Tomcat account account. The password is required only if you entered a Apache Tomcat user name.

Note: To determine whether you need to specify username and password, log into the JConsole and open the VM Summary tab. In the connection name: field, you can see if a user has been entered or not. The JConsole binary comes with the JDK installation and resides in the Tomcat bin directory.

Certificate Details

TrustStore File Name

Enter the TrustStore file name for one-way SSL and two-way SSL connections.

TrustStore Password

Enter the TrustStore password for one-way SSL and two-way SSL connections.

KeyStore File Name

Enter the KeyStore file name for two-way SSL connections.

Keystore Password

Enter the KeyStore password for two-way SSL connections.

Monitoring Options


Select one or more of the following options:

  • Server Availability
  • General Health
  • Full
  • Custom

Note: If you have selected the Custom option, click Custom selection. The custom monitoring options dialog box is displayed.  In the Custom Monitoring Options dialog box, select one or more custom monitoring options.

Click here to view Custom Monitoring Options dialog box......

 cutom_groups_tomcat.jpg

(Optional) You can also enter the the PATROL defined ID in the box.

Click OK to add this to the environment configurations list. This environment is displayed as an object in the Generic JVM hierarchy.

Click Cancel to exit without saving any changes.

You can continue to add more environments for monitoring.

Editing-an-Apache-Tomcat-environment

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC PATROL for Apache Tomcat and Generic Java Server 3.1