NAME

zelta clone - Perform a recursive clone operation.

SYNOPSIS

zelta clone [-d depth] source/dataset[@snap] target/dataset

DESCRIPTION

zelta clone performs a recursive zfs clone operation on a dataset. This is useful for recursive duplication of dataset trees and backup inspection and recovery of a files replicated with zelta backup. The clones will reference the latest or indicated snapshot, and consume practically no additional space. Clones can be modified and destroyed without affecting their origin datasets.

The source and target must be on the same host and pool. The mountpoint will be inherited below the target parent (as provided by zfs clone). The target dataset must not exist. To create a clone on a remote host ensure the source and target are identical including the username and hostname used:

Example remote operation:

zelta clone backup@host1.com:tank/zones/data host1.com:tank/clones/data
    

OPTIONS

Required Options

source

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

target

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

Logging Options

-n, --dryrun

Don’t clone, but show the zfs clone commands that would be executed.

-q

Reduce verbosity.

-v

Increase verbosity.

Dataset and Snapshot Options

--snapshot-always

Ensure a snapshot before cloning.

--snapshot-name

Specify a snapshot name. See zelta.env.example to adjust the default naming scheme.

-d depth, --depth depth

Limits the depth of all Zelta operations.

EXAMPLES

Clone a dataset tree:

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

zelta(8), zelta-backup(8), zelta-match(8), zelta-options(7), zelta-policy(8), zelta-revert(8), zelta-rotate(8), cron(8), ssh(1), zfs(8), zfs-clone(8), zfs-promote(8)

AUTHORS

Daniel J. Bell <bellhyve@zelta.space>

WWW

https://zelta.space