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

FreeBSD Manual Pages

  
 
  

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

NAME
       zelta clone - Perform a recursive clone operation.

SYNOPSIS
       zelta clone [-d depth] [initiator] source/dataset target/dataset

DESCRIPTION
       zelta  clone performs a recursive zfs clone operation on	a local	or in-
       dicated host.  By default, it wil clone the most	recent dataset and all
       of its descendents.  The	target dataset must not	 exist.	  By  default,
       the  topmost  dataset property readonly=off will	be set.	 Note that ZFS
       cloning will reset (inherit) mountpoints.  Clones must  be  created  on
       the same	pool as	the source dataset.

       When  cloning,  the  source  can	 be  readonly  and not mounted,	making
       cloning excellent for backup  inspection	 as  well  as  recovery	 of  a
       dataset	from  a	specific snapshot.  If using zelta clone for recovery,
       consider	using zelta backup -rotate to  replicate  the  cloned  dataset
       state to	its backup replicas.

OPTIONS
       A source	and target dataset parameter are required.

       source/dataset
	      A	 dataset,  in the form pool[/component][@snapshot], which will
	      be cloned	along with all of its descendents.  If a  snapshot  is
	      not  given,  the	most recent snapshot will be used as the clone
	      origin.

       target/dataset
	      A	dataset, which must be on the same pool	as the source/dataset,
	      where the	clones will be created.	 This dataset must not exist.

       initiator
	      A	remote host, accessible	via SSH, where the clone commands will
	      be executed.

       -snapshot Snapshot before cloning.  See zelta.env.example to adjust the
       naming scheme.

       -n, -dryrun
	      Don't clone, but show the	zfs clone commands that	would be  exe-
	      cuted.

       -q Reduce verbosity.

       -v Increase verbosity.

       -d depth, -depth	depth
	      Limits the depth of all Zelta operations.

EXAMPLES
       The target clones can be	destroyed without affecting their source.  Af-
       ter cloning a dataset with a remote replica, zelta backup -rotate

       Clone a dataset tree for	inspection:

	      zelta clone tank/vm/myos tank/temp/myos-202404

       Recover a dataset tree, in place, to a previous snapshot's state:

	      zfs rename tank/vm/myos tank/Archives/myos-202404
	      zelta clone tank/Archives/myos-202404@goodsnapshot tank/vm/myos

       Dry Run:	Display	the zfs	clone commands without executing them.

	      zelta clone -n tank/source/dataset tank/target/dataset

SEE ALSO
       ssh(1),	zelta(8),  zelta-backup(8),  zelta-match(8),  zelta-policy(8),
       zfs(8), zfs-clone(8), zfs-promote(8)

AUTHORS
       Daniel J. Bell <bellta@belltower.it>

WWW
       https://zelta.space

								zelta-clone(8)

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

home | help