Table 31 User Configuration Variables (continued)

User Configuration Variables

Description

MAINTENANCE_FLAG (for example,

This variable will enable or disable maintenance mode for the Tomcat package.

MAINTENANCE_FLAG ="yes")

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.

 

 

MONITOR_PORT (for example:

This is the tomcat server listening port. This should be as same as the port

MONITOR_PORT=8081)

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_INTERVAL (for example,

Specify a time interval in seconds for monitoring the Tomcat instance. The

MONITOR_INTERVAL=5)

monitor process checks the Tomcat daemons at this interval to validate they

 

are running. The default value will be 5 seconds.

 

 

RETRY_TIMES (for example,

This variable holds the number of times to attempt to check the 'tomcat' daemon

RETRY_TIMES=2)

processes before giving up and exiting to fail state. If not defined, its default

 

value will be 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