essfindmissingdisks command

Checks the disk paths and cabling connectivity.

Synopsis


essfindmissingdisks { -N NodeList } 
                    [ --prefix Prefix ] [ --suffix Suffix ] [ -h | --help ]

Availability

Available with IBM Storage Scale System.

Description

The essfindmissingdisks command checks for incorrect and missing cable connections between I/O server nodes and storage enclosures. The command checks for:
  • Paths to disks
  • Proper cable connections

Parameters

-N NodeList
Specifies a comma-separated list of nodes to run the check.

You must specify the -N or -G parameter.

--prefix Prefix
Specifies the hostname prefix. Use Prefix with NodeList to generate node names when you run the check. Use = between --suffix and value if the value starts with -.
--suffix Suffix
Specifies the hostname suffix. Use Suffix with NodeList to generate node names when you run the check. For example:
  • Node list gssio1,gssio2
  • Prefix A-
  • Suffix -ib
  • Node names A-gssio1-ib and A-gssio2-ib
The newly formed node name must be resolvable to corresponding IP address. Use = between --suffix and value if the value starts with -.
-h | --help
Displays usage information about this command and exits.

Exit status

0
Successful completion.
nonzero
A failure has occurred.

Security

You must have root authority to run the essfindmissingdisks command.

Examples

Following example shows essfindmissingdisks running on node gssio1.
essfindmissingdisks -N gssio1

The system displays output similar to this: 

essfindmissingdisks -N gssio1
2021-03-10T14:56:37.014399 [INFO] Start find missing disk paths
  2021-03-10T14:56:39.126262 [INFO] nodelist:  gssio1
  2021-03-10T14:56:39.126399 [INFO] May take long time to complete search of all drive paths
  2021-03-10T14:56:39.735788 [INFO] Checking missing disk paths from node  gssio1
  gssio1: GNR server: name gssio1.gpfs.net arch ppc64le model 8247-22L serial 213B99A
  gssio1 Enclosure G59T00Z sees 24 disks (2 SSDs, 22 HDDs)
  gssio1 Enclosure G59P022 sees 24 disks (0 SSDs, 24 HDDs)
  gssio1 Enclosure G5AM00D sees 24 disks (0 SSDs, 24 HDDs)
  gssio1 Enclosure G582L01 sees 24 disks (0 SSDs, 24 HDDs)
  gssio1: GNR server disk topology: ESS GS4 HDD (match: 100/100)
  gssio1: GNR configuration: 4 enclosures, 2 SSDs, 0 empty slots, 96 disks total, 6 NVRAM partitions
  2021-03-10T14:57:19.690596 [INFO] Finish search for missing disk paths. Number of missing disk paths: 0
  [PASS] essfindmissingdisks passed successfully

Location

/opt/ibm/ess/tools/bin