

#include "bacula_template.inc" title="Bacula Storage Management System" tag=title

<div align="center">
 <img src="bclogo.gif" alt="Bacula" height=138 width=512>
 <h1>The Bacula<sup>&reg;</sup> Storage Management System Version 1.34.4</h1>
 <h2><em>It comes by night and sucks the vital essence from your
     computers</em></h2>
</div>

<hr>
<p align=center>
This document was last updated 20 June 2004.<br><br>
If you are viewing this document with Netscape, it probably looks     
really poor.<br> I recommend that you use 
<a href="http://galeon.sourceforge.net">Galeon</a> or
<a href="http://www.mozilla.org">Mozilla</a> instead.</p>
<h2>General Documents</h2>
<ul>
<li><a href="bacula.html">What is Bacula?</a></li>
<li><a href="state.html">What Is and What Is Not Implemented</a></li>
<li><a href="quickstart.html">Quick Start Guide to Bacula</a></li>
  <ul>
    <li class="sub"><a href="quickstart.html#SupportedOSes">Supported Operating Systems</a></li>
    <li class="sub"><a href="quickstart.html#SupportedDrives">Supported Tape Drives</a></li>
    <li class="sub"><a href="quickstart.html#UnSupportedDrives">Unsupported Tape Drives</a></li>
    <li class="sub"><a href="autochangers.html#Models">Supported Autochanger Models</a></li>
  </ul>
<li><a href="install.html">Compiling and Installing Bacula</a></li>
  <ul>
    <li class="sub"><a href="install.html#Dependency">Dependency Packages</a></li>
    <li class="sub"><a href="install.html#Building">Building from Source</a></li>
    <li class="sub"><a href="install.html#DB">What Database to Use?</a></li>
    <li class="sub"><a href="install.html#Options">Configure Options</a></li>
    <li class="sub"><a href="install.html#autostart">Auto Starting the Daemons</a></li>
    <li class="sub"><a href="security.html#wrappers">Configuring and Testing TCP Wrappers</a></li>
  </ul>

<li><a href="running.html">Brief Tutorial on How to Run Bacula</a></li>
  <ul>
    <li class="sub"><a href="running.html#StartDB">Starting the Database</a></li>
    <li class="sub"><a href="running.html#StartDaemon">Starting the Daemons</a></li>
    <li class="sub"><a href="running.html#Running">Running a Job</a></li>
    <li class="sub"><a href="running.html#restoring">Restoring Your Files</a></li>
    <li class="sub"><a href="running.html#SecondClient">Adding a Second Client</a></li>
    <li class="sub"><a href="running.html#FullTape">What To Do When The Tape Fills</a></li>
    <li class="sub"><a href="running.html#Labeling">Labeling Your Volumes</a></li>
    <li class="sub"><a href="running.html#Pool">Creating a Pool</a></li>
  </ul>

