]> git.sur5r.net Git - bacula/docs/commitdiff
Update
authorKern Sibbald <kern@sibbald.com>
Sat, 14 Apr 2007 07:56:36 +0000 (07:56 +0000)
committerKern Sibbald <kern@sibbald.com>
Sat, 14 Apr 2007 07:56:36 +0000 (07:56 +0000)
docs/manual/install.tex
docs/manual/mysql.tex
docs/manual/postgresql.tex
docs/manual/requirements.tex
docs/manual/tips.tex
docs/manual/win32.tex

index 2a0db4c7a54e0ecdac5a9cac47b5dca769bcdf55..67559734e85a268c34e8f5b278f702340645211d 100644 (file)
@@ -63,14 +63,19 @@ the Bacula CVS. The released files are:
 \section{Upgrading Bacula}
 \index[general]{Bacula!Upgrading}
 \index[general]{Upgrading Bacula}
+\index[general]{Upgrading}
 
 If you are upgrading from one Bacula version to another, you should first
-carefully read the ReleaseNotes of all versions between your current
+carefully read the ReleaseNotes of all major versions between your current
 version and the version to which you are upgrading.  If the Bacula catalog
 database has been upgraded (as it is almost every major release), you will
 either need to reinitialize your database starting from scratch (not
 normally a good idea), or save an ASCII copy of your database, then proceed
-to upgrade it.  This is normally done after Bacula is build and installed
+to upgrade it. If you are upgrading two major versions (e.g. 1.36 to 2.0)
+then life will be more complicated because you must do two database
+upgrades. See below for more on this.
+
+Upgrading the catalog is normally done after Bacula is build and installed
 by:
 
 \begin{verbatim}
@@ -96,7 +101,8 @@ change. If this is confusing, simply read the ReleaseNotes very carefully as
 they will note if all daemons must be upgraded at the same time. 
 
 Finally, please note that in general it is not necessary to do a 
-{\bf make uninstall} before doing an upgrade. In fact, if you do so, you will 
+{\bf make uninstall} before doing an upgrade providing you are careful
+not to change the installation directories. In fact, if you do so, you will 
 most likely delete all your conf files, which could be disastrous.
 The normal procedure during an upgrade is simply:
 
index 076dc01e4fca83bbe88c555a3efff3a3056fe880..240b147dc330a6764c7a4957fdd8c918a1b90954 100644 (file)
@@ -219,6 +219,7 @@ device name for your machine.
 \section{Linking Bacula with MySQL}
 \index[general]{Linking Bacula with MySQL }
 \index[general]{MySQL!Linking Bacula with }
+\index[general]{Upgrading}
 
 After configuring Bacula with 
 
@@ -280,6 +281,7 @@ This will be the same with most other package managers too.
 \section{Upgrading MySQL}
 \index[general]{Upgrading MySQL }
 \index[general]{Upgrading!MySQL }
+\index[general]{Upgrading}
 If you upgrade MySQL, you must reconfigure, rebuild, and re-install 
 Bacula otherwise you are likely to get bizarre failures.  If you
 install from rpms and you upgrade MySQL, you must also rebuild Bacula.
index aa567a1b0a35f2dcef5fbdf09085d4914db2684e..217adcbab161c480f79a315f4991248b87236fff 100644 (file)
@@ -5,6 +5,7 @@
 \label{PostgreSqlChapter}
 \index[general]{PostgreSQL!Installing and Configuring }
 \index[general]{Installing and Configuring PostgreSQL }
+\index[general]{Upgrading}
 
 Warning!!! If you are considering using PostreSQL, you should be aware
 of their philosophy of upgrades, which could be 
@@ -411,6 +412,7 @@ SELECT SETVAL('pool_poolid_seq', (SELECT MAX(poolid) FROM pool));
 \section{Upgrading PostgreSQL}
 \index[general]{Upgrading PostgreSQL }
 \index[general]{Upgrading!PostgreSQL }
