%%
%%

\section*{GUI Programs}
\label{_GUIChapter}
\index[general]{GUI Programs }
\index[general]{Programs!GUI }
\addcontentsline{toc}{section}{GUI Programs}

This document briefly describes the GUI programs that work with Bacula.
The GUI programs that are currently available are:
\begin{description}
\item [bimagemgr]
   \index[general]{bimagemgr}
   Bimagemgr is a web based interface written in Perl that monitors
   disk Volumes intended to be written to CDROM. 

   For more information on bimagemgr, please see below.

\item [bwx-console]
   \index[general]{bwx-console}
   bwx-console is a graphical console interface written in wxWidgets
   and available on all client platforms. bwx-console allows you to
   do anything you can do in the standard tty console and in addition
   has a graphic tree based point and click restore feature.

\item [gnome-console]
   \index[general]{gnome-console}
   The gnome-console is a graphical console interface available on
   systems that support Gnome 2.x. Although it runs in its own
   graphical window and permits all the standard console commands,
   it has almost no additional graphical features implemented.

   For more information on gnome-console, please consult the
   \ilink{Console Chapter}{_ConsoleChapter} of this manual.

\item [tray-monitor]
   \index[general]{tray-monitor}
   The tray-monitor is a daemon monitoring program that resides
   in the system tray on Gnome and KDE systems. It is a monitor
   program that will show you the status of any daemon. It is not
   a program for interfacing to the console.

   For more information, please see 
   \ilink{Configuring the Monitor Program}{_MonitorChapter} chapter
   this manual.

\item [bacula-web]
   \index[general]{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 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.

\end{description}
    

\subsection*{bimagemgr}
\label{bimagemgr}
\index[general]{Bimagemgr }
\addcontentsline{toc}{subsection}{bimagemgr}

{\bf bimagemgr} is a utility for those who backup to disk volumes in order to
commit them to CDR disk, rather than tapes. It is a web based interface
written in Perl and is used to monitor when a volume file needs to be burned to
disk. It requires: 

\begin{itemize}
\item A web server running on the bacula server 
\item A CD recorder installed and configured on the bacula server 
\item The cdrtools package installed on the bacula server. 
\item perl, perl-DBI module, and either DBD-MySQL or DBD-PostgreSQL modules 
   \end{itemize}

SQLite databases and DVD burning are not supported by {\bf bimagemgr} at this
time, but both are planned for future releases. 

\subsubsection*{bimagemgr installation}
\index[general]{bimagemgr!Installation }
\index[general]{bimagemgr Installation }
\addcontentsline{toc}{subsubsection}{bimagemgr Installation}

Please see the README file in the bimagemgr directory of the distribution for
instructions. 

\subsubsection*{bimagemgr usage}
\index[general]{bimagemgr!Usage }
\index[general]{bimagemgr Usage }
\addcontentsline{toc}{subsubsection}{bimagemgr Usage}

Calling the program in your web browser, e.g. {\tt
http://localhost/cgi-bin/bimagemgr.pl} will produce a display as shown below
in Figure 1. The program will query the bacula database and display all volume
files with the date last written and the date last burned to disk. If a volume
needs to be burned (last written is newer than last burn date) a "Burn"
button will be displayed in the rightmost column. 

\addcontentsline{lof}{figure}{Bacula CD Image Manager}
\includegraphics{./bimagemgr1.eps} \\Figure 1 

Place a blank CDR disk in your recorder and click the "Burn" button. This will
cause a pop up window as shown in Figure 2 to display the burn progress. 

\addcontentsline{lof}{figure}{Bacula CD Image Burn Progress Window}
\includegraphics{./bimagemgr2.eps} \\Figure 2 

When the burn finishes the pop up window will display the results of cdrecord
as shown in Figure 3. Close the pop up window and refresh the main window. The
last burn date will be updated and the "Burn" button for that volume will
disappear. Should you have a failed burn you can reset the last burn date of
that volume by clicking its "Reset" link. 

\addcontentsline{lof}{figure}{Bacula CD Image Burn Results}
\includegraphics{./bimagemgr3.eps} \\Figure 3 

In the bottom row of the main display window are two more buttons labeled
"Burn Catalog" and "Blank CDRW". "Burn Catalog" will place a copy of
your bacula catalog on a disk. If you use CDRW disks rather than CDR then
"Blank CDRW" allows you to erase the disk before re-burning it. Regularly
committing your backup volume files and your catalog to disk with {\bf
bimagemgr} ensures that you can rebuild easily in the event of some disaster
on the bacula server itself. 
