ebl improve doc about multiple runscript

[bacula/docs] / docs / manuals / en / concepts / newfeatures.tex

diff --git a/docs/manuals/en/concepts/newfeatures.tex b/docs/manuals/en/concepts/newfeatures.tex
index bb63c965403d7c7c72f2ff2ebc006e788a511ba7..6fc21f76617f276ac800909e1dfc0fc9c00de33c 100644 (file)
--- a/docs/manuals/en/concepts/newfeatures.tex
+++ b/docs/manuals/en/concepts/newfeatures.tex
@@ -276,8 +276,8 @@ then Bacula will not backup the two directories named:
 \section{Accurate}
 \index[general]{Accurate Backup}
 As with most other backup programs, Bacula decides what files to backup 
-for Incremental and Differental backup by comparing the change (st_ctime)
-and modification (st_mtime) times of the file to the time the last backup completed.
+for Incremental and Differental backup by comparing the change (st\_ctime)
+and modification (st\_mtime) times of the file to the time the last backup completed.
 If one of those two times is later than the last backup time, then the file
 will be backed up.  This does not, however, permit tracking what files have
 been deleted and will miss any file with an old time that may have been
@@ -316,12 +316,12 @@ The {\bf status slots storage=\lt{}storage-name\gt{}} command displays autochang
 
 \footnotesize
 \begin{verbatim}
- Slot |  Volume Name    |  Status  |  Media Type       |    Pool        |  Loaded |
-------+-----------------+----------+-------------------+----------------+---------|
-    1 |           00001 |   Append |  DiskChangerMedia |        Default |    0    |
-    2 |           00002 |   Append |  DiskChangerMedia |        Default |    0    |
-    3*|           00003 |   Append |  DiskChangerMedia |        Scratch |    0    |
-    4 |                 |          |                   |                |    0    |
+ Slot |  Volume Name  |  Status  |  Media Type       |   Pool     |  Loaded |
+------+---------------+----------+-------------------+------------+---------|
+    1 |         00001 |   Append |  DiskChangerMedia |    Default |    0    |
+    2 |         00002 |   Append |  DiskChangerMedia |    Default |    0    |
+    3*|         00003 |   Append |  DiskChangerMedia |    Scratch |    0    |
+    4 |               |          |                   |            |    0    |
 \end{verbatim}
 \normalsize
 
@@ -332,10 +332,12 @@ command to synchronize autochanger content with your catalog.
 \index[general]{Misc New Features}
 \begin{description}
 \item [Virtual Tape Emulation]
-We now have a Virtual Tape emulator that allows us to run though 99.9\% of the 
-tape code but actually reading and writing to a disk file. This feature is most
-useful in testing.
-It is enabled by using {\bf Device Type = vtape} in the Storage daemon's Device
+
+We now have a Virtual Tape emulator that allows us to run though 99.9\% of
+the tape code but actually reading and writing to a disk file. Used with the
+\textbf{disk-changer} script, you can now emulate an autochanger with 10 drives
+and 700 slots. This feature is most useful in testing.  It is enabled
+by using {\bf Device Type = vtape} in the Storage daemon's Device
 directive. This feature is only implemented on Linux machines.
 
 \item [Bat Enhancements]
@@ -351,6 +353,19 @@ The {\bf RunScript} resource has been enhanced to permit multiple
 commands per RunScript.  Simply specify multiple {\bf Command} directives
 in your RunScript.
 
+\begin{verbatim}
+Job {
+  Name = aJob
+  RunScript {
+    Command = "/bin/echo test"
+    Command = "/bin/echo an other test"
+    Command = "/bin/echo 3 commands in the same runscript"
+    RunsWhen = Before
+  }
+ ...
+}
+\end{verbatim}
+
 A new Client RunScript {\bf RunsWhen} keyword of {\bf AfterVSS} has been implemented, which
 runs the command after the Volume Shadow Copy has been made.
 
@@ -364,5 +379,41 @@ may remove it before the final release.
 The bconsole {\bf status dir} output has been enhanced to indicate
 Storage daemon job spooling and despooling activity.
 
+\item [Statistics Enhancements]
+
+If you (or you boss) want to have statistics on your backups, you could use
+some SQL stuffs on the Job table to report how many:
+\begin{itemize}
+\item jobs have run
+\item jobs have been successful
+\item files have been backuped
+\item ...
+\end{itemize}
+
+Theses statistics are accurate only if your job retention is greater than
+your statistic period. Ie, if jobs are purged from the catalog, you won't be
+able to use them.
+
+Now, you can configure bacula to copy Job records to a new JobStat table
+with the \textbf{Use Statistics = \lt{}yes|no\gt{}} Job directive.
+
+The \texttt{Statistics Retention = \lt{}time\gt{}} director 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.
+
+Theses statistics records aren't use for restore purpose, but mainly for
+capacity planning, billings, etc.
+
+\begin{verbatim}
+Job {
+  Name = ImportantBackup
+  Client = rufus-fd
+  ...
+  Use Statistics = yes
+}
+\end{verbatim}
+
 
 \end{description}