PowerFlex: How to update device path and clear the SDS device errors using command line

This article explains how to clear device error for a device having mismatch between device path and device original-path

However, in another scenario the device may have mismatched device path and Original-path and is still in Normal state or in error state but not having the mismatched device path 

Meaning these two problems not a must to happen together, but when they happen together the command to clear errors may not work until device path mismatch is fixed 

• Log in to the Primary MDM with admin login. use single quotes ' ' if password has special characters

  3.x 
  scli --login --username admin --password '<password>'
  
  4.x 
  scli --login --username admin --password '<password>' --management_system_ip <pfmp_ip>

• Run the following command to list all SDSs details:

scli --query_all_sds

Example:

SDS ID: 2e400d3800000004 Name: LAB10_SDS3 State: Connected, Joined IP: XXX
SDS ID: 2e400d3700000003 Name: LAB10_SDS2 State: Connected, Joined IP: XXX
SDS ID: 2e400d3600000002 Name: LAB10_SDS4 State: Connected, Joined IP: XXX
SDS ID: 2e400d3500000001 Name: LAB10_SDS1 State: Connected, Joined IP: XXX
SDS ID: 2e400d3400000000 Name: LAB10_SDS5 State: Connected, Joined IP: XXX

• Location the impacted SDS and note down the SDS name then run the following command

 scli --query_sds --sds_name <sds_name>

Example output:

4: Name: ScaleIO-3a5aeb6e  Path: /dev/sde  Original-path: /dev/sdu  ID: 2a71c74700030003
                Storage Pool: SP_SAS, Capacity: 1116 GB Error-fixes: 0 scanned 0 MB, Compare errors: 0 State: Error
13: Name: ScaleIO-3a5aeb77  Path: /dev/sdn  Original-path: /dev/sdl  ID: 2a71c7500003000c
                Storage Pool: SP_SAS, Capacity: 1116 GB Error-fixes: 0 scanned 0 MB, Compare errors: 0 State: Error

• Location the impacted devices and note down the faulty device path 

In this example 2 devices are in error state, and unmatched device path and original-path

-Device path /dev/sde , Original-path /dev/sdu

-Device path /dev/sdn , Original-path /dev/sdl

• Clear device error will run successfully but errors will not be cleared, for having 2 different paths 

scli --clear_sds_device_error --sds_id c948227100000004 --device_path  /dev/sdu
 Successfully cleared SDS device sds: with ID c948227100000004, /dev/sdu

SDS node may change the device path after node is rebooted 

• Update the original path to match the current path 

scli --update_device_original_path --sds_name <sds_name> --device_id <device_id>

Example:

scli --update_device_original_path --sds_name LAB10_SDS3 --device_id  2a71c74700030003

Note: To use device_id instead of using device_path as the device path can be different at some point but the above command will rectify the same. 

• Clear device error 

-SDS name and device path are part of the command output of scli --query_all_sds and  scli --query_sds --sds_name <sds_name> explained in symptoms section above

Scli --clear_sds_device_error --sds_name <sds_name> --device_path <device path>

Example:

scli --clear_sds_device_error --sds_name LAB10_SDS3 --device_path /dev/sde
Scli --clear_sds_device_error --sds_name LAB10_SDS3 --device_path /dev/sdn