NAME

apache - LCFG Apache component

DESCRIPTION

Simple component to start and stop a default installation of Apache.

RESOURCES

config

The config file to start httpd with. If the filename is not an absolute filename, then it is relative to the serverroot. The apache default is used it not specified, this is currently conf/httpd.conf. This resource is equivalent to httpd -f option.

conftmpl

The config template file. If this resources is set, then it will pass the template through sxprof with all apache resources defined, the resulting output will go to the file specified by config. If it is null (the default), then the existing config is not changed.

httpd

The path to the httpd to run, defaults to /usr/sbin/httpd.

lang

The LANG to run the httpd under, defaults to C.

serverroot

Sets the initial value for the ServerRoot apache directive. This can then be overridden in the config file. The apache default is used if this is not specified, this is currently /etc/httpd. This resource is equivalent to the httpd -d option.

startssl

A boolean value specifying whether the secure web server should be started, otherwise just the regular one will be. This has implications if the server requires a pass phrase, as the machine will stop at boot time waiting for the pass phrase if startssl is true and the SSL certificate requires a pass phrase.

METHODS

start

Calls apachectl start

stop

Calls apachectl stop

restart

As LCFG spec, ie calls stop then start. Not the same as apachectl restart.

ctl [params]

Calls apachectl [params]

ERRORS

It is an error if conftmpl and serverroot/config specify the same file, as data loss is likely to occur. Note the the checking isn't foolproof, and file/path names with .. in it will not work.

NOTES

As this component currently just calls the default apachectl, it will only launch httpd if the config file exists and contains no errors.

RedHat have changed apachectl to source the /etc/sysconfig/apache file for extra options. It is this file that this component updates.