<li><a href="configure.html">Customizing Bacula Configuration Files</a></li>
   <ul>
      <li class="sub"><a href="configure.html#ResFormat">Resource Record Format</a></li>
      <li class="sub"><a href="configure.html#Comments">Comments</a></li>
      <li class="sub"><a href="configure.html#Case">Upper and Lower Case and Space</a></li>
      <li class="sub"><a href="configure.html#DataTypes">Data Types</a></li>
      <li class="sub"><a href="configure.html#ResTypes">Resource Types</a></li>

      <li><a href="dirdconf.html">Director Configuration Resources</a></li>
         <ul>
           <li class="sub"><a href="dirdconf.html#CatalogResource">Catalog Resource</a></li>
           <li class="sub"><a href="dirdconf.html#ClientResource">Client Resource</a></li>
           <li class="sub"><a href="dirdconf.html#ConsoleResource">Console Resource</a></li>
           <li class="sub"><a href="dirdconf.html#CounterResource">Counter Resource</a></li>
           <li class="sub"><a href="dirdconf.html#DirectorResource">Director Resource</a></li>
           <li class="sub"><a href="dirdconf.html#FileSetResource">FileSet Resource</a></li>
           <li class="sub"><a href="dirdconf.html#JobResource">Job Resource</a></li>
           <li class="sub"><a href="dirdconf.html#JobDefsResource">JobDefs Resource</a></li>
           <li class="sub"><a href="messagesres.html">Messages Resource</a></li>
           <li class="sub"><a href="dirdconf.html#PoolResource">Pool Resource</a></li>
           <li class="sub"><a href="dirdconf.html#ScheduleResource">Schedule Resource</a></li>
           <li class="sub"><a href="dirdconf.html#StorageResource">Storage Resource</a></li>
           <li class="sub"><a href="dirdconf.html#SampleDirectorConfiguration">Sample Director Configuration File</a></li>
         </ul>
      <li><a href="filedconf.html">Client/File Daemon Configuration Resources</a></li>
         <ul>
           <li class="sub"><a href="filedconf.html#ClientResource">Client Resource</a></li>
           <li class="sub"><a href="filedconf.html#DirectorResource">Director Resource</a></li>
           <li class="sub"><a href="messagesres.html">Messages Resource</a></li>
           <li class="sub"><a href="filedconf.html#SampleClientConfiguration">Sample Client Configuration File</a></li>
         </ul>
      <li><a href="storedconf.html">Storage Daemon Configuration Resources</a></li>
         <ul>
           <li class="sub"><a href="storedconf.html#StorageResource">Storage Resource</a></li>
           <li class="sub"><a href="storedconf.html#DirectorResource">Director Resource</a></li>
           <li class="sub"><a href="storedconf.html#DeviceResource">Device Resource</a></li>
           <li class="sub"><a href="messagesres.html">Messages Resource</a></li>
           <li class="sub"><a href="storedconf.html#SampleConfiguration">Sample Storage Configuration File</a></li>
         </ul>
      <li><a href="consoleconf.html">Console Configuration Resources</a></li>
         <ul>
           <li class="sub"><a href="consoleconf.html#DirectorResource">Director Resource</a></li>
           <li class="sub"><a href="consoleconf.html#SampleConfiguration">Sample Console Configuration File</a></li>
         </ul>
      <li><a href="vars.html">Variable Expansion</a></li>
   </ul>

<li><a href="console.html">Running Bacula from the Console Program</a></li>
   <ul>
      <li class="sub"><a href="console.html#list">Alphabetic List of Console Commands</a></li>
      <li class="sub"><a href="console.html#dotcommands">List of Dot commands</a></li>
      <li class="sub"><a href="console.html#atcommands">List of At (@) commands</a></li>
      <li class="sub"><a href="console.html#scripting">Running the Console from a Shell Script</a></li>
   </ul>

<li><a href="restore.html">Restoring Files</a></li>
   <ul>
      <li class="sub"><a href="restore.html">General</a></li>
      <li class="sub"><a href="restore.html#Example">Interactive Restore Example</a></li>
      <li class="sub"><a href="restore.html#CommandArguments">Command Line Arguments</a></li>
      <li class="sub"><a href="restore.html#Windows">Restoring on Windows</a></li>
      <li class="sub"><a href="restore.html#Selection">File Selection Command</a></li>
   </ul>

<li><a href="catmaintenance.html">Maintaining your Catalog</a></li>
   <ul>
      <li class="sub"><a href="catmaintenance.html#Retention">Setting Retention Periods</a></li>
      <li class="sub"><a href="catmaintenance.html#CompactingMySQL">Compacting Your MySQL Database</a></li>
      <li class="sub"><a href="catmaintenance.html#ReparingMySQL">Reparing Your MySQL Database</a></li>
      <li class="sub"><a href="catmaintenance.html#ReparingPSQL">Reparing Your PostgreSQL Database</a></li>
      <li class="sub"><a href="catmaintenance.html#CompactingSQLite">Compacting Your SQLite Database</a></li>
      <li class="sub"><a href="catmaintenance.html#BackingUpBacula">Backing Up Your Bacula Database</a></li>
      <li class="sub"><a href="catmaintenance.html#BackingUpOtherDBs">Backing Up Third Party Databases</a></li>
      <li class="sub"><a href="catmaintenance.html#Size">Database Size</a></li>
   </ul>

