anybox.recipe.openerp 1.1.5

eggs

Starting from version 0.16 of the recipe, you don’t need to put anything in this option by default. But you may specify additional eggs needed by addons, or just useful ones:

eggs =
    ipython
    openobject-library

scripts

The behaviour of this option is slightly modified : by default, no script other than those directly related to OpenERP are generated, but you may specify some explicitely, with the same semantics as the normal behaviour (we simply set an empty default value, which means to not produce scripts):

scripts =
    change_tz

In the current state, beware to not require the same script in different parts or rename them. See https://bugs.launchpad.net/anybox.recipe.openerp/+bug/1020967 for details.

interpreter

This is the default interpreter option of zc.recipe.egg that specifies the name of the Python interpreter that shoud be included in the bin directory of the buildout:

interpreter = erp_python

version

Specifies the OpenERP version to use. It can be:

The version number of an official OpenERP (server, web client or gtk client):

version = 6.0.3

A custom download:

version = url http://example.com/openerp.tar.gz

An absolute or a relative path:

version = path /my/path/to/a/custom/openerp

A custom bzr, hg, git or svn branch or repository. The syntax is the same as the addons option (see below):

version = bzr lp:openobject-server/6.1 openerp61 last:1

A nightly build:

version = nightly 6.1 20120814-233345

or (dangerously unpinned version):

version = nightly 6.1 latest

or even more dangerous:

version = nightly trunk latest

addons

Specifies additional OpenERP addons, either a local path or a repository.

Example:

addons = local ../some/relative/path/for/custom_addons/
         local /some/other/absolute/path/for/custom_addons
         bzr lp:openobject-addons/trunk/    addons0 last:1
         hg  http://example.com/some_addons addons1 default
         git http://example.com/some_addons addons2 master
         svn http://example.com/some_addons addons3 head
         bzr lp:openerp-web/trunk/ openerp-web last:1 subdir=addons

When using local paths you can either specify a directory holding addons, or a single addon. In that latter case, it will be actually placed one directory below.

For remote repositories, the syntax is:

TYPE URL DESTINATION REVISION [OPTIONS]

• TYPE can be bzr, hg, git or svn

• URL is any URL scheme supported by the versionning tool

• DESTINATION is the local directory that will be created (relative or absolute)

• REVISION is any version specification supported (revision, tag, etc.)

• OPTIONS take the form name=value. Currently, only the subdir option is recognized. If used, the given subdirectory of the repository is registered as an addons directory.

Repositories are updated on each build according to the specified revision. You must be careful with the revision specification.

Buildout offline mode is supported. In that case, update to the specified revision is performed, if the VCS allows it (Subversion does not).

script_name

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

You can choose another name for the script by using the script_name option

script_name = start_erp

startup_delay

Specifies a delay in seconds to wait before actually launching OpenERP. This option was a preliminary hack to support both gunicorn instance and a legacy instance. The Gunicorn startup script (see below) itself is not affected by this setting

startup_delay = 3

with_devtools

Allows to load development and useful testing tools, such as anybox.testing.datetime. False by default:

with_devtools = true

base_url

URL from which to download official and nightly versions (assuming the archive filenames are constistent with those in OpenERP download server). This is a basic mirroring capability:

base_url = http://download.example.com/openerp/

openerp-downloads-directory

Allows to share OpenERP downloads among several buildouts. You should put this option in your ~/.buildout/default.cfg file. It specifies the destination download directory for OpenERP archives. The path may be absolute or relative to the buildout directory.

Example:

[buildout]
openerp-downloads-directory = /home/user/.buildout/openerp-downloads

gunicorn

Gunicorn integration is only supported on OpenERP >= 6.1. This option makes the recipe generate a script to start OpenERP with Gunicorn and (new in version 1.1) a dedicated script to handle cron jobs.

It currently support two values: direct and proxied

gunicorn = direct

gunicorn = proxied

gunicorn.workers = 8

gunicorn.workers = 4
gunicorn.timeout = 240
gunicorn.max_requests = 2000

OpenERP options

You can define OpenERP options directly from the buildout file. The OpenERP configuration files are generated by OpenERP itself in the etc directory of the buildout during the first Buildout run. You can overwrite these options from the recipe section of your buildout.cfg. The options in the buildout file must be written using a dotted notation prefixed with the name of the corresponding section of the OpenERP config file. The specified options will just overwrite the existing options in the corresponding config files. You don’t have to replicate all the options in your buildout.cfg. If an option or a section does not natively exist in the openerp config file, it can be created from there for your application.

For example you can specify the xmlrpc port for the server or even an additional option that does not exist in the default config file:

options.xmlrpc_port = 8069
options.additional_option = "foobar"

It will end-up in the server config as:

[options]
xmlrpc_port = 8069
additional_option = "foobar"

For the web client you can specify the company url with:

global.server.socket_port = 8080
openerp-web.company.url = 'http://anybox.fr'

It will modify the corresponding web client config:

[global]
server.socket_port = 8080

[openerp-web]
company.url = 'http://anybox.fr'

Creating the buildout

Create a buildout.cfg file in an empty directory, containing the configuration of the example 6.1 section.

Installing build dependencies

You basically need typical development tools needed to build all the Python dependency eggs of OpenERP. You can do this by yourself with your system or Linux distribution.

Or if you’re using a Debian system, we provide a single dependency package you can use to install all dependencies in one shot:

Add the following line in your /etc/apt/sources.list:

