zfsa-backup-add(1)

Back up a policy to a remote or another pool

ZFS Assistant 0.7.0

NAME

zfsa-backup-add - Back up a policy to a remote or another pool

SYNOPSIS

zfsa backup add [GLOBAL OPTIONS] [--frequency] [--keep] [--keep-interval] [--keep-hourly] [--keep-daily] [--keep-weekly] [--keep-monthly] [--keep-yearly] [-h|--help] <--to> <--target> <POLICY>

DESCRIPTION

Back up a policy to a remote or another pool.

The backup copies the policy's snapshots below the dataset --target after the policy's snapshot job. The first copy sends a full snapshot, later ones what changed since. Encrypted datasets are sent raw, so the destination never needs their key. The destination must not be inside a dataset being copied, or contain one.

OPTIONS

--to <REMOTE>

A remote, or local for another pool on this computer

--target <DATASET>

The dataset the backups go under at the destination

--frequency <FREQUENCY>

How often it runs: after every snapshot run (the default for a new backup), at most once an hour or at most once a day

Possible values:

  • every-run: After every snapshot run

  • hourly: At most once an hour

  • daily: At most once a day

--keep <KEEP>

How far back the destination keeps backups: what the policy keeps (the default for a new backup), a week, a month or a year

Possible values:

  • same: What the policy keeps

  • week: A week

  • month: A month

  • year: A year

--keep-interval <N>

Backups at the policy's own interval to keep at the destination

--keep-hourly <N>

Hourly backups to keep at the destination

--keep-daily <N>

Daily backups to keep at the destination

--keep-weekly <N>

Weekly backups to keep at the destination

--keep-monthly <N>

Monthly backups to keep at the destination

--keep-yearly <N>

Yearly backups to keep at the destination

-h, --help

Print help (see a summary with '-h')

<POLICY>

The snapshot policy to back up

EXAMPLES

Copy the snapshots of the policy photos to a remote once a day:

zfsa backup add photos --to offsite --target backup/laptop/photos --frequency daily

Copy them to another pool on this computer after every snapshot run and keep a year there:

zfsa backup add photos --to local --target backup/photos --keep year

SEE ALSO

zfsa(1) for the global options, authorization, confirmations and exit status, zfsa-backup(1).