Next: Contents Contents Index

$\includegraphics{bacula-logo.eps}$

Bacula $^{\normalsize\textregistered }$ Bacula Main Reference
The Leading Open Source Backup Solution.

Kern Sibbald

June 8, 2011
This manual documents Bacula version 4.0.7 (06 Jun 2011)

Copyright © 1999-2010, Free Software Foundation Europe e.V.
Bacula $\textregistered$ is a registered trademark of Kern Sibbald.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".

Contents
What is Bacula?
- Who Needs Bacula?
- Bacula Components or Services
- Bacula Configuration
- Conventions Used in this Document
- Quick Start
- Terminology
- What Bacula is Not
- Interactions Between the Bacula Services
Release Version 5.0.2 and 5.0.3
New Features in 5.0.1
- Truncate Volume after Purge
- Allow Higher Duplicates
- Cancel Lower Level Duplicates
New Features in 5.0.0
- Maximum Concurrent Jobs for Devices
- Restore from Multiple Storage Daemons
- File Deduplication using Base Jobs
- AllowCompression = yesno
- Accurate Fileset Options
- Tab-completion for Bconsole
- Pool File and Job retention
- Read-only File Daemon using capabilities
- Bvfs API
- Testing your Tape Drive
- New Block Checksum Device Directive
- New Bat Features
- Bat on Windows
- New Win32 Installer
- Win64 Installer
- Linux Bare Metal Recovery USB Key
- bconsole Timeout Option
- Important Changes
- Misc Changes
Released Version 3.0.3 and 3.0.3a
New Features in Released Version 3.0.2
- Full Restore from a Given JobId
- Source Address
- Show volume availability when doing restore
- Accurate estimate command
New Features in 3.0.0
- Accurate Backup
  - Accurate = yesno
- Copy Jobs
- ACL Updates
- Extended Attributes
- Shared objects
- Building Static versions of Bacula
- Virtual Backup (Vbackup)
- Catalog Format
- 64 bit Windows Client
- Duplicate Job Control
  - Allow Duplicate Jobs = yesno
  - Allow Higher Duplicates = yesno
  - Cancel Running Duplicates = yesno
  - Cancel Queued Duplicates = yesno
- TLS Authentication
  - TLS Authenticate = yes
- bextract non-portable Win32 data
- State File updated at Job Termination
- MaxFullInterval = time-interval
- MaxDiffInterval = time-interval
- Honor No Dump Flag = yesno
- Exclude Dir Containing = filename-string
- Bacula Plugins
  - Plugin Directory
  - Plugin Options
  - Plugin Options ACL
  - Plugin = plugin-command-string
- The bpipe Plugin
- Microsoft Exchange Server 2003/2007 Plugin
  - Background
  - Concepts
  - Installing
  - Backing Up
  - Restoring
  - Restoring to the Recovery Storage Group
  - Restoring on Microsoft Server 2007
  - Caveats
- libdbi Framework
- Console Command Additions and Enhancements
  - Display Autochanger Content
  - list joblog job=xxx or jobid=nnn
  - Use separator for multiple commands
  - Deleting Volumes
- Bare Metal Recovery
- Miscellaneous
  - Allow Mixed Priority = yesno
  - Bootstrap File Directive - FileRegex
  - Bootstrap File Optimization Changes
  - Solaris ZFS/NFSv4 ACLs
  - Virtual Tape Emulation
  - Bat Enhancements
  - RunScript Enhancements
  - Status Enhancements
  - Connect Timeout
  - ftruncate for NFS Volumes
  - Support for Ubuntu
  - Recycle Pool = pool-name
  - FD Version
  - Max Run Sched Time = time-period-in-seconds
  - Max Wait Time = time-period-in-seconds
  - Incremental|Differential Max Wait Time = time-period-in-seconds
  - Max Run Time directives
  - Statistics Enhancements
  - ScratchPool = pool-resource-name
  - Enhanced Attribute Despooling
  - SpoolSize = size-specification-in-bytes
  - MaximumConsoleConnections = number
  - VerId = string
  - dbcheck enhancements
  - -docdir configure option
  - -htmldir configure option
  - -with-plugindir configure option
