HP Serviceguard Enterprise Cluster Master Toolkit User Guide (5900-2145, April 2013)

/etc/cmcluster/scripts/ecmt/apache directory. The third file is located in the /etc/
cmcluster/modules/ecmt/apache directory.
For legacy packages, one user configuration script (hahttp.conf) and three functional scripts
(toolkit.sh, hahttp.sh, and hahttp.mon) works together to integrate Apache web server with the
Serviceguard package control script.
Table 24 (page 106) lists the scripts used in legacy packages are:
Table 24 Scripts in Legacy Packages
DescriptionScript Name
This script contains a list of pre-defined variables that can be customized
for the user's environment. This script provides the user a simple format of
User Configuration file (hahttp.conf)
the user configuration data. This file is included (that is, sourced) by the
toolkit main script hahttp.sh.
This script contains a list of internal-use variables and functions that support
the start and stop of an Apache instance. This script is called by the Toolkit
Interface Script and performs the following functions.
Main Script (hahttp.sh)
• On package start, it starts the Apache server instance.
• On package stop, it stops the Apache server instance.
Monitoring functionality is initiated by calling the toolkit with the "monitor"
parameter as "toolkit.sh monitor".
Monitor Script (hahttp.mon)
This script is an interface between the Serviceguard package control script
and the toolkit main script (hahttp.sh).
Interface Script (toolkit.sh)
Toolkit user configuration
All the user configuration variables are kept in a single file hahttp.conf in shell script format.
The variable names and their sample values are listed in Table 25 (page 106):
Table 25 Configuration Variables
DescriptionConfiguration Variables
This is the base directory where HP Apache web server is installed. By
default, HP Apache is installed in the directory /opt/hpws22/apache
and hence this is also the default value.
HP_APACHE_HOME (for example,
HP_APACHE_HOME="/opt/hpws22/
apache")
This variable holds the root directory of an Apache server instance. Each
Apache instance must have its own root directory that contains its own
SERVER_ROOT (for example,
SERVER_ROOT="/opt/hpws22/apache")
server configuration file (httpd.conf). The Apache's system default
server root directory is /opt/hpws22/apache. However, to run
multiple instances in a cluster, set a value for this variable.
This variable holds the Process ID file path of the Apache server instance.
Each Apache instance must have its own PID file that maintains the main
PID_FILE (for example, PID_FILE="/
var/run/httpd_s1.pid")
process ID of the running Apache server instance. If this variable is not
set, the PID file is <package_directory>/httpd.pid.
When this variable is set to "yes" the Apache web server runs in secured
mode where the Apache web server can listen to HTTPS requests
SSL (for example: SSL="no")
otherwise. When set to "no" Apache web server is started in non secure
mode and Apache can only listen to HTTP requests.
This variable enables or disables maintenance mode for the Apache
package. By default, this is set to "yes”. To disable this feature
MAINTENANCE_FLAG (for example,
MAINTENANCE_FLAG ="yes")
MAINTENANCE_FLAG must be set to "no". When Apache must be
maintained the file "<package directory apache.debug" needs to be
created. During this maintenance period apache process monitoring is
paused. Even if the apache instance is brought down the package is
failed over to the adoptive node. To continue monitoring and turn off
maintenance mode, remove the apache.debug file. You must ensure
106 Using an Apache Toolkit in a HP Serviceguard Cluster