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" 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 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 follows;

BOX_NAME,[f|r]slot_number

where:

TABLE 1-1

Options/Arguments	Description
BOX_NAME	is the name of the Sun Enterprise Network Array enclosure, as specified by the enclosure_name subcommand
f or r	specifies the front or rear slots in the Sun Enterprise Network Array enclosure
slot_number	is 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

/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.

---

Subcommand Support Matrix

The following table lists the subcommands that are supported on both the Sun Enterprise Network Array and the SPARCstorage Array, subcommands that are supported on the Sun Enterprise Network Array only, and subcommands that are supported on the SPARCstorage Array only.

TABLE 1-2

Supported on Sun Enterprise Network Array and SPARCstorage Array	Supported on Sun Enterprise Network Array Only	Supported on SPARCstorage Array Only
display	enclosure_name	alarm
download	fcal_s_download	alarm_off
inquiry	forcelip	alarm_on
led	insert_device	alarm_set
led_off	led_blink	env_display
power_off	power_on	fast_write
release	probe	fc_s_download
reserve	rdls	led_on
set_boot_dev	remove_device	nvram_data perf_statistics purge start stop sync_cache