Sun Microsystems, Inc.  Oracle System Handbook - ISO 7.0 May 2018 Internal/Partner Edition
   Home | Current Systems | Former STK Products | EOL Systems | Components | General Info | Search | Feedback

Asset ID: 1-79-1565521.1
Update Date:2016-11-28
Keywords:

Solution Type  Predictive Self-Healing Sure

Solution  1565521.1 :   Sun Fire X4500/X4540 Hard Disk Suite (SUNWhd) and hdtool  


Related Items
  • Sun Fire X4540 Server
  •  
  • Sun Fire X4500 Server
  •  
Related Categories
  • PLA-Support>Sun Systems>x86>Server>SN-x64: AMD-STOR-SERVER
  •  




Applies to:

Sun Fire X4500 Server - Version Not Applicable and later
Sun Fire X4540 Server - Version Not Applicable and later
Information in this document applies to any platform.

Purpose

This document contains details about the Sun Fire X4500/X4540 Hard Disk Suite (the SUNWhd package) and/or the hdtool.

    Solaris (SUNWhd)
    Linux (hdtool)
    Microsoft Windows (hdtool)

Note:  The feature set for each OS version differs.  Be sure to read the README files as well as the documention that is specific for your OS.

Details


SUNWhd (Solaris)

The SUNWhd package adds the useful "hd" command.

"hd" is a hard drive logical/physical location mapping/query utility primary for x64/Sun Fire X4500/X4540 system. The x64/Sun Fire X4500/X4540 system supports 48 internal SATA drives in the system. The "hd" output enables user to locate all the disks in the Sun Fire X4500/X4540 system visually based on the physical topology of the Sun Fire X4500/X4540 drives. The" hd"'s SATA drive mapping outputs are what you see is what you get (WYSIWYG) on the Sun Fire X4500/X4540's physical location of the drives.

Note:  SUNWhd was factory installed on all x4500 and x4540 systems shipped.

If you need to reinstall SUNWhd, it is located on the following Tools & Drivers CDs:

For x4500 download: Patch 10335199: X4500 SW 1.6 - Tools and Drivers
For x4540 download: Patch 10371561: X4540 SW 2.3 - Tools & Drivers

 

Here is the Tools and Drivers README file for the Solaris version:

Solaris hdtool Directory

This directory contains Solaris hdtool package used with the Sun Fire™ X4540/X4500 server for Software Release 2.0.

Here is the package:

  • hdtool: Hard Drive mapping utility for Sun Fire X4540/X4500 server SUNWhd-1.07.pkg.

Using Solaris hdtool :

1. To install
	# pkgadd -d ./SUNWhd-1.07.pkg
2. To remove "SUNWhd" package
	# pkgrm SUNWhd
3. To use hd
	# hd -c
4. More info:
	# hd -h
   Look at :
	/opt/SUNWhd/hd/bin/hdadm.html  
	/opt/SUNWhd/hd/bin/hd.html


Two useful Solaris command outputs are hd and hd -i.

The Solaris storage devices have different logical name. The -i option lists (maps) cXtY, sd# and PCI path each storage device.
The last part of hd command (without any options) will show the ASCII character map slot locations along with the cXtY names.

Using the output from both commands we can determine the chassis slot location no matter if we have the cXtY name, the sd# name, or the PCI path.

Looking at both outputs below, for example we can tell:

The disk c3t7 is located in slot #37
The disk c4t6 is located in slot #31
The disk sd37 maps to c2t7 and is located in slot #39
The disk sd16 maps to c1t1 and is located in slot #20
The disk with device path /pci@2,0/pci1022,7458@8/pci11ab,11ab@1/disk@1,0 maps to sd6 (which maps to c5t1) and is located in slot #16
The disk with device path /pci@1,0/pci1022,7458@3/pci11ab,11ab@1/disk@4,0 maps to sd20 (which maps to c2t4) and is located in slot #3

# hd

platform = Sun Fire X4500

