Update documentation for AllowCompression feature

diff --git a/docs/manuals/en/main/dirdconf.tex b/docs/manuals/en/main/dirdconf.tex
index e7b615465c2b6b27eea6ab523ff1fb9d60afb6c2..e262af1adeb4ac48fbdab9ba49ce7d2fb0769574 100644 (file)
--- a/docs/manuals/en/main/dirdconf.tex
+++ b/docs/manuals/en/main/dirdconf.tex
@@ -2442,6 +2442,17 @@ the Director.
    turn data spooling on as documented in the \ilink{Data
    Spooling}{SpoolingChapter} chapter of this manual.
 
    turn data spooling on as documented in the \ilink{Data
    Spooling}{SpoolingChapter} chapter of this manual.
 

+\item [AllowCompression = \lt{}yes\vb{}no\gt{}]
+  \label{AllowCompression}
+   \index[dir]{AllowCompression}
+   \index[dir]{Directive!AllowCompression}
+
+   This directive is optional, and if you specify {\bf No} (the default is {\bf
+     Yes}), it will cause backups jobs running on this storage resource to run
+   without client File Daemon compression.  This effectively overrides
+   compression options in FileSets used by jobs which use this storage
+   resource.
+

 \item [Heartbeat Interval = \lt{}time-interval\gt{}]
    \index[dir]{Heartbeat Interval}
    \index[dir]{Directive!Heartbeat}
 \item [Heartbeat Interval = \lt{}time-interval\gt{}]
    \index[dir]{Heartbeat Interval}
    \index[dir]{Directive!Heartbeat}

diff --git a/docs/manuals/en/main/fileset.tex b/docs/manuals/en/main/fileset.tex
index ffcfe72b44031159c7cb601c4b2f0540643025b1..357621d51e4017019761452aabcd7f5a029b4537 100644 (file)
--- a/docs/manuals/en/main/fileset.tex
+++ b/docs/manuals/en/main/fileset.tex
@@ -252,6 +252,9 @@ The directives within an Options resource may be one of the following:
    compression levels greater than six generally give very little extra
    compression and are rather CPU intensive.
 
    compression levels greater than six generally give very little extra
    compression and are rather CPU intensive.
 

+   You can overwrite this option per Storage resource with
+   \ilink{AllowCompression}{AllowCompression} option.
+

 \item [signature=SHA1]
 \index[dir]{signature}
 \index[dir]{SHA1}
 \item [signature=SHA1]
 \index[dir]{signature}
 \index[dir]{SHA1}

diff --git a/docs/manuals/en/main/newfeatures.tex b/docs/manuals/en/main/newfeatures.tex
index 7a7d94d80c7be6d41be41884dced4baa9eb7efcf..0004808ebc95f625fd95912fbf522d83d09e08cd 100644 (file)
--- a/docs/manuals/en/main/newfeatures.tex
+++ b/docs/manuals/en/main/newfeatures.tex
@@ -113,6 +113,34 @@ FileSet {
 
 This project was funded by Bacula Systems.
 
 
 This project was funded by Bacula Systems.
 

+\section{AllowCompression = \lt{}yes\vb{}no\gt{}}
+\index[dir]{AllowCompression}
+
+This new directive may be added to Storage resource within the Director's
+configuration to allow users to selectively disable the client compression for
+any job which writes to this storage resource.
+
+For example:
+\begin{verbatim}
+Storage {
+  Name = UltriumTape
+  Address = ultrium-tape
+  Password = storage_password # Password for Storage Daemon
+  Device = Ultrium
+  Media Type = LTO 3
+  AllowCompression = No # Tape drive has hardware compression
+}
+\end{verbatim}
+The above example would cause any jobs running with the UltriumTape storage
+resource to run without compression from the client file daemons.  This
+effectively overrides any compression settings defined at the FileSet level.
+
+This feature is probably most useful if you have a tape drive which supports
+hardware compression.  By setting the \texttt{AllowCompression = No} directive
+for your tape drive storage resource, you can avoid additional load on the file
+daemon and possibly speed up tape backups.
+
+This project was funded by Collaborative Fusion, Inc.

 
 \section{Accurate Fileset Options}
 \label{sec:accuratefileset}
 
 \section{Accurate Fileset Options}
 \label{sec:accuratefileset}