Create separate bimagemgr manual document.

diff --git a/docs/manual/Makefile.in b/docs/manual/Makefile.in
index a7755da5798f43a7f3bf7a5cba900f5fac7f47f9..3ccedb714842ab25542330e3b0c57b8b637cac75 100644 (file)
--- a/docs/manual/Makefile.in
+++ b/docs/manual/Makefile.in
@@ -41,16 +41,19 @@ tex:
        makeindex bacula.sdx -o bacula.snd >/dev/null 2>/dev/null
        makeindex bacula.cdx -o bacula.cnd >/dev/null 2>/dev/null
        -latex -interaction=batchmode bacula.tex
+       -latex -interaction=batchmode bimagemgr.tex
 
 pdf:
        @echo "Making pdfm"
        @cp -fp ${IMAGES}/hires/*.eps .
        dvipdfm -p a4 bacula.dvi
+       dvipdfm -p a4 bimagemgr.dvi
 
 dvipdf:
        @echo "Making dvi to pdf"
        @cp -fp ${IMAGES}/hires/*.eps .
        dvipdf bacula.dvi bacula.pdf
+       dvipdf bimagemgr.dvi bimagemgr.pdf
 
 html:
        @echo " "

diff --git a/docs/manual/bimagemgr-chapter.tex b/docs/manual/bimagemgr-chapter.tex
new file mode 100644 (file)
index 0000000..df05703
--- /dev/null
+++ b/docs/manual/bimagemgr-chapter.tex
@@ -0,0 +1,68 @@
+%%
+%%  
+
+\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. 

diff --git a/docs/manual/bimagemgr.tex b/docs/manual/bimagemgr.tex
new file mode 100644 (file)
index 0000000..ef5bb55
--- /dev/null
+++ b/docs/manual/bimagemgr.tex
@@ -0,0 +1,56 @@
+%%
+%%
+%%  The following characters must be preceded by a backslash
+%%    to be entered as printable characters:
+%%
+%%   # $ % & ~ _ ^ \ { }
+%%
+
+\documentclass[11pt,a4paper]{book}
+\usepackage{html}
+\usepackage{float}
+\usepackage{graphicx}
+\usepackage{bacula}
+\usepackage{longtable}
+\usepackage{makeidx}
+\usepackage{index}
+\usepackage{setspace}
+\usepackage{hyperref}
+
+\sloppy
+
+\begin{document}
+\sloppy
+
+\newfont{\bighead}{cmr17 at 36pt}
+\parskip 10pt
+\parindent 0pt
+
+\title{\includegraphics{./bacula-logo.eps} \\ \bigskip
+  \begin{center}
+   \large{It comes in the night and sucks 
+          the essence from your computers. }
+  \end{center}
+}
+\author{Kern Sibbald}
+\date{\vspace{1.0in}\today \\
+      This manual documents Bacula bimagemgr version \input{version} \\
+      \vspace{0.2in}\\
+      Copyright \copyright 1999-2006, Kern Sibbald \\
+      \vspace{0.2in}\\
+      This manual may be included without modification in a \\
+      packaged release for use with Bacula, or it may be copied \\
+      for your own or company use, and it may be cited in small \\
+      parts for presentation purposes. It may not be published \\
+      for sale in any form, other than small citations, without \\
+      express written permission from the author. 
+}
+
+\maketitle
+
+\clearpage
+
+\markboth{Bacula Manual}{}
+\include{bimagemgr-chapter}
+
+\end{document}