Configuration
*************

Supported options
=================

The recipe supports the following options:

mainconfig
    location of apache configuration (ex: /etc/apache2/apache2.conf). if no
    value is provided we use the location of the config file from build recipe

bind
    Hostname and port on which Apache will listen for requests.
    Syntax is [hostname][:port].  Defaults to 80.
    If hostname is omitted then Apache will bind to all available
    interfaces.

backends
    Specifies the backend or backends which will process the
    requests. The syntax for backends:

    <hostname>[/<path>]:<ip address>:<port>

    If multiple backends are specified then each backend must include
    a hostname.

zope2_vhm_map
    zope2_vhm_map
    Defines a virtual host mapping for Zope servers. This is a list of
    **hostname:ZODB location** entries which specify the location inside
    Zope where the website for a virtual host lives.
    The syntax for zope servers:

    <hostname>:<path>


Example usage
=============



We'll start by creating a buildout that uses the recipe::

    >>> write('buildout.cfg',
    ... """
    ... [buildout]
    ... parts = apacheconfig
    ...
    ... [apacheconfig]
    ... recipe = plone.recipe.apache:config
    ... mainconfig = /usr/local/apache/config/httpd.conf
    ... bind = 80
    ... backends = plone.org:127.0.0.1:3128
    ... zope2_vhm_map = plone.org:/plone
    ... """)

Running the buildout gives us::


    >>> print system(buildout)
    Installing apacheconfig.
    ...

