$OpenBSD: README,v 1.4 2015/07/18 06:15:08 ajacoutot Exp $

+-----------------------------------------------------------------------
| Running py-buildbot-0.8.12p5 on OpenBSD
+-----------------------------------------------------------------------

On OpenBSD, the BuildBot package has an associated _buildbot user for
running the master.  The default master directory is expected to be
found in /var/buildbot.  Before being run for the first time, the
master directory must be initialized.  This is done as follows:

    # su -m _buildbot -c "buildbot create-master /var/buildbot"

The next step is to create a /var/buildbot/master.cfg configuration
file that fits your needs.  Please refer to the BuildBot documentation
on how to do so. 


Databases
=========
BuildBot supports number of different databases (via SQLAlchemy), but
you need to install Python database adapter(s) to use them:
* py-mysql - for MySQL database, 
* py-psycopg2 - for PostgreSQL database.

SQLite works out-of-the-box.


Upgrading
=========
If you're upgrading SQLite-based BuildBot from older release, you must
migrate its database before the first run using following command:

    # su -m _buildbot -c "buildbot upgrade-master /var/buildbot"

If you're using BuildBot with either MySQL or PostgreSQL database, you
must also pass the connection string:

    # su -m _buildbot -c "buildbot upgrade-master \
           --db=postgresql://buildbot:<password>@localhost/buildbot /var/buildbot"
