]> git.sur5r.net Git - bacula/docs/commitdiff
Update
authorKern Sibbald <kern@sibbald.com>
Sat, 8 Dec 2007 20:07:56 +0000 (20:07 +0000)
committerKern Sibbald <kern@sibbald.com>
Sat, 8 Dec 2007 20:07:56 +0000 (20:07 +0000)
docs/manual/general.tex
docs/manual/install.tex
docs/manual/quickstart.tex
docs/manual/requirements.tex
docs/manual/state.tex
docs/manual/supportedoses.tex

index a7350d573e1263b39d0e4ac0ba4c75e25f6d29ac..b8dc2147c71845c20793ae816fa2a5ea3e0715d4 100644 (file)
@@ -370,9 +370,9 @@ chapter on
 
 \item [Service]
    \index[fd]{Service }
-   This is Windows terminology for a {\bf daemon} -- see  above. It is
-   frequently used in Unix environments as well. 
-% TODO: maybe do not say this is "Windows" terminology because it is common
+   This is a program that remains permanently in memory awaiting
+   instructions.  In Unix environments, services are also known as
+   {\bf daemons}. 
 
 \item [Storage Coordinates]
    \index[fd]{Storage Coordinates }
@@ -414,20 +414,13 @@ chapter on
    to a Volume agrees with what is stored in the Catalog (i.e.  it compares
    the file attributes), *or it can check the Volume contents against the
    original files on disk.
-% TODO: fix book for asterisk above and below
 
 \item [*Archive]
    \index[fd]{*Archive }
    An Archive operation is done after a Save, and it  consists of removing the
-Volumes on which data is saved from active  use. These Volumes are marked as
-Archived, and may no longer be  used to save files. All the files contained
-on an Archived Volume  are removed from the Catalog. NOT YET IMPLEMENTED. 
-
-\item [*Update]
-   \index[fd]{*Update }
-   An Update operation causes the files on the remote system to be updated to be
-the same as the host system. This is  equivalent to an {\bf rdist} capability.
-NOT YET IMPLEMENTED.  
+   Volumes on which data is saved from active  use. These Volumes are marked as
+   Archived, and may no longer be  used to save files. All the files contained
+   on an Archived Volume  are removed from the Catalog. NOT YET IMPLEMENTED. 
 
 \item [Retention Period]
    \index[fd]{Retention Period }
@@ -438,14 +431,19 @@ NOT YET IMPLEMENTED.
    in the Catalog database.  This should not be confused with the time that
    the data saved to a Volume is valid.
 
-% TODO: the following sentence is unclear to me
    The File Retention Period determines the time that File records are kept
-   in the catalog database.  This period is important because the volume of
-   the database File records by far use the most storage space in the
+   in the catalog database.  This period is important for two reasons: the
+   first is that as long as File records remain in the database, you
+   can "browse" the database with a console program and restore any
+   individual file. Once the File records are removed or pruned from the
+   database, the individual files of a backup job can no longer be
+   "browsed".  The second reason for carefully choosing the File Retention
+   Period is because the volume of
+   the database File records use the most storage space in the
    database.  As a consequence, you must ensure that regular "pruning" of
