bacula main reference manual · mainreferencemanualcontents 4 newfeaturesin9.4.021 4.0.1...

Bacula® Main Reference ManualKern Sibbald

May 29, 2021

This manual documents Bacula Community Edition 11.0.4 (29 May 2021)

Copyright © 1999-2021, Kern Sibbald

Bacula® is a registered trademark of Kern Sibbald.

This Bacula documentation by Kern Sibbald with contributions from many others, a complete listcan be found in the License chapter. Creative Commons Attribution-ShareAlike 4.0 International

License http://creativecommons.org/licenses/by-sa/4.0/

http://creativecommons.org/licenses/by-sa/4.0/

Main Reference Manual

2/646All trademarks are the property of their respective owners

Bacula Community Edition v.11.0.4 (29 May 2021)

CONTENTS Main Reference Manual

Contents

1 What is Bacula Community Edition? 1

1.1 Who Needs Bacula? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

1.2 Bacula Components or Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

1.3 Bacula Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1.4 Conventions Used in this Document . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1.5 Quick Start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

1.6 Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

1.7 What Bacula is Not . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

1.8 Interactions Between the Bacula Services . . . . . . . . . . . . . . . . . . . . . . . 8

2 New Features in 11.0.0 11

2.1 Catalog Performance Improvements . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

2.2 Automatic TLS Encryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

2.3 Client Behind NAT Support with the Connect To Director Directive . . . . . . . 11

2.4 Continuous Data Protection Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

2.5 Event and Auditing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

2.6 New Prune Command Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

2.7 Volume Retention Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

2.8 Windows Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

2.9 GPFS ACL Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

2.10 New Baculum Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

2.10.1 Multi-user interface improvements . . . . . . . . . . . . . . . . . . . . . . . 16

2.10.2 Add searching jobs by filename in the restore wizard . . . . . . . . . . . . . 16

2.10.3 Show more detailed job file list . . . . . . . . . . . . . . . . . . . . . . . . . 16

2.10.4 Add graphs to job view page . . . . . . . . . . . . . . . . . . . . . . . . . . 16

2.10.5 Implement graphical status storage . . . . . . . . . . . . . . . . . . . . . . . 17

Bacula Community Edition v.11.0.4 (29 May 2021)All trademarks are the property of their respective owners

i/646

Main Reference Manual CONTENTS

2.10.6 Add Russian translations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

2.10.7 Global messages log window . . . . . . . . . . . . . . . . . . . . . . . . . . 17

2.10.8 Job status weather . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

2.10.9 Restore wizard improvements . . . . . . . . . . . . . . . . . . . . . . . . . . 17

2.10.10New API endpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

2.10.11New parameters in API endpoints . . . . . . . . . . . . . . . . . . . . . . . 17


3.0.1 Building 9.6.4 and later . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

3.0.2 Docker Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

3.0.3 Real-Time Statistics Monitoring . . . . . . . . . . . . . . . . . . . . . . . . 20


4.0.1 New Commands, Resource, and Directives for Cloud . . . . . . . . . . . . . 25

4.0.2 WORM Tape Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30


5.0.1 Enhanced Autochanger Support . . . . . . . . . . . . . . . . . . . . . . . . 31

5.0.2 New Prune Command Option . . . . . . . . . . . . . . . . . . . . . . . . . . 32

5.0.3 BConsole Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

5.0.4 Tray Monitor Restore Screen . . . . . . . . . . . . . . . . . . . . . . . . . . 33


6.0.1 Enhanced Autochanger Support . . . . . . . . . . . . . . . . . . . . . . . . 35

6.0.2 Source Code for Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

6.0.3 Maximum Virtual Full Interval Option . . . . . . . . . . . . . . . . . . . . . 36

6.0.4 Progressive Virtual Full . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

6.0.5 TapeAlert Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

6.0.6 New Console ACL Directives . . . . . . . . . . . . . . . . . . . . . . . . . . 40

6.0.7 New Bconsole “list” Command Behavior . . . . . . . . . . . . . . . . . . . 41


6.0.9 Client Initiated Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

6.0.10 Configuring Client Initiated Backup . . . . . . . . . . . . . . . . . . . . . . 43

6.0.11 New Tray Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

6.0.12 Schedule Jobs via the Tray Monitor . . . . . . . . . . . . . . . . . . . . . . 45

ii/646All trademarks are the property of their respective owners



6.0.13 Accurate Option for Verify “Volume Data” Job . . . . . . . . . . . . . . . . 48

6.0.14 FileDaemon Saved Messages Resource Destination . . . . . . . . . . . . . . 48

6.0.15 Minor Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

6.0.16 Bconsole “list jobs” command options . . . . . . . . . . . . . . . . . . . . . 49



6.0.19 New Bconsole "Tee All" Command . . . . . . . . . . . . . . . . . . . . . . . 50

6.0.20 New Job Edit Codes %I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

6.0.21 Communication Line Compression . . . . . . . . . . . . . . . . . . . . . . . 51

6.0.22 Deduplication Optimized Volumes . . . . . . . . . . . . . . . . . . . . . . . 52

6.0.23 baculabackupreport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

6.0.24 New Message Identification Format . . . . . . . . . . . . . . . . . . . . . . 52


7.1 New Features in 7.4.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

7.1.1 RunScripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

7.2 New Features in 7.4.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

7.2.1 Verify Volume Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55



7.2.4 Windows Encrypted File System (EFS) Support . . . . . . . . . . . . . . . 57

7.2.5 SSL Connections to MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

7.2.6 Max Virtual Full Interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

7.2.7 New List Volumes Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58


8.1 New Features in 7.2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

8.1.1 New Job Edit Codes %E %R . . . . . . . . . . . . . . . . . . . . . . . . . . 59

8.1.2 Enable/Disable commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

8.2 Bacula 7.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

8.2.1 Snapshot Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60


8.2.3 Data Encryption Cipher Configuration . . . . . . . . . . . . . . . . . . . . . 64

8.2.4 Read Only Storage Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . 66


iii/646


8.2.5 New Resume Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

8.2.6 New Prune “Expired” Volume Command . . . . . . . . . . . . . . . . . . . 66

8.2.7 New Job Edit Codes %P %C . . . . . . . . . . . . . . . . . . . . . . . . . . 66

8.2.8 Enhanced Status and Error Messages . . . . . . . . . . . . . . . . . . . . . 66

