Device preparation options

The storpool_initdisk tool is used when preparing storage devices for the cluster, see Storage devices. Here you can find detailed information about the options of this tool.

Basic options

--bad

Marks disk as bad. Will be treated as ejected by the servers.

-F

Forget this disk and mark it as ejected; succeeds only without a running storpool_server instance that has the drive opened.

--good

Resets disk to ejected if it was bad. Use with caution.

-i

Specify server instance, used when more than one storpool_server instances are running on the same node.

-j / --journal (<device>|none)

Set a device to be used for a journal. Used for HDDs when a RAID controller with a working cachevault or battery is present or an NVMe device is used as a power loss protected write-back journal cache.

--json

Output the list of devices as a JSON object.

--list

List all StorPool disks on this node.

--list-empty

List empty NVMe devices.

--nvme-smart nvme-pci-addr

Dump the NVMe S.M.A.R.T. counters; only for devices controlled by the storpool_nvmed service.

-r

Used to return an ejected disk back to the cluster or change some of the flags.

-s / --ssd y/n

Set SSD flag - on new initialize only, not reversible with -r. Providing the y or n value forces a disk to be considered as flash-based or not.

Advanced options

The following options should be used with care:

-e (entries_count)

Initialize the disk by overriding the default number of entries count (default is based on the disk size).

-o (objects_count)

Initialize the disk by overriding the default number of objects count (default is based on the disk size).

–no-fua (y|n)

Used to forcefully disable FUA support for an SSD device. Use with caution because it might lead to data loss if the device is powered off before issuing a FLUSH CACHE command.

–no-flush (y|n)

Used to forcefully disable FLUSH support for an SSD device.

--no-notify

Does not notify servers of the changes. They won’t immediately open the disk. Useful for changing a flag with -r without returning the disk back to the server.

--no-test

Disable forced one-time test flag.

–no-trim (y|n)

Used to forcefully disable TRIM support for an SSD device. Useful when the drive is misbehaving when TRIM is enabled.

--nvmed-rescan

Instruct the storpool_nvmed service to rescan after device changes.

–test-override (no|test|pass)

Modify the “test override” flag (default during disk init is “test”).

–wbc (y|n)

Used for HDDs when the internal write-back caching is enabled, implies SP_WRITE_BACK_CACHE_ENABLED to have an effect (see Internal write-back caching). Turned off by default.

--wipe-all-data

Used when re-initializing an already initialized StorPool drive. Use with caution.