]> git.sur5r.net Git - bacula/docs/commitdiff
Update
authorKern Sibbald <kern@sibbald.com>
Sat, 20 Dec 2008 11:44:48 +0000 (11:44 +0000)
committerKern Sibbald <kern@sibbald.com>
Sat, 20 Dec 2008 11:44:48 +0000 (11:44 +0000)
docs/manuals/en/concepts/concepts.kilepr
docs/manuals/en/concepts/newfeatures.tex

index 3878c019700fdc3bca039e3fecc40ebd31496bbf..fffca575b28c7927f9b74a4ff66028e7e8c98226 100644 (file)
@@ -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
 
index c752495085ffd0c54c09cc02610423ff24404813..6e13ba98c8aad8ad02033c2ec1e4152037594fd1 100644 (file)
@@ -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