Contents

• What is Bacula?
  • Who Needs Bacula?
  • Bacula Components or Services
    • Bacula Director
    • Bacula Console
    • Bacula File
    • Bacula Storage
    • Catalog
    • Bacula Monitor
  • Bacula Configuration
  • Conventions Used in this Document
  • Quick Start
  • Terminology
  • What Bacula is Not
  • Interactions Between the Bacula Services
  
  
• New Features in 3.0.3
  • Maximum concurent jobs for Devices
  • Restore from Multiple Storage Daemons
  • File Deduplication using Base Jobs
  • Accurate Fileset options
  • Bvfs API
  • Testing your tape drive
  • New Block Checksum Device directive
  • New Bat Features
    • Media information view
    • Job information view
    • Autochanger content view
  
  
• New Features in 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 Queued Duplicates = <yesno>
    • Cancel Running 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
    • Backup 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>
    • MaxConsoleConnections = <number>
    • VerId = <string>
    • dbcheck enhancements
    • --docdir configure option
    • --htmldir configure option
    • --with-plugindir configure option
  
  
• Bacula FD Plugin API
  • Normal vs Command Plugins
  • Loading Plugins
  • loadPlugin
  • Plugin Entry Points
    • newPlugin(bpContext *ctx)
    • freePlugin(bpContext *ctx)
    • getPluginValue(bpContext *ctx, pVariable var, void *value)
    • setPluginValue(bpContext *ctx, pVariable var, void *value)
    • handlePluginEvent(bpContext *ctx, bEvent *event, void *value)
    • startBackupFile(bpContext *ctx, struct save_pkt *sp)
    • endBackupFile(bpContext *ctx)
    • startRestoreFile(bpContext *ctx, const char *cmd)
    • createFile(bpContext *ctx, struct restore_pkt *rp)
    • setFileAttributes(bpContext *ctx, struct restore_pkt *rp)
    • endRestoreFile(bpContext *ctx)
    • pluginIO(bpContext *ctx, struct io_pkt *io)
    • bool checkFile(bpContext *ctx, char *fname)
  • Bacula Plugin Entrypoints
    • bRC registerBaculaEvents(bpContext *ctx, ...)
    • bRC getBaculaValue(bpContext *ctx, bVariable var, void *value)
    • bRC setBaculaValue(bpContext *ctx, bVariable var, void *value)
    • bRC JobMessage(bpContext *ctx, const char *file, int line, int type, utime_t mtime, const char *fmt, ...)
    • bRC DebugMessage(bpContext *ctx, const char *file, int line, int level, const char *fmt, ...)
    • void baculaMalloc(bpContext *ctx, const char *file, int line, size_t size)
    • void baculaFree(bpContext *ctx, const char *file, int line, void *mem)
  • Building Bacula Plugins
  
  
• The Current State of Bacula
  • What is Implemented
  • Advantages Over Other Backup Programs
  • Current Implementation Restrictions
  • Design Limitations or Restrictions
  
  
• System Requirements
• Supported Operating Systems
  • Important notes
  
  
• Supported Tape Drives
  • Unsupported Tape Drives
  • FreeBSD Users Be Aware!!!
  • Supported Autochangers
  • Tape Specifications
  
  
• 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
  
  
• 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
    • Introduction
    • RegexWhere Format
    • Examples
  • 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
    • Pool Options to Limit the Volume Usage
    • Automatic Volume Labeling
    • Restricting the Number of Volumes and Recycling
  • Concurrent Disk Jobs
  • An Example
  • Backing up to Multiple Disks
  • Considerations for Multiple Clients
  
  
• Automated Disk Backup
  • The Problem
  • The Solution
  • Overall Design
    • Full Pool
    • Differential Pool
    • Incremental Pool
  • The Actual Conf Files
  
  
• Migration and Copy
  • Migration and Copy Job Resource Directives
  • Migration Pool Resource Directives
  • Important Migration Considerations
  • Example Migration Jobs
  
  
• Backup Strategies
  • Simple One Tape Backup
    • Advantages
    • Disadvantages
    • Practical Details
  • Manually Changing Tapes
  • Daily Tape Rotation
    • Advantages
    • Disadvantages
    • Practical Details
  
  
• 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
  
  
• Python Scripting
  • Python Configuration
  • Bacula Events
  • Python Objects
  • Python Console Command
  • Debugging Python Scripts
  • Python Example
  
  
• 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
  
  
• 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
  
  
• Bacula Projects
• Thanks
  • Copyrights and Trademarks
  • Bacula Bugs
  
  
• Variable Expansion
  • General Functionality
  • Bacula Variables
  • Full Syntax
  • Semantics
  • Examples
  
  
• Using Stunnel to Encrypt Communications
  • Communications Ports Used
  • Encryption
  • A Picture
  • Certificates
  • Securing the Data Channel
  • Data Channel Configuration
  • Stunnel Configuration for the Data Channel
  • Starting and Testing the Data Encryption
  • Encrypting the Control Channel
  • Control Channel Configuration
  • Stunnel Configuration for the Control Channel
  • Starting and Testing the Control Channel
  • Using stunnel to Encrypt to a Second Client
  • Creating a Self-signed Certificate
  • Getting a CA Signed Certificate
  • Using ssh to Secure the Communications
  
  
• DVD Volumes
  • DVD Specific SD Directives
  • Edit Codes for DVD Directives
  • DVD Specific Director Directives
  • Other Points
  
  
• General Index
• Director Index
• File Daemon Index
• Storage Daemon Index
• Console Index
• About this document ...