Skip to ContentSun and Oracle Channel Sun How to Buy Log In

Platform Notes: Using luxadm Software

Contained Within

Find More Documentation

Featured Support Resources

Download this book in PDF

CHAPTER 2

Common Subcommands

Displaying Subsystem Information

Displaying Enclosure or Device Specific Data

Use the display subcommand to display enclosure specific or device specific data.

Enclosure data consists of enclosure environmental sense information and status for all subsystem devices including disks.

Device data consists of inquiry, capacity, and configuration information.


  luxadm [ -v ] display enclosure[,dev]... | pathname...

TABLE 2-1 display

Option/Argument	Description
`-v`	mode sense data is also displayed
*enclosure*	1 is the enclosure name of a Sun Enterprise Network Array .
*dev*	1 is the name of a specific disk in an enclosure .
*pathname*	is the physical or logical path name of a Sun Enterprise Network Array, SPARCstorage Array, or a specific disk in an array¹.

TABLE 2-1 display

Option/Argument	Description
`-p`	displays performance information for the specified device or subsystem
`-r`	displays error information for the specified device or subsystem
1See "Addressing" on page 2".

Example:


  # luxadm display dogbert  
  
                            (luxadm version: 1.23 97/05/22)  
                 SENA  
                                  DISK STATUS  
  SLOT   FRONT DISKS      (Node WWN)          REAR DISKS       (Node WWN)  
  0      On (O.K.)        20000020370412ec    On (O.K.)        200000203704141d  
  1      On (O.K.)        20000020370412e7    On (O.K.)        2000002037041375  
  2      On (O.K.)        2000002037041397    On (O.K.)        20000020370412be  
  3      On (O.K.)        200000203704139f    On (O.K.)        2000002037041433  
  4      On (O.K.)        2000002037041418    On (O.K.)        2000002037041348  
  5      On (O.K.)        200000203704140f    On (O.K.)        2000002037041333  
  6      On (O.K.)        200000203704143d    On (O.K.)        2000002037041382  
                                  SUBSYSTEM STATUS  
  Revision Level: 0.16  Node WWN: 1234123412341234Enclosure Name: dogbert  
  Power Supplies (0,2 in front, 1 in rear)  
       0 O.K.(REV 0)1 O.K.(REV 0)2 O.K.(REV 0)  
  Fans (0 in front, 1 in rear)  
       0 O.K.(REV 0)1 O.K.(REV 0)  
  ESI Interface board(IB) (A top, B bottom)  
       A: O.K. (mmma)  
       GBIC module (1 on left, 0 on right in IB)  
       0 Not Installed1 O.K.(MODn)  
       B: Not Installed  
  Disk backplane (0 in front, 1 in rear)  
       Temperature sensors (on front backplane)  
       0:42.C 1:42.C 2:40.C 3:39.C 4:40.C 5:40.C  
       6:42.C  (All temperatures are NORMAL.)  
       Temperature sensors (on rear backplane)  
       0:43.C 1:42.C 2:42.C 3:40.C 4:42.C 5:42.C  
       6:43.C  (All temperatures are NORMAL.)  
  Loop  configurationThe loop is configured as a single loop.  
  Language                        USA English  
  #

Example:


  # luxadm display -r dogbert  
  
                            (luxadm version: 1.23 97/05/22)  
                 SENA  
       Information for FC Loop on port 0 of SOC+ Host Adapter  
       at path: /devices/sbus@3,0/SUNW,socal@0,0:0  
  Version Resets  Req_Q_Intrpts  Qfulls Requests Sol_Resps Unsol_Resps Lips  
     1         2         0          0        0        0         0         1  
  Els_sent  Els_rcvd  Abts       Abts_ok Offlines Onlines Online_loops  
     0         0         0          0        0        0         1  
       Information from sf driver:  
  Version  Lip_count  Lip_fail Alloc_fail #_cmds Throttle_limit Pool_size  
     1         0         0          0        0      1024         1  
       TARGET ERROR INFORMATION:  
  AL_PA  Els_fail Timouts Abts_fail Tsk_m_fail  Data_ro_mis Dl_len_mis Logouts  
   9e      0         0        0          0           0            0        0  
   b2      0         0        0          0           0            0        0  
   b1      0         0        0          0           0            0        0  
   ae      0         0        0          0           0            0        0  
   ad      0         0        0          0           0            0        0  
   ac      0         0        0          0           0            0        0  
   ab      0         0        0          0           0            0        0  
   aa      0         0        0          0           0            0        0  
    1      0         0        0          0           0            0        0  
   75      0         0        0          0           0            0        0  
   98      0         0        0          0           0            0        0  
   97      0         0        0          0           0            0        0  
   90      0         0        0          0           0            0        0  
   8f      0         0        0          0           0            0        0  
   88      0         0        0          0           0            0        0  
   84      0         0        0          0           0            0        0  
   82      0         0        0          0           0            0        0  
  #

