Metadata-Version: 1.0
Name: plone.recipe.apache
Version: 0.1.0
Summary: An zc buildout for bulid and configure apache
Home-page: https://svn.plone.org/svn/collective/buildout/plone.recipe.apache
Author: Paris sprint 2008
Author-email: UNKNOWN
License: ZPL
Description: .. contents::
        
        .. Note to recipe author!
        ---------------------
        Update the following URLs to point to your:
        
        - code repository
        - bug tracker
        - questions/comments feedback mail
        (do not set a real mail, to avoid spams)
        
        Or remove it if not used.
        
        - Code repository: http://svn.somewhere.com/...
        - Questions and comments to somemailing_list
        - Report bugs at http://bug.somewhere.com/...
        
        
        Change history
        **************
        
        trunk (2008-04-26)
        ==================
        
        - xxx [Ingeniweb]
        
        0.1.0 (2008-04-27)
        ==================
        
        - Created recipe with ZopeSkel [Paris sprint 2008].
        
        Detailed Documentation
        **********************
        
        Building
        ********
        
        Supported options
        =================
        
        The recipe supports the following options:
        
        url
        URL for an archive containing the Squid sources. Either **url** or
        **svn** has to be specified.
        
        svn
        URL for a subversion repository containing Aapache sources. Either **url**
        or **svn** has to be specified.
        
        modules
        Here you you can specify the extra modules that you want apache to be compiled with. Each module goes in
        one line. The module name will be appended to the configure statement with "--enable-<module>".
        
        
        Example usage
        =============
        
        We'll start by creating a buildout that uses the recipe::
        
        >>> write('buildout.cfg',
        ... """
        ... [buildout]
        ... parts = apachebuild
        ...
        ... [apachebuild]
        ... recipe = plone.recipe.apache:build
        ... url = http://mir2.ovh.net/ftp.apache.org/dist/httpd/httpd-2.2.8.tar.gz
        ... """ )
        
        Running the buildout gives us::
        
        >>> print system(buildout)
        Installing apachebuild.
        apachebuild: Downloading apache tarball.
        apachebuild: Compiling Apache
        ...
        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.
        ...
        
        
        Contributors
        ************
        
        Paris sprint 2008, Author
        Carsten Rebbien
        Youenn Boussard
        
        
        Download
        ********
        
Keywords: plone recipe apache configure
Platform: UNKNOWN
Classifier: Framework :: Buildout
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: Zope Public License
