]> git.sur5r.net Git - bacula/docs/blobdiff - docs/manuals/en/install/dirdconf.tex
Updates
[bacula/docs] / docs / manuals / en / install / dirdconf.tex
index 62fb3c0869d18122ebe79c561308287752fbb2e0..c448d3112242c0b805f9a84ae9242911f258c637 100644 (file)
@@ -216,21 +216,13 @@ in the  graphical user interface. This directive is optional.
    should run  concurrently. The default is set to 1, but you may set it to a 
    larger number.  
 
-   Please  note that the Volume format becomes much more complicated with 
-   multiple simultaneous jobs, consequently, restores can take much  longer if
+   The Volume format becomes more complicated with 
+   multiple simultaneous jobs, consequently, restores may take longer if
    Bacula must sort through interleaved volume blocks from  multiple simultaneous
-   jobs. This can be avoided by having each  simultaneously running job write to
+   jobs. This can be avoided by having each simultaneous job write to
    a different volume or  by using data spooling, which will first spool the data
-   to disk simultaneously, then write each spool file to the  volume in
-   sequence.  
-
-   There may also still be some cases where directives such as  {\bf Maximum
-   Volume Jobs} are not properly synchronized with  multiple simultaneous jobs
-   (subtle timing issues can arise),  so careful testing is recommended. 
-
-   At the current time,  there is no configuration parameter set to limit the
-   number of console connections. A maximum of five simultaneous console 
-   connections are permitted.  
+   to disk simultaneously, then write one spool file at a time to the volume
+   thus avoiding excessive interleaving of the different job blocks.
 
 \item [FD Connect Timeout = \lt{}time\gt{}]
    \index[dir]{FD Connect Timeout}
@@ -312,6 +304,15 @@ resource.
    directive only permits a single address to be specified.  This directive
    should not be used if you specify a DirAddresses (N.B. plural) directive.
 
+\item [DirSourceAddress = \lt{}IP-Address\gt{}]
+   \index[fd]{DirSourceAddress}
+   \index[fd]{Directive!DirSourceAddress}
+   This record is optional, and if it is specified, it will cause the Director
+   server (when initiating connections to a storage or file daemon) to source
+   its connections from the specified address.  Only a single IP address may be
+   specified.  If this record is not specified, the Director server will source
+   its outgoing connections according to the system routing table (the default).
+
 \item[Statistics Retention = \lt{}time\gt{}]
    \index[dir]{StatisticsRetention}
    \index[dir]{Directive!StatisticsRetention}
@@ -319,9 +320,9 @@ resource.
 
    The \texttt{Statistics Retention} directive defines the length of time that
    Bacula will keep statistics job records in the Catalog database after the
-   Job End time. (In \texttt{JobStat} table) When this time period expires, and
-   if user runs \texttt{prune stats} command, Bacula will prune (remove) Job
-   records that are older than the specified period.
+   Job End time. (In \texttt{JobHistory} table) When this time period expires,
+   and if user runs \texttt{prune stats} command, Bacula will prune (remove)
+   Job records that are older than the specified period.
 
    Theses statistics records aren't use for restore purpose, but mainly for
    capacity planning, billings, etc. See \ilink{Statistics chapter} for
@@ -332,6 +333,20 @@ resource.
 
    The default is 5 years.
 
+\item[VerId = \lt{}string\gt{}]
+  \index[dir]{Directive!VerId}
+  where  \lt{}string\gt{} is an identifier which can be used for support purpose.
+  This string is displayed using the \texttt{version} command.
+
+\item[MaxConsoleConnections = \lt{}number\gt{}] 
+  \index[dir]{MaximumConsoleConnections}
+  \index[dir]{MaxConsoleConnections}
+  \index[dir]{Directive!MaxConsoleConnections}
+  \index[dir]{Console}
+   where \lt{}number\gt{}  is the maximum number of Console Connections that
+   could run  concurrently. The default is set to 20, but you may set it to a 
+   larger number.
+
 \end{description}
 
 The following is an example of a valid Director resource definition: 
@@ -372,6 +387,16 @@ a unique Job name.  Normally, you will have only one Job per Client, but
 if a client has a really huge number of files (more than several million),
 you might want to split it into to Jobs each with a different FileSet
 covering only part of the total files.
