Bacula Main Reference Manual · MainReferenceManualCONTENTS 4 NewFeaturesin9.4.021 4.0.1...
Transcript of 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 New Features in 9.6.0 19
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 New Features in 9.4.0 23
4.0.1 New Commands, Resource, and Directives for Cloud . . . . . . . . . . . . . 25
4.0.2 WORM Tape Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
5 New Features in 9.2.0 31
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 New Features in 9.0.0 35
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.8 New Console ACL Directives . . . . . . . . . . . . . . . . . . . . . . . . . . 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
Bacula Community Edition v.11.0.4 (29 May 2021)
-
CONTENTS Main Reference Manual
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.17 Minor Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
6.0.18 Bconsole “list jobs” command options . . . . . . . . . . . . . . . . . . . . . 50
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 New Features in 7.4.0 55
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.2 Bconsole “list jobs” command options . . . . . . . . . . . . . . . . . . . . . 57
7.2.3 Minor Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
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 New Features in 7.2.0 59
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.2 Minor Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
8.2.3 Data Encryption Cipher Configuration . . . . . . . . . . . . . . . . . . . . . 64
8.2.4 Read Only Storage Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Bacula Community Edition v.11.0.4 (29 May 2021)All trademarks are the property of their respective owners
iii/646
-
Main Reference Manual CONTENTS
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 New Features in 7.0.0 73
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.11 Job Bandwidth Limitation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
9.1.12 Maximum Concurrent Read Jobs . . . . . . . . . . . . . . . . . . . . . . . . 78
iv/646All trademarks are the property of their respective owners
Bacula Community Edition v.11.0.4 (29 May 2021)
-
CONTENTS Main Reference Manual
9.1.13 Director job Codes in Message Resource Commands . . . . . . . . . . . . . 79
9.1.14 Additions to RunScript variables . . . . . . . . . . . . . . . . . . . . . . . . 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 New Features in 5.2.13 85
10.0.1 Additions to RunScript variables . . . . . . . . . . . . . . . . . . . . . . . . 85
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.7 Additions to RunScript variables . . . . . . . . . . . . . . . . . . . . . . . . 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
Bacula Community Edition v.11.0.4 (29 May 2021)All trademarks are the property of their respective owners
v/646
-
Main Reference Manual CONTENTS
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
Bacula Community Edition v.11.0.4 (29 May 2021)
-
CONTENTS Main Reference Manual
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
Bacula Community Edition v.11.0.4 (29 May 2021)All trademarks are the property of their respective owners
vii/646
-
Main Reference Manual CONTENTS
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
Bacula Community Edition v.11.0.4 (29 May 2021)
-
CONTENTS Main Reference Manual
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
Bacula Community Edition v.11.0.4 (29 May 2021)All trademarks are the property of their respective owners
ix/646
-
Main Reference Manual CONTENTS
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
Bacula Community Edition v.11.0.4 (29 May 2021)
-
CONTENTS Main Reference Manual
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.2 The Director Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
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
Bacula Community Edition v.11.0.4 (29 May 2021)All trademarks are the property of their respective owners
xi/646
-
Main Reference Manual CONTENTS
25 Messages Resource 331
26 Console Configuration 337
26.1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
26.2 The Director Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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.2 The Director 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
Bacula Community Edition v.11.0.4 (29 May 2021)
-
CONTENTS Main Reference Manual
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
Bacula Community Edition v.11.0.4 (29 May 2021)All trademarks are the property of their respective owners
xiii/646
-
Main Reference Manual CONTENTS
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
Bacula Community Edition v.11.0.4 (29 May 2021)
-
CONTENTS Main Reference Manual
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
Bacula Community Edition v.11.0.4 (29 May 2021)All trademarks are the property of their respective owners
xv/646
-
Main Reference Manual CONTENTS
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
Bacula Community Edition v.11.0.4 (29 May 2021)
-
CONTENTS Main Reference Manual
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
Bacula Community Edition v.11.0.4 (29 May 2021)All trademarks are the property of their respective owners
xvii/646
-
Main Reference Manual CONTENTS
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
Bacula Community Edition v.11.0.4 (29 May 2021)
-
CONTENTS Main Reference Manual
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.2.1 New Console ACL Directives . . . . . . . . . . . . . . . . . . . . . . . . . . 562
52.3 Bacula Enterprise 8.6.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563
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
Bacula Community Edition v.11.0.4 (29 May 2021)All trademarks are the property of their respective owners
xix/646
-
Main Reference Manual CONTENTS
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 Bacula Enterprise 8.4.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573
52.5.1 Verify Volume Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573
52.5.2 Bconsole list jobs Command Options . . . . . . . . . . . . . . . . . . . 574
52.5.3 Minor Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574
52.6 Bacula Enterprise 8.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575
52.6.1 VMWare Single File Restore . . . . . . . . . . . . . . . . . . . . . . . . . . 575
52.6.2 Microsoft Exchange Single MailBox Restore . . . . . . . . . . . . . . . . . . 575
52.7 Bacula Enterprise 8.2.8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576
52.7.1 New Job Edit Codes %I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576
52.8 Bacula Enterprise 8.2.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576
52.8.1 New Job Edit Codes %E %R . . . . . . . . . . . . . . . . . . . . . . . . . . 576
52.8.2 Enable/Disable commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 576
52.9 Bacula Enterprise 8.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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.9.6 Minor Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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
Bacula Community Edition v.11.0.4 (29 May 2021)
-
CONTENTS Main Reference Manual
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.13Bacula Enterprise 6.4.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594
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.14Bacula Enterprise 6.2.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595
52.14.1New Job Edit Codes %P %C . . . . . . . . . . . . . . . . . . . . . . . . . . 595
52.15Bacula Enterprise 6.2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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.16Bacula Enterprise 6.0.6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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.17Bacula Enterprise 6.0.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
52.17.1VMWare vSphere VADP Plugin . . . . . . . . . . . . . . . . . . . . . . . . 599
52.17.2Oracle RMAN Plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
Bacula Community Edition v.11.0.4 (29 May 2021)All trademarks are the property of their respective owners
xxi/646
-
Main Reference Manual CONTENTS
52.18Bacula Enterprise 6.0.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600
52.19Bacula Enterprise 6.0.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601
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.6 Job Bandwidth Limitation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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
Bacula Community Edition v.11.0.4 (29 May 2021)
-
CONTENTS Main Reference Manual
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
Bacula Community Edition v.11.0.4 (29 May 2021)All trademarks are the property of their respective owners
xxiii/646
-
Main Reference Manual CONTENTS
xxiv/646All trademarks are the property of their respective owners
Bacula Community Edition v.11.0.4 (29 May 2021)
-
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
Bacula Community Edition v.11.0.4 (29 May 2021)All trademarks are the property of their respective owners
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
Bacula Community Edition v.11.0.4 (29 May 2021)
-
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
Bacula Community Edition v.11.0.4 (29 May 2021)All trademarks are the property of their respective owners
xxvii/646
-
Main Reference Manual LIST OF FIGURES
xxviii/646All trademarks are the property of their respective owners
Bacula Community Edition v.11.0.4 (29 May 2021)
-
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
Bacula Community Edition v.11.0.4 (29 May 2021)All trademarks are the property of their respective owners
xxix/646
-
Main Reference Manual LIST OF TABLES
xxx/646All trademarks are the property of their respective owners
Bacula Community Edition v.11.0.4 (29 May 2021)
-
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.
Bacula Community Edition v.11.0.4 (29 May 2021)All trademarks are the property of their respective owners
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 Community Edition v.11.0.4 (29 May 2021)
-
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.
Bacula Community Edition v.11.0.4 (29 May 2021)All trademarks are the property of their respective owners
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