From 2ee8399aca1c345469e3f695ce93cad4f6b7f3d3 Mon Sep 17 00:00:00 2001 From: Scott Barninger Date: Sun, 14 May 2006 13:46:26 +0000 Subject: [PATCH] Create separate bimagemgr manual document. --- docs/manual/Makefile.in | 3 ++ docs/manual/bimagemgr-chapter.tex | 68 +++++++++++++++++++++++++++++++ docs/manual/bimagemgr.tex | 56 +++++++++++++++++++++++++ 3 files changed, 127 insertions(+) create mode 100644 docs/manual/bimagemgr-chapter.tex create mode 100644 docs/manual/bimagemgr.tex diff --git a/docs/manual/Makefile.in b/docs/manual/Makefile.in index a7755da5..3ccedb71 100644 --- 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 index 00000000..df057032 --- /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 index 00000000..ef5bb559 --- /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} -- 2.39.5