====== ZFS - Replication ======

Replication is incredibly fast compared to traditional file based syncing methods like rsync.

<code bash>
zfs send <local_dataset>@<snapshot> | ssh <remote_user>@<remote host> zfs receive <remote_dataset>
</code>

<WRAP info>
**NOTE:**  Permissions to non-root users may be needing to be set.
</WRAP>

----

===== ZFS Send / Receive for non-root Account =====

<code bash>
sudo zfs send testpool/disk1@aug18 | ssh remoteuser@192.168.1.5 zfs recv xyz-pool/testpool-aug18
</code>

returns:

<code bash>
cannot receive new filesystem stream: permission denied
</code>

----

==== Set Permissions on the sender side ====

Assuming the sender is **peter**:

<code bash>
sudo zfs allow -u peter send,snapshot,hold testpool
</code>


==== Set Permissions on the receiver side ====

Assuming the receiver is **remoteuser**:

<code bash>
sudo zfs allow -u remoteuser compression,mountpoint,create,mount,receive xyz-pool
</code>

<WRAP info>
**NOTE**  After setting the permissions, the sending and receiving of the snapshots should work successfully.
</WRAP>

----

===== Check the Receiver has received the data =====

<code bash>
remoteuser@ip-:/dev$ zfs list -t snapshot
NAME                            USED  AVAIL  REFER  MOUNTPOINT
xyz-pool/testpool-aug18@aug18     0B      -  30.4M  -
</code>