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 they
orn
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.