-   the database file records is done.  (See the Console {\bf retention}
+   the database file records is done to keep your database from growing 
+   too large. (See the Console {\bf prune}
    command for more details on this subject).
-% TODO: Where?
 
    The Job Retention Period is the length of time that Job records will be
    kept in the database.  Note, all the File records are tied to the Job
index 8782a293130f96563f021d9a48001a5997b9fa33..68bb413261161fc664a01bfe584a54f8d7c57fa4 100644 (file)
@@ -9,7 +9,8 @@
 In general, you will need the Bacula source release, and if you want to run
 a Windows client, you will need the Bacula Windows binary release.
 However, Bacula needs certain third party packages (such as {\bf MySQL},
-{\bf PostgreSQL}, or {\bf SQLite} to build properly depending on the
+{\bf PostgreSQL}, or {\bf SQLite} to build and run
+properly depending on the
 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
@@ -21,9 +22,9 @@ them.
 \section{Source Release Files}
 \index[general]{Source Files}
 \index[general]{Release Files}
-Beginning with Bacula 1.38.0, the source code has been broken into
-four separate tar files each corresponding to a different module in
-the Bacula SVN. The released files are:
+ Beginning with Bacula 1.38.0, the source code has been broken into
+ four separate tar files each corresponding to a different module in
+ the Bacula SVN. The released files are:
 
 \begin{description}
 \item [bacula-2.0.3.tar.gz]
index 3be9f14cdf7b24858336c1ef39f1499629a1bfb7..468a1acf618ec9579559fdd5362278abab730d17 100644 (file)
@@ -328,19 +328,13 @@ compatibility of Bacula and your system.  \label{notls}
 \section{Get Rid of the /lib/tls Directory}
 \index[general]{Directory!Get Rid of the /lib/tls }
 \index[general]{Get Rid of the /lib/tls Directory }
-
-% TODO: this seems dangerous -- how do you know if they don't use
-% TODO: /lib/tls for something mission critical? Reword this or point to
-% TODO: appropriate documentation.
-
-The new pthreads library {\bf /lib/tls} installed by default on recent Red Hat
-systems running Linux kernel 2.4.x is defective. You must remove it or rename it,
-then reboot your system before running Bacula otherwise after a week or so of
-running, Bacula will either block for long periods or deadlock entirely. 
-You may want to use the loader environment variable override rather
-than removing /lib/tls. Please see \ilink{ Supported Operating
-Systems}{SupportedOSes} for more
-information on this problem. 
+The new pthreads library {\bf /lib/tls} installed by default on recent Red
+Hat systems running Linux kernel 2.4.x is defective.  You must remove it or
+rename it, then reboot your system before running Bacula otherwise after a
+week or so of running, Bacula will either block for long periods or
+deadlock entirely.  You may want to use the loader environment variable
+override rather than removing /lib/tls.  Please see \ilink{ Supported
+Operating Systems}{SupportedOSes} for more information on this problem.
 
 This problem does not occur on systems running Linux 2.6.x kernels. 
 
index 8f72141287b686262dc3be5a002c09f4a7eead10..9dbeed98afea97de61c313d803b4c6dec47b657d 100644 (file)
@@ -20,7 +20,7 @@
    depkgs1} releases. However, most current Linux and FreeBSD systems
    provide these as system packages.
 \item The minimum versions for each of the databases supported by Bacula
-are:
+   are:
 
    \begin{itemize}
    \item MySQL 4.1
index 51cee05b61ead83d0785d4e404b5a0a912bf7b53..066d8f2fda915d376aed28f1e061b5ff80023721 100644 (file)
@@ -22,11 +22,10 @@ In other words, what is and what is not currently implemented and functional.
          (sometimes called multiplexing).
    \item Job sequencing using priorities.  
    \item \ilink{Console}{UADef} interface to the Director allowing complete
-      control. A shell, GNOME GUI and wxWidgets GUI versions of  the Console program
-      are available. Note, the GNOME GUI program currently  offers very few
-      additional features over the shell program. 
-      With version 2.2.0, a much more complete GUI interface has been
-      written, which is called the Bacula Admistration Tool, or bat.
+      control.  A shell, Qt4 GUI, GNOME GUI and wxWidgets GUI versions of
+      the Console program are available.  Note, the Qt4 GUI program called
+      the Bacula Administration tool or bat, offers many additional
+      features over the shell program.
    \end{itemize}
 
 \item Security
@@ -178,7 +177,7 @@ In other words, what is and what is not currently implemented and functional.
    commercial application, probably because that application  stores its catalog
    information in a large number of individual  files rather than an SQL database
    as Bacula does.  
-\item Aside from a GUI administrative interface, Bacula has a
+\item Aside from several GUI administrative interfaces, Bacula has a
    comprehensive shell administrative interface, which allows the
    administrator to use tools such as ssh to administrate any part of
    Bacula from anywhere (even from home).
@@ -220,7 +219,8 @@ In other words, what is and what is not currently implemented and functional.
    You must explicitly update the date/time stamp on all moved
    files (we have a project to correct this).
 \item File System Modules (configurable routines for
-   saving/restoring special files) are not yet implemented.
+   saving/restoring special files) are not yet implemented.  However,
+   this feature is easily implemented using RunScripts.
 \item Bacula supports doing backups and restores to multiple
    devices of different media type and multiple Storage daemons.
    However, if you have backed up a job to multiple storage
index d5bf0d1d33eb3c682220382e01963d1a7d559b1e..797b9eb2d5fa843a1ba146890cc7f3932d671219 100644 (file)
@@ -7,16 +7,15 @@
 \index[general]{Supported Operating Systems }
 
 \begin{itemize}
-\item Linux systems (built and tested on SuSE 10.2).
-\item Most flavors of Linux (Gentoo, Red Hat, Fedora, Mandriva, Debian, Ubuntu, ...).  
+\item Linux systems (built and tested on CentOS 5).
+\item Most flavors of Linux (Gentoo, Red Hat, Fedora, Mandriva, 
+      Debian, OpenSuSE, Ubuntu, Kubuntu, ...).  
 \item Solaris various versions.  
 \item FreeBSD (tape driver supported in 1.30 -- for FreeBSD older than
    version 5.0, please see some  {\bf important} considerations in the 
    \ilink{ Tape Modes on FreeBSD}{FreeBSDTapes}  section of the
    Tape Testing chapter of this manual.)  
-\item Windows (Win98/Me, WinNT/2K/XP) Client (File daemon) binaries.  
-\item Windows Vista VSS (Volume Shadow Copy) is reported not to work
-      with Bacula.
+\item Windows (Win98/Me, WinNT/2K/XP, Vista) Client (File daemon) binaries.  
 \item The Windows servers (Director and Storage daemon) are available
       in the binary Client installer.  The are reported to work in     
       many cases.  However they are NOT supported.   
 \item Tru64  
 \item Bacula is said to work on other systems (AIX, BSDI, HPUX, NetBSD, ...) but we
    do not have first hand knowledge  of these systems. 
-\item  RHat 7.2 AS2, AS3, AS4, Fedora Core 2,3,4,5, SuSE SLES 7,8,9,10,10.1 and Debian Woody and Sarge Linux on
-   S/390 and Linux on zSeries.
+\item  RHat 7.2 AS2, AS3, AS4, RHEL5, Fedora Core 2,3,4,5,6,7 SuSE SLES
+       7,8,9,10,10.1,10.2,10.3
+       and Debian Woody and Sarge Linux on
+      S/390 and Linux on zSeries.
 \item See the Porting chapter of the Bacula Developer's Guide  for information
    on porting to other systems.