[some output has been snip'd]

---------------------SunFireX4500------Rear----------------------------
36:   37:   38:   39:   40:   41:   42:   43:   44:   45:   46:   47:
c3t3  c3t7  c2t3  c2t7  c5t3  c5t7  c4t3  c4t7  c1t3  c1t7  c0t3  c0t7
^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++
24:   25:   26:   27:   28:   29:   30:   31:   32:   33:   34:   35:
c3t2  c3t6  c2t2  c2t6  c5t2  c5t6  c4t2  c4t6  c1t2  c1t6  c0t2  c0t6
^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++
12:   13:   14:   15:   16:   17:   18:   19:   20:   21:   22:   23:
c3t1  c3t5  c2t1  c2t5  c5t1  c5t5  c4t1  c4t5  c1t1  c1t5  c0t1  c0t5
^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++
 0:    1:    2:    3:    4:    5:    6:    7:    8:    9:   10:   11:
c3t0  c3t4  c2t0  c2t4  c5t0  c5t4  c4t0  c4t4  c1t0  c1t4  c0t0  c0t4
^b+   ^b+   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++
-------*-----------*-SunFireX4500--*---Front-----*-----------*----------

# hd -i
c3t0d0 sd2 /pci@1,0/pci1022,7458@4/pci11ab,11ab@1/disk@0,0
c3t1d0 sd7 /pci@1,0/pci1022,7458@4/pci11ab,11ab@1/disk@1,0
c3t2d0 sd13 /pci@1,0/pci1022,7458@4/pci11ab,11ab@1/disk@2,0
c3t3d0 sd19 /pci@1,0/pci1022,7458@4/pci11ab,11ab@1/disk@3,0
c3t4d0 sd25 /pci@1,0/pci1022,7458@4/pci11ab,11ab@1/disk@4,0
c3t5d0 sd31 /pci@1,0/pci1022,7458@4/pci11ab,11ab@1/disk@5,0
c3t6d0 sd36 /pci@1,0/pci1022,7458@4/pci11ab,11ab@1/disk@6,0
c3t7d0 sd42 /pci@1,0/pci1022,7458@4/pci11ab,11ab@1/disk@7,0
c1t0d0 sd9 /pci@0,0/pci1022,7458@2/pci11ab,11ab@1/disk@0,0
c1t1d0 sd16 /pci@0,0/pci1022,7458@2/pci11ab,11ab@1/disk@1,0
c1t2d0 sd22 /pci@0,0/pci1022,7458@2/pci11ab,11ab@1/disk@2,0
c1t3d0 sd28 /pci@0,0/pci1022,7458@2/pci11ab,11ab@1/disk@3,0
c1t4d0 sd34 /pci@0,0/pci1022,7458@2/pci11ab,11ab@1/disk@4,0
c1t5d0 sd39 /pci@0,0/pci1022,7458@2/pci11ab,11ab@1/disk@5,0
c1t6d0 sd43 /pci@0,0/pci1022,7458@2/pci11ab,11ab@1/disk@6,0
c1t7d0 sd46 /pci@0,0/pci1022,7458@2/pci11ab,11ab@1/disk@7,0
c4t0d0 sd3 /pci@2,0/pci1022,7458@7/pci11ab,11ab@1/disk@0,0
c4t1d0 sd4 /pci@2,0/pci1022,7458@7/pci11ab,11ab@1/disk@1,0
c4t2d0 sd11 /pci@2,0/pci1022,7458@7/pci11ab,11ab@1/disk@2,0
c4t3d0 sd17 /pci@2,0/pci1022,7458@7/pci11ab,11ab@1/disk@3,0
c4t4d0 sd23 /pci@2,0/pci1022,7458@7/pci11ab,11ab@1/disk@4,0
c4t5d0 sd29 /pci@2,0/pci1022,7458@7/pci11ab,11ab@1/disk@5,0
c4t6d0 sd35 /pci@2,0/pci1022,7458@7/pci11ab,11ab@1/disk@6,0
c4t7d0 sd41 /pci@2,0/pci1022,7458@7/pci11ab,11ab@1/disk@7,0
c5t0d0 sd1 /pci@2,0/pci1022,7458@8/pci11ab,11ab@1/disk@0,0
c5t1d0 sd6 /pci@2,0/pci1022,7458@8/pci11ab,11ab@1/disk@1,0
c5t2d0 sd12 /pci@2,0/pci1022,7458@8/pci11ab,11ab@1/disk@2,0
c5t3d0 sd18 /pci@2,0/pci1022,7458@8/pci11ab,11ab@1/disk@3,0
c5t4d0 sd24 /pci@2,0/pci1022,7458@8/pci11ab,11ab@1/disk@4,0
c5t5d0 sd30 /pci@2,0/pci1022,7458@8/pci11ab,11ab@1/disk@5,0
c5t6d0 sd38 /pci@2,0/pci1022,7458@8/pci11ab,11ab@1/disk@6,0
c5t7d0 sd44 /pci@2,0/pci1022,7458@8/pci11ab,11ab@1/disk@7,0
c2t0d0 sd0 /pci@1,0/pci1022,7458@3/pci11ab,11ab@1/disk@0,0
c2t1d0 sd5 /pci@1,0/pci1022,7458@3/pci11ab,11ab@1/disk@1,0
c2t2d0 sd10 /pci@1,0/pci1022,7458@3/pci11ab,11ab@1/disk@2,0
c2t3d0 sd15 /pci@1,0/pci1022,7458@3/pci11ab,11ab@1/disk@3,0
c2t4d0 sd20 /pci@1,0/pci1022,7458@3/pci11ab,11ab@1/disk@4,0
c2t5d0 sd26 /pci@1,0/pci1022,7458@3/pci11ab,11ab@1/disk@5,0
c2t6d0 sd32 /pci@1,0/pci1022,7458@3/pci11ab,11ab@1/disk@6,0
c2t7d0 sd37 /pci@1,0/pci1022,7458@3/pci11ab,11ab@1/disk@7,0
c0t0d0 sd8 /pci@0,0/pci1022,7458@1/pci11ab,11ab@1/disk@0,0
c0t1d0 sd14 /pci@0,0/pci1022,7458@1/pci11ab,11ab@1/disk@1,0
c0t2d0 sd21 /pci@0,0/pci1022,7458@1/pci11ab,11ab@1/disk@2,0
c0t3d0 sd27 /pci@0,0/pci1022,7458@1/pci11ab,11ab@1/disk@3,0
c0t4d0 sd33 /pci@0,0/pci1022,7458@1/pci11ab,11ab@1/disk@4,0
c0t5d0 sd40 /pci@0,0/pci1022,7458@1/pci11ab,11ab@1/disk@5,0
c0t6d0 sd45 /pci@0,0/pci1022,7458@1/pci11ab,11ab@1/disk@6,0
c0t7d0 sd47 /pci@0,0/pci1022,7458@1/pci11ab,11ab@1/disk@7,0

It may be helpful to see the first two disk in the above example highlighted in the hd output,
so here is disk c3t7 in slot #37 (blue) and disk c4t6 located in slot #31 (red):

Disk Locations


For additional information on SUNWhd for Solaris, refer to the following:

x64 Servers Utilities Reference Manual

     "hd Utility", here:  http://docs.oracle.com/cd/E19469-01/820-1120-22/chapter1.html#CEHIAJFE
and
     Chapter 2 "Using the hd Utility on Solaris OS 10" here:  http://docs.oracle.com/cd/E19469-01/820-1120-22/chapter2.html#CGFCCDIJ   

There is also a small bit of information in the install directory of the Tools & Drives CD.  Look in the ..\solaris\tools\hdtool directory.

Once you install the SUNWhd package you can use hd -h for a brief description of the options:

# hd -h

 Usage: hd [ -c(olor mode) ] [ -s(ummary) ] [ -p(latform) ]
 [ -b(ypass) to print SunFireX4500 map ]
 [ -d(iagnose)] [-f { syslog_file } ]
 [ -m { adjacent | cross | front2back | diagonal } Mapping pairs ]
 [ -w { <pci_disk_device_path> } ]
 [ -a (fdisk pArtition type) ]
 [ -q (list drive slot number in seQuential list) ]
 [ -g (list drive slot number in seQuential list with temperature ) ]
 [ -l (List SunFireX4500/X4540 available disk in physical orders) ]
 [ -r (List SMART data for all disks in drive slot number) ]
 [ -R (List SMART data's individual id in landscape view for all disks) ]
 [ -e <cXtY> (List SMART data for specified disk) ]
 [ -E <cXtY> (List raw hex SMART data for specified disk) ]
 [ -j (List SunFireX4500/X4540 HBA controller numbers and pci nodes) ]
 [ -T (List vtoc for all drives for SunFireX4500/X4540 platform) ]
 [ -t (List vtoc for specified drives) ]
 [ -i (List cXtY, sd# and PCI path) ]
 [ -o (List LSI HBA#, Drive Target# and cXtY) ]
 [ -x (Generate hd_map.html) ]


Lastly, a traditional man page was never created for hd, however an html version was.
Look at
   /opt/SUNWhd/hd/bin/hd.html


hdtool (Linux)

For additional information on the Linux version of hd, refer to the x64 Servers Utilities Reference Manual:

    "hd utility"  here:  http://docs.oracle.com/cd/E19469-01/820-1120-22/chapter1.html#CEHIAJFE

and 

    Chapter 4 "Using the hd utility on Linux"  here:  http://docs.oracle.com/cd/E19469-01/820-1120-22/chapter4.html#BBJGBFHF

    Chapter 4 includes the following sections:

    Installing the hd Utility

    Running the hd Utility on Linux

    Viewing the hd Utility Drive Mapping Output

    Viewing the Hard Drives in Sequential Order

    Configuring Offline and Online Hard Disk Drives Using the hdadm Command

    Examples Using the hdadm Command

 

There are the four README files that exist for Linux located on the The Tools and Drivers CD:

   Linux SLES11 hdtool Directory
   Linux SLES10 hdtool Directory
   Linux RHEL5 hdtool Directory
   Linux HREL4 hdtool Directory

Each README files will contains install instructions, for example here is the RHEL5 README file:

Install hd-1.08-2.x86_64.rpm.
    # cd
    # rpm -i hd-1.08-2.x86_64.rpm

To find out the rpm package for "hd"
    # rpm -qf /usr/bin/hd
    hd-1.08-2

To find out the file list in "hd" package
    # rpm -ql hd-1.08-2
    /usr/bin/hd
    /usr/bin/hdadm
    /usr/share/doc/hd-1.08
    /usr/share/doc/hd-1.08/ChangeLog
    /usr/share/doc/hd-1.08/README
    /usr/share/man/man1/hd.1.gz
    /usr/share/man/man1/hdadm.1.gz

To remove "hd-1.08-2" package
    # rpm -e hd-1.08-2

To use hd
   # hd

 
Each README files also contain examples of useful commands, for example:

# hd
---------------------SunFireX4500------Rear----------------------------
36:   37:   38:   39:   40:   41:   42:   43:   44:   45:   46:   47:
sdab  sdaf  sdt   sdx   sdar  sdav  sdaj  sdan  sdl   sdp   sdd   sdh
^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++
24:   25:   26:   27:   28:   29:   30:   31:   32:   33:   34:   35:
sdaa  sdae  sds   sdw   sdaq  sdau  sdai  sdam  sdk   sdo   sdc   sdg
^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++
12:   13:   14:   15:   16:   17:   18:   19:   20:   21:   22:   23:
sdz   sdad  sdr   sdv   sdap  sdat  sdah  sdal  sdj   sdn   sdb   sdf
^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++
 0:    1:    2:    3:    4:    5:    6:    7:    8:    9:   10:   11:
sdy   sdac  sdq   sdu   sdao  sdas  sdag  sdak  sdi   sdm   sda   sde
^b+   ^b+   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++
-------*-----------*-SunFireX4500--*---Front-----*-----------*----------


# hd -q     
 0    sdy    present
 1    sdac   present
 2    sdq    present
 3    sdu    present
 4    sdao   present
 5    sdas   present
 6    sdag   present
 7    sdak   present
 8    sdi    present
 9    sdm    present
10    sda    present
11    sde    present
12    sdz    present
13    sdad   present
14    sdr    present
15    sdv    present
16    sdap   present
17    sdat   present
18    sdah   present
19    sdal   present
20    sdj    present
21    sdn    present
22    sdb    present
23    sdf    present
24    sdaa   present
25    sdae   present
26    sds    present
27    sdw    present
28    sdaq   present
29    sdau   present
30    sdai   present
31    sdam   present
32    sdk    present
33    sdo    present
34    sdc    present
35    sdg    present
36    sdab   present
37    sdaf   present
38    sdt    present
39    sdx    present
40    sdar   present
41    sdav   present
42    sdaj   present
43    sdan   present
44    sdl    present
45    sdp    present
46    sdd    present
47    sdh    present
#


# hd -B    (provide bootable physical slot number, logical name and status)
 0    sdy   present
 1    sdac   present


# hdadm display

---------------------SunFireX4500------Rear----------------------------
36:   37:   38:   39:   40:   41:   42:   43:   44:   45:   46:   47:
sdab  sdaf  sdt   sdx   sdar  sdav  sdaj  sdan  sdl   sdp   sdd   sdh
^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++
24:   25:   26:   27:   28:   29:   30:   31:   32:   33:   34:   35:
sdaa  sdae  sds   sdw   sdaq  sdau  sdai  sdam  sdk   sdo   sdc   sdg
^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++
12:   13:   14:   15:   16:   17:   18:   19:   20:   21:   22:   23:
sdz   sdad  sdr   sdv   sdap  sdat  sdah  sdal  sdj   sdn   sdb   sdf
^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++
 0:    1:    2:    3:    4:    5:    6:    7:    8:    9:   10:   11:
sdy   sdac  sdq   sdu   sdao  sdas  sdag  sdak  sdi   sdm   sda   sde
^b+   ^b+   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++   ^++
-------*-----------*-SunFireX4500--*---Front-----*-----------*----------

 


 hdtool (MS windows)

   For additional information on the Microsoft Windows version of hd, refer to the x64 Servers Utilities Reference Manual:

    "hd utility"  here:  http://docs.oracle.com/cd/E19469-01/820-1120-22/chapter1.html#CEHIAJFE

and 

    Chapter 3 "Using the hd utility on Windows 2003"  here:  http://docs.oracle.com/cd/E19469-01/820-1120-22/chapter3.html#CGFFEDAE

Chapter 3 includes the following sections:

    Installing the hd Utility on Windows

    Running the hd Utility on Windows

    Starting the hd Utility Command Line

    hd Command Options and Parameters

    Viewing the hd Utility Drive Mapping Output

There are several README files on the Tools and Drivers CD in the ..\windows\ directory, one for each supported version of Windows.

As an example, here is the w2k8 README file:

This directory contains Windows hdtool package used with the Sun Fire™ X4540 server.

Here is the package:

  • hdtool: Hard Drive mapping utility for Sun Fire X4540 server hd1.08_pkg.zip.

Using Windows hdtool :

1. To install Sun hd Tool on Windows2008/Windows2003 : 
	* Click on "hd1.08.msi" package.

2. To uninstall Sun hdtool:
   Windows2008 :
   - Start->All Programs->Contol Panel->"Program And Features"->
       ->Sun HD Tool-> Uninstall

   Windows2003 :
    - Start->All Programs->Contol Panel->Add or Remove Programs
        ->Sun HD Tool-> Remove

3. To run Sun hd Tool via Windows "Start" menu or Desktop.
	Start->All Program->Sun HD Tool->hdtool
   This will bring up a "Command Prompt" automatically,
   and run "hd".
4. More info:
	# hd -h 

End of Document

 

References

<NOTE:1368404.1> - Sun Fire X4540 - Decoding Disk device path to Physical disk slot numbers

Attachments
This solution has no attachment
  Copyright © 2018 Oracle, Inc.  All rights reserved.
 Feedback