BSnapDiff for ZFS Plugin: Configuration

Bacula Enterprise Only

This solution is only available for Bacula Enterprise. For subscription inquiries, please reach out to sales@baculasystems.com.

The following chapter describes the configuration of BSnapDiff for ZFS Plugin.

Accurate Mode in Job Resource

In order to manage hard links properly, the Accurate = yes must be defined in the Job resource of the Director for jobs that include ZFS file systems.

Job {
  Name = "ZfsJob"
  Client = storage-fd
  Fileset = ZfsFileSet
  ...
  Accurate = yes
}

If Accurate mode is not enabled, or is explicitly disabled by setting Accurate = no, backups will not benefit from the BSnapDiff Plugin. In this case, the backup log will include the following message:

bsnapdiff is available but accurate mode is not enabled, running regular filesystem backup

Enable Snapshots in Fileset Resource

The BSnapDiff Plugin also requires snapshots to be enabled in the target file systems. Set EnableSnapshot = yes in the Fileset resource(s) where BSnapDiff is used.

Fileset {
  Name = ZfsFileSet
  EnableSnapshot = yes
  Include {
    Options {
           Signature = MD5
    }
  }
  File = /path/to/backup
}

If snapshots are not enabled, or are explicitly disabled by setting EnableSnapshot = no, backups will not use ZFS snapshots and will not take advantage of the BSnapDiff plugin. No log message will be generated, since the BSnapDiff plugin is never invoked when snapshots are disabled.

File Daemon Configuration

On the File Daemon host, the BSnapDiff Plugin is enabled by default. It can be disabled in the /opt/bacula/etc/bsnapshot.conf file with:

bsnapdiff=no

Once the plugin is enabled, snapshots are enabled, and Accurate mode is enabled, the backup will report a log message:

Snapshot incremental accelerator BSnapDiff for ZFS enabled