8.2.9 Miscellaneous New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

8.2.10 FD Storage Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

8.2.11 Maximum Concurrent Read Jobs . . . . . . . . . . . . . . . . . . . . . . . . 67

8.2.12 Incomplete Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

8.2.13 The Stop Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

8.2.14 The Restart Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

8.2.15 Job Bandwidth Limitation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

8.2.16 Always Backup a File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

8.2.17 Setting Accurate Mode at Runtime . . . . . . . . . . . . . . . . . . . . . . 70

8.2.18 Additions to RunScript variables . . . . . . . . . . . . . . . . . . . . . . . . 71

8.2.19 LZO Compression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

8.2.20 Purge Migration Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

8.2.21 Changes in the Pruning Algorithm . . . . . . . . . . . . . . . . . . . . . . . 72

8.2.22 Ability to Verify any specified Job . . . . . . . . . . . . . . . . . . . . . . . 72


9.1 New Features in 7.0.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

9.1.1 Storage daemon to Storage daemon . . . . . . . . . . . . . . . . . . . . . . 73

9.1.2 SD Calls Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

9.1.3 Next Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

9.1.4 status storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

9.1.5 status schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

9.1.6 Data Encryption Cipher Configuration . . . . . . . . . . . . . . . . . . . . . 75

9.1.7 New Truncate Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

9.1.8 Migration/Copy/VirtualFull Performance Enhancements . . . . . . . . . . 76

9.1.9 VirtualFull Backup Consolidation Enhancements . . . . . . . . . . . . . . . 76

9.1.10 FD Storage Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76


9.1.12 Maximum Concurrent Read Jobs . . . . . . . . . . . . . . . . . . . . . . . . 78

iv/646All trademarks are the property of their respective owners



9.1.13 Director job Codes in Message Resource Commands . . . . . . . . . . . . . 79


9.1.15 Read Only Storage Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

9.1.16 New Prune “Expired” Volume Command . . . . . . . . . . . . . . . . . . . 79

9.1.17 Hardlink Performance Enhancements . . . . . . . . . . . . . . . . . . . . . . 80

9.1.18 DisableCommand Directive . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

9.1.19 Multiple Console Directors . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

9.1.20 Restricted Consoles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

9.1.21 Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

9.1.22 Maximum Spawned Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

9.1.23 Progress Meter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

9.1.24 Scheduling a 6th Week . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

9.1.25 Scheduling the Last Day of a Month . . . . . . . . . . . . . . . . . . . . . . 81

9.1.26 Improvements to Cancel and Restart bconsole Commands . . . . . . . . . 81

9.1.27 bconsole Performance Improvements . . . . . . . . . . . . . . . . . . . . . . 81

9.1.28 New .bvfs_decode_lstat Command . . . . . . . . . . . . . . . . . . . . . . 82



10.1 New Features in 5.2.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

10.1.1 LZO Compression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

10.1.2 New Tray Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

10.1.3 Purge Migration Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

10.1.4 Changes in Bvfs (Bacula Virtual FileSystem) . . . . . . . . . . . . . . . . . 88

10.1.5 Changes in the Pruning Algorithm . . . . . . . . . . . . . . . . . . . . . . . 91

10.1.6 Ability to Verify any specified Job . . . . . . . . . . . . . . . . . . . . . . . 92


10.1.8 Additions to the Plugin API . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

10.1.9 ACL enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

10.1.10XATTR enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

10.1.11Class Based Database Backend Drivers . . . . . . . . . . . . . . . . . . . . 96

10.1.12Hash List Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

10.2 Release Version 5.0.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97


v/646


10.3 Release Version 5.0.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

10.4 New Features in 5.0.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

10.4.1 Truncate Volume after Purge . . . . . . . . . . . . . . . . . . . . . . . . . . 98

10.4.2 Allow Higher Duplicates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

10.4.3 Cancel Lower Level Duplicates . . . . . . . . . . . . . . . . . . . . . . . . . 99

10.5 New Features in 5.0.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

10.5.1 Maximum Concurrent Jobs for Devices . . . . . . . . . . . . . . . . . . . . 99

10.5.2 Restore from Multiple Storage Daemons . . . . . . . . . . . . . . . . . . . . 99

10.5.3 File Deduplication using Base Jobs . . . . . . . . . . . . . . . . . . . . . . . 99

10.5.4 AllowCompression = . . . . . . . . . . . . . . . . . . . . . . . . . 100

10.5.5 Accurate Fileset Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

10.5.6 Tab-completion for Bconsole . . . . . . . . . . . . . . . . . . . . . . . . . . 101

10.5.7 Pool File and Job Retention . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

10.5.8 Read-only File Daemon using capabilities . . . . . . . . . . . . . . . . . . . 101

10.5.9 Bvfs API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

10.5.10Testing your Tape Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

10.5.11New Block Checksum Device Directive . . . . . . . . . . . . . . . . . . . 103

10.5.12New Bat Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

10.5.13Bat on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

10.5.14New Win32 Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

10.5.15Win64 Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

10.5.16Linux Bare Metal Recovery USB Key . . . . . . . . . . . . . . . . . . . . . 106

10.5.17bconsole Timeout Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

10.5.18 Important Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

10.5.19Misc Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

11 Released Version 3.0.3 and 3.0.3a 109

11.1 New Features in Released Version 3.0.2 . . . . . . . . . . . . . . . . . . . . . . . . 109

11.1.1 Full Restore from a Given JobId . . . . . . . . . . . . . . . . . . . . . . . . 109

11.1.2 Source Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

11.1.3 Show volume availability when doing restore . . . . . . . . . . . . . . . . . 110

11.1.4 Accurate estimate command . . . . . . . . . . . . . . . . . . . . . . . . . . 111

11.2 New Features in 3.0.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

vi/646All trademarks are the property of their respective owners



11.2.1 Accurate Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

11.2.2 Copy Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

11.2.3 ACL Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

11.2.4 Extended Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

11.2.5 Shared objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

11.2.6 Building Static versions of Bacula . . . . . . . . . . . . . . . . . . . . . . . 116

11.2.7 Virtual Backup (Vbackup) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

11.2.8 Catalog Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

11.2.9 64 bit Windows Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

11.2.10Duplicate Job Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

11.2.11TLS Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

11.2.12bextract non-portable Win32 data . . . . . . . . . . . . . . . . . . . . . . . 120

