Serviceguard Toolkits for Contrib User Guide Version A.12.00.00

7 Tomcat Toolkit
Overview
HP Serviceguard toolkit for Tomcat on Linux (Tomcat toolkit) enables you to configure Tomcat server
in an SG/LX cluster environment. The Tomcat toolkit consists of a set of shell scripts that are used
by the package control script to start, stop, and monitor the Tomcat database server. The toolkit
simplifies the task of integrating Tomcat with SG/LX.
Advantages
When Tomcat toolkit is deployed in an SG/LX environment, following are the advantages:
• Provides monitoring for Tomcat daemons.
• Enables easy integration of Tomcat server in an SG/LX environment.
• Provides high availability for the Tomcat server.
Prerequisites
Tomcat toolkit package requires the following to function:
• HP Serviceguard on Linux must be installed on all the nodes that must be configured in the
cluster.
• The toolkit must be installed on all the target nodes, where the package is configured to run.
• Tomcat server must be installed and configured on all the target nodes.
Files and directories created for Tomcat toolkit after installation
The following table describes the scripts installed and as part of the Tomcat installation.
Table 11 Tomcat toolkit files
Available in directoryDescriptionFile name
$SGROOT/tomcattoolkitThis is the toolkit main script that
contains internal functions that start or
stop an Tomcat instance.
hatomcat.sh
This monitors the health of the running
Tomcat server application.
hatomcat.mon
This is interface between the package
control script and the Tomcat toolkit
main shell script, hatomcat.sh.
toolkit.sh
$SGCONF/modules/tkit/tomcatThis is an attribute definition file, used
to generate a package ASCII template
in modular style of packaging.
tomcat.1
tomcat.2
$SGCONF/scripts/tkit/tomcatThis is the module script. This script is
called by the master control script and
tkit_module.sh
acts as an interface between the
master control script and the toolkit
interface script (toolkit.sh).
Setting up the Tomcat server in SG/LX environment
Before creating and configuring Serviceguard packages, you must complete the following steps:
1. Disable the automatic start of the standard Tomcat default installation if Tomcat is run from
Serviceguard so that nothing is running on the server at the system startup time. When the
Overview 31