zfsa-pool-add(1)

Add disks to a pool

ZFS Assistant 0.7.0

NAME

zfsa-pool-add - Add disks to a pool

SYNOPSIS

zfsa pool add [GLOBAL OPTIONS] [--as] [--checkpoint] [-h|--help] <POOL> <DISKS>

DESCRIPTION

Add disks to a pool.

Data disks can't always be removed again, and a disk added without protection makes the whole pool depend on it. --checkpoint takes a checkpoint first, so zpool import --rewind-to-checkpoint can undo the change; discard it with zfsa pool checkpoint --discard once you are sure.

OPTIONS

--as <ROLE> [default: disk]

What the disks become

Possible values:

  • cache: A read cache (L2ARC), one disk each

  • disk: Data disks, each on its own, without protection

  • log: A separate intent log (SLOG), one disk each

  • log-mirror: A separate intent log that is a mirror of all the disks

  • mirror: A mirror of all the disks

  • raidz1: One RAIDZ1 group of all the disks

  • raidz2: One RAIDZ2 group of all the disks

  • raidz3: One RAIDZ3 group of all the disks

  • special: Special (metadata) vdevs, one disk each

  • special-mirror: A special vdev that is a mirror of all the disks

  • spare: Hot spares, one disk each

--checkpoint

Take a checkpoint first, so the pool can be rewound if this was a mistake

-h, --help

Print help (see a summary with '-h')

<POOL>

The pool

<DISKS>

The new disks, by the names zfsa disk list shows

EXAMPLES

Grow a pool of mirrors by another mirrored pair, with a checkpoint to rewind to:

zfsa pool add tank sdd sde --as mirror --checkpoint

Add a read cache:

zfsa pool add tank nvme0n1 --as cache

SEE ALSO

zfsa(1) for the global options, authorization, confirmations and exit status, zfsa-pool(1).