11.2.13State File updated at Job Termination . . . . . . . . . . . . . . . . . . . . . 120

11.2.14MaxFullInterval = . . . . . . . . . . . . . . . . . . . . . . . 121

11.2.15MaxDiffInterval = . . . . . . . . . . . . . . . . . . . . . . . 121

11.2.16Honor No Dump Flag = . . . . . . . . . . . . . . . . . . . . . . . 121

11.2.17Exclude Dir Containing = . . . . . . . . . . . . . . . . . 121

11.2.18Bacula Plugins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

11.2.19The bpipe Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

11.2.20Microsoft Exchange Server 2003/2007 Plugin . . . . . . . . . . . . . . . . . 124

11.2.21 libdbi Framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

11.2.22Console Command Additions and Enhancements . . . . . . . . . . . . . . . 128

11.2.23Bare Metal Recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

11.2.24Miscellaneous . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

12 The Current State of Bacula 137

12.1 What is Implemented . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

12.2 Advantages Over Other Backup Programs . . . . . . . . . . . . . . . . . . . . . . . 139

12.3 Current Implementation Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . 140

12.4 Design Limitations or Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

12.5 Items to Note . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

13 System Requirements 141


vii/646


14 Supported Operating Systems 143

15 Supported Tape Drives 145

15.1 Unsupported Tape Drives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146

15.2 FreeBSD Users Be Aware!!! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

15.3 Supported Autochangers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

15.4 Tape Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

16 Getting Started with Bacula 149

16.1 Understanding Jobs and Schedules . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

16.2 Understanding Pools, Volumes and Labels . . . . . . . . . . . . . . . . . . . . . . . 149

16.3 Setting Up Bacula Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . 150

16.3.1 Configuring the Console Program . . . . . . . . . . . . . . . . . . . . . . . 150

16.3.2 Configuring the File daemon . . . . . . . . . . . . . . . . . . . . . . . . . . 151

16.3.3 Configuring the Director . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

16.3.4 Configuring the Storage daemon . . . . . . . . . . . . . . . . . . . . . . . . 151

16.3.5 Configuring the Monitor Program . . . . . . . . . . . . . . . . . . . . . . . 152

16.4 Testing your Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

16.5 Testing Compatibility with Your Tape Drive . . . . . . . . . . . . . . . . . . . . . . 153

16.6 Get Rid of the /lib/tls Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

16.7 Running Bacula . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

16.8 Log Rotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

16.9 Log Watch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

16.10Disaster Recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

17 Installing Bacula 155

17.1 Binary Release Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

17.2 Building Bacula from Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

17.3 Source Release Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

17.4 Upgrading Bacula . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

17.5 Releases Numbering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

17.6 Dependency Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

17.7 Supported Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

17.8 Building Bacula from Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

viii/646All trademarks are the property of their respective owners



17.9 What Database to Use? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

17.10Quick Start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

17.11Configure Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

17.12Recommended Options for Most Systems . . . . . . . . . . . . . . . . . . . . . . . 169

17.13Red Hat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

17.14Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170

17.15FreeBSD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

17.16Win32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

17.17One File Configure Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

17.18Installing Bacula . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

17.19Building a File Daemon or Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

17.20Auto Starting the Daemons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

17.21Other Make Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

17.22Modifying the Bacula Configuration Files . . . . . . . . . . . . . . . . . . . . . . . 174

18 Critical Items to Implement Before Production 175

18.1 Critical Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

18.2 Recommended Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

19 A Brief Tutorial 179

19.1 Before Running Bacula . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179

19.2 Starting the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

19.3 Starting the Daemons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

19.4 Using the Director to Query and Start Jobs . . . . . . . . . . . . . . . . . . . . . . 180

19.5 Running a Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

19.6 Restoring Your Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

19.7 Quitting the Console Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

19.8 Adding a Second Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

19.9 When The Tape Fills . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

19.10Other Useful Console Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

19.11Debug Daemon Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

19.12Patience When Starting Daemons or Mounting Blank Tapes . . . . . . . . . . . . 192

19.13Difficulties Connecting from the FD to the SD . . . . . . . . . . . . . . . . . . . . 193

19.14Daemon Command Line Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193


ix/646


19.15Creating a Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

19.16Labeling Your Volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

19.17Labeling Volumes with the Console Program . . . . . . . . . . . . . . . . . . . . . 194

20 Customizing the Configuration Files 197

20.1 Character Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

20.2 Resource Directive Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

20.2.1 Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

20.2.2 Upper and Lower Case and Spaces . . . . . . . . . . . . . . . . . . . . . . . 199

20.2.3 Including other Configuration Files . . . . . . . . . . . . . . . . . . . . . . . 199

20.2.4 Recognized Primitive Data Types . . . . . . . . . . . . . . . . . . . . . . . . 200

20.3 Resource Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

20.4 Names, Passwords and Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . 202

20.5 Detailed Information for each Daemon . . . . . . . . . . . . . . . . . . . . . . . . . 202

21 Configuring the Director 205

21.1 Director Resource Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

21.2 The Director Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

21.3 The Job Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

21.4 The JobDefs Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

21.5 The Schedule Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

21.6 Technical Notes on Schedules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234

21.7 The FileSet Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234

21.8 FileSet Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

21.9 Backing up Raw Partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

21.10Excluding Files and Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

21.11Windows FileSets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

21.12Testing Your FileSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255

21.12.1 Include All Windows Drives in FileSet . . . . . . . . . . . . . . . . . . . . . 255

21.12.2Microsoft VSS Writer Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . 256

21.12.3Support for NDMP Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . 259

21.12.4 Incremental Accelerator Plugin for NetApp . . . . . . . . . . . . . . . . . . 259

21.12.5PostgreSQL Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

21.12.6VMWare vSphere VADP Plugin . . . . . . . . . . . . . . . . . . . . . . . . 260

x/646All trademarks are the property of their respective owners



21.12.7Oracle RMAN Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

21.13The Client Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

21.14The Storage Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

21.15The Autochanger Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271

21.16The Pool Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

21.16.1The Scratch Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

21.17The Catalog Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

21.18The Messages Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280

21.19The Console Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280

21.20The Counter Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286

21.21The Statistics Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287

21.22Example Director Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . 288

22 Client/File daemon Configuration 291

22.1 The Client Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291


22.3 The Schedule Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300

22.4 The Message Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301

22.5 The Statistics Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301

22.6 Example Client Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302

23 Storage Daemon Configuration 305