<li><a href="recycling.html">Recycling your Volumes</a></li>
   <ul>
      <li class="sub"><a href="recycling.html">Automatic Recycling Tapes</a></li>
      <li class="sub"><a href="recycling.html#AutoPruning">Automatic Pruning</a></li>
      <li class="sub"><a href="recycling.html#Recycling">Recycling Algorithm</a></li>
      <li class="sub"><a href="recycling.html#singletape">Making Bacula Use a Single Tape</a></li>
      <li class="sub"><a href="recycling.html#usageexample">A Daily, Weekly, Monthly Tape Usage Example</a></li>
      <li class="sub"><a href="recycling.html#PruningExample">Automatic Pruning and Recycling Example</a></li>
      <li class="sub"><a href="recycling.html#manualrecycling">Manually Recycling Tapes</a></li>
   </ul>

<li><a href="disk.html">Backing Up to Disk Volumes</a></li>
   <ul>
      <li class="sub"><a href="disk.html#Concepts">Key Concepts and Resource Records</a></li>
      <li class="sub"><a href="disk.html#AutomaticLabeling">Automatic Volume Labeling</a></li>
      <li class="sub"><a href="disk.html#Recycling">Restricting Volumes and Recycling</a></li>
      <li class="sub"><a href="disk.html#Example">An Example Conf File</a></li>
      <li class="sub"><a href="disk.html#MultipleDisks">Backing up to Multiple Disks</a></li>
      <li class="sub"><a href="disk.html#MultipleClients">Considerations for Multiple Clients</a></li>
   </ul>

<li><a href="pools.html">Using Pools to Manage Disk Volumes</a></li>

<li><a href="strategies.html">Backup Strategies</a></li>
   <ul>
      <li class="sub"><a href="strategies.html#Simple">Simple One Tape Backup</a></li>
      <li class="sub"><a href="strategies.html#Manual">Manually Changing Tapes</a></li>
      <li class="sub"><a href="strategies.html#Daily">Daily Tape Rotation</a></li>
   </ul>


<li><a href="autochangers.html">Autochanger Support in Bacula</a></li>
   <ul>
      <li class="sub"><a href="autochangers.html#Models">Supported Autochanger Models</a></li>
      <li class="sub"><a href="autochangers.html#AutochangerTesting">Testing the Autochanger and Adapting Your mtx-changer Script</a></li>
   </ul>

<li><a href="spooling.html">Data Spooling</a></li>

     
<li><a href="tips.html">Tips and Suggestions for Managing Bacula</a></li>
   <ul>
      <li class="sub"><a href="tips.html#examples">Sample Scripts</a></li>
      <li class="sub"><a href="tips.html#upgrading">Upgrading Bacula Versions</a></li>
      <li class="sub"><a href="tips.html#notification">Getting Notified of Job Completion</a></li>
      <li class="sub"><a href="tips.html#email">Getting Email Notification to Work</a></li>
      <li class="sub"><a href="tips.html#bootstrap">Maintaining a Valid Bootstrap File</a></li>
      <li class="sub"><a href="tips.html#RejectedVolumes">Rejected Volumes After a Crash</a></li>
      <li class="sub"><a href="tips.html#security">Security Considerations</a></li>
      <li class="sub"><a href="tips.html#holiday">Creating Holiday Schedules</a></li>
      <li class="sub"><a href="tips.html#autolabel">Automatic Labeling Using Your Autochanger</a></li>
      <li class="sub"><a href="tips.html#DNS">Backing Up Portables Using DHCP</a></li>
      <li class="sub"><a href="tips.html#Vacation">Going on Vacation</a></li>
      <li class="sub"><a href="tips.html#Case">How to Exclude Files on Windows Regardless of Case</a></li>
      <li class="sub"><a href="tips.html#RemoteExecution">Executing Scripts on a Remote Machine</a></li>
      <li class="sub"><a href="tips.html#recycle">Recycling All Your Volumes</a></li>
      <li class="sub"><a href="tips.html#ACLs">Backing up ACLs on ext3 or XFS filesystems</a></li>
      <li class="sub"><a href="tips.html#automate">Total Automation of Bacula Tape Handling</a></li>

   </ul>

