drive

Operations with the drives.

The commands clean and locate require superuser privileges.

# xicli drive <subcommand> <args> [optional_args]

Subcommands for the drive command:


clean	Delete the metadata and reset the number of failures from the drives.
faulty-count reset	Reset the current number of failures for drives.
faulty-count show	Show the current number of failures for drives.
locate	Manage the drive LED indication.

clean

Delete the metadata and reset the fault counter from the drives.

# xicli drive clean <arg>

Table 1. Argument for the clean subcommand
Required argument
-d	--drives	The list of block devices (/dev/sd, /dev/mapper/mpath, /dev/nvme, /dev/dm-) separated by a space to delete metadata and reset the fault counter.

Warning:

When you change any parameter of the xicli drive faulty-count reset command, the xiraid-scanner.service restarts.

Reset the current numbers of failures for drives.

# xicli drive faulty-count reset <arg>

Table 2. Arguments for the faulty-count reset subcommand
Required argument
-d	--drives	The list of block devices (/dev/sd, /dev/mapper/mpath, /dev/nvme, /dev/dm-) separated by a space to reset their current numbers of failures.

Show the current numbers of failures for drives.

# xicli drive faulty-count show [optional_args]

Table 3. Arguments for the faulty-count show subcommand
Mutually exclusive optional arguments
-n	--names	The RAID name for which drives the current number of failures will be shown. If neither of the two arguments is specified, show the values for all drives.
-d	--drives	The list of block devices (/dev/sd, /dev/mapper/mpath, /dev/nvme, /dev/dm-) separated by a space to show their current numbers of failures. If neither of the two arguments is specified, show the values for all drives.
Optional argument
-f	--format	Output format: `table`; `json`; `prettyjson` – human-readable json. The default: `table`.

Manage the drive LED indication.

# xicli drive locate <arg>

Table 4. Argument for the locate subcommand
Required argument
-d	--drives	The list of block devices (/dev/sd, /dev/mapper/mpath, /dev/nvme, /dev/dm-) separated by a space to switch the indication on, or switch the indication off (with the `null` value). The argument doesn’t affect the automatic indication.