]> git.sur5r.net Git - bacula/docs/commitdiff
Update
authorKern Sibbald <kern@sibbald.com>
Sat, 3 Mar 2007 07:47:32 +0000 (07:47 +0000)
committerKern Sibbald <kern@sibbald.com>
Sat, 3 Mar 2007 07:47:32 +0000 (07:47 +0000)
docs/manual/autochangers.tex
docs/manual/dirdconf.tex
docs/manual/dvd.tex
docs/manual/storedconf.tex
docs/manual/supportedchangers.tex
docs/manual/win32.tex

index be4d137ad1b298c65e321cff93e88cb592963d61..27718e3e1478aa76157fed567dd6f6753caba37b 100644 (file)
@@ -60,10 +60,10 @@ In principle, if {\bf mtx} will operate your changer correctly, then it is
 just a question of adapting the {\bf mtx-changer} script (or selecting one
 already adapted) for proper interfacing. You can find a list of autochangers
 supported by {\bf mtx} at the following link: 
-\elink{http://mtx.badtux.net/compatibility.php}
-{http://mtx.badtux.net/compatibility.php}.
+\elink{http://mtx.opensource-sw.net/compatibility.php}
+{http://mtx.opensource-sw.net/compatibility.php}.
 The home page for the {\bf mtx} project can be found at: 
-\elink{http://mtx.badtux.net/}{http://mtx.badtux.net/}. 
+\elink{http://mtx.opensource-sw.net/}{http://mtx.opensource-sw.net/}. 
 
 If you are having troubles, please use the {\bf auto} command in the {\bf
 btape} program to test the functioning of your autochanger with Bacula. When
index 8bb32ca846c23cc27b0ce11794eb5bb9adc4c8de..9960056f1d42407e352613ff0fcce8f7434973e9 100644 (file)
@@ -2366,6 +2366,10 @@ The Pool Resource defined in the Director's configuration file
    after recycling.  This value is checked and the {\bf Used} status set
    while the job is writing to the particular volume.
 
+   This directive is particularly useful for restricting the size
+   of disk volumes, and will work correctly even in the case of
+   multiple simultaneous jobs writing to the volume.
+
    The value defined by this directive in the bacula-dir.conf file is the
    default value used when a Volume is created.  Once the volume is
    created, changing the value in the bacula-dir.conf file will not change
@@ -2403,8 +2407,12 @@ The Pool Resource defined in the Director's configuration file
    The use duration is checked and the {\bf Used} status is set only at the
    end of a job that writes to the particular volume, which means that even
    though the use duration may have expired, the catalog entry will not be
-   updated until the next job that uses this volume is run.
-   
+   updated until the next job that uses this volume is run. This
+   directive is not intended to be used to limit volume sizes
+   and will not work correctly (i.e. will fail jobs) if the use
+   duration expires while multiple simultaneous jobs are writing
+   to the volume.
+      
    Please note that the value defined by this directive in the  bacula-dir.conf
    file is the default value used when a Volume  is created. Once the volume is
    created, changing the value  in the bacula-dir.conf file will not change what
@@ -2440,13 +2448,14 @@ The Pool Resource defined in the Director's configuration file
    \index[dir]{Volume Retention}
    \index[dir]{Directive!Volume Retention}
    The Volume Retention directive defines the length of time that {\bf
-   Bacula} will keep Job and Files records associated with the Volume in
+   Bacula} will keep records associated with the Volume in
    the Catalog database after the End time of each Job written to the
    Volume.  When this time period expires, and if {\bf AutoPrune} is set to
    {\bf yes} Bacula may prune (remove) Job records that are older than the
    specified Volume Retention period if it is necessary to free up a
    Volume.  Recycling will not occur until it is absolutely necessary to
-   free up a volume.  All File records associated with pruned Jobs are also
+   free up a volume (i.e. no other writable volume exists).
+   All File records associated with pruned Jobs are also
    pruned.  The time may be specified as seconds, minutes, hours, days,
    weeks, months, quarters, or years.  The {\bf Volume Retention} is
    applied independently of the {\bf Job Retention} and the {\bf File
@@ -2462,10 +2471,6 @@ The Pool Resource defined in the Director's configuration file
    Bacula does not automatically recycle a Volume. It attempts to keep the
    Volume data intact as long as possible before over writing the Volume.
    
-   The default Volume retention period is 365 days.  Note, this directive
-   sets the default value for each Volume entry in the Catalog when the
-   Volume is created.  The value in the catalog may be later individually
-   changed for each Volume using the Console program.
    
    By defining multiple Pools with different Volume Retention periods, you
    may effectively have a set of tapes that is recycled weekly, another
@@ -2479,11 +2484,12 @@ The Pool Resource defined in the Director's configuration file
    This means that if you do a Full backup once a month, the minimum Volume
    retention period should be two months.
    
-   Please note that the value defined by this directive in the  bacula-dir.conf
-   file is the default value used when a Volume  is created. Once the volume is
-   created, changing the value  in the bacula-dir.conf file will not change what
-   is stored  for the Volume. To change the value for an existing Volume  you
-   must use the {\bf update} command in the Console.
+   The default Volume retention period is 365 days, and either the default
+   or the value defined by this directive in the bacula-dir.conf file is
+   the default value used when a Volume is created.  Once the volume is
+   created, changing the value in the bacula-dir.conf file will not change
+   what is stored for the Volume.  To change the value for an existing
+   Volume you must use the {\bf update} command in the Console.
 
 \label{PoolRecyclePool}
 \item [RecyclePool = \lt{}pool-resource-name\gt{}]
index 7f3eb5b8a181a3381b4ca1a5dd4996f2940be21e..925626b8245b865884b9797ad9ba4b675b7eb404 100644 (file)
@@ -162,6 +162,17 @@ be a name such as {\bf /dev/cdrom} or {\bf /media/cdrecorder} or
 {\bf /dev/dvd} depending on your system.  It will not be a name such
 as {\bf /mnt/cdrom}.
 
+Finally, for {\bf growisofs} to work, it must be able to lock
+a certain amount of memory in RAM.  If you have restrictions on
+this function, you may have failures.  Under {\bf bash}, you can
+set this with the following command:
+
+\footnotesize  
+\begin{verbatim}
+ulimit -l unlimited
+\end{verbatim}
+\normalsize
+
 \section{Edit Codes for DVD Directives} 
 \index[general]{Directives!DVD Edit Codes}
 \index[general]{Edit Codes for DVD Directives }
index f9cd1d7d8705b496a2455120e899e8d7b81d1cab..34133bf9dbd5be848fb85f69e5a39bc5f43a9f3a 100644 (file)
@@ -83,14 +83,25 @@ have one and only one Storage resource definition.
    \index[sd]{Directive!Heartbeat Interval}
    \index[general]{Heartbeat Interval}
    \index[general]{Broken pipe}
-   This directive defines an interval of time.  When the Storage daemon is
-   waiting for the operator to mount a tape, each time interval, it will
-   send a heartbeat signal to the File daemon.  The default interval is
-   zero which disables the heartbeat.  This feature is particularly useful
-   if you have a router such as 3Com that does not follow Internet
-   standards and times out an valid connection after a short duration 
-   despite the fact that keepalive is set. This usually results
-   in a broken pipe error message.
+   This directive defines an interval of time in seconds.  When
+   the Storage daemon is waiting for the operator to mount a
+   tape, each time interval, it will send a heartbeat signal to
+   the File daemon.  The default interval is zero which disables
+   the heartbeat.  This feature is particularly useful if you
+   have a router such as 3Com that does not follow Internet
+   standards and times out an valid connection after a short
+   duration despite the fact that keepalive is set.  This usually
+   results in a broken pipe error message.
+
+\item [Client Connect Wait = \lt{}time-interval\gt{}]
+   \index[sd]{Connect Wait}
+   \index[sd]{Directive!Connect Wait}
+   \index[general]{Client Connect Wait}
+   This directive defines an interval of time in seconds that
+   the Storage daemon will wait for a Client (the File daemon)
+   to connect.  The default is 30 seconds.  Be aware that the
+   longer the Storage daemon waits for a Client, the more
+   resources will be tied up.
 
 \item [Maximum Concurrent Jobs = \lt{}number\gt{}]
    \index[sd]{Maximum Concurrent Jobs}
index 14eb63f5b92886c4ddf3b963ef73055324356400..c7e57dcde0696b733d5a561cfdfddb704ffc18b2 100644 (file)
@@ -13,6 +13,17 @@ autochangers have been reported to work by Bacula users.  Note, in the
 Capacity/Slot column below, I quote the Compressed capacity per tape (or
 Slot).
 
+Since on most systems (other than FreeBSD), Bacula uses {\bf mtx}
+through the {\bf mtx-changer} script, in principle, if {\bf mtx}
+will operate your changer correctly, then it is just a question
+of adapting the {\bf mtx-changer} script (or selecting one
+already adapted) for proper interfacing.  You can find a list of
+autochangers supported by {\bf mtx} at the following link:
+\elink{http://mtx.opensource-sw.net/compatibility.php}
+{http://mtx.opensource-sw.net/compatibility.php}.
+The home page for the {\bf mtx} project can be found at:
+\elink{http://mtx.opensource-sw.net/}{http://mtx.opensource-sw.net/}.
+
 
 \addcontentsline{lot}{table}{Autochangers Known to Work with Bacula}
 \begin{longtable}{|p{0.6in}|p{0.8in}|p{1.9in}|p{0.8in}|p{0.5in}|p{0.75in}|}
index 9e146292695e98e8128eb0b26eaf988b6dbb6527..7fe606e812ec2726608761af46ac71ae4ca56222 100644 (file)
@@ -176,6 +176,11 @@ Windows Add/Remove Programs dialog found on the Control panel.
 \index[general]{Win32!Dealing with Problems}
 \index[general]{Dealing with Win32 Problems}
 
+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.
+
 If you are not using the portable option, and you have VSS
 (Volume Shadow Copy) enabled in the Director, and you experience
 problems with Bacula not being able to open files, it is most