From: Kern Sibbald <kern@sibbald.com>
Date: Mon, 24 Mar 2014 10:38:56 +0000 (+0100)
Subject: Tweak add more new feature documentation
X-Git-Tag: Release-7.0.0~7
X-Git-Url: https://git.sur5r.net/?p=bacula%2Fdocs;a=commitdiff_plain;h=ba12f3955e6b7aadf68f2a9cb083bc4a39b96e72

Tweak add more new feature documentation
---

diff --git a/docs/manuals/en/main/newfeatures.tex b/docs/manuals/en/main/newfeatures.tex
index 519db8b4..433c0381 100644
--- a/docs/manuals/en/main/newfeatures.tex
+++ b/docs/manuals/en/main/newfeatures.tex
@@ -84,6 +84,63 @@ finish up to ten times faster with this version of Bacula.  This is
 built-in to the Storage daemon, so it happens automatically and
 transparently.
 
+\subsection{VirtualFull Backup Consolidation Enhancements}
+By default Bacula selects jobs automatically for a VirtualFull,
+however, you may want to create the Virtual backup based on a
+particular backup (point in time) that exists.
+
+For example, if you have the following backup Jobs in your catalog:
+\begin{verbatim}
++-------+---------+-------+----------+----------+-----------+
+| JobId | Name    | Level | JobFiles | JobBytes | JobStatus |
++-------+---------+-------+----------+----------+-----------+
+| 1     | Vbackup | F     | 1754     | 50118554 | T         |
+| 2     | Vbackup | I     | 1        | 4        | T         |
+| 3     | Vbackup | I     | 1        | 4        | T         |
+| 4     | Vbackup | D     | 2        | 8        | T         |
+| 5     | Vbackup | I     | 1        | 6        | T         |
+| 6     | Vbackup | I     | 10       | 60       | T         |
+| 7     | Vbackup | I     | 11       | 65       | T         |
+| 8     | Save    | F     | 1758     | 50118564 | T         |
++-------+---------+-------+----------+----------+-----------+
+\end{verbatim}
+
+and you want to consolidate only the first 3 jobs and create a
+virtual backup equivalent to Job 1 + Job 2 + Job 3, you will use
+\texttt{jobid=3} in the \texttt{run} command, then Bacula will select the
+previous Full backup, the previous Differential (if any) and all subsequent
+Incremental jobs.
+
+\begin{verbatim}
+run job=Vbackup jobid=3 level=VirtualFull
+\end{verbatim}
+
+If you want to consolidate a specific job list, you must specify the exact
+list of jobs to merge in the run command line.  For example, to consolidate
+the last Differential and all subsequent Incremental, you will use
+\texttt{jobid=4,5,6,7} or \texttt{jobid=4-7} on the run command line. As one
+of the Job in the list is a Differential backup, Bacula will set the new job
+level to Differential. If the list is composed only with Incremental jobs,
+the new job will have a level set to Incremental.
+
+\begin{verbatim}
+run job=Vbackup jobid=4-7 level=VirtualFull
+\end{verbatim}
+
+When using this feature, Bacula will automatically discard jobs that are
+not related to the current Job.  For example, specifying
+\texttt{jobid=7,8}, Bacula will discard JobId 8 because it is not
+part of the same backup Job.
+
+We do not recommend it, but really want to consolidate jobs that have
+different names (so probably different clients, filesets, etc...), you must
+use \texttt{alljobid=} keyword instead of \texttt{jobid=}.
+
+\begin{verbatim}
+run job=Vbackup alljobid=1-3,6-8 level=VirtualFull
+\end{verbatim}
+
+
 \subsection{FD Storage Address}
 
 When the Director is behind a NAT, in a WAN area, to connect to