It comes in the night and sucks
the essence from your computers.
Kern Sibbald
January 19, 2006
The Bacula-web program was written by Juan Luis Frances
This manual documents Bacula-web version 1.38.5 (18 January 2006)
What is Bacula-web?
Bacula-web is a php based web program that provides you a
summarized output of jobs that have already run. It obtains
its information from your Bacula catalog database. Aside from a
nice graphical display, it provides summaries of your
jobs, as well as graphs of job usage. This is a fairly high
level Bacula management tool.
- You must have a web server
- You must have PHP installed and working
with your web server. We have tested
php versions 4.3.4 and 5.0.4. For more information
on php, please see:
http://www.php.net.
- The following packages should be installed
or configured as part of PHP.
- Gettext (optional)
- GD 2.x or greater
- TrueType (optional)
- Pear DB (http://pear.php.net/package/DB)
- MySQL or PostgreSQL
- The dbsize contrib package if you use PostgreSQL
- Bacula must also be installed and working, but does not
need to be running to use Bacula-web.
- Your MySQL or PostgreSQL program must be running.
- Copy the bacula-web distribution to the root
directory or a subdirectory of your web server root.
- Edit configs/bacula.conf and put your preferences
as well as ensuring that the database configuration parameters
point to the Bacula database you are using.
- Run test.php from your web browser.
It should produce output that looks like:
Checking system for dependencies...
Checking gettext: YES Language support enabled
Checking Pear(DB): YES Pear DB enabled
Checking GD: YES GD support enabled
Please, click the link below to test your graph system capabilities (Bacula-web only use PNG):
Test
- If gettext, Pear(DB) and GD all indicate yes, then things are going
in the right direction. If not, you should correct each one before
proceeding.
- If Pear(DB) is not installed and you have PHP 4.3.11 or newer, you
can use the command:
pear install DB
to install it.
After installing it, check by doing:
pear list
On my machine (Kern), I get:
Installed packages:
===================
Package Version State
Archive_Tar 1.1 stable
Console_Getopt 1.2 stable
DB 1.7.6 stable
HTML_Template_IT 1.1 stable
HTTP 1.3.5 stable
Mail 1.1.4 stable
Net_SMTP 1.2.6 stable
Net_Socket 1.0.6 stable
Net_UserAgent_Detect 2.0.1 stable
PEAR 1.3.5 stable
XML_Parser 1.2.6 stable
XML_RPC 1.4.0 stable
- When everything is installed, click on the Test link at the
bottom, which will bring up a new page with a number of PHPlot test graphs,
using GD. It should be pretty obvious if they work, if not, you must
correct the problems.
- If your graphs are not being reproduced, check that your PHP was built
with the --with-gd option, and possibly with --with-png-dir=DIR
where DIR is the path to the libpng installation directory.
- One of the most common problem is improper configuration of the
variables in bacula.config that define the database. If you see
nothing but a blank screen or error messages, please recheck your database
definitions paying careful attention to ensure that the database name and
password are correct and that the database engine is running.
- If you get an error such as DB Error: not found assuming your
database is MySQL, try using the following command:
mysql -h<host> -u<login> -p <db_name>
where, <host>, <login>, and <db_name> are
the values you put in your bacula.conf file under the
DATABASE section as in:
[.DATABASE]
host = 192.168.1.120
login = bacula-user
pass =
db_name = bacula
db_type = mysql
in this case, the mysql command would be:
mysql -h192.168.1.120 -ubacula-user -p bacula
- If you get an error such as DB Error: connection failed assuming your
database is PostgreSQL, make sure that TCP/IP-Connections to your
bacula database are allowed via pg_hba.conf.
- If nothing seems to be working and you are using SELinix, please
remember that you must have the correct contexts for the bacula-web
files. Assuming you have installed the files in
/var/www/html/bacula-web, you can most likely fix the contexts with
a command such as:
chcon -t httpd_sys_content_t /var/www/html/bacula-web/ -R
The output from bacula-web is best viewed with a resolution of
1024x768 or better. Most browsers will produce good results including
MS Internet Explorer.
If you have configured bacula-web for a language other than English,
and the language changes are not being correctly displayed, restart
your web server.
- In the Pie graphs, the margins don't work. It is a phplot bug.
- The total elapsed time "calculation" is rudimentary. If you have 2
or more concurrent jobs this is not real.
Submit your bugs at this link:
http://indpnday.com/bacula_stuff/bacula-web/mantisbt/login_page.php.
If you want add a new language not supported by bacula-web please, follow
the following instructions:
Extract strings with this command (tsmarty2c.php is with bacula-web
package):
xgettext lang.c
Now you must have this file: messages.po
Edit messages.po to have your translations, then
send us a copy of the file.
- Bacula-web, What is
- What is Bacula-web?
- Bugs
- Bugs
- Installation
- Installation
- Notes
- Notes
- Requirements
- Requirements
- Screen Shots
- Screen Shots
- Testing the Installation
- Testing the Installation
- Translations
- Translations
- What is Bacula-web?
- What is Bacula-web?
It comes in the night and sucks
the essence from your computers.
This document was generated using the
LaTeX2HTML translator Version 2002-2-1 (1.70)
Copyright © 1993, 1994, 1995, 1996,
Nikos Drakos,
Computer Based Learning Unit, University of Leeds.
Copyright © 1997, 1998, 1999,
Ross Moore,
Mathematics Department, Macquarie University, Sydney.
The command line arguments were:
latex2html -white -no_subdir -split 0 -toc_stars -white -notransparent bacula-web
The translation was initiated by on 2006-01-19
2006-01-19