From 8308f097b2dc07e859c81c61f20a1dcfa9726261 Mon Sep 17 00:00:00 2001
From: Kern Sibbald <kern@sibbald.com>
Date: Tue, 7 Jun 2005 19:25:01 +0000
Subject: [PATCH] Add latest changes

---
 docs/home-page/inc/header.php      |  2 +-
 docs/home-page/pages/bugs.php      | 49 +++++++++----------
 docs/home-page/pages/home.php      | 75 ++++++++++++++++-------------
 docs/home-page/pages/maillists.php |  4 +-
 docs/home-page/pages/support.php   | 76 +++++++++++++++++-------------
 docs/manual/Makefile               |  4 +-
 docs/manual/faq.tex                | 57 ++++++++++++----------
 docs/manual/install.tex            | 13 +++--
 docs/manual/tapetesting.tex        | 24 +++++++++-
 9 files changed, 176 insertions(+), 128 deletions(-)

diff --git a/docs/home-page/inc/header.php b/docs/home-page/inc/header.php
index f8e0cd48..f62a4bc6 100644
--- a/docs/home-page/inc/header.php
+++ b/docs/home-page/inc/header.php
@@ -123,7 +123,7 @@
         <div class="menuHead"> Support </div>
         <div class="menuItem">
            <ul class="menuitem">
-           <li class="menuItem"> <a href="<? echo $spath ?>/?page=maillists"> Maillists </a> </li>
+           <li class="menuItem"> <a href="<? echo $spath ?>/?page=maillists"> Email Lists </a> </li>
            <li class="menuItem"> <a href="<? echo $spath ?>/?page=bugs"> Bug Reports </a> </li>
            <li class="menuItem"> <a href="<? echo $spath ?>/?page=support"> Where & How </a> </li>
            <li class="menuItem"> <a href="<? echo $spath ?>/?page=professional"> Professional </a></li>
diff --git a/docs/home-page/pages/bugs.php b/docs/home-page/pages/bugs.php
index 962582fd..4afa266d 100644
--- a/docs/home-page/pages/bugs.php
+++ b/docs/home-page/pages/bugs.php
@@ -1,34 +1,35 @@
 <? require_once("inc/header.php"); ?>
 <table>
 <tr>
-	<td class="contentTopic">
-	Bug Reporting
-	</td>
+        <td class="contentTopic">
+        Bug Reporting
+        </td>
 </tr>
 <tr>
-	<td class="content">
-	Before reporting a bug, please be sure it is a bug and
-	not a request for support (see the Support tab to
-	the left).
-	<p>
-	Bacula now has a bug reporting system
-	implemented by Dan Langille and hosted on his computer. It is web based,
-	easy to use, and we recommend you give it a try. You can submit a bug
-	or review the list of open or closed bugs by visiting:
+    <td class="content">
+    Before reporting a bug, please be sure it is a bug and
+    not a request for support (see the Support tab to
+    the left).
+    <p>
+    Bacula now has a bug reporting system
+    implemented by Dan Langille and hosted on his computer. It is web based,
+    easy to use, and we recommend you give it a try. You can submit a bug
+    or review the list of open or closed bugs by visiting:
 
 <p style="text-align: center; font-size: 24px">
-	<a href="http://bugs.bacula.org">http://bugs.bacula.org</a>
+        <a href="http://bugs.bacula.org">http://bugs.bacula.org</a>
 </p>
 
+To view the bug reports, you can login as user <b>anonymous</b> 
+and password <b>anonymous</b>.                    
+
+To submit bug reports, you must create an account.   
+
 <p>
-Most Bacula problems are questions of support, so
-if you are not sure if a problem you are having is
-a bug, please send an email to <b>bacula-users at lists.sourceforge.net</b>.
-The previous address was modified to prevent easy use by spammers. To use it,
-you must replace the <b>at</b> with an @ symbol. You do not need
-to be subscribed to the list to post to it. If you do not get an answer,
-then try reporting a bug, but please do not enter support requests in
-the bug database.
+Most Bacula problems are questions of support, so if you are not
+sure if a problem you are having is a bug, see the support page
+on this site for links to the email lists.
+
 <h3>Information Needed</h3>
 For us to respond to a bug report, we normally need the following
 as the minimum information, which you can enter into the appropriate
