ocf_heartbeat_apache(7)

1OCF_HEARTBEAT_APACHE(7)       OCF resource agents      OCF_HEARTBEAT_APACHE(7)
2
3
4

NAME

6       ocf_heartbeat_apache - Manages an Apache web server instance
7

SYNOPSIS

9       apache [start | stop | status | monitor | meta-data | validate-all]
10

DESCRIPTION

12       This is the resource agent for the Apache web server. This resource
13       agent operates both version 1.x and version 2.x Apache servers.
14
15       The start operation ends with a loop in which monitor is repeatedly
16       called to make sure that the server started and that it is operational.
17       Hence, if the monitor operation does not succeed within the start
18       operation timeout, the apache resource will end with an error status.
19
20       The monitor operation by default loads the server status page which
21       depends on the mod_status module and the corresponding configuration
22       file (usually /etc/apache2/mod_status.conf). Make sure that the server
23       status page works and that the access is allowed *only* from localhost
24       (address 127.0.0.1). See the statusurl and testregex attributes for
25       more details.
26
27       See also http://httpd.apache.org/
28

SUPPORTED PARAMETERS

30       configfile
31           The full pathname of the Apache configuration file. This file is
32           parsed to provide defaults for various other resource agent
33           parameters.  (unique, optional, string, default
34           /etc/apache2/httpd.conf)
35
36       httpd
37           The full pathname of the httpd binary (optional).  (optional,
38           string, default /usr/sbin/httpd)
39
40       port
41           A port number that we can probe for status information using the
42           statusurl. This will default to the port number found in the
43           configuration file, or 80, if none can be found in the
44           configuration file. .sp
45
46           (optional, integer, no default)
47
48       statusurl
49           The URL to monitor (the apache server status page by default). If
50           left unspecified, it will be inferred from the apache configuration
51           file. .sp If you set this, make sure that it succeeds *only* from
52           the localhost (127.0.0.1). Otherwise, it may happen that the
53           cluster complains about the resource being active on multiple
54           nodes.  (optional, string, no default)
55
56       testregex
57           Regular expression to match in the output of statusurl. Case
58           insensitive.  (optional, string, default exists, but impossible to
59           show in a human readable format (try grep testregex))
60
61       client
62           Client to use to query to Apache. If not specified, the RA will try
63           to find one on the system. Currently, wget and curl are supported.
64           For example, you can set this parameter to "curl" if you prefer
65           that to wget.  (optional, string, no default)
66
67       testurl
68           URL to test. If it does not start with "http", then it's considered
69           to be relative to the Listen address.  (optional, string, no
70           default)
71
72       testregex10
73           Regular expression to match in the output of testurl. Case
74           insensitive.  (optional, string, no default)
75
76       testconffile
77           A file which contains test configuration. Could be useful if you
78           have to check more than one web application or in case sensitive
79           info should be passed as arguments (passwords). Furthermore, using
80           a config file is the only way to specify certain parameters. .sp
81           Please see README.webapps for examples and file description.
82           (optional, string, no default)
83
84       testname
85           Name of the test within the test configuration file.  (optional,
86           string, no default)
87
88       options
89           Extra options to apply when starting apache. See man httpd(8).
90           (optional, string, no default)
91
92       envfiles
93           Files (one or more) which contain extra environment variables. If
94           you want to prevent script from reading the default file, set this
95           parameter to empty string.  (optional, string, default
96           /etc/apache2/envvars)
97

SUPPORTED ACTIONS

99       This resource agent supports the following actions (operations):
100
101       start
102           Starts the resource. Suggested minimum timeout: 40s.
103
104       stop
105           Stops the resource. Suggested minimum timeout: 60s.
106
107       status
108           Performs a status check. Suggested minimum timeout: 30s.
109
110       monitor
111           Performs a detailed status check. Suggested minimum timeout: 20s.
112           Suggested interval: 10.
113
114       meta-data
115           Retrieves resource agent metadata (internal use only). Suggested
116           minimum timeout: 5.
117
118       validate-all
119           Performs a validation of the resource configuration. Suggested
120           minimum timeout: 5.
121

EXAMPLE

123       The following is an example configuration for a apache resource using
124       the crm(8) shell:
125
126           primitive p_apache ocf:heartbeat:apache \
127             op monitor depth="0" timeout="20s" interval="10"
128

AUTHOR

133       Linux-HA contributors (see the resource agent source for information
134       about individual authors)
135
136
137
138resource-agents 3.9.2             07/08/2011           OCF_HEARTBEAT_APACHE(7)