| We moved this page to our Documentation Portal. You can find the latest updates here. |
Replacing an Integrated Storage (IS) disk drive is a step-by-step procedure to substitute one drive by another. There are two methods that you can apply to replace an IS disk drive either via UI or via CLI.
Before you begin
Before you continue with the procedure, ensure that all content on a storage node is redundant and no last copy of any existing virtual disk resides there. You can check it, using one of the following methods:
- Storage Health Check that is available at the Diagnostics page on your Control Panel UI.
Or, directly on a backup server or a compute resource where the drive should be replaced by running the getdegradedvdisks command. - After you check the content on a storage node, you can follow one of the next procedures.
Replace IS Disk Drive via UI
To replace an IS disk drive from you Control Panel, follow the next steps:
- Forget a storage node that is the same disk drive you need to replace. Go to your Control Panel > Integrated Storage > Nodes. Click the Actions icon for a selected node and click Forget.
- Unassign the disk drive from the Integrated Storage Controller. Go to Settings > Compute Resources and click a label of a destination compute resource. Click Tools, and then click Manage Devices. On the Devices page, click Edit Device Configuration. In the Disks section, click Unassigned next to Status for a destination disk. Click Next, and then click Finish.
- Replace the disk phisically on the compute resource. If a compute resource does not support live diskhotplug from the physical layer, then other vdisks on other storage nodes on the compute resource have to be redundant, the virtual servers - migrated from the compute resource, and the compute resource - brought to maintenance.
- Assign the new disk drive to the Integrated Storage Controller. Go to Settings > Compute Resources and click a label of a destination compute resource. Click Tools, and then click Manage Devices. On the Devices page, click Edit Device Configuration. In the Disks section, click Assign and select the Format checkbox next to Status for a destination disk. Click Next, and then click Finish. When you are finished, the storage node should be recognized by the Storage Controller. Telnet to the Storage Controller and check mount to see if xvdX or vdX is mounted correctly. If the node is mounted correctly, its OnApp UUID will be reported to other compute resources. After all compute resources are updated, you can add the node to the datastore.
- Add the node to a destination data store. Go to Integrated Storage > Data Stores. Click Edit next to the target data store. Select a checkbox next to the node that you want to add and click Save.
If you prefer to replace a disk via CLI, see the following procedure.
Replace IS Disk Drive via CLI
To replace an IS disk drive via CLI, follow the next steps:
- Forget a storage node that is the same disk drive you need to replace. Run the following command to forget the node for all virtual disks:
forgetfromall forgetlist=<UUID> - Unassign a particular disk drive from the Integrated Storage Controller by running the diskhotplug directly on the compute resource:
HV> diskhotplug list #shows storage controllers and slots of disks
e.g. Slot 0 - /dev/sda (SCSIid:Z2AAL2M41BC14_Z2AAL2M4,NodeID:1337660081)
The NodeID corresponds to the OnApp UUID and the SCSI ID corresponds to the result of onapp_scsi_id.
You can check which Storage Controller the config maps to in the storagenode config files at /onappstore/VMconfigs/...
HV> diskhotplug unassign <Controller> <slot> #deselects the disk drive, closes down the paths - Replace disk physically on compute resource.
If a compute resource does not support live diskhotplug from the physical layer, then other vdisks on other storage nodes on the compute resource have to be redundant, the virtual servers - migrated from the compute resource, and the compute resource - brought to maintenance. - Assign the new disk drive to the Integrated Storage Controller, using the formatandconfigure and diskhotplug utilities.
HV> formatandconfigure /dev/<sdX>
HV> diskhotplug assign <controller> <free-slot> /dev/<sdX>
When you are finished, the storage node should be recognized by the Storage Controller. Telnet to the Storage Controller and check mount to see if xvdX or vdX is mounted correctly. If the node is mounted correctly, its OnApp UUID will be reported to other compute resources. After all compute resources are updated, you can add the node to the datastore. - Run following command on current Compute resource or on Backup Server:
onappstore addnode uuid=<DS UUID> member_uuid=<NODE UUID>
DS UUID - IS Datastore identifier
NODE UUID - node ID identifier.
Useful information
For additional information on the steps from the procedures, see the following documents:
Forget Storage Node
Manage Compute Resource Devices
Add Disks to Data Store
Edit Integrated Storage Data Store