Displaying `inquiry` Information

Use the inquiry subcommand to display inquiry information for a specific disk.


  luxadm [ -v ] inquiry { enclosure[,dev]... | pathname...}

TABLE 2-2 inquiry

Option/Argument	Description
*enclosure*	1 is the enclosure name of a Sun Enterprise Network Array .
*dev*	1 is the name of a specific disk in an enclosure .
*pathname*	is the physical or logical path name of a Sun Enterprise Network Array, SPARCstorage Array, or a specific disk in an array.¹
1See "Addressing" on page 2".

Example:


  # luxadm inquiry dogbert  
  
  INQUIRY:  
    Physical path:  
    /devices/sbus@3,0/SUNW,socal@0,0/sf@0,0/ses@w1234123412341235,0:0  
  Vendor:                     SUN  
  Product:                    SENA  
  Revision:                   0.16  
  Device type:                0xd (Enclosure services device)  
  Removable media:            no  
  Medium Changer Element:     no  
  ISO version:                0  
  ECMA version:               0  
  ANSI version:               3 (Device complies to SCSI-3)  
  Terminate task:             no  
  Response data format:       2  
  Additional length:          0x7b  
  Command queueing:           no  
                VENDOR-SPECIFIC PARAMETERS  
  Byte#                  Hex Value                             ASCII  
  35    12 34 12 34 12 34 12 34 00 00 00 00 00 00 00 00     .4.4.4.4........  
        00 00 00 00                                         ....  
  95    64 6f 67 62 65 72 74 00 00 00 00 00 00 00 00 00     dogbert.........  
        00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00     ................  
  #

Disk LEDs

Displaying the Current State of a Disk LED

Use the led subcommand to display the current state of the yellow LED associated with a specific disk.


  luxadm [ -v ] led { enclosure,dev... | pathname...}

TABLE 2-3 led

Option/Argument	Description
*enclosure*	1 is the enclosure name of a Sun Enterprise Network Array .
*dev*	1 is the name of a specific disk in an enclosure .
*pathname*	1 is the physical or logical path name of a specific disk in an array .
1See "Addressing" on page 2".

Example:


  # luxadm led /devices/sbus@3,0/SUNW,socal@0,0/sf@0,0/  
  ssd@w21000020370412ec,0:c,raw  
  LED state is OFF for device in location: front,slot 0  
  #

Turning Off a Disk LED

Use the led_off subcommand to turn off the yellow LED associated with a specific disk.


  luxadm [ -v ] led_off { enclosure,dev... | pathname...}

TABLE 2-4 led_off

Option/Argument	Description
*enclosure*	1 is the enclosure name of a Sun Enterprise Network Array .
*dev*	1 is the name of a specific disk in an enclosure .
*pathname*	1 is the physical or logical path name of a specific disk in an array .
1 See "Addressing" on page 2".

Note - On a Sun Enterprise Network Array this may or may not cause the yellow LED to turn off or stop blinking depending on the state of the Sun Enterprise Network Array. Refer to Sun Enterprise Network Array Instalationl and Service Manual for details.

Example:


  # luxadm led_off /devices/sbus@3,0/SUNW,socal@0,0/sf@0,0/  
  ssd@w21000020370412ec,0:c,raw  
  LED state is OFF for device in location: front,slot 0  
  #

Disk Operations

Reserving Disks

Use the reserve subcommand to reserve the specified disk(s) for exclusive use by the host from which the subcommand was issued.


  luxadm [ -v ] reserve { enclosure[,dev]... | pathname...}

TABLE 2-5 reserve

