zfsa-pool-create(1)

Create a pool from whole disks

ZFS Assistant 0.7.0

NAME

zfsa-pool-create - Create a pool from whole disks

SYNOPSIS

zfsa pool create [GLOBAL OPTIONS] [--layout] [--ashift] [--compression] [--encrypt] [--grub] [-o|--option] [--passphrase-file] [--passphrase-fd] [-h|--help] <NAME> <DISKS>

DESCRIPTION

Create a pool from whole disks.

Every disk named is erased. Before anything happens the command shows the layout, the usable space, how many disk failures the pool survives and each disk's model and serial number, and you must type the pool's name. Without a terminal give --yes --confirm NAME. The default layout is single for one disk, a mirror for two, RAIDZ1 for three to five and RAIDZ2 for more. A stripe has no redundancy and also needs --yes.

OPTIONS

--layout <LAYOUT>

How the disks are arranged. Defaults to the safest layout for the number of disks

Possible values:

  • mirror: Every disk holds a full copy

  • mirrors: Pairs of mirrored disks

  • raidz1: One parity disk

  • raidz2: Two parity disks

  • raidz3: Three parity disks

  • single: One disk without protection

  • stripe: All space, no protection

--ashift <N>

The sector size as a power of two, 9 to 16. Defaults to the size ZFS chooses

--compression <COMPRESSION>

The compression (lz4 by default)

Possible values:

  • lz4: LZ4: fast, the usual choice

  • off: None

  • zstd: Zstandard: smaller, slower

--encrypt

Encrypt with a passphrase

--grub

The pool will hold /boot and GRUB reads it (compatibility=grub2)

-o, --option <PROPERTY=VALUE>

Set ashift, autotrim, compatibility or compression, property=value

--passphrase-file <FILE>

Read the passphrase from the first line of this file

--passphrase-fd <N>

Read the passphrase from this open descriptor (3<file, <(...))

-h, --help

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

<NAME>

The new pool's name

<DISKS>

The whole disks, by the names zfsa disk list shows

EXAMPLES

Find the free disks, then make a mirror of two of them:

zfsa disk list
zfsa pool create tank sdb sdc

An encrypted RAIDZ2 pool of six disks with zstd compression:

zfsa pool create tank sdb sdc sdd sde sdf sdg --layout raidz2 --compression zstd --encrypt

Check what would happen, then create the pool from a script:

zfsa --dry-run pool create tank sdb sdc
zfsa --yes --confirm tank pool create tank sdb sdc

SEE ALSO

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