CLI – Managing storage systems

All IBM® storage systems that provide storage resources to your VMware platforms must be defined as storage systems on the IBM Spectrum Control Base Edition.

Use the sc_storage_array CLI command to add, remove, configure or list these IBM storage systems (referred to as arrays in the command syntax and output). Use the required argument after the command, as specified in the following table. In addition, you can set a threshold for alerting the user, when a storage resource capacity is running low, using the sc_setting CLI command.

Important:

IBM storage systems can be added only after the storage credentials are set, as explained in CLI – Adding or removing storage system credentials.
If you want to remove existing storage systems:
- A removed storage system, along with its storage pools and volumes, can no longer be managed by the included solution components (see Included cloud interfaces).
- If the removed storage system contains working storage pools and volumes, the information of these storage pools and volumes is no longer displayed in vSphere Web Client. However, vSphere data access and service level for these storage pools and volumes is not affected. In addition, the removed system and its storage pools and volumes can be managed from the standard IBM storage system management tools.
- After the removal, you can add the storage system back again to fully restore its management.

Note:

All CLI command arguments are case-sensitive.
The same operations are available from the GUI as well, as explained in Managing storage systems.

Table 1. Arguments for sc_storage_array
Argument	Use after sc_storage_array to:
add -i <management IP address> -a <system alias name> or add --mgmt_ip <management IP address> --storage_type <storage system type> --alias <system alias name>	Add a storage system specified by an IP address or DNS. For example: `sc_storage_array add -i 10.100.155.200` Optional: you can define an alias for the added XIV® system, by adding -a <alias name> or --alias <alias name> to the command. For example: `sc_storage_array add -i 10.100.155.200 -a mystorage1` Note: If you choose not to define an alias, the alias that is already defined (if one was defined) on the IBM storage system side is automatically assigned as the alias.
remove -a <system alias name> or remove --alias <system alias name>	Remove a storage system specified by its alias (alias that was given by you or was automatically assigned). For example: `sc_storage_array remove -a mystorage1`
list	List the names and details of all the IBM storage systems that are currently added (and were not removed). The displayed information includes: Array alias Array identifier Management IP address Elapsed time since last update Connected Notes See the example after this table.
full_metadata_recovery -a <system alias name>	Perform full VVol metadata restoration on a secondary Spectrum Control Base in a high-availability (HA) group. The metadata disparity might occur during recovery in the HA group due to timestamp inconsistencies. The timestamp inconsistencies are possible on a storage system, when its internal clock is changed to comply with time zone settings or daylight saving time requirements.
refresh	Refresh information about all managed IBM storage systems.
-h or --help	Display help information that is relevant to sc_storage_array. You can also display help for the add or remove argument if it is typed on the command line as well.

The following example shows the displayed information and format of the sc_storage_array list command output.

sc_storage_array list

 Array       Array             Management       Elapsed time
 Alias       Identifier        IP Addresses     since last update    Connected    Notes
 ----------  ----------------  -------------    ------------------   ----------   ---------------------------------
 array1000   2810-114-MN65026  9.100.150.155    16 minutes           False        Failed to log in to array 2810
                                                                                  with the provided credentials.

 array2000   2810-114-MN65027  9.200.155.155    27 minutes           True

Table 2. Storage resource-related arguments for sc_setting
Argument	Use after sc_setting to:
modify -n RESOURCE_CAPACITY_THRESHOLD -v <capacity threshold in %>	Define a threshold for a VVol-based storage resource capacity. When this threshold is reached, an alarm is generated to indicate that the storage capacity is running low. By default, the threshold is set at 70%. For example, to alert the user, when the storage resource has reached 80% of its capacity, enter: `sc_setting modify -n RESOURCE_CAPACITY_THRESHOLD -v 80`