]> git.sur5r.net Git - bacula/docs/blobdiff - docs/manuals/en/install/dirdconf.tex
Commit changes for Spanish site
[bacula/docs] / docs / manuals / en / install / dirdconf.tex
index b7adfac30b2f6464463a5c28591af28dadc740f6..1c972fc062cfba816a5cf68cf00031a0903fb84a 100644 (file)
@@ -224,10 +224,6 @@ in the  graphical user interface. This directive is optional.
    to disk simultaneously, then write one spool file at a time to the volume
    thus avoiding excessive interleaving of the different job blocks.
 
-   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.  
-
 \item [FD Connect Timeout = \lt{}time\gt{}]
    \index[dir]{FD Connect Timeout}
    \index[dir]{Directive!FD Connect Timeout}
@@ -328,6 +324,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: 
@@ -368,6 +378,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}
@@ -957,7 +977,8 @@ during working hours. We can see it like \texttt{Max Start Delay + Max Run
    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
@@ -973,6 +994,17 @@ during working hours. We can see it like \texttt{Max Start Delay + Max Run
    This means that the job will prefer to use an unused drive rather
    than use a drive that is already in use.
 
+   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|no\gt{}]
 \index[dir]{Prune Jobs}
 \index[dir]{Directive!Prune Jobs}
@@ -1013,8 +1045,23 @@ during working hours. We can see it like \texttt{Max Start Delay + Max Run
    The specified {\bf Command} (see below for details) is run as an
    external program prior or after the current Job.  This is optional.
 
-   Console options are special commands that are sent to the director instead
-   of the OS.
+   \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.
+
+   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.
 
@@ -1952,13 +1999,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>
@@ -2743,11 +2788,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