The Current State of Bacula
- What is Implemented
- Advantages Over Other Backup Programs
- Current Implementation Restrictions
- Design Limitations or Restrictions
- Items to Note
System Requirements
Supported Operating Systems
- Important notes
Supported Tape Drives
- Unsupported Tape Drives
- FreeBSD Users Be Aware!!!
- Supported Autochangers
- Tape Specifications
Getting Started with Bacula
- Understanding Jobs and Schedules
- Understanding Pools, Volumes and Labels
- Setting Up Bacula Configuration Files
- Testing your Configuration Files
- Testing Compatibility with Your Tape Drive
- Get Rid of the /lib/tls Directory
- Running Bacula
- Log Rotation
- Log Watch
- Disaster Recovery
Installing Bacula
- Source Release Files
- Upgrading Bacula
- Releases Numbering
- Beta Releases
- Dependency Packages
- Supported Operating Systems
- Building Bacula from Source
- What Database to Use?
- Quick Start
- Configure Options
- Recommended Options for Most Systems
- Red Hat
- Solaris
- FreeBSD
- Win32
- One File Configure Script
- Installing Bacula
- Building a File Daemon or Client
- Auto Starting the Daemons
- Other Make Notes
- Installing Tray Monitor
  - GNOME
  - KDE
  - Other window managers
- Modifying the Bacula Configuration Files
Critical Items to Implement Before Production
- Critical Items
- Recommended Items
A Brief Tutorial
- Before Running Bacula
- Starting the Database
- Starting the Daemons
- Using the Director to Query and Start Jobs
- Running a Job
- Restoring Your Files
- Quitting the Console Program
- Adding a Second Client
- When The Tape Fills
- Other Useful Console Commands
- Debug Daemon Output
- Patience When Starting Daemons or Mounting Blank Tapes
- Difficulties Connecting from the FD to the SD
- Daemon Command Line Options
- Creating a Pool
- Labeling Your Volumes
- Labeling Volumes with the Console Program
Customizing the Configuration Files
- Character Sets
- Resource Directive Format
- Resource Types
- Names, Passwords and Authorization
- Detailed Information for each Daemon
Configuring the Director
- Director Resource Types
- The Director Resource
- The Job Resource
- The JobDefs Resource
- The Schedule Resource
- Technical Notes on Schedules
- The FileSet Resource
- FileSet Examples
- Backing up Raw Partitions
- Excluding Files and Directories
- Windows FileSets
- Testing Your FileSet
- The Client Resource
- The Storage Resource
- The Pool Resource
  - The Scratch Pool
- The Catalog Resource
- The Messages Resource
- The Console Resource
- The Counter Resource
- Example Director Configuration File
Client/File daemon Configuration
- The Client Resource
- The Director Resource
- The Message Resource
- Example Client Configuration File
Storage Daemon Configuration
- Storage Resource
- Director Resource
- Device Resource
- Edit Codes for Mount and Unmount Directives
- Devices that require a mount (DVD)
Autochanger Resource
- Capabilities
- Messages Resource
- Sample Storage Daemon Configuration File
Messages Resource
Console Configuration
- General
- The Director Resource
- The ConsoleFont Resource
- The Console Resource
- Console Commands
- Sample Console Configuration File
Monitor Configuration
- The Monitor Resource
- The Director Resource
- The Client Resource
- The Storage Resource
- Tray Monitor Security
- Sample Tray Monitor configuration
The Restore Command
- General
- The Restore Command
  - Restore a pruned job using a pattern
