1luxadm(1M) System Administration Commands luxadm(1M)
2
6 luxadm - administer Sun Fire 880 storage subsystem and FC_AL devices
7
9 luxadm [options]... subcommand [options]... enclosure
10 [,dev] | pathname...
11
14 The luxadm program is an administrative command that manages the SENA,
15 Sun Fire 880 internal storage subsystem, and individual Fiber Channel
16 Arbitrated Loop (FC_AL) devices. luxadm performs a variety of control
17 and query tasks depending on the command line arguments and options
18 used.
19 The command line must contain a subcommand. The command line may also
22 contain options, usually at least one enclosure name or pathname, and
23 other parameters depending on the subcommand. You need specify only as
24 many characters as are required to uniquely identify a subcommand.
25 Specify the device that a subcommand interacts with by entering a path‐
28 name. For the SENA subsystem, a disk device or enclosure services con‐
29 troller may instead be specified by entering the World Wide Name (WWN)
30 for the device or a port to the device. The device may also be speci‐
31 fied by entering the name of the SENA enclosure, and an optional iden‐
32 tifier for the particular device in the enclosure. The individual FC_AL
33 devices may be specified by entering the WWN for the device or a port
34 to the device.
35 Pathname
37 Specify the device or controller by either a complete physical pathname
38 or a complete logical pathname.
39 For SENA, a typical physical pathname for a device is:
42 /devices/sbus@1f,0/SUNW,socal@1,0/sf@0,0/ssd@w2200002037000f96,
44 0:a,raw
45 For all SENA IBs (Interface Boards) and Sun Fire 880 SES device con‐
50 trollers on the system, a logical link to the physical paths is kept in
51 the directory /dev/es. An example of a logical link is /dev/es/ses0.
52 The WWN may be used in place of the pathname to select an FC_AL device,
55 SENA subsystem IB, or Sun Fire 880 internal storage subsystem. The WWN
56 is a unique 16 hexadecimal digit value that specifies either the port
57 used to access the device or the device itself. A typical WWN value is:
58 2200002037000f96
60 See NOTES for more information on the WWN formats.
65 For a disk in a Sun Fire 880 internal storage subsystem, a typical
68 physical pathname is:
69 /devices/pci@8,600000/SUNW,qlc@2/fp@0,0/ssd@w2100002037a6303c,0:a
71 and a typical logical pathname is:
76 /dev/rdsk/c2t8d0s2
78 For individual FC_AL devices, a typical physical pathname is:
83 /devices/sbus@3.0/SUNW,socal@d,10000/sf@0,0/ssd@w2200002037049fc3,0:a,raw
85 and a typical logical pathname is:
90 /dev/rdsk/c1t0d0s2
92 Enclosure
96 For SENA, a device may be identified by its enclosure name and slot‐
97 name:
98 box_name[,fslot_number]
99 box_name[,rslot_number]
100 box_name is the name of the SENA enclosure, as specified by the enclo‐
103 sure_name subcommand. When used without the optional slot_number param‐
104 eter, the box_name identifies the SENA subsystem IB.
105 f or r specifies the front or rear slots in the SENA enclosure.
108 slot_number specifies the slot number of the device in the SENA enclo‐
111 sure, 0-6 or 0-10.
112 For a Sun Fire 880 internal storage subsystem, a device may also be
115 identified by its enclosure name and slot name. However, there is only
116 one set of disks:
117 box_name[,sslot_number]
119 box_name is the name of the Sun Fire 880 enclosure, as specified by the
124 enclosure_name subcommand. When used without the optional slot_number
125 parameter, box_name identifies the Sun Fire 880 internal storage sub‐
126 system enclosure services device. Use s to specify the disk slot number
127 in the Sun Fire 880 internal storage subsystem, 0 - 11.
128 See disks(1M) and devlinks(1M) for additional information on logical
131 names for disks and subsystems.
132
134 The following options are supported by all subcommands:
135 -e Expert mode. This option is not recommended for the novice user.
137 -v Verbose mode.
140 Options that are specific to particular subcommands are described with
144 the subcommand in the USAGE section.
145
147 The following operands are supported:
148 enclosure
150 The box_name of the SENA or Sun Fire 880 internal storage subsys‐
152 tem.
153 fibre_channel_HBA_port
156 The path to the host controller port. A typical path is:
158 /devices/pci@8,600000/pci@1/SUNW,qlc@4/fp@0,0:devctl
160 pathname
165 The logical or physical path of a SENA IB, Sun Fire 880 internal
167 storage subsystem, or disk device. pathname can also be the WWN of
168 a SENA IB, SENA disk, or individual FC_AL device.
169
172 Subcommands
173 display enclosure[,dev]...| pathname...
174 display -p pathname...
175 display -r enclosure[,dev]...| pathname...
176 display -v enclosure[,dev]...| pathname...
177 Displays enclosure or device specific data.
179 Subsystem data consists of enclosure environmental sense informa‐
181 tion and status for all subsystem devices, including disks.
182 Disk data consists of inquiry, capacity, and configuration informa‐
184 tion.
185 -p Displays performance information for the device or subsystem
187 specified by pathname. This option only applies to subsystems
188 that accumulate performance information.
189 -r Displays error information for the FC_AL device specified by
192 the pathname, or, if the path is a SENA, for all devices on
193 the loop. The -r option only applies to SENA subsystems and
194 individual FC_AL devices.
195 -v Displays in verbose mode, including mode sense data.
198 download [ -s ] [ -f filename_path ] enclosure...
202 Download the prom image pointed to the SENA subsystem Interface
204 Board unit or the Sun Fire 880 internal storage subsystem specified
205 by the enclosure or pathname.
206 When the SENA's download is complete, the SENA will be reset and
208 the downloaded code executed. If no filename is specified, the
209 default prom image will be used. The default prom image for the
210 SENA is in the directory usr/lib/locale/C/LC_MESSAGES and is named
211 ibfirmware
212 When the Sun Fire 880 internal storage subsystem's download is com‐
214 plete, the subsystem resets and the downloaded code begins execu‐
215 tion. The default firmware image for the Sun Fire 880 internal
216 storage subsystem is in: /usr/platform/SUNW,Sun-
217 Fire-880/lib/images/int_fcbpl_fw.
218 -s Save. The -s option is used to save the downloaded firmware
220 in the FEPROM. If -s is not specified, the downloaded
221 firmware will not be saved across power cycles.
222 The -s option does not apply to the Sun Fire 880 internal
224 storage subsystem as it always stores downloaded firmware in
225 the flash memory.
226 When using the -s option, the download subcommand modifies
228 the FEPROM on the subsystem and should be used with caution.
229 enclosure_name new_name enclosure | pathname
233 Change the enclosure name of the enclosure or enclosures specified
235 by the enclosure or pathname. The new name (new_name) must be 16 or
236 less characters. Only alphabetic or numeric characters are accept‐
237 able. This subcommand applies only to the SENA and the Sun Fire 880
238 internal storage subsystem.
239 failover primary | secondary pathname
242 Select which Sun Storage T3 storage array partner group controller
244 accesses a given logical volume. If primary is specified, the logi‐
245 cal volume is accessed through the primary controller. If secondary
246 is specified, the logical volume is accessed through the secondary
247 controller specified by pathname.
248 fcal_s_download [ -f fcode-file ]
251 Download the fcode contained in the file fcode-file into all the
253 FC100/S Sbus Cards. This command is interactive and expects user
254 confirmation before downloading the fcode.
255 Use fcal_s_download only in single-user mode. Using fcal_s_download
257 to update a host adapter while there is I/O activity through that
258 adapter will cause the adapter to reset. Newly updated FCode will
259 not be executed or visible until a system reboot.
260 -f fcode-file When invoked without the -f option, the current
262 version of the fcode in each FC100/S Sbus card is
263 printed.
264 fcode_download -p
268 fcode_download -d dir-name
269 Locate the installed FC/S, FC100/S, FC100/P, or FC100/2P host bus
271 adapter cards and download the FCode files in dir-name to the
272 appropriate cards. The command determines the correct card for each
273 type of file, and is interactive. User confirmation is required
274 before downloading the FCode to each device.
275 Use fcode_download to load FCode only in single-user mode. Using
277 fcode_download to update a host adapter while there is I/O activity
278 through that adapter causes the adapter to reset. Newly updated
279 FCode will not be executed or visible until a system reboot.
280 -d dir-name Download the FCode files contained in the directory
282 dir-name to the appropriate adapter cards.
283 -p Prints the current version of FCode loaded on each
286 card. No download is performed.
287 inquiry enclosure[,dev ]... | pathname...
291 Display the inquiry information for the selected device specified
293 by the enclosure or pathname.
294 insert_device [ enclosure,dev... ]
297 Assist the user in the hot insertion of a new device or a chain of
299 new devices. Refer to NOTES for limitations on hotplug operations.
300 This subcommand applies only to the SENA, Sun Fire 880 internal
301 storage subsystem, and individual FC_AL drives. For the SENA, if
302 more than one enclosure has been specified, concurrent hot inser‐
303 tions on multiple busses can be performed. With no arguments to the
304 subcommand, entire enclosures or individual FC_AL drives can be
305 inserted. For the SENA or the Sun Fire 880 internal storage subsys‐
306 tem, this subcommand guides the user interactively through the hot
307 insertion steps of a new device or chain of devices. If a list of
308 disks was entered it will ask the user to verify the list of
309 devices to be inserted is correct, at which point the user can con‐
310 tinue or quit. It then interactively asks the user to insert the
311 disk(s) or enclosure(s) and then creates and displays the logical
312 pathnames for the devices.
313 led enclosure,dev...| pathname...
316 Display the current state of the LED associated with the disk spec‐
318 ified by the enclosure or pathname. This subcommand only applies to
319 subsystems that support this functionality.
320 led_blink enclosure,dev...| pathname...
323 Requests the subsystem to start blinking the LED associated with
325 the disk specified by the enclosure or pathname. This subcommand
326 only applies to subsystems that support this functionality.
327 led_off enclosure,dev...| pathname...
330 Requests the subsystem to disable (turn off) the LED associated
332 with the disk specified by the enclosure or pathname. On a SENA
333 subsystem, this may or may not cause the LED to turn off or stop
334 blinking depending on the state of the SENA subsystem. Refer to the
335 SENA Array Installation and Service Manual (p/n 802-7573). This
336 subcommand only applies to subsystems that support this functional‐
337 ity.
338 led_on pathname...
341 Requests the subsystem to enable (turn on) the LED associated with
343 the disk specified by the pathname. This subcommand only applies to
344 subsystems that support this functionality.
345 power_off [ -F ] enclosure[,dev]... | pathname ...
348 When a SENA is addressed, this subcommand causes the SENA subsystem
350 to go into the power-save mode. The SENA drives are not available
351 when in the power-save mode. When a drive in a SENA is addressed
352 the drive is set to the drive off/unmated state. In the drive
353 off/unmated state, the drive is spun down (stopped) and in bypass
354 mode. This command does not apply to the Sun Fire 880 internal
355 storage subsystem.
356 -F The force option only applies to the SENA. Instructs luxadm
358 to attempt to power off one or more devices even if those
359 devices are being used by this host (and are, therefore,
360 busy).
361 Warning: Powering off a device which has data that is cur‐
363 rently being used will cause unpredictable results. Users
364 should attempt to power off the device normally (without -F)
365 first, only resorting to this option when sure of the conse‐
366 quences of overriding normal checks.
367 power_on enclosure[,dev]..
371 Causes the SENA subsystem to go out of the power-save mode, when
373 this subcommand is addressed to a SENA.. When this subcommand is
374 addressed to a drive the drive is set to its normal start-up state.
375 This command does not apply to the Sun Fire 880 internal storage
376 subsystem.
377 probe [ -p ]
380 Finds and displays information about all attached SENA subsystems,
382 Sun Fire 880 internal storage subsystems, and individual FC_AL
383 devices, including the logical pathname, the WWNs, and enclosure
384 names. This subcommand warns the user if it finds different SENAs
385 with the same enclosure names.
386 -p Includes the physical pathname in the display.
388 qlgc_s_download [ -f fcode-file ]
392 Download the FCode contained in the file fcode-file into all the
394 FC100/P, FC100/2P PCI host adapter cards. This command is interac‐
395 tive and expects user confirmation before downloading the FCode to
396 each device. Only use qlgc_s_download in single-user mode. Using
397 qlgc_s_download to update a host adapter while there is I/O activ‐
398 ity through that adapter will cause the adapter to reset. Newly
399 updated FCode will not be executed or visible until a system
400 reboot.
401 -f fcode-file When invoked without the -f option, the current
403 version of the FCode in each FC100/P, FC100/2P PCI
404 card is printed.
405 release pathname
409 Release a reservation held on the specified disk. The pathname
411 should be the physical or logical pathname for the disk.
412 This subcommand is included for historical and diagnostic purposes
414 only.
415 remove_device [ -F ] enclosure[,dev]...| pathname...
418 Assists the user in hot removing a device or a chain of devices.
420 This subcommand can also be used to remove entire enclosures. This
421 subcommand applies to the SENA, Sun Fire 880 internal storage sub‐
422 system, and individual FC_AL drives. Refer to NOTES for limitations
423 on hotplug operations. For the SENA, Sun Fire 880 internal storage
424 subsystem, and individual FC_AL devices, this subcommand guides the
425 user through the hot removal of a device or devices. During execu‐
426 tion it will ask the user to verify the list of devices to be
427 removed is correct, at which point the user can continue or quit.
428 It then prepares the disk(s) or enclosure(s) for removal and inter‐
429 actively asks the user to remove the disk(s) or enclosure(s).
430 For Multi-Hosted disk, the steps taken are:
432 o Issue the luxadm remove_device command on the first
434 host. When prompted to continue, wait.
435 o Issue the luxadm remove_device command on the secondary
437 hosts. When prompted to continue, wait.
438 o Continue with the remove_device command on the first
440 host. Remove the device when prompted to do so.
441 o Complete the luxadm remove_device command on the addi‐
443 tional hosts.
444 -F Instructs luxadm to attempt to hot plug one or more devices
446 even if those devices are being used by this host (and are,
447 therefore, busy or reserved), to force the hotplugging opera‐
448 tion.
449 Warning: Removal of a device which has data that is currently
451 being used will cause unpredictable results. Users should
452 attempt to hotplug normally (without -F) first, only resort‐
453 ing to this option when sure of the consequences of overrid‐
454 ing normal hotplugging checks.
455 reserve pathname
459 Reserve the specified disk for exclusive use by the issuing host.
461 The pathname used should be the physical or logical pathname for
462 the disk.
463 This subcommand is included for historical and diagnostic purposes
465 only.
466 set_boot_dev [ -y ] pathname
469 Set the boot-device variable in the system PROM to the physical
471 device name specified by pathname, which can be a block special
472 device or the pathname of the directory on which the boot file sys‐
473 tem is mounted. The command normally runs interactively requesting
474 confirmation for setting the default boot-device in the PROM. The
475 -y option can be used to run it non-interactively, in which case no
476 confirmation is requested or required.
477 start pathname
480 Spin up the specified disk(s) in a SENA.
482 stop pathname...
485 Spin down the specified disks in a SENA.
487 SENA, Sun Fire 880 Internal Storage Subsystem, and Individual FC_AL Drive
490 Expert Mode Subcommands
491 The following subcommands are for expert use only, and are applicable
492 only to the SENA, Sun Fire 880 internal storage subsystem, and fiber
493 channel loops. They should only be used by users that are knowledgeable
494 about the SENA subsystem and fiber channel loops.
495 If you specify a disk to an expert subcommand that operates on a bus,
498 the subcommand operates on the bus to which the specified disk is
499 attached.
500 -e bypass [-ab] enclosure,dev
502 -e bypass -f enclosure
503 Request the enclosure services controller to set the LRC (Loop
505 Redundancy Circuit) to the bypassed state for the port and device
506 specified.
507 This subcommand supports the following options:
509 -a Bypass port a of the device specified.
511 -b Bypass port b of the device specified.
514 -e dump_map fibre_channel_HBA_port
518 Display WWN data for a target device or host bus adapter on the
520 specified fibre channel port. If there are no target devices on the
521 specified port, an error is returned.
522 -e enable [-ab] enclosure,dev
525 -e enable -f enclosure
526 Request the enclosure services controller to set the LRC (Loop
528 Redundancy Circuit) to the enabled state for the port and device
529 specified.
530 This subcommand supports the following options:
532 -a Enable port a of the device specified.
534 -b Enable port b of the device specified.
537 -e forcelip enclosure[,dev] ... | pathname...
541 Force the link to reinitialize, using the Loop Initialization Prim‐
543 itive (LIP) sequence. The enclosure or pathname can specify any
544 device on the loop. Use the pathname to specify a specific path for
545 multiple loop configurations.
546 This is an expert only command and should be used with caution. It
548 will reset all ports on the loop.
549 -e rdls enclosure[,dev] ... | pathname...
552 Read and display the link error status information for all avail‐
554 able devices on the loop that contains the device specified by the
555 enclosure or pathname.
556 Other Expert Mode Subcommands
559 See NOTES for limitations of these subcommands. They should only be
560 used by users that are knowledgeable about the systems they are manag‐
561 ing.
562 These commands do not apply to the Sun Fire 880 internal storage sub‐
565 system.
566 -e bus_getstate pathname Get and display the state of the specified
568 bus.
569 -e bus_quiesce pathname Quiesce the specified bus.
572 -e bus_reset pathname Reset the specified bus only.
575 -e bus_resetall pathname Reset the specified bus and all devices.
578 -e bus_unquiesce pathname Unquiesce the specified bus. the specified
581 device.
582 -e dev_getstate pathname Get and display the state of the specified
585 device.
586 -e dev_reset pathname Reset the specified device.
589 -e offline pathname Take the specified device offline.
592 -e online pathname Put the specified device online.
595
598 Example 1 Displaying the SENAs and Individual FC_AL Devices on a System
599 The following example finds and displays all of the SENAs and individ‐
602 ual FC_AL devices on a system:
603 example% luxadm probe
606 Example 2 Displaying a SENA or Sun Fire 880 Internal Storage Subsystem
610 The following example displays a SENA or Sun Fire 880 internal storage
613 subsystem:
614 example% luxadm display /dev/es/ses0
617 Example 3 Displaying Two Subsystems
621 The following example displays two subsystems using the enclosure
624 names:
625 example% luxadm display BOB system1
628 Example 4 Displaying Information about the First Disk
632 The following example displays information about the first disk in the
635 front of the enclosure named BOB. Use f to specify the front disks. Use
636 r to specify the rear disks.
637 example% luxadm display BOB,f0
640 Example 5 Displaying Information on a Sun Fire 880 Internal Storage
644 Subsystem
645 The Sun Fire 880 internal storage subsystem has only one set of disks.
648 In this case, use s to specify the slot:
649 example% luxadm display BOB,s0
652 Example 6 Displaying Information about a SENA disk, an Enclosure, or an
656 Individual FC_AL Drive
657 The following example displays information about a SENA disk, an enclo‐
660 sure, or an individual FC_AL drive with the port WWN of
661 2200002037001246:
662 example% luxadm display 2200002037001246
665 Example 7 Using Unique Characters to Issue a Subcommand
669 The following example uses only as many characters as are required to
672 uniquely identify a subcommand:
673 example% luxadm disp BOB
676 Example 8 Displaying Error Information
680 The following example displays error information about the loop that
683 the enclosure BOB is on:
684 example% luxadm display -r BOB
687 Example 9 Downloading New Firmware into the Interface Board
691 The following example downloads new firmware into the Interface Board
694 in the enclosure named BOB (using the default path for the file to
695 download):
696 example% luxadm download -s BOB
699 Example 10 Displaying Information from the SCSI Inquiry Command
703 The following example displays information from the SCSI inquiry com‐
706 mand from all individual disks on the system, using only as many char‐
707 acters as necessary to uniquely identify the inquiry subcommand:
708 example% luxadm inq /dev/rdsk/c?t?d?s2
711 Example 11 Hotplugging
715 The following example hotplugs a new drive into the first slot in the
718 front of the enclosure named BOB:
719 example% luxadm insert_device BOB,f0
722 The following example hotplugs a new drive into the first slot in the
727 Sun Fire 880 internal storage subsystem named SF880-1:
728 example% luxadm insert_device SF880-1,s0
731 Example 12 Running an Expert Subcommand
735 The following example runs an expert subcommand. The subcommand forces
738 a loop initialization on the loop that the enclosure BOB is on:
739 example% luxadm -e forcelip BOB
742 Example 13 Using the Expert Mode Hot Plugging Subcommands
746 An example of using the expert mode hot plugging subcommands to hot
749 remove a disk follows. See NOTES for hot plugging limitations.
750 The first step reserves the SCSI device so that it can't be accessed by
754 way of its second SCSI bus:
755 example# luxadm reserve /dev/rdsk/c1t8d0s2
758 Example 14 Taking the Disk to be Removed Offline
762 The next two steps take the disk to be removed offline then quiesce the
765 bus:
766 example# luxadm -e offline /dev/rdsk/c1t8d0s2
769 example# luxadm -e bus_quiesce /dev/rdsk/c1t8d0s2
770 Example 15 Unquiescing the Bus
774 The user then removes the disk and continues by unquiescing the bus,
777 putting the disk back online, then unreserving it:
778 example# luxadm -e bus_unquiesce /dev/rdsk/c1t8d0s2
781 example# luxadm -e online /dev/rdsk/c1t8d0s2
782 example# luxadm release /dev/rdsk/c1t8d0s2
783
787 See environ(5) for a description of the LANG environment variable that
788 affects the execution of luxadm.
789
791 The following exit values are returned:
792 0 Successful completion.
794 −1 An error occurred.
797
800 usr/lib/firmware/fc_s/fc_s_fcode
801 usr/lib/locale/C/LC_MESSAGES/ibfirmware
806
811 See attributes(5) for descriptions of the following attributes:
812 usr/sbin
814 ┌─────────────────────────────┬─────────────────────────────┐
815 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
816 ├─────────────────────────────┼─────────────────────────────┤
817 │Availability │SUNWluxop │
818 └─────────────────────────────┴─────────────────────────────┘
819
821 devlinks(1M), disks(1M), attributes(5), environ(5), ses( 7D)
822 SENA Array Installation and Service Manual (p/n 802-7573).
825 RAID Manager 6.1 Installation and Support Guide Answerbook
828 RAID Manager 6.1 User's Guide Answerbook
831
833 See the SENA Array Installation and Service Manual for additional
834 information on the SENA. Refer to Tutorial for SCSI use of IEEE Com‐
835 pany_ID, R. Snively, for additional information regarding the IEEE
836 extended WWN. See SEE ALSO. Currently, only some device drivers support
837 hot plugging. If hot plugging is attempted on a disk or bus where it is
838 not supported, an error message of the form:
839 luxadm: can't acquire "PATHNAME": No such file or directory
841 will be displayed.
846 You must be careful not to quiesce a bus that contains the root or the
849 /usr filesystems or any swap data. If you do quiesce such a bus a dead‐
850 lock can result, requiring a system reboot.
851SunOS 5.11 24 Sep 2003 luxadm(1M)