]> git.sur5r.net Git - bacula/docs/blobdiff - docs/manual/dvd.tex
Update
[bacula/docs] / docs / manual / dvd.tex
index e93a5d5f8429e1d95eee7f9796a5c3be2ff4c1b4..925626b8245b865884b9797ad9ba4b675b7eb404 100644 (file)
@@ -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}
-\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.
@@ -27,14 +26,14 @@ NOT} work with Bacula.  You must apply a patch which can be found in the
 {\bf patches} directory of Bacula sources with the name
 {\bf dvd+rw-tools-5.21.4.10.8.bacula.patch} for version 5.21 of the tools,
 or patch {bf dvd+rw-tools-6.1.bacula.patch} if you have version 6.1       
-on your system. Unfortunately, this requires you to build the dvd_rw-tools
+on your system. Unfortunately, this requires you to build the dvd\_rw-tools
 from source.
 
 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
-(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.
 
@@ -42,10 +41,9 @@ The remainder of this chapter explains the various directives that you can
 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 }
-\addcontentsline{toc}{subsection}{DVD Specific SD Directives}
 
 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}.
 
-\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 }
-\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 
@@ -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 }
-\addcontentsline{toc}{subsection}{DVD Specific Director Directives}
 
 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}
-\subsection*{Other Points}
+\section{Other Points}
 \index[general]{Points!Other }
 \index[general]{Other Points }
-\addcontentsline{toc}{subsection}{Other Points}
 
 \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
@@ -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.
-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.