CLI – Adding or removing storage array credentials

This section explains how to set the credentials that will be used to connect to the IBM® storage system, or systems, that your VMware platforms use for storage provisioning.

Important:

An identical storage admin user account with identical credentials (the same username and password) must already be predefined on all the IBM storage arrays that you intend to use. Spectrum Control can use only a single array management account for accessing all the different storage arrays that you use. For more information about how to define a storage admin account on your IBM storage arrays, refer to the relevant storage system management tools documentation.
Setting the storage credentials on Spectrum Control allows you to add the IBM storage arrays on the next step.
If the array management account is defined on a directory server, see Checking the format of directory-based storage array credentials.

Use the sc_storage_credentials CLI command to set (add), remove, or display the current storage array access credentials that Spectrum Control uses in order to access all the IBM storage arrays. Use the required argument after the command, as specified in the following table.

Note:

All CLI command arguments are case-sensitive.
The same operations are available from the GUI as well, as explained in GUI – Entering the storage array credentials.

Table 1. Arguments for sc_storage_credentials
Argument	Use after sc_storage_credentials to:
set -u <array username> -p <array password> -f -a <user type> or set --user <array username> --password <array password> --force --user_account <user type>	Set the username and password for accessing all the relevant IBM storage systems, and specify whether the storage admin user is locally-defined on the storage system or on a directory server. For example, if the storage admin user is locally defined on the storage system, enter: `sc_storage_credentials set -u john21 -p ****** -a local` And if the storage admin user is defined on a directory server, enter: `sc_storage_credentials set -u john21 -p **** -a directory` Attention: During regular operation, whenever a directory-based storage admin fails to log in (from the Spectrum Control side) to any storage array that is in use, Spectrum Control immediately locks the storage admin user account and all storage arrays become inaccessible on the Spectrum Control side. This is to prevent repeated login attempt failures after which the directory server blocks that user account. In such a case, use the -f or --force argument on the command line to unlock the storage admin account on the Spectrum Control side, with either the same credentials or with updated credentials. For example: `sc_storage_credentials set -u john21 -p ****** -f -a directory` The equivalent action in the Spectrum Control GUI is to update the account credentials, as described in GUI – Entering the storage array credentials. If the storage credentials are defined on a directory server, see Checking the format of directory-based storage array credentials.
remove	Delete the existing storage array user account definition from the server. For example: `sc_storage_credentials remove` Attention: If you already added storage systems to the server, deleting the user account disconnects all these storage systems.
list	Display the username of the existing storage array user account definition. The following example shows the command output when the storage admin user account is defined locally on the storage system: `sc_storage_credentials list Username Array Alias User Category Account Source ---------- ---------------- --------------- ---------------- admin XIV hostdev31b storageadmin local admin XIV hostdev32a storageadmin local admin XIV hostdev31a storageadmin local` The following example shows the command output when the storage admin user account is defined on a directory server: `sc_storage_credentials list Username Array Alias User Category Account Source ---------- ---------------- --------------- ---------------- admin XIV hostdev31b storageadmin directory admin XIV hostdev32a storageadmin directory admin XIV hostdev31a storageadmin directory`
-h or --help	Display help information that is relevant to sc_storage_credentials. You can also display help for the set argument if it is typed on the command line as well.