23.1 Storage Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305

23.2 Director Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310

23.3 Device Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312

23.4 Cloud Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321

23.5 Edit Codes for Mount and Unmount Directives . . . . . . . . . . . . . . . . . . . . 323

23.6 Devices that require a mount (USB) . . . . . . . . . . . . . . . . . . . . . . . . . . 323

24 Autochanger Resource 325

24.1 Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326

24.2 Messages Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326

24.3 The Statistics Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327

24.4 Sample Storage Daemon Configuration File . . . . . . . . . . . . . . . . . . . . . . 328


xi/646


25 Messages Resource 331

26 Console Configuration 337

26.1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337


26.3 The ConsoleFont Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

26.4 The Console Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341

26.5 Console Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

26.6 Sample Console Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

27 Monitor Configuration 347

27.1 The Monitor Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347


27.3 The Client Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348

27.4 The Storage Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348

27.5 Tray Monitor Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349

27.6 Sample Tray Monitor configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . 349

27.6.1 Sample File daemon’s Director record. . . . . . . . . . . . . . . . . . . . . . 350

27.6.2 Sample Storage daemon’s Director record. . . . . . . . . . . . . . . . . . . 350

27.6.3 Sample Director’s Console record. . . . . . . . . . . . . . . . . . . . . . . . 350

28 The Restore Command 351

28.1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351

28.2 The Restore Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351

28.2.1 Restore a pruned job using a pattern . . . . . . . . . . . . . . . . . . . . . . 356

28.3 Selecting Files by Filename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356

28.4 Replace Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358

28.5 Command Line Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358

28.6 Using File Relocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359

28.6.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359

28.6.2 RegexWhere Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

28.7 Restoring Directory Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361

28.8 Restoring on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362

28.9 Restoring Files Can Be Slow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362

xii/646All trademarks are the property of their respective owners



28.10Problems Restoring Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362

28.11Restore Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363

28.12Example Restore Job Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363

28.13File Selection Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364

28.14Restoring When Things Go Wrong . . . . . . . . . . . . . . . . . . . . . . . . . . . 365

29 Automatic Volume Recycling 371

29.1 Automatic Pruning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372

29.2 Pruning Directives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373

29.3 Recycling Algorithm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374

29.4 Recycle Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376

29.5 Making Bacula Use a Single Tape . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377

29.6 Daily, Weekly, Monthly Tape Usage Example . . . . . . . . . . . . . . . . . . . . . 377

29.7 Automatic Pruning and Recycling Example . . . . . . . . . . . . . . . . . . . . . . 379

29.8 Manually Recycling Volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380

30 Basic Volume Management 383

30.1 Key Concepts and Resource Records . . . . . . . . . . . . . . . . . . . . . . . . . . 383

30.1.1 Pool Options to Limit the Volume Usage . . . . . . . . . . . . . . . . . . . 384

30.1.2 Automatic Volume Labeling . . . . . . . . . . . . . . . . . . . . . . . . . . . 385

30.1.3 Restricting the Number of Volumes and Recycling . . . . . . . . . . . . . . 386

30.2 Concurrent Disk Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386

30.3 An Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387

30.4 Backing up to Multiple Disks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389

30.5 Considerations for Multiple Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . 391

31 Automated Disk Backup 395

31.1 The Problem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395

31.2 The Solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395

31.3 Overall Design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396

31.3.1 Full Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396

31.3.2 Differential Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397

31.3.3 Incremental Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397

31.4 The Actual Conf Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398


xiii/646


32 Migration and Copy 401

32.1 Migration and Copy Job Resource Directives . . . . . . . . . . . . . . . . . . . . . 402

32.2 Migration Pool Resource Directives . . . . . . . . . . . . . . . . . . . . . . . . . . . 404

32.3 Important Migration Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . 405

32.4 Example Migration Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406

32.5 Virtual Backup Consolidation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407

32.5.1 Manually Specify Jobs to Consolidate . . . . . . . . . . . . . . . . . . . . . 409

33 File Deduplication using Base Jobs 411

34 Backup Strategies 413

34.1 Simple One Tape Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413

34.1.1 Advantages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413

34.1.2 Disadvantages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413

34.1.3 Practical Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413

34.2 Manually Changing Tapes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414

34.3 Daily Tape Rotation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414

34.3.1 Advantages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414

34.3.2 Disadvantages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415

34.3.3 Practical Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415

35 Autochanger Support 419

35.1 Knowing What SCSI Devices You Have . . . . . . . . . . . . . . . . . . . . . . . . 420

35.2 Example Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421

35.3 Slots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421

35.4 Multiple Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422

35.5 Device Configuration Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422

36 Autochanger Resource 425

36.1 An Example Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426

36.2 A Multi-drive Example Configuration File . . . . . . . . . . . . . . . . . . . . . . . 426

36.3 Specifying Slots When Labeling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427

36.4 Changing Cartridges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428

36.5 Dealing with Multiple Magazines . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428

36.6 Simulating Barcodes in your Autochanger . . . . . . . . . . . . . . . . . . . . . . . 429

xiv/646All trademarks are the property of their respective owners



36.7 The Full Form of the Update Slots Command . . . . . . . . . . . . . . . . . . . . . 429

36.8 FreeBSD Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430

36.9 Testing Autochanger and Adapting mtx-changer script . . . . . . . . . . . . . . . . 430

36.10Using the Autochanger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432

36.11Barcode Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433

36.12Use bconsole to display Autochanger content . . . . . . . . . . . . . . . . . . . . . 433

36.13Bacula Autochanger Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434

37 Supported Autochangers 435

38 Data Spooling 439

38.1 Data Spooling Directives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439

38.2 FileSet consideration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440

38.3 Other Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440

39 Using Bacula catalog to grab information 443

39.1 Job statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443

40 ANSI and IBM Tape Labels 445

40.1 Director Pool Directive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445

40.2 Storage Daemon Device Directives . . . . . . . . . . . . . . . . . . . . . . . . . . . 445

41 The Windows Version of Bacula 447

41.1 Windows Supported Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447

41.2 Windows Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447

41.3 Tray Icon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450

41.4 Post Windows Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452

41.5 Uninstalling Bacula on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452

41.6 Dealing with Windows Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452

41.7 Windows Compatibility Considerations . . . . . . . . . . . . . . . . . . . . . . . . . 454

41.8 Volume Shadow Copy Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456

41.9 VSS Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457

41.10Windows Firewalls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458

