CLI – Managing integration with vCenter Operations Manager

Before you can use the IBM® Storage Management Pack for VMware vCenter Operations Manager, you must set a connection to at least one vCenter Operations Manager (vCOps) server, and then define which storage systems should be monitored in vCOps.

After a vCOps server connection is defined and storage systems (referred to as arrays in the command syntax and output) are associated with the vCOps server, detailed monitoring information for these storage systems becomes available in vCOps (for more information, see Using the IBM Storage Management Pack for VMware vCenter Operations Manager).

Use the sc_vcops_server CLI command to add, remove, or disable connections to vCOps servers, or to list the current server connections. An HTTP POST adapter is automatically created for each vCOps server that you add.

Use the sc_vcops_adapter command to attach storage systems to any created HTTP POST adapter. A storage system that is attached to an HTTP POST adapter can be monitored by the vCOps server for which the HTTP POST adapter was created. You can use the sc_vcops_adapter command for additional options as described below.

Use the required argument after each command, as specified in the following tables.

Important:

Storage systems can be attached to HTTP POST adapters only after the storage systems have been added to Spectrum Control Base, as explained in CLI – Adding or removing storage systems.
If the IBM Storage PAK file was not deployed on the vCOps server, IBM Storage monitoring information is not displayed with dedicated dashboards, graphic icons, and user-friendly attribute names in vCOps. For information about how to deploy the IBM Storage PAK file, see GUI – Downloading the vCOps management package.
If you want to detach storage systems:
- A detached storage system can no longer be monitored through vCenter Operations Manager.
- After the detachment, you can reattach the storage system to fully restore its monitoring through vCenter Operations Manager.

Note:

All CLI command arguments are case-sensitive.
Apart from the ability to add more than one vCOps server and additional HTTP POST adapters from the CLI, the same operations are available from the GUI as well, as explained in GUI – Managing integration with vCenter Operations Manager.

Table 1. Arguments for sc_vcops_server
Argument	Use after sc_vcops_server to:
add -n <hostname> -u <username> -p <password> or add --hostname <hostname> --username <username> --password <password>	Add a vCOps server connection by specifying the following parameters on the command line: IP address or hostname of the vCOps server that you want to add (connect to). Username for accessing the vCOps server. Password for accessing the vCOps server. For example: `sc_vcops_server add -n vcops1.domain -u john1 -p ********` Note: The local HTTP POST adapter is added automatically after the vCOps server is added.
remove -n <hostname> or remove --hostname <hostname>	Remove a vCOps server connection by specifying its IP address or hostname on the command line. For example: `sc_vcops_server remove -n vcops1.domain` Note: A removed vCOps server ceases to receive monitoring information regarding IBM storage resources that are in use. You can add a vCOps server back by using the add option (see above).
disable -n <hostname> or disable --hostname <hostname>	Disable reporting to a vCOps server (without removing its connection) by specifying its IP address or hostname on the command line. For example: `sc_vcops_server disable -n vcops1.domain` Note: A vCOps server for which reporting is disabled ceases to receive monitoring information regarding IBM storage resources that are in use. You can resume reporting to a vCOps server by using the enable option (see below).
enable -n <hostname> or enable --hostname <hostname>	Resume reporting to a vCOps server by specifying its IP address or hostname on the command line. For example: `sc_vcops_server enable -n vcops1.domain`
list	List all the currently connected (added) vCOps servers and their operation status (enabled or disabled). For example: `sc_vcops_server list vCOps Hostname Status --------------- ------- vcops1.domain Enabled vcops2.domain Disabled`
-h or --help	Display help information that is relevant to sc_vcops_server . You can also display help for the add, remove, enable, or disable argument if it is typed on the command line as well.

Table 2. Arguments for sc_vcops_adapter
Argument	Use after sc_vcops_adapter to:
array_attach -a <alias> -n <hostname> or array_attach --alias <alias> --hostname <hostname>	Attach a storage system to a vCOps HTTP POST adapter (of a vCOps server) by specifying the following parameters on the command line: Alias name of the storage system that you want to attach. IP address or hostname of the storage system that you want to attach. For example: `sc_vcops_adapter array_attach -a myXIV -n 9.150.200.100` Note: The storage system must already be added to Spectrum Control Base, as explained in CLI – Adding or removing storage systems.
array_detach -a <alias> -n <hostname> or array_detach --alias <alias> --hostname <hostname>	Detach a storage system from a vCOps HTTP POST adapter (of a vCOps server) by specifying the following parameters on the command line: Alias name of the storage system that you want to detach. IP address or hostname of the storage system that you want to detach. For example: `sc_vcops_adapter array_detach -a myXIV -n 9.150.200.100`
add -s <server> -n <hostname> or add --server <server> --hostname <hostname>	Add an HTTP POST adapter for a vCOps server by specifying the following parameters on the command line: IP address or hostname of a currently added (connected) vCOps server. IP address or hostname of the HTTP POST adapter that you want to add. For example: `sc_vcops_adapter add -s vcops1.domain -n adapter2.domain`
remove -n <hostname> or remove --hostname <hostname>	Remove an HTTP POST adapter by specifying its IP address or hostname on the command line. For example: `sc_vcops_adapter remove -n adapter2.domain`
report_thresholds -n <hostname> or report_thresholds --hostname <hostname>	Report the thresholds to a vCOps server by specifying its IP address or hostname on the command line. For example: `sc_vcops_adapter report_thresholds -n vcops1.domain`
report_thresholds -a or report_thresholds -all	Report the thresholds to all vCOps servers that are currently added (connected). Usually, this command can be omitted, because the thresholds are defined by default, when a vCOps server is added. `sc_vcops_adapter report_thresholds -a`
list	List all the currently defined HTTP POST adapters and display their associated vCOps server, alias name of attached storage systems, last report time (report to the vCOps server), and indication regarding whether the adapter is remote or locally defined. For example: `sc_vcops_adapter list vCOps Hostname HTTP POST Hostname Remote Last Reported Array alias -------------- ------------------ ------ ------------- ----------- vcops1.domain adapter1.domain No 5 minutes ago myXIV vcops2.domain adapter2.domain Yes 8 minutes ago myXIV`
-h or --help	Display help information that is relevant to sc_vcops_adapter. You can also display help for the array_attach, array_detach, add, remove, or report_thresholds argument if it is typed on the command line as well.