From f9c3a6b67f7cd78c6107bf4606443dd0d0abc604 Mon Sep 17 00:00:00 2001
From: Kern Sibbald <kern@sibbald.com>
Date: Wed, 8 Aug 2007 12:44:46 +0000
Subject: [PATCH] Updates

---
 docs/developers/version.tex    |  2 +-
 docs/manual-de/version.tex     |  2 +-
 docs/manual/bimagemgr.tex      |  2 +-
 docs/manual/bugs.tex           |  2 +-
 docs/manual/catmaintenance.tex | 43 +++++++++++++++++++++++++++++-
 docs/manual/gpl.tex            | 22 ++++++++--------
 docs/manual/install.tex        | 48 ++++++++++++++++++++++------------
 docs/manual/version.tex        |  2 +-
 8 files changed, 90 insertions(+), 33 deletions(-)

diff --git a/docs/developers/version.tex b/docs/developers/version.tex
index 76a5117b..191b5866 100644
--- a/docs/developers/version.tex
+++ b/docs/developers/version.tex
@@ -1 +1 @@
-2.1.29 (22 July 2007)
+2.1.29 (08 August 2007)
diff --git a/docs/manual-de/version.tex b/docs/manual-de/version.tex
index 76a5117b..191b5866 100644
--- a/docs/manual-de/version.tex
+++ b/docs/manual-de/version.tex
@@ -1 +1 @@
-2.1.29 (22 July 2007)
+2.1.29 (08 August 2007)
diff --git a/docs/manual/bimagemgr.tex b/docs/manual/bimagemgr.tex
index 4be2f862..48ca14ed 100644
--- a/docs/manual/bimagemgr.tex
+++ b/docs/manual/bimagemgr.tex
@@ -40,7 +40,7 @@
 \date{\vspace{1.0in}\today \\
       This manual documents Bacula version \input{version} \\
       ~\vspace{0.2in}\\
-      Copyright \copyright 1999-2006, Free Software Foundation Europe e.V.
+      Copyright \copyright 1999-2007, Free Software Foundation Europe e.V.
       \\
       ~\vspace{0.2in}\\
   Permission is granted to copy, distribute and/or modify this document under the terms of the \\
diff --git a/docs/manual/bugs.tex b/docs/manual/bugs.tex
index 27fcd897..42df829d 100644
--- a/docs/manual/bugs.tex
+++ b/docs/manual/bugs.tex
@@ -12,7 +12,7 @@ have a
 Generally, when a bug is fixed, a patch for the currently released version will
 be attached to the bug report.
 
-The directory {\bf patches} in the current CVS always contains a list of 
+The directory {\bf patches} in the current SVN always contains a list of 
 the patches that have been created for the previously released version
 of Bacula. In addition, the file {\bf patches-version-number} in the 
 {\bf patches} directory contains a summary of each of the patches.
diff --git a/docs/manual/catmaintenance.tex b/docs/manual/catmaintenance.tex
index 576b4f15..637b3acc 100644
--- a/docs/manual/catmaintenance.tex
+++ b/docs/manual/catmaintenance.tex
@@ -173,11 +173,52 @@ running dbcheck before (or possibly after) using the MySQL database repair
 program. It can clean up many of the orphaned record problems, and certain
 other inconsistencies in the Bacula database. 
 
+A typical cause of MySQL database problems is if your partition fills. In
+such a case, you will need to create additional space on the partition or
+free up some space then repair the database probably using {\bf myisamchk}.
+Recently my root partition filled and the MySQL database was corrupted.
+Simply running {\bf myisamchk -r} did not fix the problem. However,
+the following script did the trick for me:
+
+\footnotesize
+\begin{verbatim}
+#!/bin/sh
+for i in *.MYD ; do
+  mv $i x${i}
+  t=`echo $i | cut -f 1 -d '.' -`
+  mysql bacula <<END_OF_DATA
+set autocommit=1;
+truncate table $t;
+quit
+END_OF_DATA
+  cp x${i} ${i}
+  chown mysql:mysql ${i}
+  myisamchk -r ${t}
+done
+\end{verbatim}
+\normalsize
+
+I invoked it with the following commands:
+
+\footnotesize
+\begin{verbatim}
+cd /var/lib/mysql/bacula
+./repair
+\end{verbatim}
+\normalsize
+
+Then after ensuring that the database was correctly fixed, I did:
+\footnotesize
+\begin{verbatim}
+cd /var/lib/mysql/bacula
+rm -f x*.MYD
+\end{verbatim}
+\normalsize
+
 \section{MySQL Table is Full}
 \index[general]{Database!MySQL Table is Full}
 \index[general]{MySQL Table is Full}
 
-
 If you are running into the error {\bf The table 'File' is full ...}, 
 it is probably because on version 4.x MySQL, the table is limited by   
 default to a maximum size of 4 GB and you have probably run into
diff --git a/docs/manual/gpl.tex b/docs/manual/gpl.tex
index b40ec57c..a368afc7 100644
--- a/docs/manual/gpl.tex
+++ b/docs/manual/gpl.tex
@@ -155,17 +155,17 @@ also meet all of these conditions:
 \item {\bf b)} You must cause any work that you distribute or  publish, that
    in whole or in part contains or is derived from the Program or  any part
    thereof, to be licensed as a whole at no charge to all third parties  under
