Platform Notes: Using luxadm Software

Chapter 1 `luxadm` Command Basics

The luxadm program is an administrative command that manages both the Sun StorEdge A5000 and SPARCstorage Array disk arrays. luxadm performs a variety of control and query tasks, depending on the command-line arguments and options used.

Command Syntax

The command line must contain a subcommand. You can enter options, usually at least one enclosure name or path name, and other parameters depending on the subcommand. You specify a device by entering either a physical path name or a logical path name.

The basic syntax is as follows:

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

When specifying a subcommand, you need to enter only as many characters as are required to uniquely identify the subcommand. For example, to run the display subcommand on an enclosure named box1, you could enter:

#luxadm disp box1

Addressing

This section explains how to specify, or address, a disk array.

Addressing a StorEdge A5000 Disk Array

You can address a StorEdge A5000 disk array by path name or enclosure name.

Specifying the Path Name

You can specify the device or controller using either a complete physical path name or a complete logical path name. A typical physical path name for a StorEdge A5000 disk array is:

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

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

Specifying the Enclosure Name

For the StorEdge A5000 disk array, you can select a device or interface board using the world wide name (WWN) instead of the path name. 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.

You can also specify the name of the StorEdge A5000 disk array and an identifier for the particular device in the enclosure. A device in a StorEdge A5000 disk array is identified as follows:

BOX_NAME,[f|r]slot_number

where:

Table 1-1 Addressing a StorEdge A5000 Disk Array by Enclosure Name


Options/Arguments	Description
`BOX_NAME`	is the name of the StorEdge A5000 enclosure, as specified by the enclosure_name subcommand
`f` or `r`	specifies the front or rear slots in the StorEdge A5000 enclosure
`slot_number`	is the slot number in the StorEdge A5000 enclosure, either 0-6 or 0-10

When addressing the StorEdge A5000 disk array, the path name or enclosure name specifies the StorEdge A5000 IB.

Addressing a SPARCstorage Array

When addressing the SPARCstorage Array, the path name 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

The controller name can also be specified 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

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

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

Addressing a SPARCstorage RSM Tray

When addressing the SPARCstorage RSM tray, the path name 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

A disk in the SPARCstorage RSM tray is specified by its logical or physical device name. For example:

/dev/rdsk/c2t8d0s2