ZFS

On the ZFS page you build pools and datasets on a managed machine and read its disk health. A dataset shared from the page becomes an SMB share. The page enables the module on a machine, then shows that machine's Pools, Topology and Datasets.

Enable a device

1. In the panel, open ZFS under Agent.
2. Under Enabled devices, tick the machine with the disks and select Apply devices.

On a distribution with no prebuilt module for the running kernel, the consent dialog says that a kernel module is compiled on the machine. The build takes several minutes and runs again after every kernel upgrade.

Pools and topology

1. Under Pools, select Create pool.
2. Fill the Pool name and pick the First vdev disks.
3. Pick the Vdev layout.
4. Confirm. Disks that hold data need the word wipe typed before they are erased.

A vdev is a group of disks the pool stripes across, and the layout is how a vdev holds its data:

Layout	What it gives
Single	no redundancy
Mirror	full copies
RAID-Z1	survives one failed disk
RAID-Z2	survives two failed disks

Topology draws each pool's vdevs and disks. Expand adds a vdev to a pool, and a pool found on attached disks is offered for Import.

DANGER

A layout that does not match the pool's existing vdevs leaves the pool only as safe as its weakest vdev.

Datasets

1. Under Datasets, select Create dataset.
2. Fill the Name, pick the Pool, and set a Mountpoint or leave it blank for /pool/name.
3. Confirm.

Each dataset row shows its compression, record size and usage. Destroy removes the dataset and every file on it, and there is no snapshot to return to unless one was taken.

Disk health and replacement

Each disk in Topology shows its SMART result, passed or FAILING, and its Model. The temperature is shown when the drive reports one. Scrub starts a scrub of the pool. Replace on a disk takes a spare disk from the picker and resilvers onto it; with no spare attached the button reads No spare disk to replace with.

Share a dataset

1. On a mounted dataset, select Share.
2. Pick the users the share accepts, or pick none to accept every user, and confirm.

The Samba module on the same machine exports the dataset's mountpoint over SMB, read-write for the chosen users. The row then has an smb badge. It is then a share on the Samba page and an entry in the clients' Files panel; Unshare withdraws it.