97 lines
3.3 KiB
Plaintext
97 lines
3.3 KiB
Plaintext
$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
|