+\index[general]{Upgrading}
 If you upgrade PostgreSQL, you must reconfigure, rebuild, and re-install 
 Bacula otherwise you are likely to get bizarre failures.  If you
 to modify the bacula.spec file to account for the new PostgreSQL version.
index 208aaca0d9c9fcc6ea535f8421f02f647c280c1c..2038cfe5208902c64f85cf1aaf12c482eb9e94ca 100644 (file)
@@ -7,28 +7,30 @@
 \index[general]{Requirements!System }
 
 \begin{itemize}
-\item {\bf Bacula} has been compiled and run on Red Hat Linux, FreeBSD, and
+\item {\bf Bacula} has been compiled and run on OpenSuSE Linux, FreeBSD, and
    Solaris systems. 
 \item It requires GNU C++ version 2.95 or higher to compile. You can try  with
    other compilers and older versions, but you are on your own.  We have
-   successfully compiled and used Bacula on RH8.0/RH9/RHEL 3.0/FC3  with GCC 3.4.
-Note, in general GNU C++ is a separate package (e.g.  RPM) from GNU C, so you
-need them both loaded. On Red Hat systems, the C++ compiler is part of the
-{\bf gcc-c++} rpm package. 
-\item There are certain third party packages that Bacula needs.  Except for
+   successfully compiled and used Bacula using GNU C++ version 4.1.3.
+   Note, in general GNU C++ is a separate package (e.g.  RPM) from GNU C, so you
+   need them both loaded. On Red Hat systems, the C++ compiler is part of the
+   {\bf gcc-c++} rpm package. 
+\item There are certain third party packages that Bacula may need.  Except for
    MySQL and PostgreSQL, they can all be found in the  {\bf depkgs} and {\bf
-   depkgs1} releases. 
-\item If you want to build the Win32 binaries, you will need a  Microsoft
-   Visual C++ compiler (or Visual Studio).  Although all components build
-   (console has  some warnings), only the File daemon has been tested. 
+   depkgs1} releases. However, most current Linux and FreeBSD systems
+   provide these as system packages.
+\item If you want to build the Win32 binaries, please see the
+   README.mingw32 file in the src/win32 directory. We cross-compile the
+   Win32 release on Linux. We provide documentation on building the Win32
+   version, but due to the complexity, you are pretty much on your own
+   if you want to build it yourself.
 \item {\bf Bacula} requires a good implementation of pthreads to work.  This
    is not the case on some of the BSD systems. 
 \item The source code has been written with portability in mind and is  mostly
    POSIX compatible. Thus porting to any POSIX compatible  operating system
    should be relatively easy. 
