anybox.recipe.openerp
=====================

.. contents::

This is a buildout recipe to download, install and configure OpenERP.

Recipe options :
~~~~~~~~~~~~~~~~

zc.recipe.egg options
---------------------

This recipe reuses the *zc.recipe.egg* recipe, so the options are the same
(*eggs*, *interpreter*, etc.)
Consult the documentation here http://pypi.python.org/pypi/zc.recipe.egg/1.3.2

specific options
----------------

It also adds a few specific options :

 * **version**: specify the version of OpenERP
 * **url** : specify the download url for the server
 * **script_name**: specify the name of the startup script for the server

OpenERP options
---------------
You can also add the same options as the ones in the .openerp_serverrc option,
such as *netrpc_port*, *netrpc_interface*, *db_host*, *db_port*, etc.
The OpenERP server configuration is generated by OpenERP itself in the buildout
etc directory at the first buildout run.

Generated script :
~~~~~~~~~~~~~~~~~~

A startup script for the server is created in the bin/ directory. By default
the name is: start_<part_name>, so you can have several startup script for each
part if you configure several OpenERP servers. You can pass additional
arguments to the server via the startup script, such as -i or -u options.


Example buildouts:
~~~~~~~~~~~~~~~~~~

The simplest possible buildout is::

    [buildout]
    parts = openerp

    [openerp]
    recipe = anybox.recipe.openerp
    version = 6.0.2

A more robust buildout with version specifications, and 2 OpenERP servers
using only XMLRPCs and listening on 2 different ports::

    [buildout]
    parts = openerp1 openerp2
    allow-picked-versions = false
    versions = versions
    find-links = http://download.gna.org/pychart/

    [versions]
    MarkupSafe = 0.15
    PIL = 1.1.7
    anybox.recipe.openerp = 0.3
    caldav = 0.1.10
    coverage = 3.5
    distribute = 0.6.19
    feedparser = 5.0.1
    gp.vcsdevelop = 2.2.1
    lxml = 2.1.5
    mako = 0.4.1
    nose = 1.1.2
    psycopg2 = 2.4.2
    pychart = 1.39
    pydot = 1.0.25
    pyparsing = 1.5.6
    python-dateutil = 1.5
    pytz = 2011h
    pywebdav = 0.9.4.1
    pyyaml = 3.10
    reportlab = 2.5
    vobject = 0.8.1c
    z3c.recipe.scripts = 1.0.1
    zc.buildout = 1.5.2
    zc.recipe.egg = 1.3.2

    [openerp1]
    recipe = anybox.recipe.openerp
    eggs = PIL
    version = 6.0.2
    xmlrpc = False
    netrpc = False

    [openerp2]
    recipe = anybox.recipe.openerp
    eggs = PIL
    version = 6.0.2
    xmlrpc = False
    netrpc = False
    xmlrpcs_port = 8171


Contribute
~~~~~~~~~~
The primary branch is on the launchpad:

- Code repository: https://code.launchpad.net/~anybox/+junk/anybox.recipe.openerp