-the terms of this License.  
+   the terms of this License.  
 
 \item {\bf c)} If the modified program normally reads commands  interactively
    when run, you must cause it, when started running for such  interactive use in
    the most ordinary way, to print or display an announcement  including an
-appropriate copyright notice and a notice that there is no  warranty (or else,
-saying that you provide a warranty) and that users may  redistribute the
-program under these conditions, and telling the user how to  view a copy of
-this License. (Exception: if the Program itself is interactive  but does not
-normally print such an announcement, your work based on the  Program is not
-required to print an announcement.) 
+   appropriate copyright notice and a notice that there is no  warranty (or else,
+   saying that you provide a warranty) and that users may  redistribute the
+   program under these conditions, and telling the user how to  view a copy of
+   this License. (Exception: if the Program itself is interactive  but does not
+   normally print such an announcement, your work based on the  Program is not
+   required to print an announcement.) 
 \end{itemize}
 
 These requirements apply to the modified work as a whole. If identifiable
@@ -199,14 +199,14 @@ Section 2) in object code or executable form under the terms of Sections 1 and
 \item {\bf b)} Accompany it with a written offer, valid for at least  three
    years, to give any third party, for a charge no more than your cost of 
    physically performing source distribution, a complete machine-readable copy of
-the corresponding source code, to be distributed under the terms of Sections
-1  and 2 above on a medium customarily used for software interchange; or,  
+   the corresponding source code, to be distributed under the terms of Sections
+   1  and 2 above on a medium customarily used for software interchange; or,  
 
 \item {\bf c)} Accompany it with the information you received as to  the offer
    to distribute corresponding source code. (This alternative is  allowed only
    for noncommercial distribution and only if you received the  program in object
-code or executable form with such an offer, in accord with  Subsection b
-above.) 
+   code or executable form with such an offer, in accord with  Subsection b
+   above.) 
 \end{itemize}
 
 The source code for a work means the preferred form of the work for making
