HP Serviceguard Linux Contributed Toolkit Suite A.04.02.01 User Guide (696979-001, June 2012)

DescriptionAttribute
under this directory. To put the toolkit into maintenance
mode, create tomcat.debug file under this directory.
Define the Catalina Home directory. This is the directory
where Tomcat is installed.
CATALINA_HOME
Define the Catalina base directory. This is the base
directory where Tomcat configuration files like server.xml
CATALINA_BASE
reside. If this is not defined the toolkit uses
CATALINA_HOME as the base directory. This must be
unique for each tomcat instance and usually residing
on the shared disk
The userid used to start the tomcat daemon. It can be
either www or root. No other user can start tomcat. It
TOMCAT_USER
is advisable that tomcat is not started as root since it
may lead to security vulnerabilities.
Base directory of Java Development kit. This software
is a pre-requisite for running Tomcat.
JAVA_HOME
This parameter is used to bring this toolkit into the
maintenance mode. If this parameter is set to yes, then
MAINTENANCE_FLAG
it enables maintenance feature in the toolkit. Tomcat
toolkit searches the tomcat.debug file in the Tomcat
toolkit package file directory where all the Tomcat toolkit
files are located.
If the file exists, monitoring is paused, and you can bring
down Tomcat for maintenance. The package does not
fail over to the adoptive node even though Tomcat
instance is brought down for maintenance.
After the maintenance work, ensure that Tomcat is
brought up. You must delete the tomcat.debug file in
the package directory. This enables toolkit to continue
monitoring Tomcat server application.
NOTE: If the Maintenance flag is set to no, then this
feature does not work.
This is the tomcat server listening port. This is configured
in the configuration file $CATALINA_BASE/conf/
MONITOR_PORT
server.xml. The toolkit checks the existence of tomcat
process by periodically checking whether this port is
listening. If multiple instances of tomcat are configured
then this port must be unique for each instance.
The time interval in seconds to monitor the Tomcat
server. The default value is 30.
MONITOR_INTERVAL
The number of trials attempted by the toolkit script to
check the tomcat server daemon before giving up and
exiting. The default value is 2.
RETRY_TIMES
5. Validate the configuration using the cmcheckconf command:
# cmcheckconf -P tomcat_pkg.conf
6. Create the package using cmapplyconf command, if the cmcheckconf command does
not report any errors:
# cmapplyconf -P tomcat_pkg.conf
Managing packages
You can manage packages by running, maintaining, halting, and deleting them.
Using Tomcat toolkit 57