From 994d709cd4d9636a7f778ff039dd7eba32071263 Mon Sep 17 00:00:00 2001 From: Kern Sibbald Date: Tue, 5 Sep 2006 19:57:59 +0000 Subject: [PATCH] Update --- docs/manual/console.tex | 12 +++++++-- docs/manual/dvd.tex | 57 ++++++++++++++++++++++++++++++++++++++--- docs/manual/fileset.tex | 2 +- docs/manual/progs.tex | 15 ++++++++--- docs/manual/tls.tex | 19 ++++++++++---- docs/manual/version.tex | 2 +- 6 files changed, 90 insertions(+), 17 deletions(-) diff --git a/docs/manual/console.tex b/docs/manual/console.tex index a5b7e478..0e0d3dcc 100644 --- a/docs/manual/console.tex +++ b/docs/manual/console.tex @@ -189,7 +189,15 @@ order ... \item [directors] Used in the show command. Takes no arguments. \item [directory] - Used in the restore command. + Used in the restore command. Its argument specifies the directory + to be restored. +\item [enabled] + This keyword can appear on the {\bf update volume} command, and can + allows one of the following arguments: yes, true, no, false, archived, + 0, 1, 2. Where 0 corresponds to no or false, 1 corresponds to yes or true, and + 2 corresponds to archived. Archived volumes will not be used, nor will + the Media record in the catalog be pruned. Volumes that are not enabled, + will not be used for backup or restore. \item [done] Used in the restore command. Takes no argument. \item [file] @@ -1215,7 +1223,7 @@ wish to change. The following Volume parameters may be changed: \begin{verbatim} update volume=xxx pool=yyy slots volstatus=xxx VolRetention=ddd VolUse=ddd MaxVolJobs=nnn MaxVolBytes=nnn Recycle=yes|no - slot=nnn + slot=nnn enabled=n \end{verbatim} \normalsize diff --git a/docs/manual/dvd.tex b/docs/manual/dvd.tex index db05f24c..2224eb07 100644 --- a/docs/manual/dvd.tex +++ b/docs/manual/dvd.tex @@ -42,7 +42,6 @@ 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} \index[general]{Directives!DVD} \index[general]{DVD Specific SD Directives } @@ -82,6 +81,16 @@ Device resource. \end{verbatim} \normalsize +However, if you have defined a mount point in /etc/fstab, you might be +able to use a mount command such as: + +\footnotesize +\begin{verbatim} + Mount Command = "/bin/mount /media/dvd" +\end{verbatim} +\normalsize + + \item [Unmount Command = {\it name-string}] \index[sd]{Unmount Command} Command that must be executed to unmount the device. Before the command is @@ -123,8 +132,7 @@ Device resource. \index[sd]{Free Space Command } Command that must be executed to check how much free space is left on the device. Before the command is executed,\%a is replaced with the Archive - Device, \%m with the Mount Point, \%e is replaced with 1 if we are writing - the first part, and with 0 otherwise, and \%v with the current part filename. + Device. For a DVD, you will most frequently specify the Bacula supplied {\bf dvd-handler} script as follows: @@ -156,6 +164,28 @@ 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} +\index[general]{Directives!DVD Edit Codes} +\index[general]{Edit Codes for DVD Directives } +\addcontentsline{toc}{subsection}{Edit Codes fro DVD Directives} + +Before submitting the {\bf Mount Command}, {\bf Unmount Command}, +{\bf Write Part Command}, or {\bf Free Space Command} directives +to the operating system, Bacula performs character substitution of the +following characters: + +\footnotesize +\begin{verbatim} + %% = % + %a = Archive device name + %e = erase (set if cannot mount and first part) + %n = part number + %m = mount point + %v = last part name (i.e. filename) +\end{verbatim} +\normalsize + + \subsection*{DVD Specific Director Directives} \index[general]{Directives!DVD} @@ -249,6 +279,25 @@ The following directives are added to the Director's Job resource. \item DVD+RW and DVD-RW support only about 1000 overwrites (i.e. don't use the same medium for years if you don't want to have problems...). -\item For more informations about DVD writing, please look at the +To write to the DVD the first time use: +\begin{verbatim} + growisofs -Z /dev/xxx filename +\end{verbatim} + +To add additional files (more parts use): + +\begin{verbatim} + growisofs -M /dev/xxx filename +\end{verbatim} + +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 +greater, since these newer kernels can handle writing more than 4GB. +See below for more details on this subject. + +\item For more information about DVD writing, please look at the \elink{dvd+rw-tools homepage}{http://fy.chalmers.se/~appro/linux/DVD+RW/}. + + \end{itemize} diff --git a/docs/manual/fileset.tex b/docs/manual/fileset.tex index 72366234..8d89a3fa 100644 --- a/docs/manual/fileset.tex +++ b/docs/manual/fileset.tex @@ -513,7 +513,7 @@ Change: 2005-11-06 12:36:48.000000000 +0100 \item [hardlinks=yes|no] \index[dir]{hardlinks} \index[dir]{Directive!hardlinks} - When enabled (default), this directive will cause hard inks to be + When enabled (default), this directive will cause hard links to be backed up. However, the File daemon keeps track of hard linked files and will backup the data only once. The process of keeping track of the hard links can be quite expensive if you have lots of them (tens of diff --git a/docs/manual/progs.tex b/docs/manual/progs.tex index 38b28e0b..3de01ffc 100644 --- a/docs/manual/progs.tex +++ b/docs/manual/progs.tex @@ -323,6 +323,11 @@ bls: block.c:92 Rec: VId=1 VT=1035062102 FI=6 Strm=MD5 len=16 p=8101841 \index[general]{program!bextract} \addcontentsline{toc}{subsection}{bextract} +If you find yourself using {\bf bextract}, you probably have done +something wrong. For example, if you are trying to recover a file +but are having problems, please see the \ilink {Restoring When Things Go +Wrong}{database_restore} section of the Restore chapter of this manual. + Normally, you will restore files by running a {\bf Restore} Job from the {\bf Console} program. However, {\bf bextract} can be used to extract a single file or a list of files from a Bacula tape or file. In fact, {\bf bextract} can be @@ -443,15 +448,17 @@ program. \index[general]{program!bscan} \addcontentsline{toc}{subsection}{bscan} -The {\bf bscan} program can be used to re-create a database (catalog) from the -backup information written to one or more Volumes. This is normally needed -only if one or more Volumes have been pruned or purged from your catalog so -that the records on the Volume are no longer in the catalog. If you find yourself using this program, you have probably done something wrong. For example, the best way to recover a lost or damaged Bacula database is to reload the database from using the bootstrap file that was written when you saved it. +The {\bf bscan} program can be used to re-create a database (catalog) from +the backup information written to one or more Volumes. This is normally +needed only if one or more Volumes have been pruned or purged from your +catalog so that the records on the Volume are no longer in the catalog, or +for Volumes that you have archived. + With some care, it can also be used to synchronize your existing catalog with a Volume. Although we have never seen a case of bscan damaging a catalog, since bscan modifies your catalog, we recommend that diff --git a/docs/manual/tls.tex b/docs/manual/tls.tex index 8234c7a3..beaa7456 100644 --- a/docs/manual/tls.tex +++ b/docs/manual/tls.tex @@ -13,7 +13,10 @@ Bacula TLS (Transport Layer Security) is built-in network encryption code to provide secure network transport similar to that offered by {\bf stunnel} or {\bf ssh}. The data written to Volumes by the Storage daemon is not encrypted by this code. -The Bacula encryption code was written by Landon Fuller. +For data encryption, please see the \ilink{Data Encryption +Chapter}{DataEncryption} of this manual. + +The Bacula encryption implementations were written by Landon Fuller. Supported features of this code include: \begin{itemize} @@ -44,10 +47,16 @@ These new directives are defined as follows: \begin{description} \item [TLS Enable = \lt{}yes|no\gt{}] -Enable TLS support. +Enable TLS support. If TLS is not enabled, none of the other TLS directives +have any effect. In other words, even if you set {\bf TLS Require = yes} +you need to have TLS enabled or TLS will not be used. \item [TLS Require = \lt{}yes|no\gt{}] -Require TLS connections. +Require TLS connections. This directive is ignored unless {\bf TLS Enable} +is set to {\bf yes}. If TLS is not required, and TLS is enabled, then +Bacula will connect with other daemons either with or without TLS depending +on what the other daemon requests. If TLS is enabled and TLS is required, +then Bacula will refuse any connection that does not use TLS. \item [TLS Certificate = \lt{}Directory\gt{}] Path to a PEM encoded TLS certificate. It can be used as either a client @@ -131,7 +140,7 @@ each of them by entering a return, or if you wish you may enter your own data. Note, however, that self-signed certificates will only work for the outgoing end of connections. For example, in the case of the Director making a connection to a File Daemon, the File Daemon may be configured to -allow self-signed certifictes, but the certificate being sed by the +allow self-signed certifictes, but the certificate used by the Director must be signed by a certificate that is explicitly trusted on the File Daemon end. @@ -186,7 +195,7 @@ Note, this link may change. Landon has supplied us with the TLS portions of his configuration files, which should help you setting up your own. - + {\bf bacula-dir.conf} \footnotesize \begin{verbatim} diff --git a/docs/manual/version.tex b/docs/manual/version.tex index 2b46951b..e1b7e7c6 100644 --- a/docs/manual/version.tex +++ b/docs/manual/version.tex @@ -1 +1 @@ -1.39.21 (27 August 2006) +1.39.21 (02 Septermber 2006) -- 2.39.5