]> git.sur5r.net Git - bacula/docs/commitdiff
Document changes
authorKern Sibbald <kern@sibbald.com>
Sun, 24 Jul 2005 16:00:17 +0000 (16:00 +0000)
committerKern Sibbald <kern@sibbald.com>
Sun, 24 Jul 2005 16:00:17 +0000 (16:00 +0000)
docs/manual/autochangers.tex
docs/manual/faq.tex
docs/manual/win32.tex

index e30ae04a47834b41d7d073651d4999440cf783b6..658f297b2d20534b026e4d6a0a1efd7b96a8b08c 100644 (file)
@@ -1,11 +1,11 @@
 %%
 %%
 
-\section*{Autochangers Support}
+\section*{Autochanger Support}
 \label{_ChapterStart18}
-\index[general]{Support!Autochangers }
-\index[general]{Autochangers Support }
-\addcontentsline{toc}{section}{Autochangers Support}
+\index[general]{Support!Autochanger }
+\index[general]{Autochanger Support }
+\addcontentsline{toc}{section}{Autochanger Support}
 
 \subsection*{Autochangers -- General}
 \index[general]{General!Autochangers -- }
index 089f2386892bee94f234035e755b3e82c898bdc2..daf8955d28d7410d1388edd949e7233e13e143d2 100644 (file)
@@ -1,4 +1,4 @@
- %%
+%%
 %%
 
 \section*{Bacula Frequently Asked Questions}
@@ -14,16 +14,14 @@ Please also see
 \ilink{the bugs section}{_ChapterStart4} of this document for a list
 of known bugs and solutions.
 
-\subsection*{Frequently Asked Questions}
-\addcontentsline{toc}{section}{Frequently Asked Questions}
-
 \begin{description}
 \label{what}
-
+\subsection*{What is Bacula?}
 \item [What is {\bf Bacula}? ]
    \index[general]{What is Bacula? }
    {\bf Bacula} is a network backup and restore program. 
 