-\item The GNOME Console program is developed and tested under GNOME 2.x. It 
-   also runs under GNOME 1.4 but this version is deprecated and  thus no longer
-   maintained. 
+\item The GNOME Console program is developed and tested under GNOME 2.x.
+   GNOME 1.4 is no longer supported.
 \item The wxWidgets Console program is developed and tested with the latest 
    stable ANSI or Unicode version of 
    \elink{wxWidgets}{http://www.wxwidgets.org/} (2.6.1).  It works fine with the
@@ -44,8 +46,13 @@ need them both loaded. On Red Hat systems, the C++ compiler is part of the
    loaded (libtermcap-devel or ncurses-devel). 
 \item If you want to use DVD as backup medium, you will need to download the
    \elink{dvd+rw-tools 5.21.4.10.8}{http://fy.chalmers.se/~appro/linux/DVD+RW/},
-   apply the \elink{patch}{http://cvs.sourceforge.net/viewcvs.py/*checkout*/bacula/bacula/patches/dvd+rw-tools-5.21.4.10.8.bacula.patch}
+   apply the patch that is in the {\bf patches} directory of the main
+   source tree
    to make these tools compatible with Bacula, then compile and install them.
-   Do not use the dvd+rw-tools provided by your distribution, they will not work
-   with Bacula.
+   There is also a patch for dvd+rw-tools version 6.1, and we hope that the
+   patch is integrated into a later version.
+   Do not use the dvd+rw-tools provided by your distribution, unless you
+   are sure it contains the patch. dvd+rw-tools without the patch will not
+   work with Bacula. DVD media is not recommended for serious or important
+   backups because of its low reliability.
 \end{itemize}
index c32aa625d0a1f99fc684b696d798af43b8d3e345..c84d50aaa08e0b6922a912ff6608dff74dcb9eec 100644 (file)
@@ -16,10 +16,11 @@ distribution.
 \label{upgrading}
 \index[general]{Upgrading Bacula Versions }
 \index[general]{Versions!Upgrading Bacula }
+\index[general]{Upgrading}
 
 The first thing to do before upgrading from one version to another is to
-ensure that you don't overwrite or delete your production (current) version of Bacula until
-you have tested that the new version works. 
+ensure that you don't overwrite or delete your production (current) version
+of Bacula until you have tested that the new version works.
 
 If you have installed Bacula into a single directory, this is simple: simply
 make a copy of your Bacula directory. 
@@ -848,11 +849,13 @@ care about the data on the tapes) is to add the tape labels using the console
 {\bf add} command, then go into the catalog and manually set the VolStatus of
 every tape to {\bf Recycle}. 
 
-The SQL command to do this is very simple: 
+The SQL command to do this is very simple, either use your vendor's
+command line interface (mysql, postgres, sqlite, ...) or use the sql
+command in the Bacula console:
 
 \footnotesize
 \begin{verbatim}
-update Media set VolStatus = "Recycle";
+update Media set VolStatus='Recycle';
 \end{verbatim}
 \normalsize
 
index 2379da0655d47b2846fe58c77053e4f13e1584b4..00b8e6d27768707987789c419f2e9dae6985888f 100644 (file)
@@ -102,6 +102,7 @@ Bacula, so we don't recommend that option.
 
 \addcontentsline{lof}{figure}{Win32 Component Selection Dialog}
 \includegraphics{./win32-pkg.eps}  
+\index[general]{Upgrading}
 
 \item If you are installing for the first time, you will  be asked to
    enter some very basic information about your configuration. If
@@ -179,7 +180,15 @@ Windows Add/Remove Programs dialog found on the Control panel.
 Sometimes Win32 machines the File daemon may have very slow
 backup transfer rates compared to other machines.  To you might
 try setting the Maximum Network Buffer Size to 32,768 in both the
-File daemon and in the Storage daemon.
+File daemon and in the Storage daemon. The default size is larger,
+and apparently some Windows ethernet controllers do not deal with          
+a larger network buffer size.
+
+Many Windows ethernet drivers have a tendency to either run slowly 
+due to old broken firmware, or because they are running in half-duplex
+mode. Please check with the ethernet card manufacturer for the latest
+firmware and use whatever techniques are necessary to ensure that the 
+card is running in duplex.
 
 If you are not using the portable option, and you have VSS
 (Volume Shadow Copy) enabled in the Director, and you experience
@@ -196,6 +205,12 @@ problems, you might have to turn on VSS debugging.  The following
 link describes how to do this:
 \elink{http://support.microsoft.com/kb/887013/en-us}{\url{http://support.microsoft.com/kb/887013/en-us}}.
 
+In Microsoft Windows Small Business Server 2003 the VSS Writer for Exchange
+is turned off by default. To turn it on, please see the following link:
+\elink{http://support.microsoft.com/default.aspx?scid=kb;EN-US;Q838183}{\url{
+http://support.microsoft.com/default.aspx?scid=kb;EN-US;Q838183}}
+
+
 The most likely source of problems is authentication when the Director
 attempts to connect to the File daemon that you installed. This can occur if
 the names and the passwords defined in the File daemon's configuration file