# rsbackup and Debian

The Debian package of `rsbackup` has some extra features. You could use these on other systems but on Debian they are set up to work automatically.

## `/etc/rsbackup/config`

In the `.deb` package, the default `/etc/rsbackup/config` is as follows:

    # Location of lockfile
    lock /var/run/rsbackup.lock

    # User configuration
    include /etc/rsbackup/local

    # Hosts
    include /etc/rsbackup/hosts.d

Normally you would not edit this file. Instead, put local configuration in `/etc/rsbackup/local` and a file for each host to back up into `/etc/rsbackup/hosts.d`.

## `/etc/rsbackup/defaults`

There is an extra configuration file for the cron jobs, `/etc/rsbackup/defaults`. The default is as follows:

    #
    # Set backup=hourly|daily|weekly|monthly to control frequency of
    # backup attempts. (Use backup policies for fine-grained control over
    # when backups happen.)
    #
    backup=hourly

    #
    # Set report=hourly|daily|weekly|monthly to control frequency of
    # email reports.  (Hourly is probably a bit much!)  Only effective
    # if email is not "".
    #
    report=daily

    #
    # Set email=ADDRESS to have the report emailed to that address.
    #
    email=root

    #
    # Set prune=hourly|daily|weekly|monthly|never to control frequency of
    # automated pruning of old backups
    #
    prune=daily

    #
    # Set prune_incomplete=hourly|daily|weekly|monthly|never to control
    # frequency of automated pruning of incomplete backups
    #
    prune_incomplete=weekly

    #
    # Prefix to the rsbackup command
    # Use 'nice' and/or 'ionice' here
    #
    nicely=

- Set `backup` to control the frequency of backup attempts. Normally this can be left at `hourly` and the frequency of each host and volume’s backups controlled via backup policies.

- Set `email` to the destination address for reports from the daily backup run, or comment out the line entirely to suppress email reports. If you want reports at some other frequency than daily, modify `report`.

- Modify `prune` to control the frequency of pruning of old backups. It is recommended to leave this as `daily`, since deleting a week or more’s worth of backups takes a very long time.

- Modify `prune_incomplete` to control the frequency of deleting incomplete backups. It is recommended to keep this at a lower frequency than you take backups, as otherwise `rsync` will not be able to use incomplete backups to optimize new ones.

- Modify `nicely` to control the priority of `rsbackup`. For example, you might use:

      nicely="nice ionice -3"