+\subsection*{Does Bacula support Windows?}
 \item [Does Bacula support Windows?]
    \index[general]{Does Bacula support Windows? }
    Yes, Bacula compiles and runs on Windows machines  (Win98, WinMe, WinXP,
@@ -33,6 +31,7 @@ of known bugs and solutions.
  
 
 \label{lang}
+\subsection*{What language is Bacula written in?}
 \item [What language is Bacula written in?]
    \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
@@ -42,6 +41,7 @@ of known bugs and solutions.
    adding a larger  subset of C++.  
 
 \label{run}
+\subsection*{On what machines does Bacula run?}
 \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,
@@ -54,6 +54,7 @@ of known bugs and solutions.
  
 
 \label{stable}
+\subsection*{Is Bacula Stable?}
 \item [Is Bacula Stable? ]
    \index[general]{Is Bacula Stable? }
    Yes, it is remarkably stable, but remember, there are  still a lot of
@@ -92,6 +93,7 @@ of
    \end{enumerate}
 
 \label{AuthorizationErrors}
+\subsection*{I'm Getting Authorization Errors. What is Going On? }
 \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
@@ -148,7 +150,8 @@ of
    Bacula component will reject all new connections.
 
 \label{AccessProblems}
-
+\subsection*{Bacula Runs Fine but Cannot Access a Client on a Different Machine.
+   Why? }
 \item [Bacula Runs Fine but Cannot Access a Client on a Different Machine.
    Why? ]
    \index[general]{Bacula Runs Fine but Cannot Access a Client on a Different
@@ -179,7 +182,7 @@ of
 \end{itemize}
 
 \label{startover}
-
+\subsection*{My Catalog is Full of Test Runs, How Can I Start Over?}
 \item [My Catalog is Full of Test Runs, How Can I Start Over? ]
   \index[general]{My Catalog is Full of Test Runs, How Can I Start Over? }
   If you are using MySQL do the following:
@@ -217,6 +220,7 @@ mt -f /dev/st0 weof
 where you need to adjust the device name for your system.  
 
 \label{restorehang}
+\subsection*{I Run a Restore Job and Bacula Hangs. What do I do?}
 \item [I Run a Restore Job and Bacula Hangs. What do I do?]
    \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
@@ -227,10 +231,10 @@ where you need to adjust the device name for your system.
    sessions (jobs) will be completely blocked  from using the drive unmounted,
 so
    be sure to do a {\bf mount}  after your unmount. If in doubt, do a second
-{\bf
-   mount}, it  won't cause any harm.  
+   {\bf mount}, it  won't cause any harm.  
 
 \label{windowstart}
+\subsection*{I Cannot Get My Windows Client to Start Automatically? }
 \item [I Cannot Get My Windows Client to Start Automatically? ]
    \index[general]{I Cannot Get My Windows Client to Start Automatically? }
    You are probably having one of two problems: either the  Client is dying due
@@ -243,7 +247,7 @@ so
    manual.  
 
 \label{windowsdie}
-
+\subsection*{My Windows Client Immediately Dies When I Start It}
 \item [My Windows Client Immediately Dies When I Start It ]
 \index[general]{My Windows Client Immediately Dies When I Start It }
 The most common problem is either that the configuration  file is not where it
@@ -288,6 +292,9 @@ Obviously you will want to change the filename to be appropriate  for your
 system.  
 
 \label{nobackup}
+\subsection*{My backups are not working on my Windows 
+   Client. What should I do?}
+
 \item [I didn't realize that the backups were not working on my Windows 
    Client. What should I do? ]
 \index[general]{I didn't realize that the backups were not working on my Windows
@@ -321,6 +328,8 @@ You should also be logging the Director's messages, please see the  previous
 FAQ for how to do so.  
 
 \label{sched}
+\subsection*{All my Jobs are scheduled for the same time. Will this cause
+   problems?}
 \item [All my Jobs are scheduled for the same time. Will this cause
    problems? ]
    \index[general]{All my Jobs are scheduled for the same time. Will this cause
@@ -333,6 +342,7 @@ FAQ for how to do so.
    leave this set to {\bf 1} for the Director.  
 
 \label{disk}
+\subsection*{Can Bacula Backup My System To Files instead of Tape?}
 \item [Can Bacula Backup My System To Files instead of Tape? ]
    \index[general]{Can Bacula Backup My System To Files instead of Tape? }
    Yes, in principle, Bacula can backup to any storage  medium as long as you
@@ -346,6 +356,7 @@ FAQ for how to do so.
    chapter to read.
 
 \label{bigfiles}
+\subsection*{Can Bacula Backup and Restore Files Greater than 2 Gigabytes?}
 \item [Can Bacula Backup and Restore Files Greater than 2 Gigabytes in
    Size?  ]
 \index[general]{Can Bacula Backup and Restore Files Greater than 2 Gigabytes in
@@ -355,6 +366,8 @@ or later, the answer is yes. To the best of our  knowledge all client system
 supported by Bacula can handle  files larger than 2 Gigabytes.  
 
 \label{cancel}
+\subsection*{I want to stop a job. Is
+   there  a better way than {\bf ./bacula stop} to stop it?}
 \item [I Started A Job then Decided I Really Did Not Want to Run It. Is
    there  a better way than {\bf ./bacula stop} to stop it?]
    \index[general]{I Started A Job then Decided I Really Did Not Want to
@@ -367,6 +380,8 @@ supported by Bacula can handle  files larger than 2 Gigabytes.
    {\bf mount} command before it will be canceled.
 
 \label{trademark}
+\subsection*{Why have You Trademarked the Name
+   Bacula\raisebox{.6ex}{{\footnotesize \textsuperscript{\textregistered}}}?}
 \item [Why have You Trademarked the Name
    Bacula\raisebox{.6ex}{{\footnotesize \textsuperscript{\textregistered}}}?]
 \index[general]{Why have You Trademarked the Name
@@ -377,10 +392,10 @@ Bacula, even in a derivative product as long as it  remains totally compatible
 in all respects with the program defined  here.
 
 \label{docversion}
-\item [Why is Your Online Document for Version 1.35 of Bacula when the
-   Currently  Release Version is 1.34?]
-\index[general]{Why is Your Online Document for Version 1.35 of Bacula when the
-Currently Release Version is 1.34? }
+\subsection*{Why is Your Online Document for Version 1.37 but the Released Version is 1.36?}
+\item [Why is Your Online Document for Version 1.37 of Bacula when the
+   Currently  Release Version is 1.36?]
+\index[general]{Why is Your Online Document for Version 1.37 but Released Version is 1.36? }
 As Bacula is being developed, the document is also being enhanced, more  often
 than not it has clarifications of existing features that  can be very useful
 to our users, so we publish the very latest  document. Fortunately it is rare
@@ -390,7 +405,7 @@ If you want to read a document that pertains only to a specific  version,
 please use the one distributed in the source code.  
 
 \label{sure}
-
+\subsection*{Does Bacula really save and restore all files?}
 \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 a while to figure
@@ -412,6 +427,7 @@ please use the one distributed in the source code.
    of the same type.
 
 \label{upgrade}
+\subsection*{I want an Incremental but Bacula runs it as a Full backup. Why?}
 \item [I did a Full backup last week, but now in running an Incremental,
    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
@@ -435,6 +451,7 @@ please use the one distributed in the source code.
    or selecting a FileSet.  For more on backup levels see below.
 
 \label{filenamelengths}
+\subsection*{Do you really handle unlimited path lengths?}
 \item [How Can You Claim to Handle Unlimited Path and Filename Lengths
    when  All Other Programs Have Fixed Limits?]
    \index[general]{How Can You Claim to Handle Unlimited Path and Filename
@@ -453,6 +470,7 @@ please use the one distributed in the source code.
    restriction in later versions of Bacula.
 
 \label{unique}
+\subsection*{What Is the Really Unique Feature of Bacula?}
 \item [What Is the Really Unique Feature of Bacula?]
    \index[general]{What Is the Really Unique Feature of Bacula?  } Well, it
    is hard to come up with unique features when backup programs for Unix
@@ -471,16 +489,17 @@ please use the one distributed in the source code.
    implemented, this will enormously reduce tape usage.
 
 \label{sequence}
-\item [If I Do Run Multiple Simultaneous Jobs, How Can I Force One
+\subsection*{How can I force one job to run after another?}
+\item [If I Run Multiple Simultaneous Jobs, How Can I Force One
    Particular  Job to Run After Another Job? ]
-\index[general]{If I Do Run Multiple Simultaneous Jobs, How Can I Force One
+\index[general]{If I Run Multiple Simultaneous Jobs, How Can I Force One
 Particular Job to Run After Another Job? }
 Yes, you can set Priorities on your jobs so that they  run in the order you
 specify. Please see:  
 \ilink{the Priority record}{Priority} in the  Job resource.
 
 \label{nomail}
-
+\subsection*{I Am Not Getting Email Notification, What Can I Do? }
 \item [I Am Not Getting Email Notification, What Can I Do? ]
 
 \index[general]{I Am Not Getting Email Notification, What Can I Do? }
@@ -498,12 +517,12 @@ program,  please see
 manual.
 
 \label{periods}
-
+\subsection*{My retention periods don't work}
 \item [I Change Recycling, Retention Periods, or File Sizes in my Pool
-   Resource  and they Still Don``t Work.]
+   Resource  and they Still Don't Work.]
   \index[general]{I Change Recycling, Retention Periods, or File Sizes in my
 Pool
-  Resource and they Still Don"t Work. }
+  Resource and they Still Don't Work. }
   The different variables associated with a Pool are defined in the  Pool
   Resource, but are actually read by Bacula from the Catalog database.  On
   Bacula versions prior to 1.30, after changing your Pool Resource,  you must
@@ -519,6 +538,7 @@ Pool
   program. 
 
 \label{CompressionNotWorking}
+\subsection*{Why aren't my files compressed?}
 \item [I Have Configured Compression On, But None of My Files Are
    Compressed.  Why?]
    \index[general]{I Have Configured Compression On, But None of My Files Are
@@ -573,6 +593,7 @@ I/O
 \end{itemize}
 
 \label{LevelChanging}
+\subsection*{Incremental backups are not working}
 \item [Bacula is Not Doing the Right Thing When I Request an Incremental
    Backup. Why?]
    \index[general]{Bacula is Not Doing the Right Thing When I Request an
@@ -608,6 +629,7 @@ The above information can allow us to analyze what happened, without it,
 there is not much we can do.  
 
 \label{WaitForever}
+\subsection*{I am waiting forever for a backup of an offsite machine}
 \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?]
@@ -638,6 +660,7 @@ in the FileDaemon resource.
    \end{itemize}
 
 \label{sshHanging}
+\subsection*{SSH hangs forever after starting Bacula}
 \item [When I ssh into a machine and start Bacula then attempt to exit, 
    ssh hangs forever.]
    \index[general]{When I ssh into a machine and start Bacula then attempt to
@@ -659,7 +682,7 @@ exit,
 and likewise for the other daemons.  
 
 \label{RetentionPeriods}
-
+\subsection*{I'm confused by retention periods}
 \item [I'm confused by the different Retention periods: File Retention, 
    Job Retention, Volume Retention. Why are there so many?]
    \index[general]{I'm confused by the different Retention periods: File
@@ -684,6 +707,7 @@ catalog
    case.  
 
 \label{MaxVolumeSize}
+\subsection*{MaxVolumeSize is ignored}
 \item [Why Does Bacula Ignore the MaxVolumeSize Set in my Pool?]
    \index[general]{Why Does Bacula Ignore the MaxVolumeSize Set in my Pool? }
    The MaxVolumeSize that Bacula uses comes from the Media record,  so most
@@ -709,6 +733,7 @@ update Volume=xxx
 to change it.  
 
 \label{ConnectionRefused}
+\subsection*{I get a Connection refused when connecting to my Client}
 \item [In connecting to my Client, I get ''ERR:Connection Refused.  Packet
    Size too big from File daemon:192.168.1.4:9102`` Why?]
    \index[general]{In connecting to my Client, I get ``ERR:Connection
@@ -742,6 +767,7 @@ Another solution might be to run the daemon with the debug  option by:
 This will cause the FD to write a file {\bf bacula.trace}  in the current
 directory, which you can examine to determine  the problem.  
 
+\subsection*{Long running jobs die with Pipe Error}
 \item [During long running jobs my File daemon dies with Pipe Error, or
        some other communications error. Why?]
    \index[general]{Communications Errors}
@@ -779,6 +805,7 @@ iptables -t filter -A INPUT --dport 9103 -j ACCEPT
    This will ensure that any Bacula traffic will not get terminated because
    of high usage rates.
    
+\subsection*{How to I tell the Job which Volume to use?}
 \item[I can't figure out how to tell the job which volume to use]
    \index[general]{What tape to mount}
   This is an interesting statement. I now see that a number of people new to
index 6c1f4e866db3caa8835e567830c232261182cb92..836ab16197b183d41970c60a50235058b53564dd 100644 (file)
@@ -582,8 +582,8 @@ You should see something like this:
    checked 
 \item click on OK 
 \item When the message ``You do not have permission to read the contents of
-   directory ''c:\textbackslash{}src\textbackslash{}basis. Do you wish to replace
-   the directory permissions with permissions granting you Full Control?``, click
+   directory c:\textbackslash{}src\textbackslash{}basis. Do you wish to replace
+   the directory permissions with permissions granting you Full Control?'', click
 on Yes. 
 
 \includegraphics{./confirm.eps} 
@@ -593,6 +593,9 @@ on Yes.
 With the above procedure, you should now have full control over your restored
 directory. 
 
+In addition to the above methods of changing permissions, there is a Microsoft
+program named {\bf cacls} that can perform similar functions.
+
 \subsection*{Backing Up the WinNT/XP/2K System State}
 \index[general]{State!Backing Up the WinNT/XP/2K System }
 \index[general]{Backing Up the WinNT/XP/2K System State }