diff --git a/docs/manual/install.tex b/docs/manual/install.tex
index d8272dd2..9d457004 100644
--- a/docs/manual/install.tex
+++ b/docs/manual/install.tex
@@ -13,7 +13,7 @@ However, Bacula needs certain third party packages (such as {\bf MySQL},
 options you specify.  Normally, {\bf MySQL} and {\bf PostgreSQL} are
 packages that can be installed on your distribution.  However, if you do
 not have them, to simplify your task, we have combined a number of these
-packages into two {\bf depkgs} releases (Dependency Packages).  This can
+packages into three {\bf depkgs} releases (Dependency Packages).  This can
 vastly simplify your life by providing you with all the necessary packages
 rather than requiring you to find them on the Web, load them, and install
 them.
@@ -169,7 +169,7 @@ When the minor number is odd, it indicates that the package is under
 development and thus may not be stable. For example, while the current 
 production release of Bacula is currently 1.38.11, the current development
 version is 1.39.22. All patch versions of the development code are 
-available in the CVS (source repository).  However, not all patch versions
+available in the SVN (source repository).  However, not all patch versions
 of the development code (odd minor version) are officially released. When
 they are released, they are released as beta versions (see below for a
 definition of what beta means for Bacula releases).                     
@@ -197,9 +197,8 @@ The purpose of the beta releases is to allow early adopter users to test
 the new code.  Beta releases are made with the following considerations:
 
 \begin{itemize}
-\item The code passes the regression testing on Linux and 
-  FreeBSD machines. Including tape drive testing
-  on Linux and FreeBSD.
+\item The code passes the regression testing on FreeBSD, Linux, and Solaris
+  machines.
 
 \item There are no known major bugs, or on the rare occasion that 
   there are, they will be documented or already in the bugs database.
@@ -255,12 +254,15 @@ Although the exact composition of the dependency packages may change from time
 to time, the current makeup is the following: 
 
 \addcontentsline{lot}{table}{Dependency Packages}
-\begin{longtable}{|l|l|}
+\begin{longtable}{|l|l|l|}
  \hline 
-\multicolumn{1}{|c| }{\bf 3rd Party Package} & \multicolumn{1}{c| }{\bf depkgs} \\
- \hline {SQLite } & \multicolumn{1}{c| }{X } \\
- \hline {SQLite3 } & \multicolumn{1}{c| }{X } \\
- \hline {mtx } & \multicolumn{1}{c| }{X } \\
+\multicolumn{1}{|c| }{\bf 3rd Party Package} & \multicolumn{1}{c| }{\bf depkgs}
+     & \multicolumn{1}{c| }{\bf depkgs-qt} \\
+ \hline {SQLite } & \multicolumn{1}{c| }{X } & \multicolumn{1}{c| }{ }\\
+ \hline {SQLite3 } & \multicolumn{1}{c| }{X } & \multicolumn{1}{c| }{ }\\
+ \hline {mtx } & \multicolumn{1}{c| }{X } & \multicolumn{1}{c| }{ } \\
+ \hline {qt4 } & \multicolumn{1}{c| }{ } & \multicolumn{1}{c| }{X } \\
+ \hline {qwt } & \multicolumn{1}{c| }{ } & \multicolumn{1}{c| }{X } \\
  \hline 
 \end{longtable}
 
@@ -284,6 +286,9 @@ You should build the packages that you will require in {\bf depkgs} a
 prior to configuring and building Bacula, since Bacula will need
 them during the build process. 
 
+For more information on the {\bf depkgs-qt} package, please read the
+INSTALL file in the main directory of that package.
+
 Even if you do not use SQLite, you might find it worthwhile to build {\bf mtx}
 because the {\bf tapeinfo} program that comes with it can often provide you
 with valuable information about your SCSI tape drive (e.g. compression,
@@ -337,14 +342,16 @@ The basic installation is rather simple.
    And you have already installed the additional  rpms noted above.  
 
    SQLite is not supported on Solaris. This is because it
-   frequently fails with bus errors.
+   frequently fails with bus errors.  However SQLite3 may work.
 
 \item Detar the Bacula source code preferably into the {\bf bacula}  directory
    discussed above.  
 
 \item {\bf cd} to the directory containing the source code.  
 
-\item ./configure (with appropriate options as described below)  
+\item ./configure (with appropriate options as described below). Any
+   path names you specify as options on the ./configure command line
+   must be absolute paths and not relative.
 
 \item Check the output of ./configure very carefully, especially  the Install
    binaries and Install config directories.  If they are not correct,
@@ -355,7 +362,6 @@ The basic installation is rather simple.
 \item If after running ./configure once, you decide to change options  and
    re-run it, that is perfectly fine, but before re-running it,  you should run: 
 
-
 \footnotesize
 \begin{verbatim}
       make distclean
@@ -678,13 +684,22 @@ customize your installation.
    bat needs the qwt package installed on your system.  Please see the next
    configure item for the details.
 
+   Qt4 is available on OpenSUSE 10.2, CentOS 5, Fedora, and Debian. If it
+   is not available on your system, you can download the {\bf depkgs-qt}
+   package from the Bacula Source Forge download area and build it and
+   the qwt package, both of which are needed to build bat.  See the
+   INSTALL file in that package for more details.
+
 \item [ {-}{-}with-qwt=\lt{}path\gt{} ]
   \index[general]{{-}{-}with-qwt}
   To build bat, you need the qwt graphics package installed on
-  your system.  The qwt package is available for download from
+  your system.  The path specified must be an absolute path and
+  not relative.  
+
+  The qwt package is available for download from
   the qwt project on Source Forge.  If you wish, you may build and 
-  install it on your system (by default in /usr/lib).  If you have
-  done so, you would specify:
+  install it on your system (by default in /usr/lib). 
+  If you have done so, you would specify:
 
 \begin{verbatim}
  --with-qwt=/usr/lib/qwt-5.0.2
@@ -703,6 +718,7 @@ customize your installation.
    to manually add a soft link to the name they use or use the
    depkgs version, which handles the naming correctly.
 
+
 \item [ {-}{-}enable-batch-insert ]
    \index[general]{{-}{-}enable-batch-insert}
    This option enables batch inserts of the attribute records (default) in
diff --git a/docs/manual/version.tex b/docs/manual/version.tex
index 76a5117b..191b5866 100644
--- a/docs/manual/version.tex
+++ b/docs/manual/version.tex
@@ -1 +1 @@
-2.1.29 (22 July 2007)
+2.1.29 (08 August 2007)
-- 
2.39.5