From 645f9c0e720cb3192e65268608185eb9e03f2004 Mon Sep 17 00:00:00 2001 From: Kern Sibbald Date: Sat, 20 Dec 2008 11:44:48 +0000 Subject: [PATCH] Update --- docs/manuals/en/concepts/concepts.kilepr | 4 +- docs/manuals/en/concepts/newfeatures.tex | 65 ++++++++++++++++++------ 2 files changed, 52 insertions(+), 17 deletions(-) diff --git a/docs/manuals/en/concepts/concepts.kilepr b/docs/manuals/en/concepts/concepts.kilepr index 3878c019..fffca575 100644 --- a/docs/manuals/en/concepts/concepts.kilepr +++ b/docs/manuals/en/concepts/concepts.kilepr @@ -161,10 +161,10 @@ order=-1 [item:newfeatures.tex] archive=true -column=20 +column=92 encoding=UTF-8 highlight=LaTeX -line=76 +line=837 open=true order=0 diff --git a/docs/manuals/en/concepts/newfeatures.tex b/docs/manuals/en/concepts/newfeatures.tex index c7524950..6e13ba98 100644 --- a/docs/manuals/en/concepts/newfeatures.tex +++ b/docs/manuals/en/concepts/newfeatures.tex @@ -37,10 +37,16 @@ comparisons between every file in the FileSet and the list. \section{Copy Jobs} \index[general]{Copy Jobs} -A new {\bf Copy} job type has been implemented. It is essentially -identical to the existing Migration feature with the exception that +A new {\bf Copy} job type has been implemented. It is similar +to the existing Migration feature with the exception that the Job that is copied is left unchanged. This essentially creates -two identical copies of the same backup. The Copy Job runs without +two identical copies of the same backup. However, the copy is treated +as a copy rather than a backup job, and hence is not directly available for +restore. The {\bf restore} command will be upgraded to list copy jobs and +allow selection of copies if the keyword {\bf copies} is present on the +command line. The restore feature is still under implementation. + +The Copy Job runs without using the File daemon by copying the data from the old backup Volume to a different Volume in a different Pool. See the Migration documentation for additional details. For copy Jobs there is a new selection criterium @@ -501,7 +507,7 @@ The default value is {\bf no}. \index[general]{IgnoreDir} The {\bf ExcludeDirsContaining = \lt{}filename\gt{}} is a new directive that can be added to the Include section of the FileSet resource. If the specified -filename is found on the Client in any directory to be backed up, +filename ({\bf filename-string}) is found on the Client in any directory to be backed up, the whole directory will be ignored (not backed up). For example: @@ -545,15 +551,14 @@ files, directories, etc). \section{Bacula Plugins} \index[general]{Plugin} -Support for shared object plugins has been implemented in the Linux -(and Unix) File daemon. The API will be documented separately in +Support for shared object plugins has been implemented in the Linux, Unix +and Win32 File daemons. The API will be documented separately in the Developer's Guide or in a new document. For the moment, there is a single plugin named {\bf bpipe} that allows an external program to get control to backup and restore a file. Plugins are also planned (partially implemented) in the Director and the -Storage daemon. The code is also implemented to work on Win32 machines, -but it has not yet been tested. +Storage daemon. \subsection{Plugin Directory} Each daemon (DIR, FD, SD) has a new {\bf Plugin Directory} directive that may @@ -563,8 +568,6 @@ find the Bacula plugins. If this directive is not specified, Bacula will not load any plugins. Since each plugin has a distinctive name, all the daemons can share the same plugin directory. - - \subsection{Plugin Options} The {\bf Plugin Options} directive takes a quoted string arguement (after the equal sign) and may be specified in the @@ -685,7 +688,6 @@ on the program called. \section{Microsoft Exchange Server 2003/2007 Plugin} \subsection{Concepts} - Although it is possible to backup Exchange using Bacula VSS the Exchange plugin adds a good deal of functionality, because while Bacula VSS completes a full backup (snapshot) of Exchange, it does @@ -713,7 +715,6 @@ restoring at the individual mailbox or email item is not supported but can be simulated by use of the "Recovery" Storage Group (see below). \subsection{Installing} - The Exchange plugin requires a DLL that is shipped with Microsoft Exchanger Server called {\bf esebcli2.dll}. Assuming Exchange is installed correctly the Exchange plugin should find this automatically and run @@ -726,7 +727,6 @@ named esebcli2.dll and is found in C:\verb+\+Program Files\verb+\+Exchsrvr\verb+ default Exchange installation. \subsection{Backup up} - To back up an Exchange server the Fileset definition must contain at least {\bf Plugin = "exchange:/@EXCHANGE/Microsoft Information Store"} for the backup to work correctly. The 'exchange:' bit tells Bacula to look @@ -830,8 +830,14 @@ to back up, use the RegexWhere clause to remove the prefix of replace it with "/@EXCHANGE/Microsoft Information Store/Recovery Storage Group/". Then run the restore. -\subsection{Caveats} +\subsection{Restoring on Microsoft Server 2007} +Apparently the {\bf Exmerge} program no longer exists in Microsoft Server 2007, and henc +you use a new proceedure for recovering a single mail box. +This procedure is ducomented by Microsoft at: +\elink{http://technet.microsoft.com/en-us/library/aa997694.aspx}{http://technet.microsoft.com/en-us/library/aa997694.aspx}, +and involves using the {\bf Restore-Mailbox} and {\bf Get-MailboxStatistics} shell commands. +\subsection{Caveats} This plugin is still being developed, so you should consider it currently in BETA test, and thus use in a production environment should be done only after very careful testing. @@ -935,8 +941,9 @@ following packages are needed: You can download them and compile them on your system or install the packages from your OS distribution. +\section{Console Command Additions and Enhancements} -\section{Display Autochanger Content} +\subsection{Display Autochanger Content} \index[general]{StatusSlots} The {\bf status slots storage=\lt{}storage-name\gt{}} command displays @@ -957,6 +964,22 @@ If you an asterisk ({\bf *}) appears after the slot number, you must run an {\bf update slots} command to synchronize autochanger content with your catalog. +\subsection{list joblog job=xxx or jobid=nnn} +A new list command has been added that allows you to list the contents +of the Job Log stored in the catalog for either a Job Name (fully qualified) +or for a particular JobId. The {\bf llist} command will include a line with +the time and date of the entry. + +Note for the catalog to have Job Log entries, you must have a directive +such as: + +\begin{verbatim} + catalog = all +\end{verbatim} + +In your Director's {\bf Messages} resource. + + \section{Miscellaneous} \index[general]{Misc New Features} @@ -986,6 +1009,18 @@ catalog. With this new command, Bacula will ask if you want to specify a Regex expression for extracting only a part of the full backup. +\subsection{Bootstrap File Optimization Changes} +In order to permit proper seeking on disk files, we have extended the +bootstrap file format to include a {\bf VolStartAddr} and {\bf VolEndAddr} +records. Each takes a 64 bit unsigned integer range (i.e. nnn-mmm) which defines +the start address range and end address range respectively. These two directives +replace the {\bf VolStartFile}, {\bf VolEndFile}, {\bf VolStartBlock} and {\bf VolEndBlock} +directives. Bootstrap files containing the old directives will still work, but will not +properly take advantage of proper disk seeking, and may read completely to the end of a +disk volume during a restore. With the new format (automatically generated by the new +Director), restores will seek properly and stop reading the volume when all the files +have been restored. + \subsection{Solaris ZFS/NFSv4 ACLs} This is an upgrade of the previous Solaris ACL backup code to the new library format, which will backup both the old -- 2.39.5