Update

[bacula/docs] / docs / manual / dvd.tex

diff --git a/docs/manual/dvd.tex b/docs/manual/dvd.tex
index c2a720602344de8da3692d33fb32d1d87c6050e9..925626b8245b865884b9797ad9ba4b675b7eb404 100644 (file)
--- a/docs/manual/dvd.tex
+++ b/docs/manual/dvd.tex
@@ -1,13 +1,12 @@
 %%
 %%
 
 %%
 %%
 

-\section*{DVD Volumes}
+\chapter{DVD Volumes}

 \label{_DVDChapterStart}
 \index[general]{DVD Volumes}
 \index[general]{Writing DVDs}
 \index[general]{DVD Writing}
 \index[general]{Volumes!DVD}
 \label{_DVDChapterStart}
 \index[general]{DVD Volumes}
 \index[general]{Writing DVDs}
 \index[general]{DVD Writing}
 \index[general]{Volumes!DVD}

-\addcontentsline{toc}{section}{DVD Volumes}

 
 Bacula allows you to specify that you want to write to DVD. However,
 this feature is implemented only in version 1.37 or later.
 
 Bacula allows you to specify that you want to write to DVD. However,
 this feature is implemented only in version 1.37 or later.


@@ -34,7 +33,7 @@ The fact that Bacula cannot use the OS to write directly
 to the DVD makes the whole process a bit more error prone than
 writing to a disk or a tape, but nevertheless, it does work if you
 use some care to set it up properly. However, at the current time
 to the DVD makes the whole process a bit more error prone than
 writing to a disk or a tape, but nevertheless, it does work if you
 use some care to set it up properly. However, at the current time

-(26 August 2006) we still consider this code to be experimental and of 
+(version 1.39.30 -- 12 December 2006) we still consider this code to be

 BETA quality.  As a consequence, please do careful testing before relying
 on DVD backups in production.
 
 BETA quality.  As a consequence, please do careful testing before relying
 on DVD backups in production.
 


@@ -42,10 +41,9 @@ The remainder of this chapter explains the various directives that you can
 use to control the DVD writing.
 
 \label{DVDdirectives}
 use to control the DVD writing.
 
 \label{DVDdirectives}

-\subsection*{DVD Specific SD Directives} 
+\section{DVD Specific SD Directives} 

 \index[general]{Directives!DVD}
 \index[general]{DVD Specific SD Directives }
 \index[general]{Directives!DVD}
 \index[general]{DVD Specific SD Directives }

-\addcontentsline{toc}{subsection}{DVD Specific SD Directives}

 
 The following directives are added to the Storage daemon's
 Device resource.
 
 The following directives are added to the Storage daemon's
 Device resource.


@@ -164,10 +162,20 @@ be a name such as {\bf /dev/cdrom} or {\bf /media/cdrecorder} or
 {\bf /dev/dvd} depending on your system.  It will not be a name such
 as {\bf /mnt/cdrom}.
 
 {\bf /dev/dvd} depending on your system.  It will not be a name such
 as {\bf /mnt/cdrom}.
 

-\subsection*{Edit Codes for DVD Directives} 
+Finally, for {\bf growisofs} to work, it must be able to lock
+a certain amount of memory in RAM.  If you have restrictions on
+this function, you may have failures.  Under {\bf bash}, you can
+set this with the following command:
+
+\footnotesize  
+\begin{verbatim}
+ulimit -l unlimited
+\end{verbatim}
+\normalsize
+
+\section{Edit Codes for DVD Directives} 

 \index[general]{Directives!DVD Edit Codes}
 \index[general]{Edit Codes for DVD Directives }
 \index[general]{Directives!DVD Edit Codes}
 \index[general]{Edit Codes for DVD Directives }

-\addcontentsline{toc}{subsection}{Edit Codes for DVD Directives}

 
 Before submitting the {\bf Mount Command}, {\bf Unmount Command}, 
 {\bf Write Part Command}, or {\bf Free Space Command} directives 
 
 Before submitting the {\bf Mount Command}, {\bf Unmount Command}, 
 {\bf Write Part Command}, or {\bf Free Space Command} directives 


@@ -187,10 +195,9 @@ following characters:
 
 
 
 
 
 

-\subsection*{DVD Specific Director Directives} 
+\section{DVD Specific Director Directives} 

 \index[general]{Directives!DVD}
 \index[general]{DVD Specific Director Directives }
 \index[general]{Directives!DVD}
 \index[general]{DVD Specific Director Directives }

-\addcontentsline{toc}{subsection}{DVD Specific Director Directives}

 
 The following directives are added to the Director's Job resource.
     
 
 The following directives are added to the Director's Job resource.
     


@@ -219,12 +226,25 @@ The following directives are added to the Director's Job resource.
 
 
 \label{DVDpoints}
 
 
 \label{DVDpoints}

-\subsection*{Other Points}
+\section{Other Points}

 \index[general]{Points!Other }
 \index[general]{Other Points }
 \index[general]{Points!Other }
 \index[general]{Other Points }

-\addcontentsline{toc}{subsection}{Other Points}

 
 \begin{itemize}
 
 \begin{itemize}

+\item Please be sure that you have any automatic DVD mounting
+   disabled before running Bacula -- this includes auto mounting
+   in /etc/fstab, hotplug, ...  If the DVD is automatically
+   mounted by the OS, it will cause problems when Bacula tries
+   to mount/unmount the DVD.
+\item Please be sure that you the directive {\bf Write Part After Job}
+   set to {\bf yes}, otherwise the last part of the data to be
+   written will be left in the DVD spool file and not written to
+   the DVD. The DVD will then be unreadable until this last part
+   is written.  If you have a series of jobs that are run one at
+   a time, you can turn this off until the last job is run.
+\item The current code is not designed to have multiple simultaneous
+   jobs writing to the DVD.  As a consequence, please ensure that
+   only one DVD backup job runs at any time.

 \item Writing and reading of DVD+RW seems to work quite reliably
    provided you are using the patched dvd+rw-mediainfo programs.
    On the other hand, we do not have enough information to ensure
 \item Writing and reading of DVD+RW seems to work quite reliably
    provided you are using the patched dvd+rw-mediainfo programs.
    On the other hand, we do not have enough information to ensure


@@ -292,7 +312,7 @@ To add additional files (more parts use):
 
 The option {\bf -use-the-force-luke=4gms} was added in growisofs 5.20 to
 override growisofs' behavior of always checking for the 4GB limit.
 
 The option {\bf -use-the-force-luke=4gms} was added in growisofs 5.20 to
 override growisofs' behavior of always checking for the 4GB limit.

-Normally, this option is recommended for all Linux kernels 2.6.8 or
+Normally, this option is recommended for all Linux 2.6.8 kernels or

 greater, since these newer kernels can handle writing more than 4GB.
 See below for more details on this subject.
 
 greater, since these newer kernels can handle writing more than 4GB.
 See below for more details on this subject.