@@ -55,9 +56,9 @@ think it is a configuration problem, please don't hesitate
 to send them if necessary.</td>
 </tr>
 <tr>
-	<td style="font-size: 14px; padding: 0px 20px 0px 20px">
-	Please read that little Bug-Report-<a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html">HowTo</a> as well.
-	</td>
+   <td style="font-size: 14px; padding: 0px 20px 0px 20px">
+   Please read that little Bug-Report-<a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html">HowTo</a> as well.
+   </td>
 </tr>
 
 </table>
diff --git a/docs/home-page/pages/home.php b/docs/home-page/pages/home.php
index 72a92922..4b9e40c4 100644
--- a/docs/home-page/pages/home.php
+++ b/docs/home-page/pages/home.php
@@ -1,43 +1,50 @@
 <? require_once("inc/header.php"); ?>
 <table>
 <tr>
-        <td class="contentTopic">
-                Bacula&reg; - The Network Backup Solution
-        </td>
+   <td class="contentTopic">
+      Bacula&reg; - The Network Backup Solution
+   </td>
 </tr>
 <tr>
   <td class="content">
-      <b>Bacula</b> is a set of computer programs that permit you
-      (or the system administrator) to manage backup, recovery, and
-      verification of computer data across a network of computers of different kinds.<br>
-      <br>
-      In technical terms, it is a <b>network based backup program</b>.<br>
-      <br>
-      Bacula is relatively easy
-      to use and efficient, while offering many advanced storage
-      management features that make it easy to find and recover
-      lost or damaged files.<br>
-      <br>
-      Most of the <b>Bacula</b> source code has been released under the <b>GPL</b> version 2 license.
-      See the License page for more details.<br>
-      <br>
-      Under Documentation in the menu to the left, HTML, PDF, and TGZ
-      refer to the latest <b>released</b> Bacula source code. The
-      devel link to the right of the HTML and PDF refer to the most current
-      documentation for the development code in the Source Forge CVS.
-      This development version of the manual typically has more documentation,
-      but may also document features that are not in the released version.
-      The Developer's Guide link presents important information for users who want
-      to contribute to the Bacula project.
-      <br>
-      Bacula is Hosted on SourceForge at
-      <a href="http://sourceforge.net/projects/bacula"> http://sourceforge.net/projects/bacula </a>
-      where you can find out more about the project.<br>
-      <br>
-      You may also use the links on the left side of this page for more information.    
-      In particular, <b>Current Downloads</b> takes you to the currently
-      available downloads, and <b>All Downloads</b> takes you to a list
-      of all files ever released to SourceForge.
+     <b>Bacula</b> is a set of computer programs that permit you
+     (or the system administrator) to manage backup, recovery,
+     and verification of computer data across a network of
+     computers of different kinds.<br>
+
+     <br>
+     In technical terms, it is a <b>network based backup program</b>.<br>
+
+     <br>
+     Bacula is relatively easy to use and efficient, while
+     offering many advanced storage management features that make
+     it easy to find and recover lost or damaged files.<br> 
+
+     <br>
+     Most of the <b>Bacula</b> source code has been released
+     under a slightly modified version of the <b>GPL</b> version
+     2 license.  If you wish additional details, please follow
+     the License link to your left.<br>
+
+     <br>The Documentation link takes you to a page where you
+     can access all the available Bacula documentation (HTML,
+     PDF, and TGZ) both for the officially released version 
+     and for the current code under development in the Source
+     Forge CVS. The development version of the manual typically has
+     more documentation, but may also document new features that are
+     not in the released version.  The Developer's Guide
+     presents important information for users who want to
+     contribute to the Bacula project.<br>  
+        
+     <br> Bacula is Hosted on
+     SourceForge at <a href="http://sourceforge.net/projects/bacula">
+     http://sourceforge.net/projects/bacula </a> where you can
+     download the software.<br> <br> You may also use
+     the links on the left side of this page for more
+     information.  In particular, Current Files link takes
+     you to the currently available downloads, and the All
+     Downloads link takes you to a list of all files ever
+     released to SourceForge.
   </td>
 </tr>
 </table>
diff --git a/docs/home-page/pages/maillists.php b/docs/home-page/pages/maillists.php
index 42f69739..32b47a14 100644
--- a/docs/home-page/pages/maillists.php
+++ b/docs/home-page/pages/maillists.php
@@ -37,8 +37,8 @@ ask questions about Bacula or respond to questions
 from other users. The volume on this list is generally
 moderate, but can vary. All users are encouraged to subscribe
 and to participate.
