adddevice

Use the adddevice command to add a storage system.

To add a storage system that is attached through an IBM® z/OS® connection, use the addstorsys command.

To change the location of a storage system, use the chlocation command.

Syntax

Read syntax diagramSkip visual syntax diagramadddevice-help-h-?-devtype dsspectrum-virtualizesvcxiv -ipip_address ;ip_address -usernameuser_name -portport;port

Parameters

-help | -h | -?
Lists help for the command. If you specify additional parameters and arguments, those parameters and arguments are ignored.
-devtype { ds | spectrum-virtualize | svc | xiv }
Specifies the type of storage system. The following list shows the parameter values and the storage systems that they represent.
  • ds: IBM DS8000®
  • spectrum-virtualize: Any Storage Virtualize device
  • svc: IBM SAN Volume Controller
  • xiv: IBM XIV® Storage System
-ip ip_address[;ip_address]
Specifies the IP address or host name of the clusters or nodes that are used by the storage system.
The following storage systems use two clusters. You must specify the IP address or host name for each cluster by using a semicolon between the addresses (for example, 192.0.2.0;192.0.2.1):
  • IBM DS8000
The following storage systems use one node and require only one address or host name:
  • SAN Volume Controller
  • Storage Virtualize
The XIV and FlashSystem A9000 use multiple nodes. Specify the IP address or host name for one node and the remaining nodes are discovered automatically.
-username user_name[;user_name]
Specifies the user name for the clusters or nodes.
For the following storage systems, you can provide one user name, which is used for both clusters, or you can specify two user names. If you have separate user names, include a semicolon between the user name for cluster 0 and cluster 1.
  • IBM DS8000
For the following storage systems, provide one user name:
  • SAN Volume Controller
  • Storage Virtualize
  • The XIV system
Important: After you enter the parameters for the adddevice command, you are prompted to enter the password for this user name. The password is not displayed in the command window.
-port port[;port]
Specifies the port to use for accessing the clusters or nodes.
For the following storage systems, you can provide one port number, which is used for both clusters, or you can provide two port numbers. If you have separate port numbers, include a semicolon between the port for cluster 0 and cluster 1. The default port number is 2433.
  • IBM DS8000
For the XIV system, provide one port number, which is used for all nodes. The default port number is 7778.
The following storage systems do not require this parameter.
  • SAN Volume Controller
  • Storage Virtualize
  • The XIV system

Example: Adding a storage system

The following command adds a TotalStorage Enterprise Storage Server® Model 800 storage system.

csmcli> adddevice -devtype ess -ip sts596c0;sts596c1 -username admin

The following output is returned:

Please enter a password for the device cluster 0 userid of admin:
IWNH1612I  The connection sts596c0:sts596c1 was successfully added.