Diskhotplug
diskhotplug
is a command-line utility that you can use to manage IS Controller.
Starting from the 6.0 version, OnApp Cloud supports diskhotplug
for CloudBooted compute resources using the Integrated Storage platform. You can assign and unassign hardware disks from the IS Controllers on the compute resources, using the CLI utility.
To use the hotplug, run the following command from the required compute resource:
diskhotplug
You will see the list of all commands related to the diskhotplug
utility.
To avoid warning messages such as DELAYED_PING showing at the Diagnostics page, it will also be necessary to forget the disk drive. Whenever removing a disk drive permanently from OnApp Integrated Storage forget should be used. This can be performed by selecting nodes, finding the corresponding node, and then using the Forget option.
List of Available diskhotplug
Commands
d
iskhotplug list
- lists existing Controllers. Following is an example for a system with 6 disk drives set with default 4 drives per controller:> [root@x.x.x.x ~]# /diskhotplug list > Controller 0 > Slot 0 - /dev/sda (SCSIid:Z2A7VJQD_Z2A7VJQD,NodeID:130322041) > Slot 1 - /dev/sdb (SCSIid:9WM6B5WQS_9WM6B5WQ,NodeID:4043912490) > Slot 2 - /dev/sdc (SCSIid:9WM6B955S_9WM6B955,NodeID:2281894381) > Slot 3 - /dev/sdd (SCSIid:CVPR116003YH160DGN_2CW16_CVPR116003YH160DGN,NodeID:476612602) > Controller 1 > Slot 0 - /dev/sde (SCSIid:350025388500786eb_S1D9NEAD904298P,NodeID:235613508) > Slot 1 - /dev/sdf (SCSIid:35000cca0220b54c8_KPV675RF,NodeID:2574447922) > Slot 2 - EMPTY > Slot 3 - EMPTY
CODEdiskhotplug assign <Controller> <Slot> <device> -
assigns disks to Controllerdiskhotplug assign 3 0 /dev/sdh result=SUCCESS
CODEdiskhotplug unassign <Controller> <Slot>
- unassings disk from Controller. You can use the command when you face some mechanical disk failure or to move it to another server manually.In the example below, /dev/sdf is being removed:
> [root@x.x.x.x ~]# /diskhotplug unassign 1 1 Result of diskhotplug unassign: > [root@x.x.x.x ~]# /diskhotplug list > Controller 0 > Slot 0 - /dev/sda (SCSIid:Z2A7VJQD_Z2A7VJQD,NodeID:130322041) > Slot 1 - /dev/sdb (SCSIid:9WM6B5WQS_9WM6B5WQ,NodeID:4043912490) > Slot 2 - /dev/sdc (SCSIid:9WM6B955S_9WM6B955,NodeID:2281894381) > Slot 3 - /dev/sdd (SCSIid:CVPR116003YH160DGN_2CW16_CVPR116003YH160DGN,NodeID:476612602) > Controller 1 > Slot 0 - /dev/sde (SCSIid:350025388500786eb_S1D9NEAD904298P,NodeID:235613508) > Slot 1 - EMPTY > Slot 2 - EMPTY > Slot 3 - EMPTY
CODEdiskhotplug assign <Controller> <Slot> <device> -
assigns disks to Controller> [root@x.x.x.x ~]# /diskhotplug assign 1 1 /dev/sdf > [root@x.x.x.x ~]# /diskhotplug list > Controller 0 > Slot 0 - /dev/sda (SCSIid:Z2A7VJQD_Z2A7VJQD,NodeID:130322041) > Slot 1 - /dev/sdb (SCSIid:9WM6B5WQS_9WM6B5WQ,NodeID:4043912490) > Slot 2 - /dev/sdc (SCSIid:9WM6B955S_9WM6B955,NodeID:2281894381) > Slot 3 - /dev/sdd (SCSIid:CVPR116003YH160DGN_2CW16_CVPR116003YH160DGN,NodeID:476612602) > Controller 1 > Slot 0 - /dev/sde (SCSIid:350025388500786eb_S1D9NEAD904298P,NodeID:235613508) > Slot 1 - /dev/sdf (SCSIid:35000cca0220b54c8_KPV675RF,NodeID:2574447922) > Slot 2 - EMPTY > Slot 3 - EMPTY
CODEdiskhotplug initNewController
- creates a new one Controllerdiskhotplug initNewController Complete: added new controller: 4
CODEdiskhotplug restartController <Controller>
- restarts existing Controllerdiskhotplug restartController 3 Stopping Controller 3...DONE Re-initialising config...DONE Starting Controller 3...DONE
CODE
- Use the UI diagnostic view to query the current state of the Integrated Storage platform.
- Check that all vDisk content is redundant and all vDisks are in sync before attempting to unassign a physical drive when it is still active in the system.
- If no free slots are available while assigning disks using hotplug, the system will automatically initialize new controllers to assign the required number of disks.