+
+Multiple Storage daemons are not currently supported for Jobs, so if
+you do want to use multiple storage daemons, you will need to create
+a different Job and ensure that for each Job that the combination of
+Client and FileSet are unique.  The Client and FileSet are what Bacula
+uses to restore a client, so if there are multiple Jobs with the same
+Client and FileSet or multiple Storage daemons that are used, the
+restore will not work.  This problem can be resolved by defining multiple
+FileSet definitions (the names must be different, but the contents of
+the FileSets may be the same).
                
 
 \begin{description}
@@ -394,7 +419,7 @@ covering only part of the total files.
    specify here followed by the date and time the  job was scheduled for
    execution. This directive is required. 
 
-\item [Enabled = \lt{}yes|no\gt{}]
+\item [Enabled = \lt{}yes\vb{}no\gt{}]
   \index[dir]{Enable}
   \index[dir]{Directive!Enable}
   This directive allows you to enable or disable automatic execution
@@ -485,7 +510,7 @@ For a {\bf Backup} Job, the Level may be one of the  following:
    different FileSet.  
 \item The Job was a Full, Differential, or Incremental backup.  
 \item The Job terminated normally (i.e. did not fail or was not  canceled).  
-\item The Job started no longer ago than {\bf Max Full Age}.
+\item The Job started no longer ago than {\bf Max Full Interval}.
 \end{itemize}
 
    If all the above conditions do not hold, the Director will upgrade  the
@@ -548,7 +573,7 @@ For a {\bf Backup} Job, the Level may be one of the  following:
    different FileSet.  
 \item The Job was a FULL backup.  
 \item The Job terminated normally (i.e. did not fail or was not  canceled).  
-\item The Job started no longer ago than {\bf Max Full Age}.
+\item The Job started no longer ago than {\bf Max Full Interval}.
 \end{itemize}
 
    If all the above conditions do not hold, the Director will  upgrade the
@@ -687,23 +712,26 @@ For a {\bf Verify} Job, the Level may be one of the  following:
    have been deleted.
 \end{description}
 
-\item [Accurate = \lt{}yes|no\gt{}]
+\item [Accurate = \lt{}yes\vb{}no\gt{}]
 \index[dir]{Accurate}
-   In accurate mode, FileDaemon known exactly which files were present
-   after last backup. So it is able to handle deleted or renamed files.
+   In accurate mode, the File daemon knowns exactly which files were present
+   after the last backup. So it is able to handle deleted or renamed files.
 
