diskinfo

- disk and slot identification utility

Synopsis

/usr/sbin/diskinfo {-a|-e enclosure|-d disk|-C CSN}
     [-HLpv] [-c i] [-B label] [-b j]

Description

The diskinfo command enables a system administrator or suitably privileged user to view the relationship between disk paths and bays (also known as “slots”) for devices that are enumerated by libtopo. These are typically JBODs and direct-attached devices in blade systems.

There are three modes of operation: disk, enclosure, and chassis. Both the disk and enclosure modes require that the user specify a Solaris device name to identify which part of a machine's configuration to report information about. The chassis method requires that the user specify a Chassis Serial Number (CSN). Both the enclosure and chassis modes then allow limiting the output to devices in specific bays of the enclosure.

Various other options can also be specified, to report different levels of detail about the selected devices. This detail might include:

• the list of physical paths to the device

• SCSI Inquiry information

• the silkscreen label

• devid information

Options

One of the following four mutually-exclusive options must be specified:

-a

Probe and report on all attached enclosures.

-d disk

Report which enclosure, subchassis, and bay a specific disk is housed in. The disk name is specified using the cXtYdZ notation or the silkscreen label as reported by libtopo.

-e enclosure

Limit output to bays and disks in a specific enclosure. The enclosure name is specified as /dev/es/sesN when using the ses(7D) driver, or /dev/scsi/ses/cXtY when using the sgen(7D) driver.

-C CSN

Limit output to bays and disks in an enclosure with the specified Chassis Serial Number (CSN). For direct-attached HBAs, this can be a synthetic CSN, composed of the system serial number, then a physical or logical designation, then an instance number. For example: YB09F7-physical-hba-0 or YB09F7-logical-hba-2.

In conjunction with the preceding options, the following options can also be specified:

-B label

Limits information to the bay that matches label. This option also requires specifying a CSN (-C) or enclosure path (-e).

-b j

Limit the reported information to this specific bay number in the specified enclosure. This option is valid only with the -e or -C options.

---

Caution - This option might significantly slow down the response from the utility if the enclosure contains a large number of elements, especially subchassis. If the specified enclosure or CSN has subchassis elements, then the -c argument must also be specified with this option.

---

-c i

For enclosures that utilize subchassis elements, limit the reported information to the specified subchassis. This option is valid only with the -e or -C options.

---

Caution - This option might significantly slow down the response from the utility.

---

-h

Displays a brief usage message.

-L

Toggle the Identification LED for the specified disk, or for the specified bay in the enclosure. See NOTES below.

-p

Display physical path mapping for the specified disk. This option is not valid with the -e or -a operating modes.

-v

Display all available information for the device. All identified paths to the device and target port identifiers will be listed, along with the device devid and SCSI INQUIRY-reported serial number. This option is valid with all the operating modes of -a, -C, -d and -e.

Examples

In some of the following examples, example output wraps in an 80–character-wide display.

Example 1 Determining Which Bay

The following command determines which bay a specific disk resides in.

# /usr/sbin/diskinfo -d c0t5000C5000B2330F7d0

Enclosure path:         /dev/scsi/ses/c11t50016360000AA5FDd0
Chassis Serial Number:  0848QAJ001
Chassis Model:          SUN-Storage-J4200

Label            Disk name               Vendor   Product          Vers
---------------- ----------------------  -------- ---------------- ----
SCSI_Device__4   c0t5000C5000B2330F7d0   SEAGATE  ST330055SSUN300G 0B92

Example 2 Reporting Disks in an Enclosure

The following command reports all the disks within an enclosure.

# /usr/sbin/diskinfo -e YB09F7-physical-hba-1

Enclosure path:         YB09F7-physical-hba-1
Chassis Serial Number:  YB09F7-physical-hba-1
Chassis Model:          SUNW,Sun-Blade-T6360

Label      Disk name               Vendor   Product          Vers
---------- ----------------------  -------- ---------------- ----
/SYS/HDD0  c4t5000CCA00A0D4DE4d0   HITACHI  H103014SCSUN146G A160
/SYS/HDD1  c4t5000C50012EE871Bd0   SEAGATE  ST914603SSUN146G 0768
/SYS/HDD3  c4t5000C5001D0D1B9Fd0   SEAGATE  ST930003SSUN300G 0868

Example 3 Reporting Physical Path Information

The following command reports physical path information for a specific disk.

# /usr/sbin/diskinfo -d c4t5000C50012EE871Bd0 -p

Enclosure path:         YB09F7-physical-hba-1
Chassis Serial Number:  YB09F7-physical-hba-1
Chassis Model:          SUNW,Sun-Blade-T6360

