# cioctl drive


cioctl drive COMMAND [<DRIVEID>]

List, inspect, add, remove or rescan drive resources.

Drives are the raw devices that cio adds to a storage pool for creating volumes used by applications. When a cluster is created, cio will perform an automated discovery for drives to be added. Only drives that do not have filesystems or partitions will be automatically added. Drives can be local attached devices, e.g. ephemeral drives on cloud instances or can be networked attached devices.

The add subcommand enable drives to be added to increase capacity in the storage pool. Drives that are marked 'faulty' by the cio software can be removed and replaced. Drives with 'normal' status cannot be removed. New drives that are attached to nodes can be discovered with the rescan subcommand if they are not listed automatically.

Child commands

Command Description
cioctl drive add Add drive to storage pool
cioctl drive info Get information on drive resource
cioctl drive list List drives in cluster
cioctl drive remove Remove drive from storage pool
cioctl drive rescan Rescan nodes in cluster for new drives or changed capacity

# cioctl drive add


cioctl drive add <device> <node>

cioctl drive create <device> <node>

Add a drive to the storage pool.

Only drives marked with 'available' status can be added to the storage pool. Drives are added by specifying the drive path and node name. These two parameters are listed in the cioctl drive ls command.


Name Description
device Device is the identifier from cioctl drive list
node Identify which node, drive is attached to


$ cioctl drive add /dev/sdd u1
Succeed: node a8d3b506 has drive /dev/sdd added

# cioctl drive info


cioctl drive info <DRIVEID>

cioctl drive inspect <DRIVEID>

Get information about a device by drive id.


$ cioctl drive info a6b898730002sdd
nodeid: a6b89873
device: /dev/sdd
use: cio
type: SSD
capacity:      19 Gib
driveid: a6b898730002sdd
status: normal
Succeed: drive a6b898730002sdd info complete

# cioctl drive list


cioctl drive ls

cioctl drive list

List drives in the cluster's storage pool. Drives marked as 'available' can be added to the storage pool.


$ cioctl drive ls
NODENAME             DEVICE       USE  TYPE  SIZE(GB) DRIVE ID              STATUS
n1                   /dev/sdb     cio  SSD         9  7eb00b7d0000sdb       normal
n1                   /dev/sdc     cio  SSD        19  7eb00b7d0001sdc       normal
n1                   /dev/sdd     cio  SSD        19  7eb00b7d0002sdd       normal
n2                   /dev/sdb     cio  SSD         9  cd9a46fe0000sdb       normal
n2                   /dev/sdc     cio  SSD        19  cd9a46fe0001sdc       normal
n2                   /dev/sdd     cio  SSD        19  cd9a46fe0002sdd       normal
n3                   /dev/sdb     cio  SSD         9  a6b898730000sdb       normal
n3                   /dev/sdc     cio  SSD        19  a6b898730001sdc       normal
n3                   /dev/sdd     cio  SSD        19  a6b898730002sdd       normal
n4                   /dev/sdb     cio  SSD         9  92a88ffd0000sdb       normal
n4                   /dev/sdc     cio  SSD        19  92a88ffd0001sdc       normal
n4                   /dev/sdd     cio  SSD        19  92a88ffd0002sdd       normal

# cioctl drive remove


cioctl drive rm <DRIVEID>

cioctl drive remove <DRIVEID>

cioctl drive delete <DRIVEID>

Remove a faulty drive from the storage pool. Drives with 'normal' status cannot be removed.


Remove a faulty drive.

$ cioctl drive rm a8d3b5060002sdd
Succeed: drive a8d3b5060002sdd removed from storage pool

Remove a normal drive.

$ cioctl drive rm 92a88ffd0001sdc
Fail: Drive sdc on node 92a88ffd is not faulty

# cioctl drive rescan


cioctl drive rescan

Rescan all nodes in cluster for new drives or modified drive capacity. Any drive that can be added to the storage pool will have status 'available'.


$ cioctl drive rescan
Succeed: Scan drives complete
Last Updated: 3/17/2020, 3:56:27 AM