CLI – Adding or removing storage system 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 systems that you intend to use. Spectrum Control Base can use only a single system management account for accessing all the different storage systems that you use. For more information about how to define a storage admin account on your IBM storage systems, refer to the relevant storage system management tools documentation.
Setting the storage credentials on Spectrum Control Base allows you to add the IBM storage systems on the next step.
If the storage system management account is defined on a directory server, see Checking the format of directory-based storage system credentials.

Use the sc_storage_credentials CLI command to set (add), remove, or display the current storage system access credentials that Spectrum Control Base uses in order to access all the IBM storage systems. 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 system credentials.

Table 1. Arguments for sc_storage_credentials
Argument	Use after sc_storage_credentials to:
set -u <storage system username> -p <storage system password> -f -a <user type> or set --user <storage system username> --password <storage system 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 storage systems running Spectrum Virtualize, ensure that the credentials belong to a user account with VASAProvider role. 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 Base side) to any storage system that is in use, Spectrum Control Base immediately locks the storage admin user account and all storage systems become inaccessible on the Spectrum Control Base 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 Base 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 Base GUI is to update the account credentials, as described in GUI – Entering the storage system credentials. If the storage credentials are defined on a directory server, see Checking the format of directory-based storage system credentials.
remove	Delete the existing storage system 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 system 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.