Skip Navigation Links | |
Exit Print View | |
man pages section 1M: System Administration Commands Oracle Solaris 10 8/11 Information Library |
- disk and slot identification utility
/usr/sbin/diskinfo {-a|-e enclosure|-d disk|-C CSN} [-HLpv] [-c i] [-B label] [-b j]
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
One of the following four mutually-exclusive options must be specified:
Probe and report on all attached enclosures.
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.
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.
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:
Limits information to the bay that matches label. This option also requires specifying a CSN (-C) or enclosure path (-e).
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. |
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. |
Displays a brief usage message.
Toggle the Identification LED for the specified disk, or for the specified bay in the enclosure. See NOTES below.
Display physical path mapping for the specified disk. This option is not valid with the -e or -a operating modes.
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.
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
Success. If a disk or enclosure and bay were specified, then the device was located.
Failure. A specified device was not located, or some other error condition occurred.
See attributes(5) for descriptions of the following attributes:
|
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
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.