Brocade Communications Systems A7533A - Brocade 4Gb SAN Switch Base Command Reference Manual
  1. Manuals
  2. Brands
  3. Brocade Communications Systems Manuals
  4. Switch
  5. A7533A - Brocade 4Gb SAN Switch Base
  6. Command reference manual
Brocade Communications Systems A7533A - Brocade 4Gb SAN Switch Base Command Reference Manual

Brocade Communications Systems A7533A - Brocade 4Gb SAN Switch Base Command Reference Manual

Brocade fabric os command reference manual - supporting fabric os v5.3.0 (53-1000436-01, june 2007)
Hide thumbs Also See for A7533A - Brocade 4Gb SAN Switch Base:
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
Table of Contents

Advertisement

Quick Links

Download this manual See also: Troubleshooting Manual, Command Reference Manual
53-1000436-01
15 Jun 2007
Fabric OS
Command Reference Manual
Supporting Fabric OS v5.3.0

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the A7533A - Brocade 4Gb SAN Switch Base and is the answer not in the manual?

Questions and answers

Related Manuals for Brocade Communications Systems A7533A - Brocade 4Gb SAN Switch Base

Summary of Contents for Brocade Communications Systems A7533A - Brocade 4Gb SAN Switch Base

  • Page 1 53-1000436-01 15 Jun 2007 Fabric OS Command Reference Manual Supporting Fabric OS v5.3.0...
  • Page 2 Copyright 1998-2007, Brocade Communications Systems, Incorporated. ALL RIGHTS RESERVED. 53-1000436-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-10 Add 8, modify 164, and delete April 2005 Manual 5 commands. Add switchAdmin and MUA information to chapter 1. Modify chapter 5 from “Commands Unique to Fabric OS v4.x”...

  • Page 5: Table Of Contents

    Contents About This Document How This Document Is Organized ........xv Supported Hardware and Software .
  • Page 6 bannerShow............47 bcastShow .
  • Page 7 date ............111 dbgShow .
  • Page 8 fabRetryShow ...........155 fabricLog .
  • Page 9 fcrPathTest............204 fcrPhyDevShow .
  • Page 10 fwSetToCustom ..........270 fwSetToDefault .
  • Page 11 itemList ............334 killTelnet.
  • Page 12 passwdCfg ............394 pathInfo .
  • Page 13 portCfgGPort ........... .460 portCfgISLMode .
  • Page 14 portPerfShow........... .518 portRegTest .
  • Page 15 secPolicyDump ..........584 secPolicyFCSMove.
  • Page 16 statsTest............648 stopPortTest.
  • Page 17 trackChangesShow ..........704 trunkDebug .
  • Page 18 Chapter 5 Control Processor Commands Commands Supported on the Standby CP ......753 Chapter 6 supportShow Reference supportShow Control Commands .

  • Page 19: 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 xvi •...

  • Page 20: 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.0.1 to 5.3.0 supporting the following platforms: Brocade 200E switch • Brocade 3250 switch • Brocade 3850 switch •...

  • Page 21: What's New In This Document

    What’s New in This Document New commands that were added since this document was last released: • ipfilter iscsiswcfg fastwritecfg fcrLsanCount fcrLsanMatrix Fabric OS Command Reference Manual xvii 53-1000436-01...
  • Page 22 Commands that were modified since this document was last released: • aaaConfig agtCfgSet agtCfgShow authUtil chassisConfig configDownload configUpload distribute fabricShow fcrFabricShow fcrConfigure fcrDisable fcrEnable fcrPathTest fcrPhyDevShow fcrProxyConfig fcrResourceShow fcrRouterPortCost fddCfg firmwareDownload firmwareDownloadStatus firmwareRestore firmwareShow fwPortDetailShow ipAddrSet ipAddrShow isnscCfg licensePort lsanZoneShow iscsiCfg iscsiswcfg myId...
  • Page 23 perfMonitorShow perfShowFilterMonitor perfShowEEMonitor policy switchSho portCfgEXPort portCmd portShow secCertUtil secFabricShow secModeEnable secPolicyAbort secPolicyActivate secPolicyAdd secPolicyCreate secPolicyFCSMove secPolicySave secPolicyShow slotShow snmpConfig supportFtp supportSave supportShow switchShow switchStatusPolicyShow switchStatusShow syslogdIpAdd syslogdIpRemove syslogdIpShow traceDump tsClockServer userConfig NOTE: FOS v5.3.0. supports the TCP/IP netstat command. Use this command to show network status, print information on active sockets, routing tables, interfaces, masquerade connections, or multicast memberships.
  • Page 24 Information that was deleted or deprecated since this document was last released: • savecore traceftp iscsitargetname fcrdisable fcrenable crossporttest Fabric OS Command Reference Manual 53-1000436-01...

  • Page 25: Document Conventions

    Document Conventions This section describes text formatting conventions and important notices formats. ORMATTING 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. ROCADE ESOURCES 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 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 • Brocade 12000/24000/48000 Migration Guide • 14U Rack Mount Kit Installation Procedure •...
  • Page 28 Brocade 3250/3850 Brocade 3250/3850 Hardware Reference Manual (for v4.x software) • Brocade 3250/3850 QuickStart Guide (for v4.x software) • Brocade 200E Brocade 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...
  • Page 29 ® FICON Enables IBM host-based management programs to manage FICON fabric switches in-band by sending commands to the Fabric OS emulated control device. 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.

  • 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: 1. General Information Technical Support contract number, if applicable Switch model Switch operating system version Error numbers and messages received supportSave command output...

  • 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 xxviii Fabric OS Command Reference Manual 53-1000436-01...

  • Page 33: Chapter 1 Using Fabric Os Commands

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

  • Page 34: Using The Command Line Interface

    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 Brocade 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 2 Fabric Os Commands

    Chapter Fabric OS Commands 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 36 aaaConfig The following are the options for --add and --change actions: -p port RADIUS server port number. -s secret Common secret between the switch and RADIUS server. -t timeout Response timeout for the RADIUS server. -a [pap|chap|peap-mschapv2] Use PAP or CHAP or PEAP-MSCHAPv2 as the authentication protocol. The following gives a detailed description of each action type: --show List the current RADIUS servers and their parameters.
  • Page 37 aaaConfig Primary AAA Service: Switch database Secondary AAA Service: None To change the configuration for server 192.168.233.48: switch:admin> aaaconfig --change 192.168.233.48 -p 3002 -s newsecret -t 1 See Also none Fabric OS Command Reference Manual 53-1000436-01...
  • Page 38 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" ad --remove ad_id <[-d "dev_list"] [-s "switch_list"]> ad --rename present_ad_id new_ad_name ad --save ad --select ad_id...
  • Page 39 All switches, switch ports and devices from the fabric that are not specified in any other Admin Domain 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 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). Provides rights to zone the devices. Provides administrative view rights to the switch port the device is connected to: for example, portShow, nsShow, and so forth;...
  • Page 41 --apply Saves the current transaction buffer contents to the defined configuration and enforces the defined configuration on all switches in the fabric. ad --apply prompts for confirmation. --clear Deletes all ADs and clears AD0’s explicit members. This command fails if AD1 through AD254’s zone databases are not empty.
  • Page 42 --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. The rename operation remains in the transaction buffer until you issue ad --apply or ad --save. --save Saves the outstanding Admin Domain transaction to the defined configuration in all the switches in the fabric.
  • Page 43 FC Router Front Phantom Domain and FC Router Translate Phantom Domain are virtual entities without any exposed management interfaces; hence, any FC Router phantom switch WWNs specified in AD's switch memberlist will be marked as non-Admin Domain aware members. All D,PI members in the device list corresponding to an FC Router Phantom Domain will be marked as non-Admin Domain aware members.
  • Page 44 switch:admin> ad --create “AD1”, -s “100; 10:00:00:60:69:80:59:13” 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. This operation will fail if an effective zone configuration exists in the AD Do you want to deactivate ‘5’...
  • Page 45 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: ---------------------- AD: 1 : Active Device WWN members: 21:00:00:80:e5:12:8b:37;...
  • Page 46 1,12; 1,13; 1,14; 1,15; Switch WWN members: 10:00:00:60:69:00:02:53; To display the Admin Domain effective configuration information: switch:admin> ad --show -m 2 Current AD: 255 : AD255 Effective configuration: ------------------------ AD: 1 : Active Device WWN members: 21:00:00:80:e5:12:8b:37; 21:00:00:80:e5:12:8b:55; Switch port members: 1,0;...
  • Page 47 switch:admin> ad --transabort You are about to abort the outstanding AD transaction. Do you want to abort the AD transaction (yes, y, no, n): [no] y To display the current Admin Domain transaction: switch:admin> ad --transshow Current transaction token is 26816 It is abortable switch:admin>...
  • Page 48 Enables and manages the Access Gateway(AG) mode to perform AG specific operations. Synopsis ag --show ag --modeshow ag --modeenable ag --modedisable ag --mapshow [N_Port] ag --mapset [<N_Port> <F_Ports>] ag --mapadd [<N_Port> <F_Ports> ] ag --mapdel [<N_Port> <F_Ports>] ag --failovershow [N_Port] ag --failoverdisable <N_Port>...
  • Page 49 Displays the F_Ports that are mapped to a given N_Port. Current F_Ports are the F_Ports that are currently routed through the specified N_Port This list may not be the same as configured F_Ports in the case ofN_Port failover. Use the optional N_Port argument to display the F_Ports that are mapped to this specified N_Port only.
  • Page 50 --failbackdisable <N_Port> Disables the failback policy for an N_Port Examples To show the options for ag: switch:admin> ag --help Usage: ag <action> [<arguments>] --show Displays the AG's configuration and state --modeshow Displays agmode setting for the switch --modeenable Enables AG mode on the switch --modedisable Disables AG mode on the switch --mapshow [N_Port]...
  • Page 51 9;10 None 3;4;22 None 11;12 None None ---------------------------------------------------------------- Note: Failover and Failback indicate whether or not N_Port policy is enabled (1) or disabled (0). switch:admin> ag --mapshow 17 N_Port : 17 Failover(1=enabled/0=disabled) : 1 Failback(1=enabled/0=disabled) : 1 Current F_Ports : 1;9 Configured F_Ports : 1;2;21;...
  • Page 52 admin> ag --failbackshow 17 Failback on N_Port 17 is not supported switch:admin> ag --failbackenable 17 Failback policy is enabled for port 17 See Also portCfgNPort, portCfgNPIVPort Fabric OS Command Reference Manual 53-1000436-01...

  • Page 53: Agshow

    agshow agshow Displays the Access Gateway information registered with the fabric. Synopsis agshow --name [ ag_name] | [--local] Description This command displays the details of the F_Ports and the configured N_Ports in the Access Gateway connected. The lines of display show: Name The name of the Access Gateway.
  • Page 54 agshow To display the locally registered Access Gateways: switch:admin> agshow --local Worldwide Name Ports Enet IP Addr Firmware Local/Remote ------------------------------------------------------------------- 10:00:00:00:c9:3f:7c:86 16 10.202.90.231 v1.0.0 local To display all Access Gateways attached to the fabric: switch:admin> agshow Worldwide Name Ports Enet IP Addr Firmware Local/Remote -------------------------------------------------------------------...

  • Page 55: Agtcfgdefault

    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. This command prompts the user and only proceeds to reset on the user’s confirmation. All new values successfully configured by the command takes effect immediately.
  • Page 56 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 57 agtCfgDefault Community 6: FibreChannel (ro) No trap recipient configured yet SNMP access list configuration: Entry 0: Access host subnet area 192.168.64.0 (rw)] Entry 1: No access host configured yet Entry 2: No access host configured yet Entry 3: No access host configured yet Entry 4: No access host configured yet Entry 5:...

  • Page 58: Agtcfgset

    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. For dual-domain systems, this command operates on the SNMP agent associated with the current switch.
  • Page 59 agtCfgSet 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 60 agtCfgSet Community (rw): [OrigEquipMfr] Trap Recipient's IP address: [1080::8:800:200C:1230] 10.32.147.113 Community (rw): [private] Trap Recipient's IP address: [0.0.0.0] Community (ro): [public] Trap Recipient's IP address: [0.0.0.0] Community (ro): [common] Trap Recipient's IP address: [0.0.0.0] Community (ro): [FibreChannel] Trap Recipient's IP address: [0.0.0.0] SNMP access list configuration: Access host subnet area: [0.0.0.0] 1080::8:800:200C:1234/64 Read/Write? (true, t, false, f): [true]...

  • Page 61: Agtcfgshow

    agtCfgShow agtCfgShow Displays the SNMP agent configuration. Synopsis agtcfgshow Description Use this command to display the configuration of the SNMP agent in the switch. 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 62 agtCfgShow 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 trap, swEventTrap, is sent to configured trap recipients.
  • Page 63 agtCfgShow Entry 1: Access host subnet area 1080::8:800:200C:123/64 (rw) Entry 2: No access host configured yet Entry 3: No access host configured yet Entry 4: No access host configured yet Entry 5: No access host configured yet See Also agtCfgDefault, agtCfgShow snmpConfig, SW_v5_x.mib, “Switch Management Information &...

  • Page 64: Aliadd

    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. 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 65: Alicreate

    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). The alias member list cannot contain another zone alias. Refer to the zoneCreate command for more information on name and member specifications.

  • Page 66: Alidelete

    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. For the change to become effective, an appropriate zone configuration must be enabled using the cfgEnable command.

  • Page 67: Aliremove

    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. This command changes the defined configuration (see cfgShow). For the change to be preserved across switch reboots, it must be saved to nonvolatile memory using the cfgSave command.

  • Page 68: Alishow

    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. When secure mode is enabled, this command can be issued only from the primary FCS switch.

  • Page 69: Aptpolicy

    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 70 aptPolicy Current Policy: 3 3: Default Policy 1: Port Based Routing Policy 3: Exchange Based Routing Policy To change the current policy: switch:admin> switchdisable switch:admin> aptpolicy 1 Policy updated successfully. switch:admin> switchenable switch:admin> aptpolicy Current Policy: 1 3: Default Policy 1: Port Based Routing Policy 3: Exchange Based Routing Policy See Also...

  • Page 71: Auditcfg

    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. To add or remove any of the classes in the filter list, re-issue -class option.

  • Page 72: Authutil

    authUtil authUtil Displays and sets the authentication configuration. Synopsis authutil [--show][--set value] [<--policy - sw <passive|active|on|off>| dev> <off|passive>] [--authinit <Slotnumber/> <Portnumber>, [Slotnumber/]<Portnumber> | allE] 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).
  • Page 73 authUtil authinit [<slotnumber>/]<portnumber>, [<slotnumber>/<portnumber>...| allE>] Restarts authentication after changing the DH-chap group, hash type, and shared secret between a pair of switches. This CLI works independent of the authentication policy, that means you can initiate the authentication even if the switch is in OFF or Auto Passive mode. This CLI requests for confirmation and prints a general disclaimer/ warning message that the usage will be disastrous and may bring down the E-port if the DH chap shared secrets are not installed properly.

  • Page 74: Backplanetest

    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. This command can run only on a multiple-blade configured system. It assumes that all blades available on the specified switch have passed the blade diagnostics tests.
  • Page 75 backplaneTest DATA TIMEOUT XMIT Refer to the Fabric OS Message Reference for more information. See Also itemList Fabric OS Command Reference Manual 53-1000436-01...

  • Page 76: Backport

    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. The following items are tested: Proper backend port domain routing setup such that every user port has a valid path to every other user port.
  • Page 77 backport Internal (parallel) loopback -fr_type type Specifies the frame type to send. The default value is 1. Type Description Single frame spinfab frames spinfab 1K frames -extonly mode Specifies external-test-only mode. The default value is 0, which disables this mode. This command normally sends bursts of frames from each port under test to every other port in the list.

  • Page 78: Bannerset

    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 79: Bannershow

    bannerShow bannerShow Displays the banner text. Synopsis bannershow Description Use this command to display the contents of the banner. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples To display the banner for a switch: switch:admin>...

  • Page 80: Bcastshow

    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. Normally, all F_Ports and FL_Ports are members of the broadcast distribution tree.

  • Page 81: Bladebeacon

    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. When beaconing is enabled, the port LEDs flash amber in a running pattern from left to right and right to left.

  • Page 82: Bladedisable

    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 83: Bladeenable

    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); they might come online if connected to a device or remain offline if disconnected.
  • Page 84 bladeEnable CP BLADE ENABLED SW BLADE ENABLED UNKNOWN VACANT UNKNOWN VACANT UNKNOWN VACANT See Also bladeDisable, portDisable, portEnable, switchShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 85: Burninerrclear

    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. It is advisable to run the burninErrClear command prior to running diagSetBurnin and diagSetCycle The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 86: Burninerrshow

    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 A nonzero value that specifies the slot number from which to display burn-in errors.

  • Page 87: Burninlevel

    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 88: Burninstatus

    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 89: Camtest

    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. When a CAM is presented with a data, it checks if the data is present in its memory.
  • Page 90 camTest Refer to the Fabric OS Message Reference for more information. See Also centralMemoryTest, cmemRetentionTest, cmiTest, itemList, portLoopbackTest, portRegTest, spinSilk, sramRetentionTest Fabric OS Command Reference Manual 53-1000436-01...

  • Page 91: Centralmemorytest

    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. This command cannot be executed on an enabled switch. You must first disable the switch using the switchDisable command.
  • Page 92 centralMemoryTest Port 15 reads the central memory in ASIC 0. Port 0 reads the central memory in ASIC 1. Port 1 reads the central memory in ASIC 1. Port 14 reads the central memory in ASIC 1. Port 15 reads the central memory in ASIC 1. Port 15 reads the central memory in ASIC 2.
  • Page 93 centralMemoryTest Chip Number Error Subtest The forced bad chip number error subtest verifies that the bad buffer number in the data packet can be detected and its error flag and interrupt bits set. The test method is as follows: Clear the error and interrupt bits of all ASICs. Set up the hardware so that transmission of data includes a bad buffer.
  • Page 94 centralMemoryTest Diagnostics When this command detects failure(s), each subtest can report one or more of the following error messages: Subtest 2 LCMEM_ERR LCMRS_ERR LCMTO_ERR Subtest 3 CM_NO_BUF LCMEMTX_ERR LCMRS_ERR LCMTO_ERR Subtest 4 BAD_INT CM_ERR_PTN CM_ERR_TYPE TIMEOUT Subtest 5 BAD_INT CM_ERR_PTN CM_ERR_TYPE TIMEOUT Subtest 6...

  • Page 95: Cfgactvshow

    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. The effective configuration is built when a specified zone configuration is enabled.

  • Page 96: Cfgadd

    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 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 97: Cfgclear

    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 98: Cfgcreate

    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. Names are case sensitive: for example, “Cfg_1” and “cfg_1” are different zone configurations.

  • Page 99: Cfgdelete

    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. For the change to become in effect, an appropriate zone configuration must be enabled using the cfgEnable command.

  • Page 100: Cfgdisable

    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 101: Cfgenable

    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. If the build fails, the previous state is preserved (zoning remains disabled, or the previous effective configuration remains in effect).

  • Page 102: Cfgremove

    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. This command changes the defined configuration.

  • Page 103: Cfgsave

    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 command.

  • Page 104: Cfgshow

    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 105 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 106: Cfgsize

    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 107: Cfgtransabort

    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 108: Cfgtransshow

    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. The transaction cannot be aborted if it is an internal zoning transaction.

  • Page 109: Chassisconfig

    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. Each configuration specifies whether the chassis runs as one logical switch or two;...
  • Page 110 chassisConfig Users running secure mode should be particularly careful in using this command to change the number of domains on the local chassis, because security is disabled on all resulting local switches. These switches are not able to participate in a secure fabric until secure mode is restored.
  • Page 111 chassisConfig Are you sure you want to continue? (Y/N): y Current Option changed to 1 Restoring switch 0 configuration to factory defaults... done. (Telnet connection goes down at this point.) See Also configDownload, configUpload, slotShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 112: Chassisname

    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 113: Chassisshow

    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. Refer to the table for more information about the lines and their meaning. TABLE 1 Command Output Descriptions Line...
  • Page 114 chassisShow Header Version: Power Consume Factor: -180 Factory Part Num: 60-0001532-03 Factory Serial Num: 1013456800 Manufacture: Day: 12 Month: Year: 2001 Update: Day: 15 Month: Year: 2001 Time Alive: 28 days Time Awake: 16 days 555-374757 Part Num: 234-294-12345 Serial Num: 2734658 Revision Num: A.00...

  • Page 115: Chipregshow

    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. The output of this command is for support use only. The command is supported only on Brocade 200E,3250, 3850, 3900, 4100, 24000, and 48000 platforms.

  • Page 116: Cmemretentiontest

    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. The method used is to write a fill-pattern to all SRAMs, wait 10 seconds, and then read all SRAMs to verify that the data read matches the data previously written.
  • Page 117 cmemRetentionTest LCMEM_ERR LCMRS_ERR LCMTO_ERR Refer to the Fabric OS Message Reference for more information. See Also camTest, centralMemoryTest, cmiTest, dataTypeShow, itemList, portLoopbackTest, spinSilk, sramRetentionTest Fabric OS Command Reference Manual 53-1000436-01...

  • Page 118: Cmitest

    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. The message sent with a bad checksum sets the error and interrupt bits of the destination ASIC. The message sent with a good checksum does not set any error or interrupt bit in any ASIC pair.
  • Page 119 cmiTest See Also camTest, centralMemoryTest, cmemRetentionTest, itemList, portLoopbackTest, spinSilk, sramRetentionTest Fabric OS Command Reference Manual 53-1000436-01...

  • Page 120: Configdefault

    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 121 configDefault switch:admin> configdefault Committing Configuration ...done. See Also agtCfgDefault, configure, switchDisable, switchEnable Fabric OS Command Reference Manual 53-1000436-01...

  • Page 122: Configdownload

    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 123 configDownload • In the [Defined Security Policies] section, at least one member of the FCS_POLICY must be the 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.
  • Page 124 configDownload "user" Specifies the user name, in quotation marks: for example, “jdoe”. This user name is used to gain access to the host system. "file" Specifies the file name, in quotation marks: for example, “config.txt”. Absolute path names may be specified using a forward slash (/). Relative path names search for the file in the user’s home directory on UNIX hosts and in the directory on which the FTP server is running on Windows hosts.
  • Page 125 configDownload may cause this switch to fail. A switch reboot might be required for some parameter changes to take effect. Do you want to continue [y/n]: y configDownload completed successfully. All parameters are downloaded. switch:admin> switchenable switch:admin> See Also configDefault, configShow, configUpload, configure Fabric OS Command Reference Manual 53-1000436-01...

  • Page 126: Configshow

    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. Not all values displayed are applicable to all system models and configurations. The execution of this command is subject to Admin Domain restrictions that may be in place.
  • Page 127 configShow 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 diag.test.silkScreen.passes:180 diag.test.spinSilk.passes:120 ether.link.mode:AUTO fabric.domain:2 fabric.ididmode:0 fabric.ops.BBCredit:16 fabric.ops.E_D_TOV:2000 fabric.ops.R_A_TOV:10000 fabric.ops.dataFieldSize:2112 fabric.ops.max_hops:7 fabric.ops.mode.fcpProbeDisable:0 fabric.ops.mode.isolate:0 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...
  • Page 128 configShow lcdContrast.orange:208 ls:0,0x10000000;1,0x10000000;2,0x10000000;3,0x10000000;4,0x10000000;5,0x10000 000;6,0x10000000;7,0x10010000; ms.PlatEnable:1 ms.TDEnable:0 ns.DomRscnToDevForSwChg.enable:0 ns.EndDeviceRscnFormat:1 oemLogo:0 perf.cfgver:1 perf.eemonchks:0 (output truncated) See Also agtCfgShow, configure, diagDisablePost, diagEnablePost, ipAddrShow, licenseShow, syslogdIpShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 129: Configupload

    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). The FTP Server must be running in the host before an upload can occur.
  • Page 130 configUpload The first section contains the version of the Fabric OS from which this configuration was uploaded and the time stamp for the uploaded file creation. The[Boot Parameters] section contains the switch boot parameters, also known as the switch’s identity. It has variables such as the switch’s name and IP address. The[License] section contains license strings.
  • Page 131 configUpload File Name [config.txt]: config.txt Password: ******** configUpload complete: All config parameters except AD Headers,SFOS, and Security parameters are uploaded from AD0 See Also configDefault, configDownload, configShow, configure Fabric OS Command Reference Manual 53-1000436-01...

  • Page 132: Configure

    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” • “F_Port Login Parameters” • “Zoning Operation Parameters” • “RSCN Transmission Mode” •...
  • Page 133 configure TABLE 2 Configure Command Fabric Parameters Field Type Default Range E_D_TOV number 2000 1000 to R_A_TOV / 2 WAN_TOV number 0 to R_A_TOV / 4 MAX_HOPS number 7 to 19 Data Field Size number 2112 256 to 2112 Sequence Level Switching boolean 0 or 1 Disable Device Probing...
  • Page 134 configure 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. As a result, the user might not be able to set all the values within the range displayed against each parameter.

  • Page 135: Virtual Channel Settings

    configure 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. The range of allowed values varies depending on other system settings (see Unicast-only Operation). Insistent Domain ID Mode When this mode is set, the switch attempts to acquire from the fabric the domain number programmed in its "Switch Fabric Settings", failing which the...
  • Page 136 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. The default value is 0. This value must be set to 1 for interoperability.

  • Page 137: System Services Settings

    configure 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. When set to 1, an RSCN is issued upon completion of loop initialization, regardless of the presence or absence of new or pre-existing devices.
  • Page 138 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 8 Configurable Application Attributes Application File Type Default Range Certificate File string not set...

  • Page 139: Crossporttest

    crossPortTest crossPortTest This command is deprecated; use portloopback instead, however the test will be local to the port. 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 crossPortTest CSPAT: 0x7e, 0x7e, 0x7e, 0x7e, ... BYTE_LFSR: 0x69, 0x01, 0x02, 0x05, ... CHALF_SQ: 0x4a, 0x4a, 0x4a, 0x4a, ... QUAD_NOT: 0x00, 0xff, 0x00, 0xff, ... CQTR_SQ: 0x78, 0x78, 0x78, 0x78, ... CRPAT: 0xbc, 0xbc, 0x23, 0x47, ... RANDOM: 0x25, 0x7f, 0x6e, 0x9a, ... The crossPortTest command behavior depends on the modes activated.
  • Page 141 crossPortTest -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. For 1 Gbit/sec-only products it is ignored. The exact operation of each mode 5 through 8 depends upon the loopback mode selected.

  • Page 142: Datatypeshow

    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. The command displays an example of each data stream. Operands This command has the following operand: Specify the data pattern seed value.

  • Page 143: Date

    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. If the security feature (secure mode) is not enabled, switch operation does not depend on the date and time.
  • Page 144 date Thu Feb 27 12:30:00 UTC 2003 See Also errShow, ficoncupset, ficoncupshow, portLogShow, tsClockServer, tsTimeZone, upTime Fabric OS Command Reference Manual 53-1000436-01...

  • Page 145: Dbgshow

    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. Operands This command has the following operand: module_name...

  • Page 146: Defzone

    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. This command requires a Brocade Advanced Zoning license.
  • Page 147 defZone A cfgSave, cfgEnable, or cfgDisable command must be performed subsequent to the use of this command to commit the changes and distribute them to the fabric. If a cfgSave is performed and the fabric is already in the No Access default zone state, a cfgDisable is sent to the fabric. For example switch:admin>...

  • Page 148: Defzonecreate

    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" that in turn contains the zone member "00:00:00:00:00:00:00:00".

  • Page 149: Defzonedelete

    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" that in turn contains the zone member "00:00:00:00:00:00:00:00".

  • Page 150: Diagclearerror

    diagClearError diagClearError Clears the diagnostics failure status. Synopsis diagclearerror [[--slot] slotnumber] -all Description Use this command to clear the diagnostics failure status. 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 Specify the slot to clear the diagnostics failure status.

  • Page 151: Diagcommandshow

    diagCommandShow diagCommandShow Displays diagnostic command descriptions. Synopsis diagcommandshow [command] Description Use this command to display a short description of a diagnostic command. Use diagHelp to look up diagnostic command help pages. You can issue this command on the FR4-18i blade in a Brocade chassis; however, the command is not supported by the Brocade platform and does not effect any other feature operations.

  • Page 152: Diagdisablepost

    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> diagdisablepost Config update Succeeded Diagnostic POST is now disabled.

  • Page 153: Diagenablepost

    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 154: Diagenv

    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 155 diagEnv USR_SEED DIAG_USR_SEED USR_SPECIAL DIAG_USR_SPECIAL (output truncated) See Also none Fabric OS Command Reference Manual 53-1000436-01...

  • Page 156: Diagfaillimit

    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. The exact use of this configuration setting depends on the test method.

  • Page 157: Diaghelp

    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 158: Diagloopid

    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 159: Diagmodeshow

    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. Any automated use of this command should rely only on the names of the specific variables, not on their exact positions in the output.

  • Page 160: Diagpost

    diagPost diagPost Sets or displays diagnostic POST configuration. Synopsis diagpost [mode | -show] Description Use this command to enable or disable Power-On-Self-Test) POST. The mode is saved in flash memory (and stays in that mode) until the next execution of diagPost. The mode becomes active as soon as this command is executed;...

  • Page 161: Diagretry

    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. The mode is saved in flash memory (and stays in that mode) until the next execution of diagRetry.

  • Page 162: Diagsetburnin

    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). The errors and activity logs are stored in flash memory.

  • Page 163: Diagsetcycle

    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 164: Diagshow

    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 Specify which slot to operate on.

  • Page 165: Diagshowtime

    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). The mode is saved in flash memory (and stays in that mode) until the next execution of diagShowTime.

  • Page 166: Diagskiptests

    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. The mode becomes active as soon as this command is executed.

  • Page 167: Diagstatus

    diagStatus diagStatus Displays currently running diagnostic tests. Synopsis diagstatus [slotnumber] Description Use this command to display currently running diagnostic test names. You can issue this command on the FR4-18i blade in a Brocade chassis; however, the command is not supported by the Brocade platform and does not effect any other feature operations. This availability is offered to maintain consistency across a mixed-blade environment.

  • Page 168: Diagstopburnin

    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. This command does not require a reboot to take effect. Operands This command has the following operands: --slot number...

  • Page 169: Distribute

    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; namely SCC Switch Connection Control Policy DCC Device Connection Control Policy PWD Password Database and Password Configuration Policy...
  • Page 170 distribute Wildcard domains are: 1 3 5 To distribute the Switch Connection FCS policy and Password database to all domains in the fabric that support the distribute feature: switch:admin> distribute -p “FCS;PWD” -d "*" To distribute the AUTH amd FCS policies to all v5.3. switches in the fabric. switch:admin>...

  • Page 171: Dlsreset

    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. This command should be used only if devices connected to the fabric cannot handle occasional routing changes correctly.

  • Page 172: Dlsset

    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

    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: DLS is set The DLS option is turned on. Load sharing is reconfigured with every change in the fabric, and existing routes can be moved to maintain optimal balance.

  • Page 174: Dnsconfig

    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

    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 enclosureShow 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> enclosureShow slotid Bay 4 See Also chassisShow...

  • Page 177: Errclear

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 178: Errdelimiterset

    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

    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. The -r operand displays the messages in reversed order. The following information displays in each message: Start delimiter Delimiter string for the start of a message.

  • Page 180: Errfilterset

    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. If no parameters are specified, this command displays the filters that are currently in use.

  • Page 181: Errmoduleshow

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 182: Errshow

    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. The -r operand displays the messages in a reversed order. The following information displays in each message: Start delimiter Delimiter string for the start of a message.

  • Page 183: Exit

    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; the serial port returns to the prompt. login: The exit command is an accepted synonym for logout, as is typing Ctrl-D at the beginning of a line. Operands none Examples...

  • Page 184: Fabportshow

    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. The following information displays: Port The port number. State The state of the port: Port Offline...
  • Page 185 fabPortShow 0x00000800 Zoning has completed 0x00001000 Segmented by Platform Management 0x00002000 Segmented due to no license 0x00004000 Segmented due to E_Port disabling 0x00008000 DIA already sent for that port 0x00010000 RDI already sent 0x00020000 Port is true T port 0x00040000 Port received an ELP 0x00080000 Port received an ELP RJT...
  • Page 186 fabPortShow Flags: 0x280120 nbrWWN: 10:00:00:60:69:80:06:cf nbrPort: lr_tid: 0x1005dbd8, IDLE STATE red_ports: 10 11 62 63 Open commands pending: ====================== No commands pending See Also portShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 187: Fabretryshow

    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 HA_EFP Exchange Fabric Parameters used during warm recovery...

  • Page 188: Fabriclog

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operands: -s | --show...
  • Page 189 fabricLog Are your sure you want to do the resize [y/n]? y switch:admin> fabriclog -s Time Stamp Input and *Action S, P Sn,Pn Port =========================================================================== See Also fabPortShow, fabStatsShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 190: Fabricprincipal

    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. These mechanisms provide a preference for a switch requesting to be the principal switch in a fabric, but they do not provide an absolute guarantee that a switch requesting to be the principal switch will actually achieve this status.

  • Page 191: Fabricshow

    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 is disabled, the message “no fabric” is displayed. In the case of a mixed fabric, fabricshow must be run from a 5.3.0 switch; otherwise, IPV6 information is lost because switches prior to 5.3.0 do not recognize an IPV6 configured switch.
  • Page 192 fabricShow 1: fffc41 10:00:00:60:69:00:02:0b 192.168.64.180 192.168.65.180 >"sw180" 1080::8:800:200C:1234/64 2: fffc42 10:00:00:60:69:00:05:91 192.168.64.60 192.168.65.60 "sw60" The Fabric has 2 switches. 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...

  • Page 193: Fabstateclear

    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. This command is obsoleted by fabricLog -c. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 194: Fabstateresize

    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. This command is obsoleted by fabricLog -r size. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operand: New number of entries.

  • Page 195: Fabstateshow

    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. This command is obsoleted by fabricLog -s. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 196: Fabstatsshow

    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 Number of E_Port offline transitions Number of fabric reconfigurations Number of fabric segmentations due to: Loopback...
  • Page 197 fabStatsShow Sec Incompatibility: Sec Violation: ECP Error: Duplicate WWN: Eport Isolated: See Also fabRetryShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 198: Fabswitchshow

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...
  • Page 199 fabSwitchShow See Also supportShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 200: Fandisable

    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. This command is not available on nonbladed systems except for the Brocade 4100 and 4900. The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 201: Fanenable

    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. This command is not available on nonbladed systems except for the Brocade 4100 and 4900. The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 202: Fanshow

    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. absent Fan is not present. below minimum Fan is present but rotating too slowly or stopped.

  • Page 203: Fastboot

    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. If POST was previously disabled using the diagDisablePost command, then fastboot is the same as reboot.

  • Page 204: Fastwritecfg

    fastwritecfg fastwritecfg Enables or disables FC fastwrite feature for a given slot, which minimizes storage latency and improves the number of write transactions per second over long distances. Synopsis fastwritecfg Description Use this command to configure the blade in a given slot (slot = 0 for the Brocade 7500). This command is supported only for FR4-18i and Brocade 7500 systems.
  • Page 205 fastwritecfg !!!! WARNING !!!! Disabling this feature requires power-cycling of the affected blade to take effect and may take up to 5 minutes to complete. Non-bladed switches will be rebooted. In all cases, data traffic on all the ports (FC and GbE) of the blade will be disrupted.

  • Page 206: Fazoneadd

    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 207: Fazonecreate

    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. The member list must be enclosed in quotation marks.
  • Page 208 fazoneCreate A fabric domain and area number pair (for example, “1,2”). View the area numbers for ports using the switchShow command. WWNs (for example, “10:49:00:00:00:20:3f:2e”). Fabric Assist zone alias names. Exactly one Fabric Assist host member (for example, “H{1,2}”). This operand is required. Examples To create three Fabric Assist zones using a mixture of port numbers and Fabric Assist zone aliases: switch:admin>...

  • Page 209: Fazonedelete

    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 210: Fazoneremove

    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. Each deleted member must be found by an exact string match.

  • Page 211: Fazoneshow

    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. Defined configuration information is shown from the transaction buffer.

  • Page 212: Fcipchiptest

    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. This command is supported only on Brocade FR4-18i blades and Brocade 7500 platforms. Operands This command has the following operands: --slot slotnumber...
  • Page 213 fcipChipTest See Also fcipPathTest Fabric OS Command Reference Manual 53-1000436-01...

  • Page 214: Fcippathtest

    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 215 fcipPathTest Running fcippathtest ....Test Complete: fcippathtest Pass 10 of 10 Duration 0 hr, 1 min & 50 sec (0:1:50:942). passed. Diagnostics When a failure is detected, the test might report one or more of the following: PATH_TEST_ERR PATH_TEST_CHIP_INIT_ERR PATH_TEST_IMAGE_ERR PATH_TEST_TIMEOUT_ERR PATH_TEST_HEARTBEAT_ERR PATH_TEST_INVALID_RESULT...

  • Page 216: Fclunquery

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operands: -w wwn...

  • Page 217: Fcping

    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 218 fcPing 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> fcping 10:00:00:00:c9:29:0e:c4 21:00:00:20:37:25:ad:05 Source: 10:00:00:00:c9:29:0e:c4 Destination: 21:00:00:20:37:25:ad:05 Zone Check: Not Zoned Pinging 10:00:00:00:c9:29:0e:c4 [0x20800] with 12 bytes of data: received reply from 10:00:00:00:c9:29:0e:c4: 12 bytes time:1162 usec received reply from 10:00:00:00:c9:29:0e:c4: 12 bytes time:1013 usec...

  • Page 219: Fcplogclear

    fcpLogClear fcpLogClear Clears the FCPD debug information log (debug command). Synopsis fcplogclear Description Use this command to clear the debug information logged by FCPD. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 220: Fcplogdisable

    fcpLogDisable fcpLogDisable Disables the FCPD debug information log (debug command). Synopsis fcplogdisable Description Use this command to disable the debug information logged by FCPD. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 221: Fcplogenable

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 222: Fcplogshow

    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 To display the FCPD debug information log: switch:admin> fcplogshow Time Stamp Event Port...

  • Page 223: Fcpprobeshow

    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. This information includes the number of successful logins and SCSI INQUIRY commands sent over this port and a list of the attached devices.

  • Page 224: Fcprlsshow

    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 225: Fcrbcastconfig

    fcrbcastconfig fcrbcastconfig Display or set the broadcast frame forwarding option. Synopsis frcbcastconfig --show ,--enable <-f> <fabric id>, -disable <-f> <fabric id> --help Description Use this command to set the broadcast frame option to ON or OFF or to displaythe current configuration.

  • Page 226: Fcrchiptest

    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. The method used is to write a walking 1 pattern to each location. This is accomplished by writing a patter of 0x00000001 to register N, perform DMA read, and ensure the same pattern previously written is read back.
  • Page 227 fcrChipTest Diagnostics When a failure is detected, the test might report one or more of the following: DMA_ALLOC_FAIL DMA_READ_ABORT DMA_READ_TIMEOUT CHIP_INIT_TIMEOUT BIST_TIMEOUT BIST_FAIL See Also fcrPathTest, miniCycle, portLoopbackTest Fabric OS Command Reference Manual 53-1000436-01...

  • Page 228: Fcrconfigure

    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 fosConfig to disable FCR or switchDisable.

  • Page 229: Fcrdisable

    fcrDisable fcrDisable Disables the FC Routing service on a switch. This command is not supported in v5.3.0; instead use fosConfig. 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 230: Fcrenable

    fcrEnable fcrEnable Enables the FC Routing service on the switch. This command is not supported in v5.3.0; instead use fosConfig. 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 231: Fcrfabricshow

    fcrFabricShow fcrFabricShow Displays FC Routers on a backbone fabric. Synopsis fcrfabricshow Description Use this command to display information about FC Routers that exist in a FC Router backbone fabric. The existing invocation syntax is maintained for IPv6 support. When IPv6 addresses are not configured, the output of fabricshow is the same as it is currently.

  • Page 232: Fcrlsancount

    fcrLsanCount fcrLsanCount Displays or sets the maximum LSAN count. Synopsis fcrlsancount [max-lsan-count] Description Use this command to set or display the maximum number of LSAN zones that can be configured on the router. By default, this limit is set to 3000, which is also the minimum. This parameter can have the maximum value set to 5000.

  • Page 233: Fcrlsanmatrix

    fcrLsanMatrix fcrLsanMatrix Creates, edits and displays LSAN fabric matrix information, which binds the LSAN Zone and device database information, per specified edge fabric ID. Synopsis fcrlsanmatrix [--add FabricID1 |FabricID2] [--remove FabricID1 |FabricID2] [--apply] [--cancel] [--display] [--fabricview] [--verify] [--quickmode] [--help] Description Use this command to specify the pairs of edge fabrics IDs that have two-way communication.
  • Page 234 fcrLsanMatrix --apply Applies the information from the cache to the persistent memory only if there is no affect to the existing import/export devices. Otherwise, an error message is displayed. --cancel Cancels the data that was not applied; revert to the persistent information. --fabricview Views all the static and default/dynamic fabric binding in the backbone.
  • Page 235 fcrLsanMatrix Fabric ID 1 Fabric ID 2 -------------------------------------- Default LSAN Matrix: 1 2 8 Example of a quick mode: switch:admin > fcrproxydevshow -a Proxy Proxy Device Physical State Created Exists in Fabric in Fabric 10:00:00:06:2b:0e:4d:e5 01f001 4e0000 Imported 10:32:16:90:28:dd:d0:03 0bf001 2a0900 Imported 10:32:16:91:24:dd:d0:07...

  • Page 236: Fcrpathtest

    fcrPathTest fcrPathTest Tests the data path connection between FC Router FPGA and the central ASIC. Synopsis fcrpathtest [--slot slotnumber][-unit number][-path mode][-nframes 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 237 fcrPathTest RANDOM0x25, 0x7f, 0x6e, 0x9a, ... This command is supported only on Brocade FR4-18i blades and Brocade 7500 platforms. Operands This command has the following operands: --slot slotnumber Specifies the slot number on which the diagnostic operates. The default is 0 and operates on fixed-port-count products.

  • Page 238: Fcrphydevshow

    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. A device is considered to be configured to be exported to another fabric if it is a member of an LSAN zone.
  • Page 239 fcrPhyDevShow 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 Fabric OS Command Reference Manual 53-1000436-01...

  • Page 240: Fcrproxyconfig

    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. If no optional operand is provided, the command displays the persistent proxy device configuration;...
  • Page 241 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). “WWN does not exist in any proxy device slot.”...

  • Page 242: Fcrproxydevshow

    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. A proxy device is a virtual device presented in to a fabric by an FC Router. A proxy device represents a real device on another fabric.
  • Page 243 fcrProxyDevShow -w wwn Displays proxy devices with the specified port WWN. Examples To display the physical devices relevant to this FC Router: switch: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: 33 See Also fcrFabricShow, fcrProxyDevShow, fcrRouteShow, lsanZoneShow, switchShow Fabric OS Command Reference Manual...

  • Page 244: Fcrresourceshow

    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 245 fcrResourceShow switch:Admin> fcrresourceshow Daemon Limits: Max Allowed Currently Used ---------------------------------- LSAN Zones: 1000 LSAN Devices: 10000 1208 Proxy Device Slots: 10000 WWN Pool Size Allocated ---------------------------------- Phantom Node WWN: 8192 3790 Phantom Port WWN: 32768 6446 Port Limits: Max proxy devices: 2000 Max NR_Ports: 1000...

  • Page 246: Fcrrouterportcost

    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). The router module chooses the router port path based on the minimum cost per fid connection.
  • Page 247 fcrRouterPortCost To set the cost of an EX_Port: switch:admin> fcrrouterportcost 7/10 10000 See Also switchShow, fcrRouteShow, portCfgEXPort Fabric OS Command Reference Manual 53-1000436-01...

  • Page 248: Fcrrouteshow

    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 249: Fcrxlateconfig

    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. A translate domain is a phantom domain created by an FC Router.
  • Page 250 fcrXlateConfig switch: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: switch:admin> fcrxlateconfig 2 3 8 xlate domain already configured, overwrite?(n) y To clear the preferred domain ID of the translate domain created in fabric 2 that represents remote fabric 3: switch:admin>...

  • Page 251: Fddcfg

    fddCfg fddCfg Manages the fabric data distribution configuration parameters. Synopsis fddcfg [--showall | --localaccept policy_list | --localreject policy_list | --fabwideset policy_list ] Description Use this command to manage the fabric data distribution configuration parameters. These parameters control the fabric-wide consistency policy in non-secure mode. Supported policies are Switch Connection Control (SCC), Device Connection Control (DCC) and Password (PWD), which includes the account database and password policies.
  • Page 252 fddCfg switch:admin> fddcfg --localaccept “SCC;PWD” Local Switch Configured to accept policies. 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 253: Fdmicacheshow

    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 254: Fdmishow

    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. Only abbreviated FDMI information is shown for HBA and ports on remote switches.

  • Page 255: Ficonclear

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operand: database...

  • Page 256: Ficoncupset

    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. Changes to parameters are effective immediately.

  • Page 257: Ficoncupshow

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operands: fmsmode...

  • Page 258: Ficonhelp

    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> ficonhelp ficonclear Clears contents of the specified FICON management database ficoncupset Sets FICON-CUP parameters for a switch...

  • Page 259: Ficonshow

    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 Use this command to display the contents of a FICON database. The ficonShow database operand is the name of the database to display.
  • Page 260 ficonShow Incident Count Displays the incident count. This number increases by 1 for each incident within the individual switch. 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 NOS recognized...
  • Page 261 ficonShow 0xe0 Vendor specific. 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. 0x03 Input unit record, if it is an storage port;...
  • Page 262 ficonShow NL is NL_Port. 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 263 ficonShow Sequence Number: 0000000169CA tag: 102b {Fmt Type PID Registered Port WWN Registered Node WWN flag Parm 0x18 N 502e00 50:05:07:64:01:40:0f:ca 50:05:07:64:00:c1:69:ca 0x10 0x200105 Type number: 002064 Model number: Manufacturer: Plant of Manufacture: 02 Sequence Number: 0000000169CA tag: 052e To display the local and remote LIRR database: switch:admin>...
  • Page 264 ficonShow Plant of Manufacture: 02 Sequence Number: 0000000169CA tag: 2e00 Switch Port WWN Switch Node WWN Flag Node Parameters 20:2e:00:60:69:80:1e:4e 10:00:00:60:69:80:1e:4e 0x00 0x200a2e Switch Part Number: 060-0001501-05 Switch Serial Number: 0FT02X801E4E Domain: 20480 The local RLIR database has 1 entry. To display the local ILIR database: switch:user>...

  • Page 265: Filtertest

    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. FLTACT_LIST_B Action to handle the subgroup B-based filtering.
  • Page 266 filterTest -txports itemlist Specify the user port numbers to perform this test. All user ports are set by default. -scamoff offset Specify the program location to write SCAM test data in SCAM memory. The default value is 0. The maximum offset number is set if the specified number is larger than the limit.

  • Page 267: Firmwarecommit

    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 268: Firmwaredownload

    firmwareDownload firmwareDownload Downloads switch firmware from a remote host or a local directory. Synopsis firmwaredownload [[-s [-b -n]] [ [-a <sas|dmm>] [-t <slot number>] [-p <ftp|scp>][-c] [-e][host, user, pfile, passwd] Description Use this command to download switch firmware from an FTP server or from a local SSH server to the switch’s non-volatile memory.
  • Page 269 firmwareDownload Specify this operand to enable single -CP mode. This mode enables you to select or disable full install, autoreboot, and autocommit modes, on bladed and non-bladed systems. On bladed systems, this mode enables you to upgrade a single CP. When downloading the main Fabric OS firmware, this option disables autoreboot, unless overridden by the -b option.
  • Page 270 firmwareDownload Specify this option to erase all of the installed SA images in the system during SAS firmwaredown load. By default, downloading a SAS image will not remove the installed SA images. If this option is specified, the installed SA images will be removed.
  • Page 271 firmwareDownload user does not have permission on host The password for the user is not specified correctly Indicated firmware does not exist on the host, or is not in the right format, or is corrupted The FTP or SSH service is not running on host Platform is not supported by the firmware indicated.

  • Page 272: Firmwaredownloadstatus

    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 events during FOS, SAS, and SA firmwaredownload. The event log is created by the current firmwaredownload command and is kept until another firmwaredownload command is issued.
  • Page 273 firmwareDownloadStatus To display the status of a firmware download on a Brocade switch: switch:admin> firmwaredownloadstatus [1]: Fri Feb 15 22:17:03 2007 Firmware is being downloaded to the switch. This step may take up to 30 minutes. [2]: Fri Feb 15 22:20:54 2007 Firmware has been downloaded to the secondary partition of the switch.
  • Page 274 firmwareDownloadStatus Slot 8 (FR4-18i): Firmware commit has started on the blade. This may take up to 10 minutes. [10]: Mon Dec 19 18:50:51 2005 Slot 8 (FR4-18i): The commit operation has completed successfully. [11]: Mon Dec 19 18:55:39 2005 Slot 5 (CP0, active): Firmware has been downloaded successfully on Standby CP. [12]: Mon Dec 19 18:55:46 2005 Slot 5 (CP0, active): Standby CP reboots.

  • Page 275: Firmwarerestore

    firmwareRestore firmwareRestore Restores the former active firmware image. Synopsis firmwarerestore Description Use this command to restore the former active Fabric OS firmware image. This command can only be run if autocommit was disabled during the firmwaredownload. This command cannot be used to restore SAS and SA images.

  • Page 276: Firmwareshow

    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 FOS, SAS and SA versions in a Brocade switch or director. It shows the firmware versions on both the primary and secondary partitions of the storage device. Operands none Examples...

  • Page 277: Fporttest

    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 278 fportTest -ports itemlist Specify the ports to test. If itemlist is omitted, the test is executed on all online F_Ports in the specified slot. This operand is optional. -seed payload_pattern Specify the pattern of the test packets payload. Valid values are: CSPAT (default) BYTE_LFST CHALF_SQ...
  • Page 279 fportTest 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. See Also itemList, loopPortTest, portTest, spinFab Fabric OS Command Reference Manual 53-1000436-01...

  • Page 280: Fosconfig

    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. The following features are supported (see Notes for limitations): FC Routing service (see fcrConfigure) iSCSI service (see iscsiCfg) iSNS client service (see isnscCfg)
  • Page 281 fosConfig "FC Routing service is already disabled" - This means that the FC Routing service is already disabled. Use switchShow to display the current state of the FC Routing service. iSCSI The iSCSI service will be disabled on this switch. This command can be run while the switch state is "online".

  • Page 282: Frureplace

    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). The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 283: Fspfshow

    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. The following fields in the table display. TABLE 10 fspfShow Display Fields Field Description version...
  • Page 284 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] = 0x00400000 f_ports[1] = 0x00000000 seg_ports[0] = 0x00000000 seg_ports[1] = 0x00000000 active_ports[0] = 0x00400000 active_ports[1] = 0x76000000 minLSArrival minLSInterval LSoriginCount...

  • Page 285: Fwalarmsfilterset

    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. By turning on the alarms, all class alarms are generated.

  • Page 286: Fwalarmsfiltershow

    fwAlarmsFilterShow fwAlarmsFilterShow Displays alarm filtering for Fabric Watch. Synopsis fwalarmsfiltershow Description Use this command to display whether alarm filtering is enabled or disabled. This command requires a Fabric Watch license. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 287: Fwclassinit

    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 288: Fwconfigreload

    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. This command requires a Fabric Watch license. The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 289: Fwconfigure

    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 290 fwConfigure TABLE 11 fwConfigure Fabric Watch Classes and Areas Class Area Security Telnet Violations HTTP Violations API Violations RSNMP Violations WSNMP Violations SES Violations MS Violations Serial Violations Front Panel Violations SCC Violations DCC Violations Login Violations Invalid Timestamps Invalid Signatures Invalid Certificates SLAP Failures SLAP Bad Packets...
  • Page 291 fwConfigure TABLE 12 Access Gateway Mode Class Area Fabric E_Port downs Fabric reconfigure Domain ID changes Segmentation changes Zone changes Fabric<->QL Fabric logins SFP state changes FFL_Port (Optical Same as Port class FFL_Port (Copper) Same as Port class Resource class Flash area EE Performance Monitor Invalid CRCS...
  • Page 292 fwConfigure =========================================================================== envTemp001 enabled 33 C started 10:28:59 on 02/01/2000 Informative envTemp002 enabled 34 C started 10:28:59 on 02/01/2000 Informative envTemp003 enabled 36 C started 10:28:59 on 02/01/2000 Informative envTemp004 enabled 35 C started 10:28:59 on 02/01/2000 Informative envTemp005 enabled 36 C started 10:28:59 on 02/01/2000...

  • Page 293: Fwfrucfg

    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.

  • Page 294: Fwhelp

    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> fwhelp fanShow Show fan speeds fwAlarmsFilterSet Configure alarms filtering for Fabric Watch fwAlarmsFilterShow Show alarms filtering for Fabric Watch fwClassInit...

  • Page 295: Fwmailcfg

    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. Switch elements monitored by Fabric Watch are divided into classes, and email alerts are based on the classes.
  • Page 296 fwMailCfg : Set Recipient Mail Address for Email Alert : Quit Select an item => : (1..6) [6] 5 Mail Config Menu -------------------------------------- : Environment class : SFP class : Port class : Fabric class : E-Port class : F/FL Port (Optical) class : Alpa Performance Monitor class : End-to-End Performance Monitor class : Filter Performance Monitor class...

  • Page 297: Fwportdetailshow

    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 user specified ports. The output of this command is different for IPv4 and IPv6 addresses. The overall status is calculated based on the following contributors: Port Errors Number of link loss occurrences exceeded limit for time period...
  • Page 298 fwPortDetailShow --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 Report based on all offline ports If no option is specified, all ports are displayed.
  • Page 299 fwPortDetailShow Port# Type State Dur(H:M) LFA LSY LSI PER INW CRC PSC BLP STM SRX STX SCU ----------------------------------------------------------------------------- HEALTHY 409:09 HEALTHY 409:09 HEALTHY 409:09 See Also switchStatusShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 300: Fwsamshow

    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 301: Fwset

    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) This command requires a Fabric Watch license.

  • Page 302: Fwsettocustom

    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. This command requires a Fabric Watch license. The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 303: Fwsettodefault

    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. This command requires a Fabric Watch license. The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 304: Fwshow

    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. In Access Gateway mode, only the following class thresholds are supported.
  • Page 305 fwShow : End-to-End Performance Monitor class : Filter Performance Monitor class 10 : Security class 11 : Resource class 12 : Quit => : (1..12) [11] 1 Select an item 1 : Temperature 2 : Fan 3 : Power Supply 4 : return to previous page Select an area =>...
  • Page 306 fwShow (continued on next page) Event 1 occurred 10 times, last at 16:49:02 on 12/09/2011 * Event 5 occurred 1 time, last at 16:30:23 on 12/09/2011 Callbacks: No callbacks are registered. switch:admin> fwshow --port --persistence FW: current port persistence time = 18s switch:user>...
  • Page 307 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. The h command displays the 20 most recent commands typed into the shell; the oldest commands are replaced as new ones are entered.

  • Page 308: Hadisable

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 309: Hadump

    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: Local CP state (slot number and CP ID) Remote CP state (slot number and CP ID) Type of recovery (warm or cold)
  • Page 310 haDump Ethernet Subnetmask: 255.255.240.0 Fibre Channel IP Address: 220.220.220.64 Fibre Channel Subnetmask: 255.255.240.0 Ethernet IP Address: 10.32.227.66 Ethernet Subnetmask: 255.255.240.0 Host Name: cp0 Gateway IP Address: 10.32.224.1 Ethernet IP Address: 10.32.227.67 Ethernet Subnetmask: 255.255.240.0 Host Name: cp1 Gateway IP Address: 10.32.224.1 Slot 10 eth0: 10.32.227.69/20 Gateway: 10.32.224.1...

  • Page 311: Haenable

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 312: Hafailover

    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. In case the active and standby CPs are not synchronized or the system is not in redundant mode, the command aborts.

  • Page 313: Hashow

    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 Remote CP state (slot number and CP ID) High Availability (enabled or disabled) Heartbeat (up or down) Health of standby CP (healthy, failed or unknown), defined as follows:...

  • Page 314: Hasyncstart

    haSyncStart haSyncStart Enables HA state synchronization. Synopsis hasyncstart Description Use this command to enable the HA state synchronization. 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 315: Hasyncstop

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 316: Help

    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 317: Historylastshow

    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. A history record contains three lines of information.

  • Page 318: Historymode

    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 modeNew messages overwrite the oldest messages in the log. First-in modeOnce the log is full, all additional logs are discarded so that the first set of logs to fill the buffer are preserved.

  • Page 319: Historyshow

    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. Each history record contains three lines of information.
  • Page 320 historyShow Factory Part Number: 60-0001604-02 Factory Serial Number: FP00X600128 SW BLADE Slot 3 Inserted at Tue Aug 14 13:53:40 2001 Factory Part Number: 60-0001532-03 Factory Serial Number: 1013456800 CP BLADE Slot 6 Inserted at Tue Aug 14 13:59:50 2001 Factory Part Number: 60-0001604-02 Factory Serial Number: FP00X600128...

  • Page 321: Httpcfgshow

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...
  • Page 322 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 323 TABLE 14 i Command Field Description (Continued) Field Description The controlling terminal of the process (? displayed for no controlling terminal) TIME The cumulative execution time for the process The command name of the process The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operand: processID...

  • Page 324: Ifmodeset

    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 325 ifModeSet serial console port. Are you sure you really want to do this? (yes, y, no, n): [no] y Proceed with caution. Auto-negotiate (yes, y, no, n): [no] y Advertise 100 Mbps / Full Duplex (yes, y, no, n): [yes] y Advertise 100 Mbps / Half Duplex (yes, y, no, n): [yes] y Advertise 10 Mbps / Full Duplex (yes, y, no, n): [yes] y Advertise 10 Mbps / Half Duplex (yes, y, no, n): [yes] y...

  • Page 326: Ifmodeshow

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operand: interface...

  • Page 327: Interfaceshow

    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). The neighbor data structure. This data structure is allocated when a switch port becomes an E_Port.
  • Page 328 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. nbstFull Time the last finishing state, NB_ST_FULL, on this interface. &dbRetransList Pointer to the database retransmission list.
  • Page 329 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 330 interfaceShow rXmitTo = 5000 nCmdAcc nInvCmd nHloIn nInvHlo nLsuIn nLsaIn attHloOut nHloOut attLsuOut nLsuOut attLsaOut nLsaOut See Also nbrStateShow, portShow, switchShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 331: Interopmode

    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’ switches to be used in a Brocade fabric. This command must be executed on all Brocade switches in the fabric.
  • Page 332 interopMode Please run "msPlMgmtDeactivate" command to disable the Platform service. The switch effective configuration will be lost when the operating mode is changed; do you want to continue? (yes, y, no, n): [no] y Interopmode is enabled Note: It is recommended that you reboot this switch for the new change to take effect.
  • Page 333 interopMode 045600 No_Light 045700 No_Light 045800 Online F-Port 10:00:00:06:2b:0d:33:b9 045900 No_Light 045a00 No_Light 045b00 No_Light 045c00 Online EX-Port 10:00:08:00:88:04:6b:bc "m6140_8x_Native_205" (fabric id = 59 ) 045d00 Online EX-Port 10:00:08:00:88:04:6b:bc "m6140_8x_Native_205" (fabric id = 59 ) 045e00 No_Light 045f00 No_Light 04d000 Offline Disabled (Persistent) 04d100...

  • Page 334: Iodreset

    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. Disabling IOD allows fast re-routing after a fabric topology change.

  • Page 335: Iodset

    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 336: Iodshow

    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: switch:admin>...

  • Page 337: Ipaddrset

    ipAddrSet ipAddrSet Sets the IP address details for a switch or control processor (CP). Synopsis ipaddrset [-cp number] ipaddrset[-sw number] ipaddrset[-ipv6 ] ipaddrset [-cp number] ipaddrset [-sw number] ipaddrset [--add x:x:x:x:x:x:x/n | --delete] -slot number ipaddrset [--add x.x.x.x/n | --delete] ipaddrset [-eth0 | -eth1] ipaddrset-slot number ipaddrset [--add x.x.x.x | --delete]...
  • Page 338 ipAddrSet Sets the Ethernet IP address, Ethernet subnetmask, Fibre Channel IP address, and Fibre Channel subnetmask of logical switch 0. Sets the Ethernet IP address, Ethernet subnetmask, Fibre Channel IP address, and Fibre Channel Subnetmask of logical switch 1. -IPv6 Sets or deletes IPv6 addresses.

  • Page 339: Ipaddrshow

    ipAddrShow ipAddrShow Displays the IP address information for a switch or control processor (CP). Synopsis ipaddrshow [-cp cp_number] ipaddrshow [-sw sw_number] ipaddrshow - slot n ipaddrshow [-eth0 -eth1 -gate] 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 340: Ipfilter

    ipfilter ipfilter Manages the IP filter policies. Synopsis --create <policyname> -type < ipv4 | ipv6> --clone <policyname> -from <src_policyname> --show [policyname] --save [policyname] --activate <policyname> --delete <policyname> --addrule <policyname> -rule <rule_number> -sip <source IP> -dp <dest port> -proto <protocol> -act < permit | deny > --delrule <policyname>...
  • Page 341 ipfilter --clone <policyname> -from src_policyname Creates a replica of an existing IP filter policy. The cloned policy is stored in a temporary buffer with same rules as the policy it mirrored. --show [policyname] Displays the IP filter policy content for the specified policy name, or all IP filter policies if policyname is not specified.
  • Page 342 ipfilter Specifies the destination port number, a range of port numbers, or a service name. -proto Specifies the protocol type, for example tcp or udp. -act Specifies the permit or deny action associated with this rule. -rule rule_number Adds a new rule at the given rule index number that is valid between 1 and the current maximum rule number plus one.

  • Page 343: Iscsicfg

    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 ] iscsicfg --easycreate tgt -s [-h ] iscsicfg --create tgt -t target_name [-h ]...
  • Page 344 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; however, not all actions are valid for all operands.
  • Page 345 iscsiCfg --delete tgt -t target_name [-h ] 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. iSCSI LUN map parameters.
  • Page 346 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. --show ddset [-n ddset_name] [-v ] [-h ] Displays the DD set database. ddset_name is optional. fabric iSCSI-enabled switches and their operational states.
  • Page 347 iscsiCfg The operation completed successfully. 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. To create a target entry: switch:admin>...
  • Page 348 iscsiCfg 21:00:00:20:37:df:83:fc iqn.2002-12.com.brocade:21:00:00:20:37:df:83:fc Operation Succeeded 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. To display LUN maps: switch:admin>...
  • Page 349 iscsiCfg switch:admin> iscsicfg --create ddset -n myddset -d mynewdd The operation completed successfully. 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 350 iscsiCfg Initiator details are: Name IP Address iqn.1991-05.com.brocade:isi154116.englab.brocade.com 172.16.14.101 No. of targets currently accessible to the specified initiator are: 4 iqn.2222-12.com.brocade:tgt1 iqn.2222-12.com.brocade:tgt2 iqn.2002-12.com.brocade:50:06:0e:80:00:43:80:a2 iqn.2222-23.com.brocade:21:00:00:20:37:df:83:fc To display all targets that are accessible by a specified initiator switch:admin> iscsicfg --show initiator -i iqn.1991-05.com.brocade:initiator1 The operation completed successfully.

  • Page 351: Iscsichiptest

    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 Specifies the slot number that the diagnostic will operate on.

  • Page 352: Iscsihelp

    iscsiHelp iscsiHelp Displays a list of iSCSI support commands. Synopsis iscsihelp -fclunquery [-w <wwn> | -s] - iscsiportcfg --clearstats <slot>/ge<port>, --default <slot>/ge<port> --show <slot>/ge<port> [-v] --modify <slot>/ge<port> <option> Description Use this command to display a list of iSCSI support commands, with descriptions. Operands This command has the following iscsi support commands and operands: -fclunquery [-w <wwn>...
  • Page 353 iscsiHelp Examples To display the list of iSCSI support commands: switch:admin> iscsihelp fclunquery Display a list of LUNs of FC target(s). fosconfig Enable/disable FabOS services iscsicfg Manage/display all iscsi configuration including authentication/virtual targets/discovery domains. iscsiportcfg Manage/display iscsi protocol related port configuration including negotiated parameters/port statistics/current sessions.

  • Page 354: Iscsipathtest

    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 355: Iscsiportcfg

    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. Setting Default Error recovery level...
  • Page 356 iscsiPortCfg NOTE This parameter only supports FC4-16IP blades in Brocade 48000 directors. geport Specifies the port number of a GbE port to be configured in the specified slot. Use -h on any option to display the help text for it. Examples To modify the port parameters: switch:admin>...
  • Page 357 iscsiPortCfg iSCSI Task Reassign: Non FCP in PDU: Non FCP in Octet: 2576 Non FCP out PDU: Non FCP out Octet: 1352 Session details: Session Number: iSCSI Session Type: Normal Initiator Name: iqn.1991-05.com.microsoft:win-iscsi.lab Target Name: iqn.2002-12.com.tgt:21:00:00:04:cf:5d:cf:0e ISID: 0x400001370000 See Also fosConfig, iscsiCfg, iscsiSessionCfg Fabric OS Command Reference Manual 53-1000436-01...

  • Page 358: Iscsisessioncfg

    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 an iSCSI session/connection.
  • Page 359 iscsiSessionCfg Default time to retain Default time to wait Error recovery level Initial R2T iSCSI Operating Login Parameters: Connection Level Connection Index: Parameter Name Self Value Peer Value Max. Recv. Data Segment Length 56KB 64KB Header Digest Data Digest Immediate Data iSCSI Connection Statistics iSCSI in PDU: 23100...

  • Page 360: Iscsiswcfg

    iscsiswcfg iscsiswcfg Displays or configures iSCSI switch level configuration. Synopsis iscsiswcfg --enableconn -s slot number|all iscsiswcfg --disableconn -s slot number|all iscsiswcfg --showconn -s slot number|all iscsiswcfg --modifygw -t target name iscsiswcfg --showgw Description Use this command to display or configure iSCSI switch level confugration. The iSCSI switch level configurations are the iSCSI connection redirection and target name prefix.
  • Page 361 iscsiswcfg See Also fosConfig, iscsiCfg, iscsiPortCfg Fabric OS Command Reference Manual 53-1000436-01...

  • Page 362: Iscsitargetname

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operands: --show...

  • Page 363: Islshow

    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 364: Isnsccfg

    isnscCfg isnscCfg iSNS Client Configure. Synopsis isnsccfg --set slot/geport -s server_ip isnsccfg --set -m -s server_ip isnsccfg --reregister isnsccfg --show isnsccfg --clear Description Use this command to display and update the configuration state of the iSNS client daemon. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operands: --set...
  • Page 365 isnscCfg Initiated re-register of iSNS objects with iSNS server To clear the IP address of iSNS server: switch:admin> isnsccfg --clear Cleared iSNS server configuration. See Also none Fabric OS Command Reference Manual 53-1000436-01...

  • Page 366: Itemlist

    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 hex = 0x hex digit | hex hex digit digit = 0|1|2|3|4|5|6|7|8|9 hex digit = digit |A|B|C|D|E|F|a|b|c|d|e|f...
  • Page 367 itemList The exact type of list varies, depending on the test and the parameter; however, the most common are blade ports and user ports. A list of blade ports is most commonly used by ASIC-level tests such as cmiTest or turboRamTest and represents which ports on the current blade (specified with --slot number) are tested.

  • Page 368: Killtelnet

    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 369: Licenseadd

    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. A license key is a string of approximately 16 upper- and lowercase letters and numbers.

  • Page 370: Licensehelp

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 371: Licenseidshow

    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. For dual-domain systems, a single license enables both logical switches to use these products.

  • Page 372: Licenseport

    licensePort licensePort Manages the Dynamic Ports On Demand (POD) license assignment. Synoposis licensePort --release portnum licensePort --reserve portnum licensePort --show lcensePort --method selection Description Use this command to manage the Dynamic Ports on Demand license assignments. In the Dynamic POD method, the ports are assigned to a POD license in order to come online until they equal the number of online licensed ports.
  • Page 373 licensePort 5 ports are assigned to the first POD license Ports assigned to the base switch license: 0, 1, 2, 3, 4, 5, 6, 7, 15, 16 Ports assigned to the first POD license: 8, 9, 17, 18, 19 Ports assigned to the second POD license: 10, 11, 12, 13, 14 [Note: these ports cannot be activated due to an insufficient number of installed POD licenses.

  • Page 374: Licenseremove

    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. When the key has been entered, use the licenseShow command to verify that the key has been removed and the licensed product uninstalled.

  • Page 375: Licenseshow

    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.

  • Page 376: Linkcost

    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 377 linkCost cost Specify the new cost of the link connected to the specified port number. If cost is 0, this port will then revert to its default link cost. This operand is optional. If omitted, this command displays the cost of the specified port. If no operands are specified, the current link costs for all ports on the switch.

  • Page 378: Login

    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. If the user was originally connected using a telnet or rlogin session, that session is left open.

  • Page 379: Logout

    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. The exit command is accepted as a synonym for logout, as is Ctrl-D at the beginning of a line. Operands none Examples...

  • Page 380: Loopporttest

    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 381 loopPortTest -ports itemlist Specify a list of user ports to test. By default, all user ports in the current slot are tested. Refer to itemList for more information on selecting ports. -seed payload_pattern Specify the seed pattern of the test packets. The data types are: CSPAT 0x7e, 0x7e, 0x7e, 0x7e, ...

  • Page 382: Lsanzoneshow

    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. The LSAN zones are identified by the text string “lsan_”...
  • Page 383 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, switchShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 384: Lsdbshow

    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. There are two types of database entries: The link state database entry, which is permanently allocated.
  • Page 385 lsDbShow TABLE 17 lsDbShow Display Fields (Continued) Field Description advertiser ID (domain number) of the switch that originated this LSR. incarn Incarnation number of this LSR. length Total length, in bytes, of this LSR. Includes header and link state information for all links. chksum Checksum of total LSR, with exception of lsAge field.
  • Page 386 lsDbShow options = 0x0 lsId advertiser incarn = 0x80000014 length = 284 chksum = 0x8453 linkCnt = 16, flags = 0x0 LinkId = 2, out port = 16, rem port = 48, cost = 500, costCnt = 0, type = 1 LinkId = 2, out port = 17, rem port =...

  • Page 387: Memshow

    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. The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 388: Minicycle

    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 389 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: The number of frames requested is met on all selected ports.
  • Page 390 miniCycle -spd_mode mode Specifies the speed mode for the test. This parameter is only used for Bloom and Condor ASIC-based products, for which this parameter controls the speed at which each port operates. For 1 Gbit/sec-only products, this parameter is ignored.
  • Page 391 miniCycle Duration 0 hr, 1 min & 4 sec (0:1:4:409). passed. 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 ..... One moment please ...
  • Page 392 miniCycle 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, itemList, portLoopbackTest, portRegTest, spinSilk, sramRetentionTest Fabric OS Command Reference Manual 53-1000436-01...

  • Page 393: Minispropshow

    minisPropShow minisPropShow Displays ASIC pair properties. Synopsis minispropshow [slotnumber/]asicpair | [--slot slotnumber] -all Description Use this command to display the ASIC pair properties. This command is not intended for normal user operation and is available to provide supplemental information during system debug. Operands The operands are as follows: slotnumber/asicpair...

  • Page 394: Mscapabilityshow

    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. Reliable commit service (RCS) is a fabric-wide capability and is supported only if all the switches in the fabric support RCS.

  • Page 395: Msconfigure

    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. This application is located at the Fibre Channel well-known address, 0xFFFFFA.
  • Page 396 msConfigure done ... See Also msCapabilityShow, msPlatShow, msPlClearDB, msPlMgmtActivate, msPlMgmtDeactivate, msTdDisable, msTdEnable, msTdReadConfig, secPolicyShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 397: Msplatshow

    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 398: Msplatshowdbcb

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 399: Msplcleardb

    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 400: Msplmgmtactivate

    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. If successful, the change takes effect immediately and commits the changes to nonvolatile storage of each switch.

  • Page 401: Msplmgmtdeactivate

    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.

  • Page 402: Mstddisable

    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. This change takes effect immediately and commits to the configuration database for all switches;...

  • Page 403: Mstdenable

    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. This change takes effect immediately and commits to the configuration database for all affected switches.

  • Page 404: Mstdreadconfig

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 405: Myid

    myId myId Displays the current login session details. Synopsis myid Description Use this command to display all local IPv4 or IPv6 addresses associated with the status of the system and the login session details. The login session gives details of the following: CP/switch (or console/serial port) used to log in The IP address of the current login session for telnet or the name of the current console port or the serial port (if modem login used)

  • Page 406: Nbrstateshow

    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 407: Nbrstatsclear

    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 408 nbrStatsClear Interface 0 data structure: nghbP = 0x1004ce68 ifNo masterPort = 0 (self) defaultCost = 500 cost = 500 (output truncated) nCmdAcc nInvCmd nHloIn nInvHlo nLsuIn nLsaIn attHloOut nHloOut attLsuOut nLsuOut attLsaOut nLsaOut See Also interfaceShow, portShow, switchShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 409: Nodefind

    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 410 nodeFind FC4s: FCP [SEAGATE ST336605FC 0003] Fabric Port Name: 20:14:00:60:69:80:04:79 Permanent Port Name: 22:00:00:04:cf:9f:26:7e Device type: Physical Target Port Index: 20 Share Area: No Device Shared in Other AD: No Aliases: a320 To display all the device information matching the WWN "20:00:00:e0:8b:01:ce:d3": switch:user>...

  • Page 411: Nsaliasshow

    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. The following message is displayed if there is no information in this switch: There is no entry in the Local Name Server The command nsAllShow displays information from all switches.
  • Page 412 nsAliasShow 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: 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 Aliases: DeviceAlias 0214e2;...
  • Page 413 nsAliasShow 0214e8; 3;21:00:00:fa:ce:04:83:c9;20:00:00:fa:ce:04:83:c9; 0 FC4s: FCP [STOREX RS2999FCPH3 NS09] Fabric Port Name: 20:04:00:60:69:01:44:22 Permanent Port Name: 21:00:00:fa:ce:04:83:c9 Aliases: 0214ef; 3;21:00:00:ad:bc:04:6f:70;20:00:00:ad:bc:04:6f:70; 0 FC4s: FCP [STOREX RS2999FCPH3 JB09] Fabric Port Name: 20:04:00:60:69:01:44:22 Permanent Port Name: 21:00:00:ad:bc:04:6f:70 Aliases: The Local Name Server has 6 entries } To display local NS information with aliases with the -r and -t options: switch:admin>...

  • Page 414: Nsallshow

    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. If the type operand is supplied, only devices of specified FC-PH type are displayed. If type is omitted, all devices are displayed.

  • Page 415: Nscamshow

    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. The message “No Entry found!” displays if the NS cache manager does not discover new switches or new devices in the fabric.
  • Page 416 nscamShow nscam show for remote switches: Switch entry for 2 state owner known v430 0xfffc01 Device list: count 1 Type Pid PortName NodeName 021200; 2,3;10:00:00:60:69:00:ab:ba;10:00:00:60:69:00:ab:ba; FC4s: FCIP PortSymb: [28] "SEAGATE ST318452FC 0001" Fabric Port Name: 20:02:00:60:69:00:68:19 Permanent Port Name: 10:00:00:60:69:00:ab:ba Switch entry for 4 state owner...

  • Page 417: Nsshow

    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 The nsAllShow command displays information from all switches.
  • Page 418 nsShow SCR=2 Nx_Port detected registration. Register to receive all RSCN requests issued for events detected by the affected Nx_Port. SCR=3 Register to receive all RSCN request issued. The RSCN request returns all effected N_Port_ID pages. Displays the device type. Of the two device type parts, the first part indicates the origination of the device.
  • Page 419 nsShow 010100; 3;21:00:00:e0:8b:13:08:10;20:00:00:e0:8b:13:08:10; 1 FC4s: FCP NodeSymb: [41] "QLA2340 FW:v3.03.06 DVR:v9.0.0.2 (w32 IP)" Fabric Port Name: 20:01:00:05:1e:34:00:70 Permanent Port Name: 21:00:00:e0:8b:13:08:10 Port Index: 1 Share Area: No Device Shared in Other AD: No Redirect: No 010e00; 3;21:00:00:e0:8b:12:8a:be;20:00:00:e0:8b:12:8a:be; 1 FC4s: FCP NodeSymb: [41] "QLA2340 FW:v3.03.06 DVR:v9.0.0.2 (w32 IP)"...

  • Page 420: Nszonemember

    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 421 nsZoneMember 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 0416e2; 3;22:00:00:20:37:d9:6b:b3;20:00:00:20:37:d9:6b:b3; 0 FC4s: FCP [SEAGATE ST318304FC 0005] Fabric Port Name: 20:06:00:60:69:50:06:78 Permanent Port Name: 22:00:00:20:37:d9:6b:b3 Device type: Physical Target 0416e4; 3;22:00:00:20:37:d9:61:ac;20:00:00:20:37:d9:61:ac; 0 FC4s: FCP [SEAGATE ST318304FC 0005] Fabric Port Name: 20:06:00:60:69:50:06:78 Permanent Port Name: 22:00:00:20:37:d9:61:ac...
  • Page 422 nsZoneMember Pid: 0xba1ae4 Aliases: trimm100a_2 To display all the unzoned devices in the fabric: switch:admin> nszonemember -u Pid: 0xb01ea9; Aliases: trimm32b_1 Pid: 0xb01eaa; Aliases: trimm32b_2 Pid: 0xb01eab; Aliases: trimm32b_3 Pid: 0xb01eac; Aliases: trimm32b_4 Pid: 0xb01fad; Aliases: trimm32a_5 Pid: 0xb01fae; Aliases: trimm32a_6 Pid: 0xb01fb1;...

  • Page 423: Passwd

    passwd passwd Changes the password for the specified user. Synopsis passwd ["user"] Description Use this command to change a user account password. The passwd command is allowed on all switches in the fabric unless the fabric is configured for security when Secure Fabric OS is enabled. If you issue this command without any argument, the password is changed for the current login account only.
  • Page 424 passwd • If you are logged in as the root user when changing another user’s password, you are not prompted to enter the old password. • The command is disabled until you have changed all the login passwords from the manufacture default values.
  • Page 425 passwd Password unchanged You have entered the carriage return special input case, choosing not to change the password. Passwords do not match You have not correctly verified the new password. Invalid length of password You have entered password length not between minlength and 40. Insufficient number of lower case letters You have entered a password that contains less then the minimum required number of lowercase characters.

  • Page 426: Passwdcfg

    passwdCfg passwdCfg Manages the password policies. Synopsis passwdcfg --set [-lowercase value][-uppercase value][-digits value][-punctuation value] -minlength value -history value -minpasswordage value -maxpasswordage value -warning value -lockoutthreshold value -lockoutduration value -repeat value -sequence value --disableadminlockout --enableadminlockout --setdefault --showall --set --help Description Use this command to manage password policies. When secure mode is enabled, passwdCfg is not supported.
  • Page 427 passwdCfg The password expiration policy forces expiration of a password after a configurable period of time. When a user’s password expires, the user must change the password to complete the authentication process and open a user session. A warning that password expiration is approaching is displayed when the user logs in.
  • Page 428 passwdCfg -history value Specifies the number of past password values that are disallowed when setting a new password. A value of 1 to 24 can be specified. The default value is 1. -minpasswordage value Specifies the minimum number of days that must elapse before a password can be changed.
  • Page 429 passwdCfg --disableadminlockout Disables the admin lockout policy if already enabled and will set the config parameter "passwdcfg.adminlockout" to 0. By default, admin lockout policy is disabled. --setdefault Resets all password policies to default values. --showall Displays all the password configuration parameters. -repeat value Specifies the length of repeated character sequences that will be disallowed.For example, if the "repeat"...
  • Page 430 passwdCfg Invalid command line option An unrecognized command line option was specified. minlength value out of range The -minlength value must 8 to 40. lowercase value out of range The -lowercase value specified must be greater than or equal to 0 and less than or equal to -minlength value.

  • Page 431: Pathinfo

    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. This routing information describes the exact path that a user data stream takes to go from the source port to the destination port, including all intermediate switches.
  • Page 432 pathInfo 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 433 pathInfo The source route can specify a partial route from source to destination (in which case the remaining hops are chosen as the path from the input port or area on the first hop not listed in the source route to the destination), as a full route, or as an arbitrary route across the fabric.
  • Page 434 pathInfo Timeout The maximum time allowed to wait for the response; default is 10 seconds. 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 435 pathInfo In Port Domain ID (Name) Out Port Cost --------------------------------------------------------- 8 (web228) (output truncated) See Also portStatsShow, switchShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 436: Pdshow

    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. When executed without any arguments, this command displays output from the latest panic dump file available on the switch.

  • Page 437: Perfaddeemonitor

    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: For frames received at the port, the frame SID is the same as SourceID and frame DID is the same as DestID, both RX_COUNT and CRC_COUNT will be updated accordingly.
  • Page 438 perfAddEEMonitor Optionally, a comma can separate the operands. SourceID and DestID also can be enclosed in quotation marks. A space is required to separate the operands even when using commas. Examples To add an end-to-end monitor to blade 1 port 2: switch:admin>...

  • Page 439: Perfaddipmonitor

    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. After a successful execution of this command, a monitor number is displayed. The monitor number is provided for manipulation of these filter-based performance monitors.

  • Page 440: Perfaddreadmonitor

    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. Only frames transmitted are counted. After successful execution of this command, a monitor number is displayed.

  • Page 441: Perfaddrwmonitor

    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. Only frames transmitted are counted. After a successful execution of this command, a monitor number is displayed.

  • Page 442: Perfaddscsimonitor

    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. After a successful execution of this command, a monitor number is displayed. The monitor number is provided for manipulation of these filter-based performance monitors.

  • Page 443: Perfaddusermonitor

    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 444 perfAddUserMonitor SOFi1 SOFn1 SOFi2 SOFn2 SOFi3 SOFn3 alias Specify a name for this monitor. This string truncates to a maximum of 10 characters. It might be surrounded by quotation marks, in order to include spaces. This operand is optional. By default, the alias is an empty string. Examples To add a filter-based monitor for all Extended Link Service requests (R_CTL=0x22 and TYPE=0x01) to a port:...

  • Page 445: Perfaddwritemonitor

    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. Only frames transmitted are counted. After a successful execution of this command, a monitor number is displayed.

  • Page 446: Perfcfgclear

    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. 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.

  • Page 447: Perfcfgrestore

    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; rather, it restores the configuration on nonvolatile memory. Any configuration changes that were not saved are lost using the perfCfgRestore command.

  • Page 448: Perfcfgsave

    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. The number of monitors saved to flash memory has the following limitations: 16 EE monitors 16 filter monitors...

  • Page 449: Perfclearalpacrc

    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. This command requires a Brocade Advanced Performance Monitoring license.

  • Page 450: Perfcleareemonitor

    perfClearEEMonitor perfClearEEMonitor This command is deprecated; use perfMonitorClear instead. 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. Issuing portStatsClear on a port also results in all end-to-end monitors clearing.

  • Page 451: Perfclearfiltermonitor

    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. Issuing portStatsClear on a port also results in all filter-based monitors clearing. This command requires a Brocade Advanced Performance Monitoring license.

  • Page 452: Perfdeleemonitor

    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. 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.

  • Page 453: Perfdelfiltermonitor

    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. 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.

  • Page 454: Perfhelp

    perfHelp perfHelp Displays performance monitoring help information. Synopsis perfhelp Description Use this command to display the available performance monitoring help commands. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples To display commands related to performance monitoring: switch:admin>...

  • Page 455: Perfmonitorclear

    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 456 perfMonitorClear 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, perfMonitorShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 457: Perfmonitorshow

    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). ISL monitors are automatically activated on E_Ports (not including trunk slaves).
  • Page 458 perfMonitorShow Num_domains Total number of domains being monitored Domain_count 64-bit cumulative transmit counter for each individual domain 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.
  • Page 459 perfMonitorShow 4.9m 53m 4.9m 0 4.9m 53m 4.9m 4.4m 53m 4.4m 0 4.4m 53m 4.4m 4.8m 53m 4.8m 0 4.8m 53m 4.8m 4.6m 53m 4.6m 0 4.6m 53m 4.6m 5.0m 53m 5.0m 0 5.0m 53m 5.0m 4.8m 53m 4.8m 0 4.8m 53m 4.8m 4.5m...
  • Page 460 perfMonitorShow KEY SID OWNER_APP TX_COUNT RX_COUNT -------------------------------------------------------------------------- 0 0x58e0f 0x1182ef TELNET N/A 0x0000000000000000 0x0000000000000000 0 0x21300 0x21dda TELNET N/A 0x0000000067229e65 0x0000000000000000 1 0x21300 0x21ddc TELNET N/A 0x0000000067229e65 0x0000000000000000 2 0x21300 0x21de0 TELNET N/A 0x0000000067229e87 0x0000000000000000 6 0x11000 0x21fe0 WEB_TOOLS 0x00000004d0baed41 0x0000000067229e9 CRC_COUNT OWNER_IP_ADDR...

  • Page 461: Perfsetporteemask

    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 462 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. For example, "00:ff:00" uses only the Area ID to trigger the EE monitor.

  • Page 463: Perfshowalpacrc

    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 464: Perfshoweemonitor

    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. 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.
  • Page 465 perfShowEEMonitor switch:admin> perfshoweemonitor 0 OWNER_APP TX_COUNT ----------------------------------------------------- 0x112233 0x223344 TELNET 0x00000000000 RX_COUNT CRC_COUNT OWNER_IP_ADDR ------------------------------------------------------ 0x0000000000000000 0x0000000000000000 To display end-to-end monitor frame traffic on a port at an interval of every 6 seconds: perfshoweemonitor 4/5 6 switch:admin> perfshoweemonitor 53, 6: Tx/Rx are # of bytes and crc is # of crc errors ------------- ------------- -------------...

  • Page 466: Perfshowfiltermonitor

    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. This command has been deprecated; perfMonitorShow is preferred. Refer to perfMonitorShow for details regarding this command’s output.
  • Page 467 perfShowFilterMonitor To display filter monitor information on a port: switch:admin> perfshowfiltermonitor 2/5 There are 7 filter-based monitors defined on port 21. ALIAS OWNER_APP FRAME_COUNT OWNER_IP_ADDR ----------------------------------------------------------------- SCSI_Frame TELNET 0x00000000002c2229 SCSI_WR TELNET 0x000000000000464a SCSI_RW TELNET 0x000000000000fd8c SCSI_RW WEB_TOOLS 0x0000000000007ba3 192.168.169.40 SCSI_RW WEB_TOOLS 0x0000000000004f0e 192.168.169.190...

  • Page 468: Perfshowporteemask

    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. There are only two commands that can modify the value of the EE mask: perfSetPortEEMask and perfCfgRestore.
  • Page 469 perfShowPortEEMask RxSID ALPA: RxDID Domain: RxDID Area: RxDID ALPA: See Also perfAddEEMonitor, perfDelEEMonitor, perfSetPortEEMask, perfShowEEMonitor Fabric OS Command Reference Manual 53-1000436-01...

  • Page 470: Pkicreate

    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. The switch certificate should be obtained offline from Certificate Authority.

  • Page 471: Pkiremove

    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. In secure mode, this command displays a message and does not remove PKI objects. The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 472: Pkishow

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 473: Policy

    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 seconds] Description Use this command to display or modify the encryption and authentication algorithms for security policies.
  • Page 474 policy -seclife seconds Security association lifetime in seconds. A new key is renegotiated before seconds expires. seconds must be between 28800 to 250000000 or 0. The default is 28800. 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 -----------------------------------------...
  • Page 475 policy Authentication Algorithm: SHA-1 Encryption: AES-128 SA Life (seconds): 28800 Operation Succeeded 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 476: Portalpashow

    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. If the specified port is not an active FL_Port or if no AL_PAs are present, this command prints an error.

  • Page 477: Portbuffershow

    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.
  • Page 478 portBufferShow When there is no connection to a port or the port is disabled, or the port is not an E_Port some of the information in this display is not relevant, such as long distance mode, needed buffers, and link distance.

  • Page 479: Portcamshow

    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. Note that each CAM entry (either SID or DID CAM) can be shared among a certain number of ports, depending on the ASIC.
  • Page 480 portCamShow switch:admin> portcamshow 7/31 -------------------------------------------------- Area SID used DID used SID entries DID entries 03b380 03cf80 034100 03cf00 03cf00 03cf80 -------------------------------------------------- SID free, DID free: (2044, 1020) The SID entry 03cf00 and DID entry 03cf80 on port 7/31 belong to port 7/39. To display the filter CAM utilization for all ports on a switch: switch:user>...

  • Page 481: Portcfg

    portCfg portCfg Enables or disables a port's configuration. Synopsis portcfg action [slot/][ge]port [-Range] 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, and to configure FC fastwrite on the FC ports.
  • Page 482 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. The value of this key must be at least 12 bytes. This argument must be used together with -ike and -ipsec.
  • Page 483 portCfg -r retransmissions 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. If the user changes this value, the value specified must be greater than the calculated value.
  • Page 484 portCfg iipaddr Specifies the interface protocol as IP and the IP address on the GbE port. Use this parameter to bring up a native IP interface for link-level diagnostics, connectivity, and characterization of SLA. Specify the IP address on this GigE port.
  • Page 485 portCfg Valid modes for fastwrite are: --disable Disables FC Fastwrite --enable Enables FC Fastwrite Examples To add an ARP entry: switch:admin> portcfg arp ge0 add 192.168.255.25 00:01:02:03:04:60 Operation Succeeded To create an IP interface: switch:admin> portcfg ipif 4/ge0 create 192.168.100.50 255.255.255.0 1500 Operation Succeeded To create a static IP route: switch:admin>...
  • Page 486 portCfg where AN:AutoNegotiate, ..:OFF, ??:INVALID. LM:L0.5 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 AN AN AN AN AN AN AN AN AN AN AN AN...

  • Page 487: Portcfgdefault

    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. You can view the current port configuration using the portCfgShow command.

  • Page 488: Portcfgeport

    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. When a port is configured as a non-E_Port through this command, an ISL connected to this port is segmented.

  • Page 489: Portcfgexport

    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. This command also displays and changes a port’s EX_Port configuration.
  • Page 490 portCfgEXPort -e edtov Specify the E_D_TOV used for port negotiation. Valid values are 1000 - 60000. This operand is only applicable if the "Fabric Parameter" attribute value is not "Auto Negotiate". -d domainid Specify the preferred domain ID. Valid values are 1-239. -p pidformat Specify the Port ID format.
  • Page 491 portCfgEXPort switch:admin> portcfgexport 2/0 -t 2 See Also portCfgVEXPort, portDisable, portEnable, portShow, portCfgDefault, fcrbcastconfig Fabric OS Command Reference Manual 53-1000436-01...

  • Page 492: Portcfggport

    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. A port designated as a G_Port can become an E_Port.

  • Page 493: Portcfgislmode

    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. Refer to the configure command for more information on the core PID format.
  • Page 494 portCfgISLMode 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 495: Portcfglongdistance

    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. The port can be used only as an E_Port. This configuration can be cleared but not set on VE/VEX_Ports.
  • Page 496 portCfgLongDistance desired_distance is a required parameter to configure a port as an LD and LS-mode link. For an LD-mode link, the desired distance is used as the upper limit of the link distance to calculate buffer availability for other ports in the same port group. When the measured distance is more than desired_distance, the desired_distance is used to allocate the buffers.
  • Page 497 portCfgLongDistance vc_translation_link_init Specifies the long-distance link-initialization sequence; 1 activates and 0 deactivates this mode. When the command is run without specifying a value, 1 is assigned automatically for the long-distance link in VC_RDY flow control; otherwise, 0 is assigned. This operand is optional. desired_distance Refer to the “Description”...

  • Page 498: Portcfglport

    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. By default, the L_Port is a public L_Port. It could be set to private L_Port and the FLOGI will be rejected.
  • Page 499 portCfgLPort where AN:AutoNegotiate, ..:OFF, ??:INVALID. To display the L_Port conditions: switch:admin> portcfglport [output from other slots suppressed] Ports of Slot 4 9 10 11 12 13 14 15 -----------------+--+--+--+--+----+--+--+--+----+--+--+--+----+--+--+-- Locked L_Port ......

  • Page 500: Portcfgnport

    portCfgNPort portCfgNPort Enables and disables N_Port functionality for an Access Gateway port. Synopsis portcfgnport [port_number] | [mode] Description Use this command to configure the Access Gateway port as an N_Port in the case where the AG port is connected to the enterprise fabric. The enabled N_Port will automatically come online if it is connected to the enterprise fabric switch that supports NPIV.

  • Page 501: Portcfgnpivport

    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. By default, NPIV is enabled for all Condor ASIC-based ports and disabled for all Bloom ASIC-based ports.
  • Page 502 portCfgNPIVPort Trunk Port ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON Long Distance ........ VC Link Init ..

  • Page 503: Portcfgpersistentdisable

    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. The persistent disable configuration overrides all other port configurations but it does not change the configuration of any other port settings.

  • Page 504: Portcfgpersistentenable

    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. A persistent port enable reenables all previously set port configurations of that port.

  • Page 505: Portcfgshow

    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 506 portCfgShow ISL R_RDY Mode Displays as ON when the port has ISL R_RDY mode enabled or blank (..) when the port is ISL R_RDY mode disabled. This value is set by the portCfgISLMode command. RSCN Suppression Displays as ON when the port has RSCN suppression enabled or blank (..) when the port has RSCN suppression disabled.
  • Page 507 portCfgShow Min Retransmit Time 100 Keepalive Timeout 10 Max Retransmissions 8 DSCP Marking (Control): 10, DSCP Marking (Data): 50 To display the configuration settings for a port: switch:admin> portcfgshow ge0 Persistent Disable: Mode: FCIP Ipif configuration: Interface IP Address NetMask ---------------------------------------------------------- 192.168.255.107 255.255.255.0 1500...

  • Page 508: Portcfgspeed

    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. The configuration is saved in nonvolatile memory and is persistent across switch reboots or power cycles.

  • Page 509: Portcfgtrunkport

    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 or switchCfgTrunk commands. When the command is executed to update the trunking configuration, the ports for which the configuration applies are disabled and reenabled with the new trunk configuration.

  • Page 510: Portcfgvexport

    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 pidformat][-t fabric_parameter] Description Use this command to configure a port as an VEX_Port. This command also displays the port’s VEX_Port configuration, or changes the configuration.
  • Page 511 portCfgVEXPort 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: 10:00:00:60:69:c0:05:8a Fabric Parameters: Auto Negotiate R_A_TOV: 9000(N) E_D_TOV: 2000(N) Edge fabric's primary wwn: N/A Edge fabric's version stamp: N/A To set the fabric ID of port 2/21 to 5 and the port ID format to core: switch:admin>...

  • Page 512: Portcmd

    portCmd portCmd Diagnoses intelligent ports. Synopsis portcmd --ipperf [slot/]ge port -s src_ip -d dst_ip -S | -R [-i interval] [-p port] [-r committed_rate] [-t running_time] [-z size] [-q diffserv] portcmd --ping [slot/]ge port -s src_ip -d dst_ip [-n num_requests] [-q service_type] [-t ttl] [-w wait_time] [-z size] portcmd --traceroute [slot/]ge port -s src_ip -d dst_ip [-h max_hops] [-f first_ttl] [-q type_of_service] [-w timeout] [-z size]...
  • Page 513 portCmd -r committed_rate Specifies committed rate for the data 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 514 portCmd -d dst_ip Specifies the destination IP address to which to target the ping request. -n num_requests Specifies the number of ping requests. The default is 4. This operand is optional. -q service_type Specifies the type of service in the ping request. The default is 0 and service_type must be an integer from 0 to 255.
  • Page 515 portCmd Examples To verify if packets can be sent to the destination IP address: switch:admin> portcmd --ping 3/ge0 -s 193.10.2.1 -d 193.10.2.49 Pinging 193.10.2.49 from ip interface 193.10.2.1 on 3/ge0 with 64 bytes of data Reply from 193.10.2.49: bytes=64 rtt=0ms ttl=64 Reply from 193.10.2.49: bytes=64 rtt=0ms ttl=64 Reply from 193.10.2.49: bytes=64 rtt=0ms ttl=64 Reply from 193.10.2.49: bytes=64 rtt=0ms ttl=64...

  • Page 516: Portdebug

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operands: dbg_lvl...

  • Page 517: Portdisable

    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 518: Portenable

    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 519: Porterrshow

    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 frames rx...
  • Page 520 portErrShow See Also portShow, portStatsShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 521: Portflagsshow

    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. Valid values are In_Sync and No_Light. Flags Displays whether there is an SFP inserted in the port, whether the port is active, and the port type.

  • Page 522: Portledtest

    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. The SPEED LEDs are initially set to black before the command execution.

  • Page 523: Portlogclear

    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. If the port log is disabled, portLogClear enables it.

  • Page 524: Portlogconfigshow

    portLogConfigShow portLogConfigShow Displays the current port log configuration. Synopsis portlogconfigshow Description Use this command to display the current port log configuration. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples To display the current port log configuration: switch:admin>...

  • Page 525: Portlogdisable

    portLogDisable portLogDisable Disables the port log facility. Synopsis portlogdisable Description Use this command to disable the port log facility. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands None. Examples To display the port log facility: switch:admin>...

  • Page 526: Portlogdump

    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 between each page.

  • Page 527: Portlogdumpport

    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. It is identical to portLogShowPort, except that portLogShowPort prompts the user to press Enter between each page.

  • Page 528: Portlogenable

    portLogEnable portLogEnable Enables the port log facility. Synopsis portLogEnable Description Use this command to enable the port log facility. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands None. Examples To enable the port log facility. switch:admin>...

  • Page 529: Portlogeventshow

    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). The execution of this command is subject to Admin Domain restrictions that may be in place.
  • Page 530 portLogEventShow xfree xerr xstate seqst payload zone event switch ficonq 53 routing See Also portLogTypeDisable, portLogTypeEnable Fabric OS Command Reference Manual 53-1000436-01...

  • Page 531: Portloginshow

    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: FDISC, Discover F_Port Service Parameters or Virtual N_Port login.

  • Page 532: Portlogpdisc

    portLogPdisc portLogPdisc Sets or clears the debug_pdisc_flag. Synopsis portlogpdisc lvl Description Use this command to set or clear the debug_pdisc_flag. 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 533: Portlogreset

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 534: Portlogresize

    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. The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 535: Portlogshow

    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. The portLogShow command displays the same information as portLogDump, but it enables you to press Enter after each page of output.
  • Page 536 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 nsRemQ...
  • Page 537 portLogShow enable Mode: 0 normal; non-zero loopback Tx & Rx Header 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 Argument 0 is divided into two 16-bit fields: [A] a bit map indicating whether subsequent args are valid (0001 means argument 1 is valid, 0003 means arguments 1 and 2 are valid).
  • Page 538 portLogShow Online Offline Testing Faulty E_Port F_Port Segmented pstate AC Active State LR1 Link Reset: LR Transmit State LR2 Link Reset: LR Receive State LR3 Link Reset: LRR Receive State LF1 Link Failure: NOS Transmit State LF2 Link Failure: NOS Receive State OL1Offline: OLS Transmit State OL2Offline: OLS Receive State OL3Offline: Wait for OLS State...
  • Page 539 portLogShow For a full explanation of the information displayed by this command, refer to the Fabric OS Administrator’s Guide. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operands: count Specify the maximum number of lines to display.

  • Page 540: Portlogshowport

    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. It is identical to portLogDumpPort, except that portLogDumpPort does not prompt the user to press Enter between each page of output.

  • Page 541: Portlogtypedisable

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operand: Specify a nonzero value that corresponds to the port log type to be disabled.

  • Page 542: Portlogtypeenable

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operand: Specify a nonzero value that corresponds to the port log type to be enabled.

  • Page 543: Portloopbacktest

    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. The loopback is done at the parallel loopback path.
  • Page 544 portLoopbackTest --slot number Specify the slot number on which the diagnostic will operate. The ports specified will be relative to this slot number. The default is set to 0 and designed to operate 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.
  • Page 545 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, itemList, portRegTest, spinSilk, sramRetentionTest Fabric OS Command Reference Manual 53-1000436-01...

  • Page 546: Portmirror

    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 547 portMirror The port mirroring feature is only supported on the following platforms: Brocade 4100, Brocade 4900, Brocade 7500, and Brocade 48000 Option 5. 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.
  • Page 548 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 53-1000436-01...

  • Page 549: Portname

    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; it should not be confused with the world wide port name. Like all other configurable port attributes, port name persists across reboots and power cycles.

  • Page 550: Portperfshow

    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. Results display every second or over the specified interval, until Enter, Ctrl-c, or Ctrl-d is pressed.

  • Page 551: Portregtest

    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. The test method used is to write a walking 1 pattern to each bit location.
  • Page 552 portRegTest Diagnostics When this command detects failure(s), the test might report one or more of the following error messages: BUS_TIMEOUT REGERR REGERR_UNRST Refer to the Fabric OS Message Reference for more information. See Also camTest, centralMemoryTest, cmemRetentionTest, cmiTest, itemList, portLoopbackTest, spinSilk, sramRetentionTest Fabric OS Command Reference Manual 53-1000436-01...

  • Page 553: Portrouteshow

    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 domains in the following format: domain_number: ports_bitmap...
  • Page 554 portRouteShow broadcast routing table: 0x10000 See Also bcastShow, fabricShow, switchShow, topologyShow, uRouteShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 555: Portshow

    portShow portShow Displays the status of the specified port. Synopsis portshow [slot] fport 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 port.
  • Page 556 portShow No_Card No interface card present. No_Module No module (GBIC or other) present. 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.
  • Page 557 portShow Authentication Type If the EX_Port is connected to an edge switch with no security, then the authentication is displayed as “None”. If the edge switch is in secure mode, and assuming the DH-CHAP passwords are configured both on the router and the edge switch, the security type is displayed as “DH_CHAP”.
  • Page 558 portShow 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. fciptunnel Displays FCIP tunnel IDs, remote and local IP addresses, remote and local WWNs, compression status, fastwrite status, tape pipelining status, bandwidth rate, SACK status, Minimum Retransmit time, Keepalive Timeout,...
  • Page 559 portShow LE domain: 0 FC Fastwrite: OFF Interrupts: Link_failure: 0 Frjt: Unknown: Loss_of_sync: 4 Fbsy: Lli: Loss_of_sig: Proc_rqrd: 16796 Protocol_err: 0 Timed_out: Invalid_word: 0 Rx_flushed: Invalid_crc: Tx_unavail: Delim_err: Free_buffer: Address_err: Overrun: Lr_in: Suspended: Lr_out: Parity_err: Ols_in: 2_parity_err: Ols_out: CMI_bus_err: To view xlate domains, you must be running a Brocade 7500 or 48000 with a /FC4-18i blade. Note that the Front Domain ID is what is shown.
  • Page 560 portShow Rx_flushed: Invalid_crc: Tx_unavail: Delim_err: Free_buffer: Address_err: Overrun: Lr_in: Suspended: Lr_out: Parity_err: Ols_in: 2_parity_err: Ols_out: CMI_bus_err: Port part of other ADs: No To display IP interfaces on a GbE port: switch:admin> portshow ipif ge0 GE Port 0/ge0 Interface IP Address NetMask ---------------------------------------------------------- 192.168.255.20...
  • Page 561 portShow configuration: IP Address Mac Address ------------------------------ Iproute Configuration: IP Address Mask Gateway Metric ------------------------------------------------------ Fciptunnel configuration: ------------------------------------------- Tunnel ID 7 Remote IP Addr 192.168.255.17 Local IP Addr 192.168.255.107 Remote WWN Not Configured Local WWN 10:00:00:05:1e:37:00:20 Compression off Fastwrite off Tape Pipelining off Uncommitted bandwidth, minimum of 1000 Kbps (0.001000 Gbps) SACK on...

  • Page 562: Portstats64Show

    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. In such cases, the top word is the most significant. stat64_wtx Number of 4-byte words transmitted.
  • Page 563 portStats64Show stat64_rateRxPeakByte 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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operands: slotnumber...
  • Page 564 portStats64Show er64_enc_out top_int : Encoding error outside of frames 9131157 bottom_int : Encoding error outside of frames er64_disc_c3 top_int : Class 3 frames discarded bottom_int : Class 3 frames discarded stat64_rateTxFrame Tx frame rate (fr/sec) stat64_rateRxFrame Rx frame rate (fr/sec) stat64_rateTxPeakFrame Tx peak frame rate (fr/sec) stat64_rateRxPeakFrame...

  • Page 565: Portstatsclear

    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 566: Portstatsshow

    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. All statistics have a maximum 32-bit value of 4,294,967,295.
  • Page 567 portStatsShow Operands This command has the following operands: slotnumber For bladed systems only, specifies the slot number of the port to be displayed, followed by a slash (/). [ge]portnumber Specifies a port number to be configured, relative to its slot for bladed systems.
  • Page 568 portStatsShow ge_stat_tx_octets GE transmitted octets ge_stat_tx_ucast_frms GE transmitted unicast frames ge_stat_tx_mcast_frms GE transmitted multicast frames ge_stat_tx_bcast_frms GE transmitted broadcast frames ge_stat_tx_vlan_frms GE transmitted vlan frames ge_stat_tx_pause_frms GE transmitted pause frames ge_stat_rx_frms GE received frames ge_stat_rx_octets GE received octets ge_stat_rx_ucast_frms GE received unicast frames ge_stat_rx_mcast_frms GE received multicast frames ge_stat_rx_bcast_frms...
  • Page 569 portStatsShow See Also portErrShow, portShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 570: Portswap

    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. The result of this operation is persistent across reboots and power cycles.

  • Page 571: Portswapdisable

    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. Enabling or disabling the portswap feature does not effect previously performed portswap operations.

  • Page 572: Portswapenable

    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. Enabling or disabling the portswap feature does not effect previously performed portswap operations.

  • Page 573: Portswapshow

    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. The default area number of a port is same as its switch port number.

  • Page 574: Porttest

    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 575 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. -1 Run indefinitely. -userdelay time Specify the delay between frames sent by portTest, in milliseconds. The default value is 10 milliseconds.

  • Page 576: Porttestshow

    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. Port type tested. Current state of portTest (NO TEST, TESTING, or TEST DONE). Type of ports asked to test (ALL_PORTS, ALL_E_PORTS, ALL_L_PORTS, ALL_F_PORTS, ALL_LB_PORTS, or SINGLE_PORT).

  • Page 577: Portzoneshow

    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 578: Powerofflistset

    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 579 powerOffListSet 5th slot to be powered off: (7..10) [7] 10 6th slot to be powered off: (7..9) [8] 9 7th slot to be powered off: (7..8) [8] 8 8th slot to be powered off: (7..7) [7] 7 Old POL New POL Power Off Order ------------------------------------- Proceed to change the POL order? (yes, y, no, n): [no] y...

  • Page 580: Powerofflistshow

    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 581: Psshow

    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: OK Power supply functioning correctly. absentPower supply not present. unknownUnknown power supply unit installed. predicting failurePower supply is present but predicting failure.

  • Page 582: Quietmode

    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. By default, quiet mode is disabled, and all switch tasks may send output to the console (telnet session).

  • Page 583: Reboot

    reboot reboot Reboots the control processor (CP) in a switch or a director. Synopsis reboot -f Description Use this command to reboot a CP in a director or a switch. When this command is issued on a switch, if the switch is part of a fabric, all traffic to and from that switch stops.

  • Page 584: Routehelp

    routeHelp routeHelp Displays a list of FSPF-related commands. Synopsis routehelp Description Use this command to display a list of FSPF-related commands. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples To display a list of routing-related commands: switch:admin>...

  • Page 585: Secactivesize

    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. The information displayed might not be supported between releases and is subject to change arbitrarily.

  • Page 586: Secauthsecret

    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 587 secAuthSecret 3. Local secret: The local secret that authenticates peer. Press Enter to start setting up shared secrets > Enter WWN, Domain, or switch name (Leave blank when done): 10:00:00:60:69:80:05:14 Enter peer secret: Re-enter peer secret: Enter local secret: Re-enter local secret: Enter WWN, Domain, or switch name (Leave blank when done): Are you done? (yes, y, no, n): [no] y Saving data to key store...

  • Page 588: Seccertutil

    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. This command also imports or exports Certificate Signing Requests from or to remote host using IPV6 addresses and IPV4 addresses.
  • Page 589 secCertUtil genkey Generates a public/private key pair. This is the first step for setting up third-party certificates. The key length can be either 1,024 or 2,048 bits long. The greater the length of the key, the more secure is the connection; however, the performance goes down.
  • Page 590 secCertUtil 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 Done To delete the CSR: switch:admin> seccertutil delcsr WARNING!!! About to delete the switch CSR.

  • Page 591: Secdefinesize

    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. The information displayed might not be supported between releases and is subject to change arbitrarily.

  • Page 592: Secfabricshow

    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. Displays the domain of the switch.
  • Page 593 secFabricShow To display security related fabric information on the Primary FCS switch with IPV6 and IPV4 address configurations: primaryfcs:admin> secFabricShow Role DId Status Enet IP Addr Name ======================================================================== Primary 10:00:00:05:1e:34:14:db Ready 10.202.90.106 "mps_daz_2" 1080::8:800:200C:417A See Also secPolicyDump, secPolicyShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 594: Secfcsfailover

    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 595: Secglobalshow

    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: The version and general information The current status of the RCS transaction The active and defined sizes of the security database This command is intended strictly for debugging purposes by technical support staff only.
  • Page 596 secGlobalShow sec_aca: free RCS latest Phase: Completion RCS Message ==> RCS transaction completes. ----DataBase STATUS---- Retry Role 0 Retry Qeury0 Security Active DataSize 59 bytes Active Sum 8223 Security Defined DataSize 59 bytes Define Sum 8223 Zone Size (include enabled configuration) 4 bytes Zone sum fffb sec_db: free primaryDLPhase 0...

  • Page 597: Sechelp

    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> sechelp pkiCreate Creates new pki objects pkiRemove Removes pki objects pkiShow Displays existence of pki objects secActiveSize...

  • Page 598: Secmodedisable

    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. This command can be issued only in secure mode and only from the primary FCS switch. Operands none Examples...

  • Page 599: Secmodeenable

    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 600 secModeEnable " 5; 10:00:00:60:69:00:00:20; star1" If a member is specified by domain or switch name, the switch must be in the fabric or the command fails. This operand is optional. If no operand is specified, the session becomes interactive and you are prompted to enter FCS members. --fcs list_of_switches Specify a list of switches for the FCS policy.
  • Page 601 secModeEnable 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, which you may review at http://www.switchkeyactivation.com/cps. By using these security features, you are consenting to be bound by the terms of these...
  • Page 602 secModeEnable Changing password for admin New FCS switch admin password: Re-type new password: Changing password for user New fabric wide user password: Re-type new password: Changing password for admin New Non FCS switch admin password: Re-type new password: Broadcast message from root Thu Feb 26 02:58:52 2004... Security Policy or Password Change: root factory admin user will be logged out on switch 0 Connection closed by foreign host.
  • Page 603 secModeEnable not use these security features. (yes, y, no, n): [no] y Do you agree to these terms? This command requires Switch Certificate, Security license and Zoning license to be installed on every switch in the fabric. NOTE: On successful completion of this command, login sessions may be closed and some switches may go through a reboot to form a secure fabric.

  • Page 604: Secmodeshow

    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. The command displays secure mode as ENABLED or DISABLED. If the fabric is in secure mode, the following information displays: Version stamp Displays the current version and build date and time of the security database.

  • Page 605: Secnonfcspasswd

    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. All non-FCS switches that join the fabric in the future inherit this new password.

  • Page 606: Secpolicyabort

    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 and to abort changes to policy creation and modification operations from all the switches if fabric-wide consistency policy is not set for the particular policy.

  • Page 607: Secpolicyactivate

    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.

  • Page 608: Secpolicyadd

    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. Each policy corresponds to a management method.
  • Page 609 secPolicyAdd 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, but they are case sensitive. When the switch is in non-secure mode, this command may be used to manage only SCC, DCC, and FCS policies.
  • Page 610 secPolicyAdd switch can be specified using WWN, domain, or switch name. port can be specified by port numbers separated by commas and enclosed in either brackets or parenthesis; for example, (2, 4, 6). Ports enclosed in brackets will include the devices currently attached to those ports.

  • Page 611: Secpolicycreate

    secPolicyCreate secPolicyCreate Creates a new security policy. Synopsis secpolicycreate "name"[, "member[;member...]"] Description Use this command to create a new policy and to edit SCC, DCC, and FCS policies on the local switch. All policies can be created only once, except for the DCC_POLICY_nnn. Each DCC_POLICY_nnn must each have a unique name.
  • Page 612 secPolicyCreate The specified policy name must be capitalized. 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. The maximum length is 30 characters, including the prefix DCC_POLICY_.
  • Page 613 secPolicyCreate The following examples illustrate several ways to specify the port values: (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 614: Secpolicydelete

    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. When secure mode is first enabled using the secModeEnable command, only the FCS_POLICY exists.
  • Page 615 secPolicyDelete Are you sure (yes, y, no, n):[no] y MS_POLICY has been deleted. See Also secPolicyAbort, secPolicyActivate, secPolicyAdd, secPolicyCreate, secPolicyDump, secPolicyRemove, secPolicySave, secPolicyShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 616: Secpolicydump

    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. When secure mode is enabled, this command can be issued from all the FCS switches in the fabric. Operands This command has the following operands: "listtype"Specify which database to display.
  • Page 617 secPolicyDump HTTP_POLICY IpAddr __________________________________________________ 192.155.52.0 ____________________________________________________ ____________________________________________________ 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 192.155.53.1 192.155.54.2 192.155.55.3 ____________________________________________________ To display all security policy information for the TELNET_POLICY, without page breaks: primaryfcs:admin> secpolicydump "*", "TELNET_POLICY" ____________________________________________________ DEFINED POLICY SET TELNET_POLICY...

  • Page 618: Secpolicyfcsmove

    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 position in the FCS list. Only one FCS can be moved at a time. The first FCS switch in the list that is also present in the fabric is the Primary FCS.

  • Page 619: Secpolicyremove

    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 620 secPolicyRemove HTTP_POLICY API_POLICY RSNMP_POLICY WSNMP_POLICY These policy types require member IDs in dot notation (for example, 124.23.56.122). If 0 is specified in one of the octets, it means any number can be matched. WWN Member Policy Types The following policy types require members be specified by WWN address: FCS_POLICY SES_POLICY MS_POLICY...
  • Page 621 secPolicyRemove secPolicySave, secStatsShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 622: Secpolicysave

    secPolicySave secPolicySave Saves a defined security policy to persistent memory on all switches in the fabric. Synopsis secpolicysave Description Use this command to save a defined security policy to persistent memory of all switches in the fabric. Secpolicysave saves the modified SCC, DCC, and FCS policies to Defined Security Policy Set on the local switch.

  • Page 623: Secpolicyshow

    secPolicyShow secPolicyShow Displays an existing security policy including the FCS 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. This command displays the policy database one page at a time. Use secPolicyDump to display the policy database without page breaks.
  • Page 624 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: switch:admin> secpolicyshow "defined" ____________________________________________________ DEFINED POLICY SET FCS_POLICY...

  • Page 625: Secstatsreset

    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 626 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 627: Secstatsshow

    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 628 secStatsShow 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. This operand is optional and the default is all statistics. If the list operand is specified, then this operand is required.

  • Page 629: Sectemppasswdreset

    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 630: Sectemppasswdset

    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. Use the secTempPasswdReset command to remove the temporary password or reboot the switch.

  • Page 631: Sectransabort

    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. When secure mode is enabled, this command should be used only on the FCS switch to abort the current security transaction.

  • Page 632: Secversionreset

    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. When merging two or more secure fabrics: Determine which secure fabric will become the FCS_POLICY controller fabric, the dominant fabric to which all other secure fabrics will be merged.

  • Page 633: Sensorshow

    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. The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 634: Setdbg

    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. By default, no debug messages are displayed. High debug level values can generate a large volume of messages, degrading the system response time.

  • Page 635: Setesdmode

    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. The mode becomes active as soon as this command is executed.

  • Page 636: Setgbicmode

    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. The mode is saved in flash memory and stays in that mode until the next execution of setGbicMode.

  • Page 637: Setmediamode

    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. The mode is saved in flash memory and stays in that mode until the next execution of setMediaMode.

  • Page 638: Setmodem

    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. When modem dial-in is enabled, you can log in to a CP through a modem, and a modem attached to the CP accepts the call.
  • Page 639 setModem RJ-11 "Y" Adapter Optional Handset Modem (two shown) Analog Telco 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; RS-232 port interface) POWER SUPPLY 3 Link Link...

  • Page 640: Setsfpmode

    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. The mode is saved in flash memory and stays in that mode until the next execution of setSfpMode.

  • Page 641: Setsplbmode

    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 642: Setverbose

    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. By default, no debug messages are displayed. The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 643: Sfpshow

    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 644 sfpShow Area 12: -- Area 13: -- Area 14: -- Area 15: -- Area 16: id (sw) Vendor: AGILENT Serial No: 0105091301045274 (output truncated) To display detailed SFP information for a Finisar “smart” SFP: switch:user> sfpshow 1/3 Identifier: Connector: Transceiver: 050c402000000000 100,200_MB/s M5,M6 sw Inter_dist Encoding: 8B10B Baud Rate:...
  • Page 645 sfpShow To display detailed information for GbE port 0 on an FR4-18i router blade: CS48000:admin> sfpshow 10/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: (units 100 meters) Length 50u: (units 10 meters) Length 62.5u:15...
  • Page 646 sfpShow Baud Rate: (units 100 megabaud) Length 9u: (units km) Length 9u: (units 100 meters) Length 50u: (units 10 meters) Length 62.5u:15 (units 10 meters) Length Cu: (units 1 meter) Vendor Name: IBM Vendor OUI: 08:00:5a Vendor PN: IBM42P21SNY Vendor Rev: AA10 Wavelength: (units nm)

  • Page 647: Shellflowcontroldisable

    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. Because this command changes the flow control on the console serial port, it must be executed from a session that is logged in from the console serial port.

  • Page 648: Shellflowcontrolenable

    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. Because this command changes the flow control on the console serial port, it must be executed from a session that is logged in from the console serial port.

  • Page 649: Slotoff

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. See Also slotShow, slotPowerOff, bladeDisable Fabric OS Command Reference Manual...

  • Page 650: Sloton

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. See Also slotShow, slotPowerOn, bladeEnable Fabric OS Command Reference Manual...

  • Page 651: Slotpoweroff

    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. The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 652: Slotpoweron

    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. The slotShow command reports such slots as being in the state of INSERTED, NOT POWERED ON.

  • Page 653: Slotshow

    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 654 slotShow INITIALIZING The blade is present, powered on, and initializing hardware components. ENABLED The blade is on and enabled. ENABLED (User Ports Disabled) The blade is on but the external ports are disabled using bladeDisable. DISABLED The blade is powered on but disabled. FAULTY The blade is faulty because an error was detected.

  • Page 655: Sltest

    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 656 slTest Refer to itemList for further details. Examples To test the serial link of the following port path: switch:admin> sltest -ports 0/5-0/31 -speed 4 -lb_mode 1 passcnt 1 Running Port sltest ..passed. Diagnostic When it detects failures, the test might report one or more of the following error messages: DATA ERRSTAT INIT...

  • Page 657: Snmpconfig

    snmpConfig snmpConfig Manages the SNMP agent configuration. Synopsis snmpConfig --show | --set | --default [snmpv1 | snmpv3 | accessControl | mibCapability | systemGroup] 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 658 snmpConfig None Critical 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. Separate default passwords are provided for creation of authKey and privKey for each entry.
  • Page 659 snmpConfig Note that in order for an SNMP management station to receive SNMPv3 traps generated by the agent, the administrator must configure a trap recipient value to correspond to the IP address of the management station. Also, in addition the trap recipient should be able to pass the ACL check as described in accessControl section.
  • Page 660 snmpConfig FICON-TRAP Specifying yes means the SNMP management application can receive FICON traps from the switch. The default value is 'yes'. Users can also turn on or off individual FICON Traps. The individual FICON Traps are linkRNIDDeviceRegistration, linkRNIDDeviceDeRegistration, linkLIRRListenerAdded, linkLIRRListenerRemoved and linkRLIRFailureIncident.
  • Page 661 snmpConfig systemGroup Selects configuration parameters related to the system group. systemGroup parameters include sysDescr, sysLocation, sysContact, and authentication failure trap. Examples To display the SNMPv1 configuration: switch:admin> snmpConfig --show snmpv1 SNMPv1 community and trap recipient configuration: Community 1: Secret C0de (rw) Trap recipient: 10.32.147.113 Trap recipient Severity Level: 0 Community 2: OrigEquipMfr (rw)
  • Page 662 snmpConfig Read/Write? (true, t, false, f): [true] Committing configuration...done. To display the mibCapability configuration: switch:admin> snmpconfig --show mibCapability FE-MIB: YES SW-MIB: YES FA-MIB: YES FICON-MIB: YES HA-MIB: YES SW-TRAP: YES swFCPortScn: YES swEventTrap: YES swFabricWatchTrap: YES swTrackChangesTrap: NO FA-TRAP: YES connUnitStatusChange: YES connUnitEventTrap: NO connUnitSensorStatusChange: YES...

  • Page 663: Snmpmibcapset

    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. It first displays current settings and then prompts the user to change the values for each parameter.
  • Page 664 snmpMibCapSet HA-TRAP fruStatusChanged cpStatusChanged FA-MIB (yes, y, no, n): [yes] FICON-MIB (yes, y, no, n): [yes] n HA-MIB (yes, y, no, n): [yes] SW-TRAP (yes, y, no, n): [yes] swFCPortScn (yes, y, no, n): [yes] swEventTrap (yes, y, no, n): [no] swFabricWatchTrap (yes, y, no, n): [yes] swTrackChangesTrap (yes, y, no, n): [no] y FA-TRAP (yes, y, no, n): [yes] n...

  • Page 665: Snmpmibcapshow

    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 snmpMibCapShow The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples To display the options for configuring the SNMP MIB capability: switch:admin> snmpmibcapshow FE-MIB: YES SW-MIB: YES FA-MIB: YES FICON-MIB: NO HA-MIB: YES SW-TRAP: YES swFCPortScn: YES...

  • Page 667: Spinfab

    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 spinFab -setfail mode Instruct spinFab how to mark failed ports. If set to 1, it will mark failing ports as FAILED. If set to 0, it will not mark failed ports as FAILED. It is to minimize the impact on live fabrics. This test normally logs errors but does not set the port status to FAILED.
  • Page 669 spinFab See Also camTest, centralMemoryTest, cmemRetentionTest, cmiTest, itemList, portLoopbackTest, spinSilk, sramRetentionTest Fabric OS Command Reference Manual 53-1000436-01...

  • Page 670: Spinjitter

    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 For details about the procedures used in this test, refer to spinSilk.
  • Page 671 spinJitter Set all odd ports' speed for autonegotiate. Set all even ports' speed for 1 Gbit/sec. Set all odd ports' speed for autonegotiate. Set all even ports' speed for 2 Gbit/sec. For -lb_mode set to 2 or 3, the following speed modes are available to test FIFO underrun. Set all even ports' speed for 2 Gbit/sec.
  • Page 672 spinJitter 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. See Also backport, camTest, centralMemoryTest, cmemRetentionTest, cmiTest, itemList, portLoopbackTest, portRegTest, spinSilk, sramRetentionTest Fabric OS Command Reference Manual...

  • Page 673: Spinsilk

    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 674 spinSilk The partner port N eventually sends four similar frames, as follows: 2112 bytes of BYTE_LFSR 928 bytes of CSPAT 200 bytes of RANDOM 480 bytes of RDRAM_PAT Periodically check the following: No port has died. Each port's frames-transmitted counter is still incrementing. Each port's statistic error counters is nonzero—ENC_in, CRC_err, TruncFrm, FrmTooLong, BadEOF, Enc_out, BadOrdSet, DiscC3—until one of the following is met: The number of million frames requested per port is met.
  • Page 675 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. For 1 Gbit/sec-only products, it is ignored. The exact operation of modes 5 through 8 depends upon the loopback mode selected.
  • Page 676 spinSilk ===================================== Online Testing ..Online Testing ..Online Testing ..(output truncated) Diagnostics Following are the possible error messages if failures are detected: DATA EPI1_STATUS_ERR ERR_STAT ERR_STATS ERR_STATS_2LONG ERR_STATS_BADEOF ERR_STATS_BADOS ERR_STATS_C3DISC ERR_STATS_CRC ERR_STATS_ENCIN ERR_STATS_ENCOUT ERR_STATS_TRUNC ERR_STAT_2LONG ERR_STAT_BADEOF ERR_STAT_BADOS ERR_STAT_C3DISC ERR_STAT_CRC ERR_STAT_ENCIN ERR_STAT_ENCOUT...

  • Page 677: Sramretentiontest

    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. The method used is to write a fill pattern to all SRAMs, wait 10 seconds, and then read all SRAMs, checking that the data read matches the data previously written.
  • Page 678 sramRetentionTest 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. See Also camTest, centralMemoryTest, cmemRetentionTest, cmiTest, dataTypeShow, itemList, portLoopbackTest, spinSilk Fabric OS Command Reference Manual 53-1000436-01...

  • Page 679: Statsclear

    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. You can issue this command on the FR4-18i blade in a Brocade chassis; however, the command is not supported by the Brocade platform and does not effect any other feature operations.

  • Page 680: Statstest

    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. This command is also run from camTest.
  • Page 681 statsTest See Also camTest, itemList Fabric OS Command Reference Manual 53-1000436-01...

  • Page 682: Stopporttest

    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. If portTest is running on a non-singlemode, use stopPortTest to stop the test. The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 683: Supportffdc

    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

    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 supportftp -e Description Use this command to set, clear, or display support FTP parameters, or a time interval to check the FTP server.
  • Page 685 supportFtp To set FTP parameters: switch:admin> supportftp -s Host IP Addr[1080::8:800:200C:417A]: User Name[njoe]: Password[********]: Remote Dir[support]: Auto file transfer parameters changed To display a time interval to check the FTP server: switch:admin> supportftp -t 24 supportftp: ftp check period changed. To enable auto file transfer: switch:admin>...

  • Page 686: Supportsave

    supportSave supportSave Saves RASLOG, TRACE, supportShow, core file, FFDC data, and other support information Synopsis supportsave [-n][-c][-u user_name -p password] -h host_ip -d remote_dir [-R] [-l ftp| scp] [-k] Description Use this command to collect RASLOG, TRACE, supportShow, core file, FFDC data and other support information to a remote FTP location.
  • Page 687 supportSave the scp mode service be configured so that passwords will not be required for each attempted transfer by the supportSave command. Failure to pretest and properly configure the service could result in significant delays in obtaining transferred output from the supportSave command. Examples To save RASLOG, TRACE, supportShow, and other support information to a FTP server in non-interactive mode:...
  • Page 688 supportSave Saving support information for switch:swd76, module:NS_evlog... /tmp/supportSave_files/swd76-S6-200508280208-NS_evlog.ss: 2.72 kB 928.95 Saving support information for switch:routing1, module:FSPF_Log..e_files/routing1-S6-200508280208-FSPF_Log.ss: 2.04 kB 694.31 B/s Saving support information for switch:routing1, module:CORE_FFDC... No core or FFDC data files found! Saving support information for switch:routing1, module:CHKCONFIG..e_files/routing1-S6-200508280208-CHKCONFIG.ss: 1.04 kB 694.31 B/s...
  • Page 689 supportSave ...Save_files/routing1-S6-200508280151-RASLOG.ss: 28.00 B 9.35 B/s Saving support information for switch:routing1, module:TRACE_OLD.._files/routing1-S6-200508280151-old-tracedump.dmp: 12.00 MB 1.92 MB/s Saving support information for switch:routing1, module:TRACE_NEW.._files/routing1-S6-200508280151-new-tracedump.dmp: 12.00 MB 1.91 MB/s Saving support information for switch:routing1, module:SUPPORTSHOW..........................rtSave_files/routing1-S6-200508280159-supportShow: 6.36 MB 1.35 MB/s Saving support information for switch:routing1, module:Zone_Log...

  • Page 690: Supportshow

    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 691 supportShow topologyShow lsDbShow ess show fabStateShow fabStatsShow fabSwitchShow fabPortShow fspfShow nbrStateShow fcpLogShow zone stateshow portZoneShow cfgShow cfgSize rcssmshow rcsInfoShow rcsregistryshow zone mergeshow zone stateshow services (ENABLED by default) fdmiCacheShow fdmiShow nsShow nsAllShow nscamShow nscamShow -t ns portshow security (ENABLED by default) authUtil authUtil -dump -a secFabricShow...
  • Page 692 supportShow network (ENABLED by default) bootenv ifconfig route hostname portlog (ENABLED by default) portLogDump system (ENABLED by default) myId version firmwareShow upTime switchStatusShow switchShow haDump (includes haShow and ipAddrShow) tempShow sensorShow psShow licenseShow portFlagsShow portCfgShow portErrShow fwSamShow agtCfgShow slotShow (product-dependent) slotShow -d576 emtraceshow emtraceshow2...
  • Page 693 supportShow historyShow portSwapShow configShow extend (DISABLED by default) buffers (per-port) credits (per-port) data (per-port) phantom (per-port) properties (per-port) statistics (per-port) filter (DISABLED by default; this group has lengthy output) (per-port) filterportshow perfmon (DISABLED by default) ps_dump (per-port; this group has lengthy output) ficon (DISABLED by default;...
  • Page 694 supportShow portShow fciptunnel $1/ge$k all The execution of this command is subject to Admin Domain restrictions that may be in place. 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.

  • Page 695: Supportshowcfgdisable

    supportShowCfgDisable supportShowCfgDisable Disables a group of commands under the supportShow command. Synopsis supportshowcfgdisable [os | exception | port | fabric | services | security | network | portlog | systemextend | filter | perfmon | ficon | iswitch | asic_db |iscsi] Description Use this command to disable a group of commands under the supportShow command.

  • Page 696: Supportshowcfgenable

    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 supportShow command. Use the supportShowCfgDisable command to disable groups of commands.

  • Page 697: Supportshowcfgshow

    supportShowCfgShow supportShowCfgShow Displays the groups of commands enabled for display by the supportShowcommand. Synopsis supportshowcfgshow Description Use this command to display the groups of commands enabled for display by the supportShow command. Use the supportShowCfgEnable and the supportShowCfgDisable commands to modify which groups are displayed.

  • Page 698: Switchbeacon

    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

    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

    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

    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. If any port on the switch is not capable of the specified speed setting, an error message displays for that port.

  • Page 702: Switchcfgtrunk

    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. This command requires the Brocade ISL Trunking license. You can disable or enable trunking using the portCfgTrunkPort or switchCfgTrunk commands.

  • Page 703: Switchdisable

    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) or before running many of the diagnostic tests.

  • Page 704: Switchenable

    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

    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. This name is shown in the Fabric OS CLI prompt, under each switch icon on the Fabric Web page, and in the output of various Fabric OS commands, such as fabricShow.

  • Page 706: Switchreboot

    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. This command is not supported on single-domain systems. The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 707: Switchshow

    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. For all Bloom and Bloom 2-based platforms, private device targets are displayed in switchShow. For Condor or Goldeneye-based platforms, private device targets are not displayed in switchShow.
  • Page 708 switchShow Address The 24-bit Address Identifier. Address column is only displayed for slot-based platforms. Media Type Media types include: no module present sw shortwave laser longwave laser cu copper id serial ID Speed The speed of the port: 1/8G 125 Mbit/sec 1/4G 250 Mbit/sec 1/2G...
  • Page 709 switchShow Proto Protocol support by GbE port. ISCSI Ports support ISCSI. FCIP Ports support FCIP. comment The comment field is blank, or displays: Disabled Port is disabled. Bypassed Port is bypassed (loop only). Loopback Port is in loopback mode. E_Port Fabric port;...
  • Page 710 switchShow Operands The operand is as follows: -portcount Causes the switchShow command to display the number of ports on the switch. -iscsi Causes the switchShow command to display the number of ports on the iSCSI sessions associated with GE ports in a switch. Examples To display the port count: switch:admin>...
  • Page 711 switchShow 035900 Online E-Port 10:00:00:60:69:90:52:a8 "Term_7" 035a00 No_Module Disabled (Persistent) 035b00 No_Light Disabled (Persistent) 035c00 No_Module Disabled (Persistent) 035d00 No_Module Disabled (Persistent) 035e00 Online F-Port 10:00:00:00:00:04:00:00 035f00 Online F-Port 10:00:00:00:00:02:00:00 03d000 Offline [output truncated] 03d800 Online VE-Port 10:00:00:60:69:e2:0c:00 "bot_4a3_a10" (upstream) 03d900 Online VE-Port...

  • Page 712: Switchshutdown

    switchShutdown switchShutdown Not supported on this platform. Synopsis switchshutdown Description This command is not supported on this platform as of FOS 5.1. The execution of this command is subject to Admin Domain restrictions that may be in place. Fabric OS Command Reference Manual 53-1000436-01...

  • Page 713: Switchstart

    switchStart switchStart Not supported on this platform as of Fabric OS 5.1. Fabric OS Command Reference Manual 53-1000436-01...

  • Page 714: Switchstatuspolicyset

    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 715 switchStatusPolicySet Blade Flash MarginalPorts FaultyPorts MissingSFPs Note that the value, 0, for a parameter, means that it is NOT used in the calculation. ** In addition, if the range of settable values in the ** prompt is (0..0), the policy parameter is NOT applicable ** to the switch.

  • Page 716: Switchstatuspolicyshow

    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 717 switchStatusPolicyShow MissingSFPs See Also switchStatusPolicySet, switchStatusShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 718: Switchstatusshow

    switchStatusShow switchStatusShow Displays overall switch status. Synopsis switchstatusshow Description Use this command to display the overall status for a switch that is configured with IPv4 and IPv6 addresses. In addition, users with a Fabric Watch license are able to view the list of unhealthy ports.
  • Page 719 switchStatusShow All ports are healthy To retrieve a switch health report for a switch that is configured with an IPv4 address: switch:user> switchstatusshow Switch Health Report Report time: 09/11/2006 05:39:28 PM Switch Name: switch IP address: 10.32.89.26 SwitchState: MARGINAL Duration: 80:12 Power supplies monitor HEALTHY...

  • Page 720: Switchuptime

    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. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 721: Syslogdfacility

    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 722: Syslogdipadd

    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 723: Syslogdipremove

    syslogdIpRemove syslogdIpRemove Removes the IP address or host names of a syslog daemon. These can be IPv6 or IPv4 syslogd address configurations. Synopsis syslogdipremove ip_address Description Use this command to remove the IP address of the server that is running the syslogd process. The execution of this command is subject to Admin Domain restrictions that may be in place.

  • Page 724: Syslogdipshow

    syslogdIpShow syslogdIpShow Displays all syslog daemon IP addresses in IPv6 or IPv4 formats. Synopsis syslogdipshow Description Use this command to display all syslog daemon IP addresses in the configuration database. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples...

  • Page 725: Sysshutdown

    sysShutdown sysShutdown Provides a graceful shutdown to protect the switch file systems. Synopsis sysshutdown Description For Brocade (nonbladed) switches, use this command to shutdown the switch operating system. For Brocade 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 726 sysShutdown For the FR4-18i AP blade, to perform a system shutdown from the active CP: 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/11/16-05:47:20, [FSSM-1003], 5641,, WARNING, Brocade12000, HA State out of sync...

  • Page 727: Systemverification

    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. The optional -fru and -unit parameters allow you to focus the testing to a single blade in a multiblade system.
  • Page 728 systemVerification Examples To initiate a system verification test on all switches in the fabric: switch:admin> systemverification -short systemverification: Setting parameters for short run. systemverification: burnin parameters. CURRENT - KEYWORD : DEFAULT - number_of_runs - vib - thermal : 10 SYSTEMVERIFICATION - label : BURNIN - min_lb_mode - tbr_passes...

  • Page 729: Tempshow

    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. Refer to the hardware reference manual for your switch to determine the normal temperature range.

  • Page 730: Timeout

    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. Use this command with the timeval operand to set the login timeout value to the specified interval. A value of 0 disables timeout functionality of login sessions.

  • Page 731: Topologyshow

    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 732 topologyShow 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: switch Path Count: Hops: Out Port: In Ports: None Total Bandwidth: 2.000 Gbps Bandwidth Demand:...

  • Page 733: Tracedump

    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 734: Trackchangeshelp

    trackChangesHelp trackChangesHelp Displays information on track-changes commands. Synopsis trackchangeshelp Description Use this command to display information about the track-changes commands. 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 735: Trackchangesset

    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: Successful login Unsuccessful login Logout Config file change from task Track-changes on Track-changes off The output from the track-changes feature is dumped to the error log for the switch.

  • Page 736: Trackchangesshow

    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. Use the errDump command or errShow command to view the error log.

  • Page 737: Trunkdebug

    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: Switch does not support trunking Trunking license required Trunking not supported in switch interop mode port port_id is not E_Port...

  • Page 738: Trunkshow

    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 739 trunkShow 54-> 2 10:00:00:05:1e:35:b3:03 4 deskew 16 53-> 5 10:00:00:05:1e:35:b3:03 4 deskew 16 50-> 6 10:00:00:05:1e:35:b3:03 4 deskew 15 51-> 4 10:00:00:05:1e:35:b3:03 4 deskew 16 52-> 7 10:00:00:05:1e:35:b3:03 4 deskew 67 55-> 3 10:00:00:05:1e:35:b3:03 4 deskew 16 48-> 1 10:00:00:05:1e:35:b3:03 4 deskew 15 5: 71->...

  • Page 740: Tsclockserver

    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. The tsclockserver command accepts lists of NTP server addresses instead of just one address. The NTP server addresses can be passed in any of IPV4 or IPV6 address format or as a DNS name.
  • Page 741 tsClockServer Updating Clock Server configuration...done. switch:admin> tsclockserver 123.123.123.123 See Also date Fabric OS Command Reference Manual 53-1000436-01...

  • Page 742: Tstimezone

    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. Changing the time zone on a switch updates the local time zone setup and is reflected in local time calculations.
  • Page 743 tsTimeZone The hourOffset can be specified without a minuteOffset which will then default to zero. These operands are only valid with the --old action. 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.
  • Page 744 tsTimeZone 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 7) Eastern Time - Indiana - Starke County 8) Eastern Time - Indiana - Switzerland County...

  • Page 745: Turboramtest

    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. These same SRAMs are tested by portRegTest and sramRetentionTest using PCI operations but for this test, the BIST controller is able to perform the SRAM write and read operations at a much faster rate.

  • Page 746: Txdpath

    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 747 txdPath --slot slotnumber Specifies the slot number on which the diagnostic operates. The ports specified are relative to this slot number. The default is set to 0 and designed to operate on fixed-port-count products. -nmegs count Specify the number of million frames to send. The test progresses until the specified number of frames has been transmitted on each port.
  • Page 748 txdPath switch:admin> txdpath Running TX Data Path Test ..Test Complete: "txdpath" Pass 10 of 10 Duration 0 hr, 0 min & 47 sec (0:0:47:645). Diagnostics When it detects failure(s), the test can report one or more of the following error messages: DATA ERRSTAT INIT...

  • Page 749: Uptime

    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 750: Urouteconfig

    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 751: Urouteremove

    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. If DLS is not set, the route remains as is, with its route attribute changed from static to dynamic.

  • Page 752: Urouteshow

    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. The routing information describes how a frame that is received from a port on the local switch is to be routed to reach a destination switch.
  • Page 753 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 754: Userconfig

    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 755 userConfig --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 SecurityAdmin and Admin role users may use this action. --add username -r rolename [-h AD_ID] [-a AD_ID_list] [-d description] [-x] Add a new account named username to the switch, with the assigned role of rolename.
  • Page 756 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 757 userConfig Enter new password: Re-type new password: Account joe has been successfully added. To display current account information: switch:admin> userconfig --show joe Account name: joe Role: admin Description: Joe Smith Enabled: Yes Password Last Change Date: Unknown Password Expiration Date: Not Applicable Locked: No AD membership: 0 Home AD: 0...

  • Page 758: Userrename

    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: new_username must begin with a letter and contain only alphanumeric characters or underscores. new_username must be between 1 and 40 characters long.

  • Page 759: Version

    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 Displays the build date of firmware running in switch Flash...

  • Page 760: Wwn

    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. The WWN displays in the output of the switchShow command.

  • Page 761: Zone

    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. Users can perform a specific zone operation using the --copy, --expunge, and --validate options.
  • Page 762 zone If a zone member is specified using <D,P> in the Admin Domain membership list, all zone elements specified with WWNs hanging off of that <D,P> will be considered for zone enforcement. If a device WWN is specified in the Admin Domain member list, the corresponding <D,P>...
  • Page 763 zone To copy backup_zn zone from the root zone database (AD0) to the current Admin Domain, with Admin Domain member list filtering: switch:admin> zone --copy -f AD0.backup_zn 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>...

  • Page 764: Zoneadd

    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 765: Zonecreate

    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. Names are case sensitive; for example, "Zone_1" indicates a different zone than "zone_1".
  • Page 766 zoneCreate devices. This zone must be named "broadcast". Only one broadcast zone can exist within a fabric. This type of zone is hardware enforced; the switch controls data transfer to a port. When secure mode is enabled, this command can be issued only from the primary FCS switch. Operands The following operands are required: "zonename"...

  • Page 767: Zonedelete

    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. For the change to become effective, an appropriate zone configuration must be enabled using the cfgEnable command.

  • Page 768: Zonehelp

    zoneHelp zoneHelp Displays a description of zoning commands. Synopsis zonehelp Description Use this command to display short descriptions of zoning commands. The execution of this command is subject to Admin Domain restrictions that may be in place. Operands none Examples To display zone command help information: switch:admin>...

  • Page 769: Zoneobjectcopy

    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. You can use this command for all zone object types, including cfg, zone, and alias.

  • Page 770: Zoneobjectexpunge

    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 771: Zoneobjectrename

    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. A zone configuration name must begin with a letter that can be followed by any number of letters, numbers, and underscores.

  • Page 772: Zoneremove

    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. For the change to be preserved across switch reboots, it must be saved to nonvolatile memory using the cfgSave command.

  • Page 773: Zoneshow

    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. Refer to cfgShow for a description of this display. If a parameter is specified, it is used as a pattern to match zone configuration names, and those that match in the defined configuration are displayed.
  • Page 774 zoneShow Fabric OS Command Reference Manual 53-1000436-01...

  • Page 775: 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 744 • “Extended Fabrics Command” on page 745 • “Fabric Watch Commands” on page 745 •...

  • Page 776: Fabric Assist Mode Commands

    Fabric Assist Mode Commands TABLE 1 Zoning Commands (Continued) Command Description 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. cfgCreate Creates a zone configuration.

  • Page 777: Extended Fabrics Command

    Extended Fabrics Command Extended Fabrics Command The following command is available with the purchase of a Brocade Extended Fabrics license key. TABLE 3 Extended Fabrics Commands Command Description portCfgLongDistance Configures a port to support long-distance links. Fabric Watch Commands The following commands are available with the purchase of a Brocade Fabric Watch license key. TABLE 4 Fabric Watch Commands Command...

  • Page 778: Isl Trunking Commands

    ISL Trunking Commands 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. TABLE 5 Brocade Trunking Commands Command Description portCfgTrunkPort Configures a port for trunking.

  • Page 779: Secure Fabric Os Commands

    Secure Fabric OS Commands TABLE 6 Performance Monitoring Commands (Continued) Command Description perfDelFilterMonitor Deletes a filter-based monitor. perfMonitorClear Clears counters of end-to-end, filter-based, and ISL performance monitors on a port. perfMonitorShow Displays end-to-end, filter-based, and ISL monitors on a port. perfShowPortEEMask Sets overall mask for end-to-end (EE) monitors.
  • Page 780 Secure Fabric OS Commands TABLE 7 Brocade Secure Fabric OS Commands (Continued) Command Description secPolicyDelete Deletes an existing policy. secPolicyDump Displays all members of existing policies. secPolicyFCSMove Moves a member in the FCS policy. secPolicyRemove Removes members from an existing policy. secPolicySave Saves a defined security policy to flash memory on all switches in the fabric.

  • Page 781: 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 1 Commands Exclusive to the Primary FCS Command...
  • Page 782 Commands Exclusive to the Primary FCS TABLE 1 Commands Exclusive to the Primary FCS (Continued) Command Notes 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 783 Commands Exclusive to the Primary FCS TABLE 1 Commands Exclusive to the Primary FCS (Continued) Command Notes tsClockServer Can be run on all switches to view the NTP server's IP address. You can only modify the NTP server's IP address on the primary FCS switch. This command can be run on all switches to view the WWN.
  • Page 784 Commands Exclusive to the Primary FCS Fabric OS Command Reference Manual 53-1000436-01...

  • Page 785: Chapter 5 Control Processor Commands

    Chapter Control Processor Commands This chapter lists the commands available when logged in to the standby CP in a Brocade 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 786 Commands Supported on the Standby CP TABLE 1 Commands Supported on the Standby CP (Continued) Command Description myId Displays the current login session details. pdShow Displays information from panic dump file. reboot Reboots the standby CP. setModem Enables or disables modem dial-in to a control processor (CP). supportSave Saves support information for RASLOG, TRACE, and supportShow.

  • Page 787: Chapter 6 Supportshow Reference

    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 756 • “Proc Entry Information Displayed” on page 758 • supportShow Control Commands supportShow command is used to display support information by executing groups of preselected Fabric OS and Linux commands.

  • Page 788: Supportshow Command Groups

    supportShow Command Groups supportShow Command Groups Table 1 displays the command groups under supportshow, and which Fabric OS or Linux commands are executed by that group. TABLE 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...
  • Page 789 supportShow Command Groups TABLE 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...

  • Page 790: Proc Entry Information Displayed

    Proc Entry Information Displayed TABLE 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...
  • Page 791 Proc Entry Information Displayed TABLE 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...
  • Page 792 Proc Entry Information Displayed TABLE 2 Proc Entry Information Displayed (Continued) Proc Display Proc Example Display Command /proc/filesystems /proc/filesystems nodev rootfs nodev bdev nodev proc nodev sockfs nodev tmpfs nodev shm nodev pipefs ext2 nodev ramfs nodev nfs nodev devpts nodev dfs /proc/interrupts /proc/interrupts...
  • Page 793 Proc Entry Information Displayed TABLE 2 Proc Entry Information Displayed (Continued) Proc Display Proc Example Display Command /proc/modules /proc/modules dubby-module 582614 2 chubby-module 3128618 126 [dubby-module] dfs 5458 1 [dubby-module] consolelog-module 8539 0 (unused) panicdump-module 15279 0 [chubby-module consolelog-module] xfsnotificationhandler 4858 0 (unused) /proc/mounts /proc/mounts rootfs / rootfs rw 0 0...
  • Page 794 Proc Entry Information Displayed TABLE 2 Proc Entry Information Displayed (Continued) Proc Display Proc Example Display Command /proc/slabinfo /proc/slabinfo slabinfo - version: 1.1 kmem_cache 74 102 112 3 3 1 ip_mrt_cache 0 0 96 0 0 1 tcp_tw_bucket 2 40 96 1 1 1 tcp_bind_bucket 5 113 32 1 1 1 tcp_open_request 0 59 64 0 1 1 inet_peer_cache 1 59 64 1 1 1...
  • Page 795 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: 1.
  • Page 796 RBAC Command Availability TABLE 1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Admin Admin Switch Admin Admin aptPolicy auditCfg authUtil OM/N backplaneTest backPort bannerSet...
  • Page 797 RBAC Command Availability TABLE 1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Admin Admin Switch Admin Admin chassisShow chipRegShow cmemRetentionTest cmiTest configCommit configDefault configDownload...
  • Page 798 RBAC Command Availability TABLE 1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Admin Admin Switch Admin Admin dnsConfig enclosureShow errClear errDelimiterSet errDump errFilterSet errModuleShow...
  • Page 799 RBAC Command Availability TABLE 1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Admin Admin Switch Admin Admin fcpLogClear fcpLogDisable fcpLogEnable fcpLogShow fcrlsancount fcrlsanmatrix fcpProbeShow...
  • Page 800 RBAC Command Availability TABLE 1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Admin Admin Switch Admin Admin firmwareShow fosconfig fPortTest framerpathtest fruReplace fspfShow fwAlarmsFilterSet...
  • Page 801 RBAC Command Availability TABLE 1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Admin Admin Switch Admin Admin ifModeSet ifModeShow interfaceShow interopmode iodReset iodSet iodShow...
  • Page 802 RBAC Command Availability TABLE 1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Admin Admin Switch Admin Admin minisPropShow msCapabilityShow msConfigure msPlatShow msPlatShowDBCB msPlClearDB msPlMgmtActivate...
  • Page 803 RBAC Command Availability TABLE 1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Admin Admin Switch Admin Admin perfCfgClear perfCfgRestore perfCfgSave perfClearAlpaCrc perfClearEEMonitor perfClearFilterMonitor perfDelEEMonitor...
  • Page 804 RBAC Command Availability TABLE 1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Admin Admin Switch Admin Admin portCfgSpeed portCfgTrunkPort portcfgvexport portcmd portDebug portDisable portEnable...
  • Page 805 RBAC Command Availability TABLE 1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Admin Admin Switch Admin Admin portStatsShow portSwap portSwapDisable portSwapEnable portSwapShow portTest portTestShow...
  • Page 806 RBAC Command Availability TABLE 1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Admin Admin Switch Admin Admin secPolicyDump secPolicyFCSMove secPolicyRemove secPolicySave secPolicyShow secStatsReset secStatsShow...
  • Page 807 RBAC Command Availability TABLE 1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Admin Admin Switch Admin Admin stopPortTest supportffdc supportFtp supportSave supportShow supportShowCfgDisable supportShowCfgEnable...
  • Page 808 RBAC Command Availability TABLE 1 RBAC Availability of All Commands (O = observe, OM = observe-modify, N = none/not available) Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Admin Admin Switch Admin Admin trackChangesShow trunkDebug trunkShow tsClockServer tsTimeZone turboRamTest txDpath...
  • Page 809 AAA services backport and ASICs access levels backup FCS account lockout policy and secFCSFailover bannerSet active CP bannerShow in firmwaredownload Admin BB credit Admin Domain restrictions beacon Advanced Zoning and supportShow and switchBeacon BIST test bladeDisable Advanced Zoning commands Bloom agtCfgDefault Bloom-based platform agtCfgShow...
  • Page 810 defZoneCreate defZoneDelete zoning defaults deskew CAM utilization DH-CHAP centralMemoryTest and authUtil cfgActvShow diagCommandShow cfgClear diagDisablePost zoning diagEnablePost cfgCreate diagEnv zoning diagHelp cfgDelete diagLoopId zoning license diagnostics cfgDisable and burninLevel zoning and camTest cfgDisable and diagCommandShow cfgEnable and diagDisablePost zoning and diagEnv cfgRemove and diagPost zoning license required...
  • Page 811 failover and active ISLs and haDump and bcastShow and haFailover and fabStatShow and haSyncStop and fwConfigure FA-MIB and interfaceShow fastwrite and portCfgGPort FA-TRAP and portCfgISLMode faZoneCreate and portFlagsShow zoning and portLogShow FC Router and switchShow and trunkDebug FC2-16 port blade and uRouteConfig FC4-16 port blade EE mask...
  • Page 812 FSPF interfaceShow Inter-Switch Link interswitch link full-duplex fwConfigure AL_PA IOD, see in-order delivery IP route IP routes IPIF iproute G_Port iSCSI gateway GbE, see gigabit Ethernet GBIC Inter-Switch Link gigabit Ethernet ISL Trunking ISL Trunking commands ISL, see interswitch link GigPHY Java HA, see high availability...
  • Page 813 password Secure Fabric OS and login Security and secHelp Trunking and secNonFCSPasswd link metric and secTempPasswdSet link state record and SNMPv3 and supportFTP logical SAN and supportSave login expiration policy long distance settings password info perfAddEEMonitor LSAN, see logical SAN perfClearAlpaCrc lsanZoneShow Performance Monitor...
  • Page 814 secHelp secModeDisable proc entry information secModeEnabled public key infrastructure security license required secModeShow secPolicyActivate secPolicyAdd secPolicyFCSMove secStatShow secTempPasswdSet QuickLoop Secure Fabric OS Secure Fabric OS commands QuickLoop Fabric Assist mode commands secure mode R_A_TOV RADIUS secure telnet commands RASLOG security read link status reboot and secFabricShow...
  • Page 815 setModem tape pipelining active CP temperature readings time zone timeout value shellFlowControlEnable topology active CP trace shutdown track-changes feature from the active CP trackChangesSet SID used trunkDebug single-domain systems Trunking SNMP turbo SRAM logic test turboRamTest txdPath spinJitter ASIC spinSilk SPLB SRAM BIST test sramRetentionTest...
  • Page 816 zone configuration and cfgActvShow and zone clearing displaying inaliShow incfgShow show active zoneAdd zoneCreate zoneDelete zoneObjectCopy zoneObjectExpunge zoneObjectRename zoneRemove zoneShow zoning Advanced Zoning commands and aliCreate and cfgSize and configDefault and configDownload and interopMode and lsanZoneShow and secModeEnable cfgSave clearing zoning configurations creating disabling display in fabStatShow...

This manual is also suitable for:

A7990a - storageworks san director 4/16 blade switchAa979a - storageworks san switch 2/8vAe370a - brocade 4gb san switch 4/12Storageworks 2/128 - san director switchStorageworks 2/16v - san switchStorageworks 2/32 - san switch

Table of Contents