Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
zelta(8)		     System Manager's Manual			zelta(8)

NAME
     zelta - perform safe, recursive ZFS operations locally and remotely

SYNOPSIS
		zelta -V | \--version | version
		zelta SUBCOMMAND [OPTIONS] [ARGUMENTS]

DESCRIPTION
     zelta  provides tools for ZFS replication, backup verification, dataset re-
     covery, and policy-based automation.  All operations  work  recursively  on
     dataset trees and support both local and remote execution via ssh(1).

     Remote dataset endpoints follow scp(1) conventions.  Operations can be per-
     formed without installing zelta on remote systems--only standard ZFS utili-
     ties and SSH access are required.

     Examples:

	    Local:  pool/dataset@snapshot
	    Remote: user@example.com:pool/dataset@snapshot

     See zfs(8) for dataset naming conventions.

SUBCOMMANDS
     For  detailed  usage of each subcommand, run zelta help  or see the respec-
     tive manual page.

     zelta -?
	    Display help message.

     zelta -V, --version, version
	    Display version information.

   Comparison
     zelta match source target
	    Compare two dataset trees and report matching snapshots or	discrep-
	    ancies.  See zelta-match(8).

   Replication
     zelta backup source target
	    Replicate  a dataset tree.	Creates snapshots if needed, detects op-
	    timal send options,  and  replicates  intermediate	snapshots.   See
	    zelta-backup(8).

   Recovery
     zelta clone dataset target
	    Create a writable clone of a dataset tree.	See zelta-clone(8).

     zelta revert dataset
	    Rewind  a  dataset	to  a previous snapshot by renaming and cloning.
	    Preserves current state.  See zelta-revert(8).

     zelta rotate source target
	    Preserve divergent dataset versions through rename and clone  opera-
	    tions.  See zelta-rotate(8).

   Automation
     zelta policy [options]
	    Execute  replication  operations based on configuration file defini-
	    tions.  See zelta-policy(8).

OPTIONS AND ENVIRONMENT
     Configuration follows a hierarchy from lowest to highest precedence:

	    1. Internal defaults
	    2. `/usr/local/etc/zelta/zelta.env`
	    3. Policy configuration (`zelta.conf`)
	    4. Environment variables
	    5. Command-line arguments

     See zelta-options(7) for details.

FILES
     /usr/local/etc/zelta/zelta.conf
	    Default policy configuration file.

     /usr/local/etc/zelta/zelta.env
	    Global default setting overrides.

EXAMPLES
     The following examples use "sink" as the source  pool  and  "tank"  as  the
     backup target.

     Replicate a dataset to a remote host:

	    zelta backup sink/data/project backupuser@backup-host.example:tank/backups/project

     Compare local and remote dataset trees:

	    zelta match sink/data remote:tank/backups

     Revert a dataset to its previous snapshot:

	    zelta revert sink/data/project

     Update a target that has diverged:

	    zelta rotate sink/data/project backupuser@backup-host.example:tank/backups/project

     Back up everything defined in policy settings (zelta.conf).

	    zelta policy

EXIT STATUS
     Returns 0 on success, non-zero on error.

SEE ALSO
     zelta-match(8), zelta-backup(8), zelta-policy(8), zelta-clone(8), zelta-op-
     tions(7), zelta-revert(8), zelta-rotate(8), cron(8), ssh(1), zfs(8)

AUTHORS
     Daniel J. Bell <bellhyve@zelta.space>

WWW
     https://zelta.space

									zelta(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=zelta&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help