- Selecting Files by Filename
- Replace Options
- Command Line Arguments
- Using File Relocation
- Restoring Directory Attributes
- Restoring on Windows
- Restoring Files Can Be Slow
- Problems Restoring Files
- Restore Errors
- Example Restore Job Resource
- File Selection Commands
- Restoring When Things Go Wrong
Automatic Volume Recycling
- Automatic Pruning
- Pruning Directives
- Recycling Algorithm
- Recycle Status
- Making Bacula Use a Single Tape
- Daily, Weekly, Monthly Tape Usage Example
- Automatic Pruning and Recycling Example
- Manually Recycling Volumes
Basic Volume Management
- Key Concepts and Resource Records
- Concurrent Disk Jobs
- An Example
- Backing up to Multiple Disks
- Considerations for Multiple Clients
Automated Disk Backup
- The Problem
- The Solution
- Overall Design
- The Actual Conf Files
Migration and Copy
- Migration and Copy Job Resource Directives
- Migration Pool Resource Directives
- Important Migration Considerations
- Example Migration Jobs
File Deduplication using Base Jobs
Backup Strategies
- Simple One Tape Backup
- Manually Changing Tapes
- Daily Tape Rotation
Autochanger Support
- Knowing What SCSI Devices You Have
- Example Scripts
- Slots
- Multiple Devices
- Device Configuration Records
Autochanger Resource
- An Example Configuration File
- A Multi-drive Example Configuration File
- Specifying Slots When Labeling
- Changing Cartridges
- Dealing with Multiple Magazines
- Simulating Barcodes in your Autochanger
- The Full Form of the Update Slots Command
- FreeBSD Issues
- Testing Autochanger and Adapting mtx-changer script
- Using the Autochanger
- Barcode Support
- Use bconsole to display Autochanger content
- Bacula Autochanger Interface
Supported Autochangers
Data Spooling
- Data Spooling Directives
- !!! MAJOR WARNING !!!
- Other Points
Using Bacula catalog to grab information
- Job statistics
ANSI and IBM Tape Labels
- Director Pool Directive
- Storage Daemon Device Directives
The Windows Version of Bacula
- Win32 Installation
- Post Win32 Installation
- Uninstalling Bacula on Win32
- Dealing with Win32 Problems
- Windows Compatibility Considerations
- Volume Shadow Copy Service
- VSS Problems
- Windows Firewalls
- Windows Port Usage
- Windows Disaster Recovery
- Windows Restore Problems
- Windows Ownership and Permissions Problems
- Manually resetting the Permissions
- Backing Up the WinNT/XP/2K System State
- Considerations for Filename Specifications
- Win32 Specific File daemon Command Line
- Shutting down Windows Systems
Disaster Recovery Using Bacula
- General
- Important Considerations
- Steps to Take Before Disaster Strikes
- Bare Metal Recovery on Linux with a Rescue CD
- Requirements
- Restoring a Client System
- Boot with your Rescue CDROM
- Restoring a Server
- Linux Problems or Bugs
- Bare Metal Recovery using a LiveCD
- FreeBSD Bare Metal Recovery
- Solaris Bare Metal Recovery
- Preparing Solaris Before a Disaster
- Bugs and Other Considerations
- Disaster Recovery of Win32 Systems
- Ownership and Permissions on Win32 Systems
- Alternate Disaster Recovery Suggestion for Win32 Systems
- Restoring to a Running System
- Additional Resources
Bacula TLS - Communications Encryption
- TLS Configuration Directives
- Creating a Self-signed Certificate
- Getting a CA Signed Certificate
- Example TLS Configuration Files
Data Encryption
- Building Bacula with Encryption Support
- Encryption Technical Details
- Decrypting with a Master Key
- Generating Private/Public Encryption Keys
- Example Data Encryption Configuration
Using Bacula to Improve Computer Security
- The Details
- Running the Verify
- What To Do When Differences Are Found
- A Verify Configuration Example
Installing and Configuring MySQL
- Installing and Configuring MySQL - Phase I
- Installing and Configuring MySQL - Phase II
- Re-initializing the Catalog Database
- Linking Bacula with MySQL
- Installing MySQL from RPMs
- Upgrading MySQL
Installing and Configuring PostgreSQL
- Installing PostgreSQL
- Configuring PostgreSQL
- Re-initializing the Catalog Database
- Installing PostgreSQL from RPMs
- Converting from MySQL to PostgreSQL
- Upgrading PostgreSQL
- Tuning PostgreSQL
- Credits
Installing and Configuring SQLite
- Installing and Configuring SQLite - Phase I
- Installing and Configuring SQLite - Phase II
- Linking Bacula with SQLite
- Testing SQLite
- Re-initializing the Catalog Database
Catalog Maintenance
- Setting Retention Periods
- Compacting Your MySQL Database
- Repairing Your MySQL Database
- MySQL Table is Full
- MySQL Server Has Gone Away
- MySQL Temporary Tables
- Repairing Your PostgreSQL Database
- Database Performance Issues
- Performance Issues Indexes
- Compacting Your PostgreSQL Database
- Compacting Your SQLite Database
- Migrating from SQLite to MySQL or PostgreSQL
- Backing Up Your Bacula Database
- Security considerations
- Backing Up Third Party Databases
- Database Size
Bacula Security Issues
- Backward Compatibility
- Configuring and Testing TCP Wrappers
- Running as non-root
The Bootstrap File
- Bootstrap File Format
- Automatic Generation of Bootstrap Files
- Bootstrap for bscan
- A Final Bootstrap Example
Bacula Copyright, Trademark, and Licenses
- FDL
- GPL
- LGPL
- Public Domain
- Trademark
- Fiduciary License Agreement
- Disclaimer
GNU Free Documentation License
- GNU General Public License
- Table of Contents
- GNU GENERAL PUBLIC LICENSE
- Preamble
- TERMS AND CONDITIONS
- How to Apply These Terms to Your New Programs
- GNU Lesser General Public License
- Table of Contents
- GNU LESSER GENERAL PUBLIC LICENSE
- Preamble
- TERMS AND CONDITIONS
- How to Apply These Terms to Your New Libraries
Thanks
- Copyrights and Trademarks
- Bacula Bugs
General Index
Director Index
File Daemon Index
Storage Daemon Index
Console Index
About this document ...

Eric 2011-06-08

Bacula Bacula Main Reference The Leading Open Source Backup Solution.

$\includegraphics{bacula-logo.eps}$

Bacula $^{\normalsize\textregistered }$ Bacula Main Reference
The Leading Open Source Backup Solution.