FreeBSD Manual Pages
zelta-policy(8) System Manager's Manual zelta-policy(8) NAME zelta policy - execute a list of zelta backup operations from a policy configuration SYNOPSIS zelta policy [backup-override-options] [site|host|dataset] ... DESCRIPTION zelta policy reads from a simple YAML-style configuration file contain- ing parameters for zelta backup. Running zelta policy without parame- ters will iterate through the entire configuration file. Override op- tions for either zelta policy or zelta backup can be provided on the command line, for example, adding --json will cause that parameter to be passed to all zelta backup calls. Subsequent undashed parameters will be matched against a user-defined site name, host name, or dataset, and the backup processes will be limited to that group or item. Options In the zelta policy configuration file, you may override zelta backup's default parameters as defined in zelta-backup(8). For the complete list of Zelta configuration options, see zelta-options(7). The follow- ing parameters are specific zelta policy: --retry Retry failed syncs the indicated number of times. --jobs Run the indicated number of policy jobs concurrently, one for each Site in the configuration. --backup-root The relative target path for the target job. For example `bkhost:tank/Backups' would place backups below that dataset (if not overridden). --host-prefix Include the source hostname as a parent of the synced target, for example, `tank/Backups/source.host/backup-dataset'. --ds-prefix Similar to `zfs recv -d' and `-e', include the indicated number of parent labels for the target's synced name. See `zelta help backup' for more detail. Backup Job Parameters Without additional parameters, zelta policy will run a zelta backup job for each dataset in the configuration file. Providing one of the fol- lowing will limit the backup job. site Run a backup job only for the site listed. A site is a user de- fined top-level parameter in the configuration file representing a list of one or more hosts. host Run a backup job only for the host listed. Hosts must be accessi- ble via SSH private-key authentication or localhost. dataset Run a backup job only for the dataset listed. Note this para- meter can match the source or target dataset, e.g., requesting zroot would run the replication for any matching dataset on any host. host:dataset Specify a source or backup dataset endpoint name, equiva- lent to the paramemters of zelta backup. dataset_pattern Specify the final source or target dataset label. For example, vm would run all backup jobs with datasets ending in /vm. FILES For detailed documentation of the zelta policy configuration see zelta.conf.example. /usr/local/etc/zelta/zelta.conf The default configuration file location. ENVIRONMENT For detailed documentation of the zelta environment variables see zelta help options. SEE ALSO zelta(8), zelta-clone(8), zelta-backup(8), zelta-options(7), zelta-match(8), zelta-revert(8), zelta-rotate(8), ssh(1), zfs(8), zfs-list(8) AUTHORS Daniel J. Bell <bellhyve@zelta.space> WWW https://zelta.space zelta-policy(8)
NAME | SYNOPSIS | DESCRIPTION | FILES | ENVIRONMENT | SEE ALSO | AUTHORS | WWW
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=zelta-policy&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>