Platform Notes: Using luxadm Software
  Procure somente este livro
Fazer download desta apostila em PDF
CHAPTER 1

Using the luxadm Command


The luxadm program is an administrative command that manages both the StorEdge A5000 and SPARCstorage Array subsystems. luxadm performs a variety of control and query tasks, depending on the command line arguments and options used.
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" on page 2".
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 StorEdge A5000 Disk 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 StorEdge A5000 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 StorEdge A5000 disk array interface boards (IBs) 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 StorEdge A5000 disk array, the WWN may be used in place of the pathname to select a device or 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 StorEdge A5000 enclosure and an identifier for the particular device in the enclosure. A device in a StorEdge A5000 enclosure is identified as follows:

  BOX_NAME,[f|r]slot_number  

where:
TABLE 1-1
Options/ArgumentsDescription
BOX_NAMEis the name of the StorEdge A5000 enclosure, as specified by the enclosure_name subcommand
f or rspecifies the front or rear slots in the StorEdge A5000 enclosure
slot_numberis the slot number in the StorEdge A5000 enclosure, 0-6 or 0-10
When addressing the StorEdge A5000 subsystem the pathname or enclosure name specifies the StorEdge A5000 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 StorEdge A5000, 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
SubcommandStorEdge A5000SPARCstorage ArraySparcstorage RSMpage
alarm_off--yesyespage 22
alarm_on--yesyespage 23
alarm_set--yesyespage 23
-e bus_getstateyesyesyespage 59
-e bus_quiesceyesyesyespage 59
-e bus_resetyesyesyespage 59
-e bus_resetallyesyesyespage 59
-e bus_unquiesceyesyesyespage 59
-e dev_getstateyesyesyespage 59
-e dev_resetyesyesyespage 59
displayyesyes--page 12
downloadyesyes--page 18
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 59
inquiryyesyesyespage 15
insert_deviceyes--yespage 36
ledyesyesyespage 8
led_blinkyes----page 8
TABLE 1-2 (Continued)
SubcommandStorEdge A5000SPARCstorage ArraySparcstorage RSMpage
led_offyesyes--page 9
led_on--yesyespage 10
nvram_data--yes--page 31
-e offlineyesyes--page 59
-e onlineyesyes--page 59
perf_statistics--yes--page 25
power_offyesyes--page 25
power_onyes----page 26
probeyes----page 11
purge--yes--page 31
-e rdlsyes----page 59
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