$OpenBSD: README,v 1.2 2011/06/22 08:19:12 ajacoutot Exp $

+-----------------------------------------------------------------------
| Running trytond-2.2.1 on OpenBSD
+-----------------------------------------------------------------------

Note that to produce graphs the py-dot package needs to be installed;
the dependency is not enforced because it requires graphviz which
depends on lots of graphical packages.

Before starting the trytond server, several steps are required.

Configuration
=============
Edit /etc/trytond.conf based on your configuration and needs.
The "db_password" and "admin_passwd" MUST be changed.

PostgreSQL
==========
Trytond uses a PostgreSQL database to store its data. Dependency is not
enforced because the database can run on another machine.

Assuming you have an administrative account named `postgres', you can
create the 'tryton' user like this:
    # createuser -U postgres --pwprompt --no-superuser --createdb \
        --no-createrole tryton

Make sure to set the 'tryton' DB user password to the value of
"db_password" in /etc/trytond.conf.

First start
===========
Start the trytond server:
    # /etc/rc.d/trytond start

Database initialization
-----------------------
There are 2 ways to initialize the 'tryton' database.

1. Start directly the tryton client, then go under:
    File -> Database -> New Database
to initialise your new DB.

2. Manually initialize the DB on the server itself:
    # createdb -U postgres -E UNICODE -O tryton -T template0 tryton
    # trytond -i all -d tryton

When the "Admin Password Confirmation" is requested, make sure to match
the value of "admin_passwd" in /etc/trytond.conf.

The /var/log/trytond file can grow very marge with time, it is advised
to use newsyslog(8) to rotate it.

Modules installation
====================
Several trytond-module packages are available in OpenBSD. Just running
pkg_add(1) is not enough, they need to get installed into the database
itself.
    # trytond -i all -d tryton

This can instead be done directly from the tryton client as well if
prefered.

Upgrades
========
After upgrading to a new major version of trytond, the database needs to
be updated.
    # trytond -u all -d tryton

Documentation
=============
http://code.google.com/p/tryton/wiki/TableOfContents
http://www.tryton.org/documentation.html
