]> git.sur5r.net Git - bacula/docs/commitdiff
ebl cleanup + recyclepool option
authorEric Bollengier <eric@eb.homelinux.org>
Sat, 27 Sep 2008 12:23:59 +0000 (12:23 +0000)
committerEric Bollengier <eric@eb.homelinux.org>
Sat, 27 Sep 2008 12:23:59 +0000 (12:23 +0000)
docs/manuals/en/concepts/newfeatures.tex

index 4fb1b02d41e68419c23e202d37fcf6db576af302..59c7aa20445c45dece59b93646c2d44dc2cee1b9 100644 (file)
@@ -438,27 +438,32 @@ you can backup any kind of data (ASCII or binary) depending
 on the program called.
 
 \section{libdbi framework}
-As a general guideline, Bacula has support for a few catalog database drivers coded natively by the Bacula team. 
-With the libdbi implementation, which is a Bacula driver that uses libdbi to access the catalog, we have an 
-open field to use many different kinds database engines following the needs of users.
-
-The according to libdbi (http://libdbi.sourceforge.net/) project: libdbi implements a database-independent 
-abstraction layer in C, similar to the DBI/DBD layer in Perl. Writing one generic set of code, 
-programmers can leverage the power of multiple databases and multiple simultaneous database 
+As a general guideline, Bacula has support for a few catalog database drivers
+coded natively by the Bacula team.  With the libdbi implementation, which is a
+Bacula driver that uses libdbi to access the catalog, we have an open field to
+use many different kinds database engines following the needs of users.
+
+The according to libdbi (http://libdbi.sourceforge.net/) project: libdbi
+implements a database-independent abstraction layer in C, similar to the
+DBI/DBD layer in Perl. Writing one generic set of code, programmers can
+leverage the power of multiple databases and multiple simultaneous database
 connections by using this framework.
 
-Currently the libdbi driver in Bacula project only supports the same drivers natively coded in Bacula. 
-However the libdbi project has support for many others database engines. You can view the list at http://libdbi-drivers.sourceforge.net/. In the future all those drivers can be supported by Bacula,
-however, they must be tested properly by the Bacula team. 
+Currently the libdbi driver in Bacula project only supports the same drivers
+natively coded in Bacula.  However the libdbi project has support for many
+others database engines. You can view the list at
+http://libdbi-drivers.sourceforge.net/. In the future all those drivers can be
+supported by Bacula, however, they must be tested properly by the Bacula team.
 
 Some of benefits of using libdbi are:
 \begin{itemize}
- \item The possibility to use proprietary databases engines in which your proprietary 
-licenses prevent the Bacula team from developing the driver.
+\item The possibility to use proprietary databases engines in which your
+  proprietary licenses prevent the Bacula team from developing the driver.
  \item The possibility to use the drivers written for the libdbi project.
- \item The possibility to use other database engines without recompiling Bacula to use them. 
-       Just change one line in bacula-dir.conf
- \item Abstract Database access, this is, unique point to code and profiling catalog database access.
+ \item The possibility to use other database engines without recompiling Bacula
+   to use them.  Just change one line in bacula-dir.conf
+ \item Abstract Database access, this is, unique point to code and profiling
+   catalog database access.
  \end{itemize}
  
  The following drivers have been tested:
@@ -469,14 +474,15 @@ licenses prevent the Bacula team from developing the driver.
  \item SQLite3
  \end{itemize}
 
-In the future, we will test and approve to use others databases engines (proprietary or not) like DB2, Oracle, Microsoft SQL.
+ In the future, we will test and approve to use others databases engines
+ (proprietary or not) like DB2, Oracle, Microsoft SQL.
 
-To compile Bacula to support libdbi we need to configure the code with the --with-dbi and --with-dbi-driver=[database] 
-./configure options, where [database] is the database engine to be used with Bacula 
-(of course we can change the driver in file bacula-dir.conf, see below). 
-We must configure the access port of the database engine with the option 
---with-db-port, because the libdbi framework doesn't know the default access port 
-of each database.
+ To compile Bacula to support libdbi we need to configure the code with the
+ --with-dbi and --with-dbi-driver=[database] ./configure options, where
+ [database] is the database engine to be used with Bacula (of course we can
+ change the driver in file bacula-dir.conf, see below).  We must configure the
+ access port of the database engine with the option --with-db-port, because the
+ libdbi framework doesn't know the default access port of each database.
 
 The next phase is checking (or configuring) the bacula-dir.conf, example:
 \begin{verbatim}
@@ -487,9 +493,9 @@ Catalog {
 }
 \end{verbatim}
 
-The parameter {\bf dbdriver} indicates that we will use the driver dbi with a mysql database. 
-Currently the drivers supported by Bacula are: postgresql, mysql, sqlite, sqlite3; 
-these are the names that may be added to string "dbi:".
+The parameter {\bf dbdriver} indicates that we will use the driver dbi with a
+mysql database.  Currently the drivers supported by Bacula are: postgresql,
+mysql, sqlite, sqlite3; these are the names that may be added to string "dbi:".
 
 The following limitations apply when Bacula is set to use the libdbi framework:
  - Not tested on the Win32 platform
@@ -497,13 +503,15 @@ The following limitations apply when Bacula is set to use the libdbi framework:
    The reason is bound with the database driver provided by libdbi and the 
    simple fact that one more layer of code was added.
 
-It is important to remember, when compiling Bacula with libdbi, the following packages are needed:
+It is important to remember, when compiling Bacula with libdbi, the
+following packages are needed:
  \begin{itemize}
   \item libdbi version 1.0.0, http://libdbi.sourceforge.net/
   \item libdbi-drivers 1.0.0, http://libdbi-drivers.sourceforge.net/
  \end{itemize}
  
-You can download them and compile them on your system or install the packages from your OS distribution.
+ You can download them and compile them on your system or install the packages
+ from your OS distribution.
 
 
 \section{Display Autochanger Content}
@@ -522,8 +530,9 @@ The {\bf status slots storage=\lt{}storage-name\gt{}} command displays autochang
 \end{verbatim}
 \normalsize
 
-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.
+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.
 
 \section{Miscellaneous}
 \index[general]{Misc New Features}
@@ -594,6 +603,13 @@ version of Linux, and thus now provides correct autostart routines.
 Since Ubuntu officially supports Bacula, you can also obtain any
 recent release of Bacula from the Ubuntu repositories.
 
+\item[Recycling enhancements]
+The new \textbf{RecyclePool} directive defines to which pool the Volume will
+be placed (moved) when it is recycled. Without this directive, a Volume will
+remain in the same pool when it is recycled. With this directive, it can be
+moved automatically to any existing pool during a recycle. This directive is
+probably most useful when defined in the Scratch pool, so that volumes will
+be recycled back into the Scratch pool.
 
 \item [FD Version]
 The File daemon to Director protocol now includes a version