luxadm(1M)
NAME
luxadm - administration program for the Sun Enterprise Net-
work Array (SENA), RSM, SPARCstorage Array (SSA) subsystems,
Sun Fire 880 internal storage subsystem, and individual
Fiber Channel Arbitrated Loop (FC_AL) devices
SYNOPSIS
luxadm [options...] subcommand [options...] enclosure
[,dev] | pathname...
DESCRIPTION
The luxadm program is an administrative command that manages
the SENA, RSM, SPARCstorage Array subsystems, Sun Fire 880
internal storage subsystem, and individual FC_AL devices.
luxadm performs a variety of control and query tasks depend-
ing on the command line arguments and options used.
The command line must contain a subcommand. The command line
may also contain options, usually at least one enclosure
name or pathname, and other parameters depending on the sub-
command. You need specify only as many characters as are
required to uniquely identify a subcommand.
Specify the device that a subcommand interacts with by
entering a pathname. For the SENA subsystem, a disk device
or enclosure services controller may instead be specified by
entering the World Wide Name (WWN) for the device or a port
to the device. The device may also be specified by entering
the name of the SENA enclosure, and an optional identifier
for the particular device in the enclosure. The individual
FC_AL devices may be specified by entering the WWN for the
device or a port to the device.
Pathname
Specify the device or controller by either a complete physi-
cal pathname or a complete logical pathname.
For SENA, a typical physical pathname for a 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 SENA IBs (Interface Boards) and Sun Fire 880 SES
device controllers on the system, a logical link to the phy-
sical paths is kept in the directory /dev/es. An example of
a logical link is /dev/es.
The WWN may be used in place of the pathname to select an
FC_AL device, SENA subsystem IB, or Sun Fire 880 internal
storage subsystem. The WWN is a unique 16 hexadecimal digit
value that specifies either the port used to access the dev-
ice or the device itself. A typical WWN value is:
2200002037000f96
See NOTES for more information on the WWN formats.
For the SPARCstorage Array controller, a typical physical
pathname is:
/devices/.../.../SUNW,soc@3,0/SUNW,pln@
axxxxxxx,xxxxxxxx:ctlr
whereas, a typical physical pathname for an RSM controller
is:
/devices/sbus@1f,0/QLGC,isp@1,10000:devctl
In order to make it easier to address the SPARCstorage Array
or RSM controller, a logical pathname of the form cN is sup-
ported, 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 or RSM
controller. The /dev/rdsk entry is then used to determine
the physical name of the SPARCstorage Array or RSM con-
troller.
For a SPARCstorage Array disk, a typical physical pathname
is:
/devices/.../.../SUNW,soc@3,0/SUNW,
pln@axxxxxxx,xxxxxxxx/ssd@0,0:c,raw
and a typical logical pathname is:
/dev/rdsk/c1t0d0s2
For an RSM a typical physical pathname is:
/devices/sbus@1f,0/QLGC,isp@1,10000/sd@8,0:c,raw
and a typical logical pathname is:
/dev/rdsk/c2t8d0s2
For a disk in a Sun Fire 880 internal storage subsystem, a
typical physical pathname is:
/devices/pci@8,600000/SUNW,qlc@2/fp@0,0/ssd@w2100002037a6303c,0:a
and a typical logical pathname is:
/dev/rdsk/c2t8d0s2
For individual FC_AL devices, a typical physical pathname
is:
/devices/sbus@3.0/SUNW,socal@d,10000/sf@0,0/ssd@w2200002037049fc3,0:a,raw
and a typical logical pathname is:
/dev/rdsk/c1t0d0s2
Enclosure
For SENA, a device may be identified by its enclosure name
and slotname:
box_name[,fslot_number]
box_name[,rslot_number]
box_name is the name of the SENA enclosure, as specified by
the enclosure_name subcommand. When used without the
optional slot_number parameter, the box_name identifies the
SENA subsystem IB.
f or r specifies the front or rear slots in the SENA enclo-
sure.
slot_number specifies the slot number of the device in the
SENA enclosure, 0-6 or 0-10.
For a Sun Fire 880 internal storage subsystem, a device may
also be identified by its enclosure name and slot name. How-
ever, there is only one set of disks:
box_name[,sslot_number]
box_name is the name of the Sun Fire 880 enclosure, as
specified by the enclosure_name subcommand. When used
without the optional slot_number parameter, box_name identi-
fies the Sun Fire 880 internal storage subsystem enclosure
services device. Use s to specify the disk slot number in
the Sun Fire 880 internal storage subsystem, 0 - 11.
See disks(1M) and devlinks(1M) for additional information on
logical names for disks and subsystems.
OPTIONS
The following options are supported by all subcommands:
-e Expert mode. This option is not recommended for the
novice user.
-v Verbose mode.
Options that are specific to particular subcommands are
described with the subcommand in the USAGE section.
OPERANDS
The following operands are supported:
enclosure
The box_name of the SENA. or Sun Fire 880 internal
storage subsystem.
fibre_channel_HBA_port
The path to the host controller port. A typical path
is:
/devices/pci@8,600000/pci@1/SUNW,qlc@4/fp@0,0:devctl
pathname
The logical or physical path of a SENA IB,, Sun Fire
880 internal storage subsystem, SPARCstorage Array or
RSM controller (cN name) or disk device. pathname can
also be the WWN of a SENA IB, SENA disk, or individual
FC_AL device.
USAGE
Subcommands
display enclosure[,dev]...| pathname...
display -p pathname ...
display -r enclosure[,dev]...| pathname...
display - v enclosure[,dev]...| pathname...
Displays enclosure or device specific data.
Subsystem data consists of enclosure environmental
sense information and status for all subsystem dev-
ices, including disks.
Disk data consists of inquiry, capacity, and confi-
guration information.
-p Displays performance information for the device
or subsystem specified by pathname. This option
only applies to subsystems that accumulate per-
formance information.
-r Displays error information for the FC_AL device
specified by the pathname, or, if the path is a
SENA, for all devices on the loop. The -r option
only applies to SENA subsystems and individual
FC_AL devices.
-v Displays in verbose mode, including mode sense
data.
download [ -s ] [ -w WWN ] [ -f filename_path ] enclosure...
Download the prom image pointed to by filename_path to
the SENA subsystem Interface Board unit, the Sun Fire
880 internal storage subsystem, or the SPARCstorage
Array controllers specified by the enclosure or path-
name. The SPARCstorage Array must be reset in order to
use the downloaded code.
When the SENA's download is complete, the SENA will be
reset and the downloaded code executed. If no filename
is specified, the default prom image will be used. The
default prom image for the SPARCstorage Array con-
troller is in usr/lib/firmware/ssa/ssafirmware. The
default prom image for the SENA is in the directory
usr/lib/locale/C/LC_MESSAGES and is named ibfirmware
When the Sun Fire 880 internal storage subsystem's
download is complete, the subsystem resets and the
downloaded code begins execution. The default firmware
image for the Sun Fire 880 internal storage subsystem
is in: /usr/platform/SUNW,Sun-Fire-
880/lib/images/int_fcbpl_fw.
-s Save. The -s option is used to save the down-
loaded firmware in the FEPROM. If -s is not
specified, the downloaded firmware will not be
saved across power cycles.
The -s option does not apply to the SPARCstorage
Array controller as it always writes the down-
loaded firmware into the FEPROM.
The -s option does not apply to the Sun Fire 880
internal storage subsystem as it always stores
downloaded firmware in the flash memory.
When using the -s option, the download subcom-
mand modifies the FEPROM on the subsystem and
should be used with caution.
-w WWN
Change the SPARCstorage Array controller's World
Wide Name. WWN is a 12-digit hex number; leading
zeros are required. The -w option applies only
to the SPARCstorage Array. The new SPARCstorage
Array controller's image will have the least
significant 6 bytes of the 8-byte World Wide
Name modified to WWN.
enclosure_name new_name enclosure | pathname
Change the enclosure name of the enclosure or enclo-
sures specified by the enclosure or pathname. The new
name (new_name) must be 16 or less characters. Only
alphabetic or numeric characters are acceptable. This
subcommand applies only to the SENA and the Sun Fire
880 internal storage subsystem.
failover primary | secondary pathname
Select which Sun Storage T3 storage array partner
group controller accesses a given logical volume. If
primary is specified, the logical volume is accessed
through the primary controller. If secondary is speci-
fied, the logical volume is accessed through the
secondary controller specified by pathname.
fc_s_download [ -F ] [ -f fcode-file ]
Download the fcode contained in the file fcode-file
into all the FC/S Sbus Cards. This command is interac-
tive and expects user confirmation before downloading
the fcode.
Use fc_s_download only in single-user mode. Using
fc_s_download to update a host adapter while there is
I/O activity through that adapter will cause the
adapter to reset. Newly updated FCode will not be
executed or visible until a system reboot.
-f fcode-file
When invoked without the -f fcode-file option,
the current version of the fcode in each FC/S
Sbus card is printed.
-F Forcibly downloads the fcode, but the command
still expects user confirmation before the down-
load. The version of the FC/S Sbus Cards fcode
that was released with this version of the
Operating System is kept in the directory
usr/lib/firmware/fc_s and is named fc_s_fcode.
fcal_s_download [ -f fcode-file ]
Download the fcode contained in the file fcode-file
into all the FC100/S Sbus Cards. This command is
interactive and expects user confirmation before down-
loading the fcode.
Use fcal_s_download only in single-user mode. Using
fcal_s_download to update a host adapter while there
is I/O activity through that adapter will cause the
adapter to reset. Newly updated FCode will not be
executed or visible until a system reboot.
-f fcode-file
When invoked without the -f option, the current
version of the fcode in each FC100/S Sbus card
is printed.
fcode_download -p
fcode_download -d dir-name
Locate the installed FC/S, FC100/S, FC100/P, or
FC100/2P host bus adapter cards and download the FCode
files in dir-name to the appropriate cards. The com-
mand determines the correct card for each type of
file, and is interactive. User confirmation is
required before downloading the FCode to each device.
Use fcode_download to load FCode only in single-user
mode. Using fcode_download to update a host adapter
while there is I/O activity through that adapter
causes the adapter to reset. Newly updated FCode will
not be executed or visible until a system reboot.
-d dir-name
Download the FCode files contained in the direc-
tory dir-name to the appropriate adapter cards.
-p Prints the current version of FCode loaded on
each card. No download is performed.
inquiry enclosure[,dev ]... | pathname...
Display the inquiry information for the selected dev-
ice specified by the enclosure or pathname.
insert_device [ enclosure,dev... ]
Assist the user in the hot insertion of a new device
or a chain of new devices. Refer to NOTES for limita-
tions on hotplug operations. This subcommand applies
only to the SENA, Sun Fire 880 internal storage sub-
system, RSM, and individual FC_AL drives. RSM, and
individual FC_AL drives. For the SENA, if more than
one enclosure has been specified, concurrent hot
insertions on multiple busses can be performed. With
no arguments to the subcommand, entire enclosures or
individual FC_AL drives can be inserted. For the RSM,
only one controller can be specified. For the SENA or
the Sun Fire 880 internal storage subsystem, this
subcommand guides the this subcommand guides the user
interactively through the hot insertion steps of a new
device or chain of devices. If a list of disks was
entered it will ask the user to verify the list of
devices to be inserted is correct, at which point the
user can continue or quit. It then interactively asks
the user to insert the disk(s) or enclosure(s) and
then creates and displays the logical pathnames for
the devices.
For the RSM, the following steps are taken:
o Quiesce the bus or buses which support
quiescing and unquiescing.
o Inform the user that the device can be
safely inserted .
o Request confirmation from the user that the
device has been inserted.
o Unquiesce the bus or buses which support
quiescing and unquiescing.
o Create the logical device name for the new
device.
led enclosure,dev...| pathname...
Display the current state of the LED associated with
the disk specified by the enclosure or pathname. This
subcommand only applies to subsystems that support
this functionality.
led_blink enclosure,dev...| pathname...
Requests the subsystem to start blinking the LED asso-
ciated with the disk specified by the enclosure or
pathname. This subcommand only applies to subsystems
that support this functionality.
led_off enclosure,dev...| pathname...
Requests the subsystem to disable (turn off) the LED
associated with the disk specified by the enclosure or
pathname. On a SENA subsystem, this may or may not
cause the LED to turn off or stop blinking depending
on the state of the SENA subsystem. Refer to the SENA
Array Installation and Service Manual (p/n 802-7573).
This subcommand only applies to subsystems that sup-
port this functionality.
led_on pathname...
Requests the subsystem to enable (turn on) the LED
associated with the disk specified by the pathname.
This subcommand only applies to subsystems that sup-
port this functionality.
power_off [ -F ] enclosure[,dev]... | pathname ...
number
power_off pathname [ enclosure-
port ] ... | controller tray-
When a SENA is addressed, this subcommand causes the
SENA subsystem to go into the power-save mode. The
SENA drives are not available when in the power-save
mode. When an Enclosure Services card within the
SPARCstorage Array is addressed, the RSM tray is
powered down. When a drive in a SENA is addressed the
drive is set to the drive off/unmated state. In the
drive off/unmated state, the drive is spun down
(stopped) and in bypass mode. This command does not
apply to the Sun Fire 880 internal storage subsystem.
-F The force option only applies to the SENA.
Instructs luxadm to attempt to power off one or
more devices even if those devices are being
used by this host (and are, therefore, busy).
Warning: Powering off a device which has data
that is currently being used will cause
unpredictable results. Users should attempt to
power off the device normally (without -F)
first, only resorting to this option when sure
of the consequences of overriding normal checks.
power_on enclosure[,dev]..
Causes the SENA subsystem to go out of the power-save
mode, when this subcommand is addressed to a SENA.
There is no programmatic way to power on the
SPARCstorage Array RSM tray. When this subcommand is
addressed to a drive the drive is set to its normal
start-up state. This command does not apply to the Sun
Fire 880 internal storage subsystem.
probe [ -p ]
Finds and displays information about all attached SENA
subsystems, Sun Fire 880 internal storage subsystems,
and individual FC_AL devices, including the logical
pathname, the WWNs, and enclosure names. This subcom-
mand warns the user if it finds different SENAs with
the same enclosure names.
-p Includes the physical pathname in the display.
qlgc_s_download [ -f fcode-file ]
Download the FCode contained in the file fcode-file
into all the FC100/P, FC100/2P PCI host adapter cards.
This command is interactive and expects user confirma-
tion before downloading the FCode to each device. Only
use qlgc_s_download in single-user mode. Using
qlgc_s_download to update a host adapter while there
is I/O activity through that adapter will cause the
adapter to reset. Newly updated FCode will not be exe-
cuted or visible until a system reboot.
-f fcode-file
When invoked without the -f option, the current
version of the FCode in each FC100/P, FC100/2P
PCI card is printed.
release pathname
Release a reservation held on the specified disk. The
pathname should be the physical or logical pathname
for the disk. If the pathname is of the SPARCstorage
Array controller, then all of the disks in the
SPARCstorage Array will be released.
This subcommand is included for historical and diag-
nostic purposes only.
remove_device [ -F ] enclosure[,dev]...| pathname...
Assists the user in hot removing a device or a chain
of devices. This subcommand can also be used to remove
entire enclosures. This subcommand applies to the
SENA, Sun Fire 880 internal storage subsystem, RSM,
and individual FC_AL drives. Refer to NOTES for limi-
tations on hotplug operations. For the SENA, Sun Fire
880 internal storage subsystem, and individual FC_AL
devices, this subcommand guides the user through the
hot removal of a device or devices. During execution
it will ask the user to verify the list of devices to
be removed is correct, at which point the user can
continue or quit. It then prepares the disk(s) or
enclosure(s) for removal and interactively asks the
user to remove the disk(s) or enclosure(s).
For the RSM, the steps taken are:
o Take the device offline.
o Quiesce the bus or buses which support quiescing
and unquiescing.
o Inform user that the device can be safely
removed.
o Request confirmation from the user that the dev-
ice has been removed.
o Unquiesce the bus or buses which support quiesc-
ing and unquiescing.
o Bring the (now removed) device back online.
o Remove the logical device name for the removed
device.
For Multi-Hosted disk, the steps taken are:
o Issue the luxadm remove_device command on the
first host. When prompted to continue, wait.
o Issue the luxadm remove_device command on the
secondary hosts. When prompted to continue,
wait.
o Continue with the remove_device command on the
first host. Remove the device when prompted to
do so.
o Complete the luxadm remove_device command on the
additional hosts.
-F Instructs luxadm to attempt to hot plug one or
more devices even if those devices are being
used by this host (and are, therefore, busy or
reserved), to force the hotplugging operation.
Warning: Removal of a device which has data that
is currently being used will cause unpredictable
results. Users should attempt to hotplug nor-
mally (without -F) first, only resorting to this
option when sure of the consequences of overrid-
ing normal hotplugging checks.
replace_device [ -F ] pathname
This subcommand applies only to the RSM. Refer to
NOTES for limitations on hotplug operations. This sub-
command guides the user interactively through the hot
replacement of a device.
For the RSM, the steps taken are:
o Take the device offline.
o Quiesce the bus or buses which support quiescing
and unquiescing.
o Inform user that the device can be safely
replaced.
o Request confirmation from the user that the dev-
ice has been replaced.
o Unquiesce the bus or buses which support quiesc-
ing and unquiescing.
o Bring the device back online.
-F Instructs luxadm to attempt to hot plug one or
more devices even if those devices are busy or
reserved, (that is, to force the hotplugging
operation).
Warning: Removal of a device which has data that
is currently being used will cause unpredictable
results. Users should attempt to hotplug nor-
mally (without -F) first, only resorting to this
option when sure of the consequences of overrid-
ing normal hotplugging checks.
reserve pathname
Reserve the specified disk for exclusive use by the
issuing host. The pathname used should be the physical
or logical pathname for the disk. If the pathname is
of the SPARCstorage Array controller, then all of the
disks in the SPARCstorage Array will be reserved.
This subcommand is included for historical and diag-
nostic purposes only.
set_boot_dev [ -y ] pathname
Set the boot-device variable in the system PROM to the
physical device name specified by pathname, which can
be a block special device or the pathname of the
directory on which the boot file system is mounted.
The command normally runs interactively requesting
confirmation for setting the default boot-device in
the PROM. The -y option can be used to run it non-
interactively, in which case no confirmation is
requested or required.
start [ -t tray-number ] pathname...
Spin up the specified disk(s). If pathname specifies
the SPARCstorage Array controller, this action applies
to all disks in the SPARCstorage Array.
-t Spin up all disks in the tray specified by
tray-number. pathname must specify the
SPARCstorage Array controller.
stop [ -t tray-number ] pathname...
Spin down the specified disk(s). If pathname specifies
the SPARCstorage Array controller, this action applies
to all disks in the SPARCstorage Array.
-t Spin down all disks in the tray specified by
tray-number. pathname must specify the
SPARCstorage Array controller.
SPARCstorage Array Subcommands
fast_write [ -s ] -c pathname
fast_write [ -s ] -d pathname
fast_write [ -s ] -e pathname
Enable or disable the use of the NVRAM to enhance the
performance of writes in the SPARCstorage Array. path-
name refers to the SPARCstorage Array controller or to
an individual disk.
-s Cause the SPARCstorage Array to save the change
so it will persist across power-cycles.
-c Enable fast writes for synchronous writes only.
-d Disable fast writes.
-e Enable fast writes.
nvram_data pathname
Display the amount of fast write data in the NVRAM for
the specified disk. This command can only be used for
an individual disk.
perf_statistics -d pathname
perf_statistics -e pathname
Enable or disable the accumulation of performance
statistics for the specified SPARCstorage Array con-
troller. The accumulation of performance statistics
must be enabled before using the display -p subcom-
mand. This subcommand can be issued only to the
SPARCstorage Array controller.
-d Disable the accumulation of performance statis-
tics.
-e Enable the accumulation of performance statis-
tics.
purge pathname
Purge any fast write data from NVRAM for one disk, or
all disks if the controller is specified. This option
should be used with caution, usually only when a drive
has failed.
sync_cache pathname
Flush all outstanding writes for the specified disk
from NVRAM to the media. If pathname specifies the
controller, this action applies to all disks in the
SPARCstorage Array subsystem.
Enclosure Services Card Subcommands
The env_display and alarm* subcommands apply only to an
Enclosure Services Card (SES) in a RSM tray in a
SPARCstorage Array. The RSM tray is addressed by using the
logical or physical path of the SES device or by specifying
the controller followed by the tray number. The controller
is addressed by cN or the physical path to the SSA's con-
troller.
alarm pathname | controller tray_number
Display the current state of audible alarm.
alarm_off pathname | controller tray_number
Disable the audible alarm for this RSM tray.
alarm_on pathname | controller tray_number
Enable the audible alarm for this RSM tray.
]
alarm_set controller-
pathname | controller tray_number [ seconds
Set the audible alarm setting to seconds.
env_display pathname | controller tray_number
Display the environmental information for the speci-
fied unit.
SENA, Sun Fire 880 Internal Storage Subsystem, and Individual
FC_AL Drive Expert Mode Subcommands
The following subcommands are for expert use only, and are
applicable only to the SENA, Sun Fire 880 internal storage
subsystem, and fiber channel loops. They should only be used
by users that are knowledgeable about the SENA subsystem and
fiber channel loops.
If you specify a disk to an expert subcommand that operates
on a bus, the subcommand operates on the bus to which the
specified disk is attached.
-e bypass [-ab] enclosure,dev
-e bypass -f enclosure
Request the enclosure services controller to set the
LRC (Loop Redundancy Circuit) to the bypassed state
for the port and device specified.
This subcommand supports the following options:
-a Bypass port a of the device specified.
-b Bypass port b of the device specified.
-e dump_map fibre_channel_HBA_port
Display WWN data for a target device or host bus
adapter on the specified fibre channel port. If there
are no target devices on the specified port, an error
is returned.
-e enable [-ab] enclosure,dev
-e enable -f enclosure
Request the enclosure services controller to set the
LRC (Loop Redundancy Circuit) to the enabled state for
the port and device specified.
This subcommand supports the following options:
-a Enable port a of the device specified.
-b Enable port b of the device specified.
-e forcelip enclosure[,dev] ... | pathname...
Force the link to reinitialize, using the Loop Ini-
tialization Primitive (LIP) sequence. The enclosure or
pathname can specify any device on the loop. Use the
pathname to specify a specific path for multiple loop
configurations.
This is an expert only command and should be used with
caution. It will reset all ports on the loop.
-e rdls enclosure[,dev] ... | pathname...
Read and display the link error status information for
all available devices on the loop that contains the
device specified by the enclosure or pathname.
Other Expert Mode Subcommands
See NOTES for limitations of these subcommands. They should
only be used by users that are knowledgeable about the sys-
tems they are managing.
These commands do not apply to the Sun Fire 880 internal
storage subsystem.
-e bus_getstate pathname
Get and display the state of the specified bus.
-e bus_quiesce pathname
Quiesce the specified bus.
-e bus_reset pathname
Reset the specified bus only.
-e bus_resetall pathname
Reset the specified bus and all devices.
-e bus_unquiesce pathname
Unquiesce the specified bus. the specified device.
-e dev_getstate pathname
Get and display the state of the specified device.
-e dev_reset pathname
Reset the specified device.
-e offline pathname
Take the specified device offline.
-e online pathname
Put the specified device online.
EXAMPLES
Example 1: Displaying the SENAs and Individual FC_AL Devices
on a System
The following example finds and displays all of the SENAs
and individual FC_AL devices on a system:
example% luxadm probe
Example 2: Displaying an SSA
The following example displays an SSA:
example% luxadm display c1
Example 3: Displaying a SENA or Sun Fire 880 Internal
Storage Subsystem
The following example displays a SENA or Sun Fire 880 inter-
nal storage subsystem:
example% luxadm display /dev/es/ses0
Example 4: Displaying Two Subsystems
The following example displays two subsystems using the
enclosure names:
example% luxadm display BOB system1
Example 5: Displaying Information about the First Disk
The following example displays information about the first
disk in the front of the enclosure named BOB. Use f to
specify the front disks. Use r to specify the rear disks.
example% luxadm display BOB,f0
Example 6: Displaying Information on a Sun Fire 880 Internal
Storage Subsystem
The Sun Fire 880 internal storage subsystem has only one set
of disks. In this case, use s to specify the slot:
example% luxadm display BOB,s0
Example 7: Displaying Information about a SENA disk, an
Enclosure, or an Individual FC_AL Drive
The following example displays information about a SENA
disk, an enclosure, or an individual FC_AL drive with the
port WWN of 2200002037001246:
example% luxadm display 2200002037001246
Example 8: Using Unique Characters to Issue a Subcommand
The following example uses only as many characters as are
required to uniquely identify a subcommand:
example% luxadm disp BOB
Example 9: Displaying Error Information
The following example displays error information about the
loop that the enclosure BOB is on:
example% luxadm display -r BOB
Example 10: Downloading New Firmware into the Interface
Board
The following example downloads new firmware into the Inter-
face Board in the enclosure named BOB (using the default
path for the file to download):
example% luxadm download -s BOB
Example 11: Displaying Information from the SCSI Inquiry
Command
The following example displays information from the SCSI
inquiry command from all individual disks on the system,
using only as many characters as necessary to uniquely iden-
tify the inquiry subcommand:
example% luxadm inq /dev/rdsk/c?t?d?s2
Example 12: Hotplugging
The following example hotplugs a new drive into the first
slot in the front of the enclosure named BOB:
example% luxadm insert_device BOB,f0
The following example hotplugs a new drive into the first
slot in the Sun Fire 880 internal storage subsystem named
SF880-1:
example% luxadm insert_device SF880-1,s0
Example 13: Running an Expert Subcommand
The following example runs an expert subcommand. The sub-
command forces a loop initialization on the loop that the
enclosure BOB is on:
example% luxadm -e forcelip BOB
Example 14: Using the Expert Mode Hot Plugging Subcommands
An example of using the expert mode hot plugging subcommands
to hot remove a disk on a SSA follows. See NOTES for hot
plugging limitations.
The first step reserves the SCSI device so that it can't be
accessed by way of its second SCSI bus:
example# luxadm reserve /dev/rdsk/c1t8d0s2
Example 15: Taking the Disk to be Removed Offline
The next two steps take the disk to be removed offline then
quiesce the bus:
example# luxadm -e offline /dev/rdsk/c1t8d0s2
example# luxadm -e bus_quiesce /dev/rdsk/c1t8d0s2
Example 16: Unquiescing the Bus
The user then removes the disk and continues by unquiescing
the bus, putting the disk back online, then unreserving it:
example# luxadm -e bus_unquiesce /dev/rdsk/c1t8d0s2
example# luxadm -e online /dev/rdsk/c1t8d0s2
example# luxadm release /dev/rdsk/c1t8d0s2
ENVIRONMENT VARIABLES
See environ(5) for a description of the LANG environment
variable that affects the execution of luxadm.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
-1 An error occurred.
FILES
usr/lib/firmware/fc_s/fc_s_fcode
usr/lib/firmware/ssa/ssafirmware
usr/lib/locale/C/LC_MESSAGES/ibfirmware
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
usr/sbin
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWluxop |
|_____________________________|_____________________________|
SEE ALSO
devlinks(1M), disks(1M), ssaadm(1M), attributes(5),
environ(5), ses( 7D)
SENA Array Installation and Service Manual (p/n 802-7573).
RAID Manager 6.1 Installation and Support Guide Answerbook
RAID Manager 6.1 User's Guide Answerbook
NOTES
See the SENA Array Installation and Service Manual for addi-
tional information on the SENA. Refer to Tutorial for SCSI
use of IEEE Company_ID, R. Snively, for additional informa-
tion regarding the IEEE extended WWN. See SEE ALSO.
Currently, only some device drivers support hot plugging. If
hot plugging is attempted on a disk or bus where it is not
supported, an error message of the form:
luxadm: can't acquire "PATHNAME": No such file or directory
will be displayed.
You must be careful not to quiesce a bus that contains the
root or the /usr filesystems or any swap data. If you do
quiesce such a bus a deadlock can result, requiring a system
reboot.
Man(1) output converted with
man2html