]> git.sur5r.net Git - bacula/docs/commitdiff
added an entire line in ansi-labels and made some bold changes in faq.
authorJo Simoens <polyglot@users.sourceforge.net>
Sun, 15 May 2005 22:45:20 +0000 (22:45 +0000)
committerJo Simoens <polyglot@users.sourceforge.net>
Sun, 15 May 2005 22:45:20 +0000 (22:45 +0000)
Please review.

docs/manual/ansi-labels.tex
docs/manual/faq.tex
docs/manual/python.tex

index a1d22afbe53e13fabb75d8be590434b7b0f2ad97..ee8664b9c5abbd71452ee155513fe1a514ac27cf 100644 (file)
@@ -27,7 +27,7 @@ names to a maximum of 6 characters.
 
 \begin{description}
 \item [ Label Type = ANSI | IBM | Bacula]  
-  This directive is implemented in Director Pool resource and in SD Device
+  This directive is implemented in the Director Pool resource and in the SD Device
   resource.  If it is specified in the SD Device resource, it will take
   precedence over the value passed from the Director to the SD.
 \end{description}
@@ -37,12 +37,12 @@ names to a maximum of 6 characters.
 
 \begin{description}
 \item [ Label Type = ANSI | IBM | Bacula]  
-  This directive is implemented in Director Pool resource and in SD Device
-  resource.  If it is specified in the SD Device resource, it will take
+  This directive is implemented in the Director Pool resource and in the SD Device
+  resource.  If it is specified in the the SD Device resource, it will take
   precedence over the value passed from the Director to the SD.
 
 \item [Check Labels = yes | no]
-  This directive is implemented in the SD Device resource.  If you intend
+  This directive is implemented in the the SD Device resource.  If you intend
   to read ANSI or IBM labels, this *must* be set.  Even if the volume is
   not ANSI labeled, you can set this to yes, and Bacula will check the
   label type.
index cb94f54bd8f8b7e07eadbbb549dca545cf3e3124..d518eb6a71167ad8217eb3e4d7298902ca86a11d 100644 (file)
@@ -36,7 +36,7 @@ of known bugs and solutions.
    \index[general]{What language is Bacula written in? }
    It is written in C++, but it is mostly C  code using only a limited set of the
    C++ extensions  over C.  Thus Bacula is completely  compiled using the C++
-   compiler. There are several modules,  including the Win32 interface that are
+   compiler. There are several modules,  including the Win32 interface that is
    written using the  object oriented C++ features. Over time, we are slowly
    adding a larger  subset of C++.  
 
@@ -44,7 +44,7 @@ of known bugs and solutions.
 \item [On what machines does Bacula run? ]
    \index[general]{On what machines does Bacula run? }
    {\bf Bacula} builds and executes on RedHat Linux (versions  RH7.1-RHEL 3.0,
-   SuSE, Gentoo, Debian, Mandrake, ...), FreeBSD,  Solaris, Alpha, SGI (client),
+   SUSE, Gentoo, Debian, Mandriva, ...), FreeBSD,  Solaris, Alpha, SGI (client),
    NetBSD, OpenBSD, Mac OS X (client),  and Win32 (client).  
 
    Bacula has been my only backup tool for over  four years backing up 5 machines
@@ -58,21 +58,21 @@ of known bugs and solutions.
    unimplemented or partially implemented features.  With a program of this size
    (100,000+ lines of C++ code  not including the SQL programs) there are bound
    to be bugs.  The current test environment (a twisted pair local network and a
-   HP DLT  backup tape) is rather ideal, so additional testing on other  sites is
+   HP DLT  backup tape) is not exactly ideal, so additional testing on other  sites is
    necessary. The File daemon has never crashed -- running  months at a time with
    no intervention. The Storage daemon is  remarkably stable with most of the
    problems arising during labeling  or switching tapes. Storage daemon crashes
    are rare.  The Director, given the multitude of functions it fulfills is  also
