Platform Notes: Using luxadm Software
  Искать только в названиях книг
Загрузить это руководство в формате PDF
CHAPTER 1

Using the luxadm Command



The luxadm Command

The luxadm program is an administrative command that manages both the Sun Enterprise Network Array and SPARCstorage Array subsystems. luxadm performs a variety of control and query tasks, depending on the command line arguments and options used.

Synopsis

The command line must contain a subcommand.

  luxadm [options] subcommand [options] {enclosure[,dev]... |  
  pathname...}  

You may also enter options, usually at least one enclosure name or pathname, and other parameters depending on the subcommand.You specify a device by entering a physical path name, or a logical path name. See "Addressing".
You only need to enter as many characters as are required to uniquely identify a subcommand. For example, to run the display subcommand on an enclosure named box1, you could enter:

  #luxadm disp box1  


Addressing

Addressing a Sun Enterprise Network Array

Pathname

Either a complete physical path name or a complete logical path name may be entered to specify the device or controller. A typical physical path name for a Sun Enterprise Network Array device is:

  /devices/sbus@1f,0/SUNW,socal@1,0/sf@0,0/  
  ssd@w2200002037000f96,0:a,raw  

or

  /devices/io-unit@f,e0200000/sbi@0,0/SUNW,socal@2,0/sf@0,0/  
  ssd@34,0:a,raw  

For all Sun Enterprise Network Array IBs (Interface Boards) on the system, a logical link to the physical paths is kept in the directory /dev/es. An example of a logical link is /dev/es/ses0.

Enclosure

For the Sun Enterprise Network Array subsystem, the WWN may be used in place of the pathname to select a device or the Sun Enterprise Network Array subsystem Interface Board. The WWN is a unique 16 digit hexadecimal value that specifies either the port used to access the device or the device itself. A typical WWN value is: 2200002037000f96.
Or you can specify the name of the Sun Enterprise Network Array enclosure and an identifier for the particular device in the enclosure. A device in a Sun Enterprise Network Array enclosure is identified as followe;

  BOX_NAME,[f|r]slot_number  

where:
TABLE 1-1
Options/ArgumentsDescription
BOX_NAMEis the name of the Sun Enterprise Network Array enclosure,
as specified by the enclosure_name subcommand
f or rspecifies the front or rear slots in the Sun Enterprise Network Array enclosure
slot_numberis the slot number in the Sun Enterprise Network Array enclosure, 0-6 or 0-10
When addressing the Sun Enterprise Network Array subsystem the pathname or enclosure name specifies the Sun Enterprise Network Array Interface Board (IB).

Addressing a SPARCstorage Array

When addressing the SPARCstorage Array, the pathname specifies the SPARCstorage Array controller or a disk in the SPARCstorage Array. The controller name is specified by its physical name, for example

  /devices/.../.../SUNW,soc@3,0/SUNW,pln@axxxxxxx,xxxxxxxx:ctlr  

or by a name of the form cN, where N is the logical controller number. luxadm uses the cN name to find an entry in the /dev/rdsk directory of a disk that is attached to the SPARCstorage Array controller. The /dev/rdsk entry is then used to determine the physical name of the SPARCstorage Array controller. A disk in the SPARCstorage Array is specified by its logical or physical device name, for example,

  /dev/rdsk/c1t0d0s2  

or

  /devices/.../.../SUNW,soc@3,0/SUNW,pln@axxxxxxx,xxxxxxxx/  
  ssd@0,0:c,raw  

See the disks(1M) and devlinks(1M) manpages for more information on logical names for disks and subsystems.

Addressing a SPARCstorage RSM Tray

When addressing the SPARCstorage RSM tray, the pathname specifies the controller or a disk in the SPARCstorage RSM tray. The controller name is specified by its physical name, for example

  /devices/sbus@1f,0/QLGC,isp@1,10000/sd@8,0:c,raw  

or by a name of the form cN, where N is the logical controller number. luxadm uses the cN name to find an entry in the /dev/rdsk directory of a disk that is attached to the SPARCstorage Array controller. The /dev/rdsk entry is then used to determine the physical name of the controller. A disk in the SPARCstorage RSM tray is specified by its logical or physical device name, for example,

  /dev/rdsk/c2t8d0s2  

See the disks(1M) and devlinks(1M) manpages for more information on logical names for disks and subsystems.

Subcommand Support Matrix

The following table lists the luxadm subcommands that are supported on the Sun Enterprise Network Array, the SPARCstorage Array, and SPARCstorage RSM trays. Subcommands that are preceded by -e are expert mode subcommands and should only be used by qualified system personnel.
TABLE 1-2
SubcommandSun Enterprise Network ArraySPARCstorage ArraySparcstorage RSMpage
alarm_off--yesyespage 22
alarm_on--yesyespage 23
alarm_set--yesyespage 23
-e bus_getstate------page 61
-e bus_quiesce------page 61
-e bus_reset------page 61
-e bus_resetall------page 61
-e bus_unquiesce------page 61
-e dev_getstate------page 61
-e dev_reset------page 61
displayyesyes--page 12
downloadyesyes--page 17
enclosure_nameyes----page 24
env_display----yespage 21
fast_write--yes--page 30
fc_s_download--yes--page 19
fcal_s_downloadyes----page 20
-e forcelipyes----page 61
inquiryyesyesyespage 15
insert_deviceyes--yespage 36
ledyesyesyespage 7
led_blinkyes----page 8
TABLE 1-2
SubcommandSun Enterprise Network ArraySPARCstorage ArraySparcstorage RSMpage
led_offyesyes--page 9
led_on--yesyespage 10
nvram_data--yes--page 31
-e offline------page 61
-e online------page 61
perf_statistics--yes--page 25
power_offyesyes--page 26
power_onyes----page 26
probeyes----page 11
purge--yes--page 31
-e rdlsyes----page 61
releaseyesyesyespage 27
remove_deviceyes--yespage 34
replace_device----yespage 37
reserveyesyes--page 27
set_boot_devn/an/an/apage 28
start--yes--page 28
stop--yes--page 29
sync_cache--yes--page 32