Print this page
12745 man page typos
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1m/luxadm.1m.man.txt
+++ new/usr/src/man/man1m/luxadm.1m.man.txt
1 1 LUXADM(1M) Maintenance Commands LUXADM(1M)
2 2
3 3
4 4
5 5 NAME
6 6 luxadm - administer Sun Fire 880 storage subsystem and FC_AL devices
7 7
8 8 SYNOPSIS
9 9 luxadm [options]... subcommand [options]... enclosure
10 10 [,dev] | pathname...
11 11
12 12
13 13 DESCRIPTION
14 14 The luxadm program is an administrative command that manages the SENA,
15 15 Sun Fire 880 internal storage subsystem, and individual Fiber Channel
16 16 Arbitrated Loop (FC_AL) devices. luxadm performs a variety of control
17 17 and query tasks depending on the command line arguments and options
18 18 used.
19 19
20 20
21 21 The command line must contain a subcommand. The command line may also
22 22 contain options, usually at least one enclosure name or pathname, and
23 23 other parameters depending on the subcommand. You need specify only as
24 24 many characters as are required to uniquely identify a subcommand.
25 25
26 26
27 27 Specify the device that a subcommand interacts with by entering a
28 28 pathname. For the SENA subsystem, a disk device or enclosure services
29 29 controller may instead be specified by entering the World Wide Name
30 30 (WWN) for the device or a port to the device. The device may also be
31 31 specified by entering the name of the SENA enclosure, and an optional
32 32 identifier for the particular device in the enclosure. The individual
33 33 FC_AL devices may be specified by entering the WWN for the device or a
34 34 port to the device.
35 35
36 36 Pathname
37 37 Specify the device or controller by either a complete physical pathname
38 38 or a complete logical pathname.
39 39
40 40
41 41 For SENA, a typical physical pathname for a device is:
42 42
43 43 /devices/sbus@1f,0/SUNW,socal@1,0/sf@0,0/ssd@w2200002037000f96,
44 44 0:a,raw
45 45
46 46
47 47
48 48
49 49 For all SENA IBs (Interface Boards) and Sun Fire 880 SES device
50 50 controllers on the system, a logical link to the physical paths is kept
51 51 in the directory /dev/es. An example of a logical link is /dev/es/ses0.
52 52
53 53
54 54 The WWN may be used in place of the pathname to select an FC_AL device,
55 55 SENA subsystem IB, or Sun Fire 880 internal storage subsystem. The WWN
56 56 is a unique 16 hexadecimal digit value that specifies either the port
57 57 used to access the device or the device itself. A typical WWN value is:
58 58
59 59 2200002037000f96
60 60
61 61
62 62
63 63
64 64 See NOTES for more information on the WWN formats.
65 65
66 66
67 67 For a disk in a Sun Fire 880 internal storage subsystem, a typical
68 68 physical pathname is:
69 69
70 70 /devices/pci@8,600000/SUNW,qlc@2/fp@0,0/ssd@w2100002037a6303c,0:a
71 71
72 72
73 73
74 74
75 75 and a typical logical pathname is:
76 76
77 77 /dev/rdsk/c2t8d0s2
78 78
79 79
80 80
81 81
82 82 For individual FC_AL devices, a typical physical pathname is:
83 83
84 84 /devices/sbus@3.0/SUNW,socal@d,10000/sf@0,0/ssd@w2200002037049fc3,0:a,raw
85 85
86 86
87 87
88 88
89 89 and a typical logical pathname is:
90 90
91 91 /dev/rdsk/c1t0d0s2
92 92
93 93
94 94
95 95 Enclosure
96 96 For SENA, a device may be identified by its enclosure name and
97 97 slotname:
98 98 box_name[,fslot_number]
99 99 box_name[,rslot_number]
100 100
101 101
102 102 box_name is the name of the SENA enclosure, as specified by the
103 103 enclosure_name subcommand. When used without the optional slot_number
104 104 parameter, the box_name identifies the SENA subsystem IB.
105 105
106 106
107 107 f or r specifies the front or rear slots in the SENA enclosure.
108 108
109 109
110 110 slot_number specifies the slot number of the device in the SENA
111 111 enclosure, 0-6 or 0-10.
112 112
113 113
114 114 For a Sun Fire 880 internal storage subsystem, a device may also be
115 115 identified by its enclosure name and slot name. However, there is only
116 116 one set of disks:
117 117
118 118 box_name[,sslot_number]
119 119
120 120
121 121
122 122
123 123 box_name is the name of the Sun Fire 880 enclosure, as specified by the
124 124 enclosure_name subcommand. When used without the optional slot_number
125 125 parameter, box_name identifies the Sun Fire 880 internal storage
126 126 subsystem enclosure services device. Use s to specify the disk slot
127 127 number in the Sun Fire 880 internal storage subsystem, 0 - 11.
128 128
129 129
130 130 See disks(1M) and devlinks(1M) for additional information on logical
131 131 names for disks and subsystems.
132 132
133 133 OPTIONS
134 134 The following options are supported by all subcommands:
135 135
136 136 -e
137 137 Expert mode. This option is not recommended for the novice user.
138 138
139 139
140 140 -v
141 141 Verbose mode.
142 142
143 143
144 144
145 145 Options that are specific to particular subcommands are described with
146 146 the subcommand in the USAGE section.
147 147
148 148 OPERANDS
149 149 The following operands are supported:
150 150
151 151 enclosure
152 152
153 153 The box_name of the SENA or Sun Fire 880 internal storage
154 154 subsystem.
155 155
156 156
157 157 fibre_channel_HBA_port
158 158
159 159 The path to the host controller port. A typical path is:
160 160
161 161 /devices/pci@8,600000/pci@1/SUNW,qlc@4/fp@0,0:devctl
162 162
163 163
164 164
165 165
166 166 pathname
167 167
168 168 The logical or physical path of a SENA IB, Sun Fire 880 internal
169 169 storage subsystem, or disk device. pathname can also be the WWN of
170 170 a SENA IB, SENA disk, or individual FC_AL device.
171 171
172 172
173 173 USAGE
174 174 Subcommands
175 175 display enclosure[,dev]...| pathname...
176 176 display -p pathname...
177 177 display -r enclosure[,dev]...| pathname...
178 178 display -v enclosure[,dev]...| pathname...
179 179
180 180 Displays enclosure or device specific data.
181 181
182 182 Subsystem data consists of enclosure environmental sense
183 183 information and status for all subsystem devices, including disks.
184 184
185 185 Disk data consists of inquiry, capacity, and configuration
186 186 information.
187 187
188 188 -p
189 189 Displays performance information for the device or subsystem
190 190 specified by pathname. This option only applies to subsystems
191 191 that accumulate performance information.
192 192
193 193
194 194 -r
195 195 Displays error information for the FC_AL device specified by
196 196 the pathname, or, if the path is a SENA, for all devices on
197 197 the loop. The -r option only applies to SENA subsystems and
198 198 individual FC_AL devices.
199 199
200 200
201 201 -v
202 202 Displays in verbose mode, including mode sense data.
203 203
204 204
|
↓ open down ↓ |
204 lines elided |
↑ open up ↑ |
205 205
206 206 download [ -s ] [ -f filename_path ] enclosure...
207 207
208 208 Download the prom image pointed to the SENA subsystem Interface
209 209 Board unit or the Sun Fire 880 internal storage subsystem specified
210 210 by the enclosure or pathname.
211 211
212 212 When the SENA's download is complete, the SENA will be reset and
213 213 the downloaded code executed. If no filename is specified, the
214 214 default prom image will be used. The default prom image for the
215 - SENA is in the directory usr/lib/locale/C/LC_MESSAGES and is named
215 + SENA is in the directory /usr/lib/locale/C/LC_MESSAGES and is named
216 216 ibfirmware
217 217
218 218 When the Sun Fire 880 internal storage subsystem's download is
219 219 complete, the subsystem resets and the downloaded code begins
220 220 execution. The default firmware image for the Sun Fire 880 internal
221 221 storage subsystem is in: /usr/platform/SUNW,Sun-
222 222 Fire-880/lib/images/int_fcbpl_fw.
223 223
224 224 -s
225 225 Save. The -s option is used to save the downloaded firmware
226 226 in the FEPROM. If -s is not specified, the downloaded
227 227 firmware will not be saved across power cycles.
228 228
229 229 The -s option does not apply to the Sun Fire 880 internal
230 230 storage subsystem as it always stores downloaded firmware in
231 231 the flash memory.
232 232
233 233 When using the -s option, the download subcommand modifies
234 234 the FEPROM on the subsystem and should be used with caution.
235 235
236 236
237 237
238 238 enclosure_name new_name enclosure | pathname
239 239
240 240 Change the enclosure name of the enclosure or enclosures specified
241 241 by the enclosure or pathname. The new name (new_name) must be 16 or
242 242 less characters. Only alphabetic or numeric characters are
243 243 acceptable. This subcommand applies only to the SENA and the Sun
244 244 Fire 880 internal storage subsystem.
245 245
246 246
247 247 failover primary | secondary pathname
248 248
249 249 Select which Sun Storage T3 storage array partner group controller
250 250 accesses a given logical volume. If primary is specified, the
251 251 logical volume is accessed through the primary controller. If
252 252 secondary is specified, the logical volume is accessed through the
253 253 secondary controller specified by pathname.
254 254
255 255
256 256 fcal_s_download [ -f fcode-file ]
257 257
258 258 Download the fcode contained in the file fcode-file into all the
259 259 FC100/S Sbus Cards. This command is interactive and expects user
260 260 confirmation before downloading the fcode.
261 261
262 262 Use fcal_s_download only in single-user mode. Using fcal_s_download
263 263 to update a host adapter while there is I/O activity through that
264 264 adapter will cause the adapter to reset. Newly updated FCode will
265 265 not be executed or visible until a system reboot.
266 266
267 267 -f fcode-file
268 268 When invoked without the -f option, the current
269 269 version of the fcode in each FC100/S Sbus card is
270 270 printed.
271 271
272 272
273 273
274 274 fcode_download -p
275 275 fcode_download -d dir-name
276 276
277 277 Locate the installed FC/S, FC100/S, FC100/P, or FC100/2P host bus
278 278 adapter cards and download the FCode files in dir-name to the
279 279 appropriate cards. The command determines the correct card for each
280 280 type of file, and is interactive. User confirmation is required
281 281 before downloading the FCode to each device.
282 282
283 283 Use fcode_download to load FCode only in single-user mode. Using
284 284 fcode_download to update a host adapter while there is I/O activity
285 285 through that adapter causes the adapter to reset. Newly updated
286 286 FCode will not be executed or visible until a system reboot.
287 287
288 288 -d dir-name
289 289 Download the FCode files contained in the directory
290 290 dir-name to the appropriate adapter cards.
291 291
292 292
293 293 -p
294 294 Prints the current version of FCode loaded on each
295 295 card. No download is performed.
296 296
297 297
298 298
299 299 inquiry enclosure[,dev ]... | pathname...
300 300
301 301 Display the inquiry information for the selected device specified
302 302 by the enclosure or pathname.
303 303
304 304
305 305 insert_device [ enclosure,dev... ]
306 306
307 307 Assist the user in the hot insertion of a new device or a chain of
308 308 new devices. Refer to NOTES for limitations on hotplug operations.
309 309 This subcommand applies only to the SENA, Sun Fire 880 internal
310 310 storage subsystem, and individual FC_AL drives. For the SENA, if
311 311 more than one enclosure has been specified, concurrent hot
312 312 insertions on multiple busses can be performed. With no arguments
313 313 to the subcommand, entire enclosures or individual FC_AL drives can
314 314 be inserted. For the SENA or the Sun Fire 880 internal storage
315 315 subsystem, this subcommand guides the user interactively through
316 316 the hot insertion steps of a new device or chain of devices. If a
317 317 list of disks was entered it will ask the user to verify the list
318 318 of devices to be inserted is correct, at which point the user can
319 319 continue or quit. It then interactively asks the user to insert the
320 320 disk(s) or enclosure(s) and then creates and displays the logical
321 321 pathnames for the devices.
322 322
323 323
324 324 led enclosure,dev...| pathname...
325 325
326 326 Display the current state of the LED associated with the disk
327 327 specified by the enclosure or pathname. This subcommand only
328 328 applies to subsystems that support this functionality.
329 329
330 330
331 331 led_blink enclosure,dev...| pathname...
332 332
333 333 Requests the subsystem to start blinking the LED associated with
334 334 the disk specified by the enclosure or pathname. This subcommand
335 335 only applies to subsystems that support this functionality.
336 336
337 337
338 338 led_off enclosure,dev...| pathname...
339 339
340 340 Requests the subsystem to disable (turn off) the LED associated
341 341 with the disk specified by the enclosure or pathname. On a SENA
342 342 subsystem, this may or may not cause the LED to turn off or stop
343 343 blinking depending on the state of the SENA subsystem. Refer to the
344 344 SENA Array Installation and Service Manual (p/n 802-7573). This
345 345 subcommand only applies to subsystems that support this
346 346 functionality.
347 347
348 348
349 349 led_on pathname...
350 350
351 351 Requests the subsystem to enable (turn on) the LED associated with
352 352 the disk specified by the pathname. This subcommand only applies to
353 353 subsystems that support this functionality.
354 354
355 355
356 356 power_off [ -F ] enclosure[,dev]... | pathname ...
357 357
358 358 When a SENA is addressed, this subcommand causes the SENA subsystem
359 359 to go into the power-save mode. The SENA drives are not available
360 360 when in the power-save mode. When a drive in a SENA is addressed
361 361 the drive is set to the drive off/unmated state. In the drive
362 362 off/unmated state, the drive is spun down (stopped) and in bypass
363 363 mode. This command does not apply to the Sun Fire 880 internal
364 364 storage subsystem.
365 365
366 366 -F
367 367 The force option only applies to the SENA. Instructs luxadm
368 368 to attempt to power off one or more devices even if those
369 369 devices are being used by this host (and are, therefore,
370 370 busy).
371 371
372 372 Warning: Powering off a device which has data that is
373 373 currently being used will cause unpredictable results. Users
374 374 should attempt to power off the device normally (without -F)
375 375 first, only resorting to this option when sure of the
376 376 consequences of overriding normal checks.
377 377
378 378
379 379
380 380 power_on enclosure[,dev]..
381 381
382 382 Causes the SENA subsystem to go out of the power-save mode, when
383 383 this subcommand is addressed to a SENA.. When this subcommand is
384 384 addressed to a drive the drive is set to its normal start-up state.
385 385 This command does not apply to the Sun Fire 880 internal storage
386 386 subsystem.
387 387
388 388
389 389 probe [ -p ]
390 390
391 391 Finds and displays information about all attached SENA subsystems,
392 392 Sun Fire 880 internal storage subsystems, and individual FC_AL
393 393 devices, including the logical pathname, the WWNs, and enclosure
394 394 names. This subcommand warns the user if it finds different SENAs
395 395 with the same enclosure names.
396 396
397 397 -p
398 398 Includes the physical pathname in the display.
399 399
400 400
401 401
402 402 qlgc_s_download [ -f fcode-file ]
403 403
404 404 Download the FCode contained in the file fcode-file into all the
405 405 FC100/P, FC100/2P PCI host adapter cards. This command is
406 406 interactive and expects user confirmation before downloading the
407 407 FCode to each device. Only use qlgc_s_download in single-user mode.
408 408 Using qlgc_s_download to update a host adapter while there is I/O
409 409 activity through that adapter will cause the adapter to reset.
410 410 Newly updated FCode will not be executed or visible until a system
411 411 reboot.
412 412
413 413 -f fcode-file
414 414 When invoked without the -f option, the current
415 415 version of the FCode in each FC100/P, FC100/2P PCI
416 416 card is printed.
417 417
418 418
419 419
420 420 release pathname
421 421
422 422 Release a reservation held on the specified disk. The pathname
423 423 should be the physical or logical pathname for the disk.
424 424
425 425 This subcommand is included for historical and diagnostic purposes
426 426 only.
427 427
428 428
429 429 remove_device [ -F ] enclosure[,dev]...| pathname...
430 430
431 431 Assists the user in hot removing a device or a chain of devices.
432 432 This subcommand can also be used to remove entire enclosures. This
433 433 subcommand applies to the SENA, Sun Fire 880 internal storage
434 434 subsystem, and individual FC_AL drives. Refer to NOTES for
435 435 limitations on hotplug operations. For the SENA, Sun Fire 880
436 436 internal storage subsystem, and individual FC_AL devices, this
437 437 subcommand guides the user through the hot removal of a device or
438 438 devices. During execution it will ask the user to verify the list
439 439 of devices to be removed is correct, at which point the user can
440 440 continue or quit. It then prepares the disk(s) or enclosure(s) for
441 441 removal and interactively asks the user to remove the disk(s) or
442 442 enclosure(s).
443 443
444 444 For Multi-Hosted disk, the steps taken are:
445 445
446 446 o Issue the luxadm remove_device command on the first
447 447 host. When prompted to continue, wait.
448 448
449 449 o Issue the luxadm remove_device command on the secondary
450 450 hosts. When prompted to continue, wait.
451 451
452 452 o Continue with the remove_device command on the first
453 453 host. Remove the device when prompted to do so.
454 454
455 455 o Complete the luxadm remove_device command on the
456 456 additional hosts.
457 457
458 458 -F
459 459 Instructs luxadm to attempt to hot plug one or more devices
460 460 even if those devices are being used by this host (and are,
461 461 therefore, busy or reserved), to force the hotplugging
462 462 operation.
463 463
464 464 Warning: Removal of a device which has data that is currently
465 465 being used will cause unpredictable results. Users should
466 466 attempt to hotplug normally (without -F) first, only
467 467 resorting to this option when sure of the consequences of
468 468 overriding normal hotplugging checks.
469 469
470 470
471 471
472 472 reserve pathname
473 473
474 474 Reserve the specified disk for exclusive use by the issuing host.
475 475 The pathname used should be the physical or logical pathname for
476 476 the disk.
477 477
478 478 This subcommand is included for historical and diagnostic purposes
479 479 only.
480 480
481 481
482 482 set_boot_dev [ -y ] pathname
483 483
484 484 Set the boot-device variable in the system PROM to the physical
485 485 device name specified by pathname, which can be a block special
486 486 device or the pathname of the directory on which the boot file
487 487 system is mounted. The command normally runs interactively
488 488 requesting confirmation for setting the default boot-device in the
489 489 PROM. The -y option can be used to run it non-interactively, in
490 490 which case no confirmation is requested or required.
491 491
492 492
493 493 start pathname
494 494
495 495 Spin up the specified disk(s) in a SENA.
496 496
497 497
498 498 stop pathname...
499 499
500 500 Spin down the specified disks in a SENA.
501 501
502 502
503 503 SENA, Sun Fire 880 Internal Storage Subsystem, and Individual FC_AL Drive
504 504 Expert Mode Subcommands
505 505 The following subcommands are for expert use only, and are applicable
506 506 only to the SENA, Sun Fire 880 internal storage subsystem, and fiber
507 507 channel loops. They should only be used by users that are knowledgeable
508 508 about the SENA subsystem and fiber channel loops.
509 509
510 510
511 511 If you specify a disk to an expert subcommand that operates on a bus,
512 512 the subcommand operates on the bus to which the specified disk is
513 513 attached.
514 514
515 515 -e bypass [-ab] enclosure,dev
516 516 -e bypass -f enclosure
517 517
518 518 Request the enclosure services controller to set the LRC (Loop
519 519 Redundancy Circuit) to the bypassed state for the port and device
520 520 specified.
521 521
522 522 This subcommand supports the following options:
523 523
524 524 -a
525 525 Bypass port a of the device specified.
526 526
527 527
528 528 -b
529 529 Bypass port b of the device specified.
530 530
531 531
532 532
533 533 -e dump_map fibre_channel_HBA_port
534 534
535 535 Display WWN data for a target device or host bus adapter on the
536 536 specified fibre channel port. If there are no target devices on the
537 537 specified port, an error is returned.
538 538
539 539
540 540 -e enable [-ab] enclosure,dev
541 541 -e enable -f enclosure
542 542
543 543 Request the enclosure services controller to set the LRC (Loop
544 544 Redundancy Circuit) to the enabled state for the port and device
545 545 specified.
546 546
547 547 This subcommand supports the following options:
548 548
549 549 -a
550 550 Enable port a of the device specified.
551 551
552 552
553 553 -b
554 554 Enable port b of the device specified.
555 555
556 556
557 557
558 558 -e forcelip enclosure[,dev] ... | pathname...
559 559
560 560 Force the link to reinitialize, using the Loop Initialization
561 561 Primitive (LIP) sequence. The enclosure or pathname can specify any
562 562 device on the loop. Use the pathname to specify a specific path for
563 563 multiple loop configurations.
564 564
565 565 This is an expert only command and should be used with caution. It
566 566 will reset all ports on the loop.
567 567
568 568
569 569 -e rdls enclosure[,dev] ... | pathname...
570 570
571 571 Read and display the link error status information for all
572 572 available devices on the loop that contains the device specified by
573 573 the enclosure or pathname.
574 574
575 575
576 576 Other Expert Mode Subcommands
577 577 See NOTES for limitations of these subcommands. They should only be
578 578 used by users that are knowledgeable about the systems they are
579 579 managing.
580 580
581 581
582 582 These commands do not apply to the Sun Fire 880 internal storage
583 583 subsystem.
584 584
585 585 -e bus_getstate pathname
586 586 Get and display the state of the specified
587 587 bus.
588 588
589 589
590 590 -e bus_quiesce pathname
591 591 Quiesce the specified bus.
592 592
593 593
594 594 -e bus_reset pathname
595 595 Reset the specified bus only.
596 596
597 597
598 598 -e bus_resetall pathname
599 599 Reset the specified bus and all devices.
600 600
601 601
602 602 -e bus_unquiesce pathname
603 603 Unquiesce the specified bus. the specified
604 604 device.
605 605
606 606
607 607 -e dev_getstate pathname
608 608 Get and display the state of the specified
609 609 device.
610 610
611 611
612 612 -e dev_reset pathname
613 613 Reset the specified device.
614 614
615 615
616 616 -e offline pathname
617 617 Take the specified device offline.
618 618
619 619
620 620 -e online pathname
621 621 Put the specified device online.
622 622
623 623
624 624 EXAMPLES
625 625 Example 1 Displaying the SENAs and Individual FC_AL Devices on a System
626 626
627 627
628 628 The following example finds and displays all of the SENAs and
629 629 individual FC_AL devices on a system:
630 630
631 631
632 632 example% luxadm probe
633 633
634 634
635 635
636 636 Example 2 Displaying a SENA or Sun Fire 880 Internal Storage Subsystem
637 637
638 638
639 639 The following example displays a SENA or Sun Fire 880 internal storage
640 640 subsystem:
641 641
642 642
643 643 example% luxadm display /dev/es/ses0
644 644
645 645
646 646
647 647 Example 3 Displaying Two Subsystems
648 648
649 649
650 650 The following example displays two subsystems using the enclosure
651 651 names:
652 652
653 653
654 654 example% luxadm display BOB system1
655 655
656 656
657 657
658 658 Example 4 Displaying Information about the First Disk
659 659
660 660
661 661 The following example displays information about the first disk in the
662 662 front of the enclosure named BOB. Use f to specify the front disks. Use
663 663 r to specify the rear disks.
664 664
665 665
666 666 example% luxadm display BOB,f0
667 667
668 668
669 669
670 670 Example 5 Displaying Information on a Sun Fire 880 Internal Storage
671 671 Subsystem
672 672
673 673
674 674 The Sun Fire 880 internal storage subsystem has only one set of disks.
675 675 In this case, use s to specify the slot:
676 676
677 677
678 678 example% luxadm display BOB,s0
679 679
680 680
681 681
682 682 Example 6 Displaying Information about a SENA disk, an Enclosure, or an
683 683 Individual FC_AL Drive
684 684
685 685
686 686 The following example displays information about a SENA disk, an
687 687 enclosure, or an individual FC_AL drive with the port WWN of
688 688 2200002037001246:
689 689
690 690
691 691 example% luxadm display 2200002037001246
692 692
693 693
694 694
695 695 Example 7 Using Unique Characters to Issue a Subcommand
696 696
697 697
698 698 The following example uses only as many characters as are required to
699 699 uniquely identify a subcommand:
700 700
701 701
702 702 example% luxadm disp BOB
703 703
704 704
705 705
706 706 Example 8 Displaying Error Information
707 707
708 708
709 709 The following example displays error information about the loop that
710 710 the enclosure BOB is on:
711 711
712 712
713 713 example% luxadm display -r BOB
714 714
715 715
716 716
717 717 Example 9 Downloading New Firmware into the Interface Board
718 718
719 719
720 720 The following example downloads new firmware into the Interface Board
721 721 in the enclosure named BOB (using the default path for the file to
722 722 download):
723 723
724 724
725 725 example% luxadm download -s BOB
726 726
727 727
728 728
729 729 Example 10 Displaying Information from the SCSI Inquiry Command
730 730
731 731
732 732 The following example displays information from the SCSI inquiry
733 733 command from all individual disks on the system, using only as many
734 734 characters as necessary to uniquely identify the inquiry subcommand:
735 735
736 736
737 737 example% luxadm inq /dev/rdsk/c?t?d?s2
738 738
739 739
740 740
741 741 Example 11 Hotplugging
742 742
743 743
744 744 The following example hotplugs a new drive into the first slot in the
745 745 front of the enclosure named BOB:
746 746
747 747
748 748 example% luxadm insert_device BOB,f0
749 749
750 750
751 751
752 752
753 753 The following example hotplugs a new drive into the first slot in the
754 754 Sun Fire 880 internal storage subsystem named SF880-1:
755 755
756 756
757 757 example% luxadm insert_device SF880-1,s0
758 758
759 759
760 760
761 761 Example 12 Running an Expert Subcommand
762 762
763 763
764 764 The following example runs an expert subcommand. The subcommand forces
765 765 a loop initialization on the loop that the enclosure BOB is on:
766 766
767 767
768 768 example% luxadm -e forcelip BOB
769 769
770 770
771 771
772 772 Example 13 Using the Expert Mode Hot Plugging Subcommands
773 773
774 774
775 775 An example of using the expert mode hot plugging subcommands to hot
776 776 remove a disk follows. See NOTES for hot plugging limitations.
777 777
778 778
779 779
780 780 The first step reserves the SCSI device so that it can't be accessed by
781 781 way of its second SCSI bus:
782 782
783 783
784 784 example# luxadm reserve /dev/rdsk/c1t8d0s2
785 785
786 786
787 787
788 788 Example 14 Taking the Disk to be Removed Offline
789 789
790 790
791 791 The next two steps take the disk to be removed offline then quiesce the
792 792 bus:
793 793
794 794
795 795 example# luxadm -e offline /dev/rdsk/c1t8d0s2
796 796 example# luxadm -e bus_quiesce /dev/rdsk/c1t8d0s2
797 797
798 798
799 799
800 800 Example 15 Unquiescing the Bus
801 801
802 802
803 803 The user then removes the disk and continues by unquiescing the bus,
804 804 putting the disk back online, then unreserving it:
805 805
806 806
807 807 example# luxadm -e bus_unquiesce /dev/rdsk/c1t8d0s2
808 808 example# luxadm -e online /dev/rdsk/c1t8d0s2
809 809 example# luxadm release /dev/rdsk/c1t8d0s2
810 810
811 811
812 812
813 813 ENVIRONMENT VARIABLES
814 814 See environ(5) for a description of the LANG environment variable that
815 815 affects the execution of luxadm.
816 816
817 817 EXIT STATUS
818 818 The following exit values are returned:
|
↓ open down ↓ |
593 lines elided |
↑ open up ↑ |
819 819
820 820 0
821 821 Successful completion.
822 822
823 823
824 824 -1
825 825 An error occurred.
826 826
827 827
828 828 FILES
829 - usr/lib/firmware/fc_s/fc_s_fcode
829 + /usr/lib/firmware/fc_s/fc_s_fcode
830 830
831 831
832 832
833 833
834 - usr/lib/locale/C/LC_MESSAGES/ibfirmware
834 + /usr/lib/locale/C/LC_MESSAGES/ibfirmware
835 835
836 836
837 837
838 838
839 839 SEE ALSO
840 840 devlinks(1M), disks(1M), attributes(5), environ(5), ses(7D)
841 841
842 842 NOTES
843 843 Currently, only some device drivers support hot plugging. If hot
844 844 plugging is attempted on a disk or bus where it is not supported, an
845 845 error message of the form:
846 846
847 847 luxadm: can't acquire "PATHNAME": No such file or directory
848 848
849 849
850 850
|
↓ open down ↓ |
6 lines elided |
↑ open up ↑ |
851 851
852 852 will be displayed.
853 853
854 854
855 855 You must be careful not to quiesce a bus that contains the root or the
856 856 /usr filesystems or any swap data. If you do quiesce such a bus a
857 857 deadlock can result, requiring a system reboot.
858 858
859 859
860 860
861 - May 13, 2017 LUXADM(1M)
861 + May 17, 2020 LUXADM(1M)
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX