tl.buildout_apache 0.1.1

zc.buildout recipes for setting up an Apache web server environment.

This is a collection of zc.buildout recipes for setting up an Apache web server environment. It provides the following entry points:

httpd:

Builds the Apache HTTP server software from source.

root:

Configures an Apache server root (an instance in Zope speak).

These recipes appear to be reliable, but the feature set is basically determined by the author’s immediate needs. Don’t hesitate to send questions, bug reports, suggestions, or patches to <[e-mail]>.

The build recipe: tl.buildout_apache:httpd

None of the options described below are required: they either have sensible defaults or are computed by the recipe. You may override any of them.

Configuration options:

url:

Where to get the source distribution.

md5sum:

MD5 checksum of the source distribution.

extra-options:

Extra configure options, appended to the ./configure command line.

extra-vars:

Extra environment variables for ./configure, make, and make install calls.

Exported options:

httpd-path:

Absolute file system path to the httpd executable.

envvars-path:

Absolute file system path to the envvars script.

apxs-path:

Absolute file system path to the apxs executable.

module-dir:

Absolute file system path to the shared modules directory.

htdocs:

Absolute file system path to the document directory distributed with the Apache server, containing the welcome page.

builtin-modules:

Space-separated list of all modules compiled into the httpd executable. Names are stripped of any mod_, _module , and .so bits.

The server root recipe: tl.buildout_apache:root

An Apache server process configured with this recipe will run the “prefork” multi-processing module.

None of the options described below are required: they either have sensible defaults or are computed by the recipe. You may override any of them.

Configuration options:

httpd:

The name of a buildout section for an httpd installation, defaults to “httpd”. It must export the following options:

• httpd-path

• envvars-path

• apxs-path

• module-dir

ulimit:

Command to increase the maximum allowed number of file descriptors per child process.

conf-dir:

Absolute file system path to the system configuration directory, e.g. /etc. It is used to find MIME configuration files.

lynx-path:

Absolute file system path to the lynx executable.

user:

User name to run the server as (if starting it as root).

group:

Group name to run the server as (if starting it as root).

listen:

Interfaces and ports to listen at, such as 127.0.0.1:80.

modules:

Names of shared modules to load, e.g. “dir” or “rewrite”.

servername:

Server name to announce, e.g. localhost:80.

serveradmin:

E-mail address of the server administrator.

htdocs:

Absolute file system path to the document root.

cgi-bin:

Absolute file system path to the CGI library directory.

extra-config:

Arbitrary multi-line server configuration.

config-parts:

Names of buildout sections with further configuration. The following options exported from config parts are recognized:

• config-parts (included recursively)

• modules

• extra-config