41.11Windows Port Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458

41.12Windows Disaster Recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458


xv/646


41.13Windows FD Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458

41.14Windows Restore Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459

41.15Windows Ownership and Permissions Problems . . . . . . . . . . . . . . . . . . . . 459

41.16Manually resetting the Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . 459

41.17Backing Up the WinNT/XP/2K System State . . . . . . . . . . . . . . . . . . . . 463

41.18Fixing the Windows Boot Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463

41.19Considerations for Filename Specifications . . . . . . . . . . . . . . . . . . . . . . . 464

41.20Windows Specific File daemon Command Line . . . . . . . . . . . . . . . . . . . . 464

41.21Shutting down Windows Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464

42 Disaster Recovery Using Bacula 467

42.1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467

42.2 Important Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467

42.3 FreeBSD Bare Metal Recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467

42.4 Solaris Bare Metal Recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469

42.5 Preparing Solaris Before a Disaster . . . . . . . . . . . . . . . . . . . . . . . . . . . 469

43 Bacula TLS – Communications Encryption 471

43.1 TLS Configuration Directives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

43.2 Creating a Self-Signed Certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474

43.3 Getting a CA Signed Certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475

43.4 Example TLS Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475

43.4.1 Enable TLS Communications Encryption Between Console and Director . 477

43.4.2 Enable TLS Communications Encryption Between Console and Director . 478

43.4.3 Enable TLS Communications Encryption between Director and File Daemon480

43.4.4 Enable TLS Communications Encryption Between Director and StorageDaemon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481

43.4.5 Enable TLS Communications Encryption Between File Daemon and Stor-age Daemon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482

43.4.6 Using Certificates Issued by Different Root CAs . . . . . . . . . . . . . . . 483

43.4.7 Using TLS Authenticate to Enable a TLS Authentication Between Dae-mons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484

44 Data Encryption 489

44.1 Building Bacula with Encryption Support . . . . . . . . . . . . . . . . . . . . . . . 490

44.2 Encryption Technical Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490

xvi/646All trademarks are the property of their respective owners



44.3 Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490

44.4 Generating Private/Public Encryption Keys . . . . . . . . . . . . . . . . . . . . . . 491

44.5 Example Data Encryption Configuration . . . . . . . . . . . . . . . . . . . . . . . . 491

44.6 Decrypting with a Master Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492

45 Using Bacula to Improve Computer Security 493

45.1 The Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493

45.2 Running the Verify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494

45.3 What To Do When Differences Are Found . . . . . . . . . . . . . . . . . . . . . . . 496

45.4 A Verify Configuration Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497

46 Using Bacula Continous Data Protection 499

46.1 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500

46.1.1 FileDaemon Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500

46.1.2 Plugin Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500

46.1.3 Director Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500

46.1.4 CDP Client Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500

46.1.5 Tray Monitor Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . 501

46.1.6 The Spool Directory and Scheduled Backups . . . . . . . . . . . . . . . . . 503

46.1.7 Important . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503

46.1.8 Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504

47 User Interfaces 505

47.1 The Tray Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506

47.1.1 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506

47.1.2 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506

47.1.3 Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510

47.1.4 Running Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511

47.1.5 Local Scheduling – the Command Directory . . . . . . . . . . . . . . . . . 512

47.1.6 Proxied Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513

47.1.7 Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518

47.1.8 Running Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518

47.1.9 Proxied Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518

47.1.10Supported Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518


xvii/646


47.1.11Command Line Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518

48 Installing and Configuring MySQL 521

48.1 Installing and Configuring MySQL – Phase I . . . . . . . . . . . . . . . . . . . . . . 521

48.2 Installing and Configuring MySQL – Phase II . . . . . . . . . . . . . . . . . . . . . . 522

48.3 Re-initializing the Catalog Database . . . . . . . . . . . . . . . . . . . . . . . . . . 523

48.4 Linking Bacula with MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524

48.5 Installing MySQL from RPMs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524

48.6 Upgrading MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524

48.7 MySQL Configuration Caution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525

49 Installing and Configuring PostgreSQL 527

49.1 Installing PostgreSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527

49.2 Configuring PostgreSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528

49.3 Re-initializing the Catalog Database . . . . . . . . . . . . . . . . . . . . . . . . . . 530

49.4 Installing PostgreSQL from RPMs . . . . . . . . . . . . . . . . . . . . . . . . . . . 531

49.5 Converting from MySQL to PostgreSQL . . . . . . . . . . . . . . . . . . . . . . . . 531

49.6 Upgrading PostgreSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531

49.7 Tuning PostgreSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532

49.8 Credits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532

50 Catalog Maintenance 533

50.1 Setting Retention Periods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533

50.2 Compacting Your MySQL Database . . . . . . . . . . . . . . . . . . . . . . . . . . . 534

50.3 Repairing Your MySQL Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535

50.4 MySQL Table is Full . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535

50.5 MySQL Server Has Gone Away . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536

50.6 MySQL Temporary Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536

50.7 Repairing Your PostgreSQL Database . . . . . . . . . . . . . . . . . . . . . . . . . 536

50.8 Database Performance Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536

50.9 Performance Issues Indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537

50.9.1 PostgreSQL Indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537

50.9.2 MySQL Indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537

50.10Compacting Your PostgreSQL Database . . . . . . . . . . . . . . . . . . . . . . . . 538

xviii/646All trademarks are the property of their respective owners



50.11Migrating from SQLite to MySQL or PostgreSQL . . . . . . . . . . . . . . . . . . 539

50.12Backing Up Your Bacula Database . . . . . . . . . . . . . . . . . . . . . . . . . . . 539

50.13Security considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540

50.14Backing Up Third Party Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . 540

50.15Database Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540

51 Bacula Security Issues 543

51.1 Backward Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544

51.2 Configuring and Testing TCP Wrappers . . . . . . . . . . . . . . . . . . . . . . . . 544

51.3 Running as non-root . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546

52 New Features in Older Bacula Enterprise Versions 549

52.1 Bacula Enterprise 8.8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549

52.1.1 New Commands, Resource, and Directives for Cloud . . . . . . . . . . . . . 551

52.1.2 Progressive Virtual Full . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556

52.1.3 Backups To Keep Directive . . . . . . . . . . . . . . . . . . . . . . . . . . . 556

52.1.4 Delete Consolidated Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557

52.1.5 Virtual Full Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557

