InfoDoc ID   Synopsis   Date
16735   Mapping Between Logical and Physical Device Names on Ultra 450   27 Aug 2001

Status Issued

Description
Mapping Between Logical and Physical Device Names on Ultra 450

     Procedure for translating between the various
     logical and physical names used to identify internal disk drives in a
     Sun Ultra 450 workstation or Ultra Enterprise 450 server

     Both the Sun Ultra 450 workstation and the Ultra Enterprise 450 server
     can accommodate up to 20 internal UltraSCSI disk drives. Each drive is
     labeled with a disk slot number between 0 and 19.

-----------------------------------------------------------------------

Configuring Disk slot Associations

The procedures assumes that the NVRAM parameter disk_led_assoc is correctly 
set to match the location of any PCI UltraSCSI controller cards that control 
the internal disk drives in your system.

In order to make this association you must follow the steps below.

1.  Power on the system.
2.  When the system banner is displayed on the monitor, immediately enter 
    the Stop-a sequence on the Sun keyboard.
3.  When the ok prompt is displayed, enter the following command:
  
    OK setenv disk-led-assoc 0 x y 

        x is an integer between 1 and 10 identifying the rear panel PCI slot 
          number where the lower UltraSCSI controller is installed 
        y is an integer between 1 and 10 identifying the rear panel PCI slot
          number where the upper UltraSCSI controller is installed 

    For example, if the controller cards are installed in PCI slots 5 and 7, 
    enter the following:

     ok setenv disk-led-assoc 0 5 7  

4.  Enter a reset command at the ok prompt
5.  When the system banner is displayed on the monitor, immediately enter 
    the Stop-a sequence on the Sun keyboard.
6.  Enter the following command to perform a reconfiguration boot:

    OK boot -r

This command rebuilds the device trees for the system, incorporating any 
newly installed options. After a device has been added to a device tree,
it can be recognized by the system. After the reconfiguration reboot has 
successfully completed, the system prompt is displayed.

-----------------------------------------------------------------------

Mapping From Error Message to Disk Slot Number and UNIX Logical Name

     How to translate a UNIX physical device name provided in a SCSI error 
     message to a UNIX logical device name and a disk slot number.

     1.  Determine the UNIX physical device name from the SCSI error message.

         SCSI error messages are typically displayed in the system console
         and logged in the /usr/adm/messages file.

         WARNING: /pci@6,4000/scsi@4,1/sd@3,0 (sd228)
         Error for Command: read(10)     Error level: Retryable
         Requested Block: 3991014        Error Block: 3991269
         Vendor: FUJITSU                 Serial Number: 9606005441
         Sense Key: Media Error
         ASC: 0x11 (unrecovered read error), ASCQ: 0x0, FRU: 0x0

     In the example SCSI error message above, the UNIX physical device name
     is /pci@6,4000/scsi@4,1/sd@3.

     2. Determine the UNIX logical device name by listing the contents of
        the /dev/rdsk directory.

        Use the grep command to filter the output for any occurrence of
        the UNIX physical device name determined in Step 1:

        % ls -l /dev/rdsk | grep /pci@6,4000/scsi@4,1/sd@3
        lrwxrwxrwx   1 root     root        45 Jan 30 09:07 c12t3d0s0 ->
        ../../devices/pci@6,4000/scsi@4,1/sd@3,0:a,raw
        lrwxrwxrwx   1 root     root        45 Jan 30 09:07 c12t3d0s1 ->
        ../../devices/pci@6,4000/scsi@4,1/sd@3,0:b,raw
        lrwxrwxrwx   1 root     root        45 Jan 30 09:07 c12t3d0s2 ->
        ../../devices/pci@6,4000/scsi@4,1/sd@3,0:c,raw
        lrwxrwxrwx   1 root     root        45 Jan 30 09:07 c12t3d0s3 ->
        ../../devices/pci@6,4000/scsi@4,1/sd@3,0:d,raw
        lrwxrwxrwx   1 root     root        45 Jan 30 09:07 c12t3d0s4 ->
        ../../devices/pci@6,4000/scsi@4,1/sd@3,0:e,raw
        lrwxrwxrwx   1 root     root        45 Jan 30 09:07 c12t3d0s5 ->
        ../../devices/pci@6,4000/scsi@4,1/sd@3,0:f,raw
        lrwxrwxrwx   1 root     root        45 Jan 30 09:07 c12t3d0s6 ->
        ../../devices/pci@6,4000/scsi@4,1/sd@3,0:g,raw
        lrwxrwxrwx   1 root     root        45 Jan 30 09:07 c12t3d0s7 ->
        ../../devices/pci@6,4000/scsi@4,1/sd@3,0:h,raw

     The resulting output indicates the associated UNIX logical device name.
     In this example, the logical device name is c12t3d0.

     3. Determine the disk slot number using the prtconf command.

        Substitute the string disk@ for sd@ in the physical device name
        determined in Step 1. The result in this example is
        /pci@6,4000/scsi@4,1/disk@3.

        Use the grep command to find this name in the output of the
        prtconf command:

        % prtconf -vp | grep /pci@6,4000/scsi@4,1/disk@3
          slot#11:  '/pci@6,4000/scsi@4,1/disk@3'                  
   NOTE! When using the "format" command you will need to type "/sd@3,0" in place 
         of "/disk@3".
     
         # format /pci@6,4000/scsi@4,1/sd@3,0

     The resulting output indicates the corresponding disk slot number. In
     this example, the disk slot number is 11.

     If the output does not provide a slot number, the device is either a
     removable media device (CD-ROM or tape drive), an external device
     or the disk-led-assoc openboot PROM parameter is not set correctly.
     
------------------------------------------------------------------------

From: Platform Notes: Sun Ultra 450 Workstation and Ultra Enterprise
450 Server                  
SUBMITTER: Dan Auga APPLIES TO: Hardware/Ultra Enterprise/Servers/Enterprise 450, Operating Systems/Solaris/Solaris 2.x, AFO Vertical Team Docs/Hardware ATTACHMENTS:


Copyright (c) 1997-2003 Sun Microsystems, Inc.