]> git.sur5r.net Git - bacula/docs/commitdiff
Fix new features links
authorKern Sibbald <kern@sibbald.com>
Sat, 26 Nov 2011 14:17:21 +0000 (15:17 +0100)
committerKern Sibbald <kern@sibbald.com>
Sat, 26 Nov 2011 14:17:21 +0000 (15:17 +0100)
docs/manuals/en/main/newfeatures.tex

index 456696ecce630e514bdb97e7d918fdc1185b5751..069679ae030101f73f24d66f28218216843745c9 100644 (file)
@@ -1,7 +1,11 @@
-\chapter{New Features in 5.2.2}
+\chapter{New Features in 5.2.x}
 This chapter presents the new features that have been added to the next
 Community version of Bacula that is not yet released.
 
 This chapter presents the new features that have been added to the next
 Community version of Bacula that is not yet released.
 
+\chapter{New Features in 5.2.2}
+This chapter presents the new features that have been added to the current
+Community version of Bacula that is now released.
+
 \section{Additions to RunScript variables}
 You can have access to Director name using \%D in your runscript
 command.
 \section{Additions to RunScript variables}
 You can have access to Director name using \%D in your runscript
 command.
@@ -11,8 +15,8 @@ RunAfterJob = "/bin/echo Director=%D
 \end{verbatim}
 
 \chapter{New Features in 5.2.1}
 \end{verbatim}
 
 \chapter{New Features in 5.2.1}
-This chapter presents the new features that have been added to the current
-Community version of Bacula that is now released.
+This chapter presents the new features were added in the
+Community release version 5.2.1.
 
 There are additional features (plugins) available in the Enterprise version
 that are described in another chapter. A subscription to Bacula Systems
 
 There are additional features (plugins) available in the Enterprise version
 that are described in another chapter. A subscription to Bacula Systems
@@ -615,26 +619,88 @@ and is available with Bacula Enterprise Edition and Community Edition.
 
 \section{Class Based Database Backend Drivers}
 
 
 \section{Class Based Database Backend Drivers}
 
+The main Bacula Director code is independent of the SQL backend
+in version 2.5.0 and greater.  This means that the Bacula Director can be
+packaged by itself, then each of the different SQL backends supported can
+be packaged separately.  It is possible to build all the DB backends at the
+same time by including multiple database options at the same time.
+
+./configure can be run with multiple database configure options.
+\begin{verbatim}
+   --with-sqlite3
+   --with-mysql
+   --with-postgresql
+\end{verbatim}
+
+Order of testing for databases is:
+\begin{itemize}
+\item postgresql
+\item mysql
+\item sqlite3
+\end{itemize}
+
+Each configured backend generates a file named:
+\verb+libbaccats-<sql_backend_name>-<version>.so+ 
+A dummy catalog library is created named libbaccats-version.so
+
+At configure time the first detected backend is used as the so called
+default backend and at install time the dummy 
+\verb+libbaccats-<version>.so+ is replaced with the default backend type.
+
+If you configure all three backends you get three backend libraries and the
+postgresql gets installed as the default.  
+
+When you want to switch to another database, first save any old catalog you
+may have then you can copy one of the three backend libraries over the
+\verb+libbaccats-<version>.so+ e.g.
+
+An actual command, depending on your Bacula version might be:
+\begin{verbatim}
+   cp libbaccats-postgresql-5.2.2.so libbaccats-5.2.2.so
+\end{verbatim}
+
+where the \verb+5.2.2+ must be replaced by the Bacula release
+version number.
+
+Then you must update the default backend in the following files:
+
+\begin{verbatim}
+  create_bacula_database
+  drop_bacula_database
+  drop_bacula_tables
+  grant_bacula_privileges
+  make_bacula_tables
+  make_catalog_backup
+  update_bacula_tables 
+\end{verbatim}
+
+And re-run all the above scripts.  Please note, this means
+you will have a new empty database and if you had a previous
+one it will be lost.
+
 All current database backend drivers for catalog information are rewritten
 to use a set of multi inherited C++ classes which abstract the specific
 database specific internals and make sure we have a more stable generic
 All current database backend drivers for catalog information are rewritten
 to use a set of multi inherited C++ classes which abstract the specific
 database specific internals and make sure we have a more stable generic
-interface with the rest of sql code. From now on there is a strict boundery
-between the SQL code and the low-level database functions. This new interface
-should also make it easier to add a new backend for a currently unsupported
-database. As part of the rewrite the SQLite 2 code was removed (e.g. only
-SQLite 3 is now supported). An extra bonus of the new code is that you can
-configure multiple backends in the configure and build all backends in one
-compile session and select the correct database backend at install time.
-This should make it a lot easier for packages maintainers.
+interface with the rest of sql code.  From now on there is a strict
+boundery between the SQL code and the low-level database functions.  This
+new interface should also make it easier to add a new backend for a
+currently unsupported database.  As part of the rewrite the SQLite 2 code
+was removed (e.g.  only SQLite 3 is now supported).  An extra bonus of the
+new code is that you can configure multiple backends in the configure and
+build all backends in one compile session and select the correct database
+backend at install time.  This should make it a lot easier for packages
+maintainers.
+
+
 
 \medskip
 
 \medskip
-We also added cursor support for PostgreSQL backend, this improves memory usage
-for large installation.
+We also added cursor support for PostgreSQL backend, this improves memory
+usage for large installation.
 
 \medskip
 
 \medskip
-This project was implemented by Planets Communications B.V. and ELM Consultancy B.V.
-and Bacula Systems and is available with both the Bacula Enterprise Edition and
-the Community Edition.
+This project was implemented by Planets Communications B.V. and ELM
+Consultancy B.V. and Bacula Systems and is available with both the Bacula
+Enterprise Edition and the Community Edition.
 
 \section{Hash List Enhancements}
 
 
 \section{Hash List Enhancements}