OCF_HEARTBEAT_APACHE(7)
NAME
ocf_heartbeat_apache - Manages an Apache web server instance
SYNOPSIS
apache [start | stop | status | monitor | meta-data | validate-all]
DESCRIPTION
This is the resource agent for the Apache web server. Thie resource
agent operates both version 1.x and version 2.x Apache servers. The
start operation ends with a loop in which monitor is repeatedly called
to make sure that the server started and that it is operational. Hence,
if the monitor operation does not succeed within the start operation
timeout, the apache resource will end with an error status. The monitor
operation by default loads the server status page which depends on the
mod_status module and the corresponding configuration file (usually
/etc/apache2/mod_status.conf). Make sure that the server status page
works and that the access is allowed *only* from localhost (address
127.0.0.1). See the statusurl and testregex attributes for more
details. See also http://httpd.apache.org/
SUPPORTED PARAMETERS
- configfile
- The full pathname of the Apache configuration file. This file is
parsed to provide defaults for various other resource agent
parameters. (optional, string, default /etc/apache2/httpd.conf) - httpd
- The full pathname of the httpd binary (optional). (optional,
string, default /usr/sbin/httpd) - port
- A port number that we can probe for status information using the
statusurl. This will default to the port number found in the
configuration file, or 80, if none can be found in the
configuration file. (optional, integer, no default) - statusurl
- The URL to monitor (the apache server status page by default). If
left unspecified, it will be inferred from the apache configuration file. If you set this, make sure that it succeeds *only* from the
localhost (127.0.0.1). Otherwise, it may happen that the cluster
complains about the resource being active on multiple nodes.
(optional, string, no default) - testregex
- Regular expression to match in the output of statusurl. Case
insensitive. (optional, string, default exists, but impossible to
show in a human readable format (try grep testregex)) - client
- Client to use to query to Apache. If not specified, the RA will try
to find one on the system. Currently, wget and curl are supported.
For example, you can set this parameter to "curl" if you prefer
that to wget. (optional, string, no default) - testurl
- URL to test. If it does not start with "http", then it's considered
to be relative to the Listen address. (optional, string, no
default) - testregex10
- Regular expression to match in the output of testurl. Case
insensitive. (optional, string, no default) - testconffile
- A file which contains test configuration. Could be useful if you
have to check more than one web application or in case sensitive
info should be passed as arguments (passwords). Furthermore, using a config file is the only way to specify certain parameters. Please see README.webapps for examples and file description. (optional,
string, no default) - testname
- Name of the test within the test configuration file. (optional,
string, no default) - options
- Extra options to apply when starting apache. See man httpd(8).
(optional, string, no default) - envfiles
- Files (one or more) which contain extra environment variables. If
you want to prevent script from reading the default file, set this parameter to empty string. (optional, string, default
/etc/apache2/envvars)
SUPPORTED ACTIONS
This resource agent supports the following actions (operations):
- start
- Starts the resource. Suggested minimum timeout: 40s.
- stop
- Stops the resource. Suggested minimum timeout: 60s.
- status
- Performs a status check. Suggested minimum timeout: 30s.
- monitor
- Performs a detailed status check. Suggested minimum timeout: 20s.
Suggested interval: 10. - meta-data
- Retrieves resource agent metadata (internal use only). Suggested
minimum timeout: 5. - validate-all
- Performs a validation of the resource configuration. Suggested
minimum timeout: 5.
EXAMPLE
- The following is an example configuration for a apache resource using
the crm(8) shell: - primitive example_apache ocf:heartbeat:apache \
op monitor depth="0" timeout="20s" interval="10"
SEE ALSO
http://www.linux-ha.org/wiki/apache_(resource_agent)
AUTHOR
- Linux-HA contributors (see the resource agent source for information about individual authors)