From eb35ad4e3c74e3080de2fb88aaf857b51813ac86 Mon Sep 17 00:00:00 2001
From: Eric Bollengier <eric@baculasystems.com>
Date: Mon, 4 Feb 2013 09:48:45 +0100
Subject: [PATCH] Prepare some notes for the new virtualfull feature

---
 docs/manuals/en/main/migration.tex | 54 ++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)

diff --git a/docs/manuals/en/main/migration.tex b/docs/manuals/en/main/migration.tex
index 71f60e60..2147ed19 100644
--- a/docs/manuals/en/main/migration.tex
+++ b/docs/manuals/en/main/migration.tex
@@ -606,3 +606,57 @@ it is an Increment). This is so that if another incremental is done, which
 will be based on the Virtual Full, it will backup all files from the
 last Job included in the Virtual Full rather than from the time the Virtual
 Full was actually run.
+
+% \subsection{Manually Specify Jobs to Consolidate}
+% By default Bacula is selecting jobs automatically, however, you may want to
+% choose any point in time for the Virtual backup.
+%
+% For example, if you have the following Jobs in your catalog:
+% \begin{lstlisting}
+% +-------+---------+-------+----------+----------+-----------+
+% | 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{lstlisting}
+%
+% If 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{lstlisting}
+% run job=Vbackup jobid=3 level=VirtualFull
+% \end{lstlisting}
+%
+% 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} in 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{lstlisting}
+% run job=Vbackup jobid=4-7 level=VirtualFull
+% \end{lstlisting}
+%
+% 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 the jobid 8.
+%
+% If you know what you are doing and still want to consolidate jobs that have
+% different names, you must use \texttt{alljobid=} keyword instead of
+% \texttt{jobid=}.
+%
+% \begin{lstlisting}
+% run job=Vbackup alljobid=1-3,6-8 level=VirtualFull
+% \end{lstlisting}
+
-- 
2.39.5