User's Manual

Table 31 User Configuration Variables (continued)
DescriptionUser Configuration Variables
This variable will enable or disable maintenance mode for the Tomcat package.
By default, this is set to "yes". In order to disable this feature,
MAINTENANCE_FLAG should be set to "no". When Tomcat needs to be
maintained the file, <package directory>/tomcat.debug needs to be
touched. During this maintenance period, the tomcat process monitoring is
paused. Even if the tomcat instance is brought down, the package will not be
failed over to the adoptive node. To continue monitoring and turning off
maintenance mode, remove the tomcat.debug file. It is the user's
responsibility to ensure that the tomcat instance is running properly after the
maintenance phase.
NOTE: Setting MAINTENANCE_FLAG to "yes" and touching the
tomcat.debug file in the package directory will put the package in toolkit
maintenance mode. Serviceguard A.11.19 release has a new feature which
allows individual components of the package to be maintained while the
package is still up. This feature is called Package Maintenance mode and is
available only for modular packages. For more information using Package
Maintenance mode, see Modular package support in Serviceguard for Linux
and ECM Toolkits available at http://www.hp.com/go/hpux-serviceguard-docs
—>HP Serviceguard Enterprise Cluster Master Toolkit.
MAINTENANCE_FLAG (for example,
MAINTENANCE_FLAG ="yes")
This is the tomcat server listening port. This should be as same as the port
configured in the Tomcat configuration file $CATALINA_BASE/conf/
server.xml. The toolkit checks the existence of the Tomcat process by
periodically checking whether this port is listening. If multiple instances of
tomcat are configured, this port needs be unique for each instance. The default
value is 8081.
MONITOR_PORT (for example:
MONITOR_PORT=8081)
Specify a time interval in seconds for monitoring the Tomcat instance. The
monitor process checks the Tomcat daemons at this interval to validate they
are running. The default value will be 5 seconds.
MONITOR_INTERVAL (for example,
MONITOR_INTERVAL=5)
This variable holds the number of times to attempt to check the 'tomcat' daemon
processes before giving up and exiting to fail state. If not defined, its default
value will be 2.
RETRY_TIMES (for example,
RETRY_TIMES=2)
For the alert mail notification feature, an additional parameter called ALERT_MAIL_ID is introduced
in the ADF. It sends an e-mail message to the specified e-mail address when packages fail. This
e-mail is generated only when packages fail, and not when a package is halted by the operator.
To send this e-mail message to multiple recipients, a group e-mail ID must be created and specified
for this parameter. When an e-mail ID is not specified for this parameter, the script does not send
out this e-mail.
The following information provides the steps for configuring the toolkit and running the package.
This includes configuring the Tomcat toolkit user configuration file:
NOTE: Before working on the toolkit configuration, the package directory (for example,
/etc/cmcluster/pkg/tomcat_pkg1) must be created and all toolkit scripts copied to the package
directory.
1. Edit the Tomcat Toolkit user configuration file.
In the package directory, edit the user configuration file (hatomcat.conf ) as indicated by
the comments in that file.
For Example:
CATALINA_HOME="/opt/hpws22/tomcat"
CATALINA_BASE="/shared/tomcat_1"
120 Using Tomcat Toolkit in a HP Serviceguard Cluster