-   relatively stable. In a production environment, it rarely  if ever crashes. Of
-   the three daemons, the Director is the most  prone to having problems. It
-   frequently runs several months with  no problems.  
+   relatively stable. In a production environment, it rarely if ever crashes. Of
+   the three daemons, the Director is the most  prone to having problems. Still, it
+   frequently runs several months with  no problems.
 
    There are a number of reasons for this stability.  
 
    \begin{enumerate}
    \item The program was largely written by one person to date
       (Kern).\\
-   \item  The program constantly is checking the chain of allocated
+   \item  The program is constantly checking the chain of allocated
       memory buffers to ensure that no overruns have occurred.  \\
    \item All  memory leaks (orphaned buffers) are reported each time the
       program  terminates.\\
@@ -89,13 +89,13 @@ of known bugs and solutions.
 \item [I'm Getting Authorization Errors. What is Going On? ]
    \index[general]{I'm Getting Authorization Errors. What is Going On? }
    For security reasons, Bacula requires that both  the File daemon and the
-   Storage daemon know the name  of the Director as well as his password. As a
+   Storage daemon know the name  of the Director as well as its password. As a
    consequence,  if you change the Director's name or password, you must  make
-   the corresponding change in the Storage daemon and  in the File daemon
+   the corresponding change in the Storage daemon's and  in the File daemon's
    configuration files.  
 
    During the authorization process, the Storage daemon  and File daemon also
-   require that the Director authenticate  itself, so both ends require the other
+   require that the Director authenticates  itself, so both ends require the other
    to have the correct  name and password.  
 
    If you have edited the conf files and modified any name or  any password, and
@@ -123,7 +123,7 @@ of known bugs and solutions.
 
    In the left column, you will find the Director, Storage, and  Client
    resources, with their names and passwords -- these  are all in {\bf
-   bacula-dir.conf}. In the right column  are where the corresponding values
+   bacula-dir.conf}. The right column is where the corresponding values
    should be found in the  Console, Storage daemon (SD), and File daemon (FD)
    configuration  files.  
 
@@ -145,7 +145,7 @@ when you move the mouse over  the icon.
    you can ping the client machine using the same  address as in the Client
    record.  
 \item You have a firewall, and it is blocking traffic on port  9102 between
-   the Director's machine and the Clients  machine (or on port 9103 between the
+   the Director's machine and the Client's  machine (or on port 9103 between the
    Client and the Storage daemon  machines).  
 \item Your password or names are not correct in both the Director and  the
    Client machine. Try configuring everything identical to  how you run the
@@ -196,7 +196,7 @@ where you need to adjust the device name for your system.
    \index[general]{I Run a Restore Job and Bacula Hangs. What do I do? }
    On Bacula version 1.25 and prior, it expects you to  have the correct tape
    mounted prior to a restore. On  Bacula version 1.26 and higher, it will ask
-   you for the  tape, and if the wrong one it mounted, it will inform you.  
+   you for the  tape, and if the wrong one is mounted, it will inform you.  
 
    If you have previously done an {\bf unmount} command, all  Storage daemon
    sessions (jobs) will be completely blocked  from using the drive unmounted, so
@@ -237,12 +237,12 @@ following:
 \normalsize
 
 This will cause the FD to write a file {\bf bacula.trace}  in the current
-directory, which you can examine and determine  the problem.  
+directory, which you can examine and thereby determine  the problem.  
 
 \label{scroll}
 \item [When I Start the Console, the Error Messages Fly By. How can I see
    them? ]
-   \index[general]{When I Start the Console, the Error Messages Fly By. How can I seethem? }
+   \index[general]{When I Start the Console, the Error Messages Fly By. How can I see them? }
    Either use a shell window with a scroll bar, or use the gnome-console.  In any
    case, you probably should be logging all output to a file, and  then you can
    simply view the file using an editor or the {\bf less}  program. To log all
@@ -314,13 +314,13 @@ FAQ for how to do so.
    \ilink{Backing Up to Disk}{_ChapterStart39}.  
 
 \label{bigfiles}
-\item [Can Bacula Backup and Restore Files Greater than 2 Giga bytes in
+\item [Can Bacula Backup and Restore Files Greater than 2 Gigabytes in
    Size?  ]
-\index[general]{Can Bacula Backup and Restore Files Greater than 2 Giga bytes in
+\index[general]{Can Bacula Backup and Restore Files Greater than 2 Gigabytes in
 Size? }
 If your operating system permits it, and you are running Bacula  version 1.26
 or later, the answer is yes. To the best of our  knowledge all client system
-supported by Bacula can handle  files larger than 2 Giga bytes.  
+supported by Bacula can handle  files larger than 2 Gigabytes.  
 
 \label{cancel}
 \item [I Started A Job then Decided I Really Did Not Want to Run It. Is
@@ -361,7 +361,7 @@ please use the one distributed in the source code.
 
 \item [How Can I Be Sure that Bacula Really Saves and Restores All Files? ]
    \index[general]{How Can I Be Sure that Bacula Really Saves and Restores
-   All Files?  } It is really quite simple, but took me awhile to figure
+   All Files?  } It is really quite simple, but took me a while to figure
    out how to ``prove'' it.  First make a Bacula Rescue disk, see the
    \ilink{Disaster Recovery Using Bacula}{_ChapterStart38} of this manual.
    Second, you run a full backup of all your files on all partitions.
@@ -376,17 +376,19 @@ please use the one distributed in the source code.
    directory modification and access dates and the files changed during the
    boot, your system is identical to what it was before you wiped your hard
    disk.
+   Alternatively you could do the wiping and restoring to another computer
+   of the same type.
 
 \label{upgrade}
 \item [I did a Full backup last week, but now in running an Incremental,
-   Bacula  says it did not find a FULL backup time, so it did a FULL backup. Why?]
+   Bacula  says it did not find a FULL backup, so it did a FULL backup. Why?]
    \index[general]{I did a Full backup last week, but now in running an
-   Incremental, Bacula says it did not find a FULL backup time, so it did a
+   Incremental, Bacula says it did not find a FULL backup, so it did a
    FULL backup.  Why?  } Before doing an Incremental or a Differential
    backup, Bacula checks to see if there was a prior Full backup of the
    same Job that terminated successfully.  If so, it uses the date that
    full backup started as the time for comparing if files have changed.  If
-   Bacula does not find a successfully full backup, it proceeds to do one.
+   Bacula does not find a successful full backup, it proceeds to do one.
    Perhaps you canceled the full backup, or it terminated in error.  In
    such cases, the full backup will not be successful.  You can check by
    entering {\bf list jobs} and look to see if there is a prior Job with
@@ -410,7 +412,7 @@ please use the one distributed in the source code.
    fixed length path and filename lengths.  Over the years, these
    restrictions have been relaxed allowing longer names.  Bacula on the
    other hand was designed in 2000, and so from the start, Path and
-   Filenames have been keep in buffers that start at 256 bytes in length
+   Filenames have been kept in buffers that start at 256 bytes in length,
    but can grow as needed to handle any length.  Most of the work is
    carried out by lower level routines making the coding rather easy.
 
@@ -420,7 +422,7 @@ please use the one distributed in the source code.
    is hard to come up with unique features when backup programs for Unix
    machines have been around since the 1960s.  That said, I believe that
    Bacula is the first and only program to use a standard SQL interface to
-   its catalog database.  Although this adds a bit of complexity and
+   catalog its database.  Although this adds a bit of complexity and
    possibly overhead, it provides an amazingly rich set of features that
    are easy to program and enhance.  The current code has barely scratched
    the surface in this regard (version 1.31).
@@ -490,7 +492,7 @@ manual.
    tools such as {\bf mt}. This compression works  independently of Bacula.  
    
    Bacula also has compression code, which is normally used only when  backing up
-   to file Volumes. There are two conditions for this  ''software`` to be
+   to file Volumes. There are two conditions for this  ''software`` to become
    enabled.  
 
 \begin{enumerate}
@@ -500,7 +502,7 @@ manual.
    zlib-devel} rpm.  
 
  If the library is found by Bacula during the {\bf ./configure}  it will be
in dicated on the {\bf config.out} line by:  
mentioned in the {\bf config.out} line by:  
 
 \footnotesize
 \begin{verbatim}
@@ -568,12 +570,12 @@ there is not much we can do.
 
 \label{WaitForever}
 \item [I am Backing Up an Offsite Machine with an Unreliable Connection.
-   The  Director Waits Forever for the Client to Contact the SD. What Can  I Do.]
+   The  Director Waits Forever for the Client to Contact the SD. What Can  I Do?]
    \index[general]{I am Backing Up an Offsite Machine with an Unreliable Connection.
-   The Director Waits Forever for the Client to Contact the SD. What Can I Do}
+   The Director Waits Forever for the Client to Contact the SD. What Can I Do?}
    Bacula was written  on the assumption that it will have a good TCP/IP
    connection  between all the daemons. As a consequence, the current  Bacula
