From: Eric Bollengier <eric@eb.homelinux.org>
Date: Sat, 28 Mar 2009 13:52:52 +0000 (+0000)
Subject: ebl  Document dbcheck -B, dbport and new mysql indexes for
X-Git-Tag: Release-3.0.0~83
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=e180748d3ed27e2709ea75ba0b44b24355a79970;p=bacula%2Fdocs

ebl  Document dbcheck -B, dbport and new mysql indexes for
     Path and Filename orphaned elimination speedup
---

diff --git a/docs/manuals/en/concepts/newfeatures.tex b/docs/manuals/en/concepts/newfeatures.tex
index 501c8718..98fb7af5 100644
--- a/docs/manuals/en/concepts/newfeatures.tex
+++ b/docs/manuals/en/concepts/newfeatures.tex
@@ -1280,6 +1280,28 @@ A new director directive permits to specify the maximum number of Console
 Connections that could run concurrently. The default is set to 20, but you may
 set it to a larger number.
 
+\subsection{dbcheck enhancements}
+If you are using Mysql, dbcheck will now ask you if you want to create
+temporary indexes to speed up orphaned Path and Filename elimination. 
+
+A new \texttt{-B} option allows you to print catalog information in a simple
+text based format. This is useful to backup it in a secure way.
+
+\begin{verbatim}
+ $ dbcheck -B 
+ catalog=MyCatalog
+ db_type=SQLite
+ db_name=regress
+ db_driver=
+ db_user=regress
+ db_password=
+ db_address=
+ db_port=0
+ db_socket=
+\end{verbatim} %$
+
+You can now specify the database connection port in the command line.
+
 \section{Building Bacula Plugins}
 There is currently one sample program {\bf example-plugin-fd.c} and
 one working plugin {\bf bpipe-fd.c} that can be found in the Bacula
diff --git a/docs/manuals/en/utility/progs.tex b/docs/manuals/en/utility/progs.tex
index 9187970d..f45f4fa8 100644
--- a/docs/manuals/en/utility/progs.tex
+++ b/docs/manuals/en/utility/progs.tex
@@ -1049,8 +1049,8 @@ It is called:
 
 \footnotesize
 \begin{verbatim}
-Usage: dbcheck [-c config] [-C catalog name] [-d debug_level]
-<working-directory> <bacula-database> <user> <password> [<dbhost>]
+Usage: dbcheck [-c config ] [-B] [-C catalog name] [-d debug_level] 
+  <working-directory> <bacula-database> <user> <password> [<dbhost>] [<dbport>]
        -b              batch mode
        -C              catalog name in the director conf file
        -c              director conf filename
@@ -1061,6 +1061,23 @@ Usage: dbcheck [-c config] [-C catalog name] [-d debug_level]
 \end{verbatim}
 \normalsize
 
+If the \textbf{-B} option is specified, dbcheck will print out catalog
+information in a simple text based format. This is useful to backup it in a
+secure way.
+
+\begin{verbatim}
+ $ dbcheck -B 
+ catalog=MyCatalog
+ db_type=SQLite
+ db_name=regress
+ db_driver=
+ db_user=regress
+ db_password=
+ db_address=
+ db_port=0
+ db_socket=
+\end{verbatim} %$
+
 If the {\bf -c} option is given with the Director's conf file, there is no
 need to enter any of the command line arguments, in particular the working
 directory as dbcheck will read them from the file. 
@@ -1171,6 +1188,10 @@ The inconsistencies examined are the following:
    regardless of their age. 
 \end{itemize}
 
+
+If you are using Mysql, dbcheck will ask you if you want to create temporary
+indexes to speed up orphaned Path and Filename elimination.
+
 By the way, I personally run dbcheck only where I have messed up
 my database due to a bug in developing Bacula code, so normally
 you should never need to run dbcheck in spite of the