Option/Argument	Description
*enclosure*	1 is the enclosure name of a Sun Enterprise Network Array .
*dev*	1 is the name of a specific disk in an enclosure .
*pathname*	is the physical or logical path name of a Sun Enterprise Network Array, SPARCstorage Array, or a specific disk in an array¹.
1 See "Addressing" on page 2".

Releasing Disks

Use the release subcommand to release one or more disk drives from reservation.


  luxadm [ -v ] release { enclosure[,dev]... | pathname...}

TABLE 2-6 release

Option/Argument	Description
*enclosure*	1 is the enclosure name of a Sun Enterprise Network Array .
*dev*	1 is the name of a specific disk in an enclosure .
*pathname*	is the physical or logical path name of a Sun Enterprise Network 1 Array, SPARCstorage Array, or a specific disk in an array .
1 See "Addressing" on page 2".

Other Operations

Downloading Firmware

Use the download subcommand to download a prom image to the FEPROMs on a Sun Enterprise Network Array Interface Board or on a SPARCstorage Array controller board.

In a Sun Enterprise Network Array, when the download is complete, the Sun Enterprise Network Array subsystem will be reset and the downloaded code will be executed.

In a SPARCstorage Array, when the download is complete, you must reset the SPARCstorage Array to execute the downloaded code.


  luxadm [ -v ] download [-s] [-f filename-path ]

Caution - When using the -s option the download modifies the FEPROM in the Sun Enterprise Network Array and should be used with CAUTION.

Note - The -s option does not apply to the SPARCstorage Array controller as it always writes the downloaded firmware into the FEPROM.

TABLE 2-7 download

Option/Argument	Description
`-s`	saves the downloaded firmware in the FEPROM in a Sun Enterprise Network Array. If `-s` is not specified the downloaded firmware will not be saved across power cycles.
`-f filename`	downloads the prom image in filename. If you do not specify a filename, the default prom image will be used. The default prom image in a Sun Enterprise Network Array is in the directory `/usr/lib/locale/C/LC_MESSAGES` and is named `ibfirmware`. The default prom image in a SPARCstorage Array is in the directory `/usr/lib/firmware/ssa` and is named `ssafirmware`.
`-w WWN`	This option is for the SPARCstorage Array only. See "Changing the World Wide Name" on page 33".
1 See "Addressing" on page 2".

Setting the Boot Device Variable

Use the set_boot_dev subcommand to set the boot-device variable in the system PROM to physical device name. The set_boot_device subcommand normally runs interactively; it requests confirmation for setting the default boot-device in the PROM.


  luxadm [ -v ] set_boot_dev [ -y ] pathname

TABLE 2-8 set_boot_dev

Option/Argument	Description
*pathname*	1 is a block special device or a mount-point .
`-y`	runs non-interactively; no confirmation is requested or required.
1 See "Addressing" on page 2".

Powering Off an Enclosure or Disk Drive

Use the power_off subcommand to set an enclosure to the power-save mode.

Note - The Sun Enterprise Network Array disk drives are not available when in the power-save mode.

When an Enclosure Services card in a SPARCstorage Array is addressed, the RSM tray is powered off.

When a disk drive in a Sun Enterprise Network Array is addressed, the drive is set to the drive off/unmated state. When set to the drive off/unmated state, the drive is spun down (stopped) and put in the bypass mode.


  luxadm [ -v ] power_off { enclosure[,dev]... | pathname...}

TABLE 2-9 power_off

Option/Argument	Description
*enclosure*	1 is the enclosure name of a Sun Enterprise Network Array .
*dev*	1 is the name of a specific disk in an enclosure .
*pathname*	is the physical or logical path name of a Sun Enterprise Network Array, SPARCstorage Array, or a specific disk in an array¹.
1 See "Addressing" on page 2".

Contained Within

Find More Documentation

Featured Support Resources

Common Subcommands

Displaying Subsystem Information

Displaying Enclosure or Device Specific Data

Displaying inquiry Information

Disk LEDs

Displaying the Current State of a Disk LED

Turning Off a Disk LED

Disk Operations

Reserving Disks

Releasing Disks

Other Operations

Downloading Firmware

Setting the Boot Device Variable

Powering Off an Enclosure or Disk Drive

Displaying `inquiry` Information