Update truncate on purge doc

diff --git a/docs/manuals/en/console/bconsole.tex b/docs/manuals/en/console/bconsole.tex
index f090374b3f939af59e429740f8c527da4ef23597..d9cd52c1bc0f97f0868df88f412a4a3bd85626c2 100644 (file)
--- a/docs/manuals/en/console/bconsole.tex
+++ b/docs/manuals/en/console/bconsole.tex
@@ -821,7 +821,20 @@ purge volume|volume=\lt{}vol-name\gt{} (of all jobs)
 For the {\bf purge} command to work on Volume Catalog database  records the
 {\bf VolStatus}  must be Append, Full, Used, or Error.  
 
-The actual data written to the Volume will be unaffected by  this command.  
+The actual data written to the Volume will be unaffected by this command unless
+you are using the \texttt{ActionOnPurge=Truncate} option on those Media.
+
+To ask Bacula to truncate your \texttt{Purged} volumes, you need to use the
+following command in interactive mode or in a RunScript:
+\begin{verbatim}
+*purge volume action=truncate storage=File allpools
+# or by default, action=all
+*purge volume action storage=File pool=Default
+\end{verbatim}
+
+This is possible to specify the volume name, the media type, the pool, the
+storage, etc\dots (see \texttt{help purge}) Be sure that your storage device is
+idle when you decide to run this command.
 
 \item[python]
    \index[general]{python}

diff --git a/docs/manuals/en/main/dirdconf.tex b/docs/manuals/en/main/dirdconf.tex
index c1223b9bd165435470076cb9f2961db818183fb0..d0dfa40c38bdfb78c8218c9a8d51d7bbc7155dbb 100644 (file)
--- a/docs/manuals/en/main/dirdconf.tex
+++ b/docs/manuals/en/main/dirdconf.tex
@@ -2815,9 +2815,10 @@ The Pool Resource defined in the Director's configuration file
 \item [Action On Purge = \lt{Truncate}]
 \index[dir]{actiononpurge}
 
-This directive \textbf{ActionOnPurge=Truncate} instructs Bacula to truncate
-the volume when it is purged. It is useful to prevent disk based volumes from
-consuming too much space. 
+This directive \textbf{ActionOnPurge=Truncate} instructs Bacula to truncate the
+volume when it is purged with the \texttt{purge volume action=truncate}
+command. It is useful to prevent disk based volumes from consuming too much
+space.
 
 \begin{verbatim}
 Pool {
@@ -2827,6 +2828,21 @@ Pool {
 }
 \end{verbatim}
 
+You can schedule the truncate operation at the end of your CatalogBackup job
+like in this example:
+
+\begin{verbatim}
+Job {
+ Name = CatalogBackup
+ ...
+ RunScript {
+   RunsWhen=After
+   RunsOnClient=No
+   Console = "purge volume action=all allpools storage=File"
+ }
+}
+\end{verbatim}
+
 \label{PoolScratchPool}
 \item [ScratchPool = \lt{}pool-resource-name\gt{}]
    \index[dir]{ScrachPool}

diff --git a/docs/manuals/en/main/newfeatures.tex b/docs/manuals/en/main/newfeatures.tex
index cb063dc97d5d6daaece833aa43fc7fefa763eceb..e00ff47a6f506ad74267621ebb95ae7b5337b6fa 100644 (file)
--- a/docs/manuals/en/main/newfeatures.tex
+++ b/docs/manuals/en/main/newfeatures.tex
@@ -1,8 +1,59 @@
-\chapter{New Features in 5.0.0}
-\label{NewFeaturesChapter}
+\chapter{New Features in 5.0.1}
+
+This chapter presents the new features that are in the released Bacula version
+5.0.1. This version mainly fixes a number of bugs found in version 5.0.0 during
+the onging development process.
+
+\section{Truncate volume after purge}
+\label{sec:actiononpurge}
+
+The Pool directive \textbf{ActionOnPurge=Truncate} instructs Bacula to truncate
+the volume when it is purged with the new command \texttt{purge volume
+  action}.It is useful to prevent disk based volumes from consuming too much
+space.
+
+\begin{verbatim}
+Pool {
+  Name = Default
+  Action On Purge = Truncate
+  ...
+}
+\end{verbatim}
+
+As usual You can also set this property with the \texttt{update volume} command
+\begin{verbatim}
+*update volume=xxx actiononpurge=Truncate
+*update volume=xxx actiononpurge=None
+\end{verbatim}
+
+To ask Bacula to truncate your \texttt{Purged} volumes, you need to use the
+following command in interactive mode or in a RunScript as shown after:
+\begin{verbatim}
+*purge volume action=truncate storage=File allpools
+# or by default, action=all
+*purge volume action storage=File pool=Default
+\end{verbatim}
 
-This chapter presents the new features that are in the
-released Bacula version 5.0.0.
+This is possible to specify the volume name, the media type, the pool, the
+storage, etc\dots (see \texttt{help purge}) Be sure that your storage device is
+idle when you decide to run this command.
+
+\begin{verbatim}
+Job {
+ Name = CatalogBackup
+ ...
+ RunScript {
+   RunsWhen=After
+   RunsOnClient=No
+   Console = "purge volume action=all allpools storage=File"
+ }
+}
+\end{verbatim}
+
+\textbf{Important note}: This feature doesn't work as
+expected in version 5.0.0. Please do not use it before version 5.0.1.
+
+\chapter{New Features in 5.0.0}
 
 \section{Maximum Concurent Jobs for Devices}
 \label{sec:maximumconcurentjobdevice}
@@ -439,24 +490,6 @@ to interface to the Director.
   command (ex: \texttt{help run}).
 \end{itemize}
 
-\subsubsection*{Truncate volume after purge}
-\label{sec:actiononpurge}
-
-This feature doesn't work as expected in version 5.0.0. Please do not use it
-before version 5.0.1.
-
-%The Pool directive \textbf{ActionOnPurge=Truncate} instructs Bacula to truncate
-%the volume when it is purged. It is useful to prevent disk based volumes from
-%consuming too much space. 
-%
-%\begin{verbatim}
-%Pool {
-%  Name = Default
-%  Action On Purge = Truncate
-%  ...
-%}
-%\end{verbatim}
-%
 \subsection{Custom Catalog queries}
 
 If you wish to add specialized commands that list the contents of the catalog,