mmlspdisk command

Lists information for one or more IBM Storage Scale RAID pdisks.

Synopsis

mmlspdisk {all | RecoveryGroupName [--declustered-array DeclusteredArrayName | --pdisk pdiskName]}
           [--not-in-use | --not-ok | --replace | --ssd-endurance-percentage PercentageUsedThreshold]

Availability

Available on all IBM Storage Scale editions.

Description

The mmlspdisk command lists information for one or more pdisks, which can be specified in various ways.

Parameters

all | RecoveryGroupName
Specifies the recovery group for which the pdisk information is to be listed.

all specifies that pdisk information for all recovery groups is to be listed.

RecoveryGroupName specifies the name of a particular recovery group for which the pdisk information is to be listed.

--declustered-array DeclusteredArrayName
Specifies the name of a declustered array for which the pdisk information is to be listed.
--pdisk pdiskName
Specifies the name of a single pdisk for which the information is to be listed.
--not-in-use
Indicates that information is to be listed only for pdisks that are draining.
--not-ok
Indicates that information is to be listed only for pdisks that are not functioning correctly.
--replace
Indicates that information is to be listed only for pdisks in declustered arrays that are marked for replacement.
--ssd-endurance-percentage PercentageUsedThreshold
Shows SSDs that have reached or exceeded the specified write endurance PercentageUsedThreshold. The PercentageUsedThreshold must be a number between 0 and 100.
Note: SSDs have a finite lifetime based on the number of drive writes per day. The ssd-endurance-percentage values actually reported will be a number between 0 and 255. This value indicates the percentage of life that is used by the drive. The value 0 indicates that full life remains, and 100 indicates that the drive is at or past its end of life. The drive must be replaced when the value exceeds 100.

Exit status

0
Successful completion.
nonzero
A failure has occurred.

Security

You must have root authority to run the mmlspdisk command.

The node on which the command is issued must be able to execute remote shell commands on any other node in the cluster without the use of a password and without producing any extraneous messages. For additional details, see the following IBM Storage Scale RAID: Administration topic: Requirements for administering IBM Storage Scale RAID.

Examples

  1. The following command example shows how to display the details regarding pdisk c112d3 in recovery group 000DE37BOT: 
    mmlspdisk 000DE37BOT --pdisk c112d3
    The system displays output similar to the following: 
    
pdisk:
  replacementPriority = 1000
  name = "e2s23"
  device = "/dev/sdbs,/dev/sdcq"
  recoveryGroup = "rg0"
  declusteredArray = "p30da_d"
  state = "ok"
  capacity  = 299842404352
  freeSpace = 299573968896
  fru = "49Y1840"
  location = "SX31700361-23"
  WWN = "naa.5000C50067A91EC3"
  server = "perseus30ib.almaden.ibm.com"
  reads = 8
  writes = 5
  bytesReadInGiB = 0.002
  bytesWrittenInGiB = 0.001
  IOErrors = 0
  IOTimeouts = 0
  mediaErrors = 0
  checksumErrors = 0
  pathErrors = 0
  relativePerformance = 1.000
  bitErrorRate = 0.000e+00  
  rgIndex = 46    
  userLocation = ""   
  userCondition = "normal"    
  hardware = "IBM-ESXS ST9300605SS B559 6XP5GQMP0000M338BUSD"    
  hardwareType = Rotating 10000    
  nPaths = 2 active (2 expected) 4 total (4 expected)
  nsdFormatVersion = NSD version 2
  paxosAreaOffset = 600122941440
  paxosAreaSize = 4194304
  logicalBlockSize = 4096
  sedSupported = Yes
  2. To show which pdisks in recovery group 000DE37BOT need replacing: 
    mmlspdisk 000DE37BOT --replace

    The system displays output similar to the following:

    pdisk:
   replacementPriority = 0.98
   name = "c052d1"
   device = "/dev/rhdisk556,/dev/rhdisk460"
   recoveryGroup = "000DE37BOT"
   declusteredArray = "DA1"
   state = "dead/systemDrain/noRGD/noVCD/replace"
   .
   .
   .
pdisk:
   replacementPriority = 0.98
   name = "c096d1"
   device = "/dev/rhdisk508,/dev/rhdisk412"
   recoveryGroup = "000DE37BOT"
   declusteredArray = "DA1"
   state = "dead/systemDrain/noRGD/noVCD/replace"
   .
   .
   .
  3. The following example shows how to display the SSDs in recovery group rgL that have a write endurance percentage that is greater than 50%. Run the following command: 
    mmlspdisk rgL --ssd-endurance-percentage 50

    The system displays output similar to the following:

    
pdisk:
      replacementPriority = 1000
      name = "e2s078"
      device = "//c145f01n03/dev/sdao,//c145f01n03/dev/sdis,//c145f01n04/dev/sdbk(notEnabled)"
      recoveryGroup = "rgL"
      declusteredArray = "DA1"
      .
      .
      .
      nsdFormatVersion = 2
      paxosAreaOffset = 9931033804800
      paxosAreaSize = 4194304
      logicalBlockSize = 4096
      ssdEndurancePercentage = 55       # values range from 0 to 255

See also

See also the following IBM Storage Scale RAID: Administration topics:

Location

/usr/lpp/mmfs/bin