HP Enterprise Cluster Master Toolkit User Guide (5900-2131, December 2011)

Set the TKIT_DIR variable as the path of <package_directory>. For example, TKIT_DIR
/etc/cmcluster/pkg/apache_pkg.
5. Use cmcheckconf command to check for the validity of the configuration specified.
For Example:
#cmcheckconf -P pkg.conf
6. If the cmcheckconf command does not report any errors, use the cmapplyconf command
to add the package into Serviceguard environment.
For Example:
#cmapplyconf -P pkg.conf
Error Handling
On startup, the Apache server application will check for the existence of the httpd.conf file in
the directory <SERVER ROOT>/conf/httpd.conf. If the configuration file does not exist in this
location or Apache does not start for some other reason the action by the Apache toolkit script is
to halt the package on that node and try it on another node. In order to troubleshoot why Apache
has not been started correctly one has to look at the Apache error log files. The Apache log files
can be located by the value set for the ErrorLog directive in the Apache instance configuration file
httpd.conf. Usually this value is <SERVER ROOT>/logs/error_log.
Apache Web Server Maintenance
There might be situations, when the Apache Web Server has to be taken down for maintenance
purposes like changing the configuration, without having the instance to migrate to another node.
This procedure should be followed:
NOTE: The example assumes that the package name is http_pkg1, package directory is /etc/
cmcluster/pkg/http_pkg1 and the Apache SERVER ROOT is configured as /shared/
apache1/httpd.
• Disable the failover of the package through cmmodpkg command cmmodpkg -d http_pkg1
• Pause the monitor script. Create an empty file, /etc/cmcluster/pkg/http_pkg1/
apache.debug, as shown below:
touch/etc/cmcluster/pkg/http_pkg1/apache.debug.
The toolkit monitor script which continuously monitored the Apache daemons, would now stop
monitoring these daemons. A message "Apache toolkit pausing monitoring and entering
maintenance mode" is logged in the package control script log.
◦ If required, stop the apache application as shown below:
cd /etc/cmcluster/pkg/http_pkg1/ $PWD/toolkit.sh stop
◦ Perform maintenance actions (for example, changing the configuration of the Apache
instance, or making changes to the toolkit configuration file, hahttp.conf for starting
up Apache web server application in secured mode. If this file is changed, remember to
distribute the new file to all cluster nodes).
◦ Start the apache instance again if stopped, cd /etc/cmcluster/pkg/http_pkg1/
$PWD/toolkit.sh start
◦ Allow monitoring scripts to continue normally as shown below:
rm -f /etc/cmcluster/pkg/http_pkg1/apache.debug
108 Using an Apache Toolkit in a HP Serviceguard Cluster