52.1.6 TapeAlert Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558

52.1.7 What is New . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558

52.1.8 Handling of Alerts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560

52.1.9 Multi-Tenancy Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . 560

52.1.10New BWeb Management Suite Self User Restore . . . . . . . . . . . . . . . 560

52.1.11New Console ACL Directives . . . . . . . . . . . . . . . . . . . . . . . . . . 560

52.1.12Restore Job Security Enhancement . . . . . . . . . . . . . . . . . . . . . . . 562

52.1.13New Bconsole “list” Command Behavior . . . . . . . . . . . . . . . . . . . 562

52.2 Bacula Enterprise 8.6.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562



52.3.1 Client Initiated Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563

52.3.2 Configuring Client Initiated Backup . . . . . . . . . . . . . . . . . . . . . . 564

52.3.3 New Tray Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565

52.3.4 Scheduling Jobs via the Tray Monitor . . . . . . . . . . . . . . . . . . . . . 566

52.3.5 Concurrent VSS Snapshot Support . . . . . . . . . . . . . . . . . . . . . . . 568


xix/646


52.3.6 Accurate Option for Verify “Volume Data” Job . . . . . . . . . . . . . . . . 568

52.3.7 Single Item Restore Optimisation . . . . . . . . . . . . . . . . . . . . . . . . 569

52.3.8 FileDaemon Saved Messages Resource Destination . . . . . . . . . . . . . . 569

52.3.9 BWeb New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569

52.3.10Minor Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569

52.4 Bacula Enterprise 8.4.10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572

52.4.1 Plugin for Microsoft SQL Server . . . . . . . . . . . . . . . . . . . . . . . . 572


52.5.1 Verify Volume Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573

52.5.2 Bconsole list jobs Command Options . . . . . . . . . . . . . . . . . . . 574



52.6.1 VMWare Single File Restore . . . . . . . . . . . . . . . . . . . . . . . . . . 575

52.6.2 Microsoft Exchange Single MailBox Restore . . . . . . . . . . . . . . . . . . 575


52.7.1 New Job Edit Codes %I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576


52.8.1 New Job Edit Codes %E %R . . . . . . . . . . . . . . . . . . . . . . . . . . 576

52.8.2 Enable/Disable commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 576


52.9.1 Snapshot Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576

52.9.2 Global Endpoint Deduplication(TM) . . . . . . . . . . . . . . . . . . . . . . 581

52.9.3 Hypervisor Plugins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581

52.9.4 Windows Encrypted File System (EFS) Support . . . . . . . . . . . . . . . 581

52.9.5 BWeb Management Suite . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581


52.10Bacula Enterprise 8.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584

52.10.1Global Endpoint Deduplication™ . . . . . . . . . . . . . . . . . . . . . . . . 584

52.10.2Storage Daemon to Storage Daemon . . . . . . . . . . . . . . . . . . . . . 586

52.10.3Windows Mountpoint Support . . . . . . . . . . . . . . . . . . . . . . . . . 586

52.10.4SD Calls Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587

52.10.5Data Encryption Cipher Configuration . . . . . . . . . . . . . . . . . . . . . 588

52.10.6Minor Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588

xx/646All trademarks are the property of their respective owners



52.11Bacula Enterprise 6.6.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590

52.11.1Communication Line Compression . . . . . . . . . . . . . . . . . . . . . . . 590

52.11.2Read Only Storage Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . 591

52.11.3Catalog Performance Improvements . . . . . . . . . . . . . . . . . . . . . . 591

52.11.4Plugin Restore Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591

52.11.5Alldrives Plugin Improvements . . . . . . . . . . . . . . . . . . . . . . . . . 592

52.11.6New Truncate Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593

52.12Bacula Enterprise 6.4.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593

52.12.1SAP Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593

52.12.2Oracle SBT Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593

52.12.3MySQL Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593


52.13.1Deduplication Optimized Volumes . . . . . . . . . . . . . . . . . . . . . . . 594

52.13.2Migration/Copy/VirtualFull Performance Enhancements . . . . . . . . . . 594

52.13.3VirtualFull Backup Consolidation Enhancements . . . . . . . . . . . . . . . 594

52.13.4New Prune “Expired” Volume Command . . . . . . . . . . . . . . . . . . . 595


52.14.1New Job Edit Codes %P %C . . . . . . . . . . . . . . . . . . . . . . . . . . 595


52.15.1BWeb Bacula Configuration GUI . . . . . . . . . . . . . . . . . . . . . . . . 595

52.15.2Performance Improvements . . . . . . . . . . . . . . . . . . . . . . . . . . . 596

52.15.3Enhanced Status and Error Messages . . . . . . . . . . . . . . . . . . . . . 596

52.15.4WinBMR 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596

52.15.5Miscellaneous New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . 597


52.16.1 Incremental Accelerator Plugin for NetApp . . . . . . . . . . . . . . . . . . 597

52.16.2PostgreSQL Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597

52.16.3Maximum Reload Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . 598

52.16.4FD Storage Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598

52.16.5Maximum Concurrent Read Jobs . . . . . . . . . . . . . . . . . . . . . . . . 599


52.17.1VMWare vSphere VADP Plugin . . . . . . . . . . . . . . . . . . . . . . . . 599

52.17.2Oracle RMAN Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599


xxi/646




52.19.1 Incomplete Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601

52.19.2The stop Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601

52.19.3The restart Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601

52.19.4Support for Exchange Incremental Backups . . . . . . . . . . . . . . . . . . 602

52.19.5Support for MSSQL Block Level Backups . . . . . . . . . . . . . . . . . . . . 602


52.19.7 Incremental/Differential Block Level Difference Backup . . . . . . . . . . . 603

52.19.8SAN Shared Tape Storage Plugin . . . . . . . . . . . . . . . . . . . . . . . 604

52.19.9Advanced Autochanger Usage . . . . . . . . . . . . . . . . . . . . . . . . . . 604

52.19.10Enhancement of the NDMP Plugin . . . . . . . . . . . . . . . . . . . . . . 605

52.19.11Always Backup a File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605

52.19.12Setting Accurate Mode at Runtime . . . . . . . . . . . . . . . . . . . . . . 606

52.19.13Additions to RunScript variables . . . . . . . . . . . . . . . . . . . . . . . . 606

52.19.14LZO Compression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606

52.19.15New Tray Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607

52.19.16Purge Migration Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609

