$OpenBSD: README,v 1.10 2012/06/21 07:00:20 ajacoutot Exp $

+-----------------------------------------------------------------------
| Running ${FULLPKGNAME} on OpenBSD
+-----------------------------------------------------------------------

Webacula has been installed into ${INSTDIR}

*** Upgrading users: refer to the "Update from prior version" section in
*** ${INSTDIR}/docs/txt/install.txt

Database creation
=================

Webacula can work with a PostgreSQL, MySQL or SQLite3 database.
Support for SQLite3 is included with the main php package; to use
another database, the corresponding package needs to be installed:
    php-pdo_pgsql or php-pdo_mysql

To add the webacula DB tables, run the following commands according to
the RDBMS that bacula(8) uses. Note that prior to run these commands,
you will have to ajust at least "db_name", "db_user", "db_pwd" and
"webacula_root_pwd" in ${INSTDIR}/install/db.conf.
Also note that the scripts can take arguments and you must use the
already available bacula user for connecting to the database.

* change to the directory matching your DB (PostgreSql, MySql or SqLite)
    # cd ${INSTDIR}/install/PostgreSql

* run the included scripts to create the webacula tables
    # ./10_make_tables.sh -U bacula
    # ./20_acl_make_tables.sh -U bacula

When using SQLite3, make sure that the "www" user|group has write access
to the directory containing the DB as well as the DB file itself.

Running Webacula under chroot(8)ed Apache
=========================================

Under OpenBSD, the default Apache runs chrooted under /var/www.
Since Webacula needs to access the bconsole(8) binary we will need to
copy it in the chroot along with the required libs and configuration.
To do so, run the following command:
    # ${INSTDIR}/webacula-chroot-bconsole enable

(note that you will have to run this command again when the bacula
package is updated)

With Apache, AllowOverride settings are required on the ${INSTDIR}
directory. You can configure this as follows:
    # ln -s ${PREFIX}/conf/modules.sample/webacula.conf \
        /var/www/conf/modules

Webacula setup and configuration
================================

While upstream install notes are available with this package in:
    ${INSTDIR}/docs/INSTALL
we advise you to follow the following instructions that were written
specifically for OpenBSD.

Webacula configuration itself is done in
    ${INSTDIR}/application/config.ini

Under [general] you need to configure the way you will connect to the
bacula(8) catalog DB. When using SQLite3, make sure the bacula(8) DB
is available from the chroot(8).
Then you may want to adapt "def.timezone" according to your current
location.

Under [webacula] you may want to adapt "email.to_admin" and "email.from"
according to your site.

After restarting your webserver, you can access webacula at:
    http://<hostname>/webacula/

The built-in admin username is "root" and the password is the one you
configured in "webacula_root_pwd" (${INSTDIR}/install/db.conf).

Bacula messages configuration
=============================

To show messages of the Job output, you must change the "catalog' line
from the "Messages" block in ${SYSCONFDIR}/bacula/bacula-dir.conf to
read:
    catalog = all, !skipped, !saved

i.e.
Messages {
  Name = Standard
  <snip>
  catalog = all, !skipped, !saved
}

Then reload bacula-dir(8):
    # ${RCDIR}/bacula_dir reload