lsnsd

Use the lsnsd command to list all Network Shared Disks (NSDs) or specified NSDs that are on a Storwize® V7000 Unified storage system. You can also list NSDs by file system, pool, or both.

Syntax


1  tpctool lsnsd  -user  user_name -pwd  password   -url  url
1  -dev device_id
1  -pool +  pool_id
1  -filesystem +  file_system_id
1  -nsd +  nsd_id
2? -l
2?  -fs  character
2?  -header 
2?  -help
2?  -qs  character
2?   -silent
2? -grouping

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.
-dev dev_id | -pool pool_id... | -filesystem file_system_id... | -nsd nsd_id...
The -dev parameter specifies that information is displayed for all NSDs that are associated with a storage system. This parameter requires the globally unique identifier (GUID) of the storage system. You can use the lsdev command to return information, including the GUID, for all storage systems that were discovered.
The -pool parameter specifies that information is displayed only for NSDs that are associated with specific pools. You can enter one or multiple pool IDs. Use a comma to separate multiple IDs. You can use the lspool command to return information, including the pool IDs, for all pools that were discovered.
The -filesystem parameter specifies that information is displayed only for NSDs that are associated with specific file systems. You can enter one or multiple file system IDs. Use a comma to separate multiple IDs. You can use the lsfs command to return information, including the file system IDs, for all file systems that were discovered.
The -nsd parameter specifies that information is displayed only for specific NSDs. You can enter one or multiple NSD IDs. Use a comma to separate multiple IDs.
-l
Specifies that the following information is listed.
ID
The ID for the NSD that is composed of the NSD name, storage system name, and storage system format.
NSD
NSD: The name of the NSD.
Cluster ID
The ID for the cluster that is associated with the NSD as defined by the Storwize V7000 Unified file module.
Failover Group
The failure group that the NSD belongs to.
Type
One or more of the following types: dataAndMetadata, dataOnly, metadataOnly.
Pool
The pool that the NSD is associated with.
Status
One of the following values: NORMAL, CRITICAL, WARNING, or UNREACHABLE.
Disk Space (GB)
The total disk space for the NSD.
Available Space (GB)
The amount of unused disk space for the NSD.
File System
The file system that the NSD is associated with.
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.
-grouping
Enables the grouping of numeric values. For example, in English, the value 12000 displays as 12,000. The grouping character is determined by the system locale.

Example: List all NSDs that are on a storage system

The following command generates a list of all NSDs that are on a Storwize V7000 Unified storage system.
tpctool> lsnsd -dev 00000200A0E0005C+0 -l

The following output is returned:

ID                                                    NSD                              
========================================================================================
array0_sas_60001ff07996c0089b00000+00000200A0E0005C+0 array0_sas_60001ff07996c0089b00000
array0_sas_60001ff07996c0289b20002+00000200A0E0005C+0 array0_sas_60001ff07996c0289b20002
array1_sas_60001ff07996c0389b30003+00000200A0E0005C+0 array1_sas_60001ff07996c0389b30003
array1_sas_60001ff07996c0189b10001+00000200A0E0005C+0 array1_sas_60001ff07996c0189b10001
array0_sas_60001ff07996c0489b40004+00000200A0E0005C+0 array0_sas_60001ff07996c0489b40004
Cluster ID            Failover Group Type             Pool   Status
===================================================================
12402779238946656959  1               dataAndMetadata system NORMAL
12402779238946656959  1               dataAndMetadata system NORMAL
12402779238946656959  4005            dataAndMetadata system NORMAL
12402779238946656959  1               dataAndMetadata system NORMAL
12402779238946656959  4002            dataAndMetadata system NORMAL
Disk Space (GB) Available Space (GB) File System
================================================
      4280                     3144  gpfs0
      4280                  4278.46  gpfs1
      4280                  4278.46  ma_19037
      4280                   4128.4  testadd
      4280                     4280  testadd