-   doesn't deal with faulty connection very well. This situation  is slowly being
+   doesn't deal with faulty connections very well. This situation  is slowly being
    corrected over time.  
    
    There are several things you can do to improve the situation.  
@@ -687,6 +689,6 @@ Another solution might be to run the daemon with the debug  option by:
 \normalsize
 
 This will cause the FD to write a file {\bf bacula.trace}  in the current
-directory, which you can examine and determine  the problem.  
+directory, which you can examine to determine  the problem.  
 
 \end{description}
index 6943c6a76716551e1bbb51e34f63850da9e06e60..c0adf1e361c2f22712aa46f74555bee4e5bfb2e5 100644 (file)
@@ -11,7 +11,7 @@ You may be asking what Python is and why a scripting language is
 needed in Bacula. The answer to the first question is that Python
 is an Object Oriented scripting language with features similar
 to those found in Perl, but the syntax of the language is much
-cleaner and simpler.  The answer to why scripting in Bacula is to
+cleaner and simpler.  The answer to why have scripting in Bacula is to
 give the user more control over the whole backup process. Probably 
 the simplest example is when Bacula needs a new Volume name, with
 a scripting language such as Python, you can generate any name 
@@ -33,7 +33,7 @@ runs in Bacula's address space, so even though it is an interpreted
 language, it is very efficient.
 
 When the Director starts, it looks to see if you have a {\bf
-Scripts Directory} defined, if so, it looks in that director for
+Scripts Directory} defined, if so, it looks in that directory for
 a file named {\bf DirStartUp}. If it is found, Bacula will pass this
 file to Python for execution.
 
@@ -78,7 +78,7 @@ There are four Python objects that you will need to work with:
 \item [The Job Object]
    When a Job starts, and assuming you have defined a JobStart method
    in your Bacula Events Class, Bacula will create a Job Object. This
-   object will be passed to the JobStart event. The Job Object has
+   object will be passed to the JobStart event. The Job Object has a
    has good number of read-only members or attributes providing many
    details of the Job, and it also has a number of writable attributes
    that allow you to pass information into the Job.  These attributes
@@ -164,7 +164,7 @@ class JobEvents:
 \end{verbatim}
 \normalsize
 
-Here, you JobEvents class method NewVolume will be called each time
+Here, your JobEvents class method NewVolume will be called each time
 the Job needs a new Volume name.  To actually register the events defined
 in your class with the Job, you must instantiate the JobEvents class and
 set it in the Job {\be set_events} variable. Note, this is a bit different 
@@ -286,7 +286,7 @@ class BaculaEvents:
 bacula.set_events(BaculaEvents()) # register daemon events desired
 
 """
-  There are the Job events that you can receive.
+  These are the Job events that you can receive.
 """
 class JobEvents:
   def __init__(self):