52.19.17Changes in the Pruning Algorithm . . . . . . . . . . . . . . . . . . . . . . . 609

52.19.18Ability to Verify any specified Job . . . . . . . . . . . . . . . . . . . . . . . 609

53 The Bootstrap File 611

53.1 Bootstrap File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611

53.2 Automatic Generation of Bootstrap Files . . . . . . . . . . . . . . . . . . . . . . . . 614

53.3 Bootstrap for bscan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615

53.4 A Final Bootstrap Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615

Appendices 617

A Job status 619

A.1 Job levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619

A.2 Job types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619

A.3 Job status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620

B Bacula Copyright, Trademark, and Licenses 621

xxii/646All trademarks are the property of their respective owners



B.1 Bacula Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621

B.2 Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621

B.3 LGPL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621

B.4 Public Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622

B.5 Fiduciary License Agreement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622

B.6 Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622

C Thanks 623

C.1 Bacula Bugs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625

D Acronyms 627

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631


xxiii/646


xxiv/646All trademarks are the property of their respective owners


LIST OF FIGURES Main Reference Manual

List of Figures

1.1 Bacula Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

1.2 Bacula Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1.3 Interactions between Bacula Services . . . . . . . . . . . . . . . . . . . . . . . . . . 9

2.1 Client Behind NAT Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

2.2 CDP Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

3.1 Graphite Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

4.1 Bacula Cloud Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

5.1 Tray Monitor Restore Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

6.1 Backup Sequence Slides Forward One Day, Each Day . . . . . . . . . . . . . . . . 37

6.2 Client Initiated Backup Network Flow . . . . . . . . . . . . . . . . . . . . . . . . . 42

6.3 Relation Between Resources (bconsole) . . . . . . . . . . . . . . . . . . . . . . . . . 44

6.4 Relation Between Resources (tray-monitor) . . . . . . . . . . . . . . . . . . . . . . 44

6.5 Tray Monitor Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

6.6 Tray Monitor Client Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

6.7 Tray Monitor Run a Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

10.1 New tray monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

10.2 Run a Job through the new tray monitor . . . . . . . . . . . . . . . . . . . . . . . . 87

10.3 Bat Brestore Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

10.4 Media information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

10.5 Job information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

10.6 Autochanger content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Job time control directives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133


xxv/646

Main Reference Manual LIST OF FIGURES

16.1 Bacula Tray Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

20.1 Bacula Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

20.2 Configuration diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

21.1 Job time control directives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219

21.2 Allow Duplicate Jobs usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228

21.3 Backup over WAN using FD Storage Address . . . . . . . . . . . . . . . . . . . . . 266

41.1 Windows Client Setup Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448

41.2 Windows Installation Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449

41.3 Win32 Component Selection Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . 449

41.4 Win32 Configure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450

41.5 Windows Install Progress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451

41.6 Windows Client Setup Completed . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451

41.7 Menu on right click . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452

41.8 Popup on permission issue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460

41.9 Message to ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460

41.10Properties security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461

41.11Properties security advanced owner . . . . . . . . . . . . . . . . . . . . . . . . . . . 462

41.12Confirm granting permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462

46.1 CDP Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499

46.2 Open CDP Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501

46.3 CDP Client Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501

46.4 Watching a Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502

46.5 Result . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502

46.6 Result . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503

46.7 Job Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504

47.1 Tray Monitor Configuration as seen in Listing . . . . . . . . . . . . . . . . . . . . . 510

47.2 Tray Monitor Client Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511

47.3 Selecting a Director to run a Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511

47.4 Configuration overview: resources and their relationships . . . . . . . . . . . . . . 515

47.5 Remote, Proxied bconsole Session with Job Run . . . . . . . . . . . . . . . . . . . 518

xxvi/646All trademarks are the property of their respective owners


LIST OF FIGURES Main Reference Manual

52.1 Bacula Cloud Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550

52.2 Backup Sequence Slides Forward One Day, Each Day . . . . . . . . . . . . . . . . 557

52.3 Client Initiated Backup Network Flow . . . . . . . . . . . . . . . . . . . . . . . . . 563

52.4 Relation Between Resources (bconsole) . . . . . . . . . . . . . . . . . . . . . . . . . 565

52.5 Relation Between Resources (tray-monitor) . . . . . . . . . . . . . . . . . . . . . . 565

52.6 Tray Monitor Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566

52.7 Tray Client Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567

