X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=docs%2Fmanuals%2Fen%2Fmain%2Fdirdconf.tex;h=cedd4383ebdf6ba95f12530c76e7921ac11d5be7;hb=c123310ccbfb03c543bdf2dffa035fd893c9a006;hp=d0dfa40c38bdfb78c8218c9a8d51d7bbc7155dbb;hpb=8d6a0f637913098026732b2c90d64b6c351f63eb;p=bacula%2Fdocs diff --git a/docs/manuals/en/main/dirdconf.tex b/docs/manuals/en/main/dirdconf.tex index d0dfa40c..cedd4383 100644 --- a/docs/manuals/en/main/dirdconf.tex +++ b/docs/manuals/en/main/dirdconf.tex @@ -338,10 +338,9 @@ resource. 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{}] +\item[MaximumConsoleConnections = \lt{}number\gt{}] \index[dir]{MaximumConsoleConnections} - \index[dir]{MaxConsoleConnections} - \index[dir]{Directive!MaxConsoleConnections} + \index[dir]{Directive!MaximumConsoleConnections} \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 @@ -679,9 +678,10 @@ For a {\bf Verify} Job, the Level may be one of the following: \item [VolumeToCatalog] \index[dir]{VolumeToCatalog} This level causes Bacula to read the file attribute data written to the - Volume from the last Job. The file attribute data are compared to the + Volume from the last backup Job for the job specified on the {\bf VerifyJob} + directive. The file attribute data are compared to the values saved in the Catalog database and any differences are reported. - This is similar to the {\bf Catalog} level except that instead of + This is similar to the {\bf DiskToCatalog} level except that instead of comparing the disk file attributes to the catalog database, the attribute data written to the Volume is read and compared to the catalog database. Although the attribute data including the signatures (MD5 or @@ -698,7 +698,7 @@ For a {\bf Verify} Job, the Level may be one of the following: This level causes Bacula to read the files as they currently are on disk, and to compare the current file attributes with the attributes saved in the catalog from the last backup for the job specified on the - {\bf VerifyJob} directive. This level differs from the {\bf Catalog} + {\bf VerifyJob} directive. This level differs from the {\bf VolumeToCatalog} level described above by the fact that it doesn't compare against a previous Verify job but against a previous backup. When you run this level, you must supply the verify options on your Include statements. @@ -724,7 +724,7 @@ For a {\bf Verify} Job, the Level may be one of the following: and renamed directories are restored properly. In this mode, the File daemon must keep data concerning all files in - memory. So you do not have sufficient memory, the restore may + memory. So If you do not have sufficient memory, the backup may either be terribly slow or fail. %% $$ memory = \sum_{i=1}^{n}(strlen(path_i + file_i) + sizeof(CurFile))$$ @@ -799,7 +799,7 @@ For a {\bf Verify} Job, the Level may be one of the following: your catalog database. If the {\bf bootstrap-file-specification} begins with a vertical bar - (|), Bacula will use the specification as the name of a program to which + (\verb+|+), Bacula will use the specification as the name of a program to which it will pipe the bootstrap record. It could for example be a shell script that emails you the bootstrap record. @@ -831,7 +831,7 @@ JobDefs { \item [FileSet = \lt{}FileSet-resource-name\gt{}] \index[dir]{FileSet} -\index[dir]{FileSet} +\index[dir]{Directive!FileSet} The FileSet directive specifies the FileSet that will be used in the current Job. The FileSet specifies which directories (or files) are to be backed up, and what options to use (e.g. compression, ...). Only a @@ -839,6 +839,13 @@ JobDefs { details, see the \ilink{FileSet Resource section}{FileSetResource} of this chapter. This directive is required. +\item [Base = \lt{}job-resource-name, ...\gt{}] +\index[dir]{Base} +\index[dir]{Directive!Base} +The Base directive permits to specify the list of jobs that will be used during +Full backup as base. This directive is optional. See the \ilink{Base Job +chapter}{basejobs} for more information. + \item [Messages = \lt{}messages-resource-name\gt{}] \index[dir]{Messages} \index[dir]{Directive!Messages} @@ -925,7 +932,12 @@ 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). + job was scheduled). + + By default, the the watchdog thread will kill any Job that has run more + than 6 days. The maximum watchdog timeout is independent of MaxRunTime + and cannot be changed. + \item [Incremental|Differential Max Wait Time = \lt{}time\gt{}] \index[dir]{Incremental Wait Run Time} @@ -966,8 +978,19 @@ during working hours. We can see it like \texttt{Max Start Delay + Max Run when the job starts, ({\bf not} necessarily the same as when the job was scheduled). This directive works as expected since bacula 2.3.18. -\addcontentsline{lof}{figure}{Job time control directives} -\includegraphics{\idir different_time.eps} +\begin{figure}[htbp] + \centering + \includegraphics[width=13cm]{\idir different_time.eps} + \caption{Job time control directives} + \label{fig:differenttime} +\end{figure} + +\item [Maximum Bandwidth = \lt{}speed\gt{}] +\index[dir]{Maximum Bandwidth} +\index[dir]{Directive!Maximum Bandwidth} + +The speed parameter specifies the maximum allowed bandwidth that a job may +use. The speed parameter should be specified in k/s, kb/s, m/s or mb/s. \item [Max Full Interval = \lt{}time\gt{}] \index[dir]{Max Full Interval} @@ -1039,11 +1062,12 @@ during working hours. We can see it like \texttt{Max Start Delay + Max Run \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 - by Client basis in the Client resource with the {\bf AutoPrune} - directive. If this directive is specified (not normally) and the value - is {\bf yes}, it will override the value specified in the Client - resource. The default is {\bf no}. + Normally, pruning of Volumes from the Catalog is specified on a Pool by + Pool basis in the Pool resource with the {\bf AutoPrune} directive. + Note, this is different from File and Job pruning which is done on a + Client by Client basis. If this directive is specified (not normally) + and the value is {\bf yes}, it will override the value specified in the + Pool resource. The default is {\bf no}. \item [RunScript \{\lt{}body-of-runscript\gt{}\}] \index[dir]{RunScript} @@ -1119,21 +1143,30 @@ Console & & & Console command\\ \footnotesize \begin{verbatim} %% = % + %b = Job Bytes %c = Client's name - %d = Director's name + %d = Daemon's name (Such as host-dir or host-fd) + %D = Director's name (Also valid on file daemon) %e = Job Exit Status + %f = Job FileSet (Only on director side) + %F = Job Files + %h = Client address %i = JobId %j = Unique Job id %l = Job Level %n = Job name + %p = Pool name (Only on director side) %s = Since time %t = Job type (Backup, ...) %v = Volume name (Only on director side) + %w = Storage name (Only on director side) + %x = Spooling enabled? ("yes" or "no") \end{verbatim} \normalsize -The Job Exit Status code \%e edits the following values: +Some character substitutions are not available in all situations. The Job Exit +Status code \%e edits the following values: \index[dir]{Exit Status} \begin{itemize} @@ -1192,7 +1225,7 @@ RunScript { You can run scripts just after snapshots initializations with \textsl{AfterVSS} keyword. - In addition, for a Windows client on version 1.33 and above, please take + In addition, for a Windows client, please take note that you must ensure a correct path to your script. The script or program can be a .com, .exe or a .bat file. If you just put the program name in then Bacula will search using the same rules that cmd.exe uses @@ -1481,11 +1514,19 @@ RunScript { If this directive is set to {\bf yes} (default no), the Storage daemon will be requested to spool the data for this Job to disk rather than write it - directly to tape. Once all the data arrives or the spool files' maximum sizes - are reached, the data will be despooled and written to tape. Spooling data - prevents tape shoe-shine (start and stop) during - Incremental saves. If you are writing to a disk file using this option - will probably just slow down the backup jobs. + directly to the Volume (normally a tape). + + Thus the data is written in large blocks to the Volume rather than small + blocks. This directive is particularly useful when running multiple + simultaneous backups to tape. Once all the data arrives or the spool + files' maximum sizes are reached, the data will be despooled and written + to tape. + + Spooling data prevents interleaving date from several job and reduces or + eliminates tape drive stop and start commonly known as "shoe-shine". + + We don't recommend using this option if you are writing to a disk file + using this option will probably just slow down the backup jobs. NOTE: When this directive is set to yes, Spool Attributes is also automatically set to yes. @@ -1509,6 +1550,15 @@ RunScript { NOTE: When Spool Data is set to yes, Spool Attributes is also automatically set to yes. +\item [SpoolSize={\it bytes}] + \index[dir]{SpoolSize} + \index[dir]{Directive!SpoolSize} + where the bytes specify the maximum spool size for this job. + The default is take from Device Maximum Spool Size limit. + This directive is available only in Bacula version 2.3.5 or + later. + + \item [Where = \lt{}directory\gt{}] \index[dir]{Where} \index[dir]{Directive!Where} @@ -1650,6 +1700,67 @@ RunScript { job. If it is set to zero (the default) the job will be rescheduled an indefinite number of times. +\item [Allow Duplicate Jobs = \lt{}yes\vb{}no\gt{}] +\index[general]{Allow Duplicate Jobs} + +\begin{figure}[htbp] + \centering + \includegraphics[width=13cm]{\idir duplicate-real.eps} + \caption{Allow Duplicate Jobs usage} + \label{fig:allowduplicatejobs} +\end{figure} + +A duplicate job in the sense we use it here means a second or subsequent job +with the same name starts. This happens most frequently when the first job +runs longer than expected because no tapes are available. + + If this directive is enabled duplicate jobs will be run. If + the directive is set to {\bf no} (default) then only one job of a given name + may run at one time, and the action that Bacula takes to ensure only + one job runs is determined by the other directives (see below). + + If {\bf Allow Duplicate Jobs} is set to {\bf no} and two jobs + are present and none of the three directives given below permit + cancelling a job, then the current job (the second one started) + will be cancelled. + +\item [Allow Higher Duplicates = \lt{}yes\vb{}no\gt{}] +\index[general]{Allow Higher Duplicates} + This directive was implemented in version 5.0.0, but does not work + as expected. If used, it should always be set to no. In later versions + of Bacula the directive is disabled (disregarded). + + +\item [Cancel Lower Level Duplicates = \lt{}yes\vb{}no\gt{}] +\index[general]{Cancel Lower Level Duplicates} + If \textbf{Allow Duplicates Jobs} is set to \textbf{no} and this + directive is set to \textbf{yes}, Bacula will choose between duplicated + jobs the one with the highest level. For example, it will cancel a + previous Incremental to run a Full backup. It works only for Backup + jobs. The default is \texttt{no}. If the levels of the duplicated + jobs are the same, nothing is done and the other + Cancel XXX Duplicate directives will be examined. + +\item [Cancel Queued Duplicates = \lt{}yes\vb{}no\gt{}] +\index[general]{Cancel Queued Duplicates} + If {\bf Allow Duplicate Jobs} is set to {\bf no} and + if this directive is set to {\bf yes} any job that is + already queued to run but not yet running will be canceled. + The default is {\bf no}. + +\item[Cancel Running Duplicates = \lt{}yes\vb{}no\gt{}] +\index[general]{Cancel Running Duplicates} + If {\bf Allow Duplicate Jobs} is set to {\bf no} and + if this directive is set to {\bf yes} any job that is already running + will be canceled. The default is {\bf no}. + + +%%\item[DuplicateJobProximity = \lt{}time-specification\gt{}] +%%\index[general]{Duplicate Job Proximity} +%% This directive permits to determine if two jobs are really duplicated. +%% If the first one is running for long time, this is probably not a good +%% idea to cancel it. + \item [Run = \lt{}job-name\gt{}] \index[dir]{Run} \index[dir]{Directive!Run} @@ -1913,24 +2024,15 @@ 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\vb{}no] - \index[dir]{SpoolData} - \index[dir]{Directive!SpoolData} - tells Bacula to request the Storage daemon to spool data to a disk file - before writing it to the Volume (normally a tape). Thus the data is - written in large blocks to the Volume rather than small blocks. This - directive is particularly useful when running multiple simultaneous - backups to tape. It prevents interleaving of the job data and reduces - or eliminates tape drive stop and start commonly known as "shoe-shine". -\item [SpoolSize={\it bytes}] - \index[dir]{SpoolSize} - \index[dir]{Directive!SpoolSize} - where the bytes specify the maximum spool size for this job. - The default is take from Device Maximum Spool Size limit. - This directive is available only in Bacula version 2.3.5 or - later. +\item [Accurate=yes\vb{}no] + \index[dir]{Accurate} + \index[dir]{Directive!Accurate} + tells Bacula to use or not the Accurate code for the specific job. It can + allow you to save memory and and CPU resources on the catalog server in some + cases. + \item [WritePartAfterJob=yes\vb{}no] \index[dir]{WritePartAfterJob} \index[dir]{Directive!WritePartAfterJob} @@ -2248,6 +2350,14 @@ console run command. This directive is required. 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. +\item [Maximum Bandwidth Per Job = \lt{}speed\gt{}] +\index[dir]{Maximum Bandwidth Per Job} +\index[dir]{Directive!Maximum Bandwidth Per Job} + +The speed parameter specifies the maximum allowed bandwidth that a job may use +when started for this Client. The speed parameter should be specified in +k/s, Kb/s, m/s or Mb/s. + \item [Priority = \lt{}number\gt{}] \index[dir]{Priority} \index[dir]{Directive!Priority} @@ -3058,7 +3168,7 @@ Job { File-0002}, ... With the exception of Job specific variables, you can test your {\bf - LabelFormat} by using the \ilink{ var command}{var} the Console Chapter + LabelFormat} by using the \ilink{var command}{var} the Console Chapter of this manual. In almost all cases, you should enclose the format specification (part