<li><a href="progs.html">Bacula Utility Programs</a></li>
   <ul>
      <li class="sub"><a href="progs.html#bls">bls -- Listing the Contents of a Volume</a></li>
      <li class="sub"><a href="progs.html#bextract">bextract -- Extracting Files from a Volume</a></li>
      <li class="sub"><a href="progs.html#bscan">bscan -- Recreating a Database from a Volume</a></li>
      <li class="sub"><a href="progs.html#bcopy">bcopy -- Copy an Archive from one Volume to Another</a></li>
      <li class="sub"><a href="progs.html#btape">btape -- Testing Your Tape Drive</a></li>
      <li class="sub"><a href="progs.html#bsmtp">bsmtp -- Customizing Your Email Messages</a></li>
      <li class="sub"><a href="progs.html#dbcheck">dbcheck -- Run a Consistency Check on Your Database</a></li>
      <li class="sub"><a href="progs.html#testfind">testfind -- Test Run the Include Find Algorithm</a></li>
   </ul>

<li><a href="tapetesting.html">Testing Your Tape Drive With Bacula</a></li>
  <ul>
    <li class="sub"><a href="tapetesting.html#btape">btape</a></li>
    <li class="sub"><a href="tapetesting.html#problems">Tips for Resolving Problems</a></li>
    <li class="sub"><a href="tapetesting.html#opendevice">Bacula Cannot Open the Device</a></li>
    <li class="sub"><a href="tapetesting.html#IncorrectFiles">Incorrect File Number</a></li>
    <li class="sub"><a href="tapetesting.html#IncorrectBlocks">Incorrect Number of Blocks or Positioning Errors</a></li>
    <li class="sub"><a href="tapetesting.html#TapeModes">Ensuring that the Tape Modes Are Properly Set -- Linux Only</a></li>
    <li class="sub"><a href="tapetesting.html#compression">Checking and Setting Tape Hardware Compression and Block Sizes</a></li>
    <li class="sub"><a href="tapetesting.html#onstream">The OnStream Tape Driver</a></li>
    <li class="sub"><a href="tapetesting.html#FreeBSDTapes">Tape Modes on FreeBSD</a></li>
    <li class="sub"><a href="tapetesting.html#fill">Testing Filling a Tape</a></li>
    <li class="sub"><a href="tapetesting.html#RecoveringFiles">Recovering Files Written to Tape With Fixed Block Sizes</a></li>
    <li class="sub"><a href="tapetesting.html#BlockModes">Tape Blocking Modes</a></li>
  </ul>

<li><a href="kaboom.html">What To Do When Bacula Crashes (Kaboom)</a></li>

<li><a href="win32.html">The Windows Version of Bacula</a></li>
   <ul>
      <li class="sub"><a href="win32.html#installation">Installation</a></li>
      <li class="sub"><a href="win32.html#upgrading">Upgrading</a></li>
      <li class="sub"><a href="win32.html#problems">Problems</a></li>
      <li class="sub"><a href="win32.html#Compatibility">Compatibility Considerations</a></li>
   </ul>

<li><a href="rescue.html">Disaster Recovery Using Bacula</a></li>
  <ul>
    <li class="sub"><a href="rescue.html#considerations">Important Considerations</a></li>
    <li class="sub"><a href="rescue.html#emergency">Emergency Boot Disk</a></li>
    <li class="sub"><a href="rescue.html#rescuedisk">Creating a Bacula Rescue Disk</a></li>
    <li class="sub"><a href="rescue.html#static">Building a Static File daemon</a></li> 
    <li class="sub"><a href="rescue.html#restore">Restoring Your Linux System</a></li>
    <li class="sub"><a href="rescue.html#problems">Linux Problems and Bugs</a></li>
    <li class="sub"><a href="rescue.html#FreeBSD">FreeBSD Bare Metal Recovery</a></li>
    <li class="sub"><a href="rescue.html#solars">Solaris Bare Metal Recovery</a></li>
    <li class="sub"><a href="rescue.html#server">Recovering a Server</a></li>
    <li class="sub"><a href="rescue.html#genbugs">General Bugs and other Considerations</a></li>
    <li class="sub"><a href="rescue.html#Win32">Disaster Recover of Win32 Systems</a></li>
    <li class="sub"><a href="rescue.html#running">Restoring to a Running System</a></li>
  </ul>

