Brocade Communications Systems A7990A - StorageWorks SAN Director 4/16 Blade Switch Command Reference Manual
  1. Manuals
  2. Brands
  3. Brocade Communications Systems Manuals
  4. Switch
  5. A7990A - StorageWorks SAN Director 4/16 Blade...
  6. Command reference manual
Brocade Communications Systems A7990A - StorageWorks SAN Director 4/16 Blade Switch Command Reference Manual

Brocade Communications Systems A7990A - StorageWorks SAN Director 4/16 Blade Switch Command Reference Manual

Brocade fabric os command reference manual (53-1000240-01, november 2006)
Hide thumbs Also See for A7990A - StorageWorks SAN Director 4/16 Blade Switch:
1
2
3
4
Table Of Contents
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
Table of Contents

Advertisement

Quick Links

Download this manual See also: Administrator's Manual, Reference Manual
Fabric OS
Command Reference Manual
Supporting Fabric OS v5.2.0
Publication Number: 53-1000240-01
Publication Date: 09/29/2006

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the A7990A - StorageWorks SAN Director 4/16 Blade Switch and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Brocade Communications Systems A7990A - StorageWorks SAN Director 4/16 Blade Switch

Summary of Contents for Brocade Communications Systems A7990A - StorageWorks SAN Director 4/16 Blade Switch

  • Page 1 Fabric OS Command Reference Manual Supporting Fabric OS v5.2.0 Publication Number: 53-1000240-01 Publication Date: 09/29/2006...
  • Page 2 Copyright 1998-2006, Brocade Communications Systems, Incorporated. ALL RIGHTS RESERVED. Publication Number: 53-1000240-01 Brocade, the Brocade B weave logo, Secure Fabric OS, and SilkWorm are registered trademarks of Brocade Communications Systems, Inc., in the United States and/or in other countries. FICON, IBM BladeCenter are registered trademarks of IBM Corporation in the U.S.
  • Page 3 Document History The table below lists all versions of the Fabric OS Command Reference Manual. Document Title Publication Number Summary of Changes Publication Date Fabric OS Reference v2.0 53-0001487-03 September 1999 Fabric OS Reference v2.2 53-0001558-02 May 2000 Fabric OS Reference v2.3 53-0000067-02 December 2000 Fabric OS Reference v3.0...
  • Page 4 Document Title Publication Number Summary of Changes Publication Date Fabric OS Command Reference 53-0000519-09 Add 14, modify 128, and September 2004 Manual delete 7 commands. Fabric OS Command Reference 53-0000519-10 Add 8, modify 164, and delete April 2005 Manual 5 commands. Add switchAdmin and MUA information to chapter 1.

  • Page 5: Table Of Contents

    Contents About This Document Chapter 1 Using Fabric OS Commands Understanding Role-Based Access Control ......Using the Command Line Interface .
  • Page 6 bladeDisable ..........2-43 bladeEnable.
  • Page 7 configure ........... . . 2-96 crossPortTest .
  • Page 8 enclosureShow ..........2-141 errClear .
  • Page 9 fcpLogClear ..........2-184 fcpLogDisable.
  • Page 10 firmwareRestore ..........2-234 firmwareShow.
  • Page 11 historyShow ..........2-277 httpCfgShow .
  • Page 12 loopPortTest ..........2-332 lsanZoneShow.
  • Page 13 perfAddReadMonitor ......... . . 2-393 perfAddRWMonitor .
  • Page 14 portCfgEXPort ..........2-444 portCfgGPort .
  • Page 15 portLogShowPort ..........2-497 portLogTypeDisable .
  • Page 16 secFabricShow ..........2-557 secFCSFailover .
  • Page 17 setSplbMode ..........2-606 setVerbose .
  • Page 18 switchCfgSpeed ..........2-667 switchCfgTrunk .
  • Page 19 turboRamTest ..........2-714 txdPath .
  • Page 20 Chapter 5 Control Processor Commands Commands Supported on the Standby CP ......Chapter 6 supportShow Reference supportShow Control Commands .

  • Page 21: About This Document

    About This Document This document is a command reference manual written to help system administrators and technicians operate, maintain, and troubleshoot SAN products. “About This Document” contains the following sections: • “How This Document Is Organized,” next • “Supported Hardware and Software” on page xxii •...

  • Page 22: Supported Hardware And Software

    Supported Hardware and Software This document includes information specific to the new and changed functionality or support in the software from Brocade Fabric OS v5.1.0 to v5.2.0, supporting the following platforms: • Brocade SilkWorm 200E switch • Brocade SilkWorm 3250 switch •...
  • Page 23 What’s New in This Document • Information that was added since this document was last released: auditCfg defZone distribute fcipChipTest fcipPathTest fcLunQuery fcrChipTest fcrConfigure fcrDisable fcrEnable fcrFabricShow fcrPathTest fcrPhyDevShow fcrProxyConfig fcrResourceShow fcrRouteShow fcrRouterPortCost fcrXlateConfig fddCfg fosConfig iscsiCfg iscsiChipTest iscsiHelp iscsiPathTest iscsiPortCfg iscsiSessionCfg iscsiTargetName...
  • Page 24 portCmd portMirror supportFfdc zone zoneHelp • Information that was deleted since this document was last released: aliasDelete aliasJoin aliasPurge aliasShow diagSetEsdMode perfClrAlpaCrc renamed to perfClearAlpaCrc slotOff slotOn switchShutdown switchStart traceTrig voltShow Chapter 3, “MUA-Based Roles.” The relevant content was moved to Chapter 1. For further information, please refer to the Release Notes.

  • Page 25: Document Conventions

    Document Conventions This section describes text formatting conventions and important notices formats. Text Formatting The narrative-text formatting conventions that are used in this document are as follows: bold text Identifies command names Identifies GUI elements Identifies keywords and operands Identifies text to enter at the GUI or CLI italic text Provides emphasis Identifies variables...

  • Page 26: Additional Information

    Additional Information This section lists additional Brocade and industry-specific documentation that you might find helpful. Brocade Resources The following related documentation is provided on the Brocade Documentation CD-ROM and on the Brocade Web site, through Brocade Connect. Note Go to http://www.brocade.com and click Brocade Connect to register at no cost for a user ID and password.
  • Page 27 • Cable Management Tray and Guide Replacement Procedure • Chassis Door Replacement Procedure • Chassis Replacement Procedure • WWN LED Bezel/Card Replacement Procedure • Modem Setup and Installation Procedure • Power Supply and Filler Panel Replacement Procedure • SilkWorm 12000/24000/48000 Migration Guide •...

  • Page 28: Optional Brocade Features

    SilkWorm 200E • SilkWorm 200E Hardware Reference Manual (for v5.x software) For practical discussions about SAN design, implementation, and maintenance, you can obtain Building SANs with Brocade Fabric Switches through: http://www.amazon.com For additional Brocade documentation, visit the Brocade SAN Info Center and click the Resource Library location: http://www.brocade.com Release notes are available on the Brocade Connect Web site and are also bundled with the Fabric OS...

  • Page 29: Other Industry Resources

    FCIP Tunneling The optional Fibre Channel over Internet protocol (FCIP) Tunneling Service enables Fibre Channel frames to “tunnel” through IP networks by dividing frames, encapsulating the result in IP packets on entering the tunnel, and then reconstructing them as they leave the tunnel. Fabric OS supports eight FCIP interswitch links between two SilkWorm switches (SilkWorm 7500 or SilkWorm 48000 with a FR4-18i blade) or routes.

  • Page 30: Getting Technical Help

    Getting Technical Help Contact your switch support supplier for hardware, firmware, and software support, including product repairs and part ordering. To expedite your call, have the following information available: General Information • Technical Support contract number, if applicable • Switch model •...

  • Page 31: Document Feedback

    Document Feedback Because quality is our first concern at Brocade, we have made every effort to ensure the accuracy and completeness of this document. However, if you find an error or an omission, or you think that a topic needs further development, we want to hear from you. Forward your feedback to: documentation@brocade.com Provide the title and version number and as much detail as possible about your issue, including the topic heading and page number and your suggestions for improvement.
  • Page 32 xxxii Fabric OS Command Reference Manual Publication Number: 53-1000240-01...

  • Page 33: Understanding Role-Based Access Control

    Chapter Using Fabric OS Commands This chapter explains how to manage a Brocade SAN and Brocade SilkWorm switches and directors using the Fabric OS command line interface (CLI). The following information is discussed: • “Understanding Role-Based Access Control” on page 1-1 •...

  • Page 34: Using The Command Line Interface

    Using the Command Line Interface The Fabric OS command line interface (accessed through either telnet or serial console) provides an administrator with full management capability on a SilkWorm switch. The Fabric OS CLI enables an administrator to monitor and manage entire fabrics, individual switches, and ports from a standard workstation.
  • Page 35 Chapter Fabric OS Commands Fabric OS Command Reference Manual Publication Number: 53-1000240-01...

  • Page 36: Aaaconfig

    Note: Enter commands in lowercase only; mixed case is for readability. aaaConfig aaaConfig Manages RADIUS configuration information. Synopsis aaaconfig [action][options] Description Use this command to manage the RADIUS configuration for the authentication, authorization and accounting (AAA) services. Use this command to display, add, remove, change, enable or disable RADIUS configuration.
  • Page 37 Note: Enter commands in lowercase only; mixed case is for readability. aaaConfig --radiusonly Enable authentication via the RADIUS configuration only. This is used to select the RADIUS configuration as the primary AAA service. To enable a RADIUS configuration, as least one server must exist in the configuration. --radiuslocal Enable the current RADIUS configuration as the primary AAA service and the switch-local database as the secondary AAA service.
  • Page 38 Note: Enter commands in lowercase only; mixed case is for readability. Specifies all administration domain (Admin Domain)-level operations. Synopsis ad --activate ad_id ad --add ad_id <[-d "dev_list"] [-s "switch_list"]> ad --apply ad --clear ad --create ad_id <[-d "dev_list"] [-s "switch_list"]> ad --deactivate ad_id ad --delete ad_id ad --exec ad_id "command"...
  • Page 39 Note: Enter commands in lowercase only; mixed case is for readability. are treated as implicit members of AD0. Members added to AD0 through --add are called explicit members. As other Admin Domains are created, upon --apply, the members used in those Admin Domains are automatically removed from the implicit member list of AD0.
  • Page 40 Note: Enter commands in lowercase only; mixed case is for readability. • Supports node or port WWNs. • End-device members, whose WWNs are used in an Admin Domain definition, need not be online when the Admin Domain is created (similar to a zoneCreate operation).
  • Page 41 Note: Enter commands in lowercase only; mixed case is for readability. The activate operation remains in the transaction buffer until you issue --apply --save. --add ad_id -d "dev_list"-s "switch_list" Adds new members to an existing Admin Domain. The add operation remains in the transaction buffer until you issue --apply or --save.
  • Page 42 Note: Enter commands in lowercase only; mixed case is for readability. operation remains in the transaction buffer until you issue --apply or --save. --rename ad_id new_ad_name Renames the Admin Domain. If a reserved name is used for new_ad_id (AD number format), the operation fails if the reserved name does not correspond to ad_id’s AD number.
  • Page 43 Note: Enter commands in lowercase only; mixed case is for readability. Domain aware members. All FC Router imported devices in the AD device list will be marked as AD-aware members. Note Note: --show and --validate may return incorrect information about switch port members for non-AD aware switches running pre-v3.2 Fabric OS.
  • Page 44 Note: Enter commands in lowercase only; mixed case is for readability. To create an Admin Domain with both device and switch list: switch:admin> ad --create “AD1”, -d “100,5; 1,3; 21:20:00:00:e0:8b:05:4d:05” -s “100; 10:00:00:60:69:80:59:13” To deactivate Admin Domain 5: switch:admin> ad --deactivate 5 You are about to deactivate an AD.
  • Page 45 Note: Enter commands in lowercase only; mixed case is for readability. To select a new Admin Domain context by specifying the AD number: switch:admin> ad --select 12 To display all ADs: switch:admin> ad --show Current AD: 255 : AD255 Transaction buffer configuration: --------------------------------- no configuration Defined configuration:...
  • Page 46 Note: Enter commands in lowercase only; mixed case is for readability. To display the AD10 configuration information in persistent storage: switch:admin> ad --show 10 -m 1 Current AD: 255 : AD255 Defined configuration: ---------------------- AD: 1 : Active Device WWN members: 21:00:00:80:e5:12:8b:37;...
  • Page 47 Note: Enter commands in lowercase only; mixed case is for readability. To display the configuration information in the transaction buffer: switch:admin> ad --validate Current AD: 255 : AD255 Transaction buffer configuration: --------------------------------- no configuration Defined configuration: ---------------------- AD: 1 : Active Switch port members: 1,0;...

  • Page 48: Agshow

    Note: Enter commands in lowercase only; mixed case is for readability. agshow agshow Displays the Access Gateway information registered with the fabric. Synopsis agshow [ag_name] | [--local] Description This command displays the details of the F_Ports and the configured N_Ports in the Access Gateway connected.
  • Page 49 Note: Enter commands in lowercase only; mixed case is for readability. agshow Examples To display the Access Gateway information registered with the fabric. switch:admin> agshow WT_Stealth Name : WT_Stealth NodeName : 10:00:00:05:1e:34:e4:bd N-Port ID(s) : 0x010200 Number of Ports : 16 IP Address(es) : 10.202.90.231 Firmware Version...

  • Page 50: Agtcfgdefault

    Note: Enter commands in lowercase only; mixed case is for readability. agtCfgDefault agtCfgDefault Resets the SNMP agent configuration to default values. Synopsis agtcfgdefault Description Use this command to reset the configuration of the SNMP agent associated with the switch default values.
  • Page 51 Note: Enter commands in lowercase only; mixed case is for readability. agtCfgDefault Trap Recipient Severity Level The trap severity level is associated with each trap recipient IP address. The event trap level is in conjunction with the event's severity level. When an event occurs and if its severity level is at or below the set value, the SNMP event traps (swEventTrap, swFabricWatchTrap, and connUnitEventTrap) are sent to the trap recipients.
  • Page 52 Note: Enter commands in lowercase only; mixed case is for readability. agtCfgDefault Community 3: private (rw) No trap recipient configured yet Community 4: public (ro) No trap recipient configured yet Community 5: common (ro) No trap recipient configured yet Community 6: FibreChannel (ro) No trap recipient configured yet SNMP access list configuration: Entry 0:...

  • Page 53: Agtcfgset

    Note: Enter commands in lowercase only; mixed case is for readability. agtCfgSet agtCfgSet Modifies the SNMP agent configuration. Synopsis agtcfgset Description Use this command to modify the configuration of the SNMP agent in the switch. All values successfully configured by this command take effect immediately. These values are persistent across power cycles and reboots.
  • Page 54 Note: Enter commands in lowercase only; mixed case is for readability. agtCfgSet conjunction with the event's severity level. When an event occurs and if its severity level is at or below the set value, the SNMP event traps (swEventTrap, swFabricWatchTrap, and connUnitEventTrap) are sent to the trap recipients.
  • Page 55 Note: Enter commands in lowercase only; mixed case is for readability. agtCfgSet Examples To modify the SNMP configuration values: switch:admin> agtcfgset Customizing MIB-II system variables ... At each prompt, do one of the followings: o <Return> to accept current value, o enter the appropriate new value, o <Control-D>...

  • Page 56: Agtcfgshow

    Note: Enter commands in lowercase only; mixed case is for readability. agtCfgShow agtCfgShow Displays the SNMP agent configuration. Synopsis agtcfgshow Description Use this command to display the configuration of the SNMP agent in the switch. Note On a dual-switch chassis, there is one SNMP agent per logical switch. This command is specific to the logical switch to which you are logged in.
  • Page 57 Note: Enter commands in lowercase only; mixed case is for readability. agtCfgShow value is set to 0, implying that no swEventTrap is sent. Possible values are: • none • critical • error • warning • informational • debug Refer to errShow for related information.
  • Page 58 Note: Enter commands in lowercase only; mixed case is for readability. agtCfgShow Examples To display SNMP agent configuration information: switch:admin> agtcfgshow Current SNMP Agent Configuration Customizable MIB-II system variables: sysDescr = FC Switch sysLocation = End User Premise sysContact = Field Support. authTraps = 1 (ON) SNMPv1 community and trap recipient configuration: Community 1: Secret C0de (rw)

  • Page 59: Aliadd

    Note: Enter commands in lowercase only; mixed case is for readability. aliAdd aliAdd Adds a member to a zone alias. Synopsis aliadd "aliName", "member; member" Description Use this command to add one or more members to an existing zone alias. The alias member list cannot contain another zone alias.

  • Page 60: Alicreate

    Note: Enter commands in lowercase only; mixed case is for readability. aliCreate aliCreate Creates a zone alias. Synopsis alicreate "aliName", "member; member" Description Use this command to create a new zone alias. The zone alias member list must have at least one member (empty lists are not allowed).

  • Page 61: Alidelete

    Note: Enter commands in lowercase only; mixed case is for readability. aliDelete aliDelete Deletes a zone alias. Synopsis alidelete "aliName" Description Use this command to delete a zone alias. This command changes the defined configuration. For the change to be preserved across switch reboots, it must be saved to nonvolatile memory using the cfgSave command.

  • Page 62: Aliremove

    Note: Enter commands in lowercase only; mixed case is for readability. aliRemove aliRemove Removes a member from a zone alias. Synopsis aliremove "aliName", "member; member" Description Use this command to remove one or more members from an existing zone alias. If all members are removed, the zone alias is deleted.

  • Page 63: Alishow

    Note: Enter commands in lowercase only; mixed case is for readability. aliShow aliShow Displays zone alias information. Synopsis alishow ["pattern"][, mode] Description Use this command to display zone configuration information. If an operand is specified, it is used as a pattern to match zone alias names; those that match in the defined configuration are displayed.

  • Page 64: Aptpolicy

    Note: Enter commands in lowercase only; mixed case is for readability. aptPolicy aptPolicy Changes or displays the Advanced Performance Tuning (APT) policy. Synopsis aptpolicy [policy] Description Use this command to change the performance algorithm on the switch. Several internal parameters are changed by the use of this command, and a detailed performance-tuning discussion is beyond the scope of this manual.
  • Page 65 Note: Enter commands in lowercase only; mixed case is for readability. aptPolicy DLS setting cannot change with this policy. Examples To display the current policy: switch:admin> aptpolicy Current Policy: 3 3: Default Policy 1: Port Based Routing Policy 3: Exchange Based Routing Policy To change the current policy: switch:admin>...

  • Page 66: Auditcfg

    Note: Enter commands in lowercase only; mixed case is for readability. auditCfg auditCfg Modifies and displays audit log filter configuration. Synopsis auditcfg[--class audit_class][--show][--enable][--disable] Description Use this command to configure and display the audit log configuration. This command allows user to set filters by configuring certain classes using the --class option.

  • Page 67: Authutil

    Note: Enter commands in lowercase only; mixed case is for readability. authUtil authUtil Displays and sets the authentication configuration. Synopsis authutil [--show][--set value] Description Use this command to display and set local switch authentication parameters. Use --set to change authentication parameters such as protocol and Diffie-Hellman group (DH group). This saves the new configuration persistently.
  • Page 68 Note: Enter commands in lowercase only; mixed case is for readability. authUtil To set DH-CHAP as the authentication protocol: switch:admin> authutil --set -a dhchap Authentication is set to dhchap. To set both protocols in order of FCAP and then DH-CHAP: switch:admin>...

  • Page 69: Backplanetest

    Note: Enter commands in lowercase only; mixed case is for readability. backplaneTest backplaneTest Tests the backplane connection for a multiple-blade configured system. Synopsis backplanetest [--slot number][-passcnt count][-payload value][-pat type][-ports itemlist] [-verbose mode] Description Use this command to verify the backplane connection for each blade through the backend external (BE) ports.
  • Page 70 Note: Enter commands in lowercase only; mixed case is for readability. backplaneTest Diagnostics When this command detects failure(s), the subtest might report one or more of the following error messages: • DATA • TIMEOUT • XMIT Refer to the Fabric OS Message Reference for more information. See Also itemList 2-36...

  • Page 71: Backport

    Note: Enter commands in lowercase only; mixed case is for readability. backport backport Tests for backend ASIC-to-ASIC links. Synopsis backport [-nframes count][-ports itemlist][-lb_mode mode][-fr_type type][-extonly mode] Description Use this command to test the backplane routing and virtual channel (VC) allocation. This test applies to single blade as well as multiblade systems.
  • Page 72 Note: Enter commands in lowercase only; mixed case is for readability. backport -lb_mode mode Selects the loopback point for the test. By default, backport uses internal loopback. Mode Description Port loopback (loopback plugs) External (SERDES) loopback Internal (parallel) loopback -fr_type type Specifies the frame type to send.

  • Page 73: Bannerset

    Note: Enter commands in lowercase only; mixed case is for readability. bannerSet bannerSet Sets the banner on the local switch. Synopsis bannerset [banner] Description Use this command to set the banner on the local switch. The banner is a string of alphanumeric characters. It is displayed whenever a user tries to log in to a switch.

  • Page 74: Bannershow

    Note: Enter commands in lowercase only; mixed case is for readability. bannerShow bannerShow Displays the banner text. Synopsis bannershow Description Use this command to display the contents of the banner. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 75: Bcastshow

    Note: Enter commands in lowercase only; mixed case is for readability. bcastShow bcastShow Displays broadcast routing information. Synopsis bcastshow Description Use this command to display the broadcast routing information for all ports in the switch. The broadcast routing information indicates all ports that are members of the broadcast distribution tree: ports that are able to send and receive broadcast frames.

  • Page 76: Bladebeacon

    Note: Enter commands in lowercase only; mixed case is for readability. bladeBeacon bladeBeacon Enables or disables blade beaconing, or displays the current mode. Synopsis bladebeacon slotnumber[mode] Description Use this command to enable or disable blade beaconing or to display the current beaconing mode for one blade.

  • Page 77: Bladedisable

    Note: Enter commands in lowercase only; mixed case is for readability. bladeDisable bladeDisable Disables all user ports on a blade. Synopsis bladedisable slotnumber Description Use this command to disable all user ports on a blade. All ports on the blade are taken offline. If the switch was connected to a fabric through this blade, the remaining switches reconfigure, and this switch will configure based on the other blade ports.

  • Page 78: Bladeenable

    Note: Enter commands in lowercase only; mixed case is for readability. bladeEnable bladeEnable Enables all user ports on a blade. Synopsis bladeenable slotnumber Description Use this command to enable all user ports on a blade. All ports within the blade that did not fail the power-on self-test (POST) are enabled (except for persistently disabled ports);...
  • Page 79 Note: Enter commands in lowercase only; mixed case is for readability. bladeEnable Examples To display the slot status, enable the user ports in slot 4, and verify the setting: switch:admin> slotshow Slot Blade Type Status --------------------------------- SW BLADE ENABLED UNKNOWN VACANT UNKNOWN VACANT...

  • Page 80: Burninerrclear

    Note: Enter commands in lowercase only; mixed case is for readability. burninErrClear burninErrClear Clears errors stored in the nonvolatile memory on the slot during burn-in. Synopsis burninerrclear slotnumber Description Use this command to clear errors stored in the nonvolatile memory on the slot during burn-in. Note It is advisable to run the burninErrClear...

  • Page 81: Burninerrshow

    Note: Enter commands in lowercase only; mixed case is for readability. burninErrShow burninErrShow Displays errors stored in the nonvolatile memory on the slot during burn-in. Synopsis burninerrshow slotnumber Description Use this command to display errors stored in the nonvolatile memory on the slot during burn-in. Operands The operand is as follows: slotnumber...

  • Page 82: Burninlevel

    Note: Enter commands in lowercase only; mixed case is for readability. burninLevel burninLevel Sets the diagnostics burn-in level. Synopsis burninlevel [level | -show] Description Use this command to select or display the burn-in level. When the burn-in level is set to a value other than 0, the diagnostic daemon program performs burn-in testing in place of the power-on self-test (POST) phase II each time a switch blade is powered on.

  • Page 83: Burninstatus

    Note: Enter commands in lowercase only; mixed case is for readability. burninStatus burninStatus Displays the diagnostics burn-in status. Synopsis burninstatus [[--slot] slotnumber] Description Use this command to display the burn-in status of each blade in the system. The output contains the slot, state, current run number, current command in the run, total commands in a run, and the burn-in script name.

  • Page 84: Camtest

    Note: Enter commands in lowercase only; mixed case is for readability. camTest camTest Verifies QuickLoop's Content Addressable Memory (CAM) SID translation. Synopsis camtest [--slot slotnumber][-passcnt count][-txport itemlist] Description Use this command to verify that the CAM is functionally OK by performing hit and miss tests. The CAM is used by QuickLoop to translate the SID.
  • Page 85 Note: Enter commands in lowercase only; mixed case is for readability. camTest Diagnostics When failures are detected, the subtest might report one or more of the following error messages: DIAG-CAMFLTR DIAG-CAMINIT DIAG-CAMSID DIAG-CAMSTAT DIAG-CANTXMIT Refer to the Fabric OS Message Reference for more information. See Also centralMemoryTest, cmemRetentionTest, cmiTest, crossPortTest, itemList, portLoopbackTest, portRegTest, spinSilk,...

  • Page 86: Centralmemorytest

    Note: Enter commands in lowercase only; mixed case is for readability. centralMemoryTest centralMemoryTest Tests ASIC-pair central memory operation. Synopsis centralmemorytest [--slot slotnumber][-passcnt count][-datatype type][-ports itemlist][-seed] Description Use this command to execute an address and data bus verification of the ASIC SRAMs that serve as the central memory.
  • Page 87 Note: Enter commands in lowercase only; mixed case is for readability. centralMemoryTest Set up the hardware such that each ASIC is read by all of the ports in the switch. Data received is compared against the frame written into the ASIC. •...
  • Page 88 Note: Enter commands in lowercase only; mixed case is for readability. centralMemoryTest • interrupt status bits set. • the error type is buffer number error. • the port number in error is the receiver port (which is the base port of ASIC Y). Check that all ASICs besides X are not interrupted or flagged with an error.
  • Page 89 Note: Enter commands in lowercase only; mixed case is for readability. centralMemoryTest Examples To test the ASIC central memory: switch:admin> centralmemorytest -ports 1/0-1/15 Running centralmemorytest .... Test Complete: centralmemorytest Pass 1 of 1 Duration 0 hr, 0 min & 3 sec (0:0:3:158). passed.

  • Page 90: Cfgactvshow

    Note: Enter commands in lowercase only; mixed case is for readability. cfgActvShow cfgActvShow Displays effective zone configuration information. Synopsis cfgactvshow Description Use this command to display the effective zone configuration information. The current configuration is a single zone configuration that is currently in effect. The devices that an initiator sees are based on this configuration.

  • Page 91: Cfgadd

    Note: Enter commands in lowercase only; mixed case is for readability. cfgAdd cfgAdd Adds a member to a zone configuration. Synopsis cfgadd "cfgName", "member; member" Description Use this command to add one or more members to an existing zone. This command changes the defined configuration. For the change to be preserved across switch reboots, it must be saved to nonvolatile memory using the cfgSave command.

  • Page 92: Cfgclear

    Note: Enter commands in lowercase only; mixed case is for readability. cfgClear cfgClear Clears all zone configurations. Synopsis cfgclear Description Use this command to clear all zone information in the transaction buffer. All defined zone objects in the transaction buffer are deleted. If an attempt is made to commit the empty transaction buffer while a zone configuration is enabled, you are warned to first disable the enabled zone configuration or to provide a valid configuration with the same name.

  • Page 93: Cfgcreate

    Note: Enter commands in lowercase only; mixed case is for readability. cfgCreate cfgCreate Creates a zone configuration. Synopsis cfgcreate "cfgName", "member; member" Description Use this command to create a new zone configuration. A zone configuration name must begin with a letter that can be followed by any number of letters, numbers, and underscores.

  • Page 94: Cfgdelete

    Note: Enter commands in lowercase only; mixed case is for readability. cfgDelete cfgDelete Deletes a zone configuration. Synopsis cfgdelete "cfgName" Description Use this command to delete a zone configuration. This command changes the defined configuration. For the change to be preserved across switch reboots, it must be saved to nonvolatile memory using the cfgSave command.

  • Page 95: Cfgdisable

    Note: Enter commands in lowercase only; mixed case is for readability. cfgDisable cfgDisable Disables a zone configuration. Synopsis cfgdisable Description Use this command to disable the current zone configuration. The fabric returns to nonzoning mode, in which all devices see each other. This command ends and commits the current zoning transaction buffer to both volatile and nonvolatile memory.

  • Page 96: Cfgenable

    Note: Enter commands in lowercase only; mixed case is for readability. cfgEnable cfgEnable Enables a zone configuration. Synopsis cfgenable "cfgName" Description Use this command to enable a zone configuration. The specified zone configuration is built by checking for undefined zone names, zone alias names, or other inconsistencies by expanding zone aliases, removing duplicate entries, and then installing the effective configuration.

  • Page 97: Cfgremove

    Note: Enter commands in lowercase only; mixed case is for readability. cfgRemove cfgRemove Removes a member from a zone configuration. Synopsis cfgremove "cfgName", "member [; member ...]" Description Use this command to remove one or more members from an existing zone configuration. If all members are removed, the zone configuration is deleted.

  • Page 98: Cfgsave

    Note: Enter commands in lowercase only; mixed case is for readability. cfgSave cfgSave Saves zone configuration to nonvolatile memory. Synopsis cfgsave Description Use this command to save the current zone configuration. The defined configuration and the name of the enabled configuration are written to nonvolatile memory in all switches in the fabric. The saved configuration is automatically reloaded by the switch on power on and, if a configuration was in effect at the time it was saved, the same configuration is reinstalled with an automatic cfgEnable...

  • Page 99: Cfgshow

    Note: Enter commands in lowercase only; mixed case is for readability. cfgShow cfgShow Displays zone configuration information. Synopsis cfgshow ["pattern"][, mode] Description Use this command to display zone configuration information. If no operand is specified, all zone configuration information (both defined and effective) displays. If the local switch has an outstanding transaction, this command displays the newly edited zone configuration that has not yet been saved.
  • Page 100 Note: Enter commands in lowercase only; mixed case is for readability. cfgShow must be enclosed in brackets: for example, [0-9] or [a-f]. 2-66 Fabric OS Command Reference Manual Publication Number: 53-1000240-01...
  • Page 101 Note: Enter commands in lowercase only; mixed case is for readability. cfgShow mode Specify 0 to display the contents of the transaction buffer (the contents of the current transaction) or specify 1 to display the contents of nonvolatile memory. The default value is 0. This operand is optional. Examples To display all zone configurations that start with "Test": switch:admin>...

  • Page 102: Cfgsize

    Note: Enter commands in lowercase only; mixed case is for readability. cfgSize cfgSize Displays zone and Admin Domain database size details. Synopsis cfgsize [integer] Description Use this command to display the size details of the zone database and Admin Domain database. When executed in non-AD255 context, the size details include the Zone DB maximum size, the committed size, and the transaction size.
  • Page 103 Note: Enter commands in lowercase only; mixed case is for readability. cfgSize To display Admin Domain and zone database information in AD255 context: switch:admin> cfgsize Maximum AD and Zone DB max size - 1045274 bytes Total Committed AD and Zone DB size - 3506 bytes AD and Zone DB uncommitted space available - 1041768 bytes Total AD and Zone Transaction buffer size - 0 bytes AD Database Size:...

  • Page 104: Cfgtransabort

    Note: Enter commands in lowercase only; mixed case is for readability. cfgTransAbort cfgTransAbort Aborts the current zoning transaction. Synopsis cfgtransabort [token] Description Use this command to abort the current zoning transaction without committing it. All changes made since the transaction was started will be removed and the zone configuration database restored to the state before the transaction was started.

  • Page 105: Cfgtransshow

    Note: Enter commands in lowercase only; mixed case is for readability. cfgTransShow cfgTransShow Displays information about the current zoning transaction. Synopsis cfgtransshow Description Use this command to display the ID of the current zoning transaction. It will also give information about whether the transaction can be aborted or not.

  • Page 106: Chassisconfig

    Note: Enter commands in lowercase only; mixed case is for readability. chassisConfig chassisConfig Displays or sets the configuration of the chassis. Synopsis chassisconfig [-f][option] Description Use this command to set the chassis configuration for products that support both single-switch and dual- switch operation.
  • Page 107 Note: Enter commands in lowercase only; mixed case is for readability. chassisConfig Note User account data and passwords might not be saved using configUpload. User accounts created using userConfig command are deleted and user accounts are reset to the factory default user accounts and passwords.
  • Page 108 Note: Enter commands in lowercase only; mixed case is for readability. chassisConfig Examples To display the current configuration option on a SilkWorm 48000 director and to change the option: switch:admin> chassisconfig Current Option: 5 All Supported Options (With Blade ID 5 on slots 5-6) ---------------------------------------------------- Option 1: One 128-port switch (Blade ID 4, 17 on slots 1-4, 7-10, Blade ID 5, 16 on slots 5-6)

  • Page 109: Chassisname

    Note: Enter commands in lowercase only; mixed case is for readability. chassisName chassisName Displays or sets the chassis name. Synopsis chassisname [name] Description Use this command to display or change the name associated with the chassis. In dual-domain systems, there are up to two logical switches associated with a single chassis. Operands This command has the following operand: name...

  • Page 110: Chassisshow

    Note: Enter commands in lowercase only; mixed case is for readability. chassisShow chassisShow Displays all field replaceable units (FRUs). Synopsis chassisshow Description Use this command to inventory and display the FRU header content for each object in the chassis and chassis backplane version.
  • Page 111 Note: Enter commands in lowercase only; mixed case is for readability. chassisShow Operands none Examples To display all FRUs for a switch: switch:user> chassisshow Chassis Backplane Revision: 1C SW BLADE Slot: 3 Header Version: Power Consume Factor: -180 Factory Part Num: 60-0001532-03 Factory Serial Num: 1013456800...
  • Page 112 Note: Enter commands in lowercase only; mixed case is for readability. chassisShow See Also slotShow 2-78 Fabric OS Command Reference Manual Publication Number: 53-1000240-01...

  • Page 113: Chipregshow

    Note: Enter commands in lowercase only; mixed case is for readability. chipRegShow chipRegShow Displays the port registers for a given chip number. Synopsis chipregshow [slotnumber/]chipnumber [filter] Description Use this command to display the ASIC pair register contents for the specified chip on the specified blade slot.

  • Page 114: Cmemretentiontest

    Note: Enter commands in lowercase only; mixed case is for readability. cmemRetentionTest cmemRetentionTest Tests the data retention of the central memory SRAMs. Synopsis cmemretentiontest [--slot slotnumber][-passcnt count][-datatype type][-ports itemlist][-seed value] Description Use this command to verify that data written into the central memory SRAMs in the ASIC pair is retained after a 10-second wait.
  • Page 115 Note: Enter commands in lowercase only; mixed case is for readability. cmemRetentionTest Examples To run the data-retention test on the central memory SRAMS: switch:admin> cmemretentiontest --slot 7 Running cmemretentiontest ....Test Complete: cmemretentiontest Pass 1 of 1 Duration 0 hr, 1 min & 33 sec (0:1:33:16). passed.

  • Page 116: Cmitest

    Note: Enter commands in lowercase only; mixed case is for readability. cmiTest cmiTest Verifies the control message interface (CMI) bus between ASICs. Synopsis cmitest [--slot slotnumber][-passcnt count][-txports itemlist][-rxports itemlist][-skip mask] Description Use this command to test: • The multiplexed 4-bit CMI point-to-point connection between two ASICs. •...
  • Page 117 Note: Enter commands in lowercase only; mixed case is for readability. cmiTest Diagnostics Listed below are possible error messages if failures are detected: • DIAG-BADINT • DIAG-CMICKSUM • DIAG-CMIDATA • DIAG-CMIINVCAP • DIAG-CMINOCAP • DIAG-CMISA1 • DIAG-INTNIL Refer to the Fabric OS Message Reference for more information. See Also camTest, centralMemoryTest, cmemRetentionTest, crossPortTest, itemList, portLoopbackTest, spinSilk,...

  • Page 118: Configdefault

    Note: Enter commands in lowercase only; mixed case is for readability. configDefault configDefault Restores the system configuration to default values. Synopsis configdefault Description Use this command to reset a subset of configuration settings to the default values. With the exception of the following, all configuration parameters are reset to their default values (see configure): •...
  • Page 119 Note: Enter commands in lowercase only; mixed case is for readability. configDefault Examples To restore the system configuration to default values: switch:admin> configdefault Committing Configuration ...done. See Also agtCfgDefault, configure, switchDisable, switchEnable Fabric OS Command Reference Manual 2-85 Publication Number: 53-1000240-01...

  • Page 120: Configdownload

    Note: Enter commands in lowercase only; mixed case is for readability. configDownload configDownload Downloads switch configuration and other parameters from a host file. Synopsis configdownload [-p ftp]"host","user","file","passwd" configdownload -p scp "host","user","file" configdownload Description Use this command to download a switch configuration and other parameters from a host file. The configuration file may have been generated previously using configUpload, or it may have been created by a user to download only specific changes.
  • Page 121 Note: Enter commands in lowercase only; mixed case is for readability. configDownload same as a member in the previous FCS_POLICY. • In the [Active Security Policies] section, the FCS_POLICY must be exactly the same as the previous FCS_POLICY. Order of members must be maintained. •...
  • Page 122 Note: Enter commands in lowercase only; mixed case is for readability. configDownload Operands This command has the following operands: -p ftp or -p scp Specifies the use of the FTP or SCP protocol. If a protocol is not specified, FTP is the default.
  • Page 123 Note: Enter commands in lowercase only; mixed case is for readability. configDownload To download a configuration file interactively, on a non-AD aware switch running Fabric OS v5.1.0: switch:admin> configdownload configDownload: This command may not be executed on an operational switch. You must first disable the switch using the "switchDisable"...

  • Page 124: Configshow

    Note: Enter commands in lowercase only; mixed case is for readability. configShow configShow Displays system configuration settings. Synopsis configshow ["pattern"] Description Use this command to display some system configuration settings in addition to those items set by the configure command. Note Not all values displayed are applicable to all system models and configurations.
  • Page 125 Note: Enter commands in lowercase only; mixed case is for readability. configShow To display system configuration settings: switch:admin> configshow RSCN.end-device.TransmissionMode:0 alpaList:1 cer.internal_port_code:1 cfgload.secure:0 diag.loopID:125 diag.mode.burnin:0 diag.mode.esd:0 diag.mode.lab:0 diag.mode.mfg:0 diag.postDisable:1 diag.retryDisable:0 diag.script.BURNIN:doburnin diag.script.CP128.HOLDOFF:diagholdoff.sh diag.script.CP128.POST1:cp128post1.sh diag.script.CP128.POST2:cp128post2.sh diag.script.PORT.HOLDOFF:diagholdoff.sh diag.script.PORT.POST1:portpost1.sh diag.script.PORT.POST2:portpost2.sh diag.script.SWITCH.HOLDOFF:diagholdoff.sh diag.script.SWITCH.POST1:switchpost1.sh diag.script.SWITCH.POST2:switchpost2.sh diag.test.crossPort.passes:5000 diag.test.passes:0 diag.test.portLoopback.passes:1000...
  • Page 126 Note: Enter commands in lowercase only; mixed case is for readability. configShow fabric.ops.mode.longDistance:0 fabric.ops.mode.noClassF:0 fabric.ops.mode.pidFormat:1 fabric.ops.mode.tachyonCompat:0 fabric.ops.mode.unicastOnly:0 fabric.ops.mode.useCsCtl:0 fabric.ops.vc.class.2:2 fabric.ops.vc.class.3:3 fabric.ops.vc.config:0xc0 fabric.ops.vc.linkCtrl:0 fabric.ops.vc.multicast:7 fabric.ops.wan_tov:0 fabric.principalSwSelMode:0 fc4.fcIp.address:0.0.0.0 fc4.fcIp.mask:0.0.0.0 fc4.fcp.productId:FC Switch fc4.fcp.vendorId:BROCADE fcAL.alwaysSendRSCN:0 fcAL.fanFrameDisable:0 fcAL.openSendCLS:4 fcAL.useAltBBCredit:0 ficu.EBCDICcodePage:37 ficu.fmsmode:0 ficu.keyctr:1 flannel.ops.frameColMethod:piling flannel.ops.openBBCredit:4 gen.fabos:0 gen.zone:0 http.accesslog.enabled:0 http.enabled:1...

  • Page 127: Configupload

    Note: Enter commands in lowercase only; mixed case is for readability. configUpload configUpload Uploads the switch configuration file to a host file. Synopsis configupload [-p ftp]"host","user","file","passwd" configupload -p scp "host","user","file" configupload Description Use this command to upload the switch configuration to a host file. The first form of this command uses FTP (File Transfer Protocol).
  • Page 128 Note: Enter commands in lowercase only; mixed case is for readability. configUpload It has variables such as the switch’s name and IP address. The[License] section contains license strings. The[Chassis Configuration] and [Configuration] sections contain general switch configuration variables, such as diagnostic settings, fabric configuration settings, and SNMP settings. The[Zoning] section contains the zoning configuration.
  • Page 129 Note: Enter commands in lowercase only; mixed case is for readability. configUpload Examples To upload a configuration file interactively: switch:admin> configupload Protocol (scp or ftp) [ftp]: ftp Server Name or IP Address [host]: 192.168.1.48 User Name [user]: jdoe File Name [config.txt]: config.txt Password: ******** configUpload complete: All config parameters except AD Headers,SFOS and Security parameters are uploaded from AD0...

  • Page 130: Configure

    Note: Enter commands in lowercase only; mixed case is for readability. configure configure Changes system configuration settings. Synopsis configure Description Use this command to change the following system configuration settings for the switch: • “Switch Fabric Settings” • “Virtual Channel Settings” •...
  • Page 131 Note: Enter commands in lowercase only; mixed case is for readability. configure The Switch Fabric Settings are as follows: Table 2-3 Configure Command Fabric Parameters Field Type Default Range number varies Domain R_A_TOV number 10000 E_D_TOV * 2 to 120000 number 2000 1000 to R_A_TOV / 2...
  • Page 132 Note: Enter commands in lowercase only; mixed case is for readability. configure Note The R_A_TOV, E_D_TOV, WAN_TOV, and MAX_HOPS configuration parameters are inter-related. Assigning a specific value to one or more of these parameters can change the range of allowed values that can be assigned to the other parameters.

  • Page 133: Virtual Channel Settings

    Note: Enter commands in lowercase only; mixed case is for readability. configure level; otherwise, the fabric will be segmented. Note A Brocade Extended Fabrics license is required to set this mode. BB Credit The buffer-to-buffer (BB) credit represents the number of buffers available to attached devices for frame receipt.

  • Page 134: Rscn Transmission Mode

    Note: Enter commands in lowercase only; mixed case is for readability. configure Zoning Operation Parameters The Zoning Operation Parameter field is as follows: Disable NodeName Zone Checking Specify 1 to disable using node WWN when specifying nodes in the zone database, or specify 0 to enable using node WWN when specifying nodes in the zone data.

  • Page 135: System Services Settings

    Note: Enter commands in lowercase only; mixed case is for readability. configure Enable CLOSE on OPEN received? If this is set, a CLS is returned immediately to an OPN if no buffers are available. This is required for TachLite. Always send RSCN? Following the completion of loop initialization, a remote state change notification (RSCN) is issued when FL_Ports detect the presence of new devices or the absence of preexisting devices.
  • Page 136 Note: Enter commands in lowercase only; mixed case is for readability. configure Application Attributes Application HTTP, SNMP, and RPCd attributes are configurable; by default, all three attributes are enabled. Refer to the table for the application attributes that can be changed. Table 2-9 Configurable Application Attributes Application...
  • Page 137 Note: Enter commands in lowercase only; mixed case is for readability. configure Examples To modify configuration settings on a switch: switch:admin> configure Configure... Fabric parameters(yes, y, no, n): [no] yes Domain:(1..239) [1] R_A_TOV: (4000..120000) [10000] E_D_TOV: (1000..5000) [2000] 5000 WAN_TOV: (0..30000) [0] 0 MAX_HOPS: (7..19) [7] Data field size: (256..2112) [2112] Sequence Level Switching: (0..1) [0] 1...
  • Page 138 Note: Enter commands in lowercase only; mixed case is for readability. configure Portlog events enable (yes, y, no, n): [no] yes start(a switch start or re-start event (on, off): [on] disable(a port is disabled (on, off): [on] enable(a port is enabled (on, off): [on] ioctl(a port I/O control is executed) (on, off): [on]...

  • Page 139: Crossporttest

    Note: Enter commands in lowercase only; mixed case is for readability. crossPortTest crossPortTest Tests functional operation of port external transmit and receive path. Synopsis crossporttest [-nframes count][-lb_mode mode][-spd_mode mode][-norestore mode][-ports itemlist] Description This command verifies the intended functional operation of the switch by sending frames from port M's transmitter and looping them back through an external fiber cable into port N's receiver, thus exercising all the switch components, from the main board, to the media, to the fiber cable, to the media, and back to the main board.
  • Page 140 Note: Enter commands in lowercase only; mixed case is for readability. crossPortTest At each pass, a different data type is used to create the frame from a palette of seven types meaning that if a pass of seven is requested, seven different frames are used in the test. If eight passes, the first seven frames are unique, and the eighth is the same as the first.
  • Page 141 Note: Enter commands in lowercase only; mixed case is for readability. crossPortTest Silkscreen loopback Internal (parallel) loopback -spd_mode mode Specify the speed mode for the test. This parameter is used only for Bloom and Condor ASIC-based products, for which it controls the speed at which each port is operated.

  • Page 142: Datatypeshow

    Note: Enter commands in lowercase only; mixed case is for readability. dataTypeShow dataTypeShow Displays sample data stream types used in some diagnostic commands. Synopsis datatypeshow [-seed value] Description Use this command to display sample data stream types used in diagnostic commands. There are 20 different sample data types.

  • Page 143: Date

    Note: Enter commands in lowercase only; mixed case is for readability. date date Displays or sets the switch date and time. Synopsis date ["newdate"] Description Use this command to display or set the date and time. All switches maintain the current date and time in nonvolatile memory.
  • Page 144 Note: Enter commands in lowercase only; mixed case is for readability. date Examples To display the current date and time and then modify it: switch:admin> date Fri Jan 29 17:01:48 UTC 2000 switch:admin> date "0227123003" Thu Feb 27 12:30:00 UTC 2003 See Also errShow, ficoncupset, ficoncupshow, portLogShow, tsClockServer, tsTimeZone, upTime...

  • Page 145: Dbgshow

    Note: Enter commands in lowercase only; mixed case is for readability. dbgShow dbgShow Displays current values of debug and verbosity levels of the specified module. Synopsis dbgshow [module_name] Description Use this command to display the current values of debug and verbosity levels of the specified module. If no module name is specified, displays debug and verbosity levels of all modules.

  • Page 146: Defzone

    Note: Enter commands in lowercase only; mixed case is for readability. defZone defZone Activates or deactivates a default zone configuration. Synopsis defzone [--noaccess | --allaccess | --show] Description Use this command to set the Default Zone access mode to No Access, initialize a zoning transaction (if one is not already in progress), and create reserved zoning objects.
  • Page 147 Note: Enter commands in lowercase only; mixed case is for readability. defZone --allaccess Sets the default zone access mode to All Access, initiates a zoning transaction (if one is not already in progress), and deletes the reserved zoning objects by doing the equivalent to the following zoning commands: •...

  • Page 148: Defzonecreate

    Note: Enter commands in lowercase only; mixed case is for readability. defZoneCreate defZoneCreate Creates a default zone configuration. Synopsis defzonecreate Description Use this command to create a new default zone configuration. This command changes the defined configuration. It creates a new cfg named "d_efault_Cfg" that contains the zone "d_efault_Zone"...
  • Page 149 Note: Enter commands in lowercase only; mixed case is for readability. defZoneCreate See Also defZoneDelete Fabric OS Command Reference Manual 2-115 Publication Number: 53-1000240-01...

  • Page 150: Defzonedelete

    Note: Enter commands in lowercase only; mixed case is for readability. defZoneDelete defZoneDelete Deletes the default zone configuration. Synopsis defzonedelete Description Use this command to delete the default zone configuration. This command changes the defined configuration. This command deletes the cfg "d_efault_Cfg" that contains the zone "d_efault_Zone"...

  • Page 151: Diagclearerror

    Note: Enter commands in lowercase only; mixed case is for readability. diagClearError diagClearError Clears the diagnostics failure status. Synopsis diagclearerror [[--slot] slotnumber] -all Description Use this command to clear the diagnostics failure status. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operand: --slot slotnumber...

  • Page 152: Diagcommandshow

    Note: Enter commands in lowercase only; mixed case is for readability. diagCommandShow diagCommandShow Displays diagnostic command descriptions. Synopsis diagcommandshow [command] Description Use this command to display a short description of a diagnostic command. Note diagHelp to look up diagnostic command help pages. You can issue this command on the FR4-18i blade in a SilkWorm chassis;...

  • Page 153: Diagdisablepost

    Note: Enter commands in lowercase only; mixed case is for readability. diagDisablePost diagDisablePost Disables power-on self-test (POST). Synopsis diagdisablepost Description Use this command to disable POST. A reboot is not required for this command to take effect. Operands none Examples To disable the POST during future power ons: switch:admin>...

  • Page 154: Diagenablepost

    Note: Enter commands in lowercase only; mixed case is for readability. diagEnablePost diagEnablePost Enables power-on self-test (POST) execution at next reboot. Synopsis diagenablepost Description Use this command to enable POST. A reboot is not required for this command to take effect. POST includes two phases: POST Phase I mainly tests hardware and POST Phase II tests system functionality.

  • Page 155: Diagenv

    Note: Enter commands in lowercase only; mixed case is for readability. diagEnv diagEnv Diagnostic debug parameters management package. Synopsis diagsetdebug value diagdebughelp diagsetdebugnoncheck value diagsetdebugnorestore value diagsetfaillimit value diagsetfrcerr value diagshowusr ... more commands ... Description All of diagnostic parameters can be set either by running relevant user commands or by setting them directly in some way.
  • Page 156 Note: Enter commands in lowercase only; mixed case is for readability. diagEnv Examples To display the values of the diagnostic parameters: switch:admin> diagshowusr Name Environment Value USR_DILATION DIAG_USR_DLY_DILATION USR_MEMDLY DIAG_USR_MEMDLY USR_SEED DIAG_USR_SEED USR_SPECIAL DIAG_USR_SPECIAL (output truncated) See Also none 2-122 Fabric OS Command Reference Manual Publication Number: 53-1000240-01...

  • Page 157: Diagfaillimit

    Note: Enter commands in lowercase only; mixed case is for readability. diagFailLimit diagFailLimit Sets the diagnostics fail limit. Synopsis diagfaillimit [limit | -show] Description Use this command to set the diagnostics fail limit to a specified value. The fail limit controls the number of failures before certain diagnostic test methods aborts.

  • Page 158: Diaghelp

    Note: Enter commands in lowercase only; mixed case is for readability. diagHelp diagHelp Displays diagnostic command information. Synopsis diaghelp [command] Description Use this command to display a short description of diagnostic commands that are available to the user if command is not specified. The command builds a database of command information during the first execution.

  • Page 159: Diagloopid

    Note: Enter commands in lowercase only; mixed case is for readability. diagLoopId diagLoopId Sets the diagnostics loop ID. Synopsis diagloopid [id | -show] Description Use this command to select the loop ID to be used by FL mode diagnostics. The value entered will be converted from a loop ID to the corresponding AL_PA and used as the port address for any diagnostics that operate in FL_Port mode.

  • Page 160: Diagmodeshow

    Note: Enter commands in lowercase only; mixed case is for readability. diagModeShow diagModeShow Displays diagnostic mode configuration. Synopsis diagmodeshow Description Use this command to display the current settings for several diagnostic configuration parameters. This command is most often used by burn-in scripts to display a summary of the configuration settings that were in effect when the script was run.

  • Page 161: Diagpost

    Note: Enter commands in lowercase only; mixed case is for readability. diagPost diagPost Sets or displays diagnostic POST configuration. Synopsis diagpost [mode | -show] Description Use this command to enable or disable POST testing. The mode is saved in flash memory (and stays in that mode) until the next execution of diagPost.

  • Page 162: Diagretry

    Note: Enter commands in lowercase only; mixed case is for readability. diagRetry diagRetry Sets or displays diagnostic retry mode. Synopsis diagretry [mode | -show] Description Use this command to enable retry mode if the mode value is nonzero and to disable the retry mode if the mode value is 0.

  • Page 163: Diagsetburnin

    Note: Enter commands in lowercase only; mixed case is for readability. diagSetBurnin diagSetBurnin Initializes the blade for a burn-in run. Synopsis diagsetburnin [--slot slotnumber][script | -current] Description This sets up the blade burn-in parameters for the registered burn-in script. The burn-in will start at the next run of power-on self-test (POST) on the designated blade(s).

  • Page 164: Diagsetcycle

    Note: Enter commands in lowercase only; mixed case is for readability. diagSetCycle diagSetCycle Sets diagnostic script parameters. Synopsis diagsetcycle script [-show | -default | [-keyword value]] Description Use this command to provide an interactive method to update diagnostic command parameters. If only script is specified, the command displays all configuration variables used by the specified script and enter an interactive session.

  • Page 165: Diagshow

    Note: Enter commands in lowercase only; mixed case is for readability. diagShow diagShow Displays diagnostics status. Synopsis diagshow [--slot number][-uports itemlist][-bports itemlist][-use_bports value] Description Use this command to display the diagnostics status for the specified list of blade or user ports. Operands This command has the following optional operands: -slot number...

  • Page 166: Diagshowtime

    Note: Enter commands in lowercase only; mixed case is for readability. diagShowTime diagShowTime Sets or displays diagnostic show-time mode. Synopsis diagshowtime [mode | -show] Description Use this command to enable show-time mode (if the mode value is not 0) or disable the show-time mode (if the mode value is set to 0).

  • Page 167: Diagskiptests

    Note: Enter commands in lowercase only; mixed case is for readability. diagSkipTests diagSkipTests Enables or disables diagnostics skip test flags. Synopsis diagskiptests [value | -show] Description Use this command to enable or disable the diagnostics skip test flags. The skip test flags are saved in flash memory and stay set until the next execution of diagSkipTests.

  • Page 168: Diagstatus

    Note: Enter commands in lowercase only; mixed case is for readability. diagStatus diagStatus Displays currently running diagnostic tests. Synopsis diagstatus [slotnumber] Description Use this command to display currently running diagnostic test names. Note You can issue this command on the FR4-18i blade in a SilkWorm chassis; however, the command is not supported by the SilkWorm platform and does not effect any other feature operations.

  • Page 169: Diagstopburnin

    Note: Enter commands in lowercase only; mixed case is for readability. diagStopBurnin diagStopBurnin Terminates a blade burn-in run. Synopsis diagstopburnin [--slot number] Description Use this command to determine which PID is running burn-in on a blade and terminate that activity. The burn-in script handles the logging cleanup.

  • Page 170: Distribute

    Note: Enter commands in lowercase only; mixed case is for readability. distribute distribute Distributes data to switches in a fabric. Synopsis distribute -p "policy_list"-d "switch_list" Description Use this command to distribute data to a specific list of switches in the fabric. The data distributed must be from the policy sets currently supported;...

  • Page 171: Dlsreset

    Note: Enter commands in lowercase only; mixed case is for readability. dlsReset dlsReset Disables the dynamic load sharing (DLS) option. Synopsis dlsreset Description Use this command to turn off DLS when a fabric change occurs. Refer to dlsSet for a full description of load sharing.

  • Page 172: Dlsset

    Note: Enter commands in lowercase only; mixed case is for readability. dlsSet dlsSet Enables the dynamic load sharing (DLS) option. Synopsis dlsset Description Use this command to turn on DLS when a fabric change occurs. Routing is generally based on the incoming port and the destination domain. This means that all the traffic coming in from a port (either an E_Port or an Fx_Port) directed to the same remote domain is routed through the same output E_Port.

  • Page 173: Dlsshow

    Note: Enter commands in lowercase only; mixed case is for readability. dlsShow dlsShow Display the setting of the dynamic load sharing (DLS) option. Synopsis dlsshow Description Use this command to display whether DLS is on or off. One of two messages displays: The DLS option is turned on.

  • Page 174: Dnsconfig

    Note: Enter commands in lowercase only; mixed case is for readability. dnsConfig dnsConfig Sets, displays, or removes domain name service (DNS) parameters. Synopsis dnsconfig Description Use this command to display, set, or remove the domain name service parameters. The domain name service parameters are the domain name and the name server IP address for primary and secondary name servers.

  • Page 175: Enclosureshow

    Note: Enter commands in lowercase only; mixed case is for readability. enclosureShow enclosureShow Displays attributes of the switch enclosure. Synopsis enclosureshow attribute Description Use this command to display attributes of the switch enclosure. Currently, supported attributes are the vendor-specific enclosure identifier and the identifier of the enclosure interface to which the switch is attached.
  • Page 176 Note: Enter commands in lowercase only; mixed case is for readability. enclosureShow connloc Displays the switch location within the enclosure. connpres Displays the switch present information used by the enclosure manager. connfuse Displays whether or not the switch has a fuse. Examples To display the identifier of the enclosure interface to which the switch is attached: switch:admin>...

  • Page 177: Errclear

    Note: Enter commands in lowercase only; mixed case is for readability. errClear errClear Clears all error log messages for all switch instances on this control processor (CP). Synopsis errclear Description Use this command to clear all internal and external error log messages for all switch instances on this CP. Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 178: Errdelimiterset

    Note: Enter commands in lowercase only; mixed case is for readability. errDelimiterSet errDelimiterSet Sets the error log start and end delimiter for messages sent to the console and syslog. Synopsis errdelimiterset [-s "start delimiter string"][-e "end delimiter string"] Description Use this command to set the error log start and end delimiter for log messages sent to the console and syslog.

  • Page 179: Errdump

    Note: Enter commands in lowercase only; mixed case is for readability. errDump errDump Displays the error log, without pagination. Synopsis errdump [-s switch_instance][-r][-p] Description Use this command to display external error log messages for all switch instances and the chassis, without pagination.

  • Page 180: Errfilterset

    Note: Enter commands in lowercase only; mixed case is for readability. errFilterSet errFilterSet Sets a filter for an error log destination. Synopsis errfilterset [-d "destination"][-v "severity"] Description Use this command to set a filter for an error log destination. A filter is set based on the severity level of the messages.

  • Page 181: Errmoduleshow

    Note: Enter commands in lowercase only; mixed case is for readability. errModuleShow errModuleShow Displays all the defined error log modules. Synopsis errmoduleshow Description Use this command to display a list of all defined error log modules. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 182: Errshow

    Note: Enter commands in lowercase only; mixed case is for readability. errShow errShow Displays the error log messages, with pagination. Synopsis errshow [-s switch_instance][-r][-p] Description Use this command to display external error log messages for all switch instances and the chassis, one at a time.
  • Page 183 Note: Enter commands in lowercase only; mixed case is for readability. errShow Examples To display the error log, with pagination: switch:user> errshow Version: 4.4.0 2004/07/14-22:24:08, [HAMK-1003], 1,, INFO, switch1, Heartbeat up Type <CR> to continue, Q<CR> to stop: 2004/07/14-22:24:47, [FSSM-1002], 2,, INFO, switchChassis, HA State is in sync Type <CR>...

  • Page 184: Exit

    Note: Enter commands in lowercase only; mixed case is for readability. exit exit Logs out from a shell session. Synopsis exit Description Use this command to log out from a telnet, rlogin or serial port session. Telnet and rlogin connections are closed;...

  • Page 185: Fabportshow

    Note: Enter commands in lowercase only; mixed case is for readability. fabPortShow fabPortShow Displays fabric port information. Synopsis fabportshow [slotnumber/]portnumber Description Use this command to display the state of a port, relative to the fabric, as well as a list of pending commands.
  • Page 186 Note: Enter commands in lowercase only; mixed case is for readability. fabPortShow Sent an RJT to ELP 0x00000080 BF received from the port 0x00000100 Port truly connected to E_Port 0x00000200 Segmented by routing code 0x00000400 fspf has completed routing 0x00000800 Zoning has completed 0x00001000 Segmented by Platform Management...
  • Page 187 Note: Enter commands in lowercase only; mixed case is for readability. fabPortShow ECP RJT or retires exceeded 0x100000000 Segmented due to duplicated WWN 0x200000000 Segmented due to E_Port isolation nbrWWN Neighboring switch's WWN nbrPort Neighboring switch’s port lr_tid Link reset timer identifier and current state. red_ports All E_Ports that are connected to the same neighboring switch Note...

  • Page 188: Fabretryshow

    Note: Enter commands in lowercase only; mixed case is for readability. fabRetryShow fabRetryShow Displays the retry count of the fabric commands. Synopsis fabretryshow Description Use this command to display the retry count of the fabric commands. The SW_ISL (ISL ports) information displays the retry count for the following fabric commands: Exchange Link Parameters Exchange Fabric Parameters...

  • Page 189: Fabriclog

    Note: Enter commands in lowercase only; mixed case is for readability. fabricLog fabricLog Displays (all users) or manipulates (admin) the fabric log. Synopsis fabriclog -s | -c | -d | -e | -r size Description Use this command to display, clear, disable, enable, or resize the fabric log. Note The execution of this command is subject to Admin Domain restrictions that may be in place.
  • Page 190 Note: Enter commands in lowercase only; mixed case is for readability. fabricLog Examples To change the number of entries: switch:admin> fabriclog -s Time Stamp Input and *Action S, P Sn,Pn Port =========================================================================== Wed Apr 6 01:08:52 2005 01:08:52.977 SCN Switch Offline A2,NA F2,NA 01:08:52.977 *Snd SW state: F2...

  • Page 191: Fabricprincipal

    Note: Enter commands in lowercase only; mixed case is for readability. fabricPrincipal fabricPrincipal Sets principal switch selection mode. Synopsis fabricprincipal [-fhq][mode] Description Use this command to set principal switch selection mode for the switch. The implementation of the fabricPrincipal command is based solely on mechanisms specified in the Fibre Channel standards.

  • Page 192: Fabricshow

    Note: Enter commands in lowercase only; mixed case is for readability. fabricShow fabricShow Displays fabric membership information. Synopsis fabricshow Description Use this command to display information about switches in the fabric. If the switch is initializing or disabled, the message “no fabric” is displayed. If the fabric is reconfiguring, some or all switches might not be displayed;...
  • Page 193 Note: Enter commands in lowercase only; mixed case is for readability. fabricShow To show additional details of the FC Router, if present. switch:admin> fabricshow -m Switch ID Name ENET IP Addr FC Router FC Router IP Addr Name ------------------------------------------------------------------------- 1: fffc01 fcr_sprint_01 10.33.59.224 160: fffca0 fcr_fd_160...

  • Page 194: Fabstateclear

    Note: Enter commands in lowercase only; mixed case is for readability. fabStateClear fabStateClear Clears the fabric state information. Synopsis fabstateclear Description Use this command to clear the queue of fabric state information logged by the fabric. Note This command is obsoleted by fabricLog Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 195: Fabstateresize

    Note: Enter commands in lowercase only; mixed case is for readability. fabStateResize fabStateResize Changes the number of state entries. Synopsis fabStateResize num Description Use this command to change the number of logged state entries. This command also clears the logged entries.

  • Page 196: Fabstateshow

    Note: Enter commands in lowercase only; mixed case is for readability. fabStateShow fabStateShow Displays the fabric state information. Synopsis fabstateshow Description Use this command to display the queue of fabric state information logged by the fabric. Note This command is obsoleted by fabricLog Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 197: Fabstatsshow

    Note: Enter commands in lowercase only; mixed case is for readability. fabStatsShow fabStatsShow Displays the fabric statistics. Synopsis fabstatsshow Description Use this command to display the statistics for the fabric. The information displays as follows: • Number of times a switch domain ID has been forcibly changed •...
  • Page 198 Note: Enter commands in lowercase only; mixed case is for readability. fabStatsShow Examples To display the fabric statistics: switch:admin> fabstatsshow Description Count ----------------------------------------- Domain ID forcibly changed: E_Port offline transitions: Reconfigurations: Segmentations due to: Loopback: 6 < Incompatibility: Overlap: Zoning: E_Port Segment: Licensing: Disabled E_Port:...

  • Page 199: Fabswitchshow

    Note: Enter commands in lowercase only; mixed case is for readability. fabSwitchShow fabSwitchShow Displays the fabric switch state structure information. Synopsis fabswitchshow Description Use this command to display the fabric switch state structure information. This command is strictly for debugging; it is not intended as a user command. Note The execution of this command is subject to Admin Domain restrictions that may be in place.
  • Page 200 Note: Enter commands in lowercase only; mixed case is for readability. fabSwitchShow See Also supportShow 2-166 Fabric OS Command Reference Manual Publication Number: 53-1000240-01...

  • Page 201: Fandisable

    Note: Enter commands in lowercase only; mixed case is for readability. fanDisable fanDisable Disables a fan unit. Synopsis fandisable unit Description Use this command to disable a nonfaulty fan unit by setting the RPM speed to 0. Note This command is not available on nonbladed systems except for the SilkWorm 4100 and 4900. Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 202: Fanenable

    Note: Enter commands in lowercase only; mixed case is for readability. fanEnable fanEnable Enables a fan unit. Synopsis fanenable unit Description Use this command to set a previously disabled fan unit back to the default RPM speed. Note This command is not available on nonbladed systems except for the SilkWorm 4100 and 4900. Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 203: Fanshow

    Note: Enter commands in lowercase only; mixed case is for readability. fanShow fanShow Displays fan status and speed. Synopsis fanshow Description Use this command to display the current status and speed of each fan in the system. Fan status is displayed as: Fan is functioning correctly.

  • Page 204: Fastboot

    Note: Enter commands in lowercase only; mixed case is for readability. fastboot fastboot Reboots the Control Processor (CP), bypassing Power-On Self-Tests (POST). Synopsis fastboot Description Use this command to immediately reboot the CP. This command is similar to reboot, but skips POST when the system comes back up, reducing boot time significantly.

  • Page 205: Fazoneadd

    Note: Enter commands in lowercase only; mixed case is for readability. fazoneAdd fazoneAdd Adds a member to a Fabric Assist (FA) zone. Synopsis fazoneadd "fazoneName","member; member" Description Use this command to add one or more members to an existing Fabric Assist zone. This command does not change the defined configuration (which you can view using the cfgShow command).

  • Page 206: Fazonecreate

    Note: Enter commands in lowercase only; mixed case is for readability. fazoneCreate fazoneCreate Creates a Fabric Assist (FA) zone. Synopsis fazonecreate "fazoneName","member; member ..." Description Use this command to create a new Fabric Assist zone. You must specify a name and member list. The FA zone name must be unique among all Fabric Assist zone objects.
  • Page 207 Note: Enter commands in lowercase only; mixed case is for readability. fazoneCreate Operands This command has the following operands: fazoneName Specify a name for the Fabric Assist zone, in quotation marks. This operand is required. member Specify a member or list of members to add to a Fabric Assist zone, in quotation marks, with members separated by semicolons.

  • Page 208: Fazonedelete

    Note: Enter commands in lowercase only; mixed case is for readability. fazoneDelete fazoneDelete Deletes a Fabric Assist mode (FA) zone. Synopsis fazonedelete "fazonename" Description Use this command to delete an existing Fabric Assist mode zone on a fabric. This command does not change the defined configuration (which you can view using the cfgShow command).

  • Page 209: Fazoneremove

    Note: Enter commands in lowercase only; mixed case is for readability. fazoneRemove fazoneRemove Removes members from a Fabric Assist mode (FA) zone. Synopsis fazoneremove "fazoneName", "member [;member ...]" Description Use this command to remove one or more members from an existing Fabric Assist zone. If all members are removed, the Fabric Assist zone is deleted.

  • Page 210: Fazoneshow

    Note: Enter commands in lowercase only; mixed case is for readability. fazoneShow fazoneShow Displays Fabric Assist zone information. Synopsis fazoneshow ["pattern"[, transflag]] Description Use this command to display Fabric Assist zone information. Using this command with no operands or with the second parameter set to 0 displays all Fabric Assist zone configuration information for both defined and effective configurations.

  • Page 211: Fcipchiptest

    Note: Enter commands in lowercase only; mixed case is for readability. fcipChipTest fcipChipTest Tests functionality of components in the FCIP complex. Synopsis fcipchiptest [--slot slotnumber][-testtype type][-unit number] Description Use this command to verify the internal registers and memory of the network processor, FCIP FPGA, compression processor, and GigPHY.
  • Page 212 Note: Enter commands in lowercase only; mixed case is for readability. fcipChipTest Diagnostics When a failure is detected, the test might report one or more of the following error messages: • CHIP_TEST_ERR • CHIP_TEST_CHIP_INIT_ERR • CHIP_TEST_IMAGE_VER_ERR • CHIP_TEST_TIMEOUT_ERR • CHIP_TEST_HEARBEAT_ERR •...

  • Page 213: Fcippathtest

    Note: Enter commands in lowercase only; mixed case is for readability. fcipPathTest fcipPathTest Tests data path of the FCIP complex. Synopsis fcippathtest [--slot slotnumber][-unit number][-path mode][-nframes count ][-length data_length] [-compress mode] Description Use this command to verify the data paths in the FCIP complex. All data path modes run tests by comparing Fibre Channel frames or data packets transmitted from and received by the network processor due to the designated loopback.
  • Page 214 Note: Enter commands in lowercase only; mixed case is for readability. fcipPathTest Examples To run the test on slot 2 with PHY loopback sending 10 frames: switch:admin> fcippathtest --slot 2 -path 2 -nframes 10 Running fcippathtest ....Test Complete: fcippathtest Pass 10 of 10 Duration 0 hr, 1 min &...

  • Page 215: Fclunquery

    Note: Enter commands in lowercase only; mixed case is for readability. fcLunQuery fcLunQuery Displays a list of LUN IDs and LUNs for all accessible targets. Synopsis fclunquery [-w wwn | -s] Description Use this command to display a list of LUN IDs and LUNs for all accessible targets. Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 216: Fcping

    Note: Enter commands in lowercase only; mixed case is for readability. fcPing fcPing Sends a Fibre Channel Extended Link Service (ELS) Echo request to a pair of ports. Synopsis fcping [-hbq][-n frames][-l length][-i wait][-p pattern] source destination Description Use this command to perform a zoning check between the source and destination. In addition, two Fibre Channel ELS request are generated.
  • Page 217 Note: Enter commands in lowercase only; mixed case is for readability. fcPing Specifies quiet output. Only the zoning information and the summary line display on program termination. source Specifies the source port ID, port WWN, or node WWN. destination Specifies the destination port ID, port WWN, or node WWN. Examples To display one device that accepts the request and another device that rejects the request: switch:admin>...

  • Page 218: Fcplogclear

    Note: Enter commands in lowercase only; mixed case is for readability. fcpLogClear fcpLogClear Clears the FCPD debug information log (debug command). Synopsis fcplogclear Description Use this command to clear the debug information logged by FCPD. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 219: Fcplogdisable

    Note: Enter commands in lowercase only; mixed case is for readability. fcpLogDisable fcpLogDisable Disables the FCPD debug information log (debug command). Synopsis fcplogdisable Description Use this command to disable the debug information logged by FCPD. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 220: Fcplogenable

    Note: Enter commands in lowercase only; mixed case is for readability. fcpLogEnable fcpLogEnable Enables the FCPD debug information log (debug command). Synopsis fcplogenable Description Use this command to enable the debug information logged for FCPD. Debug information logging is enabled by default. Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 221: Fcplogshow

    Note: Enter commands in lowercase only; mixed case is for readability. fcpLogShow fcpLogShow Displays the FCPD debug information log (debug command). Synopsis fcplogshow Description Use this command to display the debug information logged at various stages of FCP device probing. Operands none Examples...

  • Page 222: Fcpprobeshow

    Note: Enter commands in lowercase only; mixed case is for readability. fcpProbeShow fcpProbeShow Displays the Fibre Channel Protocol (FCP) probe information. Synopsis fcpprobeshow [slotnumber/]portnumber Description Use this command to display the FCP probing information for the devices attached to the specified F_Port or FL_Port.

  • Page 223: Fcprlsshow

    Note: Enter commands in lowercase only; mixed case is for readability. fcpRlsShow fcpRlsShow Displays the Fibre Channel Protocol (FCP) Read Link Status (RLS) information. Synopsis fcprlsshow [slotnumber/]portnumber Description Use this command to display the FCP RLS information for the specified F_Port or FL_Port. This information describes the number of loss-of-signal, loss-of-sync, CRC-error, and other failure events that have been detected on this port.

  • Page 224: Fcrchiptest

    Note: Enter commands in lowercase only; mixed case is for readability. fcrChipTest fcrChipTest Tests the functionality of FC Router FPGA. Synopsis fcrchiptest [--slot slotnumber][-testtype type][-unit number] Description Use this command to verify that all SRAM and register data bits in each ASIC can be independently written and read successfully.
  • Page 225 Note: Enter commands in lowercase only; mixed case is for readability. fcrChipTest Examples To run all tests on slot 7 and FC Router FPGA 1: switch:admin> fcrchiptest --slot 7 -unit 1 -testtype 0 Running fcrchiptest ....Test Complete: fcrchiptest Pass 1 of 1 Duration 0 hr, 0 min &...

  • Page 226: Fcrconfigure

    Note: Enter commands in lowercase only; mixed case is for readability. fcrConfigure fcrConfigure Sets FC Router configuration parameters. Synopsis fcrconfigure Description Use this command to configure the FC Router parameters for this platform. This is an interactive command. This command cannot execute on a system with the FC Router feature enabled. First disable FC routing by using either fcrDisable or switchDisable.

  • Page 227: Fcrdisable

    Note: Enter commands in lowercase only; mixed case is for readability. fcrDisable fcrDisable Disables the FC Routing service on a switch. Synopsis fcrdisable Description Use this command to disable Fibre Channel (FC) routing on a switch. This command can be run while the switch state is “online”. Instead of disabling the switch, issue this command to disable the FC Routing service only, then change the BB fabric ID using fcrConfigure.

  • Page 228: Fcrenable

    Note: Enter commands in lowercase only; mixed case is for readability. fcrEnable fcrEnable Enables the FC Routing service on the switch. Synopsis fcrenable Description Use this command to enable the Fibre Channel (FC) Routing service on a switch. In Fabric OS v5.1 the FC Routing service is enabled by default.

  • Page 229: Fcrfabricshow

    Note: Enter commands in lowercase only; mixed case is for readability. fcrFabricShow fcrFabricShow Displays FC Routers on a backbone fabric. Synopsis fcrfabricshow Description Use this command to display the FC Routers that exist in an FC Router backbone fabric and to display information about these FC Routers.

  • Page 230: Fcrpathtest

    Note: Enter commands in lowercase only; mixed case is for readability. fcrPathTest fcrPathTest Tests the data path connection between FC Router FPGA and the central ASIC. Synopsis fcrpathtest [--slot slotnumber][-unit number][-path mode][-nmegs count] Description Use this command to verify the data path connecting the FC Router FPGA and the central ASIC by sending frames from the FC Router FPGA port N’s transmitter, and looping the frames back into the same port N’s receiver.
  • Page 231 Note: Enter commands in lowercase only; mixed case is for readability. fcrPathTest RANDOM 0x25, 0x7f, 0x6e, 0x9a, ... Note This command is supported only on SilkWorm FR4-18i blades and SilkWorm 7500 platforms. Operands This command has the following operands: --slot slotnumber Specifies the slot number on which the diagnostic operates.

  • Page 232: Fcrphydevshow

    Note: Enter commands in lowercase only; mixed case is for readability. fcrPhyDevShow fcrPhyDevShow Displays the FC Router physical device information. Synopsis fcrphydevshow [-a][-f fabricid][-w wwn][-c][-d] Description Use this command to display the physical (real) devices that are configured to be exported to other fabrics.
  • Page 233 Note: Enter commands in lowercase only; mixed case is for readability. fcrPhyDevShow Examples To display the physical devices relevant to this FC Router: fcr:admin> fcrphydevshow Device Physical Exists in Fabric ----------------------------------------- 10:00:00:00:c9:2b:6a:68 c70000 50:05:07:65:05:84:09:0e 0100ef 50:05:07:65:05:84:0b:83 0100e8 Total devices displayed: 3 See Also fcrFabricShow, fcrProxyDevShow, fcrRouteShow, lsanZoneShow, switchShow...

  • Page 234: Fcrproxyconfig

    Note: Enter commands in lowercase only; mixed case is for readability. fcrProxyConfig fcrProxyConfig Displays or configures proxy devices presented by an FC Router. Synopsis fcrproxyconfig [-s importedFID devWWN slot][-r importedFID devWWN] Description Use this command to display or set the persistent configuration of proxy devices presented by the local FC Router.
  • Page 235 Note: Enter commands in lowercase only; mixed case is for readability. fcrProxyConfig “The specified slot already contains a WWN, overwrite? [y]” is displayed if the specified slot already contains an entry. You are then prompted for overwrite confirmation. -r importedFID devWWN Removes the specified devWWN (format: XX:XX:XX:XX:XX:XX:XX:XX) from its slot for the edge fabric specified by importedFID (1 through 128).

  • Page 236: Fcrproxydevshow

    Note: Enter commands in lowercase only; mixed case is for readability. fcrProxyDevShow fcrProxyDevShow Displays FC Router proxy device information. Synopsis fcrproxydevshow [-a][-f fabricid][-w wwn] Description Use this command to display the proxy devices presented by FC Router EX_Ports and information about the proxy devices.
  • Page 237 Note: Enter commands in lowercase only; mixed case is for readability. fcrProxyDevShow Examples To display the proxy devices relevant to this FC Router: switch:admin> fcrproxydevshow Proxy Proxy Device Physical State Created Exists in Fabric in Fabric ---------------------------------------------------------------------------- 50:05:07:65:05:84:09:0e 01f001 0100ef Imported 50:05:07:65:05:84:0b:83 01f000...

  • Page 238: Fcrresourceshow

    Note: Enter commands in lowercase only; mixed case is for readability. fcrResourceShow fcrResourceShow Displays FC Router physical resource usage. Synopsis fcrresourceshow Description Use this command to display the FC Router-available resources. The maximum number allowed versus the currently used is displayed for the various resources. The command output includes: LSAN Zones The maximum versus the currently used LSAN zones.
  • Page 239 Note: Enter commands in lowercase only; mixed case is for readability. fcrResourceShow Examples To display the resource usage for the local FC Router: fcr:admin> fcrresourceshow Daemon Limits: Max Allowed Currently Used ---------------------------------- LSAN Zones: 3000 LSAN Devices: 10000 Proxy Device Slots: 10000 WWN Pool Size Allocated...

  • Page 240: Fcrrouterportcost

    Note: Enter commands in lowercase only; mixed case is for readability. fcrRouterPortCost fcrRouterPortCost Displays FC Router route information. Synopsis fcrrouterportcost [[slotnumber/]portnumber] [cost] Description Use this command to set or display the cost of the router ports. The cost of the link is a dimensionless positive number (which can be 0 or 1000 or 10000).
  • Page 241 Note: Enter commands in lowercase only; mixed case is for readability. fcrRouterPortCost To set the cost of an EX_Port: fcr:admin> switch:admin> fcrrouterportcost 7/10 10000 See Also switchShow, fcrRouteShow, portCfgEXPort Fabric OS Command Reference Manual 2-207 Publication Number: 53-1000240-01...

  • Page 242: Fcrrouteshow

    Note: Enter commands in lowercase only; mixed case is for readability. fcrRouteShow fcrRouteShow Displays FC Router route information. Synopsis fcrrouteshow Description Use this command to display routes through the FC Router backbone fabric to accessible destination fabrics. An FC Router backbone fabric is the fabric that contains the E_Ports of this platform and routes interfabric traffic between imported fabrics, creating a meta-SAN.

  • Page 243: Fcrxlateconfig

    Note: Enter commands in lowercase only; mixed case is for readability. fcrXlateConfig fcrXlateConfig Displays or persistently configures a translate (xlate) domain ID for both the EX_port-attached fabric and the backbone fabric. Synopsis fcrxlateconfig importedFabricID exportedFabricID preferredDomainID fcrxlateconfig [-r] importedFabricID exportedFabricID Description Use this command to display a translate domain ID or change the preferred domain ID.
  • Page 244 Note: Enter commands in lowercase only; mixed case is for readability. fcrXlateConfig Examples To display the translate domain configuration: fcr:admin> fcrxlateconfig ImportedFid ExportedFid Domain OwnerDid XlateWWN 000001 50:00:51:e1:30:30:0f:05 To set the preferred domain ID of the translate domain created in fabric 2 that represents remote fabric 3 to a value of 8: fcr:admin>...

  • Page 245: Fddcfg

    Note: Enter commands in lowercase only; mixed case is for readability. fddCfg fddCfg Manages the fabric data distribution configuration parameters. Synopsis fddcfg [--showall | --localaccept policy_list | --localreject policy_list | --fabwideset policy_set ] Description Use this command to manage the fabric data distribution configuration parameters. These parameters control the fabric-wide consistency policy in non-secure mode.
  • Page 246 Note: Enter commands in lowercase only; mixed case is for readability. fddCfg To configure this switch to reject distribution of SCC and DCC policy sets: switch:admin> fddcfg --localreject “SCC;DCC” Local Switch Configured to reject policies. To set the Fabric-Wide Consistency Policy to “strict” for SCC and “tolerant” for DCC: switch:admin>...

  • Page 247: Fdmicacheshow

    Note: Enter commands in lowercase only; mixed case is for readability. fdmiCacheShow fdmiCacheShow Displays abbreviated remote FDMI device information, according to remote domain ID. Synopsis fdmicacheshow Description Use this command to display FDMI cache information for remote domains only. The state of each remote domain, identified by its domain ID, is shown to be unknown, known, unsupported, or error.

  • Page 248: Fdmishow

    Note: Enter commands in lowercase only; mixed case is for readability. fdmiShow fdmiShow Displays detailed FDMI device information. Synopsis fdmishow Description Use this command to display FDMI information for all HBAs and ports. Detailed FDMI information is displayed for local HBAs and ports. This information includes the HBA with its corresponding ports, along with their respective attributes.

  • Page 249: Ficonclear

    Note: Enter commands in lowercase only; mixed case is for readability. ficonClear ficonClear Clears the records from the specified FICON database. Synopsis ficonclear database Description Use this command to remove records from the local FICON database. The command effect depends on the specified database.

  • Page 250: Ficoncupset

    Note: Enter commands in lowercase only; mixed case is for readability. ficoncupset ficoncupset Sets FICON-CUP parameters for a switch. Synopsis ficoncupset fmsmode enable | disable ficoncupset modereg bitname 0 | 1 Description Use this command to set FICON-CUP (Control Unit Port) parameters for a switch. All the parameters described below can be set while the switch is online.

  • Page 251: Ficoncupshow

    Note: Enter commands in lowercase only; mixed case is for readability. ficoncupshow ficoncupshow Displays FICON-CUP parameters for a switch. Synopsis ficoncupshow fmsmode ficoncupshow modereg [bitname] Description Use this command to display FICON-CUP (Control Unit Port) parameters for a switch. Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 252: Ficonhelp

    Note: Enter commands in lowercase only; mixed case is for readability. ficonHelp ficonHelp Displays a list of FICON support commands. Synopsis ficonhelp Description Use this command to display a list of FICON support commands, with descriptions. Operands none Examples To display a list of FICON commands: switch:admin>...

  • Page 253: Ficonshow

    Note: Enter commands in lowercase only; mixed case is for readability. ficonShow ficonShow Displays the contents of the specified FICON database. Synopsis ficonshow database [fabric] where database is one of the following: ficonshow RNID [fabric] ficonshow LIRR [fabric] ficonshow SwitchRNID [fabric] ficonshow RLIR [fabric] ficonshow ILIR [fabric] Description...
  • Page 254 Note: Enter commands in lowercase only; mixed case is for readability. ficonShow Link Incident Description Same as Link Incident Type. Link Incident Type Indicates the link incident type as one of the following: • Bit-error-rate threshold exceeded • Loss of signal or synchronization •...
  • Page 255 Note: Enter commands in lowercase only; mixed case is for readability. ficonShow Byte BB 0x00 Unspecified class. 0x01 Direct access storage device, if it is an storage port; otherwise, not channel-to-channel capable. 0x02 Magnetic tape, if it is an storage port; otherwise, a reserved field for a channel port.
  • Page 256 Note: Enter commands in lowercase only; mixed case is for readability. ficonShow • Protocol Displays whether the traffic is using FICON or FCP. Registered Node WWN Displays the device's node World Wide Name associated with the device HBA. Registered Port WWN Displays the device's channel or storage CU port World Wide Name associated with the device HBA.
  • Page 257 Note: Enter commands in lowercase only; mixed case is for readability. ficonShow Examples To display the local RNID database: switch:admin> ficonshow RNID {Fmt Type PID Registered Port WWN Registered Node WWN flag Parm 0x18 N 502b00 50:05:07:64:01:00:15:8d 50:05:07:64:00:c1:69:ca 0x10 0x200110 Type number: 002064 Model number:...
  • Page 258 Note: Enter commands in lowercase only; mixed case is for readability. ficonShow To display the local RLIR database: switch:user> ficonshow RLIR {Fmt Type PID Port Incident Count TS Format Time Stamp 0x18 N 502e00 1 Time server Mon Jan 13 04:29:33 2003 Port Status: Link not operational Link Failure Type:...

  • Page 259: Filtertest

    Note: Enter commands in lowercase only; mixed case is for readability. filterTest filterTest Tests frame filters. Synopsis filtertest [--slot slotnumber][-passcnt passcnt][-txports itemlist][-scamoff offset][-dcamoff offset] [-fdefoff offset] Description Use this command to verify the ASIC frame-level filtering logic including every type of filter actions: FLTACT_LIST_A Action to handle the subgroup A-based filtering.
  • Page 260 Note: Enter commands in lowercase only; mixed case is for readability. filterTest Operands This command has the following operands: --slot slotnumber Specify the slot number on which the diagnostic operates. The port specified are relative to this slot number. The default is 0 and designed to operate on fixed-port- count products.

  • Page 261: Firmwarecommit

    Note: Enter commands in lowercase only; mixed case is for readability. firmwareCommit firmwareCommit Commits switch firmware. Synopsis firmwarecommit Description Use this command to commit a firmware download to a CP. This command copies an updated firmware image to the secondary partition and commits both partitions of the CP to an updated version of the firmware.

  • Page 262: Firmwaredownload

    Note: Enter commands in lowercase only; mixed case is for readability. firmwareDownload firmwareDownload Downloads switch firmware from a remote host or a local directory. Synopsis firmwaredownload [[-s [-b -n]] host,user,pfile,passwd] Description Use this command to download switch firmware from an FTP server or from a local NFS directory to the switch’s nonvolatile memory.
  • Page 263 Note: Enter commands in lowercase only; mixed case is for readability. firmwareDownload Note The execution of this command is subject to Admin Domain restrictions that may be in place. Fabric OS Command Reference Manual 2-229 Publication Number: 53-1000240-01...
  • Page 264 Note: Enter commands in lowercase only; mixed case is for readability. firmwareDownload Operands By default, firmwareDownload performs full install, autoreboot, and autocommit. These modes are selectable only in single-CP (-s) mode, in which case autoreboot is off by default. You can change these settings interactively or using the following options: Specify this operand to enable single-CP mode.
  • Page 265 Note: Enter commands in lowercase only; mixed case is for readability. firmwareDownload Examples To download the firmware to an HA switch: switch:admin> firmwaredownload 192.168.166.30,johndoe,/pub/dist/release.plist,12345 The following BP blades are installed in the system. Slot Name Versions Scope of Impact ----------------------------------------------------------------- 2 FR4-18i v5.1.0 GigE...

  • Page 266: Firmwaredownloadstatus

    Note: Enter commands in lowercase only; mixed case is for readability. firmwareDownloadStatus firmwareDownloadStatus Displays the status of a firmware download. Synopsis firmwaredownloadstatus Description Use this command to display an event log that records the progress and status of the current firmwareDownload command.
  • Page 267 Note: Enter commands in lowercase only; mixed case is for readability. firmwareDownloadStatus To display the status of a firmware download on a SilkWorm director: switch:admin> firmwaredownloadstatus [1]: Mon Dec 19 18:40:19 2005 Slot 6 (CP1, active): Firmware is being downloaded to standby CP. This step may take up to 30 minutes.

  • Page 268: Firmwarerestore

    Note: Enter commands in lowercase only; mixed case is for readability. firmwareRestore firmwareRestore Restores the former active firmware image. Synopsis firmwarerestore Description Use this command to restore the former active firmware image. This command can only be run if autocommit was disabled during the firmwareDownload. After a firmwareDownload and a...

  • Page 269: Firmwareshow

    Note: Enter commands in lowercase only; mixed case is for readability. firmwareShow firmwareShow Displays the Fabric OS versions on both partitions of the local and remote CPs. Synopsis firmwareshow Description Use this command to display the Fabric OS versions on primary and secondary partitions. For systems with multiple control processor (CP) cards and AP blades, this command displays this information for both local and remote CPs and the AP blades.

  • Page 270: Fporttest

    Note: Enter commands in lowercase only; mixed case is for readability. fportTest fportTest Functional test of F->N, N->F point-to-point path. Synopsis fporttest [-nframes count][-ports itemlist][-seed payload_pattern][-width pattern_width] [-size pattern_size] Description Use this command to verify the functional operation of the switch by sending ELS Echo frames from the switch F_Port transmitter and receiving ELS Echo ACC from the N_Port device into the F_Port receiver.
  • Page 271 Note: Enter commands in lowercase only; mixed case is for readability. fportTest Operands This command has the following operands: -nframes count Specify the number of times (or number of frames per port) to execute this test. If count is omitted, the default of 10 is used. This operand is optional. -ports itemlist Specify the ports to test.
  • Page 272 Note: Enter commands in lowercase only; mixed case is for readability. fportTest ERR_STAT_2LONG ERR_STAT_BADEOF ERR_STAT_BADOS ERR_STAT_C3DISC ERR_STAT_CRC ERR_STAT_ENCIN ERR_STAT_ENCOUT ERR_STAT_TRUNC FDET_PERR FINISH_MSG_ERR FTPRT_STATUS_ERR LESSN_STATUS_ERR MBUF_STATE_ERR MBUF_STATUS_ERR NO_SEGMENT PORT_ABSENT PORT_ENABLE PORT_M2M PORT_STOPPED PORT_WRONG RXQ_FRAME_ERR RXQ_RAM_PERR STATS STATS_C3FRX STATS_FRX STATS_FTX TIMEOUT XMIT Refer to the Fabric OS Message Reference for more information.

  • Page 273: Fosconfig

    Note: Enter commands in lowercase only; mixed case is for readability. fosConfig fosConfig Displays or modifies Fabric OS features. Synopsis fosconfig [--enable feature | --disable feature] | [--show] Description Use this command to enable or disable a feature, or display the current operating status of features on a switch.
  • Page 274 Note: Enter commands in lowercase only; mixed case is for readability. fosConfig and try the command again. • "FC Routing service is already disabled" - This means that the FC Routing service is already disabled. switchShow to display the current state of the FC Routing service. •...

  • Page 275: Frureplace

    Note: Enter commands in lowercase only; mixed case is for readability. fruReplace fruReplace Interactive interface to replace a field replaceable unit (FRU). Synopsis frureplace fru Description Use this command to guide the user in replacing a FRU. The command automatically performs the necessary backup and restore (steps to accommodate the replacement).

  • Page 276: Fspfshow

    Note: Enter commands in lowercase only; mixed case is for readability. fspfShow fspfShow Displays Fabric Shortest Path First (FSPF) protocol information. Synopsis fspfshow Description Use this command to display the FSPF protocol information and internal data structures to the FSPF module.
  • Page 277 Note: Enter commands in lowercase only; mixed case is for readability. fspfShow Operands none Examples To display FSPF protocol information: switch:admin> fspfshow version domainID = 131 switchOnline = TRUE domainValid = TRUE isl_ports[0] = 0x00000000 isl_ports[1] = 0x74000000 trunk_ports[0] = 0x00000000 trunk_ports[1] = 0x02000000 f_ports[0]...

  • Page 278: Fwalarmsfilterset

    Note: Enter commands in lowercase only; mixed case is for readability. fwAlarmsFilterSet fwAlarmsFilterSet Enables or disables alarms for Fabric Watch. Synopsis fwalarmsfilterset [mode] Description Use this command to configure alarm filtering for Fabric Watch. By turning off the alarms, all non- environment class alarms are suppressed.

  • Page 279: Fwalarmsfiltershow

    Note: Enter commands in lowercase only; mixed case is for readability. fwAlarmsFilterShow fwAlarmsFilterShow Displays alarm filtering for Fabric Watch. Synopsis fwalarmsfiltershow Description Use this command to display whether alarm filtering is enabled or disabled. Note This command requires a Fabric Watch license. Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 280: Fwclassinit

    Note: Enter commands in lowercase only; mixed case is for readability. fwClassInit fwClassInit Initializes all classes under Fabric Watch. Synopsis fwclassinit Description Use this command to initialize all classes under Fabric Watch. The command should only be used after installing a Fabric Watch license to start licensed Fabric Watch classes. Refer to fwConfigure for a list of classes.

  • Page 281: Fwconfigreload

    Note: Enter commands in lowercase only; mixed case is for readability. fwConfigReload fwConfigReload Reloads the Fabric Watch configuration. Synopsis fwconfigreload Description Use this command to reload the Fabric Watch configuration. This command should only be used after downloading a new Fabric Watch configuration file from a host. Note This command requires a Fabric Watch license.

  • Page 282: Fwconfigure

    Note: Enter commands in lowercase only; mixed case is for readability. fwConfigure fwConfigure Displays and modifies the Fabric Watch configuration. Synopsis fwconfigure [--enable --port portNumber] | [--disable --port portNumber] Description Use this command to display and modify threshold information for the Fabric Watch configuration. Switch elements monitored by Fabric Watch are divided into classes, which are further divided into areas.
  • Page 283 Note: Enter commands in lowercase only; mixed case is for readability. fwConfigure Table 2-12 fwConfigure Fabric Watch Classes and Areas Class Area AL_PA Performance Monitor Invalid CRCS EE Performance Monitor Invalid CRCS RX Performance TX Performance Filter Performance Monitor Customer Defined Security Telnet Violations HTTP Violations...
  • Page 284 Note: Enter commands in lowercase only; mixed case is for readability. fwConfigure Examples To configure thresholds: switch:admin> fwconfigure 1 : Environment class 2 : SFP class 3 : Port class 4 : Fabric class 5 : E-Port class 6 : F/FL Port (Optical) class 7 : Alpa performance Monitor class 8 : EE performance Monitor class 9 : Filter performance Monitor class...

  • Page 285: Fwfrucfg

    Note: Enter commands in lowercase only; mixed case is for readability. fwFruCfg fwFruCfg Displays or modifies FRU state alert configuration. Synopsis fwfrucfg [--show] Description Use this command to configure FRU states and actions. Based on these configuration settings, Fabric Watch generates action when an FRU state changes. To configure email alerts, use fwMailCfg. Note This command requires a Fabric Watch license.

  • Page 286: Fwhelp

    Note: Enter commands in lowercase only; mixed case is for readability. fwHelp fwHelp Displays Fabric Watch command information. Synopsis fwhelp Description Use this command to display the commands that configure Fabric Watch. Operands none Examples To display a summary of Fabric Watch commands: switch:user>...

  • Page 287: Fwmailcfg

    Note: Enter commands in lowercase only; mixed case is for readability. fwMailCfg fwMailCfg Displays and configures Fabric Watch email alerts. Synopsis fwmailcfg Description Use this command to display or modify the configuration and status of the Fabric Watch email alert in the switch.
  • Page 288 Note: Enter commands in lowercase only; mixed case is for readability. fwMailCfg mail configuration information -------------------------------------------- Email Alert = disable Mail Recipients = NONE -------------------------------------------- : Show Mail Configuration Information : Disable Email Alert : Enable Email Alert : Send Test Mail : Set Recipient Mail Address for Email Alert : Quit Select an item =>...

  • Page 289: Fwportdetailshow

    Note: Enter commands in lowercase only; mixed case is for readability. fwPortDetailShow fwPortDetailShow Displays the port information for specified user ports. Synopsis fwportdetailshow [--p portNumber] | [--s portState] Description Use this command to print the overall status of the ports specified. The overall status is calculated based on the following contributors: Port Errors Number of link loss occurrences exceeded limit for time period...
  • Page 290 Note: Enter commands in lowercase only; mixed case is for readability. fwPortDetailShow Operands This command has the following operands: --p portNumber Yields a port detail report for a specific user port. --s portState Yields a port detail report for the specified portState. Valid portState entries are: Report based on all healthy ports Report based on all marginal ports Report based on all faulty ports...

  • Page 291: Fwsamshow

    Note: Enter commands in lowercase only; mixed case is for readability. fwSamShow fwSamShow Displays switch availability monitor information. Synopsis fwsamshow Description Use this command to display information about port availability. The information displayed includes total uptime, total downtime, number of faulty occurrences, and total percent of downtime for each port. In an AD-aware environment, this command is allowed only if the local switch is a member of the current Admin Domain.

  • Page 292: Fwset

    Note: Enter commands in lowercase only; mixed case is for readability. fwSet fwSet Sets the parameters controlled by Fabric Watch. Synopsis fwset --port --persistence seconds Description Use this command to set parameters controlled by Fabric Watch. It allows the user to set the port persistence time (time in which a port must persistently be in a marginal state before being labeled as such) Note...

  • Page 293: Fwsettocustom

    Note: Enter commands in lowercase only; mixed case is for readability. fwSetToCustom fwSetToCustom Sets boundary and alarm levels to custom values. Synopsis fwsettocustom Description Use this command to set boundary and alarm levels to custom values for all classes and areas in Fabric Watch.

  • Page 294: Fwsettodefault

    Note: Enter commands in lowercase only; mixed case is for readability. fwSetToDefault fwSetToDefault Returns boundary and alarm levels to the default values. Synopsis fwsettodefault Description Use this command to return boundary and alarm levels to defaults for all classes and areas in Fabric Watch.

  • Page 295: Fwshow

    Note: Enter commands in lowercase only; mixed case is for readability. fwShow fwShow Displays the thresholds monitored by Fabric Watch. Synopsis fwshow [--port --persistence] | [--disable --port] Description Use this command to display the thresholds monitored by Fabric Watch. This command also displays the port persistence time and ports with all thresholds disabled.
  • Page 296 Note: Enter commands in lowercase only; mixed case is for readability. fwShow Examples To display thresholds and port persistence time: switch:user> fwshow : Show class thresholds : Detail threshold information : Show console message level : Show port persistence time : Quit Select an item =>...
  • Page 297 Note: Enter commands in lowercase only; mixed case is for readability. fwShow switch:user> fwshow : Show class thresholds : Detail threshold information : Show console message level : Show port persistence time : Quit Select an item => : (1..3) [3] 2 Enter Threshold Name : [] envFan001 Env Temperature 1: Monitored for:...
  • Page 298 Note: Enter commands in lowercase only; mixed case is for readability. Displays shell history. Synopsis history Description Use this command to view the shell history. The shell history mechanism is similar to the UNIX Korn shell history facility. It has a built-in line editor similar to UNIX vi that enables previously typed commands to be edited.

  • Page 299: Hadisable

    Note: Enter commands in lowercase only; mixed case is for readability. haDisable haDisable Disables the High Availability feature in the switch. Synopsis hadisable Description Use this command to disable the High Availability feature in the switch. If the HA feature is already disabled, this command does nothing.

  • Page 300: Hadump

    Note: Enter commands in lowercase only; mixed case is for readability. haDump haDump Displays information about the status of the High Availability feature in the switch. Synopsis hadump Description Use this command to display information about the status of the High Availability feature in the switch. This command displays the following information: •...
  • Page 301 Note: Enter commands in lowercase only; mixed case is for readability. haDump Examples To view information about the High Availability feature status: switch:admin> hadump hashow: Local CP (Slot 6, CP1): Active, Cold Recovered Remote CP (Slot 5, CP0): Non-Redundant ipaddrshow: SWITCH Ethernet IP Address: 10.33.54.251 Ethernet Subnetmask: 255.255.240.0...

  • Page 302: Haenable

    Note: Enter commands in lowercase only; mixed case is for readability. haEnable haEnable Enables the High Availability feature in the switch. Synopsis haenable Description Use this command to enable the High Availability feature in the switch. If the HA feature is already enabled, this command does nothing.

  • Page 303: Hafailover

    Note: Enter commands in lowercase only; mixed case is for readability. haFailover haFailover Forces the failover mechanism so that the standby control processor (CP) becomes the active CP. Synopsis hafailover Description Use this command to force the failover mechanism to occur so that the standby CP becomes the active CP.

  • Page 304: Hashow

    Note: Enter commands in lowercase only; mixed case is for readability. haShow haShow Displays control processor (CP) status. Synopsis hashow Description Use this command to display control processor status, which includes: • Local CP state (slot number and CP ID), warm or cold, recovering or recovered •...
  • Page 305 Note: Enter commands in lowercase only; mixed case is for readability. haShow Examples To display CP status, first on a healthy standby CP and then on a faulty standby CP: switch:admin> hashow Local CP (Slot 6, CP1): Active, Cold Recovered Remote CP (Slot 5, CP0): Non-Redundant switch:admin>...

  • Page 306: Hasyncstart

    Note: Enter commands in lowercase only; mixed case is for readability. haSyncStart haSyncStart Enables HA state synchronization. Synopsis hasyncstart Description Use this command to enable the HA state synchronization. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Examples To enable the HA state synchronization: switch:admin>...

  • Page 307: Hasyncstop

    Note: Enter commands in lowercase only; mixed case is for readability. haSyncStop haSyncStop Disables the HA state synchronization. Synopsis hasyncstop Description Use this command to temporarily disable the HA synchronization .The next failover that takes place after might be disruptive. Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 308: Help

    Note: Enter commands in lowercase only; mixed case is for readability. help help Displays help information for commands. Synopsis help [command] Description Use this command without an operand to display an alphabetical list commands for which help is available. At the end of the list are some additional commands which display more lists of grouped commands for a particular subsystem;...

  • Page 309: Historylastshow

    Note: Enter commands in lowercase only; mixed case is for readability. historyLastShow historyLastShow Displays the latest entry in the field replaceable unit (FRU) history log. Synopsis historylastshow Description Use this command to display the contents of the latest history log, which records insertion and removal events for blades, power supplies, fans, and World Wide Cards.

  • Page 310: Historymode

    Note: Enter commands in lowercase only; mixed case is for readability. historyMode historyMode Displays the mode of the Field Replaceable Unit (FRU) history log. Synopsis historymode[mode] Description Use this command to display the mode of the history buffer: Rotating mode New messages overwrite the oldest messages in the log.

  • Page 311: Historyshow

    Note: Enter commands in lowercase only; mixed case is for readability. historyShow historyShow Displays the entire field replaceable unit (FRU) history log. Synopsis historyshow Description Use this command to display the entire history log, which records insertion and removal events for blades, power supplies, fans, and World Wide Name (WWN) cards.
  • Page 312 Note: Enter commands in lowercase only; mixed case is for readability. historyShow Examples To display the history log of FRUs and removal events: switch:admin> historyshow Unit 3 Removed at Tue Aug 14 10:05:37 1970 Factory Part Number: 20-123456-12 Factory Serial Number: 1013456800 POWER SUPPLY Unit 1...

  • Page 313: Httpcfgshow

    Note: Enter commands in lowercase only; mixed case is for readability. httpCfgShow httpCfgShow Displays the Java plug-in version. Synopsis httpcfgshow Description Use this command to display the version of the Java plug-in supported by Web Tools. This command also displays the URL from which the plug-in can be downloaded. Note The execution of this command is subject to Admin Domain restrictions that may be in place.
  • Page 314 Note: Enter commands in lowercase only; mixed case is for readability. Displays a process summary. Synopsis i [processID] Description Use this command to display information about all of the processes or about a specific process if a process ID is supplied. One line is displayed per process. Fields displayed with this commands include those shown in the table.
  • Page 315 Note: Enter commands in lowercase only; mixed case is for readability. Table 2-13 i Command Field Description (Continued) Field Description WCHAN The address of an event for which process is sleeping (if blank, process is running) The controlling terminal of the process (? displayed for no controlling terminal) TIME The cumulative execution time for the process...

  • Page 316: Ifmodeset

    Note: Enter commands in lowercase only; mixed case is for readability. ifModeSet ifModeSet Sets the link operating mode for a network interface. Synopsis ifmodeset ["interface"] Description Use this command to set the link operating mode for a network interface. An operating mode is confirmed with a y or yes at the prompt. If the operating mode selected differs from the current mode, the change is saved and the command exits.
  • Page 317 Note: Enter commands in lowercase only; mixed case is for readability. ifModeSet Examples To advertise all modes of operation, when not entering this command through the serial console port, follow this scenario for the ifModeSet command: switch:admin> ifmodeset eth0 Exercise care when using this command. Forcing the link to an operating mode not supported by the network equipment to which it is attached may result in an inability to...

  • Page 318: Ifmodeshow

    Note: Enter commands in lowercase only; mixed case is for readability. ifModeShow ifModeShow Displays the link operating mode and MAC address for a network interface. Synopsis ifmodeshow interface Description Use this command to display the link operating mode and MAC address for a network interface. Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 319: Interfaceshow

    Note: Enter commands in lowercase only; mixed case is for readability. interfaceShow interfaceShow Displays FSPF interface information. Synopsis interfaceshow [slotnumber/][portnumber] Description Use this command to display the two data structures associated with FSPF interfaces (E_Ports) on the switch: • The permanently allocated Interface Descriptor Block (IDB). •...
  • Page 320 Note: Enter commands in lowercase only; mixed case is for readability. interfaceShow nflags Internal FSPF flags. initCount Number of times this neighbor was initialized without the interface going down. lastInit Time the last initializing state, NB_ST_INIT, on this interface. firstHlo Time the first hello sent on this interface.
  • Page 321 Note: Enter commands in lowercase only; mixed case is for readability. interfaceShow Operands This command has the following operands: slotnumber For bladed systems only, specify the slot number of the port to display, followed by a slash (/). portnumber Specify the port number to display, relative to its slot for bladed systems. Use switchShow to list valid ports.
  • Page 322 Note: Enter commands in lowercase only; mixed case is for readability. interfaceShow nCmdAcc nInvCmd nHloIn nInvHlo nLsuIn nLsaIn attHloOut nHloOut attLsuOut nLsuOut attLsaOut nLsaOut See Also nbrStateShow, portShow, switchShow 2-288 Fabric OS Command Reference Manual Publication Number: 53-1000240-01...

  • Page 323: Interopmode

    Note: Enter commands in lowercase only; mixed case is for readability. interopMode interopMode Enables or disables Brocade switch interoperability with switches from other manufacturers. Synopsis interopmode [mode] Description Use this command to enable or disable interoperability mode for individual Brocade switches. This feature enables other manufacturers’...
  • Page 324 Note: Enter commands in lowercase only; mixed case is for readability. interopMode Examples To enable interoperability mode: switch:admin> interopmode 1 Please make sure the MS Platform service is disabled. Please run "msPlMgmtDeactivate" command to disable the Platform service. The switch effective configuration will be lost when the operating mode is changed;...
  • Page 325 Note: Enter commands in lowercase only; mixed case is for readability. interopMode the Brocade fabric; ports 8/2, 8/3 show the connections to a McDATA fabric): b48000_194:root> switchshow switchName:b48000_194 switchType:42.2 switchState:Online switchMode:Native switchRole:Principal switchDomain:4 switchId:fffc04 switchWwn:10:00:00:60:69:e4:00:88 zoning: ON (cfg80) switchBeacon:OFF blade1 Beacon: blade2 Beacon: blade4 Beacon: blade8 Beacon:...

  • Page 326: Iodreset

    Note: Enter commands in lowercase only; mixed case is for readability. iodReset iodReset Turns off the in-order delivery (IOD) option. Synopsis iodreset Description Use this command to turn off the IOD option. The IOD option is turned off by default; however, if the IOD option was turned on using iodSet, this command can be used to turn it off again.

  • Page 327: Iodset

    Note: Enter commands in lowercase only; mixed case is for readability. iodSet iodSet Enables the in-order delivery (IOD) option. Synopsis iodset Description Use this command to enforce in-order delivery of frames during a fabric topology change. In a stable fabric, frames are always delivered in order, even when the traffic between switches is shared among multiple paths.

  • Page 328: Iodshow

    Note: Enter commands in lowercase only; mixed case is for readability. iodShow iodShow Displays the state of the in-order delivery (IOD) option setting. Synopsis iodshow Description Use this command to display whether the IOD option is enabled or disabled. Operands none Examples To display the current setting of the IOD option:...

  • Page 329: Ipaddrset

    Note: Enter commands in lowercase only; mixed case is for readability. ipAddrSet ipAddrSet Sets the IP address details for a switch or control processor (CP). Synopsis ipaddrset [-cp number][-sw number] Description Use this command to set the IP addresses on the switch or CP. The command’s usage varies depending on whether it is being used on a chassis-based system or nonchassis-based switch.
  • Page 330 Note: Enter commands in lowercase only; mixed case is for readability. ipAddrSet Examples To set the IP address details for switch number 1 on a chassis-based system: switch:admin> ipaddrset -sw 1 Ethernet IP Address [192.168.166.148]: Ethernet Subnetmask [255.255.255.0]: Fibre Channel IP Address [none]: Fibre Channel Subnetmask [none]: Committing configuration...Done.

  • Page 331: Ipaddrshow

    Note: Enter commands in lowercase only; mixed case is for readability. ipAddrShow ipAddrShow Displays the IP address information for a switch or control processor (CP). Synopsis ipaddrshow [-cp cp_number] | [-sw sw_number] Description Use this command to display the IP addresses configured in the system. The -cp option displays the CP IP address and the -sw option displays the switch IP addresses.

  • Page 332: Iscsicfg

    Note: Enter commands in lowercase only; mixed case is for readability. iscsiCfg iscsiCfg Configures or displays iSCSI entities. Synopsis iscsicfg --create auth -u username -s CHAP_secret [-h] iscsicfg --modify auth -u username -s CHAP_secret [-h] iscsicfg --delete auth -u username [-h ] iscsicfg --clear auth [-h ] iscsicfg --show auth [-u username ] [-h] iscsicfg --easycreate tgt [-w port_wwn] [-h ]...
  • Page 333 Note: Enter commands in lowercase only; mixed case is for readability. iscsiCfg Description Use this command to configure all iSCSI entities (such as authentication (CHAP), discovery domains (DD), discovery domain sets (DDSet), iSCSI virtual targets (VT), and LUN maps). Common actions include --add, --delete, --modify, --show, --enable and --disable;...
  • Page 334 Note: Enter commands in lowercase only; mixed case is for readability. iscsiCfg Deletes a target entry with the specified target_name. • --clear tgt [-h ] Clears the iSCSI target database from the fabric. • --show tgt [-t target_name] [-v ] [-h ] Displays the iSCSI target database entries for target_name.
  • Page 335 Note: Enter commands in lowercase only; mixed case is for readability. iscsiCfg • --disable ddset [-n ddset_name] [-h ] Disables an active DD set. • --add ddset -n ddset_name -d dd_list [-h ] Adds a new DD to an existing DD set. •...
  • Page 336 Note: Enter commands in lowercase only; mixed case is for readability. iscsiCfg To display the authentication database switch:admin> iscsicfg --show auth Number of records found: 1 Name Status user1 Defined To delete a CHAP entry: switch:admin> iscsicfg --delete auth -u user1 The operation completed successfully.
  • Page 337 Note: Enter commands in lowercase only; mixed case is for readability. iscsiCfg To add a LUN map: switch:admin> iscsicfg --add lun -t iqn.2005-10.com.brocade.tgt1 -w 22:00:00:04:cf:20:5d:33 -l 0:0 The operation completed successfully. switch:admin> iscsicfg --add lun -t iqn.2005-12.com.brocade.tgt2 -w 22:00:00:04:cf:75:5b:9a -l 2-5:5-8 The operation completed successfully.
  • Page 338 Note: Enter commands in lowercase only; mixed case is for readability. iscsiCfg To add a new member to an existing DD set (the new DD, iscsidd3, must exist already) switch:admin> iscsicfg --add ddset -n myddset -d iscsidd3 The operation completed successfully. To enable a DD set: switch:admin>...
  • Page 339 Note: Enter commands in lowercase only; mixed case is for readability. iscsiCfg To display the iSCSI initiators that attempted to login: switch:admin> iscsicfg --show initiator Number of records found: 1 Name IP Address iqn.1991-05.com.brocade:initiator1 172.16.14.101 switch:admin> iscsicfg --show initiator -i iqn.1991-05.com.brocade:initiator1 Initiator details are: Name IP Address...

  • Page 340: Iscsichiptest

    Note: Enter commands in lowercase only; mixed case is for readability. iscsiChipTest iscsiChipTest Performs functional test of components in iSCSI complex. Synopsis iscsichiptest --slot slotnumber -testtype type -unit gbeports Description Use this command to verify the memory of the network processor and iFlipper FPGA. Operands This command has the following operands: --slot slotnumber...

  • Page 341: Iscsihelp

    Note: Enter commands in lowercase only; mixed case is for readability. iscsiHelp iscsiHelp Displays a list of iSCSI support commands. Synopsis iscsihelp Description Use this command to display a list of iSCSI support commands, with descriptions. Operands none Examples To display the list of iSCSI support commands: switch:admin>...

  • Page 342: Iscsipathtest

    Note: Enter commands in lowercase only; mixed case is for readability. iscsiPathTest iscsiPathTest Performs functional test of components in iSCSI complex. Synopsis iscsipathtest --slot slotnumber -unit number -path mode -nframes count Description Use this command to verify the functions of the network processor and the iSCSIcomplex. All data path modes (as described in the -path operand filed below) run test by comparing the FC frames or data packets transmitted from and received by the BCM1125H network processor due to the designated loopback points.

  • Page 343: Iscsiportcfg

    Note: Enter commands in lowercase only; mixed case is for readability. iscsiPortCfg iscsiPortCfg Displays or modifies iSCSI port parameters. Synopsis iscsiportcfg --clearstats slot/geport iscsiportcfg --default slot/geport iscsiportcfg --show slot/geport [-v] iscsiportcfg --modify slot/geport options Description Use this command to display or modify the iSCSI port parameters. The following table lists the default iSCSI port settings.
  • Page 344 Note: Enter commands in lowercase only; mixed case is for readability. iscsiPortCfg --show Displays port-level protocol parameters, statistics, and session information on the specified port. Options include: • Specifies verbose mode, which displays the initiator IP, TSID, and the number of connections in addition to the other port-level information. •...
  • Page 345 Note: Enter commands in lowercase only; mixed case is for readability. iscsiPortCfg To display the port information in verbose mode: switch:admin> iscsiportcfg --show 7/ge0 The configured port parameters for slot 7 and port ge0 are: Header Digest: Data Digest: First Burst Length: Error Recovery Level: Immediate Data: Connections per session:...

  • Page 346: Iscsisessioncfg

    Note: Enter commands in lowercase only; mixed case is for readability. iscsiSessionCfg iscsiSessionCfg Displays iSCSI session/connection details, clears the associated counters, or deletes an iSCSI session/ connection. Synopsis iscsisessioncfg --clearstats [-i initiator_iqn] [-t target_iqn] iscsisessioncfg --delete [-i initiator_iqn] [-t target_iqn] iscsisessioncfg --show [-i initiator_iqn] [-t target_iqn] Description Use this command to display iSCSI session/connection details, clear the associated counters, or delete...
  • Page 347 Note: Enter commands in lowercase only; mixed case is for readability. iscsiSessionCfg Examples To display the iSCSI session status: switch:admin> iscsisessioncfg --show Number of sessions found: Session 1 Details: Initiator Name: iqn.1991-05.com.init:6a3-iscsi-053.englab.brocade.com Target Name: iqn.2002-12.com.brocade:2f:df:00:06:2b:0d:10:b9 Session type Init. Session ID Tgt.
  • Page 348 Note: Enter commands in lowercase only; mixed case is for readability. iscsiSessionCfg (continued from previous page) iSCSI Connection Statistics iSCSI in PDU: 23100 iSCSI in Octet: 855685264 iSCSI out PDU: 851487 iSCSI out Octet: 882055140 FCP in PDU: 431295 FCP in Octet: 878756240 FCP out PDU: 425006...

  • Page 349: Iscsitargetname

    Note: Enter commands in lowercase only; mixed case is for readability. iscsiTargetName iscsiTargetName Displays or modifies the IQN prefix of iSCSI target names. Synopsis iscsitargetname --show iscsitargetname --modify -t target_name Description Use this command to display or modify the IQN prefix of iSCSI target names. The default prefix is iqn.2002-12.com.brocade.

  • Page 350: Islshow

    Note: Enter commands in lowercase only; mixed case is for readability. islShow islShow Displays ISL information. Synopsis islshow Description Use this command to display the current connections and status of the ISL of each port on this switch. The node WWN, domain ID, and switch name to which the ISL is connected, the speed and bandwidth of the connection, and whether this ISL is trunked are displayed.

  • Page 351: Isnsccfg

    Note: Enter commands in lowercase only; mixed case is for readability. isnscCfg isnscCfg iSNS Client Configure. Synopsis isnsccfg --set slot/geport -s server_ip isnsccfg --set -m -s server_ip isnsccfg --reregister isnsccfg --show Description Use this command to display and update the configuration state of the iSNS client daemon. Note The execution of this command is subject to Admin Domain restrictions that may be in place.
  • Page 352 Note: Enter commands in lowercase only; mixed case is for readability. isnscCfg To trigger a re-registration of iSNS ojects: switch:admin> isnsccfg --reregister Initiated re-register of iSNS objects with iSNS server See Also none 2-318 Fabric OS Command Reference Manual Publication Number: 53-1000240-01...

  • Page 353: Itemlist

    Note: Enter commands in lowercase only; mixed case is for readability. itemList itemList Lists parameter syntax information. Synopsis item_list = element | element white item_list element = item | item - item item = num | slot [white]/ [white] num slot = num num = hex | int int = int digit | digit...
  • Page 354 Note: Enter commands in lowercase only; mixed case is for readability. itemList blade ports and user ports. A list of blade ports is most commonly used by ASIC-level tests such as cmiTest turboRamTest and represents which ports on the current blade (specified with --slot number) are tested.

  • Page 355: Killtelnet

    Note: Enter commands in lowercase only; mixed case is for readability. killTelnet killTelnet Terminates an open telnet session. Synopsis killtelnet Description Use this command to terminate an open telnet session. The killTelnet command is an interactive menu- driven command. Upon invocation, it lists all the current telnet and serial port login sessions. It lists information such as the session number, login name, idle time, IP address of the connection, and timestamp of when the login session was opened.
  • Page 356 Note: Enter commands in lowercase only; mixed case is for readability. killTelnet See Also none 2-322 Fabric OS Command Reference Manual Publication Number: 53-1000240-01...

  • Page 357: Licenseadd

    Note: Enter commands in lowercase only; mixed case is for readability. licenseAdd licenseAdd Adds license keys to switch. Synopsis licenseadd "license" Description Use this command to add license keys to the switch. Some features of the switch and the fabric to which it is connected are optional, licensed products. Without a license installed for such products, their services are not available.

  • Page 358: Licensehelp

    Note: Enter commands in lowercase only; mixed case is for readability. licenseHelp licenseHelp Displays commands used to administer license keys. Synopsis licensehelp Description Use this command to display a list of the commands used to administer license keys. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 359: Licenseidshow

    Note: Enter commands in lowercase only; mixed case is for readability. licenseIdShow licenseIdShow Displays system license ID. Synopsis licenseidshow Description Use this command to display the license ID of the system. Some features of the switch and the fabric are optional, licensed products. Without a license installed for such products, the services provided by these features are not available.

  • Page 360: Licenseremove

    Note: Enter commands in lowercase only; mixed case is for readability. licenseRemove licenseRemove Removes the license key from the system. Synopsis licenseremove "license" Description Use this command to remove an existing license key from a switch. The existing license key must be entered exactly as shown by licenseShow, including case.

  • Page 361: Licenseshow

    Note: Enter commands in lowercase only; mixed case is for readability. licenseShow licenseShow Displays current license keys. Synopsis licenseshow Description Use this command to display current license keys, along with a list of licensed products enabled by these keys. The message "No license installed on this switch" is displayed when no licenses are installed. Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 362: Linkcost

    Note: Enter commands in lowercase only; mixed case is for readability. linkCost linkCost Sets or displays the Fabric Shortest Path First (FSPF) cost of a link. Synopsis linkcost [[slotnumber/][portnumber] [cost]] Description Use this command to set or display the cost of an interswitch link (ISL). The cost of a link is a dimensionless positive number.
  • Page 363 Note: Enter commands in lowercase only; mixed case is for readability. linkCost Operands This command has the following operands: slotnumber For bladed systems only, specify the slot number of the port to display, followed by a slash (/). portnumber Specify the port number to display, relative to its slot for bladed systems. Use switchShow to list valid ports.

  • Page 364: Login

    Note: Enter commands in lowercase only; mixed case is for readability. login login Logs in as new user. Synopsis login Description Use this command to log in to the switch with another user name and password, without first logging out from the original session.

  • Page 365: Logout

    Note: Enter commands in lowercase only; mixed case is for readability. logout logout Logs out from a shell session. Synopsis logout Description Use this command to log out from a shell session. Remote login connections are closed and the local serial connections return to the login prompt.

  • Page 366: Loopporttest

    Note: Enter commands in lowercase only; mixed case is for readability. loopPortTest loopPortTest Functional test of L_Port M->M path on a loop. Synopsis loopporttest [-nframes count][-ports itemlist][-seed payload_pattern][-width pattern_width] Description Use this command to verify the operation of the switch by sending frames from port M's transmitter and looping the frames back through an external fiber cable, including all the devices on the loop, into port M's receiver.
  • Page 367 Note: Enter commands in lowercase only; mixed case is for readability. loopPortTest -nframes count Specify the number of times (or number of frames per port) to execute this test. The default value is 10. The maximum value is 2,147,483,647, which is (2 ^ 31 - 1).

  • Page 368: Lsanzoneshow

    Note: Enter commands in lowercase only; mixed case is for readability. lsanZoneShow lsanZoneShow Displays logical SAN zone information. Synopsis lsanzoneshow [-s] [-f fabricid] [-w wwn] [-z zonename] Description Use this command to display the interfabric zones or LSAN zones. These zones are normal WWN zones created in FC Router EX_Port-connected fabrics and backbone fabrics.
  • Page 369 Note: Enter commands in lowercase only; mixed case is for readability. lsanZoneShow Examples To display the LSAN zones: switch:admin> lsanzoneshow Fabric ID: 4 Zone Name: lsan_fcr10_0 50:05:07:65:05:84:0b:83 50:05:07:65:05:84:09:0e 10:00:00:00:c9:2b:6a:68 21:00:00:20:37:18:22:55 Fabric ID: 5 Zone Name: lsan_fcr11_0 10:00:00:00:c9:2b:6a:68 21:00:00:20:37:18:22:55 50:05:07:65:05:84:0b:83 50:05:07:65:05:84:09:0e switch# See Also fcrFabricShow, fcrPhyDevShow, fcrProxyDevShow, fcrRouteShow,...

  • Page 370: Lsdbshow

    Note: Enter commands in lowercase only; mixed case is for readability. lsDbShow lsDbShow Displays the Fabric Shortest Path First (FSPF) link state database. Synopsis lsdbshow [domain] Description Use this command to display an FSPF link state database record for switches in the fabric, or one domain within it.
  • Page 371 Note: Enter commands in lowercase only; mixed case is for readability. lsDbShow Table 2-16 lsDbShow Display Fields (Continued) Field Description options Always 0. lsId ID of this LSR. It is identical to the domain number. advertiser ID (domain number) of the switch that originated this LSR. incarn Incarnation number of this LSR.
  • Page 372 Note: Enter commands in lowercase only; mixed case is for readability. lsDbShow Examples To display the link state record for a switch: switch:admin> lsdbshow 1 Domain = 1 (self), Link State Database Entry pointer = 0x1004d430 lsrP = 0x10053d18 earlyAccLSRs ignoredLSRs lastIgnored = Never...

  • Page 373: Memshow

    Note: Enter commands in lowercase only; mixed case is for readability. memShow memShow Displays the amounts of free and used memory in a switch. Synopsis memshow [-b | -k | -m] Description Use this command to display free and used memory in the switch, as well as the shared memory and buffers used by the kernel.

  • Page 374: Minicycle

    Note: Enter commands in lowercase only; mixed case is for readability. miniCycle miniCycle Runs a functional test of internal and external transmit and receive paths at full speed. Synopsis minicycle [--slot slotnumber][-nmegs count][-lb_mode mode][-spd_mode mode][-ports itemlist] Description Use this command to verify the intended functional operation of an ASIC pair (miniswitch) at the maximum or selected speed by setting up the routing hardware so that frames received by port M are retransmitted by way of port N.
  • Page 375 Note: Enter commands in lowercase only; mixed case is for readability. miniCycle • 200 bytes of RANDOM Periodically check status: Each port has not died. Each port's frames-transmitted counter is still incrementing. Each port's statistic error counters are nonzero: ENC_in, CRC_err, TruncFrm, FrmTooLong, BadEOF, Enc_out, BadOrdSet, DiscC3 Until one of the following is met: •...
  • Page 376 Note: Enter commands in lowercase only; mixed case is for readability. miniCycle The exact operation of modes 5 through 8 depends on the loopback mode selected. When speed modes 5 through 8 are used with cables, they must be connected EVEN->ODD or the test fails.
  • Page 377 Note: Enter commands in lowercase only; mixed case is for readability. miniCycle To run a functional test on ports 0, 1, 2, and 8 using port loopback: switch:admin> minicycle -ports 0,1,2,8 -lb_mode 1 Back Plane Loop Back mode is ON. Running mini Cycle .....
  • Page 378 Note: Enter commands in lowercase only; mixed case is for readability. miniCycle Refer to the Fabric OS Message Reference for more information. See Also backport, camTest, centralMemoryTest, cmemRetentionTest, cmiTest, crossPortTest, itemList, portLoopbackTest, portRegTest, spinSilk, sramRetentionTest 2-344 Fabric OS Command Reference Manual Publication Number: 53-1000240-01...

  • Page 379: Minispropshow

    Note: Enter commands in lowercase only; mixed case is for readability. minisPropShow minisPropShow Displays ASIC pair properties. Synopsis minispropshow [slotnumber/]asicpair | [--slot slotnumber] -all Description Use this command to display the ASIC pair properties. Note This command is not intended for normal user operation and is available to provide supplemental information during system debug.

  • Page 380: Mscapabilityshow

    Note: Enter commands in lowercase only; mixed case is for readability. msCapabilityShow msCapabilityShow Displays the Management Server (MS) capabilities. Synopsis mscapabilityshow Description Use this command to display the supported capabilities of the Management Server for each switch in the fabric. An asterisk displays next to the name of the local switch. Note Reliable commit service (RCS) is a fabric-wide capability and is supported only if all the switches in the fabric support RCS.

  • Page 381: Msconfigure

    Note: Enter commands in lowercase only; mixed case is for readability. msConfigure msConfigure Configures the Management Server (MS) access control list (ACL). Synopsis msconfigure Description Use this command to configure the MS ACL. MS allows a SAN management application to retrieve and administer the fabric and interconnect elements, such as switches.
  • Page 382 Note: Enter commands in lowercase only; mixed case is for readability. msConfigure Examples To display the MS ACL: switch:admin> msconfigure Done Display the access list Add member based on its Port/Node WWN Delete member based on its Port/Node WWN select : (0..3) [1] 1 MS Access List consists of (5): { 20:01:00:60:69:00:60:10 20:02:00:60:69:00:60:10...

  • Page 383: Msplatshow

    Note: Enter commands in lowercase only; mixed case is for readability. msPlatShow msPlatShow Displays the Management Server (MS) platform database. Synopsis msplatshow Description Use this command to display information from the MS platform database. This command displays the name of each platform object with the platform type (GATEWAY, HOST_BUS_ADAPTER, and so forth), associated management addresses, and associated node names.

  • Page 384: Msplatshowdbcb

    Note: Enter commands in lowercase only; mixed case is for readability. msPlatShowDBCB msPlatShowDBCB Displays the Management Server (MS) platform service database control block. Synopsis msplatshowdbcb Description Use this command to display the control block fields associated with the platform database. Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 385: Msplcleardb

    Note: Enter commands in lowercase only; mixed case is for readability. msPlClearDB msPlClearDB Clears the Management Server (MS) platform database on all switches in the fabric. Synopsis msplcleardb Description Use this command to clear the MS platform database on all switches in the fabric. Because this operation is nonrecoverable, it should not be used unless it is intended to resolve a database conflict between two joining fabrics or to establish an entirely new fabric with an empty database.

  • Page 386: Msplmgmtactivate

    Note: Enter commands in lowercase only; mixed case is for readability. msPlMgmtActivate msPlMgmtActivate Activates the Management Server (MS) platform service. Synopsis msplmgmtactivate Description Use this command to activate the MS platform service in the entire fabric. This command attempts to activate the MS platform service for each switch in the fabric.

  • Page 387: Msplmgmtdeactivate

    Note: Enter commands in lowercase only; mixed case is for readability. msPlMgmtDeactivate msPlMgmtDeactivate Deactivates the Management Server (MS) platform service. Synopsis msplmgmtdeactivate Description Use this command to deactivate the MS platform service in the entire fabric. This command deactivates the MS platform service for each switch in the fabric and commits the change to nonvolatile storage. Note When security is enabled, this command can be issued only from the primary FCS switch.

  • Page 388: Mstddisable

    Note: Enter commands in lowercase only; mixed case is for readability. msTdDisable msTdDisable Disables the Management Server (MS) topology discovery service. Synopsis mstddisable ["ALL"] Description Use this command to disable the management server topology discovery service of a local switch or an entire fabric.

  • Page 389: Mstdenable

    Note: Enter commands in lowercase only; mixed case is for readability. msTdEnable msTdEnable Enables the Management Server (MS) topology discovery service. Synopsis mstdenable ["ALL"] Description Use this command to enable the MS topology discovery service on a local switch or on the entire fabric. This command enables the MS Topology Discovery Service.

  • Page 390: Mstdreadconfig

    Note: Enter commands in lowercase only; mixed case is for readability. msTdReadConfig msTdReadConfig Displays the status of Management Server (MS) topology discovery service. Synopsis mstdreadconfig Description Use this command to check whether or not the management server topology discovery service is enabled. Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 391: Myid

    Note: Enter commands in lowercase only; mixed case is for readability. myId myId Displays the current login session details. Synopsis myid Description Use this command to display the status of the system and the login session details. The login session gives details of the following: •...

  • Page 392: Nbrstateshow

    Note: Enter commands in lowercase only; mixed case is for readability. nbrStateShow nbrStateShow Displays FSPF neighbor's state. Synopsis nbrstateshow [slotnumber/][portnumber] Description Use this command to display information about neighbors to the local switch, or information about a specific neighbor if a port number is supplied. FSPF defines a neighbor as a remote E_Port interface that is directly attached to the local switch.

  • Page 393: Nbrstatsclear

    Note: Enter commands in lowercase only; mixed case is for readability. nbrStatsClear nbrStatsClear Resets FSPF interface counters. Synopsis nbrstatsclear [slotnumber/][portnumber] Description Use this command to reset the counters of FSPF frames transmitted and received on each interswitch link (ISL) or a specific ISL. These counters display using the using the interfaceShow command.
  • Page 394 Note: Enter commands in lowercase only; mixed case is for readability. nbrStatsClear Examples To reset the counters on a port: switch:admin> interfaceshow 1/0 idbP = 0x10050a38 Interface 0 data structure: nghbP = 0x1004ce68 ifNo masterPort = 0 (self) defaultCost = 500 cost = 500 delay...

  • Page 395: Nodefind

    Note: Enter commands in lowercase only; mixed case is for readability. nodeFind nodeFind Displays all the device Name Server (NS) entries matching a given WWN, device PID, or alias. Synopsis nodefind "WWN | PID | ALIAS" Description Use this command to display the NS information for all the devices in the fabric that have either a port World Wide Name (WWN) or a node WWN matching with the given WWN;...
  • Page 396 Note: Enter commands in lowercase only; mixed case is for readability. nodeFind Examples To display all the device information matching the alias “a320”: Local: Type Pid PortName NodeName 0314d9; 3;22:00:00:04:cf:5d:dc:2d;20:00:00:04:cf:5d:dc:2d; 0 FC4s: FCP [SEAGATE ST318452FC 0001] Fabric Port Name: 20:14:00:60:69:80:04:79 Permanent Port Name: 22:00:00:04:cf:5d:dc:2d Device type: Physical Target Port Index: 20...
  • Page 397 Note: Enter commands in lowercase only; mixed case is for readability. nodeFind To display all the device information matching the PID "0x020eef": switch:user> nodefind 0x020eef Remote: Type Pid PortName NodeName 020eef; 3;20:00:00:e0:8b:01:ce:d3;20:00:00:e0:8b:01:ce:d3; Fabric Port Name: 20:0e:00:60:69:51:0b:ba Permanent Port Name: 20:00:00:e0:8b:01:ce:d3 Device type: Physical Target Port Index: 14 Share Area: No...

  • Page 398: Nsaliasshow

    Note: Enter commands in lowercase only; mixed case is for readability. nsAliasShow nsAliasShow Displays local Name Server (NS) information, with aliases. Synopsis nsaliasshow [-r -t] Description Use this command to display local name server information with the added feature of displaying the defined configuration aliases to which the device belongs.
  • Page 399 Note: Enter commands in lowercase only; mixed case is for readability. nsAliasShow Both an SCSI initiator and an SCSI target Examples To display local NS information with aliases: switch:admin> nsaliasshow Type Pid PortName NodeName TTL(sec) 021200; 2,3;10:00:00:60:69:00:03:19;30:00:00:60:69:00:03:19; na FC4s: FCIP Fabric Port Name: 20:02:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:03:19 Aliases:...
  • Page 400 Note: Enter commands in lowercase only; mixed case is for readability. nsAliasShow To display local NS information with aliases with the -r option: switch:admin> nsaliasshow -r Type Pid PortName NodeName 021200; 2,3;10:00:00:60:69:00:03:19;30:00:00:60:69:00:03:19; 3 FC4s: FCIP Fabric Port Name: 20:02:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:03:19 Aliases: 021300;...
  • Page 401 Note: Enter commands in lowercase only; mixed case is for readability. nsAliasShow To display local NS information with aliases with the -r and -t options: switch:admin> nsaliasshow -r -t Type Pid PortName NodeName 021200; 2,3;10:00:00:60:69:00:03:19;30:00:00:60:69:00:03:19; 3 FC4s: FCIP Fabric Port Name: 20:02:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:03:19 Device type: Physical Unknown(initiator/target) Aliases:...

  • Page 402: Nsallshow

    Note: Enter commands in lowercase only; mixed case is for readability. nsAllShow nsAllShow Displays global name server information. Synopsis nsallshow [type] Description Use this command to display the 24-bit Fibre Channel addresses of all devices in all switches in the fabric.

  • Page 403: Nscamshow

    Note: Enter commands in lowercase only; mixed case is for readability. nscamShow nscamShow Displays information about remote devices in the Name Server (NS) cache. Synopsis nscamshow [-t] Description Use this command to display the local NS cache information about the devices discovered in the fabric by the NS cache manager.
  • Page 404 Note: Enter commands in lowercase only; mixed case is for readability. nscamShow Examples To display all switch and device entries discovered by the NS in the fabric: switch:admin> nscamshow nscam show for remote switches: Switch entry for 2 state owner known v430 0xfffc01...

  • Page 405: Nsshow

    Note: Enter commands in lowercase only; mixed case is for readability. nsShow nsShow Displays local Name Server (NS) information. Synopsis nsshow [-r -t] Description Use this command to display local NS information about devices connected to this switch. The following message is displayed if there is no information in this switch: There is no entry in the Local Name Server nsAllShow command displays information from all switches.
  • Page 406 Note: Enter commands in lowercase only; mixed case is for readability. nsShow Operands This command has the following operands: Replaces the TTL attribute output with SCR (state change registration) information in the display. This value indicates what type of RSCN a device registers to receive.
  • Page 407 Note: Enter commands in lowercase only; mixed case is for readability. nsShow Examples To display local NS information: switch:admin> nsshow Type Pid PortName NodeName TTL(sec) 021200; 2,3;10:00:00:60:69:00:03:19;30:00:00:60:69:00:03:19; na FC4s: FCIP Fabric Port Name: 20:02:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:03:19 021300; 3;10:00:00:60:69:00:02:d6;20:00:00:60:69:00:02:d6; na Fabric Port Name: 20:03:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:02:d6 0214e2;...
  • Page 408 Note: Enter commands in lowercase only; mixed case is for readability. nsShow To display local NS information with -r and -t: switch:admin> nsshow -r -t Type Pid PortName NodeName 021200; 2,3;10:00:00:60:69:00:03:19;30:00:00:60:69:00:03:19; 3 FC4s: FCIP Fabric Port Name: 20:02:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:03:19 Device type: Physical Unknown(initiator/target) 021300;...

  • Page 409: Nszonemember

    Note: Enter commands in lowercase only; mixed case is for readability. nsZoneMember nsZoneMember Displays the information of all the online devices zoned with the given device. Synopsis nszonemember -a | -u | pid | wwn Description Use this command to display information about all the online devices zoned with the given device. Issuing this command without operands displays all online devices zoned with the given device.
  • Page 410 Note: Enter commands in lowercase only; mixed case is for readability. nsZoneMember Examples To display information about all the online devices zoned with the given device: switch:admin> nszonemember 0x0416e2 3 local zoned members: Type Pid PortName NodeName 041901; 2,3;10:00:00:00:c9:26:0e:ae;20:00:00:00:c9:26:0e:ae; 3 Fabric Port Name: 20:09:00:60:69:50:06:78 Permanent Port Name: 10:00:00:00:c9:26:0e:ae Device type: Physical Initiator...

  • Page 411: See Also

    Note: Enter commands in lowercase only; mixed case is for readability. nsZoneMember To display each local device’s online zoned device data: switch:admin> nszonemember -a Port: 4 Pid: 0xb00400 Aliases: ix360_131_201_6a Zoned Members: 2 devices Pid: 0xb00400 Aliases: ix360_131_201_6a Pid: 0xba1ee8 Aliases: trimm101b_3 Port: 12 Pid: 0xb00c01...

  • Page 412: Passwd

    Note: Enter commands in lowercase only; mixed case is for readability. passwd passwd Changes the password for a user level. Synopsis passwd ["user"] Description Use this command to change the password for the user currently logged in or for another user. To change the password for a specific user, enter the command with the optional "user"...
  • Page 413 Note: Enter commands in lowercase only; mixed case is for readability. passwd Use the following keys to control input: Return When entered at a prompt with no preceding input, accepts the default value (if applicable) and moves to the next prompt. Ctrl-D (end-of-file) When entered at a prompt with no preceding input, terminates the command without changing the password.
  • Page 414 Note: Enter commands in lowercase only; mixed case is for readability. passwd Insufficient number of digits in passwordYou have entered a password that contains less then the minimum required number of numeric characters. Insufficient number of punctuation charactersYou have entered a password that contains less then the minimum required number of punctuation characters.

  • Page 415: Passwdcfg

    Note: Enter commands in lowercase only; mixed case is for readability. passwdCfg passwdCfg Manages the password policies. Synopsis passwdcfg --help passwdcfg --set [-lowercase value][-uppercase value][-digits value][-punctuation value] [-minlength value][-history value][-minpasswordage value][-maxpasswordage value] [-warning value][-lockoutthreshold value][-lockoutduration value] passwdcfg --setdefault passwdcfg --showall passwdcfg --help passwdcfg --set Description...
  • Page 416 Note: Enter commands in lowercase only; mixed case is for readability. passwdCfg after a specified period. An administrator can unlock a locked account at any time. Note that the account locked state is distinct from the account disabled state. Note The execution of this command is subject to Admin Domain restrictions that may be in place.
  • Page 417 Note: Enter commands in lowercase only; mixed case is for readability. passwdCfg -maxpasswordage value Specifies the maximum number of days that can elapse before a password must be changed. This is the password expiration period. -maxpasswordage can be set at 0 to 999. Setting this parameter to 0 disables password expiration.
  • Page 418 Note: Enter commands in lowercase only; mixed case is for readability. passwdCfg Diagnostics If there is a failure, one or more of the following error messages displays: Command not supported passwdCfg is not supported when secure mode is enabled. minlength value out of range The -minlength value must 8 to 40.

  • Page 419: Pathinfo

    Note: Enter commands in lowercase only; mixed case is for readability. pathInfo pathInfo Display routing and statistics information along a path covering multiple switches. Synopsis pathinfo [domain [src_portnumber [dst_portnumber]] [-r]] Description Use this command to display detailed routing information from a source port or area on the local switch to a destination port or area on another switch.
  • Page 420 Note: Enter commands in lowercase only; mixed case is for readability. pathInfo output link is currently recognized by FSPF. When requested, statistics are reported below the routing information for each hop. These statistics are presented for both the input and output ports, for both receive and transmit modes. These statistics are divided into basic and extended statistics, which can be individually requested in interactive mode.
  • Page 421 Note: Enter commands in lowercase only; mixed case is for readability. pathInfo arbitrary route across the fabric. The maximum hop count is enforced. If the source route does not specify all the switches along a section of the path, a further option allows to specify a strict versus a loose path.
  • Page 422 Note: Enter commands in lowercase only; mixed case is for readability. pathInfo Examples To display basic path information to a specific domain, using the command line (noninteractive mode): switch:admin> pathinfo 91 Target port is Embedded In Port Domain ID (Name) Out Port Cost ---------------------------------------------------------...

  • Page 423: Pdshow

    Note: Enter commands in lowercase only; mixed case is for readability. pdShow pdShow Displays data from a panic dump file. Synopsis pdshow [panic_dump_file] Description Use this command to display data from a panic dump file. The panic dump file contains information that might be useful to determine the cause of the system panic.

  • Page 424: Perfaddeemonitor

    Note: Enter commands in lowercase only; mixed case is for readability. perfAddEEMonitor perfAddEEMonitor Adds an end-to-end monitor to a port. Synopsis perfaddeemonitor [slotnumber/]portnumber SourceID DestID Description Use this command to add an end-to-end performance monitor to a port. The performance monitor counts the number of words received, number of words transmitted, and number of CRC errors detected using either of the following two conditions: •...
  • Page 425 Note: Enter commands in lowercase only; mixed case is for readability. perfAddEEMonitor Operands This command has the following operands: slotnumber For bladed systems only, this operand specifies the slot number of the port on which the monitor is to be added, followed by a slash (/). portnumber Specifies the number of the port on which the monitor is to be added, relative to its slot for bladed systems.

  • Page 426: Perfaddipmonitor

    Note: Enter commands in lowercase only; mixed case is for readability. perfAddIPMonitor perfAddIPMonitor Adds a filter-based performance monitor for IP frame count. Synopsis perfaddipmonitor [slotnumber/]portnumber [alias] Description Use this command to define filter-based monitors to count the number of IP traffic frames. Only frames transmitted are counted.

  • Page 427: Perfaddreadmonitor

    Note: Enter commands in lowercase only; mixed case is for readability. perfAddReadMonitor perfAddReadMonitor Adds a filter-based performance monitor for the SCSI Read command. Synopsis perfaddreadmonitor [slotnumber/]portnumber [alias] Description Use this command to define filter-based monitors to count the number of SCSI FCP Read commands in Fibre Channel frames.

  • Page 428: Perfaddrwmonitor

    Note: Enter commands in lowercase only; mixed case is for readability. perfAddRWMonitor perfAddRWMonitor Adds a filter-based performance monitor for the SCSI read and write commands. Synopsis perfaddrwmonitor [slotnumber/]portnumber [alias] Description Use this command to define filter-based monitors to count the number of SCSI FCP Read and Write commands in Fibre Channel frames.

  • Page 429: Perfaddscsimonitor

    Note: Enter commands in lowercase only; mixed case is for readability. perfAddSCSIMonitor perfAddSCSIMonitor Adds a filter-based performance monitor for SCSI frame count. Synopsis perfaddscsimonitor [slotnumber/]portnumber [alias] Description Use this command to define filter-based monitors to count the number of SCSI traffic frames. Only frames transmitted are counted.

  • Page 430: Perfaddusermonitor

    Note: Enter commands in lowercase only; mixed case is for readability. perfAddUserMonitor perfAddUserMonitor Adds a user-defined filter-based performance monitor. Synopsis perfaddusermonitor [slotnumber/]portnumber "grouplist" [alias] Description Use this command to define a custom filter for frame offsets and values. For every offset, each group of comparison values is OR-ed together to determine a match. If there are multiple offsets, each resulting OR function is AND-ed to determine if the entire statement is true, thus incrementing the counter.
  • Page 431 Note: Enter commands in lowercase only; mixed case is for readability. perfAddUserMonitor ValueList Specify up to four values that need to be captured from frame contents. The ValueList can be either hexadecimal or decimal format. SOFx frames are considered a special case. The Offset is specified as 0x0; valueList values are specified with: SOFf SOFc1...

  • Page 432: Perfaddwritemonitor

    Note: Enter commands in lowercase only; mixed case is for readability. perfAddWriteMonitor perfAddWriteMonitor Adds a filter-based performance monitor for the SCSI write command. Synopsis perfaddwritemonitor [slotnumber/]portnumber [alias] Description Use this command to define filter-based monitors to count the number of SCSI FCP write commands in Fibre Channel frames.

  • Page 433: Perfcfgclear

    Note: Enter commands in lowercase only; mixed case is for readability. perfCfgClear perfCfgClear Clears the previously saved performance monitoring configuration settings from nonvolatile memory. Synopsis perfcfgclear Description Use this command to clear the previously saved end-to-end and filter configuration settings of performance monitoring from nonvolatile memory.

  • Page 434: Perfcfgrestore

    Note: Enter commands in lowercase only; mixed case is for readability. perfCfgRestore perfCfgRestore Restores performance monitoring configuration settings from nonvolatile memory. Synopsis perfcfgrestore Description Use this command to restore the performance monitoring configuration information from nonvolatile memory. This does not restore the information cleared using the perfCfgClear command;...

  • Page 435: Perfcfgsave

    Note: Enter commands in lowercase only; mixed case is for readability. perfCfgSave perfCfgSave Saves performance monitoring configuration settings to nonvolatile memory. Synopsis perfcfgsave Description Use this command to save the current Performance Monitor configuration for end-to-end (EE) and filter configuration settings of performance monitoring into nonvolatile memory. This enables the performance monitoring configuration to be saved across power cycles.

  • Page 436: Perfclearalpacrc

    Note: Enter commands in lowercase only; mixed case is for readability. perfClearAlpaCrc perfClearAlpaCrc Clears the CRC error count associated with a port and arbitrated loop physical address (AL_PA). Synopsis perfclearalpacrc [slotnumber/]portnumber [ALPA] Description Use this command to clear a specific CRC error counter associated with a specific port and AL_PA, or all such counters on a port.

  • Page 437: Perfcleareemonitor

    Note: Enter commands in lowercase only; mixed case is for readability. perfClearEEMonitor perfClearEEMonitor Clears statistics counters of an end-to-end performance monitors. Synopsis perfcleareemonitor [slotnumber/]portnumber [monitorId] Description Use this command to clear statistics counters for all end-to-end performance monitors on a port, or an end-to-end monitor associated with a specific monitorId.

  • Page 438: Perfclearfiltermonitor

    Note: Enter commands in lowercase only; mixed case is for readability. perfClearFilterMonitor perfClearFilterMonitor Clears counters of one or more filter-based performance monitors. Synopsis perfclearfiltermonitor [slotnumber/]portnumber [monitorId] Description Use this command to clear counters for all filter-based performance monitors on a port or a filter-based monitor associated with a specific monitorId.

  • Page 439: Perfdeleemonitor

    Note: Enter commands in lowercase only; mixed case is for readability. perfDelEEMonitor perfDelEEMonitor Deletes one or all end-to-end performance monitors from a port. Synopsis perfdeleemonitor [slotnumber/]portnumber [monitorId] Description Use this command to delete an end-to-end performance monitor from a port, or all such monitors associated with a port.

  • Page 440: Perfdelfiltermonitor

    Note: Enter commands in lowercase only; mixed case is for readability. perfDelFilterMonitor perfDelFilterMonitor Deletes one or all filter-based performance monitors from a port. Synopsis perfdelfiltermonitor [slotnumber/]portnumber [monitorid] Description Use this command to delete a filter-based performance monitor from a port, or all such monitors associated with a port.

  • Page 441: Perfhelp

    Note: Enter commands in lowercase only; mixed case is for readability. perfHelp perfHelp Displays performance monitoring help information. Synopsis perfhelp Description Use this command to display the available performance monitoring help commands. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 442: Perfmonitorclear

    Note: Enter commands in lowercase only; mixed case is for readability. perfMonitorClear perfMonitorClear Clears counters of end-to-end, filter-based, and ISL performance monitors on a port. Synopsis perfmonitorclear --class monitor_class [slotnumber/]portnumber [monitorId] Description Use this command to clear counters for performance monitors on a port, specified by class.. Monitor classes include end-to-end monitors (EE), filter-based monitors (FLT), and interswitch link monitors (ISL).
  • Page 443 Note: Enter commands in lowercase only; mixed case is for readability. perfMonitorClear To clear statistics counters for an ISL monitor: switch:admin> perfmonitorclear --class ISL 1 This will clear ISL monitor on port 1, continue? (yes, y, no, n): [no] y See Also perfAddEEMonitor, perfAddIPMonitor, perfAddReadMonitor, perfAddRWMonitor, perfAddSCSIMonitor, perfAddUserMonitor, perfAddWriteMonitor,...

  • Page 444: Perfmonitorshow

    Note: Enter commands in lowercase only; mixed case is for readability. perfMonitorShow perfMonitorShow Displays end-to-end, filter-based, and ISL monitors on a port. Synopsis perfmonitorshow --class monitor_class [slotnumber/]portnumber [interval] Description Use this command to display previously created monitors on a port. Monitor classes include end-to-end monitors (EE), filter-based monitors (FLT), and Inter-Switch Link monitors (ISL).
  • Page 445 Note: Enter commands in lowercase only; mixed case is for readability. perfMonitorShow Note This command requires a Brocade Advanced Performance Monitoring license. This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port, M (Mirror) ports and GbE ports. Note The execution of this command is subject to Admin Domain restrictions that may be in place.
  • Page 446 Note: Enter commands in lowercase only; mixed case is for readability. perfMonitorShow To display EE monitors on a port: switch:admin> perfmonitorshow --class EE 4/5 There are 7 end-to-end monitor(s) defined on port 53. OWNER_APP OWNER_IP_ADDR TX_COUNT RX_COUNT CRC_COUNT ----------------------------------------------------------------------------------------------- 0x58e0f 0x1182ef TELNET N/A 0x0000000000000000 0x0000000000000000...
  • Page 447 Note: Enter commands in lowercase only; mixed case is for readability. perfMonitorShow To display ISL monitor information on a port: switch:admin> perfmonitorshow --class ISL 1/1 Total transmit count for this ISL: 1462326 Number of destination domains monitored: 3 Number of ports in this ISL: 2 Domain 110379 Domain 98:...

  • Page 448: Perfsetporteemask

    Note: Enter commands in lowercase only; mixed case is for readability. perfSetPortEEMask perfSetPortEEMask Sets the overall mask for end-to-end (EE) performance monitors. Synopsis perfsetporteemask [slotnumber/]portnumber "TxSIDMsk " "TxDIDMsk " "RxSIDMsk" "RxDIDMsk" Description Use this command to set the mask for the end-to-end (EE) performance monitors of a port. This command enables a user to selectively choose the kind of Fibre Channel frames to get performance statistics on.
  • Page 449 Note: Enter commands in lowercase only; mixed case is for readability. perfSetPortEEMask TxSIDMsk Specify the transmitting source ID mask in dd:aa:pp format, with quotation marks, , where dd is the domain ID mask, aa is the area ID mask, and pp is AL_PA ID mask.

  • Page 450: Perfshowalpacrc

    Note: Enter commands in lowercase only; mixed case is for readability. perfShowAlpaCrc perfShowAlpaCrc Displays the CRC error count by port or by arbitrated loop physical address (AL_PA). Synopsis perfshowalpacrc [slotnumber/]portnumber [ALPA] Description Use this command to display the CRC error count of one or all devices attached to a port. If the AL_PA operand is specified, only the CRC count for that AL_PA device is displayed.

  • Page 451: Perfshoweemonitor

    Note: Enter commands in lowercase only; mixed case is for readability. perfShowEEMonitor perfShowEEMonitor Displays end-to-end performance monitor information on a port. Synopsis perfshoweemonitor [slotnumber/]portnumber [interval] Description Use this command to display end-to-end monitor information on a port. Refer to perfMonitorShow for details regarding this command’s output.
  • Page 452 Note: Enter commands in lowercase only; mixed case is for readability. perfShowEEMonitor To display cumulative information from EE monitors on a port: switch:admin> perfshoweemonitor 4/5 There are 7 end-to-end monitor(s) defined on port 53. OWNER_APP OWNER_IP_ADDR TX_COUNT RX_COUNT CRC_COUNT ----------------------------------------------------------------------------------------------------- ------------- 0x21300 0x21dda...

  • Page 453: Perfshowfiltermonitor

    Note: Enter commands in lowercase only; mixed case is for readability. perfShowFilterMonitor perfShowFilterMonitor Displays all filter-based performance monitor information for a port. Synopsis perfshowfiltermonitor [slotnumber/]portnumber [interval] Description Use this command to display all the filter-based monitors defined on the specified port and the traffic count values.
  • Page 454 Note: Enter commands in lowercase only; mixed case is for readability. perfShowFilterMonitor Examples To display filter monitor traffic on a port at an interval of every 6 seconds: switch:admin> perfshowfiltermonitor 2/5 6 perfshowfiltermonitor 21, 6 #Frames #CMDs #CMDs #Frames #Frames #CMDs #CMDs ---------------------------------------------------------------...

  • Page 455: Perfshowporteemask

    Note: Enter commands in lowercase only; mixed case is for readability. perfShowPortEEMask perfShowPortEEMask Displays the current address mask for end-to-end performance monitors on a port. Synopsis perfshowporteemask [slotnumber/]portnumber Description Use this command to display the current mask shared across all end-to-end (EE) performance monitors of a port.
  • Page 456 Note: Enter commands in lowercase only; mixed case is for readability. perfShowPortEEMask Examples To display the end-to-end mask on a port: switch:admin> perfshowporteemask 2/4 The EE mask onport 20 is set by application NONE TxSID Domain: TxSID Area: TxSID ALPA: TxDID Domain: TxDID Area: TxDID ALPA:...

  • Page 457: Pkicreate

    Note: Enter commands in lowercase only; mixed case is for readability. pkiCreate pkiCreate Creates public key infrastructure (PKI) objects. Synopsis pkicreate Description Use this command in non-secure mode to create PKI objects: • Switch private key and CSR • • Install root certificate This command does not create the switch certificate.

  • Page 458: Pkiremove

    Note: Enter commands in lowercase only; mixed case is for readability. pkiRemove pkiRemove Removes existing public key infrastructure (PKI) objects. Synopsis pkiremove Description Use this command to remove PKI objects in non-secure mode. It removes switch private key, private key pass-phrase, CSR, root certificate, and switch certificate.

  • Page 459: Pkishow

    Note: Enter commands in lowercase only; mixed case is for readability. pkiShow pkiShow Displays existing public key infrastructure (PKI) objects. Synopsis pkishow Description Use this command to display existence of PKI objects, such as switch private key, private key pass- phrase, CSR, root certificate, and switch certificate.

  • Page 460: Policy

    Note: Enter commands in lowercase only; mixed case is for readability. policy policy Displays or modifies the encryption and authentication algorithms for security policies. Synopsis policy option type number [--enc method] [--auth algorithm] [--pfs value] [--dh group] [--seclife sec- onds] Description Use this command to display or modify the encryption and authentication algorithms for security policies.
  • Page 461 Note: Enter commands in lowercase only; mixed case is for readability. policy Examples To create a new policy: switch:admin> policy --create ike 10 -enc 3des -auth md5 The following policy has been set: IKE policy 10 ----------------------------------------- Authentication Algorithm: MD5 Encryption: 3DES Perfect Forward Secrecy: 0 Diffie-Hellman Group: 1...
  • Page 462 Note: Enter commands in lowercase only; mixed case is for readability. policy To change (delete and re-create) a policy: switch:admin> policy ike --delete 10 This policy has been successfully deleted. switch:admin> policy ike --create 10 -enc aes-128 -auth sha-1 The following policy has been set: IKE policy 10 ----------------------------------------- Authentication Algorithm: SHA-1...

  • Page 463: Portalpashow

    Note: Enter commands in lowercase only; mixed case is for readability. portAlpaShow portAlpaShow Displays the Arbitrated Loop Phyiscal Addresses (AL_PAs) of devices attached to a port. Synopsis portalpashow [slotnumber/]portnumber Description Use this command to display the AL_PAs of devices connected to a port, and whether these devices are public or private.

  • Page 464: Portbuffershow

    Note: Enter commands in lowercase only; mixed case is for readability. portBufferShow portBufferShow Displays the buffer usage information for a port group or for all port groups in the switch. Synopsis portbuffershow [slotnumber/][portnumber] Description Use this command to display the current long distance buffer information for the ports in a port group. The port group can be specified by giving any port number in that group.
  • Page 465 Note: Enter commands in lowercase only; mixed case is for readability. portBufferShow Note The execution of this command is subject to Admin Domain restrictions that may be in place. Fabric OS Command Reference Manual 2-431 Publication Number: 53-1000240-01...
  • Page 466 Note: Enter commands in lowercase only; mixed case is for readability. portBufferShow Operands The operands are as follows: slotnumber For bladed systems only, specifies the slot number of the port group to display, followed by a slash (/). portnumber Specifies the number of a port associated with the port group to display, relative to its slot for bladed systems.

  • Page 467: Portcamshow

    Note: Enter commands in lowercase only; mixed case is for readability. portCamShow portCamShow Displays port-based filter CAM utilization. Synopsis portcamshow [slotnumber/][portnumber] Description Use this command to display the current filter CAM utilization of all ports or one port specified at input. The following information is displayed: SID used Total number of CAM entries used by this port.
  • Page 468 Note: Enter commands in lowercase only; mixed case is for readability. portCamShow will look like below: switch:user> portcamshow 7/39 -------------------------------------------------- Area SID used DID used SID entries DID entries 03b380 03cf80 034100 03cf00 -------------------------------------------------- SID free, DID free: (2044, 1020) zebra114:root>...
  • Page 469 Note: Enter commands in lowercase only; mixed case is for readability. portCamShow To display the filter CAM utilization for a single port on a switch: switch:user> portcamshow 3/2 -------------------------------------------------- Area SID used DID used SID entries DID entries 350400 2b2200 2b1200 220400 --------------------------------------------------...

  • Page 470: Portcfg

    Note: Enter commands in lowercase only; mixed case is for readability. portCfg portCfg Enables or disables a port's configuration. Synopsis portcfg action [slot/][ge]port args Description Use this command to configure the gigabit Ethernet (GbE) port, address resolution protocol (ARP) entries, IP interfaces on the gigabit Ethernet (GbE) port, static routes on the IP interface, FCIP tunnels, mirror port, and registered state change notification (RSCN) suppression.
  • Page 471 Note: Enter commands in lowercase only; mixed case is for readability. portCfg -key preshared-key Specifies the preshared-key to be used during IKE authentication. Its length can be up to a maximum length is 32 bytes. It must be a double quoted string of alpha-numeric characters.
  • Page 472 Note: Enter commands in lowercase only; mixed case is for readability. portCfg Specifies the maximum retransmissions for the existing tunnel. retransmissions values are 1 to 16; default is 8. If tape pipelining is enabled, default value is calculated based on the mininum retransmit time to ensure that tcp connection does not timeout before the host times out.
  • Page 473 Note: Enter commands in lowercase only; mixed case is for readability. portCfg parameter to bring up a native IP interface for link-level diagnostics, connectivity, and characterization of SLA. macaddr Specifies the MAC address which corresponds to the IP address in the ARP table. netmask Specifies the subnet mask for the specified port or route.
  • Page 474 Note: Enter commands in lowercase only; mixed case is for readability. portCfg To create a static IP route: switch:admin> portcfg iproute ge0 create 172.16.123.231. 255.255.0.0 192.168.255.25 Operation Succeeded To create an FCIP tunnel: switch:admin> portcfg fciptunnel ge0 create 2 192.168.255.2 192.168.255.20 100000 Operation Succeeded To create a mirror portl: switch:admin>...
  • Page 475 Note: Enter commands in lowercase only; mixed case is for readability. portCfg To configure a range of ports as RSCN supressed: switch:admin> portcfg rscnsupr 2/4-7 --enable switch:admin> portcfgshow [output from other slots suppressed] Ports of Slot 2 9 10 11 12 13 14 15 -----------------+--+--+--+--+----+--+--+--+----+--+--+--+----+--+--+-- Speed...

  • Page 476: Portcfgdefault

    Note: Enter commands in lowercase only; mixed case is for readability. portCfgDefault portCfgDefault Restores the port configuration to factory default values. Synopsis portcfgdefault [slotnumber/][ge]portnumber Description Use this command to reset any special configuration values on a port to their factory defaults. This command will disable ports capable of routing persistently, which is the factory default value.

  • Page 477: Portcfgeport

    Note: Enter commands in lowercase only; mixed case is for readability. portCfgEPort portCfgEPort Enables or disables a port from becoming an E_Port. Synopsis portcfgeport [slotnumber/]portnumber, mode Description Use this command to enable or disable a port from becoming an E_Port. The E_Port capability is enabled by default unless this command is used to disable it.

  • Page 478: Portcfgexport

    Note: Enter commands in lowercase only; mixed case is for readability. portCfgEXPort portCfgEXPort Sets a port to be an EX_Port, and sets and displays EX_Port configuration parameters. Synopsis portcfgexport [slotnumber/]portnumber [-a admin][-f fabricid][-r ratov][-e edtov][-d domainid] [-p pidformat][-t fabric_parameter][-m port mode] Description Use this command to configure a port as an EX_Port.
  • Page 479 Note: Enter commands in lowercase only; mixed case is for readability. portCfgEXPort -p pidformat Specify the Port ID format. Valid values are 0-native, 1-core, 2-extended edge. This operand is applicable only when port mode is set to 0 (native mode). If port mode is not "Brocade Native", the Port ID format displays as "Not applicable".

  • Page 480: Portcfggport

    Note: Enter commands in lowercase only; mixed case is for readability. portCfgGPort portCfgGPort Designates a port as a G_Port. Synopsis portcfggport [slotnumber/]portnumber, mode Description Use this command to designate a port as a G_Port. After this is done, the switch attempts to initialize that port as an F_Port only, and does not attempt loop initialization (FL_Port) on the port.

  • Page 481: Portcfgislmode

    Note: Enter commands in lowercase only; mixed case is for readability. portCfgISLMode portCfgISLMode Enables or disables ISL R_RDY mode on a port. Synopsis portcfgislmode [[slotnumber/]]portnumber, mode Description Use this command to enable or disable ISL R_RDY mode on a port. If enabling ISL R_RDY mode on a port, make sure the PID format is consistent across the entire fabric.
  • Page 482 Note: Enter commands in lowercase only; mixed case is for readability. portCfgISLMode Note The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operands: slotnumber For bladed systems only, specify the slot number of the port to display, followed by a slash (/).

  • Page 483: Portcfglongdistance

    Note: Enter commands in lowercase only; mixed case is for readability. portCfgLongDistance portCfgLongDistance Configures a port to support long-distance links. Synopsis portcfglongdistance [slotnumber/]portnumber [distance_level][vc_translation_link_init] [desired_distance] Description Use this command to allocate enough full-size frame buffers on a particular port to support a long- distance link up to 500 Km.
  • Page 484 Note: Enter commands in lowercase only; mixed case is for readability. portCfgLongDistance Depending on the switch platform and the frame buffers availability within the port group, the LD or LS- level links can operate up to distances of 500 Km, 250 Km, or 125 Km at the fixed speed of 1 Gbit/sec, 2 Gbit/sec, or 4 Gbit/sec, respectively.
  • Page 485 Note: Enter commands in lowercase only; mixed case is for readability. portCfgLongDistance Operands This command has the following operands: slotnumber Specifies the slot number, for bladed systems only. The slot number must be followed by a slash (/). portnumber Specifies a port number. Valid values for port number vary, depending on the switch type.

  • Page 486: Portcfglport

    Note: Enter commands in lowercase only; mixed case is for readability. portCfgLPort portCfgLPort Configures a port as an L_Port. Synopsis portcfglport [slotnumber/]portnumber locked_mode [private_mode] [duplex_mode] Description Use this command to designate a port as an L_Port. The switch then only attempts to initialize that port as an FL_Port.
  • Page 487 Note: Enter commands in lowercase only; mixed case is for readability. portCfgLPort Examples To configure a port as a locked L_Port: switch:admin> portcfglport 4/15, 1 switch:admin> portcfgshow [output from other slots suppressed] Ports of Slot 4 9 10 11 12 13 14 15 -----------------+--+--+--+--+----+--+--+--+----+--+--+--+----+--+--+-- Speed AN AN AN AN...

  • Page 488: Portcfgnpivport

    Note: Enter commands in lowercase only; mixed case is for readability. portCfgNPIVPort portCfgNPIVPort Enables or disables N_Port ID virtualization (NPIV) functionality on a port. Synopsis portcfgnpivport [slotnumber/]portnumber, mode Description Use this command to enable or disable NPIV functionality on a port. NPIV is applicable to an F_Port only.
  • Page 489 Note: Enter commands in lowercase only; mixed case is for readability. portCfgNPIVPort Examples To enable NPIV functionality on a port: switch:admin> portcfgnpivport 1/3 1 To display NPIV functionality on a port: switch:admin> portcfgshow (output from other ports suppressed) Ports of Slot 1 9 10 11 12 13 14 15 -----------------+--+--+--+--+----+--+--+--+----+--+--+--+----+--+--+--...

  • Page 490: Portcfgpersistentdisable

    Note: Enter commands in lowercase only; mixed case is for readability. portCfgPersistentDisable portCfgPersistentDisable Disables a port persistently. Synopsis portcfgpersistentdisable [slotnumber/]portnumber Description Use this command to persistently disable a port. Persistently disabled ports remain disabled across power cycles, switch reboots, and switch enables. By default, a port is enabled persistently. The change in configuration is effective immediately.

  • Page 491: Portcfgpersistentenable

    Note: Enter commands in lowercase only; mixed case is for readability. portCfgPersistentEnable portCfgPersistentEnable Enables a port persistently. Synopsis portcfgpersistentenable [slotnumber/]portnumber Description Use this command to persistently enable a port. Persistently enabled ports remain enabled across power cycles, switch reboots, and switch enables. By default, a port is enabled persistently. The change in configuration is effective immediately.

  • Page 492: Portcfgshow

    Note: Enter commands in lowercase only; mixed case is for readability. portCfgShow portCfgShow Displays port configuration settings. Synopsis portcfgshow [slot/][port] portcfgshow [arp | fciptunnel <all | tunnel_id> [-ipsec] | ipif | iproute | iscsi | mode ] [slot/][ge]port Description Use this command to display the current configuration of a port. If no operand is specified, this command displays port configuration settings for all ports on a switch, except gigabit Ethernet (GbE) ports.
  • Page 493 Note: Enter commands in lowercase only; mixed case is for readability. portCfgShow RSCN Suppression Displays as ON when the port has RSCN suppression enabled or blank (..) when the port has RSCN suppression disabled. This value is set by the portCfg rscnsupr command.
  • Page 494 Note: Enter commands in lowercase only; mixed case is for readability. portCfgShow Examples To display the configuration settings for a switch: switch:user> portcfgshow Ports of Slot 2 9 10 11 12 13 14 15 -----------------+--+--+--+--+---+--+--+--+----+--+--+--+----+--+--+-- Speed AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN...
  • Page 495 Note: Enter commands in lowercase only; mixed case is for readability. portCfgShow To display the configuration settings for a port: switch:user> portcfgshow 2/16 Area Number: Speed Level: AUTO Trunk Port Long Distance VC Link Init Locked L_Port Locked G_Port Disabled E_Port ISL R_RDY Mode RSCN Suppressed Persistent Disable...

  • Page 496: Portcfgspeed

    Note: Enter commands in lowercase only; mixed case is for readability. portCfgSpeed portCfgSpeed Configures a port to a particular speed level. Synopsis portcfgspeed [slotnumber/]portnumber, speed_level Description Use this command to configure the speed of a port to a particular level. After this command is issued, the port is disabled and enabled so that the port comes up with the new speed setting.

  • Page 497: Portcfgtrunkport

    Note: Enter commands in lowercase only; mixed case is for readability. portCfgTrunkPort portCfgTrunkPort Configures a port to enable or disable trunking. Synopsis portcfgtrunkport [slotnumber/]portnumber[,] mode Description Use this command to enable or disable a port for trunking. You can disable or enable trunking using the portCfgTrunkPort switchCfgTrunk commands.

  • Page 498: Portcfgvexport

    Note: Enter commands in lowercase only; mixed case is for readability. portCfgVEXPort portCfgVEXPort Sets a port to be an VEX_Port, connected to a FC-IP and sets and displays VEX_Port configuration parameters. Synopsis portcfgexport [slotnumber/]portnumber [-a admin][-f fabricid][-r ratov][-e edtov][-d domainid][-p pid- format][-t fabric_parameter] Description Use this command to configure a port as an VEX_Port.
  • Page 499 Note: Enter commands in lowercase only; mixed case is for readability. portCfgVEXPort Examples To display the VEX_Port configuration of port 2/16: switch:admin> portcfgvexport 2/16 Port 2/16 info Admin: enabled State: Pid format: core(N) Edge Fabric ID: Front Domain ID: Front WWN: 50:06:06:9e:20:9f:ce:10 Principal Switch: principal WWN:...

  • Page 500: Portcmd

    Note: Enter commands in lowercase only; mixed case is for readability. portCmd portCmd Diagnoses intelligent ports. Synopsis portcmd --ipperf [slot/]geport -s src_ip -d dst_ip -S | -R [-i interval] [-p port] [-r committed_rate] [- t running_time] [-z size] portcmd --ping [slot/]geport -s src_ip -d dst_ip [-n num_requests] [-q service_type] [-t ttl] [-w wait_time] [-z size] portcmd --traceroute [slot/]geport -s src_ip -d dst_ip [-h max_hops] [-f first_ttl] [-q type_of_service] [-w timeout] [-z size]...
  • Page 501 Note: Enter commands in lowercase only; mixed case is for readability. portCmd -r committed_rate Specifies committed rate for the date stream, in Kb/s. If specified, the traffic generator is limited by a traffic shaper. This characterizes the end- to-end IP path performance based on the data rate configured for a tunnel between the same end-points.
  • Page 502 Note: Enter commands in lowercase only; mixed case is for readability. portCmd -s src_ip Specifies the source IP interface that originates the ping request. -d dst_ip Specifies the destination IP address to which to target the ping request. -n num_requests Specifies the number of ping requests.
  • Page 503 Note: Enter commands in lowercase only; mixed case is for readability. portCmd interface. This operand is optional. Examples To verify if packets can be sent to the destination IP address: switch:admin> portcmd ping 4/ge0 -s 192.168.100.50 -d 192.168.100.40 Pinging 192.168.100.40 from ip interface 192.168.100.50 on 0/0 with 40 bytes of data Reply from 192.168.100.40: bytes=40 rtt=0ms ttl=64 Reply from 192.168.100.40: bytes=40 rtt=0ms ttl=64 Reply from 192.168.100.40: bytes=40 rtt=0ms ttl=64...

  • Page 504: Portdebug

    Note: Enter commands in lowercase only; mixed case is for readability. portDebug portDebug Sets debug level and verbose level of port modules. Synopsis portdebug dbg_lvl, vbs_lvl Description Use this command to set the debug level and verbose level of port modules. Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 505: Portdisable

    Note: Enter commands in lowercase only; mixed case is for readability. portDisable portDisable Disables a port. Synopsis portdisable [slotnumber/]portnumber Description Use this command to disable a port. If the port is connected to another switch, the fabric might reconfigure. Devices connected to this port can no longer communicate with the fabric. If the port was online before being disabled, a state transition will be indicated in the following ways: RSCN, SNMP trap, Web pop-up window.

  • Page 506: Portenable

    Note: Enter commands in lowercase only; mixed case is for readability. portEnable portEnable Enables a port. Synopsis portenable [slotnumber/]portnumber Description Use this command to enable a port. If the port is connected to another switch, the fabric might reconfigure. Devices connected to the port can now communicate with the fabric. For ports that come online after being enabled, the following indications might be sent to indicate a state transition: RSCN, SNMP trap, Web pop-up window.

  • Page 507: Porterrshow

    Note: Enter commands in lowercase only; mixed case is for readability. portErrShow portErrShow Displays port error summary. Synopsis porterrshow Description Use this command to display an error summary for all ports. The display contains one output line per port and shows error counters in ones, thousands (k), or millions (m). The following fields are displayed: frames tx Frames transmitted...
  • Page 508 Note: Enter commands in lowercase only; mixed case is for readability. portErrShow Examples To display error counters for ports on a switch: switch:admin> porterrshow frames enc disc link loss loss frjt fbsy err shrt long c3 fail sync ===================================================================== See Also portShow, portStatsShow 2-474...

  • Page 509: Portflagsshow

    Note: Enter commands in lowercase only; mixed case is for readability. portFlagsShow portFlagsShow Displays the port status bitmaps for all ports in a switch. Synopsis portflagsshow Description Use this command to display the following status for a port: SNMP Displays whether the port is online or offline. Physical Displays the port physical status.
  • Page 510 Note: Enter commands in lowercase only; mixed case is for readability. portFlagsShow See Also portShow, switchShow 2-476 Fabric OS Command Reference Manual Publication Number: 53-1000240-01...

  • Page 511: Portledtest

    Note: Enter commands in lowercase only; mixed case is for readability. portLedTest portLedTest Cycles user port LEDs. Synopsis portledtest [-npass count][-ports itemlist] Description Use this command to exercise the user port LEDs in the current switch on and off by setting the ATTN LEDs to green for the ON condition and unlighted for the OFF condition.

  • Page 512: Portlogclear

    Note: Enter commands in lowercase only; mixed case is for readability. portLogClear portLogClear Clears the port log. Synopsis portlogclear Description Use this command to clear the port log. You might want to clear the port log before triggering an activity so that the log displays only the log events related to that activity.

  • Page 513: Portlogconfigshow

    Note: Enter commands in lowercase only; mixed case is for readability. portLogConfigShow portLogConfigShow Displays the current port log configuration. Synopsis portlogconfigshow Description Use this command to display the current port log configuration. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 514: Portlogdisable

    Note: Enter commands in lowercase only; mixed case is for readability. portLogDisable portLogDisable Disables the port log facility. Synopsis portlogdisable Description Use this command to disable the port log facility. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Operands None.

  • Page 515: Portlogdump

    Note: Enter commands in lowercase only; mixed case is for readability. portLogDump portLogDump Displays the port log without page breaks. Synopsis portlogdump [count[, saved[, portid]]] Description Use this command to display the port log, listing all entries in the log without page breaks. This command displays the same information as portLogShow, but portLogShow prompts the user to press Enter...
  • Page 516 Note: Enter commands in lowercase only; mixed case is for readability. portLogDump See Also portLogClear, portLogShow, upTime 2-482 Fabric OS Command Reference Manual Publication Number: 53-1000240-01...

  • Page 517: Portlogdumpport

    Note: Enter commands in lowercase only; mixed case is for readability. portLogDumpPort portLogDumpPort Displays the port log of specified port, without page breaks. Synopsis portlogdumpport portid Description Use this command to display the port log of specified port. The command displays all entries in the log without any page breaks.

  • Page 518: Portlogenable

    Note: Enter commands in lowercase only; mixed case is for readability. portLogEnable portLogEnable Enables the port log facility. Synopsis portLogEnable Description Use this command to enable the port log facility. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Operands None.

  • Page 519: Portlogeventshow

    Note: Enter commands in lowercase only; mixed case is for readability. portLogEventShow portLogEventShow Displays information about port log events. Synopsis portlogeventshow Description Use this command to display information about the ID associated with the various port log events. The Disabled field indicates if the port log for that event ID is disabled (1) or enabled (0). Note The execution of this command is subject to Admin Domain restrictions that may be in place.
  • Page 520 Note: Enter commands in lowercase only; mixed case is for readability. portLogEventShow Examples Display information about port log events: switch:admin> portlogeventshow Event-Name Disabled --------------------------------- start disable enable ioctl stats pstate reject busy ctin ctout errlog loopscn create debug nbrfsm timer fcin fcout read...
  • Page 521 Note: Enter commands in lowercase only; mixed case is for readability. portLogEventShow See Also portLogTypeDisable, portLogTypeEnable Fabric OS Command Reference Manual 2-487 Publication Number: 53-1000240-01...

  • Page 522: Portloginshow

    Note: Enter commands in lowercase only; mixed case is for readability. portLoginShow portLoginShow Displays port login status of devices attached to the specified port. Synopsis portloginshow [slotnumber/]portnumber Description Use this command to display port login received from devices attached to the specified port. For each login, this command displays the following fields: Type Type of login:...

  • Page 523: Portlogpdisc

    Note: Enter commands in lowercase only; mixed case is for readability. portLogPdisc portLogPdisc Sets or clears the debug_pdisc_flag. Synopsis portlogpdisc lvl Description Use this command to set or clear the debug_pdisc_flag. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operand: Specify either 0 to clear or 1 to set the debug_pdisc_flag.

  • Page 524: Portlogreset

    Note: Enter commands in lowercase only; mixed case is for readability. portLogReset portLogReset Enables the port log facility. Synopsis portlogreset Description Use this command to enable the port log facility. Refer to portLogClear for events that might disable the port log facility. Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 525: Portlogresize

    Note: Enter commands in lowercase only; mixed case is for readability. portLogResize portLogResize Resizes the port log to the specified number of entries. Synopsis portlogresize num_entries Description Use this command to resize the port log to specified number of entries. If num_entries is less than the already configured port log size, no change is effected.

  • Page 526: Portlogshow

    Note: Enter commands in lowercase only; mixed case is for readability. portLogShow portLogShow Displays the port log with page breaks. Synopsis portlogshow [count, saved, ] Description Use this command to display the port log, page by page. portLogShow command displays the same information as portLogDump, but it enables you to press Enter after each page of output.
  • Page 527 Note: Enter commands in lowercase only; mixed case is for readability. portLogShow Speed negotiation states fcin Incoming fibre channel information unit fcout Outgoing fibre channel information unit read Information unit header log from read operation write Information unit header log from write operation Information unit header log of an fc error frame frame FC frame payload...
  • Page 528 Note: Enter commands in lowercase only; mixed case is for readability. portLogShow disable State (refer to state codes next) enable Mode: 0 normal; non-zero loopback Tx & RxHeader words 0,1,4 (R_CTL,D_ID,S_ID,OX_ID,RX_ID) and the first payload word reject FC-PH reject reason busy FC-PH busy reason ctin...
  • Page 529 Note: Enter commands in lowercase only; mixed case is for readability. portLogShow Online Offline Testing Faulty E_Port F_Port Segmented pstate Active State Link Reset: LR Transmit State Link Reset: LR Receive State Link Reset: LRR Receive State Link Failure: NOS Transmit State Link Failure: NOS Receive State Offline: OLS Transmit State Offline: OLS Receive State...
  • Page 530 Note: Enter commands in lowercase only; mixed case is for readability. portLogShow Negotiation complete For a full explanation of the information displayed by this command, refer to the Fabric OS Administrator’s Guide. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operands: count...

  • Page 531: Portlogshowport

    Note: Enter commands in lowercase only; mixed case is for readability. portLogShowPort portLogShowPort Displays the port log of specified port, with page breaks. Synopsis portlogshowport [portid] Description Use this command to display the port log of the specified port, showing all entries in the log with page breaks.

  • Page 532: Portlogtypedisable

    Note: Enter commands in lowercase only; mixed case is for readability. portLogTypeDisable portLogTypeDisable Disables the port log of a specified type. Synopsis portlogtypedisable id Description Use this command to disable the port log for a specified port log type. Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 533: Portlogtypeenable

    Note: Enter commands in lowercase only; mixed case is for readability. portLogTypeEnable portLogTypeEnable Enables the port log of a specified port log type. Synopsis portlogtypeenable id Description Use this command to enable the port log for a specified port log type. Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 534: Portloopbacktest

    Note: Enter commands in lowercase only; mixed case is for readability. portLoopbackTest portLoopbackTest Functional test of port N->N path. Synopsis portloopbacktest [--slot number][-nframes count][-lb_mode mode][-spd_mode mode] [-ports itemlist] Description Use this command to verify the functional operation of the switch by sending frames from the port N transmitter and looping them back into the same port N receiver.
  • Page 535 Note: Enter commands in lowercase only; mixed case is for readability. portLoopbackTest on fixed-port-count products. -nframes count Specify the number of frames to send. The test will progress until the specified number of frames has been transmitted on each port. The default value is 10. -lb_mode mode Specify the loopback mode for the test.
  • Page 536 Note: Enter commands in lowercase only; mixed case is for readability. portLoopbackTest Diagnostics Following are possible error messages if failures are detected: DATA ERRSTAT INIT PORTDIED STATS TIMEOUT XMIT Refer to the Fabric OS Message Reference for more information. See Also camTest, centralMemoryTest, cmemRetentionTest, cmiTest, crossPortTest, itemList, portRegTest, spinSilk, sramRetentionTest...

  • Page 537: Portmirror

    Note: Enter commands in lowercase only; mixed case is for readability. portMirror portMirror Add/delete/show mirror connection(s). Synopsis portMirror [--show ] [--add [slotnumber/]portnumber sourceID DestID] [--delete [sourceID DestID]] Description Use this command to add/delete/show a mirror connection. The --add option will add a mirror connection between the source and destination. The slotnumber/ portnumber is the mirrored traffic output port.
  • Page 538 Note: Enter commands in lowercase only; mixed case is for readability. portMirror The mirror port location can impact the latency of mirrored frames. Setting up multiple mirror connections on a core-edge platform between devices will mirror additional traffic. If user has two mirror connections, device A to device B and device C to device D. The mirror port will see traffic between A to B and C to D.
  • Page 539 Note: Enter commands in lowercase only; mixed case is for readability. portMirror To display port mirror connections: switch:admin> portmirror --show Number of mirror connection(s) configured: 2 Mirror_Port State ---------------------------------------- 10/12 0x791800 0x791900 Defined 10/15 0x791a00 0x799300 Enabled See Also portCfgShow Fabric OS Command Reference Manual 2-505 Publication Number: 53-1000240-01...

  • Page 540: Portname

    Note: Enter commands in lowercase only; mixed case is for readability. portName portName Assigns a name to the specificed port, or displays a port name. Synopsis portname [slotnumber/]portnumber [name] Description Use this command to assign or display a port name. This name is included in the portShow output;...

  • Page 541: Portperfshow

    Note: Enter commands in lowercase only; mixed case is for readability. portPerfShow portPerfShow Displays port throughput performance in bytes, kilobytes, or megabytes. Synopsis portperfshow [interval] Description Use this command to display throughput information for all ports on the switch. Data displays in 8 or 16 columns, one column per port plus one column that displays the total for these ports.

  • Page 542: Portregtest

    Note: Enter commands in lowercase only; mixed case is for readability. portRegTest portRegTest Reads and writes test of the ASIC SRAMs and registers. Synopsis portregtest [--slot slotnumber][-ports itemlist][-skiptests mask][-verbose mode] Description Use this command to verify that SRAM and register data bits in each ASIC can be independently written and read.
  • Page 543 Note: Enter commands in lowercase only; mixed case is for readability. portRegTest Examples To run a bit write/read test of the ASIC SRAMs and registers: switch:admin> portregtest -ports 1/0-1/15 Running Port Register Test ..Test Complete: "portregtest" Pass 1 of 1 Duration 0 hr, 0 min &...

  • Page 544: Portrouteshow

    Note: Enter commands in lowercase only; mixed case is for readability. portRouteShow portRouteShow Displays routing tables for the specified port. Synopsis portrouteshow [slotnumber/]portnumber Description Use this command to display the port address ID and the contents of the following port routing tables: External unicast routing Displays how the specified port forwards unicast frames to remote table...
  • Page 545 Note: Enter commands in lowercase only; mixed case is for readability. portRouteShow Examples To display the routing tables for a port: switch:user> portrouteshow 4/15 port address ID: 0x02bf00 external unicast routing table: 1: 0x4 (vc=3) 2: 0x10000 (vc=0) internal unicast routing table: 60: 0x8000 (vc=2) 63: 0x1000 (vc=5) broadcast routing table:...

  • Page 546: Portshow

    Note: Enter commands in lowercase only; mixed case is for readability. portShow portShow Displays the status of the specified port. Synopsis portshow [slot/] port portshow [arp | fciptunnel [-perf | -params | -ipsec] <all | tunnel_id> | ipif | iproute | iscsi | mode ] [slot/][ge]port Description Use this command to display general or switch- and port-specific status information for the specified...
  • Page 547 Note: Enter commands in lowercase only; mixed case is for readability. portShow No_Light Module is not receiving light. No_Sync Receiving light but out of sync. In_Sync Receiving light and in sync. Laser_Flt Module is signaling a laser fault. Port_Flt Port marked faulty. Diag_Flt Port failed diagnostics.
  • Page 548 Note: Enter commands in lowercase only; mixed case is for readability. portShow assuming the DH-CHAP passwords are configured both on the router and the edge switch, the security type is displayed as “DH_CHAP”. DH-CHAP is the only supported authentication type. DH Group If the EX_Port is connected to an edge switch with no security, then the value is “N/A”.
  • Page 549 Note: Enter commands in lowercase only; mixed case is for readability. portShow Note The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operands: Displays ARP table. Use this operand to display IP addresses, corresponding MAC addresses, and flags.
  • Page 550 Note: Enter commands in lowercase only; mixed case is for readability. portShow Examples To display the state of a port: switch:user> portshow 0 portName: portHealth: OFFLINE Authentication: None portDisableReason: None portCFlags: 0x1 portFlags: 0x4001 PRESENT U_PORT LED portType: portState: 2 Offline portPhys: No_Module...
  • Page 551 Note: Enter commands in lowercase only; mixed case is for readability. portShow To display the connection parameter information on an FCIP tunnel on a GbE port: switch:admin> portshow fciptunnel ge1 0 -params Port: ge1 ------------------------------------------- Tunnel ID 0 Remote IP Addr 192.168.255.200 Local IP Addr 192.168.255.100 Remote WWN Not Configured Local WWN 10:00:00:05:1e:35:16:b9...
  • Page 552 Note: Enter commands in lowercase only; mixed case is for readability. portShow To display the performance information on an FCIP tunnell: switch:admin> portshow fciptunnel ge1 0 -perf Port: ge1 ------------------------------------------- Tunnel ID 0 Remote IP Addr 192.168.255.200 Local IP Addr 192.168.255.100 Remote WWN Not Configured Local WWN 10:00:00:05:1e:35:16:b9 Compression on...
  • Page 553 Note: Enter commands in lowercase only; mixed case is for readability. portShow To display the connection IPSec information on an FCIP tunnel on a GbE port: switch:admin> portshow fciptunnel 8/ge0 -ipsec Port: ge0 ------------------------------------------- Tunnel ID 3 Remote IP Addr 192.175.5.200 Local IP Addr 192.175.5.100 Remote WWN Not Configured Local WWN 10:00:00:05:1e:37:00:20...
  • Page 554 Note: Enter commands in lowercase only; mixed case is for readability. portShow To display iSCSI Port WWN and Sessions: switch:admin> portshow isci 2/ge0 GE Port 2/ge0 Port WWN Sessions ----------------------------------- 50:06:06:9e:40:09:a2:00 See Also authUtil, portCfg, portCfgLongDistance, portLoginShow, portName, switchShow 2-520 Fabric OS Command Reference Manual Publication Number: 53-1000240-01...

  • Page 555: Portstats64Show

    Note: Enter commands in lowercase only; mixed case is for readability. portStats64Show portStats64Show Displays the 64-bit hardware statistics for a port. Synopsis portstats64show [slotnumber/]portnumber Description Use this command to display the following hardware statistics for a port. Two integers are reported for most values.
  • Page 556 Note: Enter commands in lowercase only; mixed case is for readability. portStats64Show Rx peak Byte rate (Bytes/sec). stat64_PRJTFrames Number of P_RJT frames transmitted. stat64_PBSYFrames Number of P_BSY transmitted. stat64_inputBuffersFull Occasions on which input buffers are full. stat64_rxClass1Frames Class 1 frames received. Note The execution of this command is subject to Admin Domain restrictions that may be in place.
  • Page 557 Note: Enter commands in lowercase only; mixed case is for readability. portStats64Show Examples To display the 64-bit hardware statistics for a port: switch:user> portstats64show 4/15 stat64_wtx top_int : 4-byte words transmitted bottom_int : 4-byte words transmitted stat64_wrx top_int : 4-byte words received 1486 bottom_int : 4-byte words receive stat64_ftx...

  • Page 558: Portstatsclear

    Note: Enter commands in lowercase only; mixed case is for readability. portStatsClear portStatsClear Clears the hardware statistics of a specified switch port. Synopsis portstatsclear [slotnumber/]portnumber Description Use this command to clear the hardware statistics for a specified port.This command also clears the hardware statistics for the associated three ports in the target port's quad, including ALPA-based CRC monitor, End-to-End monitor, and Filter-based performance monitor statistics.

  • Page 559: Portstatsshow

    Note: Enter commands in lowercase only; mixed case is for readability. portStatsShow portStatsShow Displays port hardware statistics. Synopsis portstatsshow [slotnumber/]portnumber portstatsshow [ge | ip | fcip ] [slotnumber/]geportnumber [ipaddress | tunnelnumber] Description Use this command to display port hardware statistics counters. Some counters are platform and port specific and display only with those platforms and ports.
  • Page 560 Note: Enter commands in lowercase only; mixed case is for readability. portStatsShow Class 3 frames discarded due to zone mismatch. er_zone_discard er_crc_good_eof CRC error with good EOF (platform and port specific). Invalid ARB. er_inv_arb open Number of times the FL_Port entered OPEN state. Number of times the FL_Port entered TRANSFER state.
  • Page 561 Note: Enter commands in lowercase only; mixed case is for readability. portStatsShow Examples To display the basic set of statistics for a port: switch:admin> portstatsshow 13 stat_wtx 4-byte words transmitted stat_wrx 4-byte words received stat_ftx Frames transmitted stat_frx Frames received stat_c2_frx Class 2 frames received stat_c3_frx...
  • Page 562 Note: Enter commands in lowercase only; mixed case is for readability. portStatsShow To display statistics for FCIP tunnel 2, slot 8, and GbE port 1: switch:admin> portstatsshow fcip 8/ge1 2 tunnel_id Tunnel ID fcip_ip2fc_bytes uncompressed bytes fcip_ip2fc_pkts pkt rvd by fcip entity from ip fcip_ip2fc_wantov_drop pkt dropped due to wantov fcip_fc2ip_pkts...

  • Page 563: Portswap

    Note: Enter commands in lowercase only; mixed case is for readability. portSwap portSwap Swaps area numbers of two ports. Synopsis portswap [slotnumber1/]portnumber1 [slotnumber2/]portnumber2 Description Use this command to swap area numbers for a pair of ports. Both ports must be disabled prior to executing this command and the port-swapping feature must be enabled using portSwapEnable.

  • Page 564: Portswapdisable

    Note: Enter commands in lowercase only; mixed case is for readability. portSwapDisable portSwapDisable Disables the portswap feature. Synopsis portswapdisable Description Use this command to disable the portswap feature. The portSwap command cannot be used after this feature is disabled. The enabled state of the portswap feature is persistent across reboots and power cycles. Note Enabling or disabling the portswap feature does not effect previously performed portswap operations.

  • Page 565: Portswapenable

    Note: Enter commands in lowercase only; mixed case is for readability. portSwapEnable portSwapEnable Enables the portswap feature. Synopsis portswapenable Description Use this command to enable the portswap feature. The portSwap command cannot be used unless the feature is first enabled with this command. The enabled state of the portswap feature is persistent across reboots and power cycles.

  • Page 566: Portswapshow

    Note: Enter commands in lowercase only; mixed case is for readability. portSwapShow portSwapShow Displays the state of the portswap feature. Synopsis portswapshow Description Use this command to display the enabled state of the portswap feature, as well as port and area information for those ports whose area number id different from the default area number.

  • Page 567: Porttest

    Note: Enter commands in lowercase only; mixed case is for readability. portTest portTest Performs a functional test of a switch in a live fabric. Synopsis porttest [-ports itemlist][-iteration count][-userdelay time][-timeout time][-pattern pattern] [-patsize size][-seed seed][-listtype porttype] Description Use this command to isolate problems to a single replaceable element and isolate problems to near-end terminal equipment, far-end terminal equipment, or transmission line.
  • Page 568 Note: Enter commands in lowercase only; mixed case is for readability. portTest -iteration count Specify the number of times (or number of frames per port) to execute this test. Default value is 20. Valid values include: Run the test on timeout mode. Run indefinitely.

  • Page 569: Porttestshow

    Note: Enter commands in lowercase only; mixed case is for readability. portTestShow portTestShow Displays information from portTest. Synopsis porttestshow [-ports itemlist] Description Use this command to display a snapshot of information from portTest. The following information displays: • Pass or fail information on a given port. •...
  • Page 570 Note: Enter commands in lowercase only; mixed case is for readability. portTestShow See Also crossPortTest, fportTest, loopPortTest, portLoopbackTest, portTest, spinFab, stopPortTest 2-536 Fabric OS Command Reference Manual Publication Number: 53-1000240-01...

  • Page 571: Portzoneshow

    Note: Enter commands in lowercase only; mixed case is for readability. portZoneShow portZoneShow Displays the enforced zone type of the F/FL-ports of a switch. Synopsis portzoneshow Description Use this command to display the enforced zone type of the F/FL-ports of a switch. Output shows virtual port number (decimal), physical port number (decimal), online status (and if online, port type).

  • Page 572: Powerofflistset

    Note: Enter commands in lowercase only; mixed case is for readability. powerOffListSet powerOffListSet Sets slot power-off list order. Synopsis powerofflistset Description Use this command to change the order in which slots are powered off. This command displays the current order and then prompts you to indicate the new order. Whenever a power supply goes out of service or a field-replaceable unit (FRU) is inserted, the system available power is compared to the system required power to determine if there is enough power to operate.
  • Page 573 Note: Enter commands in lowercase only; mixed case is for readability. powerOffListSet Examples To modify the power-off list order: switch:admin> powerofflistset Slot Current POL ------------------- 1st slot to be powered off: (1..10) [10] 1 2nd slot to be powered off: (2..10) [9] 2 3rd slot to be powered off: (3..10) [8] 3 4th slot to be powered off: (4..10) [7] 4 5th slot to be powered off: (7..10) [7] 10...

  • Page 574: Powerofflistshow

    Note: Enter commands in lowercase only; mixed case is for readability. powerOffListShow powerOffListShow Displays slot power-off list order. Synopsis powerofflistshow Description Use this command to display the order in which the physical slots will be powered off. The system- available power is compared to the system demand power to determine if there is enough power to operate.

  • Page 575: Psshow

    Note: Enter commands in lowercase only; mixed case is for readability. psShow psShow Displays power supply status. Synopsis psshow Description Use this command to display the current status of the switch power supplies. The status of each supply is displayed as: Power supply functioning correctly.

  • Page 576: Quietmode

    Note: Enter commands in lowercase only; mixed case is for readability. quietMode quietMode Sets or clears the telnet session quiet mode, or displays the current mode. Synopsis quietmode [mode] Description Use this command to filter the output displayed on the switch's console. Only telnet session will be suppressed.

  • Page 577: Reboot

    Note: Enter commands in lowercase only; mixed case is for readability. reboot reboot Reboots either one control processor (CP) or the entire system. Synopsis reboot Description Use this command to immediately reboot a CP in a director or an entire switch. The command line session is closed.

  • Page 578: Routehelp

    Note: Enter commands in lowercase only; mixed case is for readability. routeHelp routeHelp Displays a list of FSPF-related commands. Synopsis routehelp Description Use this command to display a list of FSPF-related commands. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 579: Savecore

    Note: Enter commands in lowercase only; mixed case is for readability. saveCore saveCore Saves or removes core files created by daemons. Synopsis To FTP core files: savecore [[-f core_file_list]... | -F][-h ipaddress][-u user_name | -a][-p password] [-d remote_directory] To remove core files: savecore [[-r core_files_list]...
  • Page 580 Note: Enter commands in lowercase only; mixed case is for readability. saveCore To remove selected core files from a CP: switch:admin> savecore -r /core_files/panic/,/core_files/zoned/,/mnt/core_files/nsd/ Removing: /core_files/panic/ Removing: /core_files/zoned/ Removing: /mnt/core_files/nsd/ To remove selected core files from the CP (using multiple -r operands): switch:admin>...
  • Page 581 Note: Enter commands in lowercase only; mixed case is for readability. saveCore To remove all core files using the savecore management utility: switch:admin> savecore following 1 directories contains core files: [ ]0: /mnt/core_files/panic Welcome to core files management utility. Menu 1(or R): Remove all core files 2(or F): FTP all core files 3(or r): Remove marked files...
  • Page 582 Note: Enter commands in lowercase only; mixed case is for readability. saveCore To remove core files from a selected directory: switch:admin> savecore following 2 directories contains core files: [ ]0: /core_files/nsd [ ]1: /core_files/zoned Welcome to core files management utility. Menu 1(or R): Remove all core files 2(or F): FTP all core files...

  • Page 583: Secactivesize

    Note: Enter commands in lowercase only; mixed case is for readability. secActiveSize secActiveSize Displays the size of the active security database. Synopsis secactivesize Description Use this command to display the size of the active security database. The maximum is 256 Kb. This command is intended strictly for debugging purposes by technical support staff.

  • Page 584: Secauthsecret

    Note: Enter commands in lowercase only; mixed case is for readability. secAuthSecret secAuthSecret Manages the DH-CHAP shared secret key information. Synopsis secauthsecret [--show] [--set] [--remove value | --all] Description Use this command to manage the DH-CHAP shared secret key database used for authentication. This command displays, sets, and removes shared secret key information from the database or deletes the entire database.
  • Page 585 Note: Enter commands in lowercase only; mixed case is for readability. secAuthSecret To set the shared secret: switch:admin>secAuthSecret --set This command sets up secret keys for the DH-CHAP authentication. The minimum length of a secret key is 8 characters and maximum 40 characters.

  • Page 586: Seccertutil

    Note: Enter commands in lowercase only; mixed case is for readability. secCertUtil secCertUtil Manages third-party PKI-based certificates in the switch. Synopsis seccertutil Description Use this command to manage third-party certificates in the switch, as follows: • Generate a public/private key pair. •...
  • Page 587 Note: Enter commands in lowercase only; mixed case is for readability. secCertUtil certificates. gencsr Generates a new CSR for the switch. This is second step for setting up third-party certificates in the switch. To generate a CSR, the admin must answer a series of questions prompted by this option.
  • Page 588 Note: Enter commands in lowercase only; mixed case is for readability. secCertUtil To generate a CSR: switch:admin> seccertutil gencsr Country Name (2 letter code, eg, US): State or Province Name (full name, eg, California): Locality Name (eg, city name): Organization Name (eg, company name): Organizational Unit Name (eg, department or section name): Common Name (Fully qualified Domain Name, or IP address): generating CSR, file name is: <ip_address>.csr...
  • Page 589 Note: Enter commands in lowercase only; mixed case is for readability. secCertUtil See Also none Fabric OS Command Reference Manual 2-555 Publication Number: 53-1000240-01...

  • Page 590: Secdefinesize

    Note: Enter commands in lowercase only; mixed case is for readability. secDefineSize secDefineSize Displays the size of the defined security database. Synopsis secdefinesize Description Use this command to display the size of the defined security database. The maximum size is 256 KB. This command is intended strictly for debugging purposes by technical support staff.

  • Page 591: Secfabricshow

    Note: Enter commands in lowercase only; mixed case is for readability. secFabricShow secFabricShow Displays security-related fabric information. Synopsis secfabricshow Description This command displays the security-related information about the fabric. The information displayed is as follows: Role Displays whether the switch is the primary FCS, backup FCS, or not FCS. Displays the World Wide Name of the switch.

  • Page 592: Secfcsfailover

    Note: Enter commands in lowercase only; mixed case is for readability. secFCSFailover secFCSFailover Enables a backup FCS switch to take over as primary FCS switch. Synopsis secfcsfailover Description Use this command to enable a backup FCS switch to take over as the primary FCS switch. After this command is issued, the primary FCS switch aborts its current transaction and moves the backup FCS switch to the top of the FCS list.

  • Page 593: Secglobalshow

    Note: Enter commands in lowercase only; mixed case is for readability. secGlobalShow secGlobalShow Displays the current internal security state information. Synopsis secglobalshow Description Use this command to display security server (secd) specific information as a snapshot of its current state. The information can include some of the following: •...
  • Page 594 Note: Enter commands in lowercase only; mixed case is for readability. secGlobalShow Examples To view the current security state: switch:admin> secglobalshow 15:22:01 1024 Recv sysmod SCN state 0x20 : Enf IP change ret 0 15:24:49 1024 RecvQ msgt 0x1, arg 0x0 scnt 0x0 subt 0x10 dom 0 p 0 time 233107 23:46:21 1024 RecvQ msgt 0x1, arg 0x0 scnt 0x0 subt 0x8 dom 1 p 0 time 1882306 23:46:21 1024 Try to remove dom 1 switch 00:00:00:00:00:00:00:00 primary phasee 0 23:51:51 8199 ACA : flag 0x20e1, tid 8199, pid 1536...

  • Page 595: Sechelp

    Note: Enter commands in lowercase only; mixed case is for readability. secHelp secHelp Displays information about security commands. Synopsis sechelp Description Use this command to display a list of security commands. Operands none Examples To display a list of security commands: switch:admin>...

  • Page 596: Secmodedisable

    Note: Enter commands in lowercase only; mixed case is for readability. secModeDisable secModeDisable Disables secure mode. Synopsis secmodedisable Description Use this command to disable secure mode on all switches in the fabric. This command deletes both the defined and active security databases. Note This command can be issued only in secure mode and only from the primary FCS switch.

  • Page 597: Secmodeenable

    Note: Enter commands in lowercase only; mixed case is for readability. secModeEnable secModeEnable Enables secure mode. Synopsis secmodeenable [--quickmode] | [[--currentpwd][--lockdown[=scc |=dcc]] [--fcs list_of_switches | list_of_switches]] Description Use this command to enable secure mode on all switches in the fabric. This command fails if any switch in the fabric is not capable of enforcing the security policies defined in the security database.
  • Page 598 Note: Enter commands in lowercase only; mixed case is for readability. secModeEnable Note Ensure that all users (using Fabric OS CLI or Web Tools) are logged off the fabric before enabling secure mode; otherwise, users on non-FCS switches lose their telnet sessions. It is recommended that a maximum of 80 WWNs be specified in the FCS policy using the secModeEnable command.
  • Page 599 Note: Enter commands in lowercase only; mixed case is for readability. secModeEnable --quickmode This option is a shorthand notation for a combination of the --currentpwd, --lockdown, and --fcs "*" options. On successful execution of the command, security is enabled in the fabric with all switches being FCS, all switches having passwords identical to that of the primary FCS and SCC, and DCC policies capturing and maintaining the current configuration of the fabric.
  • Page 600 Note: Enter commands in lowercase only; mixed case is for readability. secModeEnable Examples To enable a security policy that includes three FCS switches specified by domain, WWN address, and switch name: fcsprimary:admin> secmodeenable Your use of the certificate-based security features of the software installed on this equipment is subject to the End User License Agreement...
  • Page 601 Note: Enter commands in lowercase only; mixed case is for readability. secModeEnable To enable secure mode using --quickmode: fcsprimary:admin> secmodeenable --quickmode Your use of the certificate-based security features of the software installed on this equipment is subject to the End User License Agreement provided with the equipment and the Certification Practices Statement,...

  • Page 602: Secmodeshow

    Note: Enter commands in lowercase only; mixed case is for readability. secModeShow secModeShow Displays whether secure mode is enabled or disabled. Synopsis secmodeshow Description Use this command to display the current secure mode of the fabric. The fabric can be in secure mode or non-secure mode.

  • Page 603: Secnonfcspasswd

    Note: Enter commands in lowercase only; mixed case is for readability. secNonFCSPasswd secNonFCSPasswd Sets the admin password for non-FCS switches. Synopsis secnonfcspasswd Description Use this command to change the admin password on all non-FCS switches in the fabric. The changed passwords are persistent across reboots.

  • Page 604: Secpolicyabort

    Note: Enter commands in lowercase only; mixed case is for readability. secPolicyAbort secPolicyAbort Aborts all changes to the defined database that have not been saved. Synopsis secpolicyabort Description Use this command to abort all changes to the defined security database that have not been saved to flash memory.

  • Page 605: Secpolicyactivate

    Note: Enter commands in lowercase only; mixed case is for readability. secPolicyActivate secPolicyActivate Saves and activates the Defined Security Policy Set. Synopsis secpolicyactivate Description Use this command to activate the current defined security policy to all switches in the fabric. This will activate the policy set on local switch or all switches in the fabric depending on the fabric-wide consistentcy policy - see fddCfg...

  • Page 606: Secpolicyadd

    Note: Enter commands in lowercase only; mixed case is for readability. secPolicyAdd secPolicyAdd Adds members to an existing security policy. Synopsis secpolicyadd "name"[, "member [;member...]"] Description Use this command to add member to an existing access policy. The new members must not already be members within the policy or the command fails.
  • Page 607 Note: Enter commands in lowercase only; mixed case is for readability. secPolicyAdd capitalized like regular policy names, but they are case sensitive. When the switch is in non-secure mode this command may be used to manage only SCC and DCC policies. "member"...
  • Page 608 Note: Enter commands in lowercase only; mixed case is for readability. secPolicyAdd (1-6) Selects ports 1 through 6. Selects all ports on the switch. [3, 9] Selects ports 3 and 9 and all devices attached to those ports. [1-3, 5] Selects ports 1 through 3 and 5 and all devices attached to those ports. Selects all ports on the switch and devices currently attached to those ports.

  • Page 609: Secpolicycreate

    Note: Enter commands in lowercase only; mixed case is for readability. secPolicyCreate secPolicyCreate Creates a new security policy. Synopsis secpolicycreate "name"[, "member[;member...]"] Description Use this command to create a new policy. All policies can be created only once, except for the DCC_POLICY_nnn.
  • Page 610 Note: Enter commands in lowercase only; mixed case is for readability. secPolicyCreate The DCC_POLICY_nnn name has the common prefix DCC_POLICY_ followed by a string of user-defined characters. These characters do not have to be capitalized like regular policy names. Valid values for DCC_POLICY_nnn are user defined alphanumeric or underscore characters.
  • Page 611 Note: Enter commands in lowercase only; mixed case is for readability. secPolicyCreate can be specified using WWN, domain, or switch name. <switch> can be specified by port numbers separated by commas and enclosed in <port> either brackets or parenthesis: for example, (2, 4, 6). Ports enclosed in brackets will include the devices currently attached to those ports.
  • Page 612 Note: Enter commands in lowercase only; mixed case is for readability. secPolicyCreate sectelnet: primaryfcs:admin> secpolicycreate "TELNET_POLICY", "192.168.5.0" TELNET_POLICY has been created. primaryfcs:admin> See Also fddCfg, distribute, secPolicyAbort, secPolicyActivate, secPolicyAdd, secPolicyDelete, secPolicyDump, secPolicyRemove, secPolicySave, secStatsShow 2-578 Fabric OS Command Reference Manual Publication Number: 53-1000240-01...

  • Page 613: Secpolicydelete

    Note: Enter commands in lowercase only; mixed case is for readability. secPolicyDelete secPolicyDelete Deletes an existing security policy. Synopsis secpolicydelete "name" Description Use this command to delete an existing defined policy. Each policy corresponds to a management method. The list of members of a policy acts as an access control list for that management method.
  • Page 614 Note: Enter commands in lowercase only; mixed case is for readability. secPolicyDelete Note After security policy is deleted, fabric-wide switch access through that method is unrestricted. Examples To delete an existing security policy: switch:admin> secpolicydelete "MS_POLICY" About to delete policy MS_POLICY. Are you sure (yes, y, no, n):[no] y MS_POLICY has been deleted.

  • Page 615: Secpolicydump

    Note: Enter commands in lowercase only; mixed case is for readability. secPolicyDump secPolicyDump Displays all members of existing security policies. Synopsis secpolicydump ["listtype"][, "name"] Description Use this command to display, without page breaks, the members of an existing policy in the active and defined (saved) databases.
  • Page 616 Note: Enter commands in lowercase only; mixed case is for readability. secPolicyDump Examples To display all security policy information from all databases (active, updating, and defined), without page breaks: primaryfcs:admin> secpolicydump ____________________________________________________ DEFINED POLICY SET FCS_POLICY Primary WWN DId swName __________________________________________________ 10:00:00:60:69:30:15:5c 1 primaryfcs...

  • Page 617: Secpolicyfcsmove

    Note: Enter commands in lowercase only; mixed case is for readability. secPolicyFCSMove secPolicyFCSMove Moves a member in the FCS policy. Synopsis secpolicyfcsmove [from, to] Description Use this command to move an FCS member from one position to another in the FCS list. Only one FCS can be moved at a time.

  • Page 618: Secpolicyremove

    Note: Enter commands in lowercase only; mixed case is for readability. secPolicyRemove secPolicyRemove Removes members from an existing policy. Synopsis secpolicyremove "name"[, "member [;member]"] Description Use this command to remove members from an existing security policy. If a policy is empty after removing all members, all accesses to the policy are disallowed (the DCC_POLICY and OPTIONS_POLICY are exceptions).
  • Page 619 Note: Enter commands in lowercase only; mixed case is for readability. secPolicyRemove IP Address Member Policy Types The following policy types require members be specified by IP address: • TELNET_POLICY • HTTP_POLICY • API_POLICY • RSNMP_POLICY • WSNMP_POLICY These policy types require member IDs in dot notation (for example, 124.23.56.122).
  • Page 620 Note: Enter commands in lowercase only; mixed case is for readability. secPolicyRemove OPTIONS_POLICY members "NoNodeWWNZoning" is the only option. Examples To remove a member that has a WWN of 12:24:45:10:0a:67:00:40 from MS policy: switch:admin> secpolicyremove "MS_POLICY", "12:24:45:10:0a:67:00:40" Member(s) have been removed from MS_POLICY. See Also secPolicyAbort, secPolicyActivate, secPolicyAdd, secPolicyCreate, secPolicyDelete, secPolicyDump, secPolicySave,...

  • Page 621: Secpolicysave

    Note: Enter commands in lowercase only; mixed case is for readability. secPolicySave secPolicySave Saves a defined security policy to flash memory on all switches in the fabric. Synopsis secpolicysave Description Use this command to save a defined security policy to flash memory of all switches in the fabric. Note When secure mode is enabled, this command saves defined security policy to persistent memory on all switches in the fabric and can be issued only from the primary FCS switch.

  • Page 622: Secpolicyshow

    Note: Enter commands in lowercase only; mixed case is for readability. secPolicyShow secPolicyShow Displays an existing security policy. Synopsis secpolicyshow ["policy_set"[", name"]] Description Use this command to display the members of an existing policy in the Active or Defined security policy set.
  • Page 623 Note: Enter commands in lowercase only; mixed case is for readability. secPolicyShow Examples To display all security policies from active databases: switch:admin> secpolicyshow "active" ____________________________________________________ ACTIVE POLICY SET FCS_POLICY Primary WWN DId swName __________________________________________________ 10:00:00:60:69:30:15:5c 1 primaryfcs HTTP_POLICY IpAddr __________________________________________________ 192.155.52.0 ____________________________________________________ To display all security policies from defined databases:...

  • Page 624: Secstatsreset

    Note: Enter commands in lowercase only; mixed case is for readability. secStatsReset secStatsReset Resets one or all security statistics to 0. Synopsis secstatsreset ["name"][,"list"] Description Use this command to reset one or all security statistics to 0. This command can be issued to any switch. If issued on the primary FCS switch, this command can reset security statistics for any or all switches in the fabric.
  • Page 625 Note: Enter commands in lowercase only; mixed case is for readability. secStatsReset This operand is optional and the default is all statistics. If the list operand is specified, this operand is required. "list" Specify a list of domain IDs on which to reset the security statistics. Specify an asterisk (*) to represent all switches in the fabric or specify a list of domains, separated by semicolons.

  • Page 626: Secstatsshow

    Note: Enter commands in lowercase only; mixed case is for readability. secStatsShow secStatsShow Displays one or all security statistics. Synopsis secstatsshow ["name"[, "list"]] Description Use this command to display one or all security statistics. This command can be issued to any switch. If issued on the primary FCS switch, this command can retrieve and display the security statistics for any or all switches in the fabric.
  • Page 627 Note: Enter commands in lowercase only; mixed case is for readability. secStatsShow • INCOMP_DB • ILLEGAL_CMD The specified policy name must be all capitalized. To access DCC policies, enter DCC_POLICY. Violations are not tracked for individual DCC policies. The statistics for all DCC_POLICY violations are grouped together.

  • Page 628: Sectemppasswdreset

    Note: Enter commands in lowercase only; mixed case is for readability. secTempPasswdReset secTempPasswdReset Resets a temporary password on a remote switch. Synopsis sectemppasswdreset [domain[, "login_name"]] Description Use this command to remove temporary passwords that were set up using secTempPasswdSet command. If a login name is not supplied, all passwords on the switch identified by the specified domain are refreshed.

  • Page 629: Sectemppasswdset

    Note: Enter commands in lowercase only; mixed case is for readability. secTempPasswdSet secTempPasswdSet Sets a temporary password on a remote switch. Synopsis sectemppasswdset domain, "login_name" Description Use this command to set a unique temporary password for a given account on a specific switch in the fabric.

  • Page 630: Sectransabort

    Note: Enter commands in lowercase only; mixed case is for readability. secTransAbort secTransAbort Aborts current security transaction. Synopsis sectransabort Description Use this command to abort the current transaction. This command is used to recover from management application problems. This command aborts all current changes that have not been committed or activated.

  • Page 631: Secversionreset

    Note: Enter commands in lowercase only; mixed case is for readability. secVersionReset secVersionReset Resets the security version stamp to 0. Synopsis secversionreset Description Use this command to reset the security version stamp of all switches in a fabric to 0, so that it can be joined to another secure fabric.

  • Page 632: Sensorshow

    Note: Enter commands in lowercase only; mixed case is for readability. sensorShow sensorShow Displays sensor readings. Synopsis sensorshow Description Use this command to display the current temperature, fan, and power supply status and readings from sensors located on the switch. The actual location of the sensors varies, depending on the switch type. Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 633: Setdbg

    Note: Enter commands in lowercase only; mixed case is for readability. setDbg setDbg Sets debug level of the specified module. Synopsis setdbg [module_name][level] Description Use this command to set the debug level of a specified module. Debug levels filter the display of debug messages to the serial console.

  • Page 634: Setesdmode

    Note: Enter commands in lowercase only; mixed case is for readability. setEsdMode setEsdMode Enables or disables ESD mode. Synopsis setesdmode [mode | -show] Description Use this command to enable or disable ESD mode. The mode is saved in flash memory and stays in that mode until the next execution of setEsdMode.

  • Page 635: Setgbicmode

    Note: Enter commands in lowercase only; mixed case is for readability. setGbicMode setGbicMode Enables or disables media mode. Synopsis setgbicmode [mode | -show] Description Use this command to enable GBIC media mode if the mode value is nonzero and disable the media mode if the mode value is 0.

  • Page 636: Setmediamode

    Note: Enter commands in lowercase only; mixed case is for readability. setMediaMode setMediaMode Enables or disables media mode. Synopsis setmediamode [mode | -show] Description Use this command to enable media mode if the mode value is nonzero and disable the media mode if the mode value is 0.

  • Page 637: Setmodem

    Note: Enter commands in lowercase only; mixed case is for readability. setModem setModem Enables or disables modem dial-in to a control processor (CP). Synopsis setmodem [-e] | [-d] Description Use this command to enable or disable modem dial-in to a CP on those systems that support modem dial- in.
  • Page 638 Note: Enter commands in lowercase only; mixed case is for readability. setModem RJ-11 "Y" Adapter Optional Handset co Line Note: Modem power connections not shown DB-25M to DB-9F Modem Cable (one per CP Card) POWER SUPPLY 4 Modem Port on CP Card (one per CP Card;...

  • Page 639: Setsfpmode

    Note: Enter commands in lowercase only; mixed case is for readability. setSfpMode setSfpMode Enables or disables media mode. Synopsis setsfpmode [mode | -show] Description Use this command to enable SFP media mode if the mode value is nonzero and disable the media mode if the mode value is 0.

  • Page 640: Setsplbmode

    Note: Enter commands in lowercase only; mixed case is for readability. setSplbMode setSplbMode Sets or displays single port loopback (SPLB) mode. Synopsis setsplbmode [mode | -show] Description Use this command to enable MFG mode if mode is a nonzero, and disable SPLB mode if mode is 0. The mode is saved in flash memory and stays in that mode until the next execution of setSplbMode.

  • Page 641: Setverbose

    Note: Enter commands in lowercase only; mixed case is for readability. setVerbose setVerbose Specifies module verbose level. Synopsis setverbose [module_name][level] Description Use this command to set the verbose level of the specified module. These levels filter the display of the debug message to the serial console.

  • Page 642: Sfpshow

    Note: Enter commands in lowercase only; mixed case is for readability. sfpShow sfpShow Displays Small Form-factor Pluggable SFP information. Synopsis sfpshow [[slotnumber/]geportnumber | -all] Description Use this command to display information about Serial Identification SFPs (also known as module definition "4" SFPs). These SFPs provide extended information that describes the SFP’s capabilities, interfaces, manufacturer, and other information.
  • Page 643 Note: Enter commands in lowercase only; mixed case is for readability. sfpShow Examples To display SFP summary information: switch:user> sfpshow Area 0: id (id) Vendor: Serial No: Area 1: id (sw) Vendor: FINISAR CORP. Serial No: H1149T2 Area 2: id (sw) Vendor: FINISAR CORP. Serial No: H112TUD Area 3: id (sw) Vendor: FINISAR CORP.
  • Page 644 Note: Enter commands in lowercase only; mixed case is for readability. sfpShow To display detailed information for GbE port 0 on a Silkworm 7500: switch:admin> sfpshow ge0 Identifier: Connector: Transceiver: 050c402000000000 100,200_MB/s M5,M6 sw Inter_dist Encoding: 8B10B Baud Rate: (units 100 megabaud) Length 9u: (units km) Length 9u:...
  • Page 645 Note: Enter commands in lowercase only; mixed case is for readability. sfpShow To display all SFP information: switch:user> sfpshow -all ============= Port ============= Identifier: Connector: Transceiver: 050c402000000000 100,200_MB/s M5,M6 sw Inter_dist Encoding: 8B10B Baud Rate: (units 100 megabaud) Length 9u: (units km) Length 9u: (units 100 meters)

  • Page 646: Shellflowcontroldisable

    Note: Enter commands in lowercase only; mixed case is for readability. shellFlowControlDisable shellFlowControlDisable Disables XON/XOFF flow control on the console serial ports. Synopsis shellflowcontroldisable Description Use this command to disable XON/XOFF flow control on the console serial ports. Flow control is disabled by default.

  • Page 647: Shellflowcontrolenable

    Note: Enter commands in lowercase only; mixed case is for readability. shellFlowControlEnable shellFlowControlEnable Enables XON/XOFF flow control on the console serial port. Synopsis shellflowcontrolenable Description Use this command to enable XON/XOFF flow control to the shell task. Flow control is disabled by default.

  • Page 648: Slotoff

    Note: Enter commands in lowercase only; mixed case is for readability. slotOff slotOff Not supported on this platform - use slotPowerOff. Description This command is not supported on this platform as of FOS 5.1 - use slotPowerOff. Note The execution of this command is subject to Admin Domain restrictions that may be in place. See Also slotShow, slotPowerOff, bladeDisable...

  • Page 649: Sloton

    Note: Enter commands in lowercase only; mixed case is for readability. slotOn slotOn Not supported on this platform - use slotPowerOn. Description This command is not supported on this platform as of FOS 5.1 - use slotPowerOn. Note The execution of this command is subject to Admin Domain restrictions that may be in place. See Also slotShow, slotPowerOn, bladeEnable...

  • Page 650: Slotpoweroff

    Note: Enter commands in lowercase only; mixed case is for readability. slotPowerOff slotPowerOff Removes power from a slot. Synopsis slotpoweroff slotnumber Description Use this command to turn off the power to a blade unit. The slot must have a valid blade unit present and the blade unit must be of a type that can be powered off.

  • Page 651: Slotpoweron

    Note: Enter commands in lowercase only; mixed case is for readability. slotPowerOn slotPowerOn Restores power to a slot. Synopsis slotpoweron slotnumber Description Use this command to turn on the power to a blade unit. The slot must have a valid blade unit present and the blade unit must be currently powered off.

  • Page 652: Slotshow

    Note: Enter commands in lowercase only; mixed case is for readability. slotShow slotShow Displays the status of all slots in the system. Synopsis slotshow Description Use this command to inventory and display the current status of each slot in the system. The fields and their possible values are as follows: Slot Displays the physical slot number.
  • Page 653 Note: Enter commands in lowercase only; mixed case is for readability. slotShow The blade is present, powered on, and running the preboot power on self tests). • INITIALIZING The blade is present, powered on, and initializing hardware components. • ENABLED The blade is on and enabled.

  • Page 654: Sltest

    Note: Enter commands in lowercase only; mixed case is for readability. slTest slTest Tests the serial link of port N->N path. Synopsis sltest [-ports itemlist][ -lb_mode mode][-speed mode][-passcnt count] Description Use this command to verify the intended functional operation of the switch by sending SERDES BIST patterns from port N's transmitter, and looping the patterns back into the same port N's receiver.
  • Page 655 Note: Enter commands in lowercase only; mixed case is for readability. slTest -ports itemlist Specifies a list of blade ports to test. By default, all the blade ports in the specified slot (--slot) is used. -passcnt count Specifies the number of test repetitions. By default, the test runs once. Refer to itemList for further details.

  • Page 656: Snmpconfig

    Note: Enter commands in lowercase only; mixed case is for readability. snmpConfig snmpConfig Manages the SNMP agent configuration. Synopsis snmpConfig --show | --set | --default [snmpv1 | snmpv3 | accessControl | mibCapability | system- Group] Description Use this command to manage the configuration of the SNMP agent in the switch. The configuration includes SNMPv1 and SNMPv3 configuration, access control list (ACL), MIB capability, and system group.
  • Page 657 Note: Enter commands in lowercase only; mixed case is for readability. snmpConfig • Error • Warning • Informational • Debug SNMPv3 Configuration Parameters Two user roles, snmpadmin and snmpuser are supported. snmpadmin provides read-write access and snmpuser provides read-only access. Entries are added to USM table corresponding to each role. Total of three entries of role snmpadmin and three entries of role snmpuser are supported.
  • Page 658 Note: Enter commands in lowercase only; mixed case is for readability. snmpConfig accessControl Configuration Parameters The ACL check is as follows: there are six ACLs to restrict SNMP get/set/trap operations to hosts under a host-subnet-area. Host-subnet-area is defined by comparing nonzero IP octets. For example, an ACL of 192.168.64.0 enables access by any hosts that start with the specified octets.
  • Page 659 Note: Enter commands in lowercase only; mixed case is for readability. snmpConfig HA-TRAP Specifying yes means the SNMP management application can receive HA traps from the switch. The default value is 'yes'. Users can also turn on or off individual HA Traps.
  • Page 660 Note: Enter commands in lowercase only; mixed case is for readability. snmpConfig Examples To set the SNMPv1 configuration: switch:admin> snmpconfig --set snmpv1 SNMP community and trap recipient configuration: Community (rw): [Secret C0de] admin Trap Recipient's IP address in dot notation: [0.0.0.0] 10.32.225.1 Trap recipient Severity level : (0..5) [0] 1 Community (rw): [OrigEquipMfr] Trap Recipient's IP address in dot notation: [10.32.225.2]...
  • Page 661 Note: Enter commands in lowercase only; mixed case is for readability. snmpConfig To change the SNMPv3 configuration: switch:admin> snmpconfig --set snmpv3 SNMPv3 user configuration: User (rw): [snmpadmin1] adminuser Auth Protocol [MD5(1)/SHA(2)/noAuth(3)]: (1..3) [3] 1 New Auth Passwd: Verify Auth Passwd: Priv Protocol [DES(1)/noPriv[2]): (1..2) [2] 1 New Priv Passwd: Verify Priv Passwd:...
  • Page 662 Note: Enter commands in lowercase only; mixed case is for readability. snmpConfig To set the accessControl configuration: switch:admin> snmpconfig --set accessControl SNMP access list configuration: Access host subnet area in dot notation: [0.0.0.0] 192.168.0.0 Read/Write? (true, t, false, f): [true] Access host subnet area in dot notation: [0.0.0.0] 10.32.148.0 Read/Write? (true, t, false, f): [true] f Access host subnet area in dot notation: [0.0.0.0]...

  • Page 663: Snmpmibcapset

    Note: Enter commands in lowercase only; mixed case is for readability. snmpMibCapSet snmpMibCapSet Modifies options for configuring SNMP MIB trap capability. Synopsis snmpmibcapset Description This command enables a user to turn on or off certain MIBs and traps. This command also enables a user to turn on or off group information and SSN in SW trap messages.
  • Page 664 Note: Enter commands in lowercase only; mixed case is for readability. snmpMibCapSet Examples To view or modify the options for configuring SNMP MIB traps: switch:admin> snmpmibcapset The SNMP Mib/Trap Capability has been set to support FE-MIB SW-MIB FA-MIB FICON-MIB HA-MIB SW-TRAP swFCPortScn swFabricWatchTrap...

  • Page 665: Snmpmibcapshow

    Note: Enter commands in lowercase only; mixed case is for readability. snmpMibCapShow snmpMibCapShow Displays options for configuring SNMP MIB trap capability. Synopsis snmpmibcapshow Description Use this command to display the SNMP MIBs and traps capability of the SNMP agent in the switch. FA-MIB Specifying yes means the user can access FA-MIB variables with an SNMP manager.
  • Page 666 Note: Enter commands in lowercase only; mixed case is for readability. snmpMibCapShow Note agtCfgDefault also resets the SNMP MIB and trap capability to default along with other SNMP agent configuration. The values can be changed, if user download the configuration data through configDownload command.

  • Page 667: Spinfab

    Note: Enter commands in lowercase only; mixed case is for readability. spinFab spinFab Runs functional test of switch-to-switch ISL cabling and trunk group operation. Synopsis spinfab [-nmegs count][-ports itemlist][-setfail mode] Description Use this command to verify the intended functional operation of the ISL links between switches. At the maximum speed of 4 Gbit/sec, set the routing hardware such that test frames received by each E_Port retransmit on the same E_Port.
  • Page 668 Note: Enter commands in lowercase only; mixed case is for readability. spinFab to FAILED. This parameter is provided to force the failing ports to be marked as FAILED in the same manner as other diagnostics. In test or qualification environments without live traffic, this might be useful with large values of -nmegs count.

  • Page 669: Spinjitter

    Note: Enter commands in lowercase only; mixed case is for readability. spinJitter spinJitter Measures line-speed jitter. Synopsis spinjitter [--slot number][-nmegs count][-lb_mode mode][-spd_mode mode][-ports itemlist] Description This test uses the same procedures as spinsilk but with a special pattern for line-speed jitter measurement. The test uses the following pattern: jCRPAT be d7 23 47 6b 8f b3 14 5e fb 35 59 be d7 23 47...
  • Page 670 Note: Enter commands in lowercase only; mixed case is for readability. spinJitter Gbit/sec. Set all even ports' speed for autonegotiate. Set all odd ports' speed for 2 Gbit/sec. Set all odd ports' speed for autonegotiate. Set all even ports' speed for 1 Gbit/sec.
  • Page 671 Note: Enter commands in lowercase only; mixed case is for readability. spinJitter ERR_STAT_2LONG ERR_STAT_BADEOF ERR_STAT_BADOS ERR_STAT_C3DISC ERR_STAT_CRC ERR_STAT_ENCIN ERR_STAT_ENCOUT ERR_STAT_TRUNC FDET_PERR FINISH_MSG_ERR FTPRT_STATUS_ERR INIT LESSN_STATUS_ERR MBUF_STATE_ERR MBUF_STATUS_ERR NO_SEGMENT PORT_ABSENT PORT_DIED PORT_ENABLE PORT_M2M PORT_STOPPED PORT_WRONG RXQ_FRAME_ERR RXQ_RAM_PERR STATS STATS_C3FRX STATS_FRX STATS_FTX TIMEOUT XMIT Refer to the Fabric OS Message Reference for more information.

  • Page 672: Spinsilk

    Note: Enter commands in lowercase only; mixed case is for readability. spinSilk spinSilk Performs a functional test of internal and external transmit and receive paths. Synopsis spinsilk [-nmegs count][-lb_mode mode][-spd_mode mode][-verbose mode][-ports itemlist] Description Use this command to verify the intended functional operation of the switch, at the selected speed, by configuring the routing hardware so that frames received by port M are retransmitted by way of port N.
  • Page 673 Note: Enter commands in lowercase only; mixed case is for readability. spinSilk • 512 bytes of RDRAM_PAT The partner port N eventually sends four similar frames, as follows: • 2112 bytes of BYTE_LFSR • 928 bytes of CSPAT • 200 bytes of RANDOM •...
  • Page 674 Note: Enter commands in lowercase only; mixed case is for readability. spinSilk -spd_mode mode Specify the speed mode for the test. This parameter is used only for Bloom and Condor ASIC-based products, where it controls the speed at which each port is operated.
  • Page 675 Note: Enter commands in lowercase only; mixed case is for readability. spinSilk Examples To perform a functional test on selected ports: switch:admin> spinsilk -ports 1/0 - 1/2 Running Spin Silk ..... One moment please ...Ports Segmented (0) switchName: switch switchType: 10.1 switchState: Offline...
  • Page 676 Note: Enter commands in lowercase only; mixed case is for readability. spinSilk RXQ_RAM_PERR STATS STATS_C3FRX STATS_FRX STATS_FTX TIMEOUT XMIT Refer to the Fabric OS Message Reference for more information. See Also backport, camTest, centralMemoryTest, cmemRetentionTest, cmiTest, crossPortTest, itemList, portLoopbackTest, portRegTest, spinJitter, sramRetentionTest 2-642 Fabric OS Command Reference Manual...

  • Page 677: Sramretentiontest

    Note: Enter commands in lowercase only; mixed case is for readability. sramRetentionTest sramRetentionTest Performs a data retention test of the miscellaneous SRAMs in ASIC. Synopsis sramretentiontest [--slot slotnumber][-passcnt count][-ports itemlist][-skip bitmask][-delay value] Description Use this command to verify that data written into the miscellaneous SRAMs in the ASIC are retained after a 10-second wait.
  • Page 678 Note: Enter commands in lowercase only; mixed case is for readability. sramRetentionTest Examples To run a data retention test: switch:admin> sramretentiontest 2 Running SRAM Retention Test ... passed. Diagnostics Following are the possible error messages if failures are detected: BUS_TIMEOUT REGERR REGERR_UNRST Refer to the Fabric OS Message Reference for more information.

  • Page 679: Statsclear

    Note: Enter commands in lowercase only; mixed case is for readability. statsClear statsClear Clears port and diagnostic statistics. Synopsis statsclear [--slot slotnumber][-uports itemlist][-bports itemlist][-use_bports value] Description Use this command to clear the port and diagnostics statistics for the specified list of blade or user ports. Note You can issue this command on the FR4-18i blade in a SilkWorm chassis;...

  • Page 680: Statstest

    Note: Enter commands in lowercase only; mixed case is for readability. statsTest statsTest Runs a statistics counter diagnostic test. Synopsis statstest [-passcnt count][-ports itemlist] Description Use this command to verify the ASIC statistics counter logic. It can run on every base port of the quadrant and send the frame through internal loopback with no CRC data to induce the CRC error.
  • Page 681 Note: Enter commands in lowercase only; mixed case is for readability. statsTest Diagnostics When it detects failures, the subtest reports one or more of the following error messages: DIAG-STSINIT DIAG-STSNULL DIAG-STSSID DIAG-STSXMIT DIAG-STSRCV DIAG-STSFRMCNT DIAG-STSWRDCNT DIAG-STSALPACNT Refer to the Fabric OS Message Reference for more information. See Also camTest, itemList...

  • Page 682: Stopporttest

    Note: Enter commands in lowercase only; mixed case is for readability. stopPortTest stopPortTest Terminates the running portTest. Synopsis stopporttest [-ports itemlist] Description Use this command to stop the currently running portTest. Refer to the portTest command for more information. portTest is running on a non-singlemode, use stopPortTest to stop the test.

  • Page 683: Supportffdc

    Note: Enter commands in lowercase only; mixed case is for readability. supportFfdc supportFfdc Modifies or displays first-fault data capture (FFDC) daemon. Synopsis supportffdc [--disable | --enable | --show] Description Use this command to disable or enable the FFDC events, or display the current configuration. If disabled, the daemon does not capture any data even when a message with FFDC attributes is logged.

  • Page 684: Supportftp

    Note: Enter commands in lowercase only; mixed case is for readability. supportFtp supportFtp Sets, clears, or displays support FTP parameters, or a time interval to check the FTP server. Synopsis supportftp [-S] supportftp -s [-h hostip][-u username][-p password][-d remotedirectory] supportftp -t hours supportftp -R Description Use this command to set, clear, or display support FTP parameters, or a time interval to check the FTP...
  • Page 685 Note: Enter commands in lowercase only; mixed case is for readability. supportFtp Examples To set the FTP parameters: switch:admin> supportftp -s -h 192.168.67.126 -u anonymous -d tracedump supportftp: ftp parameters changed. To display a time interval to check the FTP server: switch:admin>...

  • Page 686: Supportsave

    Note: Enter commands in lowercase only; mixed case is for readability. supportSave supportSave Saves support information for RASLOG, TRACE, and supportShow. Synopsis supportsave [-n][-c][-u user_name -p password] -h host_ip -d remote_dir [-R] Description Use this command to save RASLOG, TRACE, and supportShow, core file, FFDC data, and other support information to a remote FTP location.
  • Page 687 Note: Enter commands in lowercase only; mixed case is for readability. supportSave Examples To save RASLOG, TRACE, supportShow, and other support information to a FTP server in non- interactive mode: switch:admin> supportsave -n -u admin -p pass -h 192.168.1.1 -d tmp Saving support information for switch:routing1, module:RASLOG...
  • Page 688 Note: Enter commands in lowercase only; mixed case is for readability. supportSave To save RASLOG, TRACE, and supportShow , core file, FFDC data, and other information to a FTP server in interactive mode on a dual-CP system: switch:admin> supportsave This command will collect RASLOG, TRACE, supportShow, core file, FFDC data and other support information and then transfer them to a FTP server.

  • Page 689: Supportshow

    Note: Enter commands in lowercase only; mixed case is for readability. supportShow supportShow Displays switch information for debugging purposes. Synopsis supportshow [[slotnumber/]portnumber1-portnumber2] [lines] Description Use this command to display support information from groups of preselected Fabric OS and Linux commands. You can specify the range of ports for which this information displays. These commands are organized by groups, but note that the order of the groups listed next is not the same as executed by the command.
  • Page 690 Note: Enter commands in lowercase only; mixed case is for readability. supportShow • trunkShow • topologyShow • lsDbShow • ess show • fabStateShow • fabStatsShow • fabSwitchShow • fabPortShow • fspfShow • nbrStateShow • fcpLogShow • zone stateshow • portZoneShow •...
  • Page 691 Note: Enter commands in lowercase only; mixed case is for readability. supportShow • secPolicyDump • secPolicyShow • secStatsShow • network (ENABLED by default) • bootenv • • • ifconfig • route • hostname • portlog (ENABLED by default) • portLogDump •...
  • Page 692 Note: Enter commands in lowercase only; mixed case is for readability. supportShow • fwAlarmsFilterShow • chassisShow • timeout • historyShow • portSwapShow • configShow • extend (DISABLED by default) • buffers (per-port) • credits (per-port) • data (per-port) • phantom (per-port) •...
  • Page 693 Note: Enter commands in lowercase only; mixed case is for readability. supportShow • fcrResourceShow • FCIP (DISABLED by default) • portShow fciptunnel ge$k all • portShow fciptunnel $1/ge$k all Note The execution of this command is subject to Admin Domain restrictions that may be in place. Fabric OS Command Reference Manual 2-659 Publication Number: 53-1000240-01...
  • Page 694 Note: Enter commands in lowercase only; mixed case is for readability. supportShow Operands This command has the following operands: slotnumber/portnumber1-portnumber2 Specify the range of ports to display. If the slotnumber/portnumber parameter is omitted, all ports in the switch display in the per-port outputs. The slotnumber must be provided when specifying a range of ports on multi-bladed products.

  • Page 695: Supportshowcfgdisable

    Note: Enter commands in lowercase only; mixed case is for readability. supportShowCfgDisable supportShowCfgDisable Disables a group of commands under the supportShow command. Synopsis supportshowcfgdisable [os | exception | port | fabric | services | security | network | portlog | syste- mextend | filter | perfmon | ficon] Description Use this command to disable a group of commands under the...

  • Page 696: Supportshowcfgenable

    Note: Enter commands in lowercase only; mixed case is for readability. supportShowCfgEnable supportShowCfgEnable Enables a group of commands under the supportShow command. Synopsis supportshowcfgenable [os | exception | port | fabric | services | security | network | portlog | system | extend | filter | perfmon | ficon] Description Use this command to enable a group of commands under the...

  • Page 697: Supportshowcfgshow

    Note: Enter commands in lowercase only; mixed case is for readability. supportShowCfgShow supportShowCfgShow Displays the groups of commands enabled for display by the supportShow command. Synopsis supportshowcfgshow Description Use this command to display the groups of commands enabled for display by the supportShow command.

  • Page 698: Switchbeacon

    Note: Enter commands in lowercase only; mixed case is for readability. switchBeacon switchBeacon Sets switch beaconing mode on or off. Synopsis switchbeacon [mode] Description Use this command to enable or disable switch beaconing mode. When beaconing mode is turned on, the port LEDs flash amber, left to right and right to left, from port 0 to the highest port number and back to port 0.

  • Page 699: Switchcfgpersistentdisable

    Note: Enter commands in lowercase only; mixed case is for readability. switchCfgPersistentDisable switchCfgPersistentDisable Disables a switch persistently. Synopsis switchcfgpersistentdisable Description Use this command to persistently disable the switch. All Fibre Channel ports are taken offline. If the switch was part of a fabric, the remaining switches reconfigure. The switch remains disabled even after a reboot.

  • Page 700: Switchcfgpersistentenable

    Note: Enter commands in lowercase only; mixed case is for readability. switchCfgPersistentEnable switchCfgPersistentEnable Enables a switch persistently. Synopsis switchcfgpersistentenable Description Use this command to persistently enable the switch. All Fibre Channel ports which did not fail power-on self-test (POST) are enabled, and can come online if connected to a device, or remain offline if disconnected.

  • Page 701: Switchcfgspeed

    Note: Enter commands in lowercase only; mixed case is for readability. switchCfgSpeed switchCfgSpeed Configures all ports of a switch to a particular speed. Synopsis switchcfgspeed speed_level Description Use this command to configure the speed of all the ports on a switch to a particular level. The configuration is saved in flash memory and persists across switch reboots or power cycles.

  • Page 702: Switchcfgtrunk

    Note: Enter commands in lowercase only; mixed case is for readability. switchCfgTrunk switchCfgTrunk Enables or disables trunking on all the ports of a switch. Synopsis switchcfgtrunk mode Description Use this command to enable or disable trunking on all the ports of a switch. Note This command requires the Brocade ISL Trunking license.

  • Page 703: Switchdisable

    Note: Enter commands in lowercase only; mixed case is for readability. switchDisable switchDisable Disables the switch. Synopsis switchdisable Description Use this command to disable the switch. All Fibre Channel ports are taken offline; if the switch was part of a fabric, the remaining switches reconfigure. The switch must be disabled before making configuration changes (using configure or configDefault)

  • Page 704: Switchenable

    Note: Enter commands in lowercase only; mixed case is for readability. switchEnable switchEnable Enables the switch. Synopsis switchenable Description Use this command to enable the switch. All Fibre Channel ports that passed POST are enabled. They can come online if connected to a device, or will remain offline if disconnected. Use switchEnable if you disable the switch to make configuration changes or to run diagnostics.

  • Page 705: Switchname

    Note: Enter commands in lowercase only; mixed case is for readability. switchName switchName Displays or sets the switch name. Synopsis switchname [name] Description Use this command to display or set the switch name. All switches have a symbolic name that is primarily used for switch management.

  • Page 706: Switchreboot

    Note: Enter commands in lowercase only; mixed case is for readability. switchReboot switchReboot Halts and reboots the operational switch. Synopsis switchreboot Description This command reboots the operational switch without disrupting the other switch in a dual-switch chassis. This command is equal to running switchShutdown and switchStart.

  • Page 707: Switchshow

    Note: Enter commands in lowercase only; mixed case is for readability. switchShow switchShow Displays switch and port status. Synopsis switchshow [-portcount] [-scsi] Description Use this command to display switch and port status information. Information might vary by switch model: for instance, number of ports and domain ID values. Note For all Bloom and Bloom 2-based platforms, private device targets are displayed in switchShow.
  • Page 708 Note: Enter commands in lowercase only; mixed case is for readability. switchShow shortwave laser longwave laser copper serial ID Speed The speed of the port: 1/8G 125 Mbit/sec 1/4G 250 Mbit/sec 1/2G 500 Mbit/sec 1 Gbit/sec fixed transfer speed 1 Gbit/sec negotiated transfer speed 2 Gbit/sec fixed transfer speed 2 Gbit/sec negotiated transfer speed 4 Gbit/sec fixed transfer speed...
  • Page 709 Note: Enter commands in lowercase only; mixed case is for readability. switchShow Testing Running diagnostics. Offline Connection not established (for virtual ports only). Online Port is up and running. Proto Protocol support by GbE port. ISCSI Ports support ISCSI. FCIP Ports support FCIP.
  • Page 710 Note: Enter commands in lowercase only; mixed case is for readability. switchShow If a port is configured as a long distance port, the long distance level is displayed in the format of Lx, where x represents the long distance level number. Refer to portCfgLongDistance for more information.
  • Page 711 Note: Enter commands in lowercase only; mixed case is for readability. switchShow To display GE ports with iSCSI sessions: san116:user> switchshow -iscsi Ports of Slot 1 ge0 ge1 ge2 ge3 ge4 ge5 ge6 ge7 -----------------+---+---+---+---+-----+---+---+--- Sessions Fabric OS Command Reference Manual 2-677 Publication Number: 53-1000240-01...
  • Page 712 Note: Enter commands in lowercase only; mixed case is for readability. switchShow To display switch information: top_4a3_a10:root> switchshow switchName: top_4a3_a10 switchType: 42.1 switchState: Online switchMode: Native switchRole: Subordinate switchDomain: switchId: fffc03 switchWwn: 10:00:00:60:69:e2:09:be AD Feature: Not Active Current AD: zoning: ON (bot_cfg) switchBeacon: blade4 Beacon:...

  • Page 713: Switchshutdown

    Note: Enter commands in lowercase only; mixed case is for readability. switchShutdown switchShutdown Not supported on this platform. Synopsis switchshutdown Description This command is not supported on this platform as of FOS 5.1. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Fabric OS Command Reference Manual 2-679 Publication Number: 53-1000240-01...

  • Page 714: Switchstart

    Note: Enter commands in lowercase only; mixed case is for readability. switchStart switchStart Not supported on this platform as of Fabric OS 5.1. 2-680 Fabric OS Command Reference Manual Publication Number: 53-1000240-01...

  • Page 715: Switchstatuspolicyset

    Note: Enter commands in lowercase only; mixed case is for readability. switchStatusPolicySet switchStatusPolicySet Sets the policy parameters that determine overall switch status. Synopsis switchstatuspolicyset Description Use this command to set policy parameters for calculating the overall status of the switch enclosure. The policy parameter values determine how many failed or faulty units of each contributor are allowed before triggering a status change in the switch from HEALTHY to MARGINAL or DOWN.
  • Page 716 Note: Enter commands in lowercase only; mixed case is for readability. switchStatusPolicySet Examples To change the switch policies: switch:admin> switchstatuspolicyset To change the overall switch status policy parameters The current overall switch status policy parameters: Down Marginal ---------------------------------- PowerSupplies Temperatures Fans Blade Flash...

  • Page 717: Switchstatuspolicyshow

    Note: Enter commands in lowercase only; mixed case is for readability. switchStatusPolicyShow switchStatusPolicyShow Displays the policy parameters that determine overall switch status. Synopsis switchstatuspolicyshow Description Use this command to view the current policy parameters set for the switch. These policy parameters determine the number of failed or nonoperational units allowed for each contributor before triggering a status change in the switch.
  • Page 718 Note: Enter commands in lowercase only; mixed case is for readability. switchStatusPolicyShow Examples To display the switch policies: switch:admin> switchstatuspolicyshow The current overall switch status policy parameters: Down Marginal ---------------------------------- PowerSupplies Temperatures Fans Blade Flash MarginalPorts FaultyPorts MissingSFPs See Also switchStatusPolicySet, switchStatusShow 2-684...

  • Page 719: Switchstatusshow

    Note: Enter commands in lowercase only; mixed case is for readability. switchStatusShow switchStatusShow Displays overall switch status. Synopsis switchstatusshow Description Use this command to display the overall status of the switch. In addition, users with a Fabric Watch license are able to view the list of unhealthy ports. This command displays the overall switch status, along with the status of each of the following contributors: •...
  • Page 720 Note: Enter commands in lowercase only; mixed case is for readability. switchStatusShow Examples To display a switch health report: switch:user> switchstatusshow Switch Health Report Report time: 06/19/2003 10:48:31 AM Switch Name: switch IP address: 10.10.255.255 SwitchState: MARGINAL Duration: 00:06 Power supplies monitor HEALTHY Temperatures monitor HEALTHY...

  • Page 721: Switchuptime

    Note: Enter commands in lowercase only; mixed case is for readability. switchUptime switchUptime Displays the amount of time the switch has been operating. Synopsis switchuptime Description Use this command to display the current time and the amount of time that the switch has been operational. Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 722: Syslogdfacility

    Note: Enter commands in lowercase only; mixed case is for readability. syslogdFacility syslogdFacility Changes the syslog facility. Synopsis syslogdFacility [-l level] Description Use this command to change the syslog facility to LOG_LOCAL0, LOG_LOCAL1, LOG_LOCAL2, LOG_LOCAL3, LOG_LOCAL4, LOG_LOCAL5, LOG_LOCAL6, or LOG_LOCAL7. Syslog daemon (syslogd) is a process available on most UNIX systems that reads and forwards system messages to the appropriate log files or users, depending on the system configuration.

  • Page 723: Syslogdipadd

    Note: Enter commands in lowercase only; mixed case is for readability. syslogdIpAdd syslogdIpAdd Adds the IP address of a syslog daemon. Synopsis syslogdipadd ip_address Description Use this command to add the IP address of the server that is running the syslogd process. Syslog daemon (syslogd) is a process available on most UNIX systems that reads and forwards system messages to the appropriate log files or users, depending on the system configuration.

  • Page 724: Syslogdipremove

    Note: Enter commands in lowercase only; mixed case is for readability. syslogdIpRemove syslogdIpRemove Removes the IP address of a syslog daemon. Synopsis syslogdipremove ip_address Description Use this command to remove the IP address of the server that is running the syslogd process. Note The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 725: Syslogdipshow

    Note: Enter commands in lowercase only; mixed case is for readability. syslogdIpShow syslogdIpShow Displays all syslog daemon IP addresses. Synopsis syslogdipshow Description Use this command to display all syslog daemon IP addresses in the configuration database. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 726: Sysshutdown

    Note: Enter commands in lowercase only; mixed case is for readability. sysShutdown sysShutdown Provides a graceful shutdown to protect the switch file systems. Synopsis sysshutdown Description For SilkWorm (nonbladed) switches, use this command to shutdown the switch operating system. For SilkWorm directors, when sysShutdown is called in the active control processor (CP), the command shuts down the active CP, standby CP, and any AP blades.
  • Page 727 Note: Enter commands in lowercase only; mixed case is for readability. sysShutdown To perform a system shutdown from the active CP in a dual-CP platform: switch:admin> sysshutdown This command will shutdown the operating systems on your switch. You are required to power-cycle the switch in order to restore operation. Are you sure you want to shutdown the switch [y/n]? y This is the active Cp 2005/09/13-01:15:13, [FSSM-1003], 414,, WARNING, Silkworm48000, HA State out of sync...

  • Page 728: Systemverification

    Note: Enter commands in lowercase only; mixed case is for readability. systemVerification systemVerification Runs a suite of diagnostic tests on all switches in a fabric. Synopsis systemverification [-parameters | -short][[-fru type] -unit id] Description Use this command to run a comprehensive, system-wide test of all switches in a system. The command initiates a burn-in run on all switches within the current system.
  • Page 729 Note: Enter commands in lowercase only; mixed case is for readability. systemVerification Diagnostics Each diagnostic test in this suit might report its own set of error messages when it detects failure(s). Refer to the Diagnostics section of individual diagnostic test help pages. These messages are available only in the log file.

  • Page 730: Tempshow

    Note: Enter commands in lowercase only; mixed case is for readability. tempShow tempShow Displays temperature readings. Synopsis tempshow Description Use this command to display the current temperature readings of all temperature sensors in a switch. For each sensor, this command displays the slot number (if applicable), the sensor state, and the temperature. The temperature readings are given in both Centigrade and Fahrenheit.

  • Page 731: Timeout

    Note: Enter commands in lowercase only; mixed case is for readability. timeout timeout Sets or displays the idle timeout value for a login session. Synopsis timeout [timeval] Description Use this command with out an operand to display, in minutes, the current timeout value after which idle logins are automatically terminated.

  • Page 732: Topologyshow

    Note: Enter commands in lowercase only; mixed case is for readability. topologyShow topologyShow Displays the unicast fabric topology. Synopsis topologyshow [domain] Description Use this command to display the fabric topology, as it appears to the local switch, including: • A list of all domains that are part of the fabric, and to each of those domains, all possible paths from the local switch.
  • Page 733 Note: Enter commands in lowercase only; mixed case is for readability. topologyShow Examples To display the unicast fabric topology: switch:admin> topologyshow 2 domains in the fabric; Local Domain ID: 1 Local Translate Domain 4 owned by port: 5 Local Translate Domain 8 owned by port: 4 Domain: Metric: Name:...

  • Page 734: Tracedump

    Note: Enter commands in lowercase only; mixed case is for readability. traceDump traceDump Displays, initiates, or removes a trace dump. Synopsis tracedump [-S][-s slot] tracedump -n [-s slot] tracedump -r [-s slot] tracedump -R Description Use this command to initiate a background trace dump, to remove the content of a trace dump, or to display the dump status on the switch.

  • Page 735: Traceftp

    Note: Enter commands in lowercase only; mixed case is for readability. traceFtp traceFtp Displays, enables, or disables the trace auto-FTP, or retrieves the trace dump file. Synopsis traceftp [-S] traceftp -e traceftp -d traceftp -n [-s slot][-h hostip][-u username][-p password][-d remotedirectory][-f remotefile] Description Use this command to display, enable, or disable trace auto-FTP or to retrieve a trace dump file from the switch to the FTP site immediately.
  • Page 736 Note: Enter commands in lowercase only; mixed case is for readability. traceFtp Examples To retrieve a trace dump file: switch:admin> traceftp -n -h 192.168.67.126 -u anonymous -d tracedump -f dumpfile ftp trace dump file in progress... ftp trace dump file succeeded To enable the auto-FTP feature: switch:admin>...

  • Page 737: Trackchangeshelp

    Note: Enter commands in lowercase only; mixed case is for readability. trackChangesHelp trackChangesHelp Displays information on track-changes commands. Synopsis trackchangeshelp Description Use this command to display information about the track-changes commands. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Examples To display information on the track-changes commands: switch:admin>...

  • Page 738: Trackchangesset

    Note: Enter commands in lowercase only; mixed case is for readability. trackChangesSet trackChangesSet Enables or disables track-changes feature. Synopsis trackchangesset [mode][, snmptrapmode] Description This command enables or disables the track-changes feature. An SNMP-TRAP mode can also be enabled. Trackable changes are: •...

  • Page 739: Trackchangesshow

    Note: Enter commands in lowercase only; mixed case is for readability. trackChangesShow trackChangesShow Displays status of track-changes feature. Synopsis trackchangesshow Description Use this command to display status of the track-changes feature. It shows whether the feature is enabled or disabled and if SNMP traps are generated. The output from the track-changes feature is dumped to the error log for the switch.

  • Page 740: Trunkdebug

    Note: Enter commands in lowercase only; mixed case is for readability. trunkDebug trunkDebug Debugs a trunk link failure. Synopsis trunkdebug port1 port2 Description Use this command to debug a trunk link failure. This command reports one of the following messages, based on the trunking properties of the two specified ports: •...

  • Page 741: Trunkshow

    Note: Enter commands in lowercase only; mixed case is for readability. trunkShow trunkShow Displays trunking information. Synopsis trunkshow Description Use this command to display trunking information of both E_Ports and EX_Ports. The following fields display: Trunking Group Number Displays each trunking group on a switch. All the ports that are part of this trunking group are displayed.
  • Page 742 Note: Enter commands in lowercase only; mixed case is for readability. trunkShow several edge fabrics (see the EX_Port with WWN "10:00:00:05:1e:35:b3:03" and the E_Port with WWN "10:00:00:05:1e:37:12:13" in the output below): switch:admin> trunkshow 4: 49-> 0 10:00:00:05:1e:35:b3:03 4 deskew 16 MASTER 54->...

  • Page 743: Tsclockserver

    Note: Enter commands in lowercase only; mixed case is for readability. tsClockServer tsClockServer Displays or sets the NTP Server address. Synopsis tsclockserver [ipaddr] Description Use this command to synchronize the local time of the principal or primary FCS switch to an external NTP server.
  • Page 744 Note: Enter commands in lowercase only; mixed case is for readability. tsClockServer Examples To display the current clock server value (LOCL), set the value to an NTP server at the specified IP address and then verify that the new IP address was saved: switch:admin>...

  • Page 745: Tstimezone

    Note: Enter commands in lowercase only; mixed case is for readability. tsTimeZone tsTimeZone Displays or sets the system time zone. Synopsis tstimezone --interactive tstimezone timezonename tstimezone [--old][hourOffset [, minuteOffset]] Description Use this command to display or set the system time zone. All switches maintain the current time zone setup in nonvolatile memory.
  • Page 746 Note: Enter commands in lowercase only; mixed case is for readability. tsTimeZone timezonename The name of a zoneinfo time zone. These will vary as additional time zones are added. tstimezone --interactive can be used to get the appropriate zone name. Examples To display the current time zone setup and then change it to GMT-3:30: switch:admin>...
  • Page 747 Note: Enter commands in lowercase only; mixed case is for readability. tsTimeZone (continued): Please select one of the following time zone regions. 1) Eastern Time 2) Eastern Time - Michigan - most locations 3) Eastern Time - Kentucky - Louisville area 4) Eastern Time - Kentucky - Wayne County 5) Eastern Time - Indiana - most locations 6) Eastern Time - Indiana - Crawford County...

  • Page 748: Turboramtest

    Note: Enter commands in lowercase only; mixed case is for readability. turboRamTest turboRamTest Performs a turbo SRAM logic test for 2-Gbit/sec ASICs. Synopsis turboramtest [--slot slotnumber][-passcnt count][-ports itemlist] Description This command verifies the on chip SRAM located in the 2 Gbit/sec ASIC using the turbo-RAM BIST circuitry.

  • Page 749: Txdpath

    Note: Enter commands in lowercase only; mixed case is for readability. txdPath txdPath Performs a functional test of ASIC pair TXA,TXD connections. Synopsis txdpath [--slot slotnumber][-nframes count][-lb_mode mode][-spd_mode mode][-nonstop mode] [-ports itemlist] Description Use this command to verify the TXA, TXD, and CMI data paths between the chips within a mini-switch. This is done by configuring all of the ports on the mini-switch in internal loopback and sending a frame from each quadrant to each other port on the same mini-switch.
  • Page 750 Note: Enter commands in lowercase only; mixed case is for readability. txdPath Note The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operands: --slot slotnumber Specifies the slot number on which the diagnostic operates. The ports specified are relative to this slot number.
  • Page 751 Note: Enter commands in lowercase only; mixed case is for readability. txdPath -nonstop mode Specify nonstop mode. If set to a nonzero value, the test does not stop on the first error. The default value is 0. -ports itemlist Specify a list of user ports to test. By default, all of the user ports in the current switch are tested.

  • Page 752: Uptime

    Note: Enter commands in lowercase only; mixed case is for readability. upTime upTime Displays length of time the system has been operational. Synopsis uptime Description upTime provides a one line display of the following information. The current time, how long the system has been running, how many users are currently logged on, and the system load averages for the past 1, 5, and 15 minutes.

  • Page 753: Urouteconfig

    Note: Enter commands in lowercase only; mixed case is for readability. uRouteConfig uRouteConfig Configures a static route. Synopsis urouteconfig in_area domain out_area Description Use this command to configure static routes. A static route is a route that is assigned to a specific path (defined by port number out_area), a route that does not change when a topology change occurs unless the path used by the route becomes unavailable.
  • Page 754 Note: Enter commands in lowercase only; mixed case is for readability. uRouteConfig See Also configShow, interfaceShow, uRouteRemove, uRouteShow 2-720 Fabric OS Command Reference Manual Publication Number: 53-1000240-01...

  • Page 755: Urouteremove

    Note: Enter commands in lowercase only; mixed case is for readability. uRouteRemove uRouteRemove Removes a static route. Synopsis urouteremove in_area domain Description Use this command to remove a previously configured static route. After this command is issued, the route to domain for in_area might change to use a different output port, only if dynamic load sharing (DLS) is set.

  • Page 756: Urouteshow

    Note: Enter commands in lowercase only; mixed case is for readability. uRouteShow uRouteShow Displays unicast routing information. Synopsis urouteshow [slotnumber/][portnumber][domain] Description Use this command to display the unicast routing information for a port, as it is known by the FSPF path selection and routing task.
  • Page 757 Note: Enter commands in lowercase only; mixed case is for readability. uRouteShow domain Specify a remote domain in the fabric for which routing information is to be displayed. This operand is optional; if omitted, the routing information for all domains in the fabric is displayed. Examples To display the routing information of all the active ports: switch:admin>...

  • Page 758: Userconfig

    Note: Enter commands in lowercase only; mixed case is for readability. userConfig userConfig Manages user accounts. Synopsis userconfig [actions][arguments] Description Use this command to manage a user's account on a switch by configuring the account's role and the Admin Domains that account may access. An account is assigned a single role. An account can access multiple Admin Domains, but only one Admin Domain at a time.
  • Page 759 Note: Enter commands in lowercase only; mixed case is for readability. userConfig actions require the Admin role. --showad [-a AD_ID_list] For each Admin Domain in AD_ID_list, display a list of users that include that Admin Domain in their Admin Domain permissions. Only Admin role users may use this action.
  • Page 760 Note: Enter commands in lowercase only; mixed case is for readability. userConfig --deletead username [-h AD_ID][-a AD_ID_list] Delete Admin Domain(s) from username's Admin Domain list. If a home Admin Domain is specified, it must be one of the ADs in the Admin Domain permissions remaining after the ADs specified by the --deletead option have been removed.
  • Page 761 Note: Enter commands in lowercase only; mixed case is for readability. userConfig Examples To add a new account: switch:admin> userconfig --add joe -r admin -d "Joe Smith" Setting initial password for joe Enter new password: Re-type new password: Account joe has been successfully added. To display current account information: switch:admin>...

  • Page 762: Userrename

    Note: Enter commands in lowercase only; mixed case is for readability. userRename userRename Renames the user login name. Synopsis userrename old_username new_username Description Use this command to change an existing account login name to a new login name. The following rules apply: •...

  • Page 763: Version

    Note: Enter commands in lowercase only; mixed case is for readability. version version Displays firmware version information. Synopsis version Description Use this command to display firmware version information and build dates. The following is displayed: Kernel Displays the version of switch kernel operating system Fabric OS Displays the version of switch Fabric OS Made on...

  • Page 764: Wwn

    Note: Enter commands in lowercase only; mixed case is for readability. Displays or sets the World Wide Name (WWN) of the switch. Synopsis wwn [name] Description Use this command to display the WWN of a switch. All switches have a numeric address that is the unique Fibre Channel address used for communicating with the switch.

  • Page 765: Zone

    Note: Enter commands in lowercase only; mixed case is for readability. zone zone Specifies zone operations. Synopsis zone --copy < [source_ad.][source_zone_object] > [dest_zone_object] zone --expunge "zone_object" zone --validate [-f | -m mode] ["zone_object"] Description Use this command for zone copy, expunge and validate operations. zone command follows a batched- transaction model.
  • Page 766 Note: Enter commands in lowercase only; mixed case is for readability. zone following: • The device is not online. • The device is online but is not Admin Domain-aware. • The device is online but it is not part of the current Admin Domain. •...
  • Page 767 Note: Enter commands in lowercase only; mixed case is for readability. zone To delete all reference of zone member 100,5: switch:admin> zone --expunge “100,5” To delete all reference of zone backup_zn: switch:admin> zone --expunge backup_zn To delete all reference of zone alias backup_ali1: switch:admin>...

  • Page 768: Zoneadd

    Note: Enter commands in lowercase only; mixed case is for readability. zoneAdd zoneAdd Adds a member to the zone. Synopsis zoneadd "zoneName", "member;member" Description Use this command to add one or more members to an existing zone. This command changes the defined configuration. For the change to be preserved across switch reboots, it must be saved to non-volitile memory using the cfgSave command.

  • Page 769: Zonecreate

    Note: Enter commands in lowercase only; mixed case is for readability. zoneCreate zoneCreate Creates a zone. Synopsis zonecreate "zonename", "member;member" Description Use this command to create a new zone. A zone name is a C-style name beginning with a letter and followed by any number of letters, digits, and underscore characters.
  • Page 770 Note: Enter commands in lowercase only; mixed case is for readability. zoneCreate When secure mode is enabled, this command can be issued only from the primary FCS switch. Operands The following operands are required: "zonename" Name for a zone to be created, in quotation marks. Quotation marks are optional. This name cannot be used for any other zone object.

  • Page 771: Zonedelete

    Note: Enter commands in lowercase only; mixed case is for readability. zoneDelete zoneDelete Deletes a zone. Synopsis zonedelete "zonename" Description Use this command to delete a zone. This command changes the defined configuration. For the change to be preserved across switch reboots, it must be saved to flash memory using the cfgSave command.

  • Page 772: Zonehelp

    Note: Enter commands in lowercase only; mixed case is for readability. zoneHelp zoneHelp Displays a description of zoning commands. Synopsis zonehelp Description Use this command to display short descriptions of zoning commands. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 773: Zoneobjectcopy

    Note: Enter commands in lowercase only; mixed case is for readability. zoneObjectCopy zoneObjectCopy Copies a zone object. Synopsis zoneObjectCopy "objectName", "newName" Description Use this command to copy a zone object to a new zone object. The resulting object has the same type as the original object.

  • Page 774: Zoneobjectexpunge

    Note: Enter commands in lowercase only; mixed case is for readability. zoneObjectExpunge zoneObjectExpunge Expunges a zone object. Synopsis zoneObjectExpunge "objectName" Description Use this command to expunge a zone object. In addition to performing a simple delete, this command also removes the object from the member lists of all other objects. Afterwards, this object is completely removed from the database.

  • Page 775: Zoneobjectrename

    Note: Enter commands in lowercase only; mixed case is for readability. zoneObjectRename zoneObjectRename Renames a zone object. Synopsis zoneObjectRename "objectName", "newName" Description Use this command to rename a zone object. You can use this command for all zone object types, including cfg, zone, and alias.

  • Page 776: Zoneremove

    Note: Enter commands in lowercase only; mixed case is for readability. zoneRemove zoneRemove Removes a member from a zone. Synopsis zoneremove "zonename", "zoneMemberList" Description Use this command to remove one or more members from an existing zone. If all members are removed, the zone is deleted. This command changes the defined configuration.

  • Page 777: Zoneshow

    Note: Enter commands in lowercase only; mixed case is for readability. zoneShow zoneShow Displays zone information. Synopsis zoneshow ["pattern"][, mode] Description Use this command to display zone configuration information. If no parameters are specified, all zone configuration information (both defined and enabled) is displayed.
  • Page 778 Note: Enter commands in lowercase only; mixed case is for readability. zoneShow 2-744 Fabric OS Command Reference Manual Publication Number: 53-1000240-01...

  • Page 779: Chapter 3 Licensed Product Commands

    Chapter Licensed Product Commands This chapter summarizes the commands that are only available with a license key. • “Advanced Zoning Commands,” next • “Fabric Assist Mode Commands” on page 3-2 • “Extended Fabrics Command” on page 3-3 • “Fabric Watch Commands” on page 3-3 •...

  • Page 780: Fabric Assist Mode Commands

    Table 3-1 Zoning Commands (Continued) Command Description zoneShow Displays zone information. Zone Objects zoneObjectCopy Copies a zone object. zoneObjectExpunge Expunges a zone object. zoneObjectRename Renames a zone object. Zone Configuration cfgActvShow Displays effective zone configuration information. cfgAdd Adds a zone to a zone configuration. cfgClear Clears all zone configurations.

  • Page 781: Extended Fabrics Command

    Note The Fabric Assist Mode is only available on Fabric OS v2.6.x and v3.x systems in the fabric; it is not supported on Fabric OS v4.x or v5.x. Extended Fabrics Command The following command is available with the purchase of a Brocade Extended Fabrics license key. Table 3-3 Extended Fabrics Commands Command...

  • Page 782: Isl Trunking Commands

    Table 3-4 Fabric Watch Commands Command Description switchStatusPolicySet Sets the policy parameters that determine overall switch status. switchStatusPolicyShow Displays the policy parameters that determine overall switch status. switchStatusShow Displays overall switch status. tempShow Displays temperature readings. ISL Trunking Commands The following commands are available with the purchase of a Brocade ISL Trunking license key. For more detailed information about trunking refer to the Fabric OS Administrator’s Guide.
  • Page 783 Table 3-6 Performance Monitoring Commands (Continued) Command Description perfAddSCSIMonitor Adds a SCSI traffic frame monitor to a port. perfAddUserMonitor Adds a user-defined monitor to a port. perfAddWriteMonitor Adds a SCSI Write monitor to a port. perfCfgClear Clears the performance monitoring settings from flash memory. perfCfgRestore Restores performance monitoring settings from flash memory.

  • Page 784: Secure Fabric Os Commands

    Secure Fabric OS Commands The following commands are available with the purchase of a Brocade Security license key. For more detailed information about security, refer to the Secure Fabric OS Administrator’s Guide. Table 3-7 Brocade Secure Fabric OS Commands Command Description pkiCreate Creates public key infrastructure (PKI) objects.
  • Page 785 Table 3-7 Brocade Secure Fabric OS Commands (Continued) Command Description secTempPasswdReset Resets a password on a remote switch. secTempPasswdSet Sets a temporary password on a remote switch. secTransAbort Aborts current security transaction. secVersionReset Resets the version stamp to 0. Fabric OS Command Reference Manual Publication Number: 53-1000240-01...
  • Page 786 Fabric OS Command Reference Manual Publication Number: 53-1000240-01...

  • Page 787: Chapter 4 Exclusive Primary Fcs Commands

    Chapter Exclusive Primary FCS Commands This chapter summarizes the commands that are available only on the primary FCS when security mode is enabled. Commands Exclusive to the Primary FCS The following commands are available only on the primary FCS when security mode is enabled. Table 4-1 Commands Exclusive to the Primary FCS Command...
  • Page 788 Table 4-1 Commands Exclusive to the Primary FCS (Continued) Command Notes cfgTransShow Must be run from the primary FCS switch. date This command can be run on all switches to view the current date. You can only modify the date from the primary FCS switch. defZone Must be run from the primary FCS switch.
  • Page 789 Table 4-1 Commands Exclusive to the Primary FCS (Continued) Command Notes secTempPasswdSet Must be run from the primary FCS switch. secVersionReset Must be run from the primary FCS switch. Can also be run on a single non-FCS switch which is segmented from a fabric. snmpConfig Community strings can be changed on the primary FCS switch only tsClockServer...
  • Page 790 Fabric OS Command Reference Manual Publication Number: 53-1000240-01...

  • Page 791: Commands Supported On The Standby Cp

    Chapter Control Processor Commands This chapter lists the commands available when logged in to the standby CP in a SilkWorm 24000 or 48000 director. The full set of commands for your user role are available to the active CP. Commands Supported on the Standby CP The following commands are supported when logged into the standby CP.
  • Page 792 Table 5-1 Commands Supported on the Standby CP (Continued) Command Description login Logs in as new user. logout Logs out from a telnet, rlogin, or serial port session. memShow Displays memory usage in the system. myId Displays the current login session details. pdShow Displays information from panic dump file.

  • Page 793: Supportshow Control Commands

    Chapter supportShow Reference This chapter explains the information displayed by the supportShow command. This chapter has the following sections: • “supportShow Control Commands,” next • “supportShow Command Groups” on page 6-2 • “Proc Entry Information Displayed” on page 6-4 supportShow Control Commands supportShow command is used to display support information by executing groups of preselected Fabric OS and Linux commands.

  • Page 794: Supportshow Command Groups

    supportShow Command Groups Table 6-1 displays the command groups under supportshow, and which Fabric OS or Linux commands are executed by that group. Table 6-1 supportShow Command Groups Command Group Fabric OS v3.2.0 Fabric OS v4.x/v5.x mqshow mii-tool –vv /usr/bin/du -xh / | /bin/sort: memShow /bin/ps –elfh mallocshow...
  • Page 795 Table 6-1 supportShow Command Groups (Continued) Command Group Fabric OS v3.2.0 Fabric OS v4.x/v5.x services nsShow fdmiCacheShow nsAllShow ficonDbg dump rnid nscamShow ficonDbg log ficonShow ilir ficonShow lirr ficonShow rlir ficonShow rnid fdmiShow nsShow nsAllShow nscamShow security secModeShow secModeShow secPolicyDump secPolicyDump secStatsShow secStatsShow...

  • Page 796: Proc Entry Information Displayed

    Table 6-1 supportShow Command Groups (Continued) Command Group Fabric OS v3.2.0 Fabric OS v4.x/v5.x system version myId upTime version switchShow firmwareShow tempShow upTime psShow switchStatusShow licenseShow switchShow diagShow haDump portFlagsShow tempShow portErrShow sensorShow portCfgShow psShow configShow fanShow licenseShow portFlagsShow portCfgShow sfpShow portErrShow fwSamShow...
  • Page 797 Table 6-2 Proc Entry Information Displayed Proc Display Proc Example Display Command /proc/cmdline /proc/cmdline quiet /proc/cpuinfo /proc/cpuinfo cpu : 405GP clock : 200MHz revision : 1.69 (pvr 4011 0145) bogomips : 199.47 machine : Brocade Silkworm plb bus clock : 100MHz pci bus clock : 33MHz /proc/devices /proc/devices...
  • Page 798 Table 6-2 Proc Entry Information Displayed (Continued) Proc Display Proc Example Display Command /proc/interrupts /proc/interrupts CPU0 0: 0 IBM UIC Level serial 1: 591 IBM UIC Level serial 2: 2696197 IBM UIC Level IBM OCP IIC 10: 0 IBM UIC Level OCP EMAC MAL SERR 11: 1512 IBM UIC Level OCP EMAC TX EOB 12: 343895 IBM UIC Level OCP EMAC RX EOB 13: 0 IBM UIC Level OCP EMAC TX DE...
  • Page 799 Table 6-2 Proc Entry Information Displayed (Continued) Proc Display Proc Example Display Command /proc/mtd /proc/mtd dev: size erasesize name mtd0: 00010000 00010000 "boot environment" mtd1: 00070000 00010000 "boot prom" mtd2: 01000000 00040000 "Entire user flash" mtd3: 00400000 00040000 "kernel and initrd (1)" mtd4: 00400000 00040000 "kernel and initrd (2)"...
  • Page 800 Table 6-2 Proc Entry Information Displayed (Continued) Proc Display Proc Example Display Command /proc/stat /proc/stat cpu 184683 47107 88647 15558673 cpu0 184683 47107 88647 15558673 page 54635 71305 swap 0 0 intr 4154525 0 591 2696197 0 0 0 0 0 0 0 0 1520 343900 0 0 0 0 0 0 0 0 0 0 0 0 0 52017 0 0 0 1060300 0 disk_io: (3,0):(61121,5352,115463,55769,944835) ctxt 44089966...
  • Page 801 Appendix RBAC Command Availability This appendix explains how a command is validated when it is typed at the command prompt. A command must be validated based on the user account’s role before the command is executed. Validation is done with these checks, in this order: Active/Standby availability: on chassis-based systems, check that the command is available on the Control Processor (CP).
  • Page 802 Table 1-1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Oper Switch Zone Fabric Basic Admin ator Admin Admin Admin Switch Admin aptPolicy auditCfg backplaneTest backPort bannerSet bannerShow bcastShow bladeBeacon bladeDisable bladeEnable bladevershow...
  • Page 803 Table 1-1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Oper Switch Zone Fabric Basic Admin ator Admin Admin Admin Switch Admin chassisShow chipRegShow cmemRetentionTest cmiTest configDefault configDownload configShow configUpload configure crossPortTest dataTypeShow...
  • Page 804 Table 1-1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Oper Switch Zone Fabric Basic Admin ator Admin Admin Admin Switch Admin dlsReset dlsSet dlsShow dnsConfig enclosureShow errClear errDelimiterSet errDump errFilterSet errModuleShow errShow...
  • Page 805 Table 1-1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Oper Switch Zone Fabric Basic Admin ator Admin Admin Admin Switch Admin fcipChipTest fciphelp fcipPathTest fclunquery fcPing fcpLogClear fcpLogDisable fcpLogEnable fcpLogShow fcpProbeShow fcpRlsShow...
  • Page 806 Table 1-1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Oper Switch Zone Fabric Basic Admin ator Admin Admin Admin Switch Admin ficonShow filterTest filterTest firmwareCommit firmwareDownload firmwareDownloadStatus firmwareRestore firmwareShow fosconfig fPortTest framerpathtest...
  • Page 807 Table 1-1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Oper Switch Zone Fabric Basic Admin ator Admin Admin Admin Switch Admin haFailover haShow haSyncStart haSyncStop help historyMode historyShow httpcfgShow ifModeSet ifModeShow interfaceShow...
  • Page 808 Table 1-1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Oper Switch Zone Fabric Basic Admin ator Admin Admin Admin Switch Admin licenseport licenseRemove licenseShow linkCost login logout loopPortTest lsanzoneshow LSDbShow memShow miniCycle...
  • Page 809 Table 1-1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Oper Switch Zone Fabric Basic Admin ator Admin Admin Admin Switch Admin openSource passwd passwd passwdcfg pathInfo pdShow perfAddEEMonitor perfAddIPMonitor perfAddReadMonitor perfAddRWMonitor perfAddSCSIMonitor...
  • Page 810 Table 1-1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Oper Switch Zone Fabric Basic Admin ator Admin Admin Admin Switch Admin pkiShow policy portAlpaShow portBufferShow portCamShow portCfg portCfgDefault portCfgEport portcfgexport portCfgGport portCfgISLMode...
  • Page 811 Table 1-1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Oper Switch Zone Fabric Basic Admin ator Admin Admin Admin Switch Admin portLogEnable portLogEventShow portLoginShow portLogPdisc portLogReset portLogResize portLogShow portLogShowPort portLogTypeDisable portLogTypeEnable portLoopbackTest...
  • Page 812 Table 1-1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Oper Switch Zone Fabric Basic Admin ator Admin Admin Admin Switch Admin quietMode reboot routeHelp sasChipTest sasPathTest savecore secActiveSize secAuthSecret secCertUtil secDefineSize secFabricShow...
  • Page 813 Table 1-1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Oper Switch Zone Fabric Basic Admin ator Admin Admin Admin Switch Admin secTempPasswdSet secTransAbort secVersionReset sensorShow setDbg setEsdMode setMfgMode setmodem setSplbMode setVerbose sfpShow...
  • Page 814 Table 1-1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Oper Switch Zone Fabric Basic Admin ator Admin Admin Admin Switch Admin supportShowCfgDisable supportShowCfgEnable supportShowCfgShow switchBeacon switchCfgPersistentDisable switchCfgSpeed switchCfgTrunk switchDisable switchEnable switchName switchReboot...
  • Page 815 Table 1-1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Oper Switch Zone Fabric Basic Admin ator Admin Admin Admin Switch Admin trunkShow tsClockServer tsTimeZone turboRamTest txDpath uptime uRouteConfig uRouteRemove uRouteShow userConfig userConfig...
  • Page 816 A-16 Fabric OS Command Reference Manual Publication Number: 53-1000240-01...
  • Page 817 Index 2-270, 2-272, 2-273, 2-275, 2-277, 2-279, 2- Numerics 281, 2-282, 2-284, 2-286, 2-292, 2-293, 2-295, 2-107, 2-337, 2-341, 2-342, 2-449, 2-450, 2-297, 2-299, 2-309, 2-312, 2-315, 2-317, 2- 1 Gbit/sec 2-462, 2-501, 2-620, 2-635, 2-636, 2-640, 2- 321, 2-323, 2-324, 2-325, 2-326, 2-327, 2-328, 667, 2-674, 2-698, 2-716 2-332, 2-337, 2-339, 2-346, 2-347, 2-349, 2- 350, 2-351, 2-352, 2-353, 2-354, 2-355, 2-356,...
  • Page 818 2-125, 2-204, 2-221, 2-225, 2-249, 2-332, 2- 2-129, 2-132, 2-135, 2-694 AL_PA 391, 2-402, 2-414, 2-415, 2-416, 2-429, 2-673, 2-734, 2-735 2-429 AL_PAs 2-619, 2-693 AP blade 2-433, 2-434, 2-435 CAM utilization 2-30, 2-385 2-75 chassis name 2-100, 2-172, 2-402, 2-416, arbitrated loop parameters 2-709, 2-710 clock server...
  • Page 819 2-325, 2-622, 2-730 282, 2-730 2-30, 2-137, 2-138, 2-139, 2- 2-624, 2-628, 2-629, 2-630, 2-631, 2-632 dynamic load sharing FA-MIB 544, 2-721 2-436, 2-437, 2-507, 2-515 fastwrite 2-624, 2-628, 2-629, 2-630, 2-631, 2-632 FA-TRAP 2-190, 2-191, 2-192, 2-195, 2-196, 2-197, FC Router 2-198, 2-199, 2-200, 2-202, 2-203, 2-204, 2- 205, 2-208, 2-209, 2-334, 2-572, 2-673...
  • Page 820 2-235, 2-600, 2-606, 2-618, 2-645, 2-693 2-76, 2-219, 2-224, 2-241, 2-251, 2-252, 2- 2-286, 2-535, 2-697 253, 2-254, 2-275, 2-277, 2-538, 2-694 idle timeout value 2-292, 2-293, 2-294, 2-544, 2-633 2-242, 2-243, 2-285, 2-286, 2-287, 2-328, 2- in-order deliver FSPF 336, 2-358, 2-359, 2-385, 2-386, 2-544, 2-652, 2-410 Inter-Switch Link...
  • Page 821 2-116, 2-537, 2-734, 2-735, 2-737, 2-739, 2-740, 2-741, 2-742, 2-743, 3-1, 3-2 2-99, 2-449 Extended Fabrics 2-98, 2-140, 2-144, 2-198, 2-202, 2- Name Server 2-57, 2-59, 2-63, 2-171, 2-172, 2- Fabric Assist 253, 2-361, 2-364, 2-365, 2-366, 2-367, 2-368, 173, 2-174, 2-175, 2-176, 2-738, 3-2 2-369, 2-371, 2-373, 2-374, 2-493 2-72, 2-74, 2-244, 2-245, 2-246, 2- Fabric Watch...
  • Page 822 165, 2-364, 2-372, 2-436, 2-438, 2-455, 2-459, power-on self-test, see POST 2-471, 2-472, 2-486, 2-493, 2-671 2-17, 2-20, 2-23, 2-25, 2-26, 2-27, 2-28, primary FCS 2-29, 2-57, 2-58, 2-59, 2-60, 2-61, 2-62, 2-63, 2-438 rscnsupr 2-64, 2-68, 2-70, 2-71, 2-72, 2-87, 2-109, 2- 112, 2-114, 2-116, 2-171, 2-172, 2-174, 2-175, 2-176, 2-289, 2-351, 2-352, 2-353, 2-354, 2- 355, 2-378, 2-514, 2-557, 2-558, 2-562, 2-563,...
  • Page 823 2-433, 2-434, 2-435 SID used supportShow control commands 2-79, 2-105, 2-236, 2-332, 2- 2-624, 2-628, 2-629, 2-630, 2-631, 2- SilkWorm 200E switch SW-EXTTRAP 416, 2-450, 2-508, 2-620, 2-635, 2-638, 2-643, 2-676, 2-715 2-423, 2-424, 2-425, 2-553, 2-566, switch certificate 2-35, 2-37, 2-50, 2-52, 2-72, 2-567 SilkWorm 24000 director 2-74, 2-79, 2-80, 2-82, 2-105, 2-225, 2-236, 2-...
  • Page 824 2-464, 2-465 VEX_Port 2-37, 2-98, 2-99, 2-289 virtual channel settings 2-87, 2-92, 2-97, 2-98 WAN_TOV 2-279, 2-410, 2-564, 2-671 Web Tools 2-26, 2-27, 2-28, 2-29, 2-56, 2-57, zone configuration 2-58, 2-59, 2-60, 2-61, 2-62, 2-63, 2-64, 2-65, 2-67, 2-68, 2-70, 2-112, 2-113, 2-114, 2-116, 2- 176, 2-731, 2-732, 2-734, 2-735, 2-737, 2-738, 2-739, 2-740, 2-741, 2-742, 2-743, 3-2 2-25, 2-26, 2-27, 2-28, 2-56, 2-57, 2-58, 2-...

This manual is also suitable for:

Aa979a - storageworks san switch 2/8vStorageworks 2/128 - san director switchStorageworks 2/16n - ff and 2/16n san switchStorageworks 2/16v - san switchStorageworks 2/32 - san switch

Table of Contents