$\includegraphics{./bacula-logo.eps}$

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.

Requirements

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.

Installation

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.

Testing the Installation

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

Screen Shots

$\includegraphics{./bweb-index.eps}$
$\includegraphics{./bweb-report.eps}$

Notes

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.

Bugs

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.

Translations

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):
$./tsmarty2c.php templates \gt{} lang.c\\$ 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.

General Index

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?

About this document ...

$\includegraphics{./bacula-logo.eps}$

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)

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

$\includegraphics{./bacula-logo.eps}$

It comes in the night and sucks the essence from your computers.

Contents

List of Figures

List of Tables

What is Bacula-web?

Requirements

Installation

Testing the Installation

Screen Shots

Notes

Bugs

Translations

General Index

About this document ...