-   When restoring a fileset for a specified date (including "most
-   recent"), Bacula is able to give you exactly the files and
+   When restoring a FileSet for a specified date (including "most
+   recent"), Bacula is able to restore exactly the files and
    directories that existed at the time of the last backup prior to
-   that date.
+   that date including ensuring that deleted files are actually deleted,
+   and renamed directories are restored properly.
 
-   In this mode, FileDaemon have to keep all files in memory. So you have
-   to check that your memory and swap are sufficent.
+   In this mode, the File daemon must keep data concerning all files in
+   memory.  So you do not have sufficient memory, the restore may
+   either be terribly slow or fail.
 
-   $$ memory = \sum_{i=1}^{n}(strlen(path_i + file_i) + sizeof(CurFile))$$
+%%   $$ memory = \sum_{i=1}^{n}(strlen(path_i + file_i) + sizeof(CurFile))$$
 
-   For 500.000 files (typical desktop linux system), it will take
-   around 64MB of RAM on your FileDaemon.
+   For 500.000 files (a typical desktop linux system), it will require
+   approximately 64 Megabytes of RAM on your File daemon to hold the
+   required information.
 
 \item [Verify Job = \lt{}Job-Resource-Name\gt{}]
    \index[dir]{Verify Job}
@@ -897,8 +925,37 @@ JobDefs {
 \index[dir]{Directive!Max Run Time}
    The time specifies the maximum allowed time that a job may run, counted
    from when the job starts, ({\bf not} necessarily the same as when the
-   job was scheduled).  This directive is implemented in version 1.33 and
-   later.
+   job was scheduled).
+
+\item [Incremental|Differential Max Wait Time = \lt{}time\gt{}]
+\index[dir]{Incremental Wait Run Time}
+\index[dir]{Differential Wait Run Time}
+\index[dir]{Directive!Differential Max Wait Time}
+    Theses directives have been deprecated in favor of
+    \texttt{Incremental|Differential Max Run Time} since bacula 2.3.18.
+
+\item [Incremental Max Run Time = \lt{}time\gt{}]
+\index[dir]{Incremental Max Run Time}
+\index[dir]{Directive!Incremental Max Run Time}
+The time specifies the maximum allowed time that an Incremental backup job may
+run, counted from when the job starts, ({\bf not} necessarily the same as when
+the job was scheduled).
+
+\item [Differential Max Wait Time = \lt{}time\gt{}]
+\index[dir]{Differential Max Run Time}
+\index[dir]{Directive!Differential Max Run Time}
+The time specifies the maximum allowed time that a Differential backup job may
+run, counted from when the job starts, ({\bf not} necessarily the same as when
+the job was scheduled).
+
+\item [Max Run Sched Time = \lt{}time\gt{}]
+\index[dir]{Max Run Sched Time}
+\index[dir]{Directive!Max Run Sched Time}
+
+The time specifies the maximum allowed time that a job may run, counted from
+when the job was scheduled. This can be useful to prevent jobs from running
+during working hours. We can see it like \texttt{Max Start Delay + Max Run
+  Time}.
 
 \item [Max Wait Time = \lt{}time\gt{}]
 \index[dir]{Max Wait Time}
@@ -907,32 +964,14 @@ JobDefs {
    for a resource (such as waiting for a tape to be mounted, or waiting for
    the storage or file daemons to perform their duties), counted from the
    when the job starts, ({\bf not} necessarily the same as when the job was
-   scheduled).  This directive is implemented only in version 1.33 and
-   later.
+   scheduled). This directive works as expected since bacula 2.3.18.
 
-\item [Incremental Max Wait Time = \lt{}time\gt{}]
-\index[dir]{Incremental Max Wait Time}
-\index[dir]{Directive!Incremental Max Wait Time}
-   The time specifies the maximum allowed time that an Incremental backup
-   job may block waiting for a resource (such as waiting for a tape to be
-   mounted, or waiting for the storage or file daemons to perform their
-   duties), counted from the when the job starts, ({\bf not} necessarily
-   the same as when the job was scheduled).  Please note that if there is a
-   {\bf Max Wait Time} it may also be applied to the job.
+\addcontentsline{lof}{figure}{Job time control directives}
+\includegraphics{\idir different_time.eps}
 
-\item [Differential Max Wait Time = \lt{}time\gt{}]
-\index[dir]{Differential Max Wait Time}
-\index[dir]{Directive!Differential Max Wait Time}
-   The time specifies the maximum allowed time that a Differential backup
-   job may block waiting for a resource (such as waiting for a tape to be
-   mounted, or waiting for the storage or file daemons to perform their
-   duties), counted from the when the job starts, ({\bf not} necessarily
-   the same as when the job was scheduled).  Please note that if there is a
-   {\bf Max Wait Time} it may also be applied to the job.
-
-\item [Max Full Age = \lt{}time\gt{}]
-\index[dir]{Max Full Age}
-\index[dir]{Directive!Max Full Age}
+\item [Max Full Interval = \lt{}time\gt{}]
+\index[dir]{Max Full Interval}
+\index[dir]{Directive!Max Full Interval}
    The time specifies the maximum allowed age (counting from start time) of
    the most recent successful Full backup that is required in order to run
    Incremental or Differential backup jobs. If the most recent Full backup
@@ -942,7 +981,7 @@ JobDefs {
    considered.
 
 \label{PreferMountedVolumes}
-\item [Prefer Mounted Volumes = \lt{}yes|no\gt{}]
+\item [Prefer Mounted Volumes = \lt{}yes\vb{}no\gt{}]
 \index[dir]{Prefer Mounted Volumes}
 \index[dir]{Directive!Prefer Mounted Volumes}
    If the Prefer Mounted Volumes directive is set to {\bf yes} (default
@@ -950,7 +989,8 @@ JobDefs {
    a drive with a valid Volume already mounted in preference to a drive
    that is not ready.  This means that all jobs will attempt to append
    to the same Volume (providing the Volume is appropriate -- right Pool, 
-   ... for that job). If no drive with a suitable Volume is available, it
+   ... for that job), unless you are using multiple pools.
+   If no drive with a suitable Volume is available, it
    will select the first available drive.  Note, any Volume that has
    been requested to be mounted, will be considered valid as a mounted
    volume by another job.  This if multiple jobs start at the same time
@@ -966,7 +1006,18 @@ JobDefs {
    This means that the job will prefer to use an unused drive rather
    than use a drive that is already in use.
 
-\item [Prune Jobs = \lt{}yes|no\gt{}]
+   Despite the above, we recommend against setting this directive to
+   {\bf no} since
+   it tends to add a lot of swapping of Volumes between the different
+   drives and can easily lead to deadlock situations in the Storage
+   daemon. We will accept bug reports against it, but we cannot guarantee
+   that we will be able to fix the problem in a reasonable time.
+
+   A better alternative for using multiple drives is to use multiple
+   pools so that Bacula will be forced to mount Volumes from those Pools
+   on different drives.
+
+\item [Prune Jobs = \lt{}yes\vb{}no\gt{}]
 \index[dir]{Prune Jobs}
 \index[dir]{Directive!Prune Jobs}
    Normally, pruning of Jobs from the Catalog is specified on a Client by
@@ -976,7 +1027,7 @@ JobDefs {
    default is {\bf no}.
 
 
-\item [Prune Files = \lt{}yes|no\gt{}]
+\item [Prune Files = \lt{}yes\vb{}no\gt{}]
 \index[dir]{Prune Files}
 \index[dir]{Directive!Prune Files}
    Normally, pruning of Files from the Catalog is specified on a Client by
@@ -985,7 +1036,7 @@ JobDefs {
    yes}, it will override the value specified in the Client resource.  The
    default is {\bf no}.
 
-\item [Prune Volumes = \lt{}yes|no\gt{}]
+\item [Prune Volumes = \lt{}yes\vb{}no\gt{}]
 \index[dir]{Prune Volumes}
 \index[dir]{Directive!Prune Volumes}
    Normally, pruning of Volumes from the Catalog is specified on a Client
@@ -998,16 +1049,31 @@ JobDefs {
    \index[dir]{RunScript}
    \index[dir]{Directive!Run Script}
 
-   This directive is implemented in version 1.39.22 and later.
    The RunScript directive behaves like a resource in that it
    requires opening and closing braces around a number of directives
    that make up the body of the runscript.
 
-   The specified {\bf Command} (see below for details) is run as an
-   external program prior or after the current Job.  This is optional.
+   The specified {\bf Command} (see below for details) is run as an external
+   program prior or after the current Job.  This is optional.  By default, the
+   program is executed on the Client side like in \texttt{ClientRunXXXJob}.
+
+   \textbf{Console} options are special commands that are sent to the director instead
+   of the OS. At this time, console command ouputs are redirected to log with
+   the jobid 0.
 
-   Console options are special commands that are sent to the director instead
-   of the OS.
+   You can use following console command : \texttt{delete}, \texttt{disable},
+   \texttt{enable}, \texttt{estimate}, \texttt{list}, \texttt{llist},
+   \texttt{memory}, \texttt{prune}, \texttt{purge}, \texttt{reload},
+   \texttt{status}, \texttt{setdebug}, \texttt{show}, \texttt{time},
+   \texttt{trace}, \texttt{update}, \texttt{version}, \texttt{.client},
+   \texttt{.jobs}, \texttt{.pool}, \texttt{.storage}.  See console chapter for
+   more information. You need to specify needed information on command line, nothing
+   will be prompted. Example :
+
+\begin{verbatim}
+   Console = "prune files client=%c"
+   Console = "update stats age=3"
+\end{verbatim}
 
    You can specify more than one Command/Console option per RunScript.
 
@@ -1391,7 +1457,7 @@ RunScript {
    Note, please see the notes above in {\bf RunScript} 
    concerning Windows clients.
 
-\item [Rerun Failed Levels = \lt{}yes|no\gt{}]
+\item [Rerun Failed Levels = \lt{}yes\vb{}no\gt{}]
    \index[dir]{Rerun Failed Levels}
    \index[dir]{Directive!Rerun Failed Levels}
    If this directive is set to {\bf yes} (default no), and Bacula detects that
@@ -1409,7 +1475,7 @@ RunScript {
    when checking for failed levels, which means that any FileSet change will
    trigger a rerun.
 
-\item [Spool Data = \lt{}yes|no\gt{}]
+\item [Spool Data = \lt{}yes\vb{}no\gt{}]
    \index[dir]{Spool Data}
    \index[dir]{Directive!Spool Data}
 
@@ -1424,7 +1490,7 @@ RunScript {
    NOTE: When this directive is set to yes, Spool Attributes is also
    automatically set to yes.
 
-\item [Spool Attributes = \lt{}yes|no\gt{}]
+\item [Spool Attributes = \lt{}yes\vb{}no\gt{}]
    \index[dir]{Spool Attributes}
    \index[dir]{Directive!Spool Attributes}
    \index[dir]{slow}
@@ -1531,7 +1597,7 @@ RunScript {
   if the backed up file already exists, Bacula skips  restoring this file.  
 \end{description}
 
-\item [Prefix Links=\lt{}yes|no\gt{}]
+\item [Prefix Links=\lt{}yes\vb{}no\gt{}]
    \index[dir]{Prefix Links}
    \index[dir]{Directive!Prefix Links}
    If a {\bf Where} path prefix is specified for a recovery job, apply it
@@ -1555,7 +1621,7 @@ RunScript {
    documented under \ilink{ Maximum Concurrent Jobs}{DirMaxConJobs} in the
    Director's resource.
 
-\item [Reschedule On Error = \lt{}yes|no\gt{}]
+\item [Reschedule On Error = \lt{}yes\vb{}no\gt{}]
    \index[dir]{Reschedule On Error}
    \index[dir]{Directive!Reschedule On Error}
    If this directive is enabled, and the job terminates in error, the job
@@ -1640,7 +1706,8 @@ RunScript {
    The priority only affects waiting jobs that are queued to run, not jobs
    that are already running.  If one or more jobs of priority 2 are already
    running, and a new job is scheduled with priority 1, the currently
-   running priority 2 jobs must complete before the priority 1 job is run.
+   running priority 2 jobs must complete before the priority 1 job is
+   run, unless Allow Mixed Priority is set.
 
    The default priority is 10.  
 
@@ -1678,8 +1745,25 @@ avoid it by starting any higher priority jobs a few seconds before lower
 priority ones.  This insures that Bacula will examine the jobs in the
 correct order, and that your priority scheme will be respected.
 
+\label{AllowMixedPriority}
+\item [Allow Mixed Priority = \lt{}yes\vb{}no\gt{}]
+\index[dir]{Allow Mixed Priority}
+   This directive is only implemented in version 2.5 and later.  When
+   set to {\bf yes} (default {\bf no}), this job may run even if lower
+   priority jobs are already running.  This means a high priority job
+   will not have to wait for other jobs to finish before starting.
+   The scheduler will only mix priorities when all running jobs have
+   this set to true.
+
+   Note that only higher priority jobs will start early.  Suppose the
+   director will allow two concurrent jobs, and that two jobs with
+   priority 10 are running, with two more in the queue.  If a job with
+   priority 5 is added to the queue, it will be run as soon as one of
+   the running jobs finishes.  However, new priority 10 jobs will not
+   be run until the priority 5 job has finished.
+
 \label{WritePartAfterJob}
-\item [Write Part After Job = \lt{}yes|no\gt{}]
+\item [Write Part After Job = \lt{}yes\vb{}no\gt{}]
 \index[dir]{Write Part After Job}
 \index[dir]{Directive!Write Part After Job}
    This directive is only implemented in version 1.37 and later.
@@ -1698,17 +1782,6 @@ correct order, and that your priority scheme will be respected.
 
    This directive is ignored with tape and FIFO devices.  
 
-\item [Use Statistics = \lt{}yes|no\gt{}]
-  \label{JobUseStatistics}
-  \index{dir}{Use Statistics}
-  \index{dir}{Directive!Statistics}
-
-  This directive is optional (default \textbf{no}) and if specified will cause
-  the Director to keep job record in \texttt{JobStat} catalog table. This table
-  can be used to make longterm statistics. This table will not be pruned by
-  standard prunning algorithm. See \ilink{Prunning
-    Statistics}{PruneStatistics} for more information.
-
 \end{description}
 
 The following is an example of a valid Job resource definition: 
@@ -1840,7 +1913,7 @@ upgraded from another type  to a full backup.
    specifies to use the Pool  named {\bf Incremental} if the job is an
 incremental  backup.  
 
-\item [SpoolData=yes|no]
+\item [SpoolData=yes\vb{}no]
    \index[dir]{SpoolData}
    \index[dir]{Directive!SpoolData}
    tells Bacula to request the Storage  daemon to spool data to a disk file
@@ -1858,7 +1931,7 @@ incremental  backup.
    This directive is available only in Bacula version 2.3.5 or 
    later.
 
-\item [WritePartAfterJob=yes|no]
+\item [WritePartAfterJob=yes\vb{}no]
    \index[dir]{WritePartAfterJob}
    \index[dir]{Directive!WritePartAfterJob}
    tells Bacula to request the Storage daemon to write the current part
@@ -1938,13 +2011,11 @@ pseudo-BNF:
                           <wday-range>
 <date>            = <date-keyword> | <day> | <range>
 <date-spec>       = <date> | <date-spec>
-<day-spec>        = <day> | <wday-keyword> |
-                    <day-range> | <wday-range> |
-                    <daily-keyword>
 <day-spec>        = <day> | <wday-keyword> |
                     <day> | <wday-range> |
                     <week-keyword> <wday-keyword> |
-                    <week-keyword> <wday-range>
+                    <week-keyword> <wday-range> |
+                    <daily-keyword>
 <month-spec>      = <month-keyword> | <month-range> |
                     <monthly-keyword>
 <date-time-spec>  = <month-spec> <day-spec> <time-spec>
@@ -2155,7 +2226,7 @@ console run command.  This directive is required.
    The default is 180 days.  
 
 \label{AutoPrune}
-\item [AutoPrune = \lt{}yes|no\gt{}]
+\item [AutoPrune = \lt{}yes\vb{}no\gt{}]
    \index[dir]{AutoPrune}
    \index[dir]{Directive!AutoPrune}
    If AutoPrune is set to  {\bf yes} (default), Bacula (version 1.20 or greater)
@@ -2173,10 +2244,7 @@ console run command.  This directive is required.
    with the same name as the resource in which it appears. Any  other
    restrictions on the maximum concurrent jobs such as in  the Director, Job, or
    Storage resources will also apply in addition to  any limit specified here.
-   The  default is set to 1, but you may set it to a larger number.  We strongly
-   recommend that you read the WARNING documented under  
-   \ilink{ Maximum Concurrent Jobs}{DirMaxConJobs} in the Director's
-   resource.  
+   The  default is set to 1, but you may set it to a larger number.
 
 \item [Priority = \lt{}number\gt{}]
    \index[dir]{Priority}
@@ -2333,7 +2401,7 @@ the Director.
    check so that you don't try to write data for a DLT onto an 8mm device.
 
 \label{Autochanger1}
-\item [Autochanger = \lt{}yes|no\gt{}]  
+\item [Autochanger = \lt{}yes\vb{}no\gt{}]  
    \index[dir]{Autochanger}
    \index[dir]{Directive!Autochanger}
    If you specify {\bf yes} for this command (the default is {\bf no}),
@@ -2531,7 +2599,7 @@ The Pool Resource defined in the Director's configuration file
    the Job resource or in the Pool, but it must be specified in
    one or the other.  If not configuration error will result.
 
-\item [Use Volume Once = \lt{}yes|no\gt{}]
+\item [Use Volume Once = \lt{}yes\vb{}no\gt{}]
    \index[dir]{Use Volume Once}
    \index[dir]{Directive!Use Volume Once}
    This directive if set to {\bf yes} specifies that each volume is to be
@@ -2661,7 +2729,7 @@ The Pool Resource defined in the Director's configuration file
    must use the 
    \ilink{\bf update volume}{UpdateCommand} command in the Console.  
 
-\item [Catalog Files = \lt{}yes|no\gt{}]
+\item [Catalog Files = \lt{}yes\vb{}no\gt{}]
    \index[dir]{Catalog Files}
    \index[dir]{Directive!Catalog Files}
    This directive defines whether or not you want the names of the files
@@ -2674,7 +2742,7 @@ The Pool Resource defined in the Director's configuration file
    restore} command nor any other command that references File entries.
    
 \label{PoolAutoPrune}
-\item [AutoPrune = \lt{}yes|no\gt{}]
+\item [AutoPrune = \lt{}yes\vb{}no\gt{}]
    \index[dir]{AutoPrune}
    \index[dir]{Directive!AutoPrune}
    If AutoPrune is set to {\bf yes} (default), Bacula (version 1.20 or
@@ -2712,7 +2780,6 @@ The Pool Resource defined in the Director's configuration file
    Bacula does not automatically recycle a Volume. It attempts to keep the
    Volume data intact as long as possible before over writing the Volume.
    
-   
    By defining multiple Pools with different Volume Retention periods, you
    may effectively have a set of tapes that is recycled weekly, another
    Pool of tapes that is recycled monthly and so on.  However, one must
@@ -2732,11 +2799,22 @@ The Pool Resource defined in the Director's configuration file
    what is stored for the Volume.  To change the value for an existing
    Volume you must use the {\bf update} command in the Console.
 
+\label{PoolScratchPool}
+\item [ScratchPool = \lt{}pool-resource-name\gt{}]
+   \index[dir]{ScrachPool}
+   \index[dir]{Directive!ScrachPool}
+   This directive permits to specify a dedicate \textsl{Scratch} for the
+   current pool. This pool will replace the special pool named \textsl{Scrach}
+   for volume selection. For more information about \textsl{Scratch} see
+   \ilink{Scratch Pool}{TheScratchPool} section of this manual. This is useful
+   when using multiple storage sharing the same mediatype or when you want to
+   dedicate volumes to a particular set of pool.
+
 \label{PoolRecyclePool}
 \item [RecyclePool = \lt{}pool-resource-name\gt{}]
    \index[dir]{RecyclePool}
    \index[dir]{Directive!RecyclePool}
-   On versions 2.1.4 or greater, this directive defines to which pool
+   This directive defines to which pool
    the Volume will be placed (moved) when it is recycled. Without
    this directive, a Volume will remain in the same pool when it is
    recycled. With this directive, it can be moved automatically to any
@@ -2753,7 +2831,7 @@ The Pool Resource defined in the Director's configuration file
         
    
 \label{PoolRecycle}
-\item [Recycle = \lt{}yes|no\gt{}]
+\item [Recycle = \lt{}yes\vb{}no\gt{}]
    \index[dir]{Recycle}
    \index[dir]{Directive!Recycle}
    This directive specifies whether or not Purged Volumes may be recycled.
@@ -2782,7 +2860,7 @@ The Pool Resource defined in the Director's configuration file
 
 
 \label{RecycleOldest}
-\item [Recycle Oldest Volume = \lt{}yes|no\gt{}]
+\item [Recycle Oldest Volume = \lt{}yes\vb{}no\gt{}]
    \index[dir]{Recycle Oldest Volume}
    \index[dir]{Directive!Recycle Oldest Volume}
    This directive instructs the Director to search for the oldest used
@@ -2806,7 +2884,7 @@ The Pool Resource defined in the Director's configuration file
 
 \label{RecycleCurrent}
 
-\item [Recycle Current Volume = \lt{}yes|no\gt{}]
+\item [Recycle Current Volume = \lt{}yes\vb{}no\gt{}]
    \index[dir]{Recycle Current Volume}
    \index[dir]{Directive!Recycle Current Volume}
    If Bacula needs a new Volume, this directive instructs Bacula to Prune
@@ -2829,7 +2907,7 @@ The Pool Resource defined in the Director's configuration file
 
 \label{PurgeOldest}
 
-\item [Purge Oldest Volume = \lt{}yes|no\gt{}]
+\item [Purge Oldest Volume = \lt{}yes\vb{}no\gt{}]
    \index[dir]{Purge Oldest Volume}
    \index[dir]{Directive!Purge Oldest Volume}
    This directive instructs the Director to search for the oldest used
@@ -2895,7 +2973,9 @@ The Pool Resource defined in the Director's configuration file
 
    If no variable expansion characters are found in the string, the Volume
    name will be formed from the {\bf format} string appended with the
-   number of volumes in the pool plus one, which will be edited as four
+   a unique number that increases.  If you do not remove volumes from the
+   pool, this number should be the number of volumes plus one, but this
+   is not guaranteed. The unique number will be edited as four
    digits with leading zeros.  For example, with a {\bf Label Format =
    "File-"}, the first volumes will be named {\bf File-0001}, {\bf
    File-0002}, ...
@@ -3027,7 +3107,7 @@ defined.
    by MySQL and PostgreSQL and is ignored by SQLite if provided.  This
    directive is optional.
 
-%% \item [Multiple Connections = \lt{}yes|no\gt{}]
+%% \item [Multiple Connections = \lt{}yes\vb{}no\gt{}]
 %% \index[dir]{Multiple Connections}
 %% \index[dir]{Directive!Multiple Connections}
 %% By default, this  directive is set to no. In that case, each job that uses