Extended discovery of Tomcat
Apache Tomcat is an Application Server, otherwise known as a Web Container, developed by the Apache Software Foundation (ASF).
Tomcat implements the Java Servlet and the JavaServer Pages (JSP) specifications from Sun Microsystems, providing an environment for Java code to run in cooperation with a web server, in addition it adds tools for configuration and management, which can also be configured by editing configuration files that are normally XML-formatted, and includes its own internal HTTP server.
BMC Atrium Discovery uses the
ApacheFoundation.Tomcat.Tomcat pattern to discover the Tomcat instance, identify the home directory (
catalina.home), identify the base directory (
catalina.base), and determine the Tomcat version. The pattern extracts information from the Tomcat configuration files to create and populate a Tomcat SI and its attributes.
Extended Tomcat discovery is enabled by the activation of the
Tomcat.ExtendedDiscovery.DiscoverTomcat pattern. This is activated by default in a new installation of BMC Atrium Discovery, but in an upgraded appliance, it must be activated manually. The
Tomcat.ExtendedDiscovery.DiscoverTomcat pattern triggers on the creation or update of a Tomcat SI. The
Tomcat.ExtendedDiscovery.DiscoverTomcat pattern is fully described in Configipedia.
Creation of a "JDBC Resource" Detail node triggers the
CreateJDBCToDatabaseSI pattern which searches the BMC Atrium Discovery model for an SI representing that database. If the database SI is found the pattern creates relationships between the Tomcat Application Server SI and the nodes representing the database (see below). If the host that the database runs on has not been scanned, no further work is undertaken.
Creation of a "J2EEApplication" SoftwareComponent node does not trigger any further operations.
See the Tomcat documentation for additional information on Tomcat datasources.
Requirements for a full discovery
For a full discovery of Tomcat, the database or databases that it is using, and the relationships between them, you need the following credentials:
Tomcat Discovery results
The following screen shows a successfully scanned Apache Tomcat instance.
The attributes section of the Tomcat SI contains sections for Components, and Details.
- Components are the SoftwareComponent nodes representing J2EE applications on Tomcat.
- Details are detail nodes representing resources on Tomcat. These may be application specific or globally defined. They may be one of the following:
- Custom Resources: a custom resource can be any kind of JavaBean declared as a resource.
- User Database Resource: the default Tomcat user management database.
- Java Mail Resources
- JDBC Resources
Improvements over extended discovery using JMX
Previously, extended Tomcat discovery relied on JMX. This required configuration on Tomcat to ensure that JMX was configured to permit local and remote monitoring. Additionally, discovery using JMX only permitted discovery of globally defined resources; discovery using configuration files enables you to discover application specific resources too.