From c4f97ca5d1f3ec5b1a5da66c628af0e29cd63998 Mon Sep 17 00:00:00 2001 From: Eric Bollengier Date: Sat, 27 Sep 2008 12:23:59 +0000 Subject: [PATCH] ebl cleanup + recyclepool option --- docs/manuals/en/concepts/newfeatures.tex | 74 ++++++++++++++---------- 1 file changed, 45 insertions(+), 29 deletions(-) diff --git a/docs/manuals/en/concepts/newfeatures.tex b/docs/manuals/en/concepts/newfeatures.tex index 4fb1b02d..59c7aa20 100644 --- a/docs/manuals/en/concepts/newfeatures.tex +++ b/docs/manuals/en/concepts/newfeatures.tex @@ -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 -- 2.39.5