From 7c8ec50236ff27251e0beda22f793c06ccf0ef7d Mon Sep 17 00:00:00 2001 From: Kern Sibbald Date: Sun, 14 Jan 2007 17:56:52 +0000 Subject: [PATCH] Update to 2.0.1 --- docs/manual/ansi-labels.tex | 2 +- docs/manual/autochangers.tex | 2 +- docs/manual/bootstrap.tex | 2 +- docs/manual/bugs.tex | 2 +- docs/manual/catmaintenance.tex | 2 +- docs/manual/configure.tex | 10 +++--- docs/manual/console.tex | 4 +-- docs/manual/consoleconf.tex | 8 ++--- docs/manual/critical.tex | 20 ++++++------ docs/manual/dirdconf.tex | 18 +++++----- docs/manual/disk.tex | 12 +++---- docs/manual/faq.tex | 12 +++---- docs/manual/filedconf.tex | 4 +-- docs/manual/fileset.tex | 24 +++++++------- docs/manual/firewalls.tex | 2 +- docs/manual/general.tex | 20 ++++++------ docs/manual/gpl.tex | 2 +- docs/manual/install.tex | 30 ++++++++--------- docs/manual/internaldb.tex | 2 +- docs/manual/kaboom.tex | 2 +- docs/manual/lesser.tex | 2 +- docs/manual/license.tex | 20 +++++++++--- docs/manual/migration.tex | 2 +- docs/manual/monitorconf.tex | 12 +++---- docs/manual/mysql.tex | 2 +- docs/manual/oldfileset.tex | 4 +-- docs/manual/pools.tex | 2 +- docs/manual/postgresql.tex | 2 +- docs/manual/progs.tex | 8 ++--- docs/manual/projects.tex | 2 +- docs/manual/python.tex | 2 +- docs/manual/quickstart.tex | 60 +++++++++++++++++++--------------- docs/manual/recycling.tex | 6 ++-- docs/manual/restore.tex | 12 +++---- docs/manual/rpm-faq.tex | 2 +- docs/manual/security.tex | 2 +- docs/manual/sqlite.tex | 2 +- docs/manual/state.tex | 6 ++-- docs/manual/storedconf.tex | 10 +++--- docs/manual/strategies.tex | 16 ++++----- docs/manual/stunnel.tex | 2 +- docs/manual/tapetesting.tex | 4 +-- docs/manual/thanks.tex | 2 +- docs/manual/tips.tex | 12 ++++--- docs/manual/tutorial.tex | 10 +++--- docs/manual/vars.tex | 2 +- docs/manual/verify.tex | 2 +- docs/manual/version.tex | 2 +- docs/manual/win32.tex | 2 +- 49 files changed, 206 insertions(+), 186 deletions(-) diff --git a/docs/manual/ansi-labels.tex b/docs/manual/ansi-labels.tex index 54cfac13..7d6e14fe 100644 --- a/docs/manual/ansi-labels.tex +++ b/docs/manual/ansi-labels.tex @@ -1,6 +1,6 @@ \chapter{ANSI and IBM Tape Labels} -\label{_ChapterStart62} +\label{AnsiLabelsChapter} \index[general]{ANSI and IBM Tape Labels} \index[general]{Labels!Tape} diff --git a/docs/manual/autochangers.tex b/docs/manual/autochangers.tex index 57ac46aa..be4d137a 100644 --- a/docs/manual/autochangers.tex +++ b/docs/manual/autochangers.tex @@ -2,7 +2,7 @@ %% \chapter{Autochanger Support} -\label{_ChapterStart18} +\label{AutochangersChapter} \index[general]{Support!Autochanger } \index[general]{Autochanger Support } diff --git a/docs/manual/bootstrap.tex b/docs/manual/bootstrap.tex index f961addb..eb370557 100644 --- a/docs/manual/bootstrap.tex +++ b/docs/manual/bootstrap.tex @@ -2,7 +2,7 @@ %% \chapter{The Bootstrap File} -\label{_ChapterStart43} +\label{BootstrapChapter} \index[general]{File!Bootstrap } \index[general]{Bootstrap File } diff --git a/docs/manual/bugs.tex b/docs/manual/bugs.tex index e8ba19b7..27fcd897 100644 --- a/docs/manual/bugs.tex +++ b/docs/manual/bugs.tex @@ -2,7 +2,7 @@ %% \section{Bacula Bugs} -\label{_ChapterStart4} +\label{BugsChapter} \index[general]{Bacula Bugs } \index[general]{Bugs!Bacula } diff --git a/docs/manual/catmaintenance.tex b/docs/manual/catmaintenance.tex index 8397d947..576b4f15 100644 --- a/docs/manual/catmaintenance.tex +++ b/docs/manual/catmaintenance.tex @@ -2,7 +2,7 @@ %% \chapter{Catalog Maintenance} -\label{_ChapterStart12} +\label{CatMaintenanceChapter} \index[general]{Maintenance!Catalog } \index[general]{Catalog Maintenance } diff --git a/docs/manual/configure.tex b/docs/manual/configure.tex index 5b0eceb4..318bc67f 100644 --- a/docs/manual/configure.tex +++ b/docs/manual/configure.tex @@ -2,7 +2,7 @@ %% \chapter{Customizing the Configuration Files} -\label{_ChapterStart16} +\label{ConfigureChapter} \index[general]{Files!Customizing the Configuration } \index[general]{Customizing the Configuration Files } @@ -365,19 +365,19 @@ The following configuration files must be defined: \begin{itemize} \item - \ilink{Console}{_ChapterStart36} -- to define the resources for + \ilink{Console}{ConsoleConfChapter} -- to define the resources for the Console program (user interface to the Director). It defines which Directors are available so that you may interact with them. \item - \ilink{Director}{_ChapterStart40} -- to define the resources + \ilink{Director}{DirectorChapter} -- to define the resources necessary for the Director. You define all the Clients and Storage daemons that you use in this configuration file. \item - \ilink{Client}{_ChapterStart25} -- to define the resources for + \ilink{Client}{FiledConfChapter} -- to define the resources for each client to be backed up. That is, you will have a separate Client resource file on each machine that runs a File daemon. \item - \ilink{Storage}{_ChapterStart31} -- to define the resources to + \ilink{Storage}{StoredConfChapter} -- to define the resources to be used by each Storage daemon. Normally, you will have a single Storage daemon that controls your tape drive or tape drives. However, if you have tape drives on several machines, you will have at least one Storage daemon diff --git a/docs/manual/console.tex b/docs/manual/console.tex index 920721a9..366cf746 100644 --- a/docs/manual/console.tex +++ b/docs/manual/console.tex @@ -44,7 +44,7 @@ Console version. This file allows default configuration of the Console, and at the current time, the only Resource Record defined is the Director resource, which gives the Console the name and address of the Director. For more information on configuration of the Console program, please see the -\ilink{Console Configuration File}{_ChapterStart36} Chapter of +\ilink{Console Configuration File}{ConsoleConfChapter} Chapter of this document. \section{Running the Console Program} @@ -764,7 +764,7 @@ python restart Python interpreter is initialized, there is no other way to make it accept any changes to the startup script {\bf DirStartUp.py}. For more details on Python scripting, please see the \ilink{Python - Scripting}{_ChapterStart60} chapter of this manual. + Scripting}{PythonChapter} chapter of this manual. \label{ManualPruning} \item [prune] diff --git a/docs/manual/consoleconf.tex b/docs/manual/consoleconf.tex index d510927f..e65f0a3e 100644 --- a/docs/manual/consoleconf.tex +++ b/docs/manual/consoleconf.tex @@ -2,7 +2,7 @@ %% \chapter{Console Configuration} -\label{_ChapterStart36} +\label{ConsoleConfChapter} \index[general]{Configuration!Console} \index[general]{Console Configuration} @@ -16,7 +16,7 @@ Directors. For a general discussion of the syntax of configuration files and their resources including the data types recognized by {\bf Bacula}, please see -the \ilink{Configuration}{_ChapterStart16} chapter of this manual. +the \ilink{Configuration}{ConfigureChapter} chapter of this manual. The following Console Resource definition must be defined: @@ -46,7 +46,7 @@ choose one when you start the {\bf Console} program. likely already be set to the value you specified on the {\bf \verb:--:with-base-port} option of the {\bf ./configure} command. This port must be identical to the {\bf DIRport} specified in the {\bf Director} resource of - the \ilink{Director's configuration}{_ChapterStart40} file. The + the \ilink{Director's configuration}{DirectorChapter} file. The default is 9101 so this directive is not normally specified. \item [Address = \lt{}address\gt{}] @@ -59,7 +59,7 @@ choose one when you start the {\bf Console} program. Where the password is the password needed for the Director to accept the Console connection. This password must be identical to the {\bf Password} specified in the {\bf Director} resource of the - \ilink{Director's configuration}{_ChapterStart40} file. This + \ilink{Director's configuration}{DirectorChapter} file. This directive is required. \end{description} diff --git a/docs/manual/critical.tex b/docs/manual/critical.tex index 95872aaf..680833cc 100644 --- a/docs/manual/critical.tex +++ b/docs/manual/critical.tex @@ -2,7 +2,7 @@ %% \chapter{Critical Items to Implement Before Production} -\label{_ChapterStart32} +\label{CriticalChapter} \index[general]{Production!Critical Items to Implement Before } \index[general]{Critical Items to Implement Before Production } @@ -36,7 +36,7 @@ production, use the checklist anyway). \item Test your tape drive for compatibility with Bacula by using the test command in the \ilink{btape}{btape} program. \item Better than doing the above is to walk through the nine steps in the - \ilink{Tape Testing}{_ChapterStart27} chapter of the manual. It + \ilink{Tape Testing}{TapeTestingChapter} chapter of the manual. It may take you a bit of time, but it will eliminate surprises. \item Test the end of tape handling of your tape drive by using the fill command in the \ilink{btape}{btape} program. @@ -51,7 +51,7 @@ production, use the checklist anyway). Write Bootstrap directive is described in the \ilink{Director Configuration}{writebootstrap} chapter of the manual, and more details are available in the - \ilink{Bootstrap File}{_ChapterStart43} chapter. Also, the default + \ilink{Bootstrap File}{BootstrapChapter} chapter. Also, the default bacula-dir.conf comes with a Write Bootstrap directive defined. This allows you to recover the state of your system as of the last backup. \item Backup your catalog. An example of this is found in the default @@ -68,7 +68,7 @@ production, use the checklist anyway). reconstruct if your server dies. \item Make a Bacula Rescue CDROM! See the \ilink{Disaster Recovery Using a Bacula Rescue - CDROM}{_ChapterRescue} chapter. It is trivial to make such a CDROM, + CDROM}{RescueChapter} chapter. It is trivial to make such a CDROM, and it can make system recovery in the event of a lost hard disk infinitely easier. \item Bacula assumes all filenames are in UTF-8 format. This is important @@ -89,19 +89,19 @@ Although these items may not be critical, they are recommended and will help you avoid problems. \begin{itemize} -\item Read the \ilink{Quick Start Guide to Bacula}{_ChapterStart37} +\item Read the \ilink{Quick Start Guide to Bacula}{QuickStartChapter} \item After installing and experimenting with Bacula, read and work carefully through the examples in the - \ilink{Tutorial}{_ChapterStart1} chapter of this manual. + \ilink{Tutorial}{TutorialChapter} chapter of this manual. \item Learn what each of the \ilink{Bacula Utility Programs}{_UtilityChapter} does. \item Set up reasonable retention periods so that your catalog does not grow to be too big. See the following three chapters:\\ - \ilink{Recycling your Volumes}{_ChapterStart22},\\ - \ilink{Basic Volume Management}{_ChapterStart39},\\ - \ilink{Using Pools to Manage Volumes}{_ChapterStart11}. + \ilink{Recycling your Volumes}{RecyclingChapter},\\ + \ilink{Basic Volume Management}{DiskChapter},\\ + \ilink{Using Pools to Manage Volumes}{PoolsChapter}. \item Perform a bare metal recovery using the Bacula Rescue CDROM. See the - \ilink{Disaster Recovery Using a Bacula Rescue CDROM}{_ChapterRescue} + \ilink{Disaster Recovery Using a Bacula Rescue CDROM}{RescueChapter} chapter. \end{itemize} diff --git a/docs/manual/dirdconf.tex b/docs/manual/dirdconf.tex index 73c2b9f3..39afa361 100644 --- a/docs/manual/dirdconf.tex +++ b/docs/manual/dirdconf.tex @@ -2,7 +2,7 @@ %% \chapter{Configuring the Director} -\label{_ChapterStart40} +\label{DirectorChapter} \index[general]{Director!Configuring the} \index[general]{Configuring the Director} @@ -12,7 +12,7 @@ as you add clients or modify the FileSets. For a general discussion of configuration files and resources including the data types recognized by {\bf Bacula}. Please see the -\ilink{Configuration}{_ChapterStart16} chapter of this manual. +\ilink{Configuration}{ConfigureChapter} chapter of this manual. \section{Director Resource Types} \index[general]{Types!Director Resource} @@ -650,7 +650,7 @@ For a {\bf Verify} Job, the Level may be one of the following: the files you select to be restored. For additional details of the {\bf bootstrap} file, please see - \ilink{Restoring Files with the Bootstrap File}{_ChapterStart43} chapter + \ilink{Restoring Files with the Bootstrap File}{BootstrapChapter} chapter of this manual. \label{writebootstrap} @@ -693,7 +693,7 @@ JobDefs { \end{verbatim} For more details on using this file, please see the chapter entitled - \ilink{The Bootstrap File}{_ChapterStart43} of this manual. + \ilink{The Bootstrap File}{BootstrapChapter} of this manual. \item [Client = \lt{}client-resource-name\gt{}] \index[dir]{Client} @@ -2066,7 +2066,7 @@ the Director. probably should use two different Media Types for your two disk Devices (even though you might think of them as both being File types). You can find more on this subject in the \ilink{Basic Volume - Management}{_ChapterStart39} chapter of this manual. + Management}{DiskChapter} chapter of this manual. The {\bf MediaType} specified here, {\bf must} correspond to the {\bf Media Type} specified in the {\bf Device} resource of the {\bf Storage @@ -2105,7 +2105,7 @@ the Director. yes} in the \ilink{Device Resource}{Autochanger} in the Storage daemon's configuration file as well as other important Storage daemon configuration information. Please consult the \ilink{Using - Autochangers}{_ChapterStart18} manual of this chapter for the details of + Autochangers}{AutochangersChapter} manual of this chapter for the details of using autochangers. \item [Maximum Concurrent Jobs = \lt{}number\gt{}] @@ -2167,7 +2167,7 @@ to a single set of Volumes. In this case, you will probably only use the {\bf Default} Pool. If your backup strategy calls for you to mount a different tape each day, you will probably want to define a separate Pool for each day. For more information on this subject, please see the -\ilink{Backup Strategies}{_ChapterStart3} chapter of this +\ilink{Backup Strategies}{StrategiesChapter} chapter of this manual. @@ -2594,7 +2594,7 @@ The Pool Resource defined in the Director's configuration file specify variable expansion characters, you should always enclose the format with double quote characters ({\bf "}). For more details on variable expansion, please see the \ilink{Variable - Expansion}{_ChapterStart50} Chapter of this manual. + Expansion}{VarsChapter} Chapter of this manual. If no variable expansion characters are found in the string, the Volume name will be formed from the {\bf format} string appended with the @@ -2938,7 +2938,7 @@ keyword {\bf *all*} can be specified in any of the above access control lists. When this keyword is present, any resource or command name (which ever is appropriate) will be accepted. For an example configuration file, please see the -\ilink{Console Configuration}{_ChapterStart36} chapter of this +\ilink{Console Configuration}{ConsoleConfChapter} chapter of this manual. \section{The Counter Resource} diff --git a/docs/manual/disk.tex b/docs/manual/disk.tex index 1f3358ed..07232ab4 100644 --- a/docs/manual/disk.tex +++ b/docs/manual/disk.tex @@ -2,7 +2,7 @@ %% \chapter{Basic Volume Management} -\label{_ChapterStart39} +\label{DiskChapter} \index[general]{Basic Volume Management} \index[general]{Management!Basic Volume} \index[general]{Disk Volumes} @@ -165,7 +165,7 @@ information from environment variables and special Bacula Counter variables. In version 1.37 and later, it is probably much better to use Python scripting and the NewVolume event since generating Volume labels in a Python script is much easier than trying to figure out Counter variables. See the -\ilink{Python Scripting}{_ChapterStart60} chapter of this manual for more +\ilink{Python Scripting}{PythonChapter} chapter of this manual for more details. Please note that automatic Volume labeling can also be used with tapes, but @@ -174,7 +174,7 @@ requires some user interaction. Automatic labeling from templates does NOT work with autochangers since Bacula will not access unknown slots. There are several methods of labeling all volumes in an autochanger magazine. For more information on this, please see the \ilink{ -Autochanger}{_ChapterStart18} chapter of this manual. +Autochanger}{AutochangersChapter} chapter of this manual. Automatic Volume labeling is enabled by making a change to both the Pool resource (Director) and to the Device resource (Storage daemon) shown above. @@ -198,7 +198,7 @@ Pool { Bacula will create Volume names Vol0001, Vol0002, and so on when new Volumes are needed. Much more complex and elaborate labels can be created using variable expansion defined in the -\ilink{Variable Expansion}{_ChapterStart50} chapter of this manual. +\ilink{Variable Expansion}{VarsChapter} chapter of this manual. The second change that is necessary to make automatic labeling work is to give the Storage daemon permission to automatically label Volumes. Do so by adding @@ -278,12 +278,12 @@ following: The first three records (File Retention, Job Retention, and AutoPrune) determine the amount of time that Job and File records will remain in your Catalog, and they are discussed in detail in the -\ilink{Automatic Volume Recycling}{_ChapterStart22} chapter of +\ilink{Automatic Volume Recycling}{RecyclingChapter} chapter of this manual. Volume Retention, AutoPrune, and Recycle determine how long Bacula will keep your Volumes before reusing them, and they are also discussed in detail in the -\ilink{Automatic Volume Recycling}{_ChapterStart22} chapter of +\ilink{Automatic Volume Recycling}{RecyclingChapter} chapter of this manual. The Maximum Volumes record can also be used in conjunction with the Volume diff --git a/docs/manual/faq.tex b/docs/manual/faq.tex index 1bfc1142..acd82c8d 100644 --- a/docs/manual/faq.tex +++ b/docs/manual/faq.tex @@ -4,7 +4,7 @@ % TODO: and use detailed indexing to help reader \chapter{Bacula Frequently Asked Questions} -\label{_ChapterStart48} +\label{FaqChapter} \index[general]{Questions!Bacula Frequently Asked } \index[general]{Bacula Frequently Asked Questions } @@ -19,7 +19,7 @@ or go directly to his FAQ at: \elink{http://paramount.ind.wpi.edu/wiki/doku.php?id=faq}{http://paramount.ind.wpi.edu/wiki/doku.php?id=faq}. Please also see -\ilink{the bugs section}{_ChapterStart4} of this document for a list +\ilink{the bugs section}{BugsChapter} of this document for a list of known bugs and solutions. \begin{description} @@ -118,7 +118,7 @@ of known bugs and solutions. 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 + instructions in the \ilink{ Running Bacula}{TutorialChapter} 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. @@ -254,7 +254,7 @@ where you need to adjust the device name for your system. For the first problem, see the next FAQ question. For the second problem, please review the \ilink{ Windows Installation - instructions}{_ChapterStart7} in this manual. + instructions}{Win32Chapter} in this manual. \label{windowsdie} \section{My Windows Client Immediately Dies When I Start It} @@ -356,7 +356,7 @@ FAQ for how to do so. resource. For an example of how to backup to files, please see the \ilink{Pruning Example}{PruningExample} in the Recycling chapter of this manual. Also, there is a whole chapter devoted to \ilink{Basic Volume - Management}{_ChapterStart39}. This chapter was originally written to + Management}{DiskChapter}. This chapter was originally written to explain how to write to disk, but was expanded to include volume management. It is, however, still quite a good chapter to read. @@ -413,7 +413,7 @@ manual. \index[general]{Checking Restores} It is really quite simple, but took me a while to figure out how to "prove" it. First make a Bacula Rescue disk, see the - \ilink{Disaster Recovery Using Bacula}{_ChapterRescue} chapter + \ilink{Disaster Recovery Using Bacula}{RescueChapter} chapter of this manual. Second, you run a full backup of all your files on all partitions. Third, you run an Verify InitCatalog Job on the same FileSet, which diff --git a/docs/manual/filedconf.tex b/docs/manual/filedconf.tex index 4f87fe80..5b1ed7ee 100644 --- a/docs/manual/filedconf.tex +++ b/docs/manual/filedconf.tex @@ -2,7 +2,7 @@ %% \chapter{Client/File daemon Configuration} -\label{_ChapterStart25} +\label{FiledConfChapter} \index[general]{Configuration!Client/File daemon } \index[general]{Client/File daemon Configuration } @@ -13,7 +13,7 @@ configuration file. For a general discussion of configuration file and resources including the data types recognized by {\bf Bacula}, please see the -\ilink{Configuration}{_ChapterStart16} chapter of this manual. The +\ilink{Configuration}{ConfigureChapter} chapter of this manual. The following Client Resource definitions must be defined: \begin{itemize} diff --git a/docs/manual/fileset.tex b/docs/manual/fileset.tex index 10507541..f545b09e 100644 --- a/docs/manual/fileset.tex +++ b/docs/manual/fileset.tex @@ -568,9 +568,9 @@ Change: 2005-11-06 12:36:48.000000000 +0100 You may want to test your expressions prior to running your backup by using the bwild program. Please see the - \ilink{UtilitiesChapter}{Utilities} chapter of this manual for + \ilink{Utilities}{bwild} chapter of this manual for more. You can also test your full FileSet definition by using - the \ilink{estimate command}{estimate} command in the Console + the \ilink{estimate}{estimate} command in the Console chapter of this manual. It is recommended to enclose the string in double quotes. @@ -590,9 +590,9 @@ Change: 2005-11-06 12:36:48.000000000 +0100 You may want to test your expressions prior to running your backup by using the bwild program. Please see the - \ilink{UtilitiesChapter}{Utilities} chapter of this manual for + \ilink{Utilities}{bwild} chapter of this manual for more. You can also test your full FileSet definition by using - the \ilink{estimate command}{estimate} command in the Console + the \ilink{estimate}{estimate} command in the Console chapter of this manual. An example of excluding with the WildDir option on Win32 machines is presented below. @@ -616,9 +616,9 @@ Change: 2005-11-06 12:36:48.000000000 +0100 You may want to test your expressions prior to running your backup by using the bwild program. Please see the - \ilink{UtilitiesChapter}{Utilities} chapter of this manual for + \ilink{Utilities}{bwild} chapter of this manual for more. You can also test your full FileSet definition by using - the \ilink{estimate command}{estimate} command in the Console + the \ilink{estimate}{estimate} command in the Console chapter of this manual. An example of excluding with the WildFile option on Win32 machines is presented below. @@ -642,9 +642,9 @@ Change: 2005-11-06 12:36:48.000000000 +0100 another, and in addition, regular expressions are complicated, so you may want to test your expressions prior to running your backup by using the bregex program. Please see the - \ilink{UtilitiesChapter}{Utilities} chapter of this manual for + \ilink{Utilities}{bwild} chapter of this manual for more. You can also test your full FileSet definition by using - the \ilink{estimate command}{estimate} command in the Console + the \ilink{estimate}{estimate} command in the Console chapter of this manual. @@ -668,7 +668,7 @@ Change: 2005-11-06 12:36:48.000000000 +0100 another, and in addition, regular expressions are complicated, so you may want to test your expressions prior to running your backup by using the bregex program. Please see the - \ilink{UtilitiesChapter}{Utilities} chapter of this manual for + \ilink{Utilities}{bregex} chapter of this manual for more. @@ -690,7 +690,7 @@ Change: 2005-11-06 12:36:48.000000000 +0100 another, and in addition, regular expressions are complicated, so you may want to test your expressions prior to running your backup by using the bregex program. Please see the - \ilink{UtilitiesChapter}{Utilities} chapter of this manual for + \ilink{Utilities}{bregex} chapter of this manual for more. @@ -949,7 +949,7 @@ Include { Ludovic Strappazon has pointed out that this feature can be used to backup a full Microsoft Windows disk. Simply boot into the system using a Linux Rescue disk, then load a statically linked Bacula as described in the - \ilink{ Disaster Recovery Using Bacula}{_ChapterRescue} chapter of + \ilink{ Disaster Recovery Using Bacula}{RescueChapter} chapter of this manual. Then save the whole disk partition. In the case of a disaster, you can then restore the desired partition by again booting with the rescue disk and doing a restore of the partition. @@ -1523,7 +1523,7 @@ as of version 1.37.30 or later. If you wish to get an idea of what your FileSet will really backup or if your exclusion rules will work correctly, you can test it by using the {\bf estimate} command in the Console program. See the -\ilink{estimate command}{estimate} in the Console chapter of this +\ilink{estimate}{estimate} in the Console chapter of this manual. As an example, suppose you add the following test FileSet: diff --git a/docs/manual/firewalls.tex b/docs/manual/firewalls.tex index be777f1c..1e93c04e 100644 --- a/docs/manual/firewalls.tex +++ b/docs/manual/firewalls.tex @@ -2,7 +2,7 @@ %% \chapter{Dealing with Firewalls} -\label{_ChapterStart26} +\label{FirewallsChapter} \index[general]{Dealing with Firewalls } \index[general]{Firewalls!Dealing with } diff --git a/docs/manual/general.tex b/docs/manual/general.tex index cf485ab3..3605d1fe 100644 --- a/docs/manual/general.tex +++ b/docs/manual/general.tex @@ -2,7 +2,7 @@ %% \chapter{What is Bacula?} -\label{_ChapterStart41} +\label{GeneralChapter} \index[general]{Bacula!What is } \index[general]{What is Bacula? } @@ -131,16 +131,16 @@ Bacula is made up of the following five major components or services: The RPMs for MySQL and PostgreSQL ship as part of Red Hat Linux and several other releases. Alternatively, building the rpms from the source is quite easy, see the \ilink{ Installing and Configuring - MySQL}{_ChapterStart} chapter of this document for the details. For + MySQL}{MySqlChapter} chapter of this document for the details. For more information on MySQL, please see: \elink{www.mysql.com}{http://www.mysql.com}. Or see the \ilink{ - Installing and Configuring PostgreSQL}{_ChapterStart10} chapter of this + Installing and Configuring PostgreSQL}{PostgreSqlChapter} chapter of this document for the details. For more information on PostgreSQL, please see: \elink{www.postgresql.org}{http://www.postgresql.org}. Configuring and building SQLite is even easier. For the details of configuring SQLite, please see the \ilink{ Installing and Configuring - SQLite}{_ChapterStart33} chapter of this document. + SQLite}{SqlLiteChapter} chapter of this document. \item \label{MonDef} {\bf Bacula Monitor} services is the program that allows the @@ -189,14 +189,14 @@ generally lags behind the code a bit. To get Bacula up and running quickly, we recommend that you first scan the Terminology section below, then quickly review the next chapter entitled -\ilink{The Current State of Bacula}{_ChapterStart2}, then the -\ilink{Getting Started with Bacula}{_ChapterStart37}, which will +\ilink{The Current State of Bacula}{StateChapter}, then the +\ilink{Getting Started with Bacula}{QuickStartChapter}, which will give you a quick overview of getting Bacula running. After which, you should proceed to the chapter on -\ilink{Installing Bacula}{_ChapterStart17}, then -\ilink{How to Configure Bacula}{_ChapterStart16}, and finally the +\ilink{Installing Bacula}{InstallChapter}, then +\ilink{How to Configure Bacula}{ConfigureChapter}, and finally the chapter on -\ilink{ Running Bacula}{_ChapterStart1}. +\ilink{ Running Bacula}{TutorialChapter}. \section{Terminology} \index[general]{Terminology } @@ -469,7 +469,7 @@ NOT YET IMPLEMENTED. {\bf Bacula} is a backup, restore and verification program and is not a complete disaster recovery system in itself, but it can be a key part of one if you plan carefully and follow the instructions included in the -\ilink{ Disaster Recovery}{_ChapterRescue} Chapter of this manual. +\ilink{ Disaster Recovery}{RescueChapter} Chapter of this manual. With proper planning, as mentioned in the Disaster Recovery chapter {\bf Bacula} can be a central component of your disaster recovery system. For diff --git a/docs/manual/gpl.tex b/docs/manual/gpl.tex index a4db8126..1e08236e 100644 --- a/docs/manual/gpl.tex +++ b/docs/manual/gpl.tex @@ -2,7 +2,7 @@ %% \section*{GNU General Public License} -\label{_ChapterStart20} +\label{GplChapter} \index[general]{GNU General Public License } \index[general]{License!GNU General Public } diff --git a/docs/manual/install.tex b/docs/manual/install.tex index 01b19a99..224c9348 100644 --- a/docs/manual/install.tex +++ b/docs/manual/install.tex @@ -2,7 +2,7 @@ %% \chapter{Installing Bacula} -\label{_ChapterStart17} +\label{InstallChapter} \index[general]{Bacula!Installing} \index[general]{Installing Bacula} @@ -298,9 +298,9 @@ The basic installation is rather simple. \item Install and build any {\bf depkgs} as noted above. This should be unnecessary on most modern Operating Systems. \item Configure and install MySQL or PostgreSQL (if desired). - \ilink{Installing and Configuring MySQL Phase I}{_ChapterStart} or + \ilink{Installing and Configuring MySQL Phase I}{MySqlChapter} or \ilink{Installing and Configuring PostgreSQL Phase - I}{_ChapterStart10}. If you are installing from rpms, and are + I}{PostgreSqlChapter}. If you are installing from rpms, and are using MySQL, please be sure to install {\bf mysql-devel}, so that the MySQL header files are available while compiling Bacula. In addition, the MySQL client library {\bf mysqlclient} requires the gzip compression library {\bf @@ -316,7 +316,7 @@ The basic installation is rather simple. \item As an alternative to MySQL and PostgreSQL, configure and install SQLite, which is part of the {\bf depkgs} and also available with most modern Operating Systems. - \ilink{Installing and Configuring SQLite}{_ChapterStart33}. SQLite is + \ilink{Installing and Configuring SQLite}{SqlLiteChapter}. SQLite is probably not suited to a fair size production environment because it tends to be slow compared to MySQL and it has few or poor tools for repairing database damage. @@ -380,7 +380,7 @@ continue on. \item Customize the configuration files for each of the three daemons (Directory, File, Storage) and for the Console program. For the details of how to do this, please see \ilink{Setting Up Bacula Configuration - Files}{_ChapterStart16} in the Configuration chapter of this manual. We + Files}{ConfigureChapter} in the Configuration chapter of this manual. We recommend that you start by modifying the default configuration files supplied, making the minimum changes necessary. Complete customization can be done after you have Bacula up and running. Please take care when @@ -403,7 +403,7 @@ continue on. \item Interface with Bacula using the Console program \item For the previous two items, please follow the instructions in the - \ilink{Running Bacula}{_ChapterStart1} chapter of this manual, + \ilink{Running Bacula}{TutorialChapter} chapter of this manual, where you will run a simple backup and do a restore. Do this before you make heavy modifications to the configuration files so that you are sure that Bacula works and are familiar with it. After that changing the conf files @@ -551,7 +551,7 @@ recommend that you install either MySQL or PostgreSQL for production work. If you wish to use MySQL as the Bacula catalog, please see the -\ilink{Installing and Configuring MySQL}{_ChapterStart} chapter of +\ilink{Installing and Configuring MySQL}{MySqlChapter} chapter of this manual. You will need to install MySQL prior to continuing with the configuration of Bacula. MySQL is a high quality database that is very efficient and is suitable for any sized installation. It is slightly more @@ -560,7 +560,7 @@ sophisticated features such as userids and passwords. It runs as a separate process, is truly professional and can manage a database of any size. If you wish to use PostgreSQL as the Bacula catalog, please see the -\ilink{Installing and Configuring PostgreSQL}{_ChapterStart10} +\ilink{Installing and Configuring PostgreSQL}{PostgreSqlChapter} chapter of this manual. You will need to install PostgreSQL prior to continuing with the configuration of Bacula. PostgreSQL is very similar to MySQL, though it tends to be slightly more SQL92 compliant and has many more @@ -568,7 +568,7 @@ advanced features such as transactions, stored procedures, and the such. It requires a certain knowledge to install and maintain. If you wish to use SQLite as the Bacula catalog, please see -\ilink{Installing and Configuring SQLite}{_ChapterStart33} chapter of +\ilink{Installing and Configuring SQLite}{SqlLiteChapter} chapter of this manual. \section{Quick Start} @@ -825,7 +825,7 @@ customize your installation. This enables use of the SQLite version 2.8.x database. The {\bf sqlite-path} is not normally specified as Bacula looks for the necessary components in a standard location ({\bf depkgs/sqlite}). See - \ilink{Installing and Configuring SQLite}{_ChapterStart33} chapter of + \ilink{Installing and Configuring SQLite}{SqlLiteChapter} chapter of this manual for more details. See the note below under the {-}{-}with-postgresql item. @@ -835,7 +835,7 @@ customize your installation. This enables use of the SQLite version 3.x database. The {\bf sqlite3-path} is not normally specified as Bacula looks for the necessary components in a standard location ({\bf depkgs/sqlite3}). See - \ilink{Installing and Configuring SQLite}{_ChapterStart33} chapter of + \ilink{Installing and Configuring SQLite}{SqlLiteChapter} chapter of this manual for more details. \item [ {-}{-}with-mysql=\lt{}mysql-path\gt{}] @@ -846,7 +846,7 @@ customize your installation. in a standard system location, you can simply use {\bf {-}{-}with-mysql} with no path specification. If you do use this option, please proceed to installing MySQL in the \ilink{Installing and Configuring - MySQL}{_ChapterStart} chapter before proceeding with the configuration. + MySQL}{MySqlChapter} chapter before proceeding with the configuration. See the note below under the {-}{-}with-postgresql item. @@ -885,7 +885,7 @@ customize your installation. standard library locations for Python 2.2, 2.3, or 2.4. If it cannot find the library, you will need to supply a path to your Python library directory. Please see the - \ilink{Python chapter}{_ChapterStart60} for the details of using + \ilink{Python chapter}{PythonChapter} for the details of using Python scripting. \item [ {-}{-}with-libintl-prefix=\lt{}DIR\gt{}] @@ -1227,7 +1227,7 @@ probably not work. \index[general]{Win32} To install the binary Win32 version of the File daemon please see the -\ilink{Win32 Installation Chapter}{_ChapterStart7} in this document. +\ilink{Win32 Installation Chapter}{Win32Chapter} in this document. \section{One File Configure Script} \index[general]{Script!One File Configure} @@ -1511,5 +1511,5 @@ supported by your window manager, and if applicable, how to activate it. \index[general]{Files!Modifying the Bacula Configuration} See the chapter -\ilink{Configuring Bacula}{_ChapterStart16} in this manual for +\ilink{Configuring Bacula}{ConfigureChapter} in this manual for instructions on how to set Bacula configuration files. diff --git a/docs/manual/internaldb.tex b/docs/manual/internaldb.tex index fb0f865b..fc0c5dc0 100644 --- a/docs/manual/internaldb.tex +++ b/docs/manual/internaldb.tex @@ -3,7 +3,7 @@ \section*{The internal database is not supported, please do not use it.} -\label{_ChapterStart42} +\label{InternalDbChapter} \index[general]{Use it!The internal database is not supported please do not } \index[general]{The internal database is not supported, please do not diff --git a/docs/manual/kaboom.tex b/docs/manual/kaboom.tex index 164b0ba6..b4f16a5c 100644 --- a/docs/manual/kaboom.tex +++ b/docs/manual/kaboom.tex @@ -2,7 +2,7 @@ %% \chapter{What To Do When Bacula Crashes (Kaboom)} -\label{_ChapterStart47} +\label{KaboomChapter} \index[general]{Kaboom!What To Do When Bacula Crashes } \index[general]{What To Do When Bacula Crashes (Kaboom) } diff --git a/docs/manual/lesser.tex b/docs/manual/lesser.tex index 5bee83d3..eadd217f 100644 --- a/docs/manual/lesser.tex +++ b/docs/manual/lesser.tex @@ -2,7 +2,7 @@ %% \section*{GNU Lesser General Public License} -\label{_ChapterStart49} +\label{LesserChapter} \index[general]{GNU Lesser General Public License } \index[general]{License!GNU Lesser General Public } diff --git a/docs/manual/license.tex b/docs/manual/license.tex index d3c9b0f1..17e68fa7 100644 --- a/docs/manual/license.tex +++ b/docs/manual/license.tex @@ -2,16 +2,28 @@ %% \chapter{Bacula Copyright, Trademark, and Licenses} -\label{_ChapterStart29} +\label{LicenseChapter} \index[general]{Licenses!Bacula Copyright Trademark} \index[general]{Bacula Copyright, Trademark, and Licenses} There are a number of different licenses that are used in Bacula. +If you have a printed copy of this manual, the details of each of +the licenses referred to in this chapter can be found in the +online version of the manual at +\elink{http://www.bacula.org}{http://www.bacula.org}. \section{FDL} \index[general]{FDL } -The GNU Free Documentation License (FDL) is used for this manual. +The GNU Free Documentation License (FDL) is used for this manual, +which is a free and open license. This means that you may freely +reproduce it and even make changes to it. However, rather than +distribute your own version of this manual, we would much prefer +if you would send any corrections or changes to the Bacula project. + +The most recent version of the manual can always be found online +at \elink{http://www.bacula.org}{http://www.bacula.org}. + % TODO: Point to appendix that has it @@ -19,7 +31,7 @@ The GNU Free Documentation License (FDL) is used for this manual. \index[general]{GPL } The vast bulk of the source code is released under a modified version of the -\ilink{GNU General Public License version 2.}{_ChapterStart20} The +\ilink{GNU General Public License version 2.}{GplChapter} The modifications (actually additions) are described in the source file LICENSE, and their purpose is not to alter the essential qualities of the GPL but to permit more freedom in linking certain third party software supposedly non-GPL @@ -39,7 +51,7 @@ non-modified GPL 2 license. \index[general]{LGPL } Some of the Bacula library source code is released under the -\ilink{GNU Lesser General Public License.}{_ChapterStart49} This +\ilink{GNU Lesser General Public License.}{LesserChapter} This permits third parties to use these parts of our code in their proprietary programs to interface to Bacula. diff --git a/docs/manual/migration.tex b/docs/manual/migration.tex index 794ae744..5ccf899e 100644 --- a/docs/manual/migration.tex +++ b/docs/manual/migration.tex @@ -1,6 +1,6 @@ \chapter{Migration} -\label{_MigrationChapter} +\label{MigrationChapter} \index[general]{Migration} The term Migration, as used in the context of Bacula, means moving data from diff --git a/docs/manual/monitorconf.tex b/docs/manual/monitorconf.tex index 6af6d582..20c70b9d 100644 --- a/docs/manual/monitorconf.tex +++ b/docs/manual/monitorconf.tex @@ -13,7 +13,7 @@ daemons you want to monitor. For a general discussion of configuration file and resources including the data types recognized by {\bf Bacula}, please see the -\ilink{Configuration}{_ChapterStart16} chapter of this manual. +\ilink{Configuration}{ConfigureChapter} chapter of this manual. The following Monitor Resource definition must be defined: @@ -56,7 +56,7 @@ Console name used to connect to Director. This record is required. Where the password is the password needed for Directors to accept the Console connection. This password must be identical to the {\bf Password} specified in the {\bf Console} resource of the -\ilink{Director's configuration}{_ChapterStart40} file. This +\ilink{Director's configuration}{DirectorChapter} file. This record is required if you wish to monitor Directors. \item [Refresh Interval = \lt{}time\gt{}] @@ -79,7 +79,7 @@ monitored by this Monitor. As you are not permitted to define a Password in this resource, to avoid obtaining full Director privileges, you must create a Console resource in the -\ilink{Director's configuration}{_ChapterStart40} file, using the +\ilink{Director's configuration}{DirectorChapter} file, using the Console Name and Password defined in the Monitor resource. To avoid security problems, you should configure this Console resource to allow access to no other daemons, and permit the use of only two commands: {\bf status} and {\bf @@ -107,7 +107,7 @@ likely already be set to the value you specified on the {\bf \verb:--:with-base-port} option of the {\bf ./configure} command. This port must be identical to the {\bf DIRport} specified in the {\bf Director} resource of the -\ilink{Director's configuration}{_ChapterStart40} file. The +\ilink{Director's configuration}{DirectorChapter} file. The default is 9101 so this record is not normally specified. \item [Address = \lt{}address\gt{}] @@ -125,7 +125,7 @@ The Client resource defines the attributes of the Clients that are monitored by this Monitor. You must create a Director resource in the -\ilink{Client's configuration}{_ChapterStart25} file, using the +\ilink{Client's configuration}{FiledConfChapter} file, using the Director Name defined in the Monitor resource. To avoid security problems, you should set the {\bf Monitor} directive to {\bf Yes} in this Director resource. @@ -173,7 +173,7 @@ The Storage resource defines the attributes of the Storages that are monitored by this Monitor. You must create a Director resource in the -\ilink{Storage's configuration}{_ChapterStart31} file, using the +\ilink{Storage's configuration}{StoredConfChapter} file, using the Director Name defined in the Monitor resource. To avoid security problems, you should set the {\bf Monitor} directive to {\bf Yes} in this Director resource. diff --git a/docs/manual/mysql.tex b/docs/manual/mysql.tex index 2ad4fa98..076dc01e 100644 --- a/docs/manual/mysql.tex +++ b/docs/manual/mysql.tex @@ -2,7 +2,7 @@ %% \chapter{Installing and Configuring MySQL} -\label{_ChapterStart} +\label{MySqlChapter} \index[general]{MySQL!Installing and Configuring } \index[general]{Installing and Configuring MySQL } diff --git a/docs/manual/oldfileset.tex b/docs/manual/oldfileset.tex index 2197fd57..43a190fa 100644 --- a/docs/manual/oldfileset.tex +++ b/docs/manual/oldfileset.tex @@ -2,7 +2,7 @@ %% \chapter{The Old FileSet Resource} -\label{_ChapterStart} +\label{OldFileSetChapter} \label{FileSetResource} \index[general]{Resource!Old FileSet } \index[general]{Old FileSet Resource } @@ -398,7 +398,7 @@ will backup the data in device /dev/hd6. Ludovic Strappazon has pointed out that this feature can be used to backup a full Microsoft Windows disk. Simply boot into the system using a Linux Rescue disk, then load a statically linked Bacula as described in the -\ilink{ Disaster Recovery Using Bacula}{rescue.tex#_ChapterStart} chapter of +\ilink{ Disaster Recovery Using Bacula}{RescueChapter} chapter of this manual. Then simply save the whole disk partition. In the case of a disaster, you can then restore the desired partition. \item If you explicitly specify a FIFO device name (created with mkfifo), and diff --git a/docs/manual/pools.tex b/docs/manual/pools.tex index e4451519..250778e6 100644 --- a/docs/manual/pools.tex +++ b/docs/manual/pools.tex @@ -2,7 +2,7 @@ %% \chapter{Automated Disk Backup} -\label{_ChapterStart11} +\label{PoolsChapter} \index[general]{Volumes!Using Pools to Manage} \index[general]{Disk!Automated Backup} \index[general]{Using Pools to Manage Volumes} diff --git a/docs/manual/postgresql.tex b/docs/manual/postgresql.tex index 211d8632..aa567a1b 100644 --- a/docs/manual/postgresql.tex +++ b/docs/manual/postgresql.tex @@ -2,7 +2,7 @@ %% \chapter{Installing and Configuring PostgreSQL} -\label{_ChapterStart10} +\label{PostgreSqlChapter} \index[general]{PostgreSQL!Installing and Configuring } \index[general]{Installing and Configuring PostgreSQL } diff --git a/docs/manual/progs.tex b/docs/manual/progs.tex index 985462eb..8c20b1e5 100644 --- a/docs/manual/progs.tex +++ b/docs/manual/progs.tex @@ -407,7 +407,7 @@ information needed to restore precisely the files you want. Specifying a {\bf bootstrap} file is optional but recommended because it gives you the most control over which files will be restored. For more details on the {\bf bootstrap} file, please see -\ilink{Restoring Files with the Bootstrap File}{_ChapterStart43} +\ilink{Restoring Files with the Bootstrap File}{BootstrapChapter} chapter of this document. Note, you may also use a bootstrap file produced by the {\bf restore} command. For example: @@ -810,7 +810,7 @@ your first Bacula job to ensure that the parameters you have defined for your storage device (tape drive) will permit {\bf Bacula} to function properly. You only need to mount a blank tape, enter the command, and the output should be reasonably self explanatory. Please see the -\ilink{Tape Testing}{_ChapterStart27} Chapter of this manual for +\ilink{Tape Testing}{TapeTestingChapter} Chapter of this manual for the details. \subsection{btape Commands} @@ -1114,7 +1114,7 @@ recommendations given above, which are given so that users don't waste their time running dbcheck too often. \section{bregex} -\label{regex} +\label{bregex} \index[general]{bregex} \index[general]{program!bregex} @@ -1150,7 +1150,7 @@ This program can be useful for testing regex expressions to be applied against a list of filenames. \section{bwild} -\label{wild} +\label{bwild} \index[general]{bwild} \index[general]{program!bwild} diff --git a/docs/manual/projects.tex b/docs/manual/projects.tex index 761a36f7..f118e791 100644 --- a/docs/manual/projects.tex +++ b/docs/manual/projects.tex @@ -2,7 +2,7 @@ %% \chapter{Bacula Projects} -\label{_ChapterStart28} +\label{ProjectsChapter} \index[general]{Projects!Bacula } \index[general]{Bacula Projects } diff --git a/docs/manual/python.tex b/docs/manual/python.tex index 45e3533e..40e1b2e0 100644 --- a/docs/manual/python.tex +++ b/docs/manual/python.tex @@ -2,7 +2,7 @@ %% \chapter{Python Scripting} -\label{_ChapterStart60} +\label{PythonChapter} \index[general]{Python Scripting} \index[general]{Scripting!Python} diff --git a/docs/manual/quickstart.tex b/docs/manual/quickstart.tex index 0f688ade..23ea1364 100644 --- a/docs/manual/quickstart.tex +++ b/docs/manual/quickstart.tex @@ -2,8 +2,7 @@ %% \chapter{Getting Started with Bacula} -\label{_ChapterStart37} -% TODO: cleanup these labels to use descriptions not numbers +\label{QuickStartChapter} \index[general]{Getting Started with Bacula } If you are like me, you want to get Bacula running immediately to get a feel @@ -16,7 +15,7 @@ particular follow the instructions for testing your tape drive. We assume that you have managed to build and install Bacula, if not, you might want to first look at the \ilink{System Requirements}{SysReqs} then at the -\ilink{Compiling and Installing Bacula}{_ChapterStart17} chapter of +\ilink{Compiling and Installing Bacula}{InstallChapter} chapter of this manual. \label{JobsandSchedules} @@ -120,34 +119,32 @@ right. Please do not despair. Once you have created your configuration files, you will rarely need to change them nor will you stop and start Bacula very often. Most of the work will simply be in changing the tape when it is full. -\subsection{ -\ilink{Configuring the Console Program}{_ChapterStart36}} +\subsection{Configuring the Console Program} \index[general]{Configuring the Console Program } \index[general]{Program!Configuring the Console } The Console program is used by the administrator to interact with the Director and to manually start/stop Jobs or to obtain Job status information. -The Console configuration file is found in the directory specified on the {\bf -\verb:--:sysconfdir} option that you specified on the {\bf ./configure} command -and -by default is named {\bf console.conf}. +The Console configuration file is found in the directory specified on the +{\bf \verb:--:sysconfdir} option that you specified on the {\bf +./configure} command and by default is named {\bf bconsole.conf}. -If you choose to build the GNOME console with the {\bf \verb:--:enable-gnome} -option, -you also find a default configuration file for it, named {\bf -gnome-console.conf}. +If you choose to build the GNOME console with the {\bf +\verb:--:enable-gnome} option, you also find a default configuration file +for it, named {\bf gnome-console.conf}. The same applies to the wxWidgets console, which is build with the {\bf -\verb:--:enable-wx-console} option, and the name of the default configuration -file -is, in this case, {\bf wx-console.conf}. +\verb:--:enable-wx-console} option, and the name of the default +configuration file is, in this case, {\bf wx-console.conf}. Normally, for first time users, no change is needed to these files. Reasonable defaults are set. -\subsection{ -\ilink{Configuring the Monitor Program}{_MonitorChapter}} +Further details are in the +\ilink{Console configuration}{ConsoleConfChapter} chapter. + +\subsection{Configuring the Monitor Program} \index[general]{Program!Configuring the Monitor } \index[general]{Configuring the Monitor Program } @@ -175,8 +172,10 @@ graphical environment (don't forget to allow non-root users to execute {\bf bacula-tray-monitor}). This is not a security problem as long as you use the default settings. -\subsection{ -\ilink{Configuring the File daemon}{_ChapterStart25}} +More information is in the +\ilink{Monitor configuration}{_MonitorChapter} chapter. + +\subsection{Configuring the File daemon} \index[general]{Daemon!Configuring the File } \index[general]{Configuring the File daemon } @@ -195,8 +194,10 @@ File daemon must appear in the Director's configuration file. % TODO: point to section about how to install just the File daemon % TODO: and creating the unique configuration file. -\subsection{ -\ilink{Configuring the Director}{_ChapterStart40}} +Further details are in the +\ilink{File daemon configuration}{FiledConfChapter} chapter. + +\subsection{Configuring the Director} \index[general]{Director!Configuring the } \index[general]{Configuring the Director } @@ -242,8 +243,10 @@ working directory, the daemons temporary file names will not be unique, and you will get many strange failures. % TODO: why not check for that and not allow sharing working directory? -\subsection{ -\ilink{Configuring the Storage daemon}{_ChapterStart31}} +More information is in the +\ilink{Director configuration}{DirectorChapter} chapter. + +\subsection{Configuring the Storage daemon} \index[general]{Daemon!Configuring the Storage } \index[general]{Configuring the Storage daemon } @@ -263,6 +266,9 @@ instead of a tape, the Archive device must point to a directory in which the Volumes will be created as files when you label the Volume. \label{ConfigTesting} +Further information is in the +\ilink{Storage daemon configuration}{StoredConfChapter} chapter. + \section{Testing your Configuration Files} \index[general]{Testing your Configuration Files } \index[general]{Files!Testing your Configuration } @@ -305,7 +311,7 @@ conf file name). Before spending a lot of time on Bacula only to find that it doesn't work with your tape drive, please read the \ilink{btape -- Testing Your Tape -Drive}{_ChapterStart27} chapter of this manual. If you have a modern +Drive}{TapeTestingChapter} chapter of this manual. If you have a modern standard SCSI tape drive on a Linux or Solaris, most likely it will work, but better test than be sorry. For FreeBSD (and probably other xBSD flavors), reading the above mentioned tape testing chapter is a must. @@ -350,7 +356,7 @@ errors, than if you had already tried it once. To get a good idea how to use Bacula in a short time, we {\bf strongly} recommend that you follow the example in the -\ilink{Running Bacula Chapter}{_ChapterStart1} of this manual where +\ilink{Running Bacula Chapter}{TutorialChapter} of this manual where you will get detailed instructions on how to run Bacula. \section{Log Rotation} @@ -380,7 +386,7 @@ explanation on how to install it and what kind of output to expect. If you intend to use Bacula as a disaster recovery tool rather than simply a program to restore lost or damaged files, you will want to read the -\ilink{Disaster Recovery Using Bacula Chapter}{_ChapterRescue} of +\ilink{Disaster Recovery Using Bacula Chapter}{RescueChapter} of this manual. In any case, you are strongly urged to carefully test restoring some files diff --git a/docs/manual/recycling.tex b/docs/manual/recycling.tex index 951b59b7..44f3b82c 100644 --- a/docs/manual/recycling.tex +++ b/docs/manual/recycling.tex @@ -2,7 +2,7 @@ %% \chapter{Automatic Volume Recycling} -\label{_ChapterStart22} +\label{RecyclingChapter} \index[general]{Recycling!Automatic Volume } \index[general]{Automatic Volume Recycling } @@ -51,7 +51,7 @@ directives such as: \item Maximum Volume Bytes = mmm \end{itemize} Please see below and -the \ilink{Basic Volume Management}{_ChapterStart39} chapter +the \ilink{Basic Volume Management}{DiskChapter} chapter of this manual for more complete examples. Automatic recycling of Volumes is performed by Bacula only when it wants a @@ -659,7 +659,7 @@ comment out the {\bf Schedule} record in the {\bf Job} resource. Although automatic recycling of Volumes is implemented in version 1.20 and later (see the -\ilink{Automatic Recycling of Volumes}{_ChapterStart22} chapter of +\ilink{Automatic Recycling of Volumes}{RecyclingChapter} chapter of this manual), you may want to manually force reuse (recycling) of a Volume. Assuming that you want to keep the Volume name, but you simply want to write diff --git a/docs/manual/restore.tex b/docs/manual/restore.tex index 63fa534c..afb98ea3 100644 --- a/docs/manual/restore.tex +++ b/docs/manual/restore.tex @@ -219,7 +219,7 @@ to be restored, so it prompts with: \begin{verbatim} The defined FileSet resources are: 1: Full Set - 2: Kerns Files + 2: Other Files Select FileSet resource (1-2): \end{verbatim} \normalsize @@ -370,7 +370,7 @@ JobName: kernsrestore Bootstrap: /home/kern/bacula/working/restore.bsr Where: /tmp/bacula-restores Replace: always -FileSet: Kerns Files +FileSet: Other Files Client: Rufus Storage: Tape When: 2006-12-11 18:20:33 @@ -512,7 +512,7 @@ JobName: kernsrestore Bootstrap: /home/kern/bacula/working/restore.bsr Where: /tmp/bacula-restores Replace: always -FileSet: Kerns Files +FileSet: Other Files Client: Rufus Storage: DDS-4 When: 2003-09-11 10:20:53 @@ -961,7 +961,7 @@ provide a few ideas how to get out of these problem situations. In addition to what is presented here, there is more specific information on restoring a \ilink{Client}{restore_client} and your \ilink{Server}{restore_server} in the \ilink{Disaster Recovery Using -Bacula}{_ChapterRescue} chapter of this manual. +Bacula}{RescueChapter} chapter of this manual. \begin{description} \item[Problem] @@ -1026,7 +1026,7 @@ OK to run? (yes/mod/no): You will then need to follow the instructions for your database type to recreate the database from the ASCII backup file. - See the \ilink {Catalog Maintenance}{_ChapterStart12} chapter of + See the \ilink {Catalog Maintenance}{CatMaintenanceChapter} chapter of this manual for examples of the command needed to restore a database from an ASCII dump (they are shown in the Compacting Your XXX Database sections). @@ -1119,7 +1119,7 @@ FileIndex=1-1 Once you have restored the ASCII dump of the database, you will then to follow the instructions for your database type to recreate the database from the ASCII backup file. - See the \ilink {Catalog Maintenance}{_ChapterStart12} chapter of + See the \ilink {Catalog Maintenance}{CatMaintenanceChapter} chapter of this manual for examples of the command needed to restore a database from an ASCII dump (they are shown in the Compacting Your XXX Database sections). diff --git a/docs/manual/rpm-faq.tex b/docs/manual/rpm-faq.tex index 3ce3901d..6f413b90 100644 --- a/docs/manual/rpm-faq.tex +++ b/docs/manual/rpm-faq.tex @@ -2,7 +2,7 @@ %% \chapter{Bacula RPM Packaging FAQ} -\label{_ChapterStart34} +\label{RpmFaqChapter} \index[general]{FAQ!Bacula\textsuperscript{\textregistered} - RPM Packaging } \index[general]{Bacula\textsuperscript{\textregistered} - RPM Packaging FAQ } diff --git a/docs/manual/security.tex b/docs/manual/security.tex index cba37381..cf2fb840 100644 --- a/docs/manual/security.tex +++ b/docs/manual/security.tex @@ -2,7 +2,7 @@ %% \chapter{Bacula Security Issues} -\label{_ChapterStart14} +\label{SecurityChapter} \index[general]{Bacula Security Issues} \index[general]{Security} \index[general]{Issues!Bacula Security} diff --git a/docs/manual/sqlite.tex b/docs/manual/sqlite.tex index a95b386f..db380acd 100644 --- a/docs/manual/sqlite.tex +++ b/docs/manual/sqlite.tex @@ -2,7 +2,7 @@ %% \chapter{Installing and Configuring SQLite} -\label{_ChapterStart33} +\label{SqlLiteChapter} \index[general]{Installing and Configuring SQLite } \index[general]{SQLite!Installing and Configuring } diff --git a/docs/manual/state.tex b/docs/manual/state.tex index 332aeb2a..e30cd2a2 100644 --- a/docs/manual/state.tex +++ b/docs/manual/state.tex @@ -2,7 +2,7 @@ %% \chapter{The Current State of Bacula} -\label{_ChapterStart2} +\label{StateChapter} \index[general]{Current State of Bacula } In other words, what is and what is not currently implemented and functional. @@ -46,7 +46,7 @@ In other words, what is and what is not currently implemented and functional. current backup or a backup prior to a specified time and date. \item Restore of a complete system starting from bare metal. This is mostly automated for Linux systems and partially automated for Solaris. See - \ilink{Disaster Recovery Using Bacula}{_ChapterRescue}. This is also + \ilink{Disaster Recovery Using Bacula}{RescueChapter}. This is also reported to work on Win2K/XP systems. \item Listing and Restoration of files using stand-alone {\bf bls} and {\bf bextract} tool programs. Among other things, this permits extraction of files @@ -132,7 +132,7 @@ In other words, what is and what is not currently implemented and functional. \begin{itemize} \item Multi-threaded implementation. \item A comprehensive and extensible - \ilink{configuration file}{_ChapterStart40} for each daemon. + \ilink{configuration file}{DirectorChapter} for each daemon. \end{itemize} \end{itemize} diff --git a/docs/manual/storedconf.tex b/docs/manual/storedconf.tex index 6baf99c3..6c152224 100644 --- a/docs/manual/storedconf.tex +++ b/docs/manual/storedconf.tex @@ -2,7 +2,7 @@ %% \chapter{Storage Daemon Configuration} -\label{_ChapterStart31} +\label{StoredConfChapter} \index[general]{Storage Daemon Configuration} \index[general]{Configuration!Storage Daemon} @@ -21,7 +21,7 @@ here. For a general discussion of configuration file and resources including the data types recognized by {\bf Bacula}, please see the -\ilink{Configuration}{_ChapterStart16} chapter of this manual. The +\ilink{Configuration}{ConfigureChapter} chapter of this manual. The following Storage Resource definitions must be defined: \begin{itemize} @@ -406,7 +406,7 @@ specified within the Device resource are specific to the Device. /dev/sg0} for the Changer Device name. Depending on your exact configuration, and the number of autochangers or the type of autochanger, what you specify here can vary. This directive is - optional. See the \ilink{ Using Autochangers}{_ChapterStart18} chapter + optional. See the \ilink{ Using Autochangers}{AutochangersChapter} chapter of this manual for more details of using this and the following autochanger directives. @@ -431,7 +431,7 @@ Changer Command = "/path/mtx-changer %c %o %S %a %d" release). An example of this command is in the default bacula-sd.conf file. For more details on the substitution characters that may be specified to configure your autochanger please see the - \ilink{Autochangers}{_ChapterStart18} chapter of this manual. + \ilink{Autochangers}{AutochangersChapter} chapter of this manual. For FreeBSD users, you might want to see one of the several {\bf chio} scripts in {\bf examples/autochangers}. @@ -443,7 +443,7 @@ Changer Command = "/path/mtx-changer %c %o %S %a %d" wrong with your tape drive (at least for most modern tape drives). The same substitution characters that may be specified in the Changer Command may also be used in this string. For more information, please see the - \ilink{Autochangers}{_ChapterStart18} chapter of this manual. + \ilink{Autochangers}{AutochangersChapter} chapter of this manual. Note, it is not necessary to have an autochanger to use this command. The diff --git a/docs/manual/strategies.tex b/docs/manual/strategies.tex index e32043ca..c3eaed62 100644 --- a/docs/manual/strategies.tex +++ b/docs/manual/strategies.tex @@ -2,7 +2,7 @@ %% \chapter{Backup Strategies} -\label{_ChapterStart3} +\label{StrategiesChapter} \index[general]{Strategies!Backup } \index[general]{Backup Strategies } @@ -55,7 +55,7 @@ tape. Using this strategy, one typically does a Full backup once a week followed by daily Incremental backups. To minimize the amount of data written to the tape, -one can do (as I do) a Full backup once a month on the first Sunday of the +one can do a Full backup once a month on the first Sunday of the month, a Differential backup on the 2nd-5th Sunday of the month, and incremental backups the rest of the week. \label{Manual} @@ -75,9 +75,9 @@ several ways to get Bacula to release the tape: \item In your Storage daemon's Device resource, set {\bf AlwaysOpen = no} In this case, Bacula will release the tape after every job. If you run -several jobs, the tape will be rewound and repositioned to the end at the -beginning of every job. This is not very efficient, but does let you change -the tape whenever you want. + several jobs, the tape will be rewound and repositioned to the end at the + beginning of every job. This is not very efficient, but does let you change + the tape whenever you want. \item Use a {\bf RunAfterJob} statement to run a script after your last job. This could also be an {\bf Admin} job that runs after all your backup jobs. The script could be something like: @@ -85,7 +85,7 @@ the tape whenever you want. \footnotesize \begin{verbatim} #!/bin/sh - /full-path/console -c /full-path/console.conf <