From: Kern Sibbald Date: Sat, 14 Apr 2007 07:56:36 +0000 (+0000) Subject: Update X-Git-Tag: Release-2.2.0~732 X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=c957321e0c7ff8d440bcc1fd5755536e9c53b8a8;p=bacula%2Fdocs Update --- diff --git a/docs/manual/install.tex b/docs/manual/install.tex index 2a0db4c7..67559734 100644 --- a/docs/manual/install.tex +++ b/docs/manual/install.tex @@ -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: diff --git a/docs/manual/mysql.tex b/docs/manual/mysql.tex index 076dc01e..240b147d 100644 --- a/docs/manual/mysql.tex +++ b/docs/manual/mysql.tex @@ -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. diff --git a/docs/manual/postgresql.tex b/docs/manual/postgresql.tex index aa567a1b..217adcba 100644 --- a/docs/manual/postgresql.tex +++ b/docs/manual/postgresql.tex @@ -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. diff --git a/docs/manual/requirements.tex b/docs/manual/requirements.tex index 208aaca0..2038cfe5 100644 --- a/docs/manual/requirements.tex +++ b/docs/manual/requirements.tex @@ -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} diff --git a/docs/manual/tips.tex b/docs/manual/tips.tex index c32aa625..c84d50aa 100644 --- a/docs/manual/tips.tex +++ b/docs/manual/tips.tex @@ -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 diff --git a/docs/manual/win32.tex b/docs/manual/win32.tex index 2379da06..00b8e6d2 100644 --- a/docs/manual/win32.tex +++ b/docs/manual/win32.tex @@ -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