PowerFlex: How to Use Command line to Update Device Path and Clear the SDS Device Errors
Summary: Even after performing the clean command, the SDS device error does not clear. Below are steps on how this can be addressed.
Symptoms
This article explains how to clear device error for a device having a mismatch between device path and device original-path.
However, in another scenario the device may have a mismatched device path and Original-path and is still in a Normal state or in error state but not having the mismatched device path.
This means that these two issues do not have 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 the 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
- Locate the impacted SDS and write 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
- Locate the impacted devices and write down the faulty device path. In this example two devices are in error state, and have unmatched device path and original-path:
- Device path
/dev/sde, Original path/dev/sdu - Device path
/dev/sdn, Original path/dev/sdl
- Device path
- Clear device error runs successfully but errors are not be cleared, because of having two different paths.
scli --clear_sds_device_error --sds_id c948227100000004 --device_path /dev/sdu Successfully cleared SDS device sds: with ID c948227100000004, /dev/sdu
Cause
SDS node may change the device path after node is rebooted.
Resolution
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
device_id instead of using device_path as the device path can be different at some point but the above command rectifies 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> as 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