52.8 Tray Monitor Run a Job (1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567

52.9 Tray Monitor Run a Job (2) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 568

52.10BWeb Global Endpoint Deduplication Overview . . . . . . . . . . . . . . . . . . . . 570

52.11Copy Job Creation Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570

52.12Migrate Job Creation Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571

52.13Run Job Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571

52.14BWeb SSH Remote Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572

52.15BWeb VMWare Single File Restore . . . . . . . . . . . . . . . . . . . . . . . . . . . 575

52.16BWeb Storage Daemon Status/Overview . . . . . . . . . . . . . . . . . . . . . . . . 582

52.17BWeb TLS Security Center . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582

52.18BWeb FileSet Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583

52.19BWeb Job/Media Table Configuration . . . . . . . . . . . . . . . . . . . . . . . . . 583

52.20SD to SD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586

52.21SD Calls Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587

52.22Choose datastore, ESXi or hostname at restore time . . . . . . . . . . . . . . . . . 592

52.23Configuration with BWeb Management Suite . . . . . . . . . . . . . . . . . . . . . 596

52.24Backup Over WAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598

52.25New tray monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607

52.26Run a Job through the new tray monitor . . . . . . . . . . . . . . . . . . . . . . . . 608


xxvii/646

Main Reference Manual LIST OF FIGURES

xxviii/646All trademarks are the property of their respective owners


LIST OF TABLES Main Reference Manual

List of Tables

14.1 Bacula supported operating systems . . . . . . . . . . . . . . . . . . . . . . . . . . 143

15.1 Supported Tape Drives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

15.2 DLT & LTO specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

Dependency Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

20.1 Resource types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

21.1 Options for Run Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221

21.2 RunScript shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

28.1 Regular expressions examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361

37.1 Autochangers known to work with Bacula . . . . . . . . . . . . . . . . . . . . . . . 436

41.1 WinNT/2K/XP Restore Portability Status . . . . . . . . . . . . . . . . . . . . . . . 455

52.1 Debug tag option table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590

A.1 Job levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619

A.2 Job types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619

A.3 Job Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620


xxix/646

Main Reference Manual LIST OF TABLES

xxx/646All trademarks are the property of their respective owners


Who Needs Bacula? Main Reference Manual

Chapter 1

What is Bacula CommunityEdition?

Bacula is a set of computer programs that permits the system administrator to manage backup,recovery, and verification of computer data across a network of computers of different kinds.Bacula can also run entirely upon a single computer and can backup to various types of media,including tape and disk.

In technical terms, it is a network Client/Server based backup program. Bacula is relatively easyto use and efficient, while offering many advanced storage management features that make iteasy to find and recover lost or damaged files. Due to its modular design, Bacula is scalablefrom small single computer systems to systems consisting of hundreds of computers located overa large network.

1.1 Who Needs Bacula?

If you are currently using a program such as tar, dump, or bru to backup your computer data,and you would like a network solution, more flexibility, or catalog services, Bacula will most likelyprovide the additional features you want. However, if you are new to Unix systems or do nothave offsetting experience with a sophisticated backup package, the Bacula project does notrecommend using Bacula as it is much more difficult to setup and use than tar or dump.

If you want Bacula to behave like the above mentioned simple programs and write over any tapethat you put in the drive, then you will find working with Bacula difficult. Bacula is designed toprotect your data following the rules you specify, and this means reusing a tape only as the lastresort. It is possible to “force” Bacula to write over any tape in the drive, but it is easier andmore efficient to use a simpler program for that kind of operation.

If you would like a backup program that can write to multiple volumes (i.e. is not limited byyour tape drive capacity), Bacula can most likely fill your needs. In addition, quite a number ofBacula users report that Bacula is simpler to setup and use than other equivalent programs.

If you are currently using a sophisticated commercial package such as Legato Networker. ARC-serveIT, Arkeia, or PerfectBackup+, you may be interested in Bacula, which provides many ofthe same features and is free software available under the Affero GPL Version 3 software license.


1/646

Main Reference Manual Bacula Components or Services

1.2 Bacula Components or Services

Bacula is made up of the following five major components or services: Director, Console, File,Storage, and Monitor services.

Figure 1.1: Bacula Applications

(thanks to Aristedes Maniatis for this graphic and the one below)

Bacula Director

The Bacula Director service is the program that supervises all the backup, restore, verify andarchive operations. The system administrator uses the Bacula Director to schedule backups andto recover files. For more details see the Director Services Daemon Design (chapter 6 page59) in the Bacula Community Edition Developer’s manual. The Director runs as a daemon (orservice) in the background.

2/646All trademarks are the property of their respective owners


Bacula Components or Services Main Reference Manual

Bacula Console

The Bacula Console service is the program that allows the administrator or user to communicatewith the Bacula Director Currently, the Bacula Console is available in three versions: text-based console interface, QT-based interface, and a wxWidgets graphical interface. The first andsimplest is to run the Console program in a shell window (i.e. TTY interface). Most systemadministrators will find this completely adequate. The second version is a GNOME GUI interfacethat is far from complete, but quite functional as it has most the capabilities of the shell Console.The third version is a wxWidgets GUI with an interactive file restore. It also has most of thecapabilities of the shell console, allows command completion with tabulation, and gives youinstant help about the command you are typing. For more details see the Bacula ConsoleDesign Document (Chapter 1 page 1).

Bacula File

The Bacula File service (also known as the Client program) is the software program that isinstalled on the machine to be backed up. It is specific to the operating system on which it runsand is responsible for providing the file attributes and data when requested by the Director. TheFile services are also responsible for the file system dependent part of restoring the file attributesand data during a recovery operation. For more details see the File Services Daemon Design(chapter 7 page 61) in the Bacula Community Edition Developer’s manual. This program runsas a daemon on the machine to be backed up. In addition to Unix/Linux File daemons, thereis a Windows File daemon (normally distributed in binary format). The Windows File daemonruns on current Windows versions (NT, 2000, XP, 2003, and possibly Me and 98).

Bacula Storage

The Bacula Storage services consist of the software programs that perform the storage andrecovery of the file attributes and data to the physical backup media or volumes. In other words,the Storage daemon is responsible for reading and writing your tapes (or other storage media,e.g. files). For more details see the Storage Services Daemon (chapter 8 page 63) in theBacula Community Edition Developer’s manual. The Storage services runs as a daemon on themachine that has the backup device (usually a tape drive).

Catalog

The Catalog services are comprised of the software programs responsible for maintaining the fileindexes and volume databases for all files backed up. The Catalog services permit the systemadministrator or user to quickly locate and restore any desired file. The Catalog services setsBacula apart from simple backup programs like tar and bru, because the catalog maintains arecord of all Volumes used, all Jobs run, and all Files saved, permitting efficient restoration andVolume management. Bacula currently supports three different databases, MySQL, PostgreSQL,one of which must be chosen when building Bacula.

The three SQL databases currently supported (MySQL, PostgreSQL) quite a number of features,including rapid indexing, arbitrary queries, and security. Although the Bacula project plans tosupport other major SQL databases, the current Bacula implementation interfaces only to MySQL,PostgreSQL. For the technical and porting details see the Catalog Services Design (chapter9 page 67) in the Bacula Community Edition Developer’s manual.

The packages for MySQL and PostgreSQL are available for several operating systems. Alterna-tively, installing from the source is quite easy, see the . . . . . . . . .Installing. . . . .and . . . . . . . . . . . .Configuring. . . . . . .MySQL chapterof this document for the details. For more information on MySQL, please see: . . . . . . . . . . . . . . . .www.mysql.com.Or see the . . . . . . . . .Installing. . . .and. . . . . . . . . . . . .Configuring . . . . . . . . . . . . .PostgreSQL chapter of this document for the details. Formore information on PostgreSQL, please see: . . . . . . . . . . . . . . . . . . .www.postgresql.org.


3/646

http://www.mysql.comhttp://www.postgresql.org

Main Reference Manual Conventions Used in this Document

Bacula Monitor

A Bacula Monitor service is the program that allows the administrator or user to watch currentstatus of Bacula Directors, Bacula File Daemons and Bacula Storage Daemons. Currently, onlya GTK+ version is avail

bacula main reference manual · mainreferencemanualcontents 4 newfeaturesin9.4.021 4.0.1...

Documents