lsnode

Use the lsnode command to list all nodes or specified nodes that are associated with a cluster that is on a Storwize V7000 Unified storage system.

Syntax

Read syntax diagramSkip visual syntax diagramtpctoollsnode-user user_name -pwd password -url url -cluster cluster_id-node  node_id-l-fs character-header -help-qs character?-silent

Parameters and arguments

-user user_name
Specifies an IBM Spectrum Control user ID.
-pwd password
Specifies the password for the IBM Spectrum Control user ID.
-url url
Specifies the Device server. The format of the URL is system:port_number, where system represents either the host name or IP address, and port_number represents the IBM Spectrum Control Device server port.
-cluster cluster_id | -node node_id...
Specifies that information is displayed for all nodes that are on a cluster.
For the -cluster parameter, specify the ID for the cluster. You can use the lscluster command to view information, including the cluster IDs, for all clusters that were discovered.
The -node parameter specifies that information is displayed only for specific nodes. You can enter one or multiple node IDs. Use a comma to separate multiple IDs.
-l
Specifies that the following information is listed.
ID
An ID for the node that is composed of the node name, cluster name, storage system name, and storage system format.
Node
The name of the node.
Description
The description of the node.
IP Address
The IP address for the node.
Role
One or more of the following roles: interface, management, or storage.
Cache Gateway Node
Specifies Yes or No to indicate whether an interface node is enabled to function as a caching gateway node that exchanges data with other systems.
Status
One of the following values: NORMAL, CRITICAL, or WARNING.
If you omit this parameter, only the ID is returned.
-fs character
Specifies the 7-bit character that separates the information in the output. If you omit this parameter, the information is separated by blank spaces.
-header
Suppresses the column headings in the output. If you omit this parameter, the column headings are included.
-help | -h | -?
Lists help information for the command.
-qs character
Specifies the 7-bit character that surrounds character strings and date stamps in the output. If you omit this parameter, character strings and date stamps are enclosed by double quotation marks (").
-silent
Suppresses all output for the command. If you omit this parameter, output is included.

Example: Listing all nodes that are on a cluster

The following command generates a list of all nodes that are on a cluster.
tpctool> lsnode -cluster storage3.storage.tucson.ibm.com+127.0.0.1+0 -l

The following output is returned:

ID                                                          
===========================================================
int001st001+storage3.storage.tucson.ibm.com+127.0.0.1+0
int002st001+storage3.storage.tucson.ibm.com+127.0.0.1+0
int003st001+storage3.storage.tucson.ibm.com+127.0.0.1+0
mgmt001st001+storage3.storage.tucson.ibm.com+127.0.0.1+0
strg001st001+storage3.storage.tucson.ibm.com+127.0.0.1+0
strg002st001+storage3.storage.tucson.ibm.com+127.0.0.1+0
Node         Description  IP Address   Role 
================================================
int001st001  int001st001  127.0.0.1  interface
int002st001  int002st001  127.0.0.1  interface
int003st001  int003st001  127.0.0.1  interface
mgmt001st001 mgmt001st001 127.0.0.1  interface,management
strg001st001 strg001st001 127.0.0.1 storage
strg002st001 strg002st001 127.0.0.1 storage
Status        Cache Gateway Node
================================
NORMAL            Yes
NORMAL            Yes
NORMAL            No
NORMAL            No
NORMAL            No
NORMAL            No