| blob | 524527f222761d411af3f9c7dc0cec938a8424b5 |
1 '\" te
2 .\" Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved
3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH LUXADM 1M "Sep 24, 2003"
7 .SH NAME
8 luxadm \- administer Sun Fire 880 storage subsystem and FC_AL devices
9 .SH SYNOPSIS
10 .LP
11 .nf
12 \fBluxadm\fR [\fIoptions\fR]... \fIsubcommand\fR [\fIoptions\fR]... \fIenclosure\fR
13 [,\fIdev\fR] | \fIpathname\fR...
14 .fi
16 .SH DESCRIPTION
17 .sp
18 .LP
19 The \fBluxadm\fR program is an administrative command that manages the
20 \fBSENA\fR, Sun Fire 880 internal storage subsystem, and individual Fiber
21 Channel Arbitrated Loop (\fBFC_AL\fR) devices. \fBluxadm\fR performs a variety
22 of control and query tasks depending on the command line arguments and options
23 used.
24 .sp
25 .LP
26 The command line must contain a subcommand. The command line may also contain
27 options, usually at least one enclosure name or pathname, and other parameters
28 depending on the subcommand. You need specify only as many characters as are
29 required to uniquely identify a subcommand.
30 .sp
31 .LP
32 Specify the device that a subcommand interacts with by entering a pathname. For
33 the \fBSENA\fR subsystem, a disk device or enclosure services controller may
34 instead be specified by entering the World Wide Name (\fBWWN\fR) for the device
35 or a port to the device. The device may also be specified by entering the name
36 of the \fBSENA\fR enclosure, and an optional identifier for the particular
37 device in the enclosure. The individual \fBFC_AL\fR devices may be specified by
38 entering the \fBWWN\fR for the device or a port to the device.
39 .SS "Pathname"
40 .sp
41 .LP
42 Specify the device or controller by either a complete physical pathname or a
43 complete logical pathname.
44 .sp
45 .LP
46 For \fBSENA,\fR a typical physical pathname for a device is:
47 .sp
48 .in +2
49 .nf
50 /devices/sbus@1f,0/SUNW,socal@1,0/sf@0,0/ssd@w2200002037000f96,
51 0:a,raw
52 .fi
53 .in -2
54 .sp
56 .sp
57 .LP
58 For all \fBSENA IBs\fR (Interface Boards) and Sun Fire 880 SES device
59 controllers on the system, a logical link to the physical paths is kept in the
60 directory \fB/dev/es\fR. An example of a logical link is \fB/dev/es/ses0\fR.
61 .sp
62 .LP
63 The \fBWWN\fR may be used in place of the pathname to select an \fBFC_AL\fR
64 device, \fBSENA\fR subsystem IB, or Sun Fire 880 internal storage subsystem.
65 The \fBWWN\fR is a unique 16 hexadecimal digit value that specifies either the
66 port used to access the device or the device itself. A typical \fBWWN\fR value
67 is:
68 .sp
69 .in +2
70 .nf
71 2200002037000f96
72 .fi
73 .in -2
74 .sp
76 .sp
77 .LP
78 See NOTES for more information on the \fBWWN\fR formats.
79 .sp
80 .LP
81 For a disk in a Sun Fire 880 internal storage subsystem, a typical physical
82 pathname is:
83 .sp
84 .in +2
85 .nf
86 /devices/pci@8,600000/SUNW,qlc@2/fp@0,0/ssd@w2100002037a6303c,0:a
87 .fi
88 .in -2
89 .sp
91 .sp
92 .LP
93 and a typical logical pathname is:
94 .sp
95 .in +2
96 .nf
97 /dev/rdsk/c2t8d0s2
98 .fi
99 .in -2
100 .sp
102 .sp
103 .LP
104 For individual FC_AL devices, a typical physical pathname is:
105 .sp
106 .in +2
107 .nf
108 /devices/sbus@3.0/SUNW,socal@d,10000/sf@0,0/ssd@w2200002037049fc3,0:a,raw
109 .fi
110 .in -2
111 .sp
113 .sp
114 .LP
115 and a typical logical pathname is:
116 .sp
117 .in +2
118 .nf
119 /dev/rdsk/c1t0d0s2
120 .fi
121 .in -2
122 .sp
124 .SS "Enclosure"
125 .sp
126 .LP
127 For \fBSENA,\fR a device may be identified by its enclosure name and slotname:
128 .br
129 .in +2
130 \fIbox_name\fR[\fB,f\fR\fIslot_number\fR]
131 .in -2
132 .br
133 .in +2
134 \fIbox_name\fR[\fB,r\fR\fIslot_number\fR]
135 .in -2
136 .sp
137 .LP
138 \fIbox_name\fR is the name of the \fBSENA\fR enclosure, as specified by the
139 \fBenclosure_name\fR subcommand. When used without the optional
140 \fIslot_number\fR parameter, the \fIbox_name\fR identifies the \fBSENA\fR
141 subsystem \fBIB.\fR
142 .sp
143 .LP
144 \fBf\fR or \fBr\fR specifies the front or rear slots in the \fBSENA\fR
145 enclosure.
146 .sp
147 .LP
148 \fIslot_number\fR specifies the slot number of the device in the \fBSENA\fR
149 enclosure, \fB0-6\fR or \fB0-10\fR.
150 .sp
151 .LP
152 For a Sun Fire 880 internal storage subsystem, a device may also be identified
153 by its enclosure name and slot name. However, there is only one set of disks:
154 .sp
155 .in +2
156 .nf
157 \fIbox_name\fR[,\fIsslot_number\fR]
158 .fi
159 .in -2
160 .sp
162 .sp
163 .LP
164 \fIbox_name\fR is the name of the Sun Fire 880 enclosure, as specified by the
165 \fBenclosure_name\fR subcommand. When used without the optional
166 \fIslot_number\fR parameter, \fIbox_name\fR identifies the Sun Fire 880
167 internal storage subsystem enclosure services device. Use \fIs\fR to specify
168 the disk slot number in the Sun Fire 880 internal storage subsystem, \fB0\fR -
169 \fB11\fR.
170 .sp
171 .LP
172 See \fBdisks\fR(1M) and \fBdevlinks\fR(1M) for additional information on
173 logical names for disks and subsystems.
174 .SH OPTIONS
175 .sp
176 .LP
177 The following options are supported by all subcommands:
178 .sp
179 .ne 2
180 .na
181 \fB\fB-e\fR\fR
182 .ad
183 .RS 6n
184 Expert mode. This option is not recommended for the novice user.
185 .RE
187 .sp
188 .ne 2
189 .na
190 \fB\fB-v\fR\fR
191 .ad
192 .RS 6n
193 Verbose mode.
194 .RE
196 .sp
197 .LP
198 Options that are specific to particular subcommands are described with the
199 subcommand in the \fBUSAGE\fR section.
200 .SH OPERANDS
201 .sp
202 .LP
203 The following operands are supported:
204 .sp
205 .ne 2
206 .na
207 \fB\fIenclosure\fR\fR
208 .ad
209 .sp .6
210 .RS 4n
211 The \fIbox_name\fR of the \fBSENA\fR or Sun Fire 880 internal storage
212 subsystem.
213 .RE
215 .sp
216 .ne 2
217 .na
218 \fB\fIfibre_channel_HBA_port\fR\fR
219 .ad
220 .sp .6
221 .RS 4n
222 The path to the host controller port. A typical path is:
223 .sp
224 .in +2
225 .nf
226 /devices/pci@8,600000/pci@1/SUNW,qlc@4/fp@0,0:devctl
227 .fi
228 .in -2
229 .sp
231 .RE
233 .sp
234 .ne 2
235 .na
236 \fB\fIpathname\fR\fR
237 .ad
238 .sp .6
239 .RS 4n
240 The logical or physical path of a \fBSENA IB\fR, Sun Fire 880 internal storage
241 subsystem, or disk device. \fIpathname\fR can also be the \fBWWN\fR of a
242 \fBSENA IB\fR, \fBSENA\fR disk, or individual \fBFC_AL\fR device.
243 .RE
245 .SH USAGE
246 .SS "Subcommands"
247 .sp
248 .ne 2
249 .na
250 \fB\fBdisplay\fR \fIenclosure\fR[,\fIdev\fR]\|.\|.\|.\||
251 \fIpathname\fR\|.\|.\|.\fR
252 .ad
253 .br
254 .na
255 \fB\fBdisplay\fR \fB-p\fR \fIpathname\fR\|.\|.\|.\fR
256 .ad
257 .br
258 .na
259 \fB\fBdisplay\fR \fB-r\fR \fIenclosure\fR[,\fIdev\fR]\|.\|.\|.\||
260 \fIpathname\fR\|.\|.\|.\fR
261 .ad
262 .br
263 .na
264 \fB\fBdisplay\fR \fB-v\fR \fIenclosure\fR[,\fIdev\fR]\|.\|.\|.\||
265 \fIpathname\fR\|.\|.\|.\fR
266 .ad
267 .sp .6
268 .RS 4n
269 Displays enclosure or device specific data.
270 .sp
271 Subsystem data consists of enclosure environmental sense information and status
272 for all subsystem devices, including disks.
273 .sp
274 Disk data consists of inquiry, capacity, and configuration information.
275 .sp
276 .ne 2
277 .na
278 \fB\fB-p\fR\fR
279 .ad
280 .RS 6n
281 Displays performance information for the device or subsystem specified by
282 \fIpathname\fR. This option only applies to subsystems that accumulate
283 performance information.
284 .RE
286 .sp
287 .ne 2
288 .na
289 \fB\fB-r\fR\fR
290 .ad
291 .RS 6n
292 Displays error information for the \fBFC_AL\fR device specified by the
293 pathname, or, if the path is a \fBSENA,\fR for all devices on the loop. The
294 \fB-r\fR option only applies to \fBSENA\fR subsystems and individual
295 \fBFC_AL\fR devices.
296 .RE
298 .sp
299 .ne 2
300 .na
301 \fB\fB-v\fR\fR
302 .ad
303 .RS 6n
304 Displays in verbose mode, including mode sense data.
305 .RE
307 .RE
309 .sp
310 .ne 2
311 .na
312 \fB\fBdownload\fR [ \fB-s\fR ] [ \fB-f\fR \fIfilename_path\fR ]
313 \fIenclosure\fR.\|.\|.\fR
314 .ad
315 .sp .6
316 .RS 4n
317 Download the prom image pointed to the SENA subsystem Interface Board unit or
318 the Sun Fire 880 internal storage subsystem specified by the enclosure or
319 pathname.
320 .sp
321 When the \fBSENA's\fR download is complete, the \fBSENA\fR will be reset and
322 the downloaded code executed. If no filename is specified, the default prom
323 image will be used. The default prom image for the \fBSENA\fR is in the
324 directory \fBusr/lib/locale/C/LC_MESSAGES\fR and is named \fBibfirmware\fR
325 .sp
326 When the Sun Fire 880 internal storage subsystem's download is complete, the
327 subsystem resets and the downloaded code begins execution. The default firmware
328 image for the Sun Fire 880 internal storage subsystem is in:
329 \fB/usr/platform/SUNW,Sun-Fire-880/lib/images/int_fcbpl_fw\fR.
330 .sp
331 .ne 2
332 .na
333 \fB\fB-s\fR\fR
334 .ad
335 .RS 6n
336 Save. The \fB-s\fR option is used to save the downloaded firmware in the
337 FEPROM. If \fB-s\fR is not specified, the downloaded firmware will not be saved
338 across power cycles.
339 .sp
340 The \fB-s\fR option does not apply to the Sun Fire 880 internal storage
341 subsystem as it always stores downloaded firmware in the flash memory.
342 .sp
343 When using the \fB-s\fR option, the \fBdownload\fR subcommand modifies the
344 \fBFEPROM\fR on the subsystem and should be used with \fIcaution\fR.
345 .RE
347 .RE
349 .sp
350 .ne 2
351 .na
352 \fB\fBenclosure_name\fR \fInew_name\fR \fIenclosure\fR | \fIpathname\fR\fR
353 .ad
354 .sp .6
355 .RS 4n
356 Change the enclosure name of the enclosure or enclosures specified by the
357 enclosure or pathname. The new name (\fInew_name\fR) must be 16 or less
358 characters. Only alphabetic or numeric characters are acceptable. This
359 subcommand applies only to the SENA and the Sun Fire 880 internal storage
360 subsystem.
361 .RE
363 .sp
364 .ne 2
365 .na
366 \fB\fBfailover primary\fR | \fBsecondary\fR \fIpathname\fR\fR
367 .ad
368 .sp .6
369 .RS 4n
370 Select which Sun Storage T3 storage array partner group controller accesses a
371 given logical volume. If \fBprimary\fR is specified, the logical volume is
372 accessed through the primary controller. If \fBsecondary\fR is specified, the
373 logical volume is accessed through the secondary controller specified by
374 \fIpathname\fR.
375 .RE
377 .sp
378 .ne 2
379 .na
380 \fB\fBfcal_s_download\fR [ \fB-f\fR \fIfcode-file\fR ]\fR
381 .ad
382 .sp .6
383 .RS 4n
384 Download the fcode contained in the file \fIfcode-file\fR into \fIall\fR the
385 \fBFC100/S\fR Sbus Cards. This command is interactive and expects user
386 confirmation before downloading the fcode.
387 .sp
388 Use \fBfcal_s_download\fR \fIonly\fR in single-user mode. Using
389 \fBfcal_s_download\fR to update a host adapter while there is \fBI/O\fR
390 activity through that adapter \fIwill\fR cause the adapter to reset. Newly
391 updated FCode will not be executed or visible until a system reboot.
392 .sp
393 .ne 2
394 .na
395 \fB\fB-f\fR \fIfcode-file\fR\fR
396 .ad
397 .RS 17n
398 When invoked without the \fB-f\fR option, the current version of the fcode in
399 each \fBFC100/S\fR Sbus card is printed.
400 .RE
402 .RE
404 .sp
405 .ne 2
406 .na
407 \fB\fBfcode_download\fR \fB-p\fR\fR
408 .ad
409 .br
410 .na
411 \fB\fBfcode_download\fR \fB-d\fR \fIdir-name\fR\fR
412 .ad
413 .sp .6
414 .RS 4n
415 Locate the installed \fBFC/S\fR, \fBFC100/S, FC100/P\fR, or \fBFC100/2P\fR host
416 bus adapter cards and download the FCode files in \fIdir-name\fR to the
417 appropriate cards. The command determines the correct card for each type of
418 file, and is interactive. User confirmation is required before downloading the
419 FCode to each device.
420 .sp
421 Use \fBfcode_download\fR to load FCode only in single-user mode. Using
422 \fBfcode_download\fR to update a host adapter while there is \fBI/O\fR activity
423 through that adapter causes the adapter to reset. Newly updated FCode will not
424 be executed or visible until a system reboot.
425 .sp
426 .ne 2
427 .na
428 \fB\fB-d\fR \fIdir-name\fR\fR
429 .ad
430 .RS 15n
431 Download the FCode files contained in the directory \fIdir-name\fR to the
432 appropriate adapter cards.
433 .RE
435 .sp
436 .ne 2
437 .na
438 \fB\fB-p\fR\fR
439 .ad
440 .RS 15n
441 Prints the current version of FCode loaded on each card. No download is
442 performed.
443 .RE
445 .RE
447 .sp
448 .ne 2
449 .na
450 \fB\fBinquiry\fR \fIenclosure\fR[,\fIdev\fR ]\|.\|.\|.\| |
451 \fIpathname\fR\|.\|.\|.\fR
452 .ad
453 .sp .6
454 .RS 4n
455 Display the inquiry information for the selected device specified by the
456 enclosure or pathname.
457 .RE
459 .sp
460 .ne 2
461 .na
462 \fB\fBinsert_device\fR [ \fIenclosure\fR,\fIdev\fR\|.\|.\|. ]\fR
463 .ad
464 .sp .6
465 .RS 4n
466 Assist the user in the hot insertion of a new device or a chain of new devices.
467 Refer to \fBNOTES\fR for limitations on hotplug operations. This subcommand
468 applies only to the \fBSENA\fR, Sun Fire 880 internal storage subsystem, and
469 individual FC_AL drives. For the \fBSENA\fR, if more than one enclosure has
470 been specified, concurrent hot insertions on multiple busses can be performed.
471 With no arguments to the subcommand, entire enclosures or individual
472 \fBFC_AL\fR drives can be inserted. For the \fBSENA\fR or the Sun Fire 880
473 internal storage subsystem, this subcommand guides the user interactively
474 through the hot insertion steps of a new device or chain of devices. If a list
475 of disks was entered it will ask the user to verify the list of devices to be
476 inserted is correct, at which point the user can continue or quit. It then
477 interactively asks the user to insert the disk(s) or enclosure(s) and then
478 creates and displays the logical pathnames for the devices.
479 .RE
481 .sp
482 .ne 2
483 .na
484 \fB\fBled\fR \fIenclosure\fR,\fIdev\fR\|.\|.\|.\|| \fIpathname\fR.\|.\|.\fR
485 .ad
486 .sp .6
487 .RS 4n
488 Display the current state of the \fBLED\fR associated with the disk specified
489 by the enclosure or pathname. This subcommand only applies to subsystems that
490 support this functionality.
491 .RE
493 .sp
494 .ne 2
495 .na
496 \fB\fBled_blink\fR \fIenclosure\fR,\fIdev\fR\|.\|.\|.\||
497 \fIpathname\fR\|.\|.\|.\fR
498 .ad
499 .sp .6
500 .RS 4n
501 Requests the subsystem to start blinking the \fBLED\fR associated with the disk
502 specified by the enclosure or pathname. This subcommand only applies to
503 subsystems that support this functionality.
504 .RE
506 .sp
507 .ne 2
508 .na
509 \fB\fBled_off\fR \fIenclosure\fR,\fIdev\fR\|.\|.\|.\||
510 \fIpathname\fR\|.\|.\|.\fR
511 .ad
512 .sp .6
513 .RS 4n
514 Requests the subsystem to disable (turn off) the \fBLED\fR associated with the
515 disk specified by the enclosure or pathname. On a \fBSENA\fR subsystem, this
516 may or may not cause the \fBLED\fR to turn off or stop blinking depending on
517 the state of the \fBSENA\fR subsystem. Refer to the \fBSENA\fR Array
518 Installation and Service Manual (p/n 802-7573). This subcommand only applies to
519 subsystems that support this functionality.
520 .RE
522 .sp
523 .ne 2
524 .na
525 \fB\fBled_on\fR \fIpathname\fR\|.\|.\|.\fR
526 .ad
527 .sp .6
528 .RS 4n
529 Requests the subsystem to enable (turn on) the \fBLED\fR associated with the
530 disk specified by the pathname. This subcommand only applies to subsystems that
531 support this functionality.
532 .RE
534 .sp
535 .ne 2
536 .na
537 \fB\fBpower_off\fR [ \fB-F\fR ] \fIenclosure\fR[,\fIdev\fR]\|.\|.\|. |
538 \fIpathname\fR \|.\|.\|.\fR
539 .ad
540 .sp .6
541 .RS 4n
542 When a \fBSENA\fR is addressed, this subcommand causes the \fBSENA\fR subsystem
543 to go into the power-save mode. The \fBSENA\fR drives are not available when in
544 the power-save mode. When a drive in a \fBSENA\fR is addressed the drive is set
545 to the drive off/unmated state. In the drive off/unmated state, the drive is
546 spun down (stopped) and in bypass mode. This command does not apply to the Sun
547 Fire 880 internal storage subsystem.
548 .sp
549 .ne 2
550 .na
551 \fB\fB-F\fR\fR
552 .ad
553 .RS 6n
554 The force option only applies to the \fBSENA.\fR Instructs \fBluxadm\fR to
555 attempt to power off one or more devices even if those devices are being used
556 by this host (and are, therefore, busy).
557 .sp
558 \fBWarning\fR: Powering off a device which has data that is currently being
559 used will cause unpredictable results. Users should attempt to power off the
560 device normally (without \fB-F\fR) first, only resorting to this option when
561 sure of the consequences of overriding normal checks.
562 .RE
564 .RE
566 .sp
567 .ne 2
568 .na
569 \fB\fBpower_on\fR \fIenclosure\fR[\fB,\fR\fIdev\fR]\|.\|.\|\fR
570 .ad
571 .sp .6
572 .RS 4n
573 Causes the \fBSENA\fR subsystem to go out of the power-save mode, when this
574 subcommand is addressed to a \fBSENA.\fR. When this subcommand is addressed to
575 a drive the drive is set to its normal start-up state. This command does not
576 apply to the Sun Fire 880 internal storage subsystem.
577 .RE
579 .sp
580 .ne 2
581 .na
582 \fB\fBprobe\fR [ \fB-p\fR ]\fR
583 .ad
584 .sp .6
585 .RS 4n
586 Finds and displays information about all attached \fBSENA\fR subsystems, Sun
587 Fire 880 internal storage subsystems, and individual \fBFC_AL\fR devices,
588 including the logical pathname, the \fBWWNs,\fR and enclosure names. This
589 subcommand warns the user if it finds different \fBSENAs\fR with the same
590 enclosure names.
591 .sp
592 .ne 2
593 .na
594 \fB\fB-p\fR\fR
595 .ad
596 .RS 6n
597 Includes the physical pathname in the display.
598 .RE
600 .RE
602 .sp
603 .ne 2
604 .na
605 \fB\fBqlgc_s_download\fR [ \fB-f\fR \fIfcode-file\fR ]\fR
606 .ad
607 .sp .6
608 .RS 4n
609 Download the FCode contained in the file \fIfcode-file\fR into all the
610 \fBFC100/P\fR, \fBFC100/2P\fR \fBPCI\fR host adapter cards. This command is
611 interactive and expects user confirmation before downloading the FCode to each
612 device. Only use \fBqlgc_s_download\fR in single-user mode. Using
613 \fBqlgc_s_download\fR to update a host adapter while there is\fB I/O\fR
614 activity through that adapter will cause the adapter to reset. Newly updated
615 FCode will not be executed or visible until a system reboot.
616 .sp
617 .ne 2
618 .na
619 \fB\fB-f\fR \fIfcode-file\fR\fR
620 .ad
621 .RS 17n
622 When invoked without the \fB-f\fR option, the current version of the FCode in
623 each \fBFC100/P\fR,\fB FC100/2P PCI\fR card is printed.
624 .RE
626 .RE
628 .sp
629 .ne 2
630 .na
631 \fB\fBrelease\fR \fIpathname\fR\fR
632 .ad
633 .sp .6
634 .RS 4n
635 Release a reservation held on the specified disk. The pathname should be the
636 physical or logical pathname for the disk.
637 .sp
638 This subcommand is included for historical and diagnostic purposes only.
639 .RE
641 .sp
642 .ne 2
643 .na
644 \fB\fBremove_device\fR [ \fB-F\fR ] \fIenclosure\fR[,\fIdev\fR]\|.\|.\|.\||
645 \fIpathname\fR\|.\|.\|.\fR
646 .ad
647 .sp .6
648 .RS 4n
649 Assists the user in hot removing a device or a chain of devices. This
650 subcommand can also be used to remove entire enclosures. This subcommand
651 applies to the \fBSENA\fR, Sun Fire 880 internal storage subsystem, and
652 individual \fBFC_AL\fR drives. Refer to \fBNOTES\fR for limitations on hotplug
653 operations. For the \fBSENA\fR, Sun Fire 880 internal storage subsystem, and
654 individual \fBFC_AL\fR devices, this subcommand guides the user through the hot
655 removal of a device or devices. During execution it will ask the user to verify
656 the list of devices to be removed is correct, at which point the user can
657 continue or quit. It then prepares the disk(s) or enclosure(s) for removal and
658 interactively asks the user to remove the disk(s) or enclosure(s).
659 .sp
660 For Multi-Hosted disk, the steps taken are:
661 .RS +4
662 .TP
663 .ie t \(bu
664 .el o
665 Issue the \fBluxadm\fR \fBremove_device\fR command on the first host. When
666 prompted to continue, wait.
667 .RE
668 .RS +4
669 .TP
670 .ie t \(bu
671 .el o
672 Issue the \fBluxadm\fR \fBremove_device\fR command on the secondary hosts. When
673 prompted to continue, wait.
674 .RE
675 .RS +4
676 .TP
677 .ie t \(bu
678 .el o
679 Continue with the \fBremove_device\fR command on the first host. Remove the
680 device when prompted to do so.
681 .RE
682 .RS +4
683 .TP
684 .ie t \(bu
685 .el o
686 Complete the \fBluxadm\fR \fBremove_device\fR command on the additional hosts.
687 .RE
688 .sp
689 .ne 2
690 .na
691 \fB\fB-F\fR\fR
692 .ad
693 .RS 6n
694 Instructs \fBluxadm\fR to attempt to hot plug one or more devices even if those
695 devices are being used by this host (and are, therefore, \fBbusy\fR or
696 \fBreserved\fR), to \fBforce\fR the hotplugging operation.
697 .sp
698 \fBWarning\fR: Removal of a device which has data that is currently being used
699 will cause unpredictable results. Users should attempt to hotplug normally
700 (without \fB-F\fR) first, only resorting to this option when sure of the
701 consequences of overriding normal hotplugging checks.
702 .RE
704 .RE
706 .sp
707 .ne 2
708 .na
709 \fB\fBreserve\fR \fIpathname\fR\fR
710 .ad
711 .sp .6
712 .RS 4n
713 Reserve the specified disk for exclusive use by the issuing host. The pathname
714 used should be the physical or logical pathname for the disk.
715 .sp
716 This subcommand is included for historical and diagnostic purposes only.
717 .RE
719 .sp
720 .ne 2
721 .na
722 \fB\fBset_boot_dev\fR [ \fB-y\fR ] \fIpathname\fR\fR
723 .ad
724 .sp .6
725 .RS 4n
726 Set the boot-device variable in the system \fBPROM\fR to the physical device
727 name specified by \fIpathname\fR, which can be a block special device or the
728 pathname of the directory on which the boot file system is mounted. The command
729 normally runs interactively requesting confirmation for setting the default
730 boot-device in the \fBPROM\fR. The \fB-y\fR option can be used to run it
731 non-interactively, in which case no confirmation is requested or required.
732 .RE
734 .sp
735 .ne 2
736 .na
737 \fB\fBstart\fR \fIpathname\fR\fR
738 .ad
739 .sp .6
740 .RS 4n
741 Spin up the specified disk(s) in a SENA.
742 .RE
744 .sp
745 .ne 2
746 .na
747 \fB\fBstop\fR \fIpathname\fR...\fR
748 .ad
749 .sp .6
750 .RS 4n
751 Spin down the specified disks in a SENA.
752 .RE
754 .SS "SENA, Sun Fire 880 Internal Storage Subsystem, and Individual FC_AL Drive Expert Mode Subcommands"
755 .sp
756 .LP
757 The following subcommands are for expert use only, and are applicable only to
758 the \fBSENA\fR, Sun Fire 880 internal storage subsystem, and fiber channel
759 loops. They should only be used by users that are knowledgeable about the
760 \fBSENA\fR subsystem and fiber channel loops.
761 .sp
762 .LP
763 If you specify a disk to an expert subcommand that operates on a bus, the
764 subcommand operates on the bus to which the specified disk is attached.
765 .sp
766 .ne 2
767 .na
768 \fB\fB-e\fR \fBbypass\fR \fB[\fR\fB-ab\fR\fB]\fR \fIenclosure\fR,\fIdev\fR\fR
769 .ad
770 .br
771 .na
772 \fB\fB-e\fR \fBbypass\fR \fB-f\fR \fIenclosure\fR\fR
773 .ad
774 .sp .6
775 .RS 4n
776 Request the enclosure services controller to set the LRC (Loop Redundancy
777 Circuit) to the bypassed state for the port and device specified.
778 .sp
779 This subcommand supports the following options:
780 .sp
781 .ne 2
782 .na
783 \fB\fB-a\fR\fR
784 .ad
785 .RS 6n
786 Bypass port \fBa\fR of the device specified.
787 .RE
789 .sp
790 .ne 2
791 .na
792 \fB\fB-b\fR\fR
793 .ad
794 .RS 6n
795 Bypass port \fBb\fR of the device specified.
796 .RE
798 .RE
800 .sp
801 .ne 2
802 .na
803 \fB\fB-e\fR \fBdump_map\fR \fIfibre_channel_HBA_port\fR\fR
804 .ad
805 .sp .6
806 .RS 4n
807 Display WWN data for a target device or host bus adapter on the specified fibre
808 channel port. If there are no target devices on the specified port, an error is
809 returned.
810 .RE
812 .sp
813 .ne 2
814 .na
815 \fB\fB-e\fR \fBenable\fR \fB[\fR\fB-ab\fR\fB]\fR \fIenclosure\fR,\fIdev\fR\fR
816 .ad
817 .br
818 .na
819 \fB\fB-e\fR \fBenable\fR \fB-f\fR \fIenclosure\fR\fR
820 .ad
821 .sp .6
822 .RS 4n
823 Request the enclosure services controller to set the LRC (Loop Redundancy
824 Circuit) to the enabled state for the port and device specified.
825 .sp
826 This subcommand supports the following options:
827 .sp
828 .ne 2
829 .na
830 \fB\fB-a\fR\fR
831 .ad
832 .RS 6n
833 Enable port \fBa\fR of the device specified.
834 .RE
836 .sp
837 .ne 2
838 .na
839 \fB\fB-b\fR\fR
840 .ad
841 .RS 6n
842 Enable port \fBb\fR of the device specified.
843 .RE
845 .RE
847 .sp
848 .ne 2
849 .na
850 \fB\fB\fR\fB-e\fR \fBforcelip\fR \fIenclosure\fR[\fB,\fR\fIdev\fR] \|.\|.\|. |
851 \fIpathname\fR\|.\|.\|.\fR
852 .ad
853 .sp .6
854 .RS 4n
855 Force the link to reinitialize, using the Loop Initialization Primitive
856 (\fBLIP\fR) sequence. The enclosure or pathname can specify any device on the
857 loop. Use the pathname to specify a specific path for multiple loop
858 configurations.
859 .sp
860 This is an expert only command and should be used with caution. It will reset
861 all ports on the loop.
862 .RE
864 .sp
865 .ne 2
866 .na
867 \fB\fB\fR\fB-e\fR \fBrdls\fR \fIenclosure\fR[\fB,\fR\fIdev\fR] \|.\|.\|. |
868 \fIpathname\fR\|.\|.\|.\fR
869 .ad
870 .sp .6
871 .RS 4n
872 Read and display the link error status information for all available devices on
873 the loop that contains the device specified by the enclosure or pathname.
874 .RE
876 .SS "Other Expert Mode Subcommands"
877 .sp
878 .LP
879 See \fBNOTES\fR for limitations of these subcommands. They should only be used
880 by users that are knowledgeable about the systems they are managing.
881 .sp
882 .LP
883 These commands do not apply to the Sun Fire 880 internal storage subsystem.
884 .sp
885 .ne 2
886 .na
887 \fB\fB\fR\fB-e\fR \fBbus_getstate\fR \fIpathname\fR\fR
888 .ad
889 .RS 29n
890 Get and display the state of the specified bus.
891 .RE
893 .sp
894 .ne 2
895 .na
896 \fB\fB\fR\fB-e\fR \fBbus_quiesce\fR \fIpathname\fR\fR
897 .ad
898 .RS 29n
899 Quiesce the specified bus.
900 .RE
902 .sp
903 .ne 2
904 .na
905 \fB\fB\fR\fB-e\fR \fBbus_reset\fR \fIpathname\fR\fR
906 .ad
907 .RS 29n
908 Reset the specified bus only.
909 .RE
911 .sp
912 .ne 2
913 .na
914 \fB\fB\fR\fB-e\fR \fBbus_resetall\fR \fIpathname\fR\fR
915 .ad
916 .RS 29n
917 Reset the specified bus and all devices.
918 .RE
920 .sp
921 .ne 2
922 .na
923 \fB\fB\fR\fB-e\fR \fBbus_unquiesce\fR \fIpathname\fR\fR
924 .ad
925 .RS 29n
926 Unquiesce the specified bus. the specified device.
927 .RE
929 .sp
930 .ne 2
931 .na
932 \fB\fB\fR\fB-e\fR \fBdev_getstate\fR \fIpathname\fR\fR
933 .ad
934 .RS 29n
935 Get and display the state of the specified device.
936 .RE
938 .sp
939 .ne 2
940 .na
941 \fB\fB\fR\fB-e\fR \fBdev_reset\fR \fIpathname\fR\fR
942 .ad
943 .RS 29n
944 Reset the specified device.
945 .RE
947 .sp
948 .ne 2
949 .na
950 \fB\fB\fR\fB-e\fR \fBoffline\fR \fIpathname\fR\fR
951 .ad
952 .RS 29n
953 Take the specified device offline.
954 .RE
956 .sp
957 .ne 2
958 .na
959 \fB\fB\fR\fB-e\fR \fBonline\fR \fIpathname\fR\fR
960 .ad
961 .RS 29n
962 Put the specified device online.
963 .RE
965 .SH EXAMPLES
966 .LP
967 \fBExample 1 \fRDisplaying the \fBSENA\fRs and Individual FC_AL Devices on a
968 System
969 .sp
970 .LP
971 The following example finds and displays all of the \fBSENA\fRs and individual
972 \fBFC_AL\fR devices on a system:
974 .sp
975 .in +2
976 .nf
977 example% \fBluxadm probe\fR
978 .fi
979 .in -2
980 .sp
982 .LP
983 \fBExample 2 \fRDisplaying a \fBSENA\fR or Sun Fire 880 Internal Storage
984 Subsystem
985 .sp
986 .LP
987 The following example displays a \fBSENA\fR or Sun Fire 880 internal storage
988 subsystem:
990 .sp
991 .in +2
992 .nf
993 example% \fBluxadm display /dev/es/ses0\fR
994 .fi
995 .in -2
996 .sp
998 .LP
999 \fBExample 3 \fRDisplaying Two Subsystems
1000 .sp
1001 .LP
1002 The following example displays two subsystems using the enclosure names:
1004 .sp
1005 .in +2
1006 .nf
1007 example% \fBluxadm display BOB system1\fR
1008 .fi
1009 .in -2
1010 .sp
1012 .LP
1013 \fBExample 4 \fRDisplaying Information about the First Disk
1014 .sp
1015 .LP
1016 The following example displays information about the first disk in the front of
1017 the enclosure named \fBBOB.\fR Use \fBf\fR to specify the front disks. Use
1018 \fBr\fR to specify the rear disks.
1020 .sp
1021 .in +2
1022 .nf
1023 example% \fBluxadm display BOB,f0\fR
1024 .fi
1025 .in -2
1026 .sp
1028 .LP
1029 \fBExample 5 \fRDisplaying Information on a Sun Fire 880 Internal Storage
1030 Subsystem
1031 .sp
1032 .LP
1033 The Sun Fire 880 internal storage subsystem has only one set of disks. In this
1034 case, use \fIs\fR to specify the slot:
1036 .sp
1037 .in +2
1038 .nf
1039 example% \fBluxadm display BOB,s0\fR
1040 .fi
1041 .in -2
1042 .sp
1044 .LP
1045 \fBExample 6 \fRDisplaying Information about a \fBSENA\fR disk, an Enclosure,
1046 or an Individual \fBFC_AL\fR Drive
1047 .sp
1048 .LP
1049 The following example displays information about a \fBSENA\fR disk, an
1050 enclosure, or an individual \fBFC_AL\fR drive with the port \fBWWN\fR of
1051 \fB2200002037001246\fR:
1053 .sp
1054 .in +2
1055 .nf
1056 example% \fBluxadm display 2200002037001246\fR
1057 .fi
1058 .in -2
1059 .sp
1061 .LP
1062 \fBExample 7 \fRUsing Unique Characters to Issue a Subcommand
1063 .sp
1064 .LP
1065 The following example uses only as many characters as are required to uniquely
1066 identify a subcommand:
1068 .sp
1069 .in +2
1070 .nf
1071 example% \fBluxadm disp BOB\fR
1072 .fi
1073 .in -2
1074 .sp
1076 .LP
1077 \fBExample 8 \fRDisplaying Error Information
1078 .sp
1079 .LP
1080 The following example displays error information about the loop that the
1081 enclosure \fBBOB\fR is on:
1083 .sp
1084 .in +2
1085 .nf
1086 example% \fBluxadm display \fR\fB-r\fR\fB BOB\fR
1087 .fi
1088 .in -2
1089 .sp
1091 .LP
1092 \fBExample 9 \fRDownloading New Firmware into the Interface Board
1093 .sp
1094 .LP
1095 The following example downloads new firmware into the Interface Board in the
1096 enclosure named \fBBOB\fR (using the default path for the file to download):
1098 .sp
1099 .in +2
1100 .nf
1101 example% \fBluxadm download \fR\fB-s\fR\fB BOB\fR
1102 .fi
1103 .in -2
1104 .sp
1106 .LP
1107 \fBExample 10 \fRDisplaying Information from the \fBSCSI\fR Inquiry Command
1108 .sp
1109 .LP
1110 The following example displays information from the \fBSCSI\fR inquiry command
1111 from all individual disks on the system, using only as many characters as
1112 necessary to uniquely identify the inquiry subcommand:
1114 .sp
1115 .in +2
1116 .nf
1117 example% \fBluxadm inq /dev/rdsk/c?t?d?s2\fR
1118 .fi
1119 .in -2
1120 .sp
1122 .LP
1123 \fBExample 11 \fRHotplugging
1124 .sp
1125 .LP
1126 The following example hotplugs a new drive into the first slot in the front of
1127 the enclosure named \fBBOB:\fR
1129 .sp
1130 .in +2
1131 .nf
1132 example% \fBluxadm insert_device BOB,f0\fR
1133 .fi
1134 .in -2
1135 .sp
1137 .sp
1138 .LP
1139 The following example hotplugs a new drive into the first slot in the Sun Fire
1140 880 internal storage subsystem named SF880-1:
1142 .sp
1143 .in +2
1144 .nf
1145 example% \fBluxadm insert_device SF880-1,s0\fR
1146 .fi
1147 .in -2
1148 .sp
1150 .LP
1151 \fBExample 12 \fRRunning an Expert Subcommand
1152 .sp
1153 .LP
1154 The following example runs an expert subcommand. The subcommand forces a loop
1155 initialization on the loop that the enclosure \fBBOB\fR is on:
1157 .sp
1158 .in +2
1159 .nf
1160 example% \fBluxadm \fR\fB-e\fR\fB forcelip BOB\fR
1161 .fi
1162 .in -2
1163 .sp
1165 .LP
1166 \fBExample 13 \fRUsing the Expert Mode Hot Plugging Subcommands
1167 .sp
1168 .LP
1169 An example of using the expert mode hot plugging subcommands to hot remove a
1170 disk follows. See \fBNOTES\fR for hot plugging limitations.
1172 .sp
1173 .LP
1174 The first step reserves the SCSI device so that it can't be accessed by way of
1175 its second SCSI bus:
1177 .sp
1178 .in +2
1179 .nf
1180 example# \fBluxadm reserve /dev/rdsk/c1t8d0s2\fR
1181 .fi
1182 .in -2
1183 .sp
1185 .LP
1186 \fBExample 14 \fRTaking the Disk to be Removed Offline
1187 .sp
1188 .LP
1189 The next two steps take the disk to be removed offline then quiesce the bus:
1191 .sp
1192 .in +2
1193 .nf
1194 example# \fBluxadm \fR\fB-e\fR\fB offline /dev/rdsk/c1t8d0s2\fR
1195 example# \fBluxadm -e bus_quiesce /dev/rdsk/c1t8d0s2\fR
1196 .fi
1197 .in -2
1198 .sp
1200 .LP
1201 \fBExample 15 \fRUnquiescing the Bus
1202 .sp
1203 .LP
1204 The user then removes the disk and continues by unquiescing the bus, putting
1205 the disk back online, then unreserving it:
1207 .sp
1208 .in +2
1209 .nf
1210 example# \fBluxadm \fR\fB-e\fR\fB bus_unquiesce /dev/rdsk/c1t8d0s2\fR
1211 example# \fBluxadm \fR\fB-e\fR\fB online /dev/rdsk/c1t8d0s2\fR
1212 example# \fBluxadm release /dev/rdsk/c1t8d0s2\fR
1213 .fi
1214 .in -2
1215 .sp
1217 .SH ENVIRONMENT VARIABLES
1218 .sp
1219 .LP
1220 See \fBenviron\fR(5) for a description of the \fBLANG\fR environment variable
1221 that affects the execution of \fBluxadm\fR.
1222 .SH EXIT STATUS
1223 .sp
1224 .LP
1225 The following exit values are returned:
1226 .sp
1227 .ne 2
1228 .na
1229 \fB\fB0\fR\fR
1230 .ad
1231 .RS 9n
1232 Successful completion.
1233 .RE
1235 .sp
1236 .ne 2
1237 .na
1238 \fB\fB\(mi1\fR\fR
1239 .ad
1240 .RS 9n
1241 An error occurred.
1242 .RE
1244 .SH FILES
1245 .sp
1246 .ne 2
1247 .na
1248 \fB\fBusr/lib/firmware/fc_s/fc_s_fcode\fR\fR
1249 .ad
1250 .sp .6
1251 .RS 4n
1253 .RE
1255 .sp
1256 .ne 2
1257 .na
1258 \fB\fBusr/lib/locale/C/LC_MESSAGES/ibfirmware\fR\fR
1259 .ad
1260 .sp .6
1261 .RS 4n
1263 .RE
1265 .SH SEE ALSO
1266 .sp
1267 .LP
1268 \fBdevlinks\fR(1M), \fBdisks\fR(1M), \fBattributes\fR(5), \fBenviron\fR(5),
1269 \fBses\fR( 7D)
1270 .sp
1271 .LP
1272 \fISENA Array Installation and Service Manual\fR (p/n 802-7573).
1273 .sp
1274 .LP
1275 \fIRAID Manager 6.1 Installation and Support Guide Answerbook\fR
1276 .sp
1277 .LP
1278 \fIRAID Manager 6.1 User's Guide Answerbook\fR
1279 .SH NOTES
1280 .sp
1281 .LP
1282 See the \fISENA Array Installation and Service Manual\fR for additional
1283 information on the \fBSENA.\fR Refer to \fITutorial for SCSI use of IEEE
1284 Company_ID\fR, R. Snively, for additional information regarding the \fBIEEE\fR
1285 extended \fBWWN.\fR See \fBSEE ALSO\fR. Currently, only some device drivers
1286 support hot plugging. If hot plugging is attempted on a disk or bus where it is
1287 not supported, an error message of the form:
1288 .sp
1289 .in +2
1290 .nf
1291 luxadm: can't acquire "PATHNAME": No such file or directory
1292 .fi
1293 .in -2
1294 .sp
1296 .sp
1297 .LP
1298 will be displayed.
1299 .sp
1300 .LP
1301 You must be careful not to quiesce a bus that contains the root or the
1302 \fB/usr\fR filesystems or any swap data. If you do quiesce such a bus a
1303 deadlock can result, requiring a system reboot.