<li><a href="stunnel.html">Using stunnel to Encrypt Communications to Clients</a></li>


<li><a href="verify.html">Using Bacula to Improve Computer Security</a></li>

<li><a href="rpm-faq.html">Bacula - RPM Packaging FAQ</a></li>

<li><a href="bootstrap.html">The Bootstrap File</a></li>

<li><a href="mysql.html">Installing and Configuring MySQL</a></li>
<li><a href="postgresql.html">Installing and Configuring PostgreSQL</a></li>
<li><a href="sqlite.html">Installing and Configuring SQLite</a></li>
<li><a href="internaldb.html">Installing and Configuring the Internal Database</a></li>
<li><a href="license.html">Bacula Copyright and Licenses</a></li>
   <ul>
      <li class="sub"><a href="gpl.html">GPL</a></li>
      <li class="sub"><a href="lesser.html">LGPL</a></li>
   </ul>
  
</ul>

<h2>Other Notes</h2>
<ul>
<li><a href="faq.html">Frequently Asked Questions</a>
   <ul>
      <li class="sub"><a href="faq.html#AuthorizationErrors">Authorization Errors</a></li>
      <li class="sub"><a href="faq.html#AccessProblems">Access Problems</a></li>
      <li class="sub"><a href="faq.html#CompressionNotWorking">Why aren't my Files Compressed?</a></li>
      <li class="sub"><a href="faq.html#NewTape">Why is Bacula Requesting a New Tape Too Often?</a></li>
      <li class="sub"><a href="faq.html#LevelChanging">Bacula Changes Backup Levels</a></li>
      <li class="sub"><a href="faq.html#WaitForever">Accessing Offsite Machines Waits Forever</a></li>
      <li class="sub"><a href="faq.html#sshHanging">SSH Hangs After Starting Bacula</a></li>
      <li class="sub"><a href="faq.html#RetentionPeriods">Why are there So Many Retention Periods?</a></li>
      <li class="sub"><a href="faq.html#MaxVolumeSize">Why is MaxVolumeSize Ignored?</a></li>
      <li class="sub"><a href="faq.html#ConnectionRefused">Why do I get Packet too big. Connection Refused?</a></li>
   </ul>


<li><a href="security.html">Security Issues</a>
<li><a href="firewalls.html">Firewall Issues</a>
<li><a href="projects.html">Bacula Projects</a>
<li><a href="thanks.html">Thanks and Acknowledgments</a>
</ul>
 
<h2>Bugs</h2>
<ul>
<li><a href="bugs.html">Bugs</a>
</ul>

<h2>Bacula Design Documents</h2>
<ul>
<li><a href="director.html">Director Services Design</a>
<li><a href="storage.html">Storage Services Design</a>
<li><a href="file.html">File Services Design</a>
<li><a href="catalog.html">Catalog Services Design</a>
<li><a href="internals.html">Internal Component Design Documents</a>
  <ul>
    <li class="sub"><a href="developers.html">Developer Notes</a>
    <li class="sub"><a href="porting.html">Porting Notes</a>
    <li class="sub"><a href="regression.html">Regression Testing</a>
    <li class="sub"><a href="gui-interface.html">Bacula GUI Interface</a>
    <li class="sub"><a href="daemonprotocol.html">Intra-daemon Protocols</a>
    <li class="sub"><a href="mediaformat.html">Storage Media Format</a>
    <li class="sub"><a href="mempool.html">Memory Management Design</a>
    <li class="sub"><a href="netprotocol.html">Bacula Network Protocol</a>
    <li class="sub"><a href="md5.html">Our MD5 Algorithm</a>
    <li class="sub"><a href="smartall.html">Smart Memory Allocation Routines</a>
  </ul>
</ul>

<hr>
<p>
Bacula<sup>&reg;</sup> is a registered trademark of Kern Sibbald and John Walker.
<p>
Copyright (C) 2000-2004 Kern Sibbald and John Walker.
<p>
Bacula source code is released under the GNU General Public License version 2.
<p>
The use of the name Bacula is restricted to software systems
that agree exactly with the program presented here.
