ZFS

TL;DR

# Create a pool from a single device.
zpool create pool_name device

# Create an encrypted pool from multiple devices.
zpool create \
  -o feature@encryption=enabled \
  -O encryption=on -O keyformat=passphrase \
  pool_name \
  /dev/sdb /dev/sdc /dev/sdd

# List available pools.
zpool list

# Show pools configuration and status.
zpool status
zpool status pool_name time_in_seconds

# Show pools i/o statistics.
zpool iostat
zpool iostat pool_name -n 1

# Check a pool for errors.
# Verifies the checksum of every block.
# Very cpu and disk intensive.
zpool scrub pool_name

# List all pools available for import.
zpool import

# Import a pool.
zpool import pool_name
zpool import encrypted_pool_name -l

# Export a pool.
# Unmounts all filesystems in the pool.
zpool export pool_name

# Show the history of all pool's operations.
zpool history pool_name

# Create a mirrored pool.
zpool create pool_name mirror device1 device2 mirror device3 device4

# Add a cache (L2ARC) device to a pool.
zpool add pool_name cache cache_disk

# Show the current version of a pool.
zpool upgrade -v

# Upgrade pools.
zpool upgrade pool_name
zpool upgrade -a

# Get a pool's properties.
zpool get all pool_name

# Set a pool's properties.
zpool set compression=lz4 pool_name

# Add a vdev to a mirrored pool.
zpool attach pool_name first_drive_in_existing_mirror new_dev

# Destroy a pool.
zpool destroy pool_name

# Restore a destroyed pool.
# The pool needs to be reimported straight after the destroy command has been
# issued.
zpool import -D

# Get info about zpools features.
man zpool-features

# List all available datasets (filesystems).
zfs list

# Mount or unmount filesystems.
# See 'zfs get mountpoint pool_name' for a dataset's mountpoint's root path.
zfs mount -alv
zfs unmount pool_name/filesystem_name

# Create a new filesystem.
zfs create pool_name/filesystem_name

# Delete a filesystem.
zfs destroy pool_name/filesystem_name

# List all snapshots.
zfs list -t snapshot

# Recursively list snapshots for a given dataset, outputting only name and
# creation date
zfs list -r -t snapshot -o name,creation pool_name/filesystem_name

# Create a new snapshot.
zfs snapshot pool_name/filesystem_name@snapshot_name

# Destroy a snapshot.
zfs destroy  pool_name/filesystem_name@snapshot_name

# Query a file system or volume configuration (get properties).
zfs get all pool_name
zfs get all pool_name/filesystem_name

# Enable or change settings on a filesystem.
zfs set compression=on pool_name/filesystem_name
zfs set mountpoint=/my/mount/path pool_name/filesystem_name

# Get more information about zfs volumes properties.
man zfs

# Create a dataset in a new pool, adjust its permissions and unmount the pool.
sudo zpool create \
  -o feature@encryption=enabled \
  -O encryption=on -O keyformat=passphrase \
  vault /dev/sdb
sudo zfs create vault/data
sudo chown "$USER":users /vault/data
sudo zpool export vault

Gotchas

one cannot shrink a pool
one cannot remove vdevs after a pool is created
more than 9 drives in one RAIDZ can cause performance regression; use 2 RAIDZ with 5 drives each instead of 1 RAIDZ with 10 drives to avoid this
one can add hot spares to a RAIDZ1 or RAIDZ2 pool
one can replace a drive with a bigger one (but not a smaller one) one at a time
one can mix MIRROR, RAIDZ1 and RAIDZ2 in a pool
datasets need an empty folder to be mounted

Manjaro

Manjaro has prebuilt modules for ZFS, which package is the kernel's package postfixed by -zfs (e.g. for linux-515 it is linux515-zfs)

# install the modules' packages for all installed kernels
sudo pamac install $(mhwd-kernel --listinstalled | grep '*' | awk -F '* ' '{print $2}' | xargs -I {} echo {}-zfs)

Mac OS X

Pool options (-o option):

ashift=XX
- XX=9 for 512B sectors, XX=12 for 4KB sectors, XX=16 for 8KB sectors
- reference
version=28
- compatibility with ZFS on Linux

Filesystem options (-O option):

atime=off
compression=on
- activates compression with the default algorithm
- pool version 28 cannot use lz4
copies=2
- number of copies of data stored for the dataset
dedup=on
- deduplication
- halves write speed
- reference
xattr=sa

sudo zpool \
  create \
    -f \
    -o comment='LaCie Rugged USB-C 4T' \
    -o version=28 \
    -O casesensitivity=mixed \
    -O compression=on \
    -O com.apple.mimic_hfs=on \
    -O copies=2 \
    -O logbias=throughput \
    -O normalization=formD \
    -O xattr=sa \
    volume_name \
    disk2
sudo zpool import -a

sudo zpool \
  create \
    -f \
    -o ashift=12 \
    -o feature@allocation_classes=disabled \
    -o feature@async_destroy=enabled \
    -o feature@bookmarks=enabled \
    -o feature@device_removal=enabled \
    -o feature@embedded_data=enabled \
    -o feature@empty_bpobj=enabled \
    -o feature@enabled_txg=enabled \
    -o feature@encryption=disabled \
    -o feature@extensible_dataset=enabled \
    -o feature@hole_birth=enabled \
    -o feature@large_dnode=disabled \
    -o feature@obsolete_counts=enabled \
    -o feature@spacemap_histogram=enabled \
    -o feature@spacemap_v2=enabled \
    -o feature@zpool_checkpoint=enabled \
    -o feature@filesystem_limits=enabled \
    -o feature@multi_vdev_crash_dump=enabled \
    -o feature@lz4_compress=enabled \
    -o feature@project_quota=disabled \
    -o feature@resilver_defer=disabled \
    -o feature@sha512=enabled \
    -o feature@skein=enabled \
    -o feature@userobj_accounting=disabled \
    -O atime=off \
    -O relatime=on \
    -O compression=lz4 \
    -O logbias=throughput \
    -O normalization=formD \
    -O xattr=sa \
    volume_name \
    /dev/sdb

6.8 KiB Raw Blame History

ZFS

TL;DR

Gotchas

Manjaro

Mac OS X

Further readings

6.8 KiB

Raw Blame History