deb http://apt.anybox.fr/openerp common main

Install the dependency package:

$ sudo aptitude update
$ sudo aptitude install openerp-server-system-build-deps

You can uninstall this package with aptitude after the build to automatically remove all un-needed dependencies.

Bootstrapping the buildout

Bootstrapping the buildout consists in creating the basic structure of the buildout, and installing buildout itself in the directory.

The easiest and recommended way to bootstrap is to use a bootstrap.py script:

$ wget https://raw.github.com/buildout/buildout/master/bootstrap/bootstrap.py
$ python bootstrap.py

As an alternative and more complicated solution, you may also bootstrap by creating a virtualenv, installing zc.buildout, then run the bootstrap:

$ virtualenv sandbox
$ sandbox/bin/pip install zc.buildout
$ sandbox/bin/buildout bootstrap

Running the build

Just run

$ bin/buildout

Starting OpenERP

Just run

$ bin/start_openerp

1.1.5 (14-10-2012)

• Improved documentation (bootstrap and sample buildouts)

• Re-enabled support for trunk nightly (and maybe 7.0 final)

• fixed a packaging problem with openerp-cron-worker in 1.1.4

1.1.3 (26-09-2012)

• launchpad #1041231: Resilience to changes of bzr locations

• launchpad #1049519: openerp-cron-worker startup script

• launchpad #1025144: By default, admin passwd is now disabled

• launchpad #1054667: Problem with current dev nightlies for OpenERP 6.2

• fixed a packaging problem with openerp-cron-worker in 1.1.2

1.0.3 (24-08-2012)

• no actual difference with 1.0 (only changelogs and the like)

1.0 (24-08-2012)

• launchpad #1040011: works with current OpenERP trunk (future 7.0)

• launchpad #1027994: ‘base_url’ option, to download from mirrors

• launchpad #1035978: restored ‘local’ version scheme for OpenERP itself. Also implemented the ‘url’ version scheme.

• removed deprecated renaming of 6.1 to 6.1-1

• Refactored the documentation

0.17 (07-08-2012)

• launchpad #1033525: startup_delay option

• launchpad #1019888: Gunicorn integration.

• launchpad #1019886: installation of ‘openerp’ as a develop distribution, and full python server startup script.

• launchpad #1025617: Support for nightly versions in 6.1 series

• launchpad #1025620: Support for latest version

• launchpad #1034124: Fix interference of buildout options with gtkclient recipe

• launchpad #1021083: optional development tools loading in startup script

• launchpad #1020967: stop creating scripts by default

• launchpad #1027986: Better handling of interrupted downloads

0.16 (29-06-2012)

• launchapd #1017252: relying on Pillow to provide PIL unless PIL is explicitely wanted.

• launchpad #1014066: lifted the prerequirement for Babel. Now the recipe installs it if needed before inspection of OpenERP’s setup.py

0.15 (14-06-2012)

• launchpad #1008931: Mercurial pull don’t take URL changes into account. Now the recipe manages the repo-local hgrc [paths] section, updates the default paths while storing earlier values

• launchpad #1012899: Update problems with standalone vcs addons

• launchpad #1005509: Now bzr branches are stacked only if

  bzr-stacked-branches option is set to True.

0.14.1 (17-05-2012)

• launchpad #1000352: fixed a concrete problem in Bzr reraising

0.14 (17-05-2012)

• launchpad #1000352: option vcs-clear-retry to retrieve from scratch in case of diverged Bzr branches. Raising UpdateError in right place would trigger the same for other VCSes.

• Basic tests for Git and Svn

• Refactor with classes of VCS package

0.13.1 (14-05-2012)

• launchpad #997107: fixed vcs-clear-locks option for bzr, that requires a user confirmation that cannot be bypassed in older versions

0.13 (14-05-2012)

• launchpad #998404: more robust calls to hg and bzr (w/ unit tests), and have exception raised if vcs call failed (break early, break often).

• launchpad #997107: vcs-clear-locks option (currently interpreted by Bzr only)

0.12 (02-05-2012)

• launchpad #993362: addons subdir option, and made repositories being one addon usable by creating an intermediate directory.

0.11 (18-04-2012)

• Faster tarball inspection (see lp issue #984237)

• Shared downloads and more generally configurable downloads directory, see https://blueprints.launchpad.net/anybox.recipe.openerp/+spec/shared-downloads

0.10 (02-04-2012)

• fixed the sample buildouts in the readme file

0.9 (23-03-2012)

• Clean-up and refactoring

• Removed url option (download url supported through version)

• Support OpenERP 6.1 and 6.0

• Added an ‘addons’ option allowing remote repositories and local directories

• Improved error messages

• Updated the documentation

• Handle bad Babel import in setup.py

• Support offline mode of buildout

• Create gtk client config without starting it

0.8 (20-12-2011)

• handle deploying custom bzr branches

0.7 (14-09-2011)

• handle new sections in openerp config

0.6 (11-09-2011)

• Overwrite config files each time

• Make the “dsextras” error more explicit (install PyGObject and PyGTK)

• fixed some deps

• improved the doc

0.5 (10-08-2011)

• Use dotted notation to add openerp options in the generated configs

0.4 (09-08-2011)

• Added support for the web client and gtk client

0.3 (08-08-2011)

• fixed config file creation

0.2 (08-08-2011)

• Pass the trailing args to the startup script of the server

0.1 (07-08-2011)

• Initial implementation for the OpenERP server only