Label      Disk name               Vendor   Product          Vers
---------- ----------------------  -------- ---------------- ----
/SYS/HDD1  c4t5000C50012EE871Bd0   SEAGATE  ST914603SSUN146G 0768
        Physical path
        --------------------------------
        0: /pci@400/pci@1/pci@0/pci@2/LSI,sas@0/iport@2/disk@w5000c\
           50012ee8719,0

Example 4 Reporting All Information

The following command reports all information for a specific disk.

# /usr/sbin/diskinfo -d c0t5000C50002FB6823d0 -v

Enclosure path:         /dev/es/ses6
Chassis Serial Number:  0818QAJ002
Chassis Model:          SUN-Storage-J4200

Label            Disk name               Vendor   Product          Vers
---------------- ----------------------  -------- ---------------- ----
SCSI_Device__0   c0t5000C50002FB6823d0   SEAGATE  ST314655SSUN146G 0B92
        Physical path
        --------------------------------
        0: /pci@0,0/pci10de,5d@d/pci11f8,8001@0/iport@f/disk@w5000c\
           50002fb6821,0
        1: /pci@7b,0/pci10de,5d@d/pci11f8,8001@0/iport@f/disk@w5000c\
           50002fb6822,0
        2: /pci@0,0/pci10de,5d@d/pci11f8,8001@0/iport@f0/disk@w5000c\
           50002fb6822,0
        3: /pci@7b,0/pci10de,5d@d/pci11f8,8001@0/iport@f0/disk@w5000c\
           50002fb6821,0

        Target port ident
        --------------------
        0: w5000c50002fb6821
        1: w5000c50002fb6821
        2: w5000c50002fb6822
        3: w5000c50002fb6822

        devid
        --------------------------------
        id1,sd@n5000c50002fb6823

        Inquiry Serial Number
        --------------------------------
        0807S47FQP        3LN47FQP

Example 5 Reporting Information for a Subchassis/Disk

The following command reports all information for a disk in a specific subchassis.

# /usr/sbin/diskinfo -e /dev/es/ses61 -c 10 -b 23 -v

Enclosure path:         /dev/es/ses61
Chassis Serial Number:  50800207e4828000
Chassis Model:          SUN-GENESIS


Label                Disk name              Vendor   Product         Vers
-------------------  ---------------------- -------- --------------- ----
DRIVE_SET_10_HDD_23  c0t5000C50003586473d0  SEAGATE  ST34008SSUN0.4T 0543
        Physical path
        --------------------------------
        0: /pci@77,0/pci8086,3410@9/pci11f8,8001@0/iport@f/disk@w5000c\
           50003586471,0
        1: /pci@77,0/pci8086,340e@7/pci11f8,8001@0/iport@f/disk@w5000c\
           50003586472,0

        Target port ident
        --------------------
        0: w5000c50003586471
        1: w5000c50003586472

        devid
        --------------------------------
        id1,sd@n5000c50003586473

        Inquiry Serial Number
        --------------------------------
        0818X0JX2Q        3RJ0JX2Q

Example 6 Reporting on Disks Attached to a Controller

The following command reports on all disks attached to a physical controller.

# /usr/sbin/diskinfo -C YB09F7-physical-hba-1

Enclosure path:         YB09F7-physical-hba-1
Chassis Serial Number:  YB09F7-physical-hba-1
Chassis Model:          SUNW,Sun-Blade-T6360

Label      Disk name               Vendor   Product          Vers
---------- ----------------------  -------- ---------------- ----
/SYS/HDD0  c4t5000CCA00A0D4DE4d0   HITACHI  H103014SCSUN146G A160
/SYS/HDD1  c4t5000C50012EE871Bd0   SEAGATE  ST914603SSUN146G 0768
/SYS/HDD3  c4t5000C5001D0D1B9Fd0   SEAGATE  ST930003SSUN300G 0868

Exit Status

0

Success. If a disk or enclosure and bay were specified, then the device was located.

1

Failure. A specified device was not located, or some other error condition occurred.

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

cfgadm(1M), fmd(1M), attributes(5), mpt(7D), mpt_sas(7D), ses(7D), sgen(7D)

The SCSI Storage Interfaces committee website, http://www.t10.org

SCSI Primary Commands-4, SPC4; SCSI Enclosure Services-2; SES2, Serial Attached SCSI-2, SAS2

Notes

The enumeration libraries that /usr/sbin/diskinfo depends on require that enclosures behave in a standards-compliant (SPC4 and SES2) fashion. Enclosures that do not respond appropriately might not report slots or disk nodes to FMA correctly. Specifically, diskinfo requires that enclosures support SES diagnostic page 0xa (Additional Element Status) and set the Element Index Present (EIP) bit to 1. Enclosures that do not meet this criteria are not enumerable and will not be properly visible with FMA or /usr/sbin/diskinfo.

LED support is not included in the initial integration of this utility.