HP Serviceguard Enterprise Cluster Master Toolkit User Guide, December 2012 (5900-2145)

and tries to start it on another node. To troubleshoot and to check, you must check error log files.
The Tomcat log files are available at $CATALINA_BASE/logs directory.
Tomcat Server Maintenance
For maintenance, the Tomcat Server must be brought down. For example, when you want to change
configuration of Tomcat but do not want to migrate to another node.
In the following example, consider that the package name is tomcat_pkg1, package directory is
/etc/cmcluster/pkg/tomcat_pkg1, and the Tomcat CATALINA_BASE is configured as
/shared/tomcat_1.
Steps for Tomcat Server maintenance:
1. Disable the failover of the package through the cmmodpkg command cmmodpkg -d
tomcat_pkg1.
2. Pause the monitor script .
• Create an empty file, /etc/cmcluster/pkg/tomcat_pkg1/tomcat.debug
touch/etc/cmcluster/pkg/tomcat_pkg1/tomcat.debug
The toolkit monitor script, which continuously monitored the Tomcat daemons, stops
monitoring these daemons. A message "Tomcat toolkit pausing monitoring and entering
maintenance mode" is logged in the package control script log.
3. Optional: Stop the tomcat application.
cd /etc/cmcluster/pkg/tomcat_pkg1/
$PWD/toolkit.sh stop
4. Perform maintenance actions (for example, change the configuration of the Tomcat instance,
or change the toolkit configuration file, hatomcat.conf. If you change this file, ensure that
you distribute the new file to all cluster nodes.
5. Restart the tomcat instance again if it is stopped using cd /etc/cmcluster/pkg/
tomcat_pkg1/ $PWD/toolkit.sh start.
6. Allow monitoring scripts to run normally.
rm -f /etc/cmcluster/pkg/tomcat_pkg1/tomcat.debug
A message "Starting Tomcat toolkit monitoring again after maintenance" appears in the
Serviceguard Package Control script log.
7. Enable the package failover:
cmmodpkg -e tomcat_pkg1
NOTE:
• If the package fails during maintenance (for example, the node crashes), the package does
not automatically fail over to an adoptive node. You must start the package on an adoptive
node. For more information, see the latest Managing Serviceguard manual available at http://
www.hp.com/go/hpux-serviceguard-docs —>HP Serviceguard .
This feature is enabled only when the configuration variable MAINTENANCE_FLAG is set to
"yes" in the tomcat toolkit configuration file /etc/cmcluster/pkg/tomcat_pkg1/
hatomcat.conf.
• HP suggests you to have different toolkit directories for each package. If two or more packages
share the same toolkit directory and if one package enters the maintenance mode, it will affect
the other package too.
Tomcat Server Maintenance 119