It comes in the night and sucks
the essence from your computers.
Kern Sibbald
November 22, 2005
The Bacula-web program was written by Juan Luis Frances
This manual documents Bacula-web version 1.38.2 (20 November 2005)
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.
- 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
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 2005-11-22
2005-11-22