Skip to main content

HDD Replacement (v3.8+)

Summary

This KB explains how to use the StorONE CLI application to identify, remove and replace array drives.

Requirements

  • StorONE version 3.8+
    • For HDD replacement instructions on version 3.7 and below, see HDD Replacement.
  • StorONE CLI application
  • Array administration user and password

Steps

  1. Identifying and ejecting the failing drive

  2. Illuminating JBOD LEDs for drive replacement

  3. Adding SED password (Optional)

  4. Adding replacement drive to pool

  5. Turning off JBOD LEDs

Identifying and removing a failed or failing drive

  1. Using the CLI application, log into the array as an administrator.

  2. Enter the command: settings output --table

  3. Enter the command: resource drives list to list the status, serial number, drive ID, device name, Drive vendor, model, self encrypting drive status.  and drive firmware version  All of this information will be needed when replacing a new drive

Example:

demo-array1> resources drives list

image.png

NOTE: the Resource Status: Missing

Enter command: setting output --tree

Enter command: resource drives list --details --ids <drive-ID>

Example: resource drives list --details --ids 199

image.png

NOTE: This disk has a status of missing, meaning it is already ejected by the array and needs to be replaced.

If the disk is in the process of failing and needs to be removed from the array, then illuminating the LED and physically removing the drive is recommended.  Proceed to “Illuminating LED for drive replacement” to light the correct LED to remove the drive.

To check a drive for SMART errors:

settings output --tree

resource drives smart --node <node-name> --driveid <drive-id>

Example: resource drives smart --node CSE90 --driveid 198

This will display the smart errors for the requested drive.  A range of drives can also be selected with this command

Example: resource drives smart --node CSE90 --driveid 19[3-6]

The above command will return SMART results for drives 193 through 196.

image.png


Illuminating JBOD LED for drive replacement

To Illuminate the JBOD light for an ejected drive.

Example: resource drives led_on --ids 1041

CSETRG> resources drives led_on --driveId 1041


CSETRG> resources drives list --led --ids 1041
Name             ║ Id   ║ Resource Serial      ║ Resource ║ Type ║ Capacity ║ Approved ║ Manual ║ Led
                 ║      ║                      ║ Status   ║      ║          ║ State    ║ Pool   ║
═════════════════╬══════╬══════════════════════╬══════════╬══════╬══════════╬══════════╬════════╬═════
XS3840SE70084512 ║ 1041 ║ HSQ06GME0000822150Z3 ║ OK       ║ SSD  ║ 3.8 TB   ║ Approved ║ SSD3.8 ║ On

Adding SED password for replacement drive (Optional)

If SED drives are in use, and the SED is activated, then before adding the replacement drive to a pool, we must first set the SED password for the new drive.

To determine if SED is in use:

nodes list --sed

image.png

If the field “Is SED Password Supplied”, is “True” then the array is using some SED capable drives.

To view the drive SED status: resource drives list --details

The example below shows SED enabled for the HDD drives, since we are replacing an HDD in this example, we need to initialize the SED for the new HDD

image.png

To initialize the SED for the replacement drive:

resources drives sed initialize --driveIds <disk-id> --password <sed-password> --confirmPassword <sed-password>

Example: resource drives sed initialize --driveids 199 --password abcd1234 --confirmPassword abcd1234

Adding replacement drive to pool

With the SED initialized if used, we can now add the replacement drive to the existing pool.

To verify the drive pools in use: resource drives pool list --drives

image.png

Once the desired pool is identified the following command will add the drive to a pool.

If user created (manual) drive pools are configured, the desired pool needs to be specified when approving the drive.

resource drive approve --driveIds <drive-id> --manualPool <pool-name>

Example:  resources drives approve --driveIds 199 --manualPool HDD-1

Disabling JBOD LEDs after drive replacement

Once drive replacement is completed, the drive has been initialized for SED if needed, and added to the desired pool, all that is left is to disable the JBOD LEDs used to find the drive.

To check JBOD LED status for all drives

resources drives list --led

To check LED status for a single or range of drives

resources drives list --led --ids <drive-ids>

To disable JBOD LEDs:

resources drives led_off --driveId <drive-id>

Example: resources drives led_off --driveId 199