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

Running packages
To start a package:
# cmrunpkg <package_name>
Maintaining packages
HP Serviceguard normally monitors critical processes, but there might be situations when a planned
maintenance task (for example, changing the configuration) is required that affects those monitored
processes. The maintenance flag can be used to signal to Serviceguard that it should not failover
the instance to an adoptive node.
For easy comprehension, the following naming conventions are used in this section:
• Package name: tomcat_pkg1
• Package directory: ${SGCONF}/tomcat_pkg1
To set an Tomcat toolkit package to the maintenance mode:
1. Enable the maintenance for the package during package creation.
To enable the maintenance mode feature, set the MAINTENANCE_FLAG to yes in the package
configuration file or Tomcat toolkit configuration file, and then apply the configuration by
running the cmapplyconf command.
2. Create an empty file to pause Tomcat server processes monitoring
${SGCONF}/pkg/tomcat_pkg1/tomcat.debug as shown below:
touch ${SGCONF}/pkg/tomcat_pkg1/tomcat.debug
The toolkit monitoring script stops monitoring the Tomcat daemons running for the instance
configured for the package. The following message is logged in the package control script:
Tomcat toolkit pausing, monitoring, and entering maintenance mode.
3. Perform the maintenance actions.
For example, you can change the configuration of the Tomcat instance, or install a Tomcat
patch.
4. To start the monitoring process, run:
# rm -f ${SGCONF}/pkg/tomcat_pkg1/tomcat.debug
The following message is recorded in the Serviceguard package control script log:
Starting Tomcat toolkit monitoring again after maintenance.
NOTE: Ensure that the Tomcat server instance is up and running before removing the
tomcat.debug file.
Halting packages
To halt a package:
# cmhaltpkg <package_name>
Deleting packages
To delete a package from the cluster:
# cmdeleteconf -p <package_name>
This command prompts for a verification, before deleting the files, unless you use the -f option.
58 Tomcat Toolkit