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
       recovery, 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
       performed without installing zelta on remote systems--only standard ZFS
       utilities 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  re-
       spective	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 dis-
	      crepancies.  See zelta-match(8).

   Replication
       zelta backup source target
	      Replicate	a dataset tree.	 Creates snapshots if needed,  detects
	      optimal  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 op-
	      erations.	 See zelta-rotate(8).

   Automation
       zelta policy [options]
	      Execute replication operations based on configuration file defi-
	      nitions.	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-options(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