-Although you are not required to be subscribed to send
-a message to this list, it is recommended.
+Due to the increasing volume of spam, you must be subscribed
+before you can send email to this list.
 To subscribe follow the instructions at:
 <a href="http://lists.sourceforge.net/lists/listinfo/bacula-users">Bacula Users List Subscription/Unsubscription/Modification</a>.
 <p>
diff --git a/docs/home-page/pages/support.php b/docs/home-page/pages/support.php
index ca0c0635..4dba4e99 100644
--- a/docs/home-page/pages/support.php
+++ b/docs/home-page/pages/support.php
@@ -1,45 +1,55 @@
 <? require_once("inc/header.php"); ?>
 <table>
 <tr>
-	<td class="contentTopic">
-		Support for Bacula
-	</td>
+        <td class="contentTopic">
+                Support for Bacula
+        </td>
 </tr>
 <tr>
-	<td class="content">
+   <td class="content">
 
-	Please keep in mind that we are not getting paid for this.
-	Nevertheless, our desire is to see as many people using
-	<b>Bacula</b> as possible. So we are very willing to
-	provide a reasonable level of email support.
+   Please keep in mind that we are not getting paid for this.
+   Nevertheless, our desire is to see as many people using
+   <b>Bacula</b> as possible. So we are very willing to
+   provide a reasonable level of email support.
 
-	<p>Before asking for help, it could be useful to check against the
-	email archive as often solution to your problem has been discussed
-	or a patch has been released. Please see:
-	<a href="http://news.gmane.org/search.php?match=bacula">
-	http://news.gmane.org/search.php?match=bacula</a>.
-	<p>For support, send an email to
-	<b>bacula-users at lists.sourceforge.net</b>, and if you are
-	specific enough, some kind Bacula user will help you. The
-	previous address was modified to prevent easy use by spammers.
-	To use it, you must replace the <b>at</b> with an @ symbol. You
-	don't need to be subscribed to the list to send an email to it.
-	The users constantly monitor this list and will generally provide
-	support. Please see <b>Information Needed</b> below for what to
-	include in your support request. If you don't supply the necessary
-	information, it will take longer to respond to your request, and
-	users may be afraid to try to respond,
-	if your request is too complicated and not well formulated.
-	<p>I (Kern) get a number of &quot;off-list&quot; emails sent
-	directly to me. Please always copy the appropriate list, if you
-	do not copy the list, I may not answer you, or I will answer by copying
-	the list. If you <em>really</em> have something confidential,
-	please clearly indicate it.</p>
+   <p>Before asking for help, it could be useful to check against the
+   email archive as often solution to your problem has been discussed
+   or a patch has been released. Please see:
+   <a href="http://news.gmane.org/search.php?match=bacula">
+   http://news.gmane.org/search.php?match=bacula</a>.
 
-	<p>If you are looking for live-suppport you might check out our irc-channel
-	in the <a href="http://www.freenode.net">Freenode</a> net, called #bacula.
+   <p>For support, send an email to
+   <b>bacula-users at lists.sourceforge.net</b>, and if you are
+   specific enough, some kind Bacula user will help you. The
+   previous address was modified to prevent easy use by spammers.
+   To use it, you must replace the <b>at</b> with an @ symbol. Due
+   to the increasing volumes of spam on the list, you must 
+   be subscribed to it to be able to send and email to it.  The
+   link to your left entitled <b>Email Lists</b> provides links
+   to where you can subscribe to each of the Bacula email lists.
+    
+   The users constantly monitor this list and will generally provide
+   support. Please see <b>Information Needed</b> below for what to
+   include in your support request. If you don't supply the necessary
+   information, it will take longer to respond to your request, and
+   users may be afraid to try to respond,
+   if your request is too complicated or not well formulated.
 
-	</td>
+
+   <p>I (Kern) get a number of &quot;off-list&quot; emails sent
+   directly to me. Unfortunately, I am no longer able to provide
+   direct user support. However, I do read all the email sent and
+   occasionally provide a tip or two. If you do send email to me,
+   please always copy the appropriate list, if you
+   do not copy the list, I may not answer you, or I will answer by copying
+   the list. If you <em>really</em> have something confidential,
+   please clearly indicate it.</p>
+
+   <p>If you are looking for live-suppport you might check out our irc-channel
+   in the <a href="http://www.freenode.net">Freenode</a> net, called #bacula.
+
+   </td>
 </tr>
 </table>
 <? require_once("inc/footer.php"); ?>
diff --git a/docs/manual/Makefile b/docs/manual/Makefile
index 4e070845..6c27d4c6 100644
--- a/docs/manual/Makefile
+++ b/docs/manual/Makefile
@@ -113,7 +113,7 @@ devpdfm:
 html:
 	@echo "Making html"
 #    If you turn on the following, it aborts after a "make clean"
-#	@./translate_images.pl --from_meaningful_names bacula.html
+	@./translate_images.pl --from_meaningful_names bacula.html
 	@cp -fp ${IMAGES}/*.eps .
 	latex2html -white -no_subdir -split 0 -toc_stars -white -notransparent \
 		-init_file latex2html-init.pl bacula >/dev/null
@@ -135,7 +135,7 @@ web:
 	@mkdir -p bacula
 	@cp -f imagename_translations bacula
 #    If you turn on the following, it aborts after a "make clean"
-#	@./translate_images.pl --from_meaningful_names bacula/Bacula_Users_Guide.html
+	@./translate_images.pl --from_meaningful_names bacula/Bacula_Users_Guide.html
 	@rm -rf bacula/*.html
 	@cp -fp ${IMAGES}/*.eps .
 	@rm -f next.eps next.png prev.eps prev.png up.eps up.png
diff --git a/docs/manual/faq.tex b/docs/manual/faq.tex
index 6d779c8f..fe842158 100644
--- a/docs/manual/faq.tex
+++ b/docs/manual/faq.tex
@@ -85,7 +85,6 @@ of known bugs and solutions.
    \end{enumerate}
 
 \label{AuthorizationErrors}
-
 \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
@@ -94,30 +93,38 @@ of known bugs and solutions.
    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 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
-   you are getting authentication errors,  then your best bet is to go back to
-   the  original conf files generated by the Bacula installation  process. Make
-   only the absolutely necessary modifications  to these files -- e.g. add the
-   correct email address. Then  follow the instructions in the 
-   \ilink{ Running Bacula}{_ChapterStart1} chapter of this manual. You
-   will run  a backup to disk and a restore. Only when that works, should you
-   begin customization of the conf files.  
-
-   Another reason that you can get authentication errors is  if you are running
-   Multiple Concurrent Jobs in the Director,  but you have not set them in the
-   File daemon or the Storage  daemon. Once you reach their limit, they will
-   reject the  connection producing authentication (or connection) errors.
-
-   If you are having problems connecting to a Windows machine that previously
-   worked, you might try restarting the Bacula service since Windows frequently 
-   encounters networking connection problems.
-
-   Here is a picture that indicates what names/passwords in which  files/Resources
-   must match up:  
+   During the authorization process, the Storage daemon and File daemon
+   also 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 you are getting authentication errors, then your best bet is to go
+   back to the original conf files generated by the Bacula installation
+   process.  Make only the absolutely necessary modifications to these
+   files -- e.g.  add the correct email address.  Then follow the
+   instructions in the \ilink{ Running Bacula}{_ChapterStart1} chapter of
+   this manual.  You will run a backup to disk and a restore.  Only when
+   that works, should you begin customization of the conf files.
+
+   Another reason that you can get authentication errors is if you are
+   running Multiple Concurrent Jobs in the Director, but you have not set
+   them in the File daemon or the Storage daemon.  Once you reach their
+   limit, they will reject the connection producing authentication (or
+   connection) errors.
+
+   If you are having problems connecting to a Windows machine that
+   previously worked, you might try restarting the Bacula service since
+   Windows frequently encounters networking connection problems.
+
+   Some users report that authentication fails if there is not a proper
+   reverse DNS lookup entry for the machine.  This seems to be a
+   requirement of gethostbyname(), which is what Bacula uses to translate
+   names into IP addresses.  If you cannot add a reverse DNS entry, or you
+   don't know how to do so, you can avoid the problem by specifying an IP
+   address rather than a machine name in the appropriate Bacula conf file.
+
+   Here is a picture that indicates what names/passwords in which
+   files/Resources must match up:
 
    \includegraphics{./Conf-Diagram.eps}  
 
diff --git a/docs/manual/install.tex b/docs/manual/install.tex
index f7c39d6a..4a566005 100644
--- a/docs/manual/install.tex
+++ b/docs/manual/install.tex
@@ -176,7 +176,7 @@ The basic installation is rather simple.
 \item {\bf cd} to the directory containing the source code.  
 \item ./configure (with appropriate options as described below)  
 \item Check the output of ./configure very carefully, especially  the Install
-   binaries and Install config files directories.  If they are not correct,
+   binaries and Install config directories.  If they are not correct,
    please rerun ./configure until they  are. The output from ./configure is
    stored in {\bf config.out}  and can be re-displayed at any time without
    rerunning the  ./configure by doing {\bf cat config.out}.  
@@ -193,7 +193,7 @@ The basic installation is rather simple.
 
 so that you are sure to start from scratch and not have a  mixture of the two
 options. This is because ./configure  caches much of the information. The {\bf
-make distclean}  is also critical if you move the source file from one 
+make distclean}  is also critical if you move the source dirctory from one 
 machine to another. If the {\bf make distclean} fails,  just ignore it and
 continue on.  
 \item make  
@@ -568,7 +568,10 @@ customize your installation.
    standard locations.  This option affects the Bacula build.  In specifying your
    restrictions in the {\bf /etc/hosts.allow}  or {\bf /etc/hosts.deny} files, do
    not use the {\bf twist}  option (hosts\_options(5)) or the Bacula process will
-   be terminated.  
+   be terminated. Note, when setting up your {\bf /etc/hosts.allow}
+   or {\bf /etc/hosts.deny}, you must identify the Bacula daemon in
+   question with the name you give it in your conf file rather than the
+   name of the executable.
    
    For more information on configuring and testing TCP wrappers, please  see the 
    \ilink{Configuring and Testing TCP Wrappers}{wrappers}  section
@@ -844,7 +847,7 @@ However, it is still built under a CYGWIN build environment -- though you can
 probably do it with VC Studio only. If you wish to build the Win32 File daemon
 from the source, you will need Microsoft C++ version 6.0 or greater. In Bacula
 prior to version 1.33, CYGWIN was used. Details for building it are in the
-README file of the src/win32 directory. 
+README.win32 file of the src/win32 directory. 
 
 Note, although most parts of Bacula build on Windows systems, the only part
 that we have tested and used is the File daemon. 
@@ -1082,7 +1085,7 @@ drop_mysql_tables
 fd
 gnome-console
 gnome-console.conf
-lymake_bacula_tables
+make_bacula_tables
 make_catalog_backup
 make_mysql_tables
 mtx-changer
diff --git a/docs/manual/tapetesting.tex b/docs/manual/tapetesting.tex
index 847c1a11..837f4057 100644
--- a/docs/manual/tapetesting.tex
+++ b/docs/manual/tapetesting.tex
@@ -332,7 +332,6 @@ numeric.
 \addcontentsline{toc}{subsection}{Tips for Resolving Problems}
 
 \label{CannotRestore}
-
 \subsubsection*{Bacula Saves But Cannot Restore Files}
 \index[general]{Files!Bacula Saves But Cannot Restore }
 \index[general]{Bacula Saves But Cannot Restore Files }
@@ -383,8 +382,29 @@ fails. This directive is available in version 1.35.5  or later (and not yet
 tested).  
 \end{enumerate}
 
-\label{opendevice}
+If you are getting error messages such as:
+\footnotesize
+\begin{verbatim}
+Volume data error at 0:0!
+Block checksum mismatch in block=0 len=32625 calc=345678 blk=123456
+\end{verbatim}
+\normalsize
 
+You are getting tape read errors, and this is most likely due to 
+one of the following things:
+\begin{enumerate}
+\item An old or bad tape.
+\item A dirty drive that needs cleaning (particularly for DDS drives).
+\item A loose SCSI cable.
+\item Old firmware in your drive. Make sure you have the latest firmware
+      loaded.
+\item Computer memory errors.
+\item Over-clocking your CPU.
+\item A bad SCSI card.
+\end{enumerate}
+
+
+\label{opendevice}
 \subsubsection*{Bacula Cannot Open the Device}
 \index[general]{Device!Bacula Cannot Open the }
 \index[general]{Bacula Cannot Open the Device }
-- 
2.39.5