HP StorageWorks 8/8 Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01,
HP StorageWorks 8/8 - SAN Switch Manual
View all HP StorageWorks 8/8 manuals
Add to My Manuals
Save this manual to your list of manuals |
HP StorageWorks 8/8 manual content summary:
- HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 1
53-1001337-01 ® 28 July 2009 Fabric OS Command Reference Manual Supporting Fabric OS v6.3.0 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 2
are registered trademarks, and DCFM, Extraordinary Networks, and SAN Health are trademarks of Brocade Communications Systems, Inc., in warranty, expressed or implied, concerning any equipment, equipment feature, or service offered or to be offered by Brocade. Brocade reserves the right /support/oscd. - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 3
Brocade Communications Systems, Incorporated Corporate and Latin American Headquarters Brocade Communications Systems, Inc. 1745 Technology Drive San Jose, CA 95110 Tel: 1-408-333-8000 Fax: 1-408-333-8101 Email: [email protected] European Headquarters Brocade Communications Switzerland Sàrl Centre - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 4
support new v6.1 functionality. Removed 6 operands from 6 commands. Corrected errors support new Fabric OS v6.2.0 features. Removed 8 deprecated commands. Miscellaneous edits to ~40 commands to correct edits, update examples etc. Removed standby CP command table. Updated Preface, surrounding chapters - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 5
18 new commands. Modified 27 commands with new command operands to support new Fabric OS v6.3.0 features. Removed 6 deprecated command options. Removed correct edits, update examples etc. Updated Preface, surrounding chapters, and permission tables. July 2009 Fabric OS Command Reference v - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 6
vi Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 7
xxi Supported hardware and software xxi What is new in this document xxiii Document conventions xxv Notice to the reader xxvii Additional information xxviii Getting technical help xxviii Document feedback xxix Chapter 1 Using Fabric OS Commands In this chapter 1 Understanding role-based - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 8
authUtil 51 bannerSet 55 bannerShow 56 bcastShow 57 bladeCfgGeMode 58 bladeDisable 60 bladeEnable 62 bladeSwap 64 bootLunCfg 65 bottleneckMon 66 bpPortLoopbackTest 70 bpTurboRamTest 73 cfgActvShow 75 cfgAdd 76 cfgClear 77 cfgCreate 78 cfgDelete 79 cfgDisable 80 cfgEnable 81 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 9
Fabric OS Command Reference 53-1001337-01 configDownload 106 configList 111 configRemove 112 configShow 113 configUpload 117 configure 121 configureChassis 129 cryptoCfg 131 dataTypeShow 179 date 180 dbgShow 182 defZone 183 diagClearError 185 diagDisablePost 186 diagEnablePost 187 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 10
fabricShow 217 fabStatsShow 219 fabSwitchShow 221 fanDisable 222 fanEnable 223 fanShow 224 fastboot 225 fastWriteCfg 226 fcipChipTest 228 fcipHelp 230 fcipPathTest 231 fcLunQuery 233 FCoE 234 fcoeLoginCfg 238 fcoeLoginGroup 240 fcPing 242 fcpLogClear 246 fcpLogDisable 247 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 11
Fabric OS Command Reference 53-1001337-01 fcrXlateConfig 283 fddCfg 286 fdmiCacheShow 288 fdmiShow 289 ficonClear 290 ficonCupSet 291 ficonCupShow 293 ficonHelp 295 ficonShow 296 fipsCfg 302 firmwareCommit 305 firmwareDownload 306 firmwareDownloadStatus 311 firmwareKeyShow 314 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 12
haEnable 357 haFailover 358 haShow 359 haSyncStart 361 haSyncStop 362 help 363 historyLastShow 365 historyMode 366 historyShow 367 httpCfgShow 369 i 370 iclCfg 372 ifModeSet 374 ifModeShow 376 interfaceShow 378 interopMode 382 iodDelayReset 386 iodDelayShow 387 iodReset 388 iodSet - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 13
Fabric OS Command Reference 53-1001337-01 lfCfg 446 licenseAdd 449 licenseHelp 450 licenseIdShow 451 licensePort 452 licenseRemove 454 licenseShow 456 licenseSlotCfg 458 linkCost 462 login 464 logout 465 lsanZoneShow 466 lsCfg 468 lsDbShow 473 fosExec 476 memShow 479 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 14
pathInfo 519 pdShow 525 perfAddEEMonitor 526 perfResourceShow 530 perfAddIPMonitor 534 perfAddReadMonitor 535 perfAddRWMonitor 536 perfAddSCSIMonitor 537 perfAddUserMonitor 538 perfAddWriteMonitor 540 perfCfgClear 541 perfCfgRestore 542 perfCfgSave 543 perfClearAlpaCrc 544 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 15
Fabric OS Command Reference 53-1001337-01 portCfgEport 603 portCfgEXPort 604 portCfgFillword 607 portCfgFportBuffers 608 portCfgGport 609 portCfgISLMode 610 portCfgLongDistance 612 portCfgLport 615 portcfgGeMediaType 617 portCfgNPIVPort 618 portCfgNPort 620 portCfgPersistentDisable 621 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 16
portLogShow 670 portLogShowPort 675 portLogTypeDisable 676 portLogTypeEnable 677 portLoopbackTest 678 portMirror 681 portName 684 portPerfShow 685 portRouteShow 687 portShow 689 portStats64Show 725 portStatsClear 728 portStatsShow 729 portSwap 735 portSwapDisable 736 portSwapEnable - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 17
Fabric OS Command Reference 53-1001337-01 secPolicyDelete 782 secPolicyDump 784 secPolicyFCSMove 787 secPolicyRemove 789 secPolicySave 791 secPolicyShow 792 secStatsReset 794 secStatsShow 796 sensorShow 798 setContext 799 setDbg 800 setModem 801 setVerbose 802 sfpShow 803 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 18
switchDisable 852 switchEnable 853 switchName 854 switchShow 855 switchStatusPolicySet 863 switchStatusPolicyShow 865 switchStatusShow 867 switchUptime 869 switchViolation 870 syslogdFacility 871 syslogdIpAdd 872 syslogdIpRemove 873 syslogdIpShow 874 sysMonitor 875 sysShutDown 877 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 19
Chapter 3 Appendix A zone 920 zoneAdd 929 zoneCreate 930 zoneDelete 932 zoneHelp 933 zoneObjectCopy 934 zoneObjectExpung 935 zoneObjectRename 936 zoneRemove 937 zoneShow 938 Primary FCS commands Primary - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 20
xx Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 21
SAN and Brocade switches. • Chapter 2, "Fabric OS Commands" provides command information. • Chapter Based Access Control as well as Virtual Fabric and Admin Domain restriction checks used to validate commands. Supported hardware and software This document includes updated information specific - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 22
• Brocade 7800 Extension Switch • Brocade 8000 FCoE Switch • Brocade Encryption Switch • Brocade DCX Backbone supported by Brocade Communications Systems, Inc. for Fabric OS v6.3.0, documenting all possible configurations and scenarios is beyond the scope of this document. This document is specific - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 23
and commands that were modified to support the current Fabric OS release and the new Brocade Extension Platform (Brocade 7800,and FX8- , no Brocade help page • wwnAddress - WWN-based switch configuration. The following commands have been modified to support new command options: • ag (Access Gateway) - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 24
to enable the Ethernet Switch service (for upgrade/downgrade). • fosExec - New --fid all option to execute a command on all logical switches. • help - New all logical switches. • licenseShow - Output modification to support new licensing requirements (upgrade licensing, slot-based licensing). - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 25
display blade information. - Expanded output displays. • slotShow - Support for new hardware. • traceDump - New -c option to errors. The following commands and command operands have been removed from this manual is a debug function not intended for end users. NOTE Automatic page breaks in CLI command - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 26
For readability, command names in the narrative portions of this guide are presented in mixed letter case, for example, switchShow. In examples, command letter case is all lowercase. If there are exceptions, this manual specifically notes those cases in which a command is case-sensitive. Command - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 27
Brocade resources" on page xxviii for instructions on accessing the information. For definitions of SAN-specific terms, visit the Storage Networking Industry Corporation Referenced Trademarks and Products Commvault Thales NCKA EMC HP IBM Legato Microsoft Corporation NetApp Sun Microsystems, Inc. - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 28
: 1. General Information • Switch model • Switch operating system version • Error numbers and messages received • supportSave command output • Detailed description of the problem, including the switch or fabric behavior immediately following the problem, and specific questions xxviii Fabric OS - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 29
troubleshooting steps already performed and the results • Serial console and Telnet session logs • syslog message logs 2. Switch Serial Number The switch accuracy and completeness of this document. However, if you find an error or an omission, or you think that a topic needs further development, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 30
xxx Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 31
the command line interface 3 Understanding role-based access control Fabric OS implements Role-Based Access Control (RBAC) to control access to all Fabric OS operations. Seven roles are supported, as defined in Table 1. Role definitions are guided by perceived common operational situations and - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 32
3 Switch Types Switch Type Definition All Switches Command can be executed in any switch context. Base Switch Only Command can be executed only on the base switch. Default Switch Only Command can be executed only on the default switch. N/A Command is a chassis command or not supported in - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 33
a secure Telnet or SSH session, as indicated in the command description in this manual. Access is controlled by a switch-level password for each access level. The commands available through the CLI are based on the user's login role and the license keys used to unlock certain features. The Fabric - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 34
provisioning, and daily management of every aspect of storage area networks (SAN). • A deeper view of the tasks involved in managing a Brocade SAN. • Identification, isolation, and management of SAN events across every switch in the fabric. • Management of Brocade licenses. The documentation for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 35
(CHAP) and, for switches running Fabric OS v5.3.0 or later, Protected Extensible Authentication Protocol (PEAP). In addition, Fabric OS v6.0.0 provides support for Light-weight Directory Access Protocol (LDAP) authentication against Active Directory for user authentication and authorization. RADIUS - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 36
can use centralized RADIUS servers to manage AAA services for a switch, as defined in the RFC 2865 RADIUS specification. Fabric OS v6.1.0 and later is required to configure LDAP while in FIPS mode. Refer to the Fabric OS Administrator's Guide for configuration procedures. This command can be - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 37
secret between the switch and the RADIUS Protocol peap-mschapv2 Protected Extensible Authentication Protocol (requires Fabric services. Services must be enclosed in double quotation marks. The following AAA services and service pairs are valid: "local" Default setting. Authenticates the user - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 38
credentials are correct, the user authentication succeeds. If the user provides credentials from the switch database, the RADIUS authentication fails but login succeeds through the switch database. Enables the current LDAP configuration as the primary AAA service and the switch-local database as the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 39
See Also To replace the AAA service with backup option: switch:admin> aaaconfig --authspec "ldap;local" -backup none aaaConfig 2 Fabric OS Command Reference 9 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 40
only the Defined Configuration in the transaction buffer. The --save option sends the changes made in the transaction buffer to all other switches and permanently saves the changes to the Defined configuration in persistent storage. The --apply option performs a save operation, sends a request to - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 41
restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, the description of actions. The following actions are supported: --activate arg Activates an Admin Domain. An and enforces the defined configuration on all switches in the fabric. ad --apply prompts - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 42
be empty for the delete operation to succeed. Not all existing user sessions to a deleted Admin Domain are terminated; however, subsequent CLI Saves the outstanding Admin Domain transaction to the defined configuration on all switches in the fabric. The saved Admin Domain definition is enforced only - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 43
ad --show; however, all members that are from non-Admin Domain aware switches are marked with a plus sign (+). Members that are not online are it is an internal Admin Domain transaction. The following arguments are supported with selected AD actions: ad_id Uniquely identifies an Admin Domain. An - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 44
Uses traditional zone WWN member types. Benefits include: • Supports node or port WWNs. • End-device members, switch. Any switch member specified in Domain ID format is converted into a switch WWN-based on the current fabric information. Operations with switch list fail if the domain ID to switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 45
> ad --create "AD1", -s "100; 10:00:00:60:69:80:59:13" To create an Admin Domain with a device list and a 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" Fabric OS - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 46
in an AD7 context (using the current user_id): switch:admin> ad --exec 7 "switchshow" To rename Eng_AD to Eng_AD2: switch:admin> ad --rename Eng_AD Eng_AD2 To rename AD 200 to Eng_AD200: switch:admin> ad --rename 200 Eng_AD200 To rename a user-assigned Admin Domain name to a reserved Admin Domain - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 47
11; 1,12; 1,13; 1,14; 1,15; 10:00:00:60:69:00:02:53; To display the AD1 configuration information in the transaction buffer: switch:admin> ad --show 1 -m 0 Current AD: 255 : AD255 Transaction buffer configuration no configuration To display the AD10 configuration information in persistent storage - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 48
:00:14:00:00; AD Number: 2 AD Name: ad2 State: Inactive Device WWN members: Switch port members: 10:00:00:06:2b:12:68:2b; 10:00:00:06:2b:12:68 :3f; 1,8; 69,16; AD Number: 3 AD Name: AD3 State: Inactive Device WWN members: Switch port members: 11:22:33:44:55:66:77:88*; 10:00:00:06:2b:12:64:54; - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 49
66:77:88*; AD Number: 5 AD Name: AD5 State: Inactive Device WWN members: Switch port members: 10:00:00:06:2b:12:69:ff*; 10:00:00:06:2b: 00:00; Effective configuration AD Number: 50 AD Name: AD50 State: Active Device WWN members: Switch port members: 10:00:00:00:00:17:00:00; 10:00:00:00:00:15 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 50
the AD transaction (yes, y, no, n): [no] y See Also To display the current Admin Domain transaction: switch:admin> ad --transshow Current transaction token is 26816 It is abortable switch:admin> ad --transshow There is no outstanding zoning transaction cfgSave, cfgTransShow, defZone, logout. 20 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 51
ag 2 ag Enables Access Gateway (AG) and manages AG-specific operations. Synopsis ag --help ag --show ag --modeshow | --modeenable |--modedisable ag [--policyenable | --policydisable] policy ag --policyshow ag --mapshow [N_Port] ag [--mapset | --mapadd |--mapdel] N_Port [F_Port1; - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 52
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. AG is supported only on selected Brocade hardware platforms. Refer to the Access Gateway Administrator's Guide for Hardware support and AG configuration procedures. In non-AG - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 53
enabled or disabled. AG supports three types of policies: • Port Grouping (pg) policy: This policy manages failover of an F_Port to a set of related N_Ports in a port group. • Auto Port Configuration (auto): When this policy is enabled, the AG enabled switch automatically detects available ports - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 54
;...] Deletes one or more specified F_Ports from the "primary" N_Port mapping. --pgshow [pgid] Displays the Port Group configuration. The port grouping feature supports specifying a set of N_Ports to be included in the Port Group (PG) Policy. The factory default PG is "pg0", which includes all - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 55
a semicolon. Alternately you can set the modes at the time when you create the port group with the pgcreate command. The following modes are supported: lb Specifies the login balancing mode for the specified port group. If login balancing mode is enabled and an F_Port goes offline, logins in the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 56
2 ag 26 --failovershow [N_Port] If an N_Port is specified (optional), the command displays the failover policy for this N_Port. Otherwise, the failover policy for all N_Ports is displayed. Failover is displayed as enabled (1) or disabled (0). --failbackenable [N_Port | -pg pgid] Enables the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 57
logged out. --clearalpamap F_Port Clears the ALPA values for the specific F_Port. This command removes the PWWN-to-ALPA-value mapping from Access Gateway with Failover (FO) and Failback (FB) enabled on N_Ports 9 and 12: switch:admin> ag --show Name : switch_ST1 NodeName : 10:00:00:05:1e:35:9b: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 58
06:2b:0a:a3:91 3 1 no 13 0x6d0d01 10:00:00:06:2b:0a:a3:90 3 1 no 2. To display the current Access Gateway mode: switch:admin> ag --modeshow Access Gateway mode is enabled. switch:admin> ag --modeshow Access Gateway mode is NOT enabled. AG group policy commands 1. To show current policies - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 59
configuration using configupload. Do you want to continue? (yes, y, no, n): [no] y 5. To disable auto port configuration policy when the switch is disabled: switch:admin> ag --policydisable auto Default factory settings will be restored. Default mappings will come into effect. Please save the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 60
for F_Port[s] Please delete it before removing primary N_Port ERROR:Unable to remove F_Port[s] from mapping, retry the command switch:admin> ag --prefshow F_Ports Preferred N_Port 10;11 0 4;5;6 2 7;8;9 3 switch:admin> ag --prefdel 5 2 Preferred N_Port is deleted successfully for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 61
admin> ag --failoverenable 1 Failover policy is enabled for port 1 switch:admin> ag --failoverdisable 0 Failover policy is disabled for port 0 switch:admin> ag --failovershow 0 Failover on N_Port 0 is not supported switch:admin> ag --failbackdisable 2 Failback policy is disabled for port 2 admin - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 62
2. To create a port group "FirstFabric" that includes N_Ports 1 and 3 and has login balancing enabled: switch:admin> ag --pgcreate 3 "1;3" -n FirstFabric1 -m "lb" Port Group 3 created successfully switch:admin> ag --pgshow PG_ID PG_Name PG_Mode N_Ports F_Ports 0 pg0 lb,mfnm none none - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 63
set the list of allowed devices for Ports 11 and 12 to 'no access': switch:admin> ag--adsset"11;12""" WWN list set successfully as the Allow Lists the list of allowed devices for Ports 1, 10 and 13 to 'all access': switch:admin> ag--adsset"1;10;13""*" WWN list set successfully as the Allow Lists of - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 64
Lists of the F_Port[s] 5. To display the lists of allowed devices on the switch: switch:admin> ag --adsshow F_Port WWNs Allowed 1 ALL ACCESS 3 20:03:08: remove a device entry from the database when the device is offline: switch:admin> ag --deletepwwnfromdb 0:12:00:05:1e:85:92:88 Device - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 65
ag 2 See Also To remove a device entry from the database when the device is not present in the table: switch:admin> ag --deletepwwnfromdb 0:12:00:05:1e:85:92:00 20:12:00:05:1e:85:92:00 not found. Please check the device name - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 66
fport Enabled or disabled • If Auto Policy is enabled on the switch, the command displays the status of the automatic rebalancing feature per port Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 67
port group is specified, command execution is targeted to the members of that specific port group. When all port groups are specified, command execution is targeted automatic login redistribution settings for port groups 0 and 1: switch:admin> agautomapbalance --show AG Policy: pg PG_ID LB - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 68
:admin> agautomapbalance --disable -fport To disable automatic login redistribution on F_Ports and N_Ports on port group 1 in the Access Gateway: switch:admin> agautomapbalance --enable -fport pg 1 To disable automatic login redistribution on F_Ports and N_Ports on all port groups in the Access - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 69
Remote Indicates whether the Access Gateway is locally or remotely registered to this switch. World Wide Name The world wide name (WWN) of the given Gateway. Use portCfgNPIVPort to enable NPIV capability on the specific port. Operands This command has the following optional operands: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 70
:00:05:1e:04:06:ae 24 10.32.173.64 v6.0.0 local L5D2_B14_4024_1 See Also To display all Access Gateways attached to the fabric: switch:admin> agshow Worldwide Name Ports Enet IP Addr Firmware Local/Remote Name 10:00:00:05:1e:02:b7:2c 16 10.32.173.62 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 71
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for member can be specified by one or more of the following methods: • A switch domain and port index pair. Use switchShow for a list of valid port index - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 72
more information on name and member specifications. This command changes the defined Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, by one or more of the following methods: • A switch domain and port index pair. Use switchShow for a list of - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 73
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for is enabled, this command can be issued only from the primary FCS switch. Operands The following operand is required: "aliName" Specify the name of - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 74
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for member can be specified by one or more of the following methods: • A switch domain and port index number pair. Use switchShow for a list of valid port - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 75
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" description of this display. Examples To display all zone aliases beginning with "arr": switch:admin> alishow "arr*" alias: array1 21:00:00:20:37:0c:76:8c - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 76
that policy settings for the base switch or any switch in the base fabric affect all traffic going through the base fabric including any logical fabric traffic that uses the base fabric. When invoked without arguments, this command displays the APT policies supported on this switch, as well as the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 77
option supported under both port-based and exchange-based policies. The following policies are supported: AP switch performance. Examples To display the current APT policy: switch:admin> aptpolicy Current Policy: 3 1(ap) 3 1 (ap): Default Policy 1: Port Based Routing Policy 3: Exchange Based - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 78
to enable or disable audit filters. Based on the configuration, certain classes are be in place. Refer to chapter 1, "Using Fabric OS commands" displayed. Valid values are INFO, WARNING, ERROR, and CRITICAL. By default, all switch:admin> auditcfg --class 2,3 Audit filter is configured. switch: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 79
See Also switch:admin> auditcfg --show Audit filter is disabled. 1-ZONE 2-SECURITY 3-CONFIGURATION 4-FIRMWARE 5-FABRIC Severity level: INFO auditDump auditCfg 2 Fabric OS Command Reference 49 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 80
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operands: -s | -show Displays the audit log on the switch or the CP. -c | -clear Clears the audit log on - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 81
chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands When invoked without operands, this command displays the usage. The following operands are supported is given priority over DH-CHAP on the local switch. -g 0|1|2|3|4|* Sets the Diffie-Hellman (DH) - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 82
FIPS. Refer to the Fabric OS Administrator's Guide for details on FIPS configuration. --policy Sets the switch authentication policy or device authentication policy. The following options are supported: -sw on|off|active|passive Sets the switch authentication policy. Specify one of the following - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 83
]/portnumber...| allE Re-initiates authentication on selected ports after changing the DH-CHAP group, hash type, and shared secret between a pair of switches. This command does not work on Private, Loop, NPIV and FICON devices. The command can re-initiate authentication only if the device was - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 84
authutil --show AUTH TYPE HASH TYPE GROUP TYPE fcap,dhchap sha1,md5 1 Switch Authentication Policy: PASSIVE Device Authentication Policy: OFF switch:admin> authutil --set -h sha1 Hash is set to sha1. switch:admin> authutil --show AUTH TYPE HASH TYPE GROUP TYPE fcap,dhchap sha1 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 85
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" characters. Examples To set a new banner for a switch: switch:admin> bannerset "My banner" switch:admin> bannerSet Please input context of security banner (press - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 86
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the banner for a switch: switch:admin> bannershow Banner: Do not log into this switch if you are not an authorized administrator. See - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 87
to display the broadcast routing information for all ports in the switch. The broadcast routing information indicates all ports that are members Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 88
port mode on the Brocade FX8-24 extension blade or to display the configuration. The to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is supported only 1G mode: switch:admin> bladecfggemode --set 1g -slot 4 switch:admin> To display the GbE port mode - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 89
bladeCfgGeMode 2 See Also To display the GbE port mode for all configured slots: switch:admin> bladecfggemode --show -all bladeCfgGeMode: Blade in slot 1 is configured in 1GigE Mode 1GigE mode: only the ge0-9 ports are enabled (xge0 and xge1 are - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 90
user ports on a blade. All Fibre Channel ports on the blade are taken offline. If the switch was connected to a fabric through this blade, the remaining switches reconfigure, and the switch reconfigures based that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 91
FC Disabled FC Disabled FC Disabled FC Disabled FC Disabled Slot Blade Type ID Status 1 SW BLADE 2 ENABLED 2 SW BLADE 2 ENABLED (User Ports Disabled) 3 SW BLADE 2 ENABLED 4 SW BLADE 2 ENABLED 5 CP BLADE 1 ENABLED 6 CP BLADE 1 ENABLED 7 SW BLADE 2 ENABLED 8 SW BLADE - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 92
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" Examples To display the slot status, enable the user ports in slot 4, and verify the settings: switch:admin> slotshow Slot Blade Type ID Status 1 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 93
bladeEnable 2 See Also switch:admin> slotshow Slot Blade Type ID Status 1 SW BLADE 2 ENABLED 2 UNKNOWN VACANT 3 UNKNOWN VACANT 4 SW BLADE 2 ENABLED 5 CP BLADE 1 ENABLED 6 CP BLADE 1 ENABLED 7 SW BLADE 2 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 94
to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. To swap area numbers between matching port pairs of two slots: switch:admin> bladeswap -src 1 -dest 3 bladeswap done See Also - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 95
the boot LUN for an HBA. Existing fabric-based boot LUN discovery allows the host's boot LUN restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, Successful To remove an HBA to Port/LUN mapping: switch:admin> bootluncfg --delete 11:22:ab:44:44:ff - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 96
for this port using the retained configuration. This feature allows you to configure more than one logical switch to perform bottleneck detection on the same port, although only one logical switch performs the operation on the port at any given time. The --show option displays a history of the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 97
is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is supported only on Fibre Channel F_Ports and FL_Ports. When you attempt to enable bottleneck monitoring on - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 98
(24 hours). --disable Disables bottleneck detection on one or more specified ports. If Virtual Fabrics are enabled on the switch, the ports do not need to belong to the logical switch in whose context the command is issued. This command succeeds on online or offline ports that have bottleneck - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 99
Jun 15 18:54:10 80.00% To display the ports which are monitored for devices affected by latency bottlenecks: switch:admin> bottleneckmon --status Slot Port Alerts? Threshold Time (s) Quiet Time (s) 2 0 N -- -- -- 2 1 Y 0.200 250 500 2 24 N -- -- -- none Fabric OS Command - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 100
to verify the functional operation of the switch. The test sends frames from a specified 5. Check if any of the following statistic error counters report non-zero values: ENC_in, CRC_err , ... Notes This command does not support High Availability (HA). 70 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 101
supported only on the Brocade Encryption platform at a default speed of 4 Gbps and a loopback mode of 7. Use portLoopBackTest on all other platforms. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter frame: switch:admin> - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 102
When it detects failures, the test may report one or more of the following error messages. If errors persist, contact Technical Support. DATA Data received does not match the data sent. ERRSTAT Errors were found in the ASIC statistics. INIT Port failed to initialize. PORTDIED A previously - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 103
is currently supported only on the Brocade Encryption platform. It complements the bpturboramTest, which tests the Condor2 ASIC on the switch. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 104
2 bpTurboRamTest Example SEE ALSO To run the test in default mode: switch:admin> bpturboramtest Running bpturboramtest Board Init Running Vader bist test Vader bist test PASSED Running Ob1 bist test Ob1 bist test PASSED BIST test PASSED - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 105
devices that an initiator sees are based on this configuration. The effective that may be in place. Refer to chapter 1, "Using Fabric OS commands" and none Examples To display the effective zone configuration information: switch:admin> cfgactvshow Effective configuration: cfg: c4 zone: z3 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 106
the cfgEnable command. For the change to be preserved across switch reboots, save the configuration to nonvolatile memory with the cfgSave Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 107
disable and clear the zone configuration in nonvolatile memory for all the switches in the fabric. If no current zoning configuration exists, use Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 108
specifications. Notes The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter allowed. Examples To create a configuration containing three zones: switch:admin> cfgcreate "USA_cfg", "Purple_zone;Blue_zone;Green_zone" See Also - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 109
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for is enabled, this command can be issued only from the primary FCS switch. Operands The following operand is required: "cfgName" Specify a name - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 110
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for only from the primary FCS switch. Operands none Examples To disable the current zone configuration: switch:admin> cfgdisable You are about - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 111
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details zone configuration. Examples To enable the zone configuration USA_cfg: switch:admin> cfgenable USA_cfg You are about to enable a new - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 112
enables or disables the specific feature fabric-wide, meaning that the feature is disabled or enabled on all switches in the fabric. Notes The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 113
with the cfgEnable command. For the change to be preserved across switch reboots, save the configuration to nonvolatile memory with the cfgSave Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 114
configuration by performing the same tests as cfgEnable. If the tests fail, an error displays and the configuration is not saved. This command ends and commits the current transaction. If a transaction is open on a different switch in the fabric when this command is run, the transaction on the other - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 115
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is only effective when the Brocade switch/director is in McDATA fabric mode. Operands The cfgSaveActiveToDefined command has no - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 116
effective) displays. If the local switch has an outstanding transaction, this command based on this configuration. The effective configuration is built when a specific zone configuration is enabled and all error that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 117
1,0 21:00:00:20:37:0c:76:85 21:00:00:20:37:0c:71:df See Also To display only configuration names: switch:admin> cfgshow "*" cfg: USA1 Blue_zone cfg: USA_cfg Red_zone; Blue_zone cfgAdd, cfgClear, cfgCreate, cfgDelete, cfgDisable, cfgEnable, cfgRemove, cfgSave, cfgTransAbort, cfgTransShow Fabric OS - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 118
Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. When an FCS policy is enabled, this command can be issued only from the primary FCS switch. In order to support non-disruptive Hot Code Load on a Brocade 5100 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 119
cfgSize 2 To display Admin Domain and zone database information in AD255 context: switch:admin> cfgsize Maximum AD and Zone DB size - 1045274 bytes Total Committed AD and Zone DB size - 3390 bytes AD and Zone DB uncommitted space - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 120
when this command is run, the transaction on the other switch remains open and unaffected. Notes The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 121
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for y, no, n): [no] y Clearing All zoning configurations... switch:admin> cfgtransshow Current transaction token is 271010736 It is abortable See - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 122
and functional. However, if diagnostic frame-based tests such as portLoopbackTest are executed, the Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, switch:admin> chassisbeacon 1 Chassis beacon success 1 To turn beaconing mode off: switch:admin - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 123
the specified mode. This may result in some blades being faulted as incompatible, based on the new configuration option. When an option is not supported by the platform, this command is rejected without causing a reboot. 5 One 384-port switch (Blade ID 17, 18, 24, 31, 33, 36, 39 in slots 1-4, 7-10 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 124
command to manually distribute IP switches. Displays the originating switch WWN in switches running earlier Fabric OS versions. CHASSISNAME Displays the name of the originating chassis.. SUPPORTED_DIST Displays yes if the distribution is supported in place. Refer to chapter 1, "Using Fabric OS - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 125
without confirmation. To distribute the IP Filter policies to all chassis that are connected through the logical fabric 128 and support the distribute feature: switch:admin> chassisDistribute -db "IPFILTER" -fid 128 FID DOMAIN CHASSISWWN CHASSISNAME SUPPORTED_DIST 128 3 10:00:00:05:1e:38:ac - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 126
2 chassisEnable chassisEnable Enables all user ports in a chassis. Synopsis chassisenable Description Use this command to Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To enable a chassis: switch:admin> chassisenable - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 127
. Commands that require the chassis to be disabled generate an error message if invoked while the chassis is enabled. It is not necessary to disable a chassis before rebooting or powering off. To disable the ports of a single logical switch, use the switchDisable command. To disable the ports of - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 128
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for To change the chassis name to "dilbert": switch:admin> chassisname dilbert switch:admin> chassisname dilbert See Also switchName 98 Fabric - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 129
in hexadecimal. 2 Object type: CHASSIS, FAN, POWER SUPPLY, SW BLADE (switch), CP BLADE (control processor), WWN (world wide name), or UNKNOWN. Object Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 130
2 chassisShow Examples See Also To display all FRUs for a switch: switch:user> chassisshow Chassis Backplane Revision: 1C SW BLADE Slot: 3 Header Version: Power Consume Factor: Factory Part Num: Factory Serial Num: Manufacture: Update: Time Alive: Time Awake: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 131
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" the standby CP. Operands none Examples To display the command history on a switch: switch:admin> clihistory Command History: 09:14:17.6924 1 admin, 192.168 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 132
GbE interfaces and L2/L3 protocol services. The CEE management shell provides Ethernet Administrator's Guide for information chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands None Examples To run FCoE using the minimum switch configuration: switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 133
an FCoE VLAN: switch:admin> cmsh switch:admin>en switch:admin>#conf t switch:admin>(config)#protocol lldp switch:admin>(conf-lldp)# advertise dcbx-fcoe-app-tlv switch:admin>(conf-lldp)# advertise dcbx-fcoe-logical-link-tlv switch:admin>(conf-lldp)#exit switch:admin>(config)#exit switch:admin>(config - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 134
wide name • Zoning configuration (includes aliases, zones, and configurations) • Security parameters and policies • User account passwords (includes all user configuration and all built-in accounts) • Switch PID format • Ethernet Link Mode Refer to the help files for configure and configureChassis - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 135
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for following operands: -fid FID Specifies the Fabric ID of the logical switch for which to reset the configuration. This operand is valid only in - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 136
configuration parameters. The Virtual Fabric configuration file includes logical switch definitions for a specific platform, the platform ID, Virtual Fabric status (enabled this command downloads the switch configuration to the current logical switch only. An Admin user with chassis permissions can - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 137
user is allowed to execute. • In a non-Virtual Fabric environment, this command by default downloads the switch configuration. Additional options support to the default switch or chassis. For more information on compatibility refer to the Fabric OS Administrator's Guide. The switch must be disabled - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 138
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Do not manually edit a configuration file after uploading the file and before downloading the file to a switch. Manual editing bypasses sanity checks for some configuration - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 139
IPv4 and IPv6 addresses are supported. To be able to mention User Name [user]: admin Path/Filename [/config.txt]: Section (all|chassis|FID# [all]): *** CAUTION *** This command is used to download a backed-up configuration for a specific switch. If using a file from a different switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 140
The FTP server is not running on the host. • The configuration file contains errors. • The configuration file's logical switch definitions do not match the definitions on the target switch. See Also configDefault, configList, configShow, configUpload, configure, configRemove 110 Fabric OS Command - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 141
Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Examples To display a list of configuration files stored on the local chassis: switch:admin> configlist -local config.txt config2.txt next_cfg.txt 25679 25679 20977 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 142
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" name. Examples To remove a configuration file from the local chassis: switch:admin> configremove -local first_config.txt To remove a configuration file from - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 143
grouped into chassis information and switch information. Each configuration type restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix and other common regular expression operators is not supported. Some configuration settings do not display when filtered - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 144
of the information provided when -USB is not specified. Examples To display all configuration data on a Virtual Fabric-enabled system: switch :admin> configshow -all [Configuration upload Information] Configuration Format = 2.0 date = Tue Oct 7 14:54:20 2008 FOS version = v6.2.0.0 Number of - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 145
.lockoutthreshold:0 passwdcfg.lockoutduration:30 passwdcfg.adminlockout:0 passwdcfg.repeat:1 passwdcfg.sequence:1 passwdcfg.status:0 To display switch configuration data for FID 20: switch :admin> configshow -fid 20 [Configuration upload Information] Configuration Format = 2.0 date = Tue Oct 7 14:53 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 146
2 configShow See Also FOS version = v6.2.0.0 Number of LS = 3 [Switch Configuration Begin : 0] SwitchName = Spirit_66 Fabric ID = 20 [Boot Parameters] boot.name:Spirit_66 boot.ipa:10.32.228.66 boot.licid:10:00:00:05:1e: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 147
(no operands) prompts for input on only the parameters the user is allowed to execute. • In a non-Virtual Fabric environment, this command by default uploads the switch configuration only. Additional options support uploading the chassis configuration (-chassis) or all of the system's configuration - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 148
OS Administrator's Guide for information on chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Do not manually edit a configuration or a switch user" "path" Uploads all system configuration data including chassis and switch configuration for all logical switches - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 149
complete: All config parameters are uploaded To upload the switch configuration that belongs to a logical switch with FID 100: switch:admin> configupload Protocol (scp, ftp, local) [ftp]: Server Name or IP Address [host]: 10.32.220.100 User Name [user]: jdoe File Name [/config.txt]: config - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 150
The configuration upload might fail for one or more of the following reasons: • The host name is not known to the switch. • The host IP address cannot be contacted. • The user does not have permission on the host. • The FTP server is not running on the host. See Also configDefault, configDownload - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 151
information and switch information. Each configuration type is managed separately. For information on file format and specific parameters contained in Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 152
-to-buffer credit or timeout values, can be modified to suit specific applications or operating environments but must be in agreement among all switches to allow formation of the fabric. Table 2 lists the switch fabric settings that can be modified. TABLE 2 Configure command fabric parameters - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 153
switch to the base switch and carries traffic for multiple logical fabrics. This feature is supported port is physically located. This allows FICON users to make use of high port count error condition. Error detect time out value specified in milliseconds. This timer is used to flag a potential error - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 154
interrelated. Assigning a specific value to one or against each parameter. To reduce problems, the configuration utility validates (data) frame. The switch advertises this value to other switches in the fabric during routing priority, support is also available for per-frame-based prioritization when - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 155
to acquire from the fabric the domain number programmed in its "Switch Fabric Settings." If the operation fails, the switch will segment from the fabric. Virtual Channel Settings The switch enables fine-tuning for a specific application by configuring the parameters for eight virtual channels. The - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 156
the RSCN transmission mode values fields. TABLE 6 RSCN transmission modes Field End-device RSCN Transmission Mode Domain RSCN to End-device for switch IP address or name change Type number number Default 1 0 Range 0 to 2 0 to 1 End-device RSCN Transmission Mode values are as follows: 0 RSCN - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 157
Performed by the FCP daemon, RLS probing reads the link error block from the device. This extended link services command is defined by the FC standards. Refer to the File Length of crypto key Secure RPCd Callback secret Basic User Enabled Perform License Checking and Warning Allow Fabric Event - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 158
XISL use on a logical switch with FID 20: switch:admin> setcontext 20 switch:admin>switchdisable switch:admin>configure Configure... Change (yes, y, no, n): [no] Arbitrated Loop parameters (yes, y, no, n): [no] System services (yes, y, no, n): [no] Portlog events enable (yes, y, no, n): [no] ssl - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 159
system parameters. In a non-Virtual Fabric environment, disable the switch before configuring chassis parameters. Note The execution of this command is Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 160
If this field is set to a value other than 0, then any nonfatal HW ASIC data parity error causes the problem blade to be powered off. Examples To enable signature validation for downloading firmware: switch:admin> configurechassis Not all options will be available on an enabled - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 161
configure and manage the Brocade Encryption Switch and the FS8-18 encryption blade. These platforms support the encryption of data-at- hosts, follow the instructions described in the section "Configuring a multi-path Crypto LUN" in the Fabric OS Encryption Administrator's Guide. Note The execution - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 162
member node and group leader registration. • Group-wide policy configuration. • Zeroization of all critical security parameters on the local encryption switch or blade. • Certificate display and management. • Display of the local encryption engine status. Use the --show localEE command to display - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 163
center (KAC) certificate, the FIPS Crypto Officer, and the FIPS User key pairs. Some of the certificates generated with this command may need for mutual authentication. Refer to the Fabric OS Encryption Administrator's Guide for details. The --initnode function must be performed before the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 164
and FIPS User certificate are switch or blade to a specified external host or to a mounted USB device. This command is valid on all nodes. The files are exported from the predetermined directory that was generated during the node initialization phase. The following operands are supported - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 165
supported only for the RKM, HP SKM, and NCKA key vaults. -CPcert Exports the member node CP certificate. --import Imports a certificate from a specified external host or from a mounted USB storage device to a predetermined directory on the local encryption switch Specifies the user name for the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 166
the file name. -usb Imports a file from a mounted USB storage device. This command is valid only on nodes assigned to the imported file. This is a user-generated file name. source_filename Specifies the name of the group leader: member_node_WWN Specifies the switch world wide name of the member - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 167
this command on both a primary and a secondary key vault. The system generates a username based on the switch WWN. The username and group under which the username should be created on the key vault to the Fabric OS Encryption Administrator's Guide. Fabric OS Command Reference 137 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 168
| RKM | SKM | NCKA cryptocfg --set -failbackmode auto | manual cryptocfg --set -hbmisses value cryptocfg --set -hbtimeout value cryptocfg a node are part of the same encryption group. Fabric OS v6.2.0 and later support up to four nodes per encryption group, and up to two encryption engines per node - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 169
from the designated group leader. The encryption switch or blade on which you create the of the Fabric OS Encryption Administrator's Guide for a more comprehensive explanation of system group name: user-defined label • Encryption group policies: - Failback mode: Auto or Manual - Heartbeat misses - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 170
Certificate: the node CP certificate name (user-defined) - Current master key (or in the Fabric OS Encryption Administrator's Guide - Current master key ID (if RKM the GbE ports on the encryption switch or blade. The two GbE ports ipAddrSet help page for instructions on configuring the Ethernet - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 171
cert_label Specifies the key vault certificate label. This is a user-generated name for the specified key vault. Use cryptocfg reside in the predetermined directory where certificates are stored. In the case of the HP SKM, this operand specifies the CA file, which is the certificate of the signing - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 172
the RSA Key Manager (RKM) (opaque key repository). SKM Specifies the HP Secure Key Manager (SKM) (opaque key repository). NCKA Specifies the is enabled by default. manual Enables manual failback. In this mode, failback must be initiated manually after an encryption switch or blade that failed - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 173
cryptoCfg 2 value Specifies the heartbeat time-out in seconds. The default value is 2 seconds. Valid values are integers in the range between 1 and 30 seconds. --set -quorumsize value Sets the quorum size used to authenticate functions that require a quorum of authentication cards. The default - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 174
from a specified pass phrase. By default this command backs up the key to the attached key vaults, or optionally to a predetermined file on the switch. This command is valid only on the group leader. This command prompts for a pass phrase. passphrase Specifies the pass phrase for the master key - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 175
when restoring the master key from a file in the predetermined directory on the switch. Use this operand when the master key was backed up to a file rather Displays encryption group status information. --sync -encgroup Manually synchronizes the encryption group database belonging to the group - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 176
: numeric value • For each HA cluster: - HA cluster name: user-defined label - Number of encryption engine entries: numeric value - HA belong to different switches or chassis. This rule is enforced by the CLI to ensure redundancy. The following operands are supported: HA_cluster_name Specifies - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 177
to an already configured HA. A maximum of two HA cluster members is currently supported. The EEs must be part of the same encryption group as the node on on the group leader. The encryption engines must belong to different switches or chassis. This rule is enforced by the CLI to ensure redundancy - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 178
2 cryptoCfg HA_cluster_name Specifies the HA cluster member to be replaced. The HA cluster name must be specified when this operand is used. This operand is optional. It is not needed if the encryption engine to be replaced is not part of an HA cluster. current_node_WWN [slot_number] Specifies the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 179
data. A CryptoTarget container (CTC) is a configuration of "virtual devices" that is created for each target port hosted on a Brocade Encryption Switch or FS8-18 blade. The container holds the configuration information for a single target, including associated hosts and LUN settings. A CryptoTarget - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 180
information. This command set supports the following tasks: • to access the targets), or manually initiate a failback of an encryption OS Encryption Administrator's Guide for a more comprehensive user-define label • Number of containers: numeric value • For each container: - Container name: user - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 181
: (brocade) native or DF-compatible - Tape policy type: pool-based, LUN-based - Encrypt existing data: disabled or enabled - Rekey: disabled or enabled Encryption group name: user-defined label • Number of containers: numeric value • For each container - Container name: a user-defined label - Type - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 182
state: refer to the appendix in the Fabric OS Encryption Administrator's Guide • Encryption algorithm: AES256 -XTS (disk), AES256-CCM (tape), information for a specific CTC. When used with -stat the display includes the following LUN runtime status information: • Container name: user-defined label • - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 183
enabled or disabled - Rekey: enabled or disabled - Tape policy type: pool-based or LUN-based - Key life: key lifespan in days - Volume/pool label - LUN state: Refer to the Fabric OS Encryption Administrator's Guide. - Encryption algorithm: AES256 -XTS (disk), AES256-CCM (tape), or none - Compression - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 184
ID not applicable - Key life (in days): numeric value - Volume/pool label: user-defined label - Rekey status: numeric value If re-key or tape sessions are in Read or Write phase - Tape volume/pool Label: user-defined label - Tape state: mounted or unmounted - Tape policy configuration details: • Tape - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 185
Crypto LUN/initiator pair of a specific CryptoTarget container. The display includes the following information: • LUN number: numeric ID • LUN Serial Number (SN): alpha-numeric label • CryptoTarget container Name: user-defined name • Target: target port WWN and node WWN • Target PID: target PID - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 186
a specific container. The display includes the following information: • Number of tape sessions in progress: numeric value • Container name: user-defined decimal number beginning with 0 to an octal, which results in a conversion error. For example, 035 is interpreted as 29 (decimal), or 0x1D hex, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 187
with the Name Server. Initiator and target must be zoned for NS-based frame redirection to take effect. Use nsshow to verify the creation of the . This command is valid only on the group leader. The following operands are supported: disk | tape Specifies the type of the CTC as a disk array or - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 188
container for a listing of valid CTC names. --failback -EE Performs a manual failback of all CTCs that were failed over earlier to another encryption engine a "new" specified encryption engine. This command generates an error if the specified current encryption engine and new encryption engine are - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 189
Numbers must be 16-bit numbers in hex format. The Range parameter is not supported for 64-bit LUN numbers. The LUN number must be zero when a tape must be configured. Refer to the Fabric OS Encryption Administrator's Guide for more information. The following LUN policy parameters can be optionally - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 190
encryption format. Two encryption formats are supported: native The LUN uses the Brocade -compatible license to be present on the encryption switch or the chassis that houses the encryption blade become disabled (default) and generate errors when executed: -enable_encexistingdata, -enable_rekey, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 191
and generates an error. • For tape LUNs the -enable_encexistingdata and the -enable_rekey operands are not valid and return an error when executed. • tape sessions are in progress, refer to the Fabric OS Encryption Administrator's Guide. --remove -LUN Removes a LUN from a specified CTC. You must - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 192
command must be executed on the local switch that is hosting the LUN. No to the Fabric OS Encryption Administrator's Guide for a description of conditions under which supported: -label pool_label | -num pool_num Specifies the tape pool volume label or alternately the tape pool ID. This is a user - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 193
are in progress. Refer to the Fabric OS Administrator's Guide for more information. [-encryption_format native | DF_compatible] [-encrypt | -cleartext] --manual_rekey Performs a manual re-keying of a specified LUN associated with a specified CTC. Manual re-keying is performed in both online and - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 194
failure status messages. You must take corrective action to clear all error conditions that caused the re-key failure before resuming a suspended re . This command is valid on all nodes. The following operands are supported: -all -cfg Displays the configuration for all containers in the encryption - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 195
This command is valid on all nodes. The following operands are supported: crypto_target_container_name Specifies the CTC for which to display the Crypto or uncompressed blocks and/or byte counters for a specific CryptoLUN. The following operands are required: crypto_target_container_name Specifies - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 196
device configuration" on page 173 "F. Device configuration display commands" on page 175 For additional examples and configuration procedures, refer to the Fabric OS Encryption Administrator's Guide. 166 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 197
-scp enc1_cpcert.pem 192.168.38.245 mylogin /temp/certs/enc_switch1_cpcert.pem Password: To register a member node with the group leader: SecurityAdmin:switch>cryptocfg --reg -membernode 10:00:00:05:1e:39:14:00 enc_switch1_cert.pem 10.32.244.60 Operation succeeded. Fabric OS Command Reference - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 198
the selected file. ARE YOU SURE (yes, y, no, n): [no] y To display local encryption engine information for a Brocade FS8-18 encryption blade on a DCX: SecurityAdmin:switch> cryptocfg --show -localEE EE Slot: 7 SP state: Online Primary Link KeyID: 72:21:1a:32:b7:b0:95:e2:d4:50:db:b9:86:2d: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 199
Master key generated. The master key should be exported before further operations are performed. To export the master key to the RKM key vault: SecurityAdmin:switch>cryptocfg --exportmasterkey Enter the passphrase: passphrase Master key exported. Key ID: 8f:88:45:32:8e:bf:eb:44:c4:bc:aa:2a:c1:69 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 200
7e IP address 10.32.50.141 10.32.50.152 Role GroupLeader MemberNode (current node) To display the encryption group member information: SecurityAdmin:switch>cryptocfg --show -groupmember -all NODE LIST Total Number of defined nodes:2 Group Leader Node Name: 10:00:00:05:1e:41:9a:7e Encryption - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 201
:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00 C. Group-wide policy configuration To set the failback mode to manual failback: SecurityAdmin:switch> cryptocfg --set -failbackmode manual Set failback policy status: Operation Succeeded. To set the heartbeat miss value to 3: SecurityAdmin - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 202
cluster name: HAC2 - 1 EE entry Status: Defined WWN Slot Number 10:00:00:05:1e:39:53:67 0 Status Online To initiate a manual failback of an encryption engine: SecurityAdmin:switch> cryptocfg --failback -EE 10:00:00:05:1e:39:53:67 0 22:00:00:04:cf:6e:57:62 Operation Succeeded 172 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 203
Create a disk CryptoTarget container to be hosted on the encryption engine. FabricAdmin:switch>cryptocfg --create -container disk my_disk_tgt1 0:00:00:05:1e:41:9a:7e to the CryptoTarget container and commit the transaction. FabricAdmin:switch>cryptocfg --add -initiator my_disk_tgt 10:00:00:00:c9 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 204
the LUNs seen by the initiators in the CryptoTarget container. FabricAdmin:switch>cryptocfg --discoverLUN my_disk_tgt Container name: my_disk_tgt Number of LUN(s): c6:4f 6. Add a LUN to the CTC with encryption enabled. FabricAdmin:switch>cryptocfg --add -LUN my_disk_tgt 0 10:00:00:00:c9:2b:c9: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 205
19:72:89:c6:4f Sun Jun 1 20:21:32 2008 9. Display Crypto LUN configuration. FabricAdmin:switch>cryptocfg --show -LUN my_disk_tgt 0 10:00:00:00:c9:2b:c9:3a -cfg EE node: , VT, VI and target, VI, VT. FabricAdmin:switch>cfgshow Defined configuration: cfg: itcfg itzone cfg: r_e_d_i_r_c__fg - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 206
:28 20:0a:00:05:1e:53:8a:24 20:0b:00:05:1e:53:8a:24 1 To display all configured tape pools: FabricAdmin:switch> cryptocfg --show -tapepool -all Tape pool label: Key life: Encryption mode: Encryption format: Configuration status: tpool.00001 0 (minute) encrypt native committed(2) Tape pool label - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 207
container configuration information For a disk LUN with re-keying enabled: FabricAdmin:switch>cryptocfg --show -LUN my_disk_tgt 0x0 10:00:00:db:69:78:93 display all tape sessions in progress on the local node: FabricAdmin:switch>cryptocfg --show -tape_sessions -all Number of tape session(s): 2 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 208
2 cryptoCfg See Also Tape session number: 0 Number of uncompressed blocks: Number of compressed blocks: Number of uncompressed bytes: Number of compressed bytes: LUN number: 0x1 Tape session number: 1 Number of uncompressed blocks: Number of compressed blocks: Number of uncompressed - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 209
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for display sample data streams you can use with diagnostics: switch:admin> datatypeshow Pattern type example BYTE_FILL WORD_FILL QUAD_FILL - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 210
its local time. Refer to tsTimeZone for more information on time zone support. If the switch is operating in FICON Management Server mode (fmsmode), setting the date or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 211
date 2 Examples See Also To display the current date and time and then modify it: switch:admin> date Fri Jan 29 17:01:48 UTC 2007 switch:admin> date "0227123007" Thu Feb 27 12:30:00 UTC 2007 errShow, ficonCupSet, ficonCupShow, portLogShow, tsClockServer, tsTimeZone, upTime Fabric OS Command - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 212
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" This operand is optional. Examples To display information about a specific module named NS: switch:admin> dbgshow NS Module NS, debug level = 1, verbose - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 213
controls device access when zoning is not enabled. When a user-specified zoning configuration is not enabled, Default Zone is in effect, allowing primary FCS switch. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 214
2 defZone Examples See Also --allaccess Sets the default zone access mode to All Access, initiates a zoning transaction (if one is not already in progress), and deletes the reserved zoning objects by performing the equivalent to the following zoning commands: cfgDelete "d_efault_Cfg" zoneDelete " - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 215
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" flags. Examples To clear the diag software flag: switch:admin> diagclearerror 8 ERROR: DIAG CLEARERR Diagnostics Errors Cleared, port: 8/31 Err# 0120041 081F - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 216
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To disable the POST: switch:admin> diagdisablepost Config update Succeeded Diagnostic POST is now disabled. See Also - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 217
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To enable the POST: switch:admin> diagenablepost Config update Succeeded Diagnostic POST is now enabled. See Also - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 218
of the underlying hardware and are intended for support personnel only. Contact support if you want to use these operands. Note chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display diagnostic command information: switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 219
POST mode modifies the behavior of the diagnostics daemon program to inhibit testing of switch blades when the system is first powered on or a new blade is Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 220
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command switch:admin> diagretry -show Diagnostic Retry Mode is currently enabled. switch:admin> diagretry 0 Config update Succeeded Diagnostic Retry Mode is now disabled. switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 221
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" otherwise, the user ports specified in -uports displays. The default value is 0. Examples To display diagnostic status on a switch blade: switch:admin> diagshow - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 222
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" This operand is optional. Examples To display information about a specific module named NS: switch:admin> dbgshow NS Module NS, debug level = 1, verbose - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 223
-v5.3,0 switches, the command generates an error for security policies such as FCS, AUTH and IPFILTER, because these policies are not supported prior to Fabric OS v.5.3.0. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 224
database to all domains in the fabric that support the distribute feature: switch:admin> distribute -p "FCS;PWD" -d "*" To distribute the AUTH and FCS policies to all switches in the fabric that run Fabric OS v5.3.0 or later: switch:admin> distribute -p "AUTH;FCS" -d "*" To distribute the AUTH - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 225
is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. DLS is not supported in certain routing policies. Refer to aptPolicy for more information on routing policies. Operands - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 226
change occurs. Routing is based on the incoming port not supported in certain routing policies. If supported, the chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To enable the dynamic load sharing option: switch:admin> dlsset switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 227
to dlsSet for a description of load sharing. Notes DLS is not supported in certain routing policies. Refer to aptPolicy for more information on routing Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 228
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To set the DNS parameters for the system: switch:admin> dnsconfig Enter option 1 Display Domain Name Service (DNS) configuration 2 Set DNS configuration - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 229
of the enclosure interface to which the switch is attached. This command applies to products that are embedded in a blade server or storage chassis. Most options are platform-specific. Options that do not apply to a platform are identified with a "Not supported on this platform" message. Note The - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 230
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To clear the error log messages: switch:admin> errclear See Also errDump, errShow 200 Fabric OS Command Reference - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 231
Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command end delimiters (with sample output): switch:admin> errdelimiterset -s "Start" -e "End" Start2003/03/10-09:54:03, [NS-1002], 1035,, ERROR, SWITCH43, Name Server received an - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 232
values include INFO, WARNING, ERROR, and CRITICAL. Switch name Switch name for the generator of chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operands: -a Displays messages for the entire chassis for a user - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 233
errDump 2 See Also 2008/08/25-10:13:41, [ZONE-1022], 9037, CHASSIS, INFO, Spir_67, The effective configuration has changed to meh. 2008/08/25-11:35:04, [FABR-1001], 9041, CHASSIS, WARNING, Spir_67, port 0, incompatible Long distance mode. 2008/08/25-11:39:35, [LOG-1000], 9043, CHASSIS, INFO, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 234
level of the message to pass through the filter. Valid values are INFO, WARNING, ERROR, or CRITICAL. Input values are not case-sensitive. Examples To display the current filter settings: switch:admin> errfilterset console: filter severity = WARNING See Also To set the filter severity level - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 235
Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display a list of all defined error log modules: switch:user> errmoduleshow Module IDs: 1 KT 2 UT 5 LOG 6 CDR 9 PIXE 10 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 236
values include INFO, WARNING, ERROR, and CRITICAL. Switch name Switch name for the generator of chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operands: -a Displays messages for the entire chassis for a user - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 237
errShow 2 See Also 2008/08/25-10:13:41, [ZONE-1022], 9037, CHASSIS, INFO, Spir_67, The effective configuration has changed to meh. [Type to continue, Q to stop: 2008/08/25-11:35:04, [FABR-1001], 9041, CHASSIS, WARNING, Spir_67, port 0, incompatible Long distance mode. [Type to - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 238
exit command is an accepted synonym for logout, as is typing Ctrl-D at the beginning of a line. Operands none Examples To exit from a shell session: switch:admin> exit Connection to host lost. See Also logout 208 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 239
fabPortShow 2 fabPortShow Synopsis Description Displays fabric port information. fabportshow [slotnumber/]portnumber 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 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 240
state. red_ports All E_Ports that are connected to the same neighboring switch Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 241
Examples See Also To display fabric port information: switch:admin> fabportshow 4/14 Fabric Port Information Port: State: List: List Count: Flags: nbrWWN: nbrPort: lr_tid: red_ports: 10 11 62 63 62 P3 0x10068418 0 0x280120 10: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 242
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the retry count of Fabric OS commands: switch:user> fabretryshow SW_ILS E_Port ELP EFP HA_EFP DIA RDI BF FWD - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 243
fabricLog 2 fabricLog Displays (all users) or manipulates (admin) the fabric that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix Displays the command usage. Examples To display the fabric log: switch:admin> fabriclog -s Time Stamp Input and *Action S, P Sn,Pn - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 244
I4 F2,P0 8 NA F2,P0 F2,P0 8 NA F2,NA F2,NA NA NA switch:admin> fabriclog -r 64 Warning: This command will clear the logs. Are your sure you y To display the cleared fabric log after the size was changed: See Also switch:admin> fabriclog -s Time Stamp Input and *Action S, P Sn,Pn Port Xid - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 245
--disable fabricprincipal [-f] mode Description Use this command to set principal switch selection mode for a switch and to set priorities for principal switch selection. The implementation of the fabricPrincipal command is based solely on mechanisms specified in the Fibre Channel standards. These - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 246
. Mode changes take effect when the fabric rebuilds. This operand is optional. Examples To enable a high fabric principle priority setting: switch:admin> fabricprincipal --enable -p 0xff -f Principal Selection Mode enabled (Activate in next fabric rebuild) To disable the principal mode selection - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 247
switch is not an FC Router or it the FC Router does not support it. Chassis WWN The world wide name of the chassis. Chassis Name The name of the chassis. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 248
"sw60" 67: fffc43 10:00:00:60:69:10:60:1f 192.168.64.187 0.0.0.0 "sw187" The Fabric has 4 switches To show a mixed fabric with IPv4 and IPv6-configured switches: sw5:admin> fabricShow Switch ID Worldwide Name Enet IP Addr FC IP Addr Name 1: fffc41 10:00:00:60:69:00:02:0b - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 249
is displayed: • Number of times a switch domain ID has been forcibly changed • Number - Security incompatibility - Security violation - ECP error - Duplicate WWN - E_Port isolated Note The execution restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 250
2 fabStatsShow Sec Incompatibility: 0 Sec Violation: 0 ECP Error: 0 Duplicate WWN: 0 Eport Isolated: 0 See Also fabRetryShow 220 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 251
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display fabric switch state structure: switch:admin> fabswitchshow Fabric Switch State Structure Information State: D0 Stage: warm - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 252
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for of the fan unit to disable. Examples To disable a fan unit: switch:admin> fandisable 1 Fan unit 1 has been disabled See Also fanEnable, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 253
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for the fan unit number to enable. Examples To enable a fan unit: switch:admin> fanenable 1 Fan unit 1 has been enabled See Also fanDisable - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 254
fan speed is displayed. The output from this command varies depending on switch type and number of fans present. Note This command is not available on Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 255
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for Processor without executing power-on self test (POST) on startup: switch:admin> fastboot See Also diagDisablePost, diagEnablePost, reboot Fabric OS - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 256
, use portcfg --fastwritecfg to enable or disable FC Fastwrite on the individual ports. Notes This command requires a High-Performance Extension over FCIP/FC license This command is supported only on the Brocade 7500 and on modular platforms with one or more Brocade FC-IP/FC Router blades (FR4-18i - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 257
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. Continue (Y,y,N,n): [ n] portCfg - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 258
to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is supported only All GbE ports Examples To run all tests on slot 7 and GbE port 1: switch:admin> fcipchiptest --slot 7 -unit 1 -testtype 0 Running fcipchiptest Test Complete: fcipchiptest - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 259
Diagnostics When a failure is detected, the test might report one or more of the following error messages: CHIP_TEST_ERR CHIP_TEST_CHIP_INIT_ERR CHIP_TEST_IMAGE_VER_ERR CHIP_TEST_TIMEOUT_ERR CHIP_TEST_HEARBEAT_ERR CHIP_TEST_INVALID_RESULT See Also fcipPathTest Fabric OS Command Reference 229 53 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 260
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" Operands none Examples To display FCIP command help information: switch:admin> fciphelp fastwritecfg portcfg portcmd portshow Configure FC fastwrite - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 261
command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is supported only on the Brocade 7500/FR4-18i), and on the Brocade 7800/FX8-24 platforms only with - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 262
is used. This setting is applicable only to path mode 1 and 2. To run the test on slot 2 with PHY loopback sending 10 frames: switch:admin> fcippathtest --slot 2 -path 2 -nframes 10 Running fcippathtest Test Complete: fcippathtest Pass 10 of 10 Duration 0 hr, 1 min & 50 sec (0:1:50:942). passed - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 263
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command node WWNs which is used for any LUN query from this switch. Examples To display the LUN information: switch:user> fclunquery Target Index: 1 Target Node WWN: 50:05: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 264
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability the port number. There are 24 configurable embedded FCoE ports on the Brocade 8000 switch, and the valid range for port is 8 to 31. On the Brocade FCoE10 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 265
port number. -device wwn Specifies the device WWN. Examples To Display the FCoE ports on the Brocade 8000: switch:admin> switchshow switchName: elara133 switchType: 76.6 switchState: Online switchMode: Native switchRole: Subordinate switchDomain: 133 switchId: fffc85 switchWwn: 10 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 266
VN-Port(s) 1 VN-Port(s) 1 VN-Port(s) 1 VN-Port(s) 1 VN-Port(s) To display information about devices logged into a specific FCoE port on the Brocade 8000: switch:admin> fcoe --loginshow 31 Number of connected devices: 1 Peer Type Connect Info Device WWN Device MAC FCOE_DEVICE Direct - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 267
logged into FCoE port 0/2 on the Brocade FCoE10-24: switch:admin> fcoe --loginshow 2/0 Number of connected devices: 1 7b:34:e0 Te 2/0 To display the configuration for FCoE port 2/0 on the Brocade FCoE10-24: switch:admin> fcoe --logincfg 2/0 Slot: 2, Port: 0, Status: Enabled, Port WWN: 20:40:00: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 268
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details conflicting login groups and login groups for non-existing switches. --save Saves and applies FCoE login configuration changes as - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 269
WWN 10:00:00:05:1e:76:5c:80 Login group login_def_allowall(active) To display the current FCoE login configuration for the switch only: switch:admin> fcoelogincfg --show -switch 10:00:00:05:1e:76:5c:80 No ongoing transaction Effective Configuration Logingroup name : login_def_allowall(active - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 270
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" xx.xx.xx.xx.xx.xx. Only specified members are allowed to log into the switch. --delete lgname Deletes a login group. Specifies the name of the login group. - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 271
in hex format as xx.xx.xx.xx.xx.xx.xx.x. Only specified members are allowed to log into the switch. Renames the specified login group. Examples To create a login group: switch:admin>fcoelogingroup --create mylg -self "12:23:34:45:56:67:78:89" To add a VN_Port device to the login - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 272
Sends a Fibre Channel Extended Link Service (ELS) Echo request to a switch WWN, a domain ID, or a switch domain controller ID. No zoning check is performed when a single device is probed. The ELS Echo may not be supported that may be in place. Refer to chapter 1, "Using Fabric OS commands" and - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 273
the request frame payload sent. This is useful for diagnosing data-dependent problems in the fabric link. The pattern bytes are specified as hexadecimal accepts the request and another device that does not respond to the request: switch:admin> fcping 0x020800 22:00:00:04:cf:75:63:85 Source: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 274
0 frames rejected, 5 frames timeout Round-trip min/avg/max = 0/0/0 usec To use fcPing with a single destination (in this example, the destination is a switch WWN): switch:admin> fabricshow Switch ID Worldwide Name Enet IP Addr FC IP Addr Name 6: fffc06 10:00:00:05:1e:34:2b:66 10.202.90.201 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 275
fcPing 2 See Also switch:admin> fcping 20:00:00:00:c9:3f:7c:b8 Destination: 20:00:00:00:c9:3f:7c:b8 Pinging 20:00:00:00:c9: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 276
daemon (FCPD). Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To clear the FCPD debug information log - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 277
daemon (FCPD). Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To disable the FCPD debug information log - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 278
by default. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To enable the FCPD debug information log - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 279
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability for details. Operands none Examples To display the FCPD debug information log: switch:admin> fcplogshow Time Stamp Event Port file&lineno arg0 arg1 arg2 arg3 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 280
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for . This operand is required. Examples To display the FCP probe information: switch:admin> fcpprobeshow 4/4 port 52 is L-Port and it is online. nodes - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 281
this command to gather and display F_Port error statistics, you must enable the following two may be in place. Refer to chapter 1, "Using Fabric OS commands" and This operand is required. Examples To display the FCP RLS information: switch:admin> fcprlsshow 2/5 0xda 0xdc link fail 0 0 loss sync - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 282
. Use the --show option to display the current settings on the switch. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 283
See Also To display the new configuration: switch:admin> fcrbcastconfig --show Broadcast configuration is enabled for FID: 2 128 bcastshow, portRouteShow fcrBcastConfig 2 Fabric OS Command Reference 253 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 284
is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is supported only on Brocade FR4-18i blades and Brocade 7500 platforms. Operands This command has the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 285
fcrChipTest 2 Examples To run all tests on slot 7 and FC Router FPGA 1: switch:admin> fcrchiptest --slot 7 -unit 1 -testtype 0 Running fcrchiptest Test Complete: fcrchiptest Pass 1 of 1 Duration 0 hr, 0 min & 4 sec (0:0:4:351). passed. Diagnostics See Also When a failure is detected, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 286
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" fabric is the fabric attached to the U_Ports-for example, E/F_Ports-of this switch. The backbone fabric ID must be unique across all FC Router-connected fabrics - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 287
configuration: • If the EX_Port is Online, the command displays the FID, the EX_Port to which it is assigned, the E_Port, the port WWN and the switch WWN. • If the EX_Port is offline, the command displays the FID, the EX_Port to which it is assigned, and an "OFFLINE" message. • IF no EX_Ports - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 288
2 fcrEdgeshow See Also To display a FID for which no EX_Ports are configured: switch:admin> fcredgeshow -fid 29 No EX-ports with FID 29 fcrPhyDevShow, fcrProxyDevShow, fcrRouteShow, lsanZoneShow, switchShow, fcrfabricshow 258 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 289
backbone fabric. The existing syntax is maintained for IPv6 support. When IPv6 addresses are not configured, the output of chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the FC Routers in the backbone fabric: switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 290
1, Info: 10.32.66.210, 210::10:32:66:210 "Neptune210" EX_Port FID Neighbor Switch Info (enet IP, WWN, name) 17 76 10.20.30.176 10:00:00:05:1e 2, Info: 10.32.66.220, 220::10:32:66:220 "sw220n" EX_Port FID Neighbor Switch Info (enet IP, WWN, name) 16 80 10.32.66.180 10:00:00:05:1e - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 291
optimizes an FC router's behavior based on a specified subset of LSANS switch is online. • You must change the LSAN name in the edge fabric or the backbone fabric and propagate the LSAN to the FCR. Note that enforce tags are not supported be in place. Refer to chapter 1, "Using Fabric OS Commands" - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 292
FCR LSAN tag database. Examples To add an LSAN enforcement tag named "brocade": switch:admin> switchdisable switch:admin> fcrlsan --add -enforce brocade LSAN tag set successfully To add a speed tag named "mcdt": switch:admin> fcrlsan --add -speed mcdt LSAN tag set successfully To remove the LSAN - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 293
switches throughout the meta-SAN, the device import or export will not be identical on the FCRs. You should therefore enter the same maximum LSAN count for all the FCR switches in the same backbone that support that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 294
For FC Routers running Fabric OS versions prior to 6.1.0, the best practice is, therefore, to enter the same information for all the FCR switches in the backbone that support this command. This command is also used to specify FC Router pairs that can talk to each other. All edge fabrics connected to - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 295
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for if there is no effect on the existing import/export devices. Otherwise, an error message is displayed. --cancel -lsan | -fcr Cancels the data that was - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 296
Matrix: 1 2 8 To display all proxy devices for all FC Routers in the same backbone fabric whether or not they are relevant to this FC Router: switch:admin > fcrproxydevshow -a Proxy WWN Created in Fabric Proxy PID Device Physical Exists PID in Fabric State 52 10:00:00:06:2b:0e:4d:e5 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 297
not join the backbone fabric. Make sure that all legacy FCR switches in the backbone support the matrix merge feature, otherwise the feature is not supported. • Use fcrlsanmatrix --fabricview -lsan | -fcr to confirm that all the switches in the backbone have the same LSAN and FCR binding matrix. If - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 298
. - Disable the conflicting devices. Error message (2): "There may be other FCR switches in the backbone that do not support the LSAN Binding feature or do switches to confirm that the shared edge fabric FIDs have the same access in both backbones. Refer to the Fabric OS Message Reference manual - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 299
of the FC Router FPGA port N. 4. Pick up the frame from the same port N. 5. Check if any of the eight statistic error counters are nonzero: - ENC_in - CRC_err - TruncFrm - FrmTooLong - BadEOF - Enc_out - BadOrdSet - DropRxUnavail 6. Check if the transmit, receive, or Class 3 receiver counters are - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 300
chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is supported only on Brocade FR4-18i blades and Brocade 7500 platforms. The switch One of the ASIC internal counters detected a frame statistics error in the received frame. A cable, media, or ASIC - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 301
the Tx/Rx frame count statistics. The DIAG-STATS error can be caused by a faulty SFP or indicate deeper problems in the main board or ASIC. Check for a that was sent out. This can be caused by a faulty SFP or indicate deeper problems in the main board or ASIC. Check for a faulty SFP. Replace the SFP - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 302
listed by fabric. The -f and -w operands allow searching for physical devices based on fabric ID or port world wide name. "No device found" is Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 303
fcrPhyDevShow 2 Examples See Also To display the physical devices relevant to this FC Router: fcr:admin> fcrphydevshow Device WWN Physical Exists PID in Fabric 2 10:00:00:00:c9:2b:6a:68 c70000 3 50:05:07:65:05:84:09:0e 0100ef 3 50:05:07:65:05:84:0b:83 0100e8 Total devices displayed - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 304
Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operands: -s importedFID devWWN slot Adds - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 305
for the specified edge fabric. Examples To display the persistent proxy device configuration: switch:admin> fcrproxyconfig Imported FID 002 002 002 002 003 Device WWN 50:05: 00:11:22:33:44:55:66:77 to use slot f101h in fabric 5: switch:admin> fcrproxyconfig -s 5 00:11:22:33:44:55:66:77 f101 See - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 306
are listed by fabric. Search parameters -f and -w allow searching for proxy devices based on fabric ID or port WWN. "No proxy device found" is displayed if Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 307
are relevant to this FC Router. Displays proxy devices with the specified port WWN. Examples To display the physical devices relevant to this FC Router: switch:admin> fcrphydevshow Device WWN Physical Exists PID in Fabric 2 10:00:00:00:c9:2b:6a:68 c70000 3 50:05:07:65:05:84:09 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 308
WWNs are not returned to the pool until the system reboots, because the phantom switch might still be accessible through other switches. Across the switch reboot, the allocation starts from the next usable WWN base from the pool and not from the beginning. Port Limits Displays resources for each - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 309
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for Examples To display the resource usage for the local FC Router: switch:admin> fcrresourceshow Daemon Limits: LSAN Zones: LSAN Devices: Proxy - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 310
the default value based on link type (EX/VEX). The router module chooses the router port path based on the minimum the current link costs for all ports on the switch. Notes Before setting the cost, ensure that admin that may be in place. Refer to chapter 1, "Using Fabric OS commands" and - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 311
fcrrouterportcost 7/10 Port Cost 7/10 10000 To set the default cost on the EX_Port: See Also switch:admin> fcrrouterportcost 7/10 0 switch:admin> fcrrouterportcost 7/10 Port Cost 7/10 1000 switchShow, fcrRouteShow, portCfgEXPort fcrRouterPortCost 2 Fabric OS Command Reference - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 312
imported fabrics, creating a meta-SAN. There are FC Router ports intermediate fabrics are currently not supported, an NR_Port provides a chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the route information: switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 313
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" be issued on the switches to which the edge fabrics are directly attached. In a Virtual Fabric environment, this is the base switch. Fabric OS Command - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 314
When persistxd is enabled, the translate domain is created based on the persistent translate domain ID configuration. If a the translate domain configuration and the state of the persistxd parameter: switch:admin> fcrxlateconfig ImportedFid ExportedFid Domain 001 002 004 001 005 003 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 315
To set the preferred domain ID of the translate domain created in fabric 2, which represents the 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, which - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 316
policy is possible in mixed fabrics. However, switches that do not support the policies ignore them. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 317
Server (FCS). All members specified in a given policy set are automatically distributed to all participating switches in the fabric that support the policy. Refer to the DESCRIPTION section for specific exceptions. In the presence of a fabric-wide FCS consistency policy, this command can only be - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 318
unsupported, or error. The revision of the switch also displays, followed by the world wide name of the switch. For HBAs chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the FDMI cache: switch:admin> fdmicacheshow Switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 319
chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display FDMI information on a local switch: switch LP9000 1 Gigabit PCI Fibre Channel Adapter Hardware Version: 00000001 Driver Version: SLI-2 SW_DATE:May 3 2002, v5-2.11a2 **CT_TEST - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 320
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for database: switch:user> ficonclear RLIR successfully clear local RLIR Database. See Also To clear the RNID database: switch:user> ficonclear RNID - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 321
restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, the FICON Management Server (FMS) mode for the switch. modereg bitname 0|1 Set a bit in the FICON are POSC Programmed offline state control UAM User alert mode ASMA Active=saved mode DCAM Director - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 322
2 ficonCupSet To set the ASM bit in the mode register for the switch: switch:admin> ficoncupset modereg ASM 1 Active=Saved Mode bit is set to 1 See Also To set the MIHPTO value to 60 seconds: switch:admin> ficoncupset MIHPTO 60 MIHPTO has been changed to 60 seconds ficonCupShow 292 Fabric OS - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 323
Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command mode for the switch: switch:user> ficoncupshow fmsmode fmsmode for the switch: Enabled To display the mode register for the switch: switch:user> ficoncupshow modereg - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 324
2 ficonCupShow To display the ASM bit in the mode register for the switch: switch:user> ficoncupshow modereg ASM ASM --1 See Also To display the MIHPTO value for the CUP: switch:user> ficoncupshow MIHPTO MIHPTO for the CUP: 60 seconds ficoncupset 294 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 325
support commands with descriptions. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter FICON-CUP parameters for a switch ficoncupshow Displays FICON-CUP parameters for a switch ficonhelp N/A ficonshow Displays - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 326
the command displays the members of the named database that are local to the switch on which the command was issued. If the fabric operand is present, it current. 0x40 Indicates the node ID of the storage port for the RNID switch for RLIR is not valid. 0x50 Indicates the node ID of the channel - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 327
increases by 1 for each incident within the individual switch. Link Incident Description Same as Link Incident Type. type as one of the following: • Bit-error-rate threshold exceeded • Loss of signal or FC-4 support not specified. 0xa0 Reserved. 0xc0 Reserved. Fabric OS Command Reference - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 328
2 ficonShow 0xe0 Vendor-specific. Byte BB 0x00 Unspecified class. 0x01 Direct access storage device mode if it is a storage port; otherwise, an emulated control unit support only. 0x09 Reserved. 0x10 Switch, if it is a switch device; otherwise, reserved. 0x0b-0xff Reserved. Byte CC 0x00 If - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 329
Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command of the named database are displayed. Examples To display the local RNID database: switch:admin> ficonshow RNID { {Fmt Type PID Registered Port WWN Registered Node WWN - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 330
number: 48K Manufacturer: BRD Plant of Manufacture: CA Sequence Number: 0RB030000082 tag: 00ff } } The Local switch RNID database has 1 entries. To display the local RLIR database: switch:user> ficonshow RLIR { {Fmt Type PID Port Incident Count TS Format Time Stamp 0x18 N 502e00 46 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 331
: 0FT02X801E4E Domain: 20480 } } The local RLIR database has 1 entry. Flag 0x00 Node Parameters 0x200a2e See Also To display the local ILIR database: switch:user> ficonshow ILIR { {FRU Failure [2]: Power Supply[2] failure occurred on Mon Jan 13 12:11:38 2003 Fmt Protocol Domain Fabric WWN - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 332
tests are executed when the switch is powered on to check for the consistency of the algorithms implemented on the switch. Notes Certain services and functions, such as . FIPS is not supported on all platforms. For FIPS-compliant hardware, refer to the Fabric OS Administrator's Guide. In a Virtual - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 333
admin> fipscfg --enable selftests FIPS Selftests mode/status has been set to : Enabled/None To verify FIPS prerequisites: switch:admin>fipscfg --verify fips Standby firmware supports FIPS SELF tests check has passed Root account is enabled. Radius check has passed Authentication check has passed - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 334
2 fipsCfg See Also To enable FIPS after prerequisites have been met: switch:admin> fipscfg --enable fips FIPS mode has been set to : Enabled Please reboot the system switch:admin> fipscfg --show FIPS mode is : Enabled none 304 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 335
firmwareDownload completes successfully and the CP is rebooted, the system switches the primary partition (with the old firmware) to the Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 336
ftp | scp ] [ -c ] [ -o ] host, user, pfile, passwd To download SAS firmware over a network and remove Switch firmware can also be downloaded from an external USB device on platforms that support disruption to application services. This operation depends on High Availability (HA) support. If HA is - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 337
may be in place. Refer to chapter 1, "Using Fabric OS commands" that support a USB port. Refer to your specific Hardware Reference Guide manually to activate the downloaded image. If auto reboot mode is enabled, the switch or IPv6 should be used. user Specify a user name for FTP or SSH server - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 338
firmwareDownload to continue even if HCL is not supported in the fabric or the protocol fails. Using this option may cause traffic disruption for some switches in the fabric. Examples To download the firmware to an HA switch over a network: switch:admin> firmwaredownload 192.168.166.30,johndoe - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 339
same command on a single-CP switch with USB support. Output may vary depending on platform.): switch:admin> firmwaredownload -U v6.2.0 Checking : 192.168.32.10 Network Protocol (1-auto-select, 2-FTP, 3-SCP) [1]: User Name: userfoo File Name: /home/userfoo/dist/release.plist Password: To download SAS - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 340
to enable the USB device. • The switch is a single-CP switch in an interop fabric and does not support Coordinated HotCode Load. For other return codes, refer to the Fabric OS Error Message Reference Manual. firmwareCommit, firmwareDownloadStatus, firmwareKeyShow, firmwareKeyUpdate, firmwareRestore - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 341
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for of the firmwaredownload for an SAS image to the blades in slot 2 and 7. switch:admin> firmwaredownloadstatus [1]: Thu Jul 28 00:30:49 2007 Slot 2 (SAS): - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 342
15 22:20:54 2007 Firmware has been downloaded to the secondary partition of the switch. [3]: Fri Feb 15 22:22:19 2007 The firmware commit operation has started This may take up to 10 minutes. [4]: Fri Feb 15 22:22:51 2007 Switch is relocating an internal firmware image. [5]: Fri Feb 15 22:25:15 2007 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 343
firmwareDownloadStatus 2 See Also 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 2007 Slot 8 (FR4-18i): The commit operation has completed successfully. [11]: Mon Dec 19 18:55:39 2007 Slot 5 (CP0, active): Firmware has been - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 344
Notes A firmware key should be installed on every switch as a part of the Fabric OS installation. . Refer to the Fabric OS Administrator's Guide for complete details on upgrading or downgrading firmware restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 345
user,keyfile,passwd firmwarekeyupdate -U keyfile Description Use this command to update the public key used for firmware signature validation. The firmware key can be updated over the network, or, if the switch supports to the Fabric OS Administrator's Guide for complete details on upgrading or - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 346
public key, please wait... Public key successfully updated. To update the public key using the interactive method: switch:admin> firmwarekeyupdate Server Name or IP Address: 192.168.21.34 User Name: johndoe File Name: /pub/dist/pubkey.pem Network Protocol(1-auto-select, 2-FTP, 3-SCP) [1]: Password - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 347
is booted after a firmwareDownload; otherwise, it returns with an error code. Note The execution of this command is subject to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To restore the former active firmware image: switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 348
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" a Brocade director with FA4-18 blades installed in slot 2 and 7: switch:admin> firmwareshow Slot Name Appl Primary/Secondary Versions Status 2 FA4-16 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 349
isnscCfg) • Virtual Fabrics (see lfCfg) • Ethernet switching service Notes The features described may not be supported on all platforms. If you attempt to enable a feature that is not supported on your platform, an error message stating "Command not supported on this platform" is displayed. The - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 350
for confirmation, because the chassis reboots after this command is executed. Enables the Ethernet switch service on the switch. The Ethernet switch service is disabled by default. Enabling the Ethernet switch service does not disrupt the FC traffic. --disable feature fcr . iSCSI iSNSC vf ethsw - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 351
WARNING: This operation will enable the Ethernet Switch Service on this switch. Would you like to continue [Y/N]: y Enabling the Ethernet Switch Service. Please wait ... Create Ethernet switch instance 0 All service instances in sync. The Ethernet Switch Service has been enabled. Please enable all - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 352
Refer to chapter 1, " supported value, specifying the replacement of the WWN card. Examples To replace the world wide name card: switch Switch WWN Card Removal and Replacement document. Do you wish to continue [y/n]? y Backing up WWN card data, please wait about 25 seconds for further instruction - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 353
correspond to the default areas of the ports. Bit 0 refers to default area of the switch, bit 1 refers to default area 1, and so forth. Bit map of all the Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 354
2 fspfShow Examples See Also To display FSPF protocol information: switch:admin> fspfshow version = 2 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] = - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 355
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for enable alarms in Fabric Watch: switch:admin> fwalarmsfilterset FW: Alarms are already disabled switch:admin> fwalarmsfilterset 1 FW: Alarms - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 356
be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the status of alarm filtering in Fabric Watch: switch:user> fwalarmsfiltershow FW: Alarms are enabled switch:user> fwalarmsfiltershow FW: Alarms are - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 357
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for Operands none Examples To initialize all classes under Fabric Watch: switch:admin> fwclassinit fwClassInit: Fabric Watch is updating... fwClassInit: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 358
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for Examples To reload the saved Fabric Watch configuration: switch:admin> fwconfigreload fwConfigReload: Fabric Watch configuration reloaded See - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 359
operands, this command runs interactively. On switches running Fabric OS v6.1.0 or later, use to the Fabric Watch Administrator's Guide for information on how to enable : 1. The Port class does not support VE _Ports and VEX_Ports, except for State Signal loss Protocol error Invalid words Invalid CRCS - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 360
changes Zone changes FabricQL Fabric logins SFP state changes Link loss (E_Port) Sync loss (E_Port) Signal loss (E_Port) Protocol error (E_Port) Invalid words (E_Port) Invalid CRCS E_Port) RX Performance (E_Port) TX Performance (E_Port) State Changes (E/VE_Port) Utilization (VE_Port) Packet Loss - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 361
Current Voltage Link failure Sync loss Signal loss Protocol error Invalid words Invalid CRCs RX Performance TX Performance State be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Not all platforms support fans or power supplies. If - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 362
--disable --port portNumber Disables all thresholds associated with a certain port. Examples To configure thresholds in Fabric OS mode: switch:admin> fwconfigure 1 : Environment class 2 : SFP class 3 : Port class 4 : Fabric class 5 : E-Port class 6 : F/FL Port (Optical) class 7 : Alpa performance - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 363
fwConfigure 2 See Also Select a class => : (1..6) [6] 1 1 : Temperature 2 : Fan 3 : Power Supply 4 : return to previous page Select an area => : (1..4) [4] 1 Index ThresholdName Status CurVal LastEvent LasteventTime LastVal LastState 1 envTemp001 enabled 23 C inBetween Sat Oct7 10:01:53 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 364
unit (FRU) states and actions. Based on these configuration settings, Fabric Watch Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, Examples To change FRU state alert configuration: switch:admin> fwfrucfg The current FRU configuration: Alarm - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 365
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display a summary of Fabric Watch commands: switch:user> fwhelp fanshow fwalarmsfilterset fwalarmsfiltershow fwclassinit fwconfigreload fwconfigure - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 366
Watch email alert in the switch. Switch elements monitored by Fabric Watch are divided into classes, and email alerts are based on the classes. Each chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To configure email settings: switch: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 367
fwMailCfg 2 1 : Show Mail Configuration Information 2 : Disable Email Alert 3 : Enable Email Alert 4 : Send Test Mail 5 : Set Recipient Mail Address for Email Alert 6 : Relay Host IP Configuration 7 : Quit Select an item => : (1..7) [7]5 See Also Mail Config Menu 1 : Environment class 2 : SFP - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 368
Watch license. Port errors are not supported for virtual ports and SFP errors are not applicable chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operands: --p portNumber Yields a port detail report for a specific user - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 369
port detailed report for a switch configured with an IPv6 address: switch:user> fwportdetailshow Port Detail Report Switch Name: switch IP address: 1080::8:800:200C:417A Port Exception report [by All] Report time: 09/11/2006 05:51:15 PM --------Port-Errors SFP-Errors---Port# Type State Dur - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 370
See Also To retrieve a port detailed report: switch:user> fwportdetailshow --s h Port Detail Report Switch Name: switch IP address: 192.168.163.237 Port Exception report [by Healthy] Report time: 05/21/2007 11:22:58 PM --------Port-Errors SFP-Errors---- Port# Type State Dur(H:M) LFA LSY - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 371
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command requires a Fabric Watch license. Operands none Examples To generate a SAM report on an eighty-port switch: switch:user> fwsamshow Total Total Down Total Port - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 372
2 fwSamShow 30 U 0 0 0 100 31 U 0 0 0 100 32 U 0 0 0 100 33 U 0 0 0 100 34 U 0 0 0 100 35 U 0 0 0 100 36 U 0 0 0 100 37 U 0 0 0 100 38 U 0 0 0 100 39 U 0 0 0 100 40 T 99 0 0 0 41 T 99 0 0 0 42 T 100 0 0 0 43 T 99 0 0 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 373
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for To set the port persistence time to 18 seconds: switch:user> fwset --port --persistence 18 See Also fwShow Fabric OS Command Reference 343 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 374
factory default settings and user-defined custom settings. specific configuration procedures, refer to the Fabric Watch Administrator's Guide chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To set alarm levels to custom values: switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 375
1 1 1 Threshold boundary level is set at : Custom Unit Time base Low High BufSize Default C 0 60 10 Custom C 0 60 10 alarm 4 : change custom unit 14 : change above alarm 5 : change custom time base 15 : change inBetween alarm 6 : change custom low 16 : apply threshold alarm changes - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 376
2 fwSetToCustom See Also 8 : change custom buffer 18 : return to previous page 9 : apply threshold boundary changes 10 : cancel threshold boundary changes Select choice => : (1..18) [18] fwSetToDefault, fwConfigure, fwHelp, fwShow 346 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 377
switch from custom to default settings. If no user- specific configuration procedures, refer to the Fabric Watch Administrator's Guide. chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To return alarm levels to default values: switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 378
1 1 1 Threshold boundary level is set at : Default Unit Time base Low High BufSize Default C 0 60 10 Custom C 0 60 10 alarm 4 : change custom unit 14 : change above alarm 5 : change custom time base 15 : change inBetween alarm 6 : change custom low 16 : apply threshold alarm changes - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 379
fwSetToDefault 2 See Also 8 : change custom buffer 18 : return to previous page 9 : apply threshold boundary changes 10 : cancel threshold boundary changes Select choice => : (1..18) [18] fwSetToCustom, fwConfigure, fwHelp, fwShow Fabric OS Command Reference 349 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 380
Guide. In Access Gateway mode, only the following class thresholds are supported. F/FL Port (Copper) class threshold is supported may be in place. Refer to chapter 1, "Using Fabric OS commands" and display thresholds for a fan in the SFP class: switch:user> fwshow 1 : Show class thresholds 2 : Detail - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 381
Name Label Last value envFan001 Env Fan 1 2576 RPM envFan002 Env Fan 2 2518 RPM envFan003 Env Fan 3 2481 RPM switch:user> fwshow 1 : Show class thresholds 2 : Detail threshold information 3 : Show port persistence time 4 : Quit Select an item => : (1..4) [3] 2 Enter Threshold Name - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 382
> fwshow --port --persistence FW: current port persistence time = 18s To display ports that have all thresholds disabled: switch:user> fwShow --disable --port Port Threshold Status 1 disabled fwClassInit, fwConfigReload, fwConfigure, fwSet 352 Fabric OS Command Reference 53-1001337 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 383
commands typed into the shell; the oldest commands are replaced as new ones are entered. Operands none Examples To display previous shell commands: switch:admin> h 1 version 2 switchshow 3 portdisable 2 4 portenable 2 5 switchshow See Also none Fabric OS Command Reference 353 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 384
Use this command to disable the High Availability (HA) feature on a switch. If the HA feature is already disabled, this command does nothing. Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 385
errors. Failed The standby CP is running, but the background health diagnostic has discovered a problem IP and Fibre Channel addresses configured for the switch. • Additional internal HA state information, subject that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 386
2 haDump See Also SWITCH Ethernet IP Address: 10.32.227.64 Ethernet Subnetmask: 255.255.240.0 Fibre Channel IP Address: 220.220.220.64 Fibre Channel Subnetmask: 255.255. - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 387
Fabric or Admin Domain Restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To enable the High Availability feature: switch:admin> haenable Warning: This command will enable the HA. It will - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 388
traffic is continuing to flow. This command is supported only on dual-CP systems. The execution of restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, the active CP to the standby CP in the switch: switch:admin> hafailover Local CP (Slot 7, CP1): Active - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 389
errors. Failed The standby CP is running, but the background health diagnostic has discovered a problem failover is disruptive. Notes This command may not be supported on non-bladed systems. Slot numbers for CP1 and place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, " - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 390
PCI fail, severity: CRITICAL HA enabled, Heartbeat Up, HA State not in sync To display CP status on a Brocade DCX with a healthy standby CP: switch:admin> hashow Local CP (Slot 7, CP1) : Active, Cold Recovered Remote CP (Slot 6, CP0) : Standby, Healthy HA Enabled, Heartbeat Up, HA State Synchronized - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 391
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Examples To enable the HA state synchronization: switch:admin> hasyncstart See Also haFailover, haShow, haSyncStop Fabric OS Command Reference - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 392
to be disruptive. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To disable the HA state synchronizing process - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 393
user; command availability may vary depending on: • Login user role • License key • Hardware platform To access help information for a specific switch:admin> help -p aaaconfig ad ag agshow agtcfgdefault aliadd alicreate alidelete aliremove alishow aptpolicy auditcfg Configure RADIUS for AAA services - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 394
Display broadcast routing information bladedisable Disables all user ports on a blade. bladeenable Enables all User Ports on a blade. Type output with "grep": switch:admin> help | grep errshow errshow Print error log porterrshow Print port error summary switch:admin> See Also - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 395
these units. All other platforms that contain FRUs support 28 history log entries. Note The execution of that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix display the late FRU insertion or removal event: switch:admin> historylastshow POWER SUPPLY Unit 2 Inserted - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 396
, which records the insertion and removal of FRUs on a switch or chassis. This command supports two modes of handling new log entries once the history buffer or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 397
these units. All other platforms that contain FRUs support 28 history log entries. Note The execution of that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix of FRUs and removal events on a standalone switch: switch:admin> historyshow FAN Unit 3 Removed at - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 398
2 historyShow WWN Unit 1 Inserted at Tue Aug 14 11:03:45 2001 Factory Part Number: 40-0000031-03 Factory Serial Number: 1013456800 See Also SW BLADE Slot 3 Removed at Tue Aug 14 12:10:09 2001 Factory Part Number: 60-0001532-03 Factory Serial Number: 1013456800 CP BLADE Slot 6 Removed at - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 399
to display the version of the Java plug-in supported by Web Tools. This command also displays the URL restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, display the Java plug-in version: switch:admin> httpcfgshow Current HTTP configuration javaplugin - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 400
or about all processes running on the local switch. One line is displayed per process. system calls 040 forked but did not exec 100 used super-user privileges 200 dumped core 400 killed by a signal Process state codes may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 401
the following operand: processID Specifies the process name or process ID for the process to display. Examples To display information about process ID 433: switch:admin> i 433 F S UID PID PPID C PRI NI ADDR SZ WCHAN TTY TIME CMD 000 S 0 433 1 0 69 0 - 1283 5c64 ? 00:00:02 fabricd See Also - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 402
power cycles. This command is supported only on the Brocade DCX and may be in place. Refer to chapter 1, "Using Fabric OS commands" and switch:user> iclcfg --disable 8/1 To enable the ICL for ports 16-31: switch:user> iclcfg --enable 8/1 To disable the ICL for ports 16-31 persistently: switch:user - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 403
See also To enable the ICL for ports 16-31 persistently: switch:user> iclcfg --persistentdnable 8/1 none iclCfg 2 Fabric OS Command Reference 373 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 404
supports eth0 and eth3 as interface parameters. On all other platforms, only eth0 is supported. When selecting auto-negotiation, you can choose the specific Refer to chapter 1, " switch:admin> ifmodeset eth0 Exercise care when using this command. Forcing the link to an operating mode not supported - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 405
link for the eth0 interface from auto-negotiation to 10 Mbps half-duplex operation, when entering this command through the serial console port: switch:admin> ifmodeset eth0 Auto-negotiate (yes, y, no, n): [yes] n Force 100 Mbps / Full Duplex (yes, y, no, n): [no] n Force 100 Mbps / Half Duplex (yes - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 406
this command supports eth0 and eth3 as interface parameters. On all other platforms, only eth0 is supported. The CP be in place. Refer to chapter 1, "Using Fabric OS commands" the link operating mode for the eth0 Ethernet interface: switch:admin> ifmodeshow eth0 Link mode: negotiated 100baseTx-HD, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 407
See Also To display the active interface: ras010:root> ifmodeshow bond0 Currently Active Slave: eth0 ifModeSet ifModeShow 2 Fabric OS Command Reference 377 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 408
port becomes an E_Port. The neighbor data structure contains all the information relating to the switch that is connected to an adjacent switch. This command displays the content of both data structures, if they have been allocated. The following fields are displayed: idbP Pointer to IDB. nghbP - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 409
ID. inactTo Inactivity timeout value, in milliseconds. When this timeout expires, the adjacency with the neighbor switch is broken and new paths are computed to all possible destination switches in the fabric. helloTo Hello timeout value, in milliseconds. When this timeout expires, a Hello frame - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 410
switch. Number of LSAs transmitted to the neighbor switch. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter the switch (including non-E_Ports). Examples To display FSPF interface information: switch:user> - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 411
See Also delay = 1 lastScn = 16 &dbRetransList = 0x1008c6a0 &lsrRetransList = 0x1008c6c4 &lsrAckList = 0x1008c6e8 inactTID = 0x1008c768 helloTID = 0x1008c7a0 dbRtxTID = 0x1008c7d8 lsrRtxTID = 0x1008c848 inactTo = 80000 helloTo = 2000 rXmitTo = 5000 nCmdAcc = 7 nInvCmd = 0 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 412
mode. • McDATA Open Fabric Mode (IM3) - Brocade switches in IM3 are interoperable with McDATA switches in IM3. IM3 is supported on all platforms that support McDATA Fabric Mode (IM2). Open Fabric Mode is intended specifically for adding Fabric OS-based products into M-EOS fabrics that are already - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 413
Guide for more information. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter switch to Brocade Native mode (IM0). --enable Enables and configures the specified interop mode settings. The following operands are supported - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 414
--show InteropMode: McDATA Fabric ( IM2 ) Default Zone: Off Safe Zone: Off Domain Id offset: 0x20 To turn Safe Zone on while in IM2: switch:admin> interopmode --enable -safezone MCDT default/safe zone will be changed. Do you want to continue? (yes, y, no, n): [no] y InteropMode: McDATA Fabric ( IM2 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 415
Domain ID mode in IM3 to IM 2 (this command fails unless you change the domain offset as well to a value supported in IM2): switch:admin> interopmode --enable -mcdata The switch effective and defined configuration will be lost if interop Mode is changed. Interop Mode or Domain Offset Will Be Changed - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 416
user-defined IOD delay settings to default values (-1). This command resets IOD delay values for a specified domain ID that was previously configured with the iodDelaySet command. The switch restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions" and Appendix - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 417
restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions" and Appendix A, IOD delay setting for domain 5: switch:user> ioddelayshow 5 Domain - Iod Delay 5 - 20 To display IOD settings for all domains in the fabric: switch:user> ioddelayshow 5 Domain - Iod Delay - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 418
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To disable IOD enforcement: switch:admin> iodreset switch:admin> iodshow IOD is not set See Also iodSet, iodShow 388 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 419
for a specific LS. For example, assume a chassis is partitioned as follows: logical switch LS1 consists of ports 1/1-5, and logical switch LS2 consists implementation. Lossless DLS is supported only in FICON environments, and the switch must be configured with a port-based policy. Refer to aptPolicy - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 420
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" Use iodReset to disable IOD completely. --show Displays the IOD setting on the switch. This command displays the status of both, legacy IOD setting and IOD - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 421
Synopsis iodshow Description Use this command to display the IOD setting on the switch. By default, IOD is disabled. Note The execution of this command Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 422
to a logical switch IPFC network interface, and to configure a service port on the specific features of the command are outlined below. For complete details, refer to the Fabric OS Administrator Guide the implied entity is the single managed entity supported by the platform and must be left - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 423
, and Gateway IP address. Valid switch and CP numbers depend on the command prompts for a specification of whether the When DHCP is enabled, any user-configured Ethernet IP address, Ethernet be in place. Refer to chapter 1, "Using Fabric OS commands command line options are supported with the --add - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 424
name of CP1. -chassis Specifies the managed entity as the chassis. Examples Command line examples To configure an IPv6 address and prefix on a standalone platform: switch:admin> ipaddrset -ipv6 --add fec0:60:69bc:60:260:69ff:fed0:107/64 To configure an IPv6 address and prefix on a single CP of - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 425
:admin>ipaddrset -ls 123 --add 11.1.2.4/24 IP address is being changed...Done. To verify the IPv4 FC address for the logical switch: switch:admin> ipaddrshow CHASSIS Ethernet IP Address: 10.32.220.10 Ethernet Subnetmask: 255.255.240.0 CP0 Ethernet IP Address: 10.32.220.11 Ethernet Subnetmask: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 426
IP Address [192.168.166.148]: Ethernet Subnetmask [255.255.255.0]: Committing configuration...Done. To enable DHCP on a standalone, non-AP platform: switch:admin> ipaddrset Ethernet IP Address [192.168.74.102]: Ethernet Subnetmask [255.255.255.0]: Gateway IP Address [192.168.74.1]: DHCP [Off - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 427
For each CP: • Ethernet IP Address • Ethernet Subnet mask • Host Name • Gateway IP Address If the IPFC network interface is configured for logical switches: • IPFC address for Virtual Fabric ID For each CP: - Backplane IP address - IPv6 Auto configuration Enabled: Yes or No If enabled, the command - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 428
• deprecated Refer to the RFC 2462 specification for more information. On modular platforms restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix display the IP addresses on a standalone switch: switch:admin> ipaddrshow SWITCH Ethernet IP Address: 192.168.163. - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 429
:e45a/64 preferred chassis 0 stateless fec0:60:69bc:63:205:1eff:fe39:e45a/64 preferred IPv6 Gateways: To display only the IP addresses for CP 1: switch:admin> ipaddrshow CP1 Ethernet IP Address: 10.33.60.87 Ethernet Subnetmask: 255.255.240.0 Host Name: cp1 Gateway IP Address: 10.33.48.1 ipAddrSet - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 430
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for are treated as chassis-wide configurations and apply to all logical switches in the chassis. Chassis permissions are required to manage IP - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 431
ipfilter 2 case. The policy type identifies the policy as an IPv4 or IPv6 filter. You can create a maximum of eight IP filter policies. --create policyname -type ipv4 | ipv6 Creates an IP filter policy with the specified name and type. The policy created is stored in a temporary buffer and is lost - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 432
arguments are supported with the the destination port number, a range of port numbers, or a service name. Specifies the protocol type, for example tcp or udp. IP address, destination port, and protocol, and to permit the rule: switch:admin> ipfilter --addrule ex1 -sip fec0:60:69bc:60:260:69ff:fe80 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 433
:fe80:d4a tcp Dest Port Action 23 permit To activate the IP Filter policy "ex1": switch:admin> ipfilter --activate ex1 To display all IP Filter policies, including the activated policy: switch:admin> ipfilter --show Name: default_ipv4, Type: ipv4, State: active Rule Source IP Protocol Dest - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 434
admin> ipfilter --addrule ex2 -sip 10.32.69.99 -dp 23 -proto tcp -act permit To display the IP filter policies, including the new policy: switch:admin> ipfilter --show Name: default_ipv4, Type: ipv4, State: active Rule Source IP Protocol Dest Port Action 1 any tcp 22 permit 2 any tcp 23 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 435
(IPsec) feature for traffic flows on switch Ethernet management interfaces, or to display the through the use of cryptographic security services. IPSec uses different protocols to layer protocol header. The IPsec key management supports Internet Key Exchange (IKE) or Manual key/SA entry. • In IKE the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 436
chapter support protection of traffic flows on FCIP interfaces. This command does not support switch database. The MD5 hash algorithm is blocked when FIPS mode is enabled. Refer to the example section for specific use cases and associated command sequences. Refer to the Fabric OS Administrator's Guide - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 437
policy to be created. Supported policies include: Creates or modifies an IPsec policy. This policy determines the security services afforded to a packet are required: -tag name Specifies a name for the transform. This is a user-generated name. The name must be between 1 and 32 characters in length, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 438
(SA) proposal, including name, SAs to be included and lifetime of the proposal. The following operands are supported: -tag name Specifies a name for the SA proposal. This is a user-generated name. The name must be between 1 and 32 characters in length, and may include alphanumeric characters - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 439
SAs. You cannot modify an SA once it is created. Use ipsecConfig --flush manual-sa to remove all SA entries from the kernel SA database (SADB) and start over. -tag name Specifies a name for the SA. This is a user-generated name. The name must be between 1 and 32 characters in length, and - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 440
include: -tag name Specifies a name for the IKE policy. This is a user-generated name. The name must be between 1 and 32 characters in length, address and prefix. -id identifier Specifies the local identifier. The switch is identified by its IPv4 or IPv6 address. -remoteid identifier Specifies - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 441
for creating an SADB entry is as follows: ipsecconfig --add manual-sa arguments. arguments Valid arguments for manual-sa include: -spi number Specifies the security parameter index (SPI) for the SA. This is a user-defined index. Valid SPI numbers consist of numeric characters (0-9). -local - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 442
-key number Specifies the encryption key. This is a user-generated key based on the length of the key. Use the LINUX random key generator or any other comparable third party utility to generate the manual SA keys. Refer to the Fabric OS Administrator's Guide for details. • A 192-bit value for the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 443
policies, you have the option to delete specific components only, such as the transform or manual SADB entries. manual-sa arguments -a -tag name Deletes the SA policy entries used in manually . Flushing any other policy parameters is not supported. --show type policy ips Displays current IPsec - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 444
between two systems using protection with MD5 and Manually keyed SAs. 5. "IPsec display commands" - Verify your IPsec configurations. 6. "Using the help command" - Use the help command with arguments to get syntax information on specific parameters. 414 Fabric OS Command Reference 53-1001337 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 445
IKE policy for the remote peer. switch:admin> ipsecconfig --add policy ike manual-sa -a. Refer to the "IPsec display commands" section for an example. 10. Perform the equivalent steps on the remote peer to complete the IPsec configuration. Refer to your server administration guide for instructions - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 446
complete the IPsec configuration. Refer to your server administration guide for instructions. Example 3 Secure traffic between two systems using AH with SHA1 and ESP protection with 3DES and configure IKE with pre-shared keys. The two systems are a switch, BROCADE300 (IP address 10.33.74.13), and an - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 447
remote peer to complete the IPsec configuration. Refer to your server administration guide for instructions. Example 4 Secure traffic between two systems using protection with MD5 and Manually keyed SAs. The two systems are a switch, the BROCADE300 (IPv4 address 10.33.74.13), and an external UNIX - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 448
pem" peer-public-key:"/etc/fabos/certs/sw0/spiritcert.pem To display the outbound and inbound SAs in the kernel SA database: switch:admin> ipsecconfig --show manual-sa -a 10.33.69.132[0] 10.33.74.13[0] ah mode=transport spi=34560190(0x020f58be) reqid=0(0x00000000) A: hmac-md5 7e5aeb47 e0433649 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 449
:any transform-used:policy-A-B Using the help command To use the --help command with arguments to display the syntax of specific types and subtypes: switch:admin>ipsecconfig --help add policy ips selector Usage: ipsecConfig --add policy ips selector ARGUMENTS ARGUMENTS -tag -direction - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 450
2 ipsecConfig References [DISR] "DOD IPv6 Standards Profiles for IPv6 Capable Products", v2.0 (6/15/2007). [NIST] "A Profile for IPv6 in the U.S. Government", v1.0 (1/31/2007). [4301] Kent, S. and K. Seo, "Security Architecture for the Internet Protocol", RFC 4301 (Dec 2005). [4302] Kent, S., "IP - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 451
iscsiCfg Synopsis Configures or displays iSCSI entities. 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 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 452
triggers the propagation of changes to all iSCSI-enabled switches and blades in the fabric. Changes do not Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, status for the specified user. If username is not specified, all users in the database are - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 453
based on the login frame from the host. --addusername tgt -t target_name -u user_list [-h] Binds user names defined in AUTH database to the specific target. --deleteusername tgt -t target_name -u user_list [-h] Unbinds user domain, an error is returned. If IQN format is supported. Multiple entities - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 454
. Actions on initiator are: --clear initiator [-h] Clears the iSCSI initiator database. --show initiator [-i initiator_name][-h] Displays all iSCSI initiators that the switch is aware of. If an initiator has attempted discovery or logon to a target, it is displayed here. If initiator_name is - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 455
completed successfully. To modify a CHAP entry associated with an existing user: switch:admin> iscsicfg --modify auth -u user1 -s newsecret The operation completed successfully. To display the authentication database switch:admin> iscsicfg --show auth Number of records found: 1 Name Status - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 456
admin> iscsicfg --addusername tgt-t iqn.2005-10.com.brocade.tgt1 -u user1 The operation completed successfully. To unbind user CHAP from a target: switch:admin> iscsicfg --deleteusername tgt -t iqn.2005-10.com.brocade.tgt1 -u user1 The operation completed successfully. To clear the target database - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 457
myddset -d mynewdd The operation completed successfully. To display the iSCSI-aware switches and their operational states (Displays switches that are capable of propagating iSCSI data base): switch:admin> iscsicfg --show fabric Switch ID Switch WWN Switch State iSNSC * 1 10:00:00:60:69:e4:20:1e - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 458
: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. Index iSCSI Name IP Address Type 1. iqn.1991-05.com - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 459
and iFlipper FPGA. Notes This command is supported only on the Brocade FR4-16IP blade that may be in place. Refer to chapter 1, "Using Fabric OS commands" and 7 or specify 8 for all ports. Examples To run iscsichiptest: switch:admin> iscsichiptest --slot 7 -unit 1 -testtype 0 Running iscsichiptest - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 460
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the list of iSCSI support commands: switch:admin> iscsihelp fclunquery fosconfig iscsicfg iscsiportcfg iscsisessioncfg iscsiswcfg - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 461
mode with the -path option. Notes This command is supported only on the Brocade FR4-16IP blade. On all other that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix default value is 100. Examples To run iscsipathtest: switch:admin> iscsipathtest --slot 2 -path 2 -nframes - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 462
iSCSI port settings are as follows: TABLE 18 Default iSCSI port settings Setting Default Error recovery level Connections per session Connections per session Header digest support Immediate data support First burst length value 0 1 Disabled Disabled No 512 Note Operands The execution of this - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 463
Specifies the slot number. This parameter only supports FC4-16IP blades in Brocade 48000 directors. the port information in verbose mode: switch:admin> iscsiportcfg --show 7/ge0 The Data Out: FC XFer Ready: FC Response: iSCSI Error PDU: FC Error PDU: iSCSI Snack: iSCSI NOP Out: iSCSI Text: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 464
2 iscsiPortCfg See Also iSCSI Abort Task Set: iSCSI Clear ACA: iSCSI Clear Task Set: iSCSI LUN Reset: iSCSI Target Reset: iSCSI Task Reassign: Non FCP in PDU: Non FCP in Octet: Non FCP out PDU: Non FCP out Octet: Session details: Session Number: iSCSI Session Type: Initiator Name: Target Name: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 465
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" match the given target IQN. Examples To display the iSCSI session status: switch:admin> iscsisessioncfg --show Number of sessions found: 1 Session 1 Details: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 466
Max outstanding R2T Default time to retain Default time to wait Error recovery level Initial R2T 256KB 512B 1 20s 2s 0 Off : 420686 FC Data Out: 417656 FC XFer Ready: 3375 FC Response: 7234 iSCSI Error PDU: 0 FC Error PDU: 0 iSCSI Snack: 0 iSCSI NOP Out: 0 iSCSI Text: 0 iSCSI - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 467
Use this command to display the iSCSI switch level configuration and to configure the iSCSI chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operands: --enableconn Enables the connection redirection on a specific - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 468
Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples When you issue islshow in a base fabric, the output displays as follows: switch:user> islshow 1: 2->300 10:00:00:05:1e:43:00:00 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 469
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix GbE port in an iSCSI blade. This parameter only supports Brocade FC4-16IP blades in Brocade 48000 directors. of an external iSNS server with an attached GbE port: switch:admin> isnsccfg --set 7/ge0 -s 192.168.131.124 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 470
2 isnscCfg See Also To register the iSNS objects: switch:admin> isnsccfg --reregister 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. none 440 Fabric OS Command Reference 53-1001337- - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 471
port lists may specify multiple conflicting slot numbers. For instance, "1/0, 2/0, 3/0" is a valid user port list but is not valid for any other type of list. In the case of conflicting settings within a single item list, an error is generated, as described earlier. In the case of multiple item list - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 472
MINIS SLOTS INDEX Blade Switch Blade Blade Blade Chassis N/A Blade ports, internal and external ports User ports, ports with external Mini-switches Slots Anything Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 473
chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Examples To terminate an open Telnet connection: switch: is: "pts/0 ". This action will effectively kill these process(es):- USER PID ACCESS COMMAND /dev/pts/0 root 12868 f.... login root 12869 f.... - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 474
an alias for a customer-defined group which allows a user belonging to that group to login to the switch with the permissions associated with the mapped switch role. This command supports one-to-one role mapping only. For example, you might map the "SAN administrator" role on the AD server to the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 475
the command usage. Examples To display current LDAP and switch role map: switch:admin> ldapcfg --show LDAP Role | Switch Role ldapadmin | admin ldapuser | user SANfabadmin | fabricadmin SANzoneadmin | zoneadmin SANoperator | operator LDAPSANsecadm | securityadmin SANuser - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 476
chassis context. Each logical switch displays only the user ports that are configured to be part of that switch instance. The switch context is defined by the fabric ID. The default context is the base logical switch that you are placed in upon login. The default logical switch context is defined by - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 477
.2.0 or later. Refer to the Fabric OS Administrator's Guide for specific hardware support. You cannot use the portEnable command on logical ports. Use lfcfg with the --lislenable option to re-enable disabled LISL ports on a logical switch. Operands This command has the following operands: --show - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 478
WWN: 10:00:00:05:1e:0b:a4:5e Number of Partitions: 2 Base switch domain: 2 Logical switch: 2 State: Online(1) Base switch: YES Fabric Id: 2 Switch WWN: 10:00:00:05:1e:0b:a4:41 Logical Switch: 1 State: Online(1) Base switch: NO Fabric Id: 1 Switch WWN: 10:00:00:05:1e:0b:a4:40 To display the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 479
switch. Some features of the switch and the fabric to which it is connected are optional, licensed products. Without a valid license installed for such products, their services or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 480
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for commands: switch:admin> licensehelp licenseadd licensehelp licenseidshow licenseremove licenseshow licenseslotcfg Adds license keys to switch Prints - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 481
of the switch and the fabric are optional, licensed products. Without a license installed for such products, the services provided by to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the license ID: switch:admin - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 482
specific ports in the event that there are more online ports than the purchased POD licenses can support . Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter specified port when the switch is using the Dynamic - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 483
1 POD license is installed Dynamic POD method is in use 24 port assignments are provisioned for use in this switch: 12 port assignments are provisioned by the base switch license 12 port assignments are provisioned by the first POD license * 0 more assignments are added if the second POD license - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 484
switch after removing a license. For a switch that has no licenses installed, licenseShow displays "No licenses." Upgradable licenses, such as slot-based licenses or Universal Time-based Blade Slots 3,4 DXXtN3LmRSMWCSW3XmfSBPfrWKLZ3HMTN73rP9GANJMA: Advanced Extension (FTR_AE) license - Inactive. - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 485
licenseRemove 2 See Also 8 Gig FC license Expiry Date 03/06/2009 License is expired Hf7MBEEGCFNmTAWXXF99RtHXQN4RRtM3mLGtrWZLAMaTaAY9EB: Storage Application Services license Expiry Date 03/07/2009 licenseAdd, licenseHelp, licenseIdShow, licenseShow Fabric OS Command Reference 455 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 486
- Associated product Temporary and universal time-based licenses - License key - Associated product chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the license keys on a switch with permanent licenses installed: switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 487
examples show time-based, the third one shows a slot-based license): switch:admin> licenseshow DAmHTPgQ7KDtKrEYQC7X7STF9HJDL7TmTWRmZPmSTSE49AEfaE: Trunking license Expiry Date 11/11/2008 License is expired H47CFSa93aKgKJM9NWMYEMaLrATQWDHCgHfZftWGGgNCYAJaBA: High-Performance Extension over FCIP/FC - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 488
command. Refer to the Fabric OS Administrator's Guide for more information. Note Operands The execution of chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. In Fabric OS v6.3.0, slot-based licensing is available only on the Brocade FX8-24 extension - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 489
--help Displays the command usage. Examples To add a license key for the slot-based Advance Extension feature for eight slots: switch:admin> licenseadd DXXtN3LmRSMWCSW3XmfSBPfrWKLZ3HMTN73rP9GANJMA adding license-key [DXXtN3LmRSMWCSW3XmfSBPfrWKLZ3HMTN73rP9GANJMA] To display the installed license - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 490
Extension license on slots 3 and 12, and to display the: results: switch:admin> licenseslotcfg --remove FTR_AE 3 Blade slot-3 removed from FTR_AE slot-based license configuration switch expired Hf7MBEEGCFNmTAWXXF99RtHXQN4RRtM3mLGtrWZLAMaTaAY9EB: Storage Application Services license Expiry Date 03/07 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 491
Extension license completely (marked inactive): switch:admin> licenseremove DXXtN3LmRSMWCSW3XmfSBPfrWKLZ3HMTN73rP9GANJMA removing license-key [DXXtN3LmRSMWCSW3XmfSBPfrWKLZ3HMTN73rP9GANJMA] switch Hf7MBEEGCFNmTAWXXF99RtHXQN4RRtM3mLGtrWZLAMaTaAY9EB: Storage Application Services license Expiry Date 03 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 492
executed without operands, the command displays the current cost of each port on the switch, including non-ISLs. An E_PORT suffix is appended to the interface number of or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 493
,535. Assigning a value outside this range will fail and generate an error. A value of 0 removes the static cost and the port reverts to specified port. Examples To display the link costs for all ports on a switch: switch:admin> linkcost Slot Interface Cost 2 0 500 (STATIC) 2 1 1000 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 494
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To log in as admin from the login user: switch:user> login login: admin Password:xxxxxx See Also logout 464 Fabric OS - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 495
command is accepted as a synonym for logout, as is Ctrl-D at the beginning of a line. Operands none Examples To log out from an rlogin session: switch:admin> logout See Also login Fabric OS Command Reference 465 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 496
Displays logical SAN zone information . Search parameters -f, -w, and -z allow searching for LSAN zones based on fabric ID, WWN of an LSAN zone member, or LSAN that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and switch, which can differ from the database stored on the other FCR - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 497
lsanZoneShow 2 Examples See Also To display the LSAN zones: switch:admin> lsanzoneshow Fabric ID: 4 Zone Name: lsan_fcr10_0 50:05:07:65 :84:0b:83 50:05:07:65:05:84:09:0e switch# fcrFabricShow, fcrPhyDevShow, fcrProxyDevShow, fcrRouteShow, switchShow Fabric OS Command Reference 467 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 498
aware and run Fabric OS v6.2.0 or later. Refer to the Fabric OS Administrator's Guide for specific hardware support. The Virtual Fabric (VF) feature must be enabled on the switch before you can configure a logical switch. Use the fosconfig --enable vf command to enable the feature. Use the fosconfig - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 499
. --change Changes the fabric ID of a logical switch, creates a base logical switch out of an existing logical switch, or removes base switch properties. The -newfid and -base operands are exclusive and may not be combined. The following operands are supported: FID Specifies the Fabric ID of the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 500
is optional and valid only on a chassis. --help Displays the command usage. Examples To create a base switch: switch:admin> lscfg --create 1 -base Creation of a base switch requires that the proposed new base switch on this system be disabled. Would you like to continue [y/n]?: y About to create - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 501
| 128 | 128 | 128 | To change the fabric ID for a logical switch: switch:admin> lscfg --change 1 -newfid 2 Changing of a switch fid requires that the switch be disabled. Would you like to continue [y/n]?: y Disabling switch... All active login sessions for FID 2 have been terminated. Checking and - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 502
fid 1 Disabling the proposed new base switch... Disabling switch fid 1 Please enable your switches when ready. To make logical switch FID 1 the base switch with confirmation: switch:admin> lscfg --change 1 -base Creation of a base switch requires that the proposed new base switch on this system be - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 503
two types of database entries: • The link state database entry, which is permanently allocated. • The link state record (LSR), which is allocated when a switch is connected to the fabric. The LSR describes the links between connected domains in a fabric. For a link to be reported in the LSR, the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 504
local switch. Port number of the port on the other side of the link. Cost of this link. The default cost for a 1 Gbps link is 1,000. Always 0. Always 1. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 505
lsDbShow 2 See Also mOutIfsP[4] mOutIfsP[5] mOutIfsP[6] parent mPathCost mHopsFromRoot = 0x00000000 = 0x00000000 = 0x00000000 = 0xf0 = 0 = 0 Link State Record: Link State Record pointer = 0x109784b0 lsAge = 321 reserved = 0 type = 1 options = 0x0 lsId = 1 advertiser = 1 incarn = - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 506
executed in all logical switches. The FIDs must be part of the FID permission list associated with the user account. If you restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix 10, Base Switch: No, Default Switch: No, Address Mode 0] 476 Fabric OS - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 507
" on FID 10: A port or ports is/are not part of this switch. "portenable" on FID 20: A port or ports is/are not part of this switch. switch:admin> To display the firmware version for all logical switches: switch:user> fosexec --fid all -cmd "firmwareshow -v" LF permission does not exist for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 508
2 fosExec See Also To display the switch name for all logical switches without confirmation: switch:user> fosexec --fid all -force -cmd "switchname" switchname" on FID 10: switch_10 switchname" on FID 20: switch_20 switch:user> setContext, userConfig 478 Fabric OS Command Reference 53- - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 509
to display free and used memory in the switch, as well as the shared memory and buffers used by the kernel. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 510
is a fabric-wide capability and is supported only if all the switches in the fabric support the service. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 511
. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is supported only in AD0 and AD255 contexts. Operands none Examples To display the MS ACL: switch:admin> msconfigure 0 Done 1 Display the access list 2 Add member based on its - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 512
2 msConfigure See Also 0 Done 1 Display the access list 2 Add member based on its Port/Node WWN 3 Delete member based on its Port/Node WWN select : (0..3) [1] 0 done ... msCapabilityShow, msPlatShow, msPlClearDB, msPlMgmtActivate, msPlMgmtDeactivate, msTdDisable, msTdEnable, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 513
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for Operands none Examples To display the MS platform database for a fabric: switch:admin> msplatshow Platform Name: [9] "first obj" Platform Type: 5 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 514
Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the MS platform service database control block: switch:admin> msplatshowdbcb Domain Worldwide Name Retry Count Exchange - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 515
place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is supported only in AD0 and AD255 contexts. Operands none Examples To clear the MS platform database: switch:admin> msplcleardb MS Platform Service is currently enabled. This - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 516
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is supported only in AD0 and AD255 contexts. Operands none Examples To activate the MS platform service: switch:admin> msplmgmtactivate Request to activate MS - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 517
in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is supported only in AD0 and AD255 contexts. Operands none Examples To deactivate the MS platform service on all switches in the fabric: switch:admin> msplmgmtdeactivate MS - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 518
the attached devices (including attached switches) to support request node identification data (RNID) extended link service (ELS). When an FCS policy in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is supported only in AD0 and - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 519
the attached devices (including attached switches) to support request node identification data (RNID) extended link service (ELS). When an FCS policy in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is supported only in AD0 and - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 520
Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the status of the topology discovery service: switch:admin> mstdreadconfig *MS Topology Discovery is enabled. See Also - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 521
gives details of the following: • CP/switch (or console/serial port) used to log chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To display current login information: switch:admin> myid Current Switch: switch Session Detail: switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 522
the switchShow command. Domain Domain ID of the remote switch. Remote Port E_Port interface on the remote switch. State State of the neighbor. The neighbor can or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 523
nbrStateShow 2 Examples See Also To display information about a neighbor directly connected to the local switch: switch:user> nbrstateshow 2/0 Local Domain ID: 1 Local Port Domain Remote Port State 16 2 48 NB_ST_FULL interfaceShow Fabric OS Command Reference 493 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 524
Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command FSPF statistics are reset. Examples To display the counters on a port: switch:admin> interfaceshow 1/0 idbP = 0x10050a38 Interface 0 data structure: nghbP ifNo masterPort - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 525
To reset the counters on a port: switch:admin> nbrstatsclear 1/0 See Also To verify the changes: switch:admin> interfaceshow 1/0 idbP = 0x10050a38 Interface 0 data structure: nghbP ifNo masterPort defaultCost cost = 0x1004ce68 = 0 = 0 (self) = 500 = 500 (output truncated) interfaceShow, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 526
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command . Examples To display all the device information matching the alias "a320": switch:user> nodefind a320 Local: Type Pid COS PortName NodeName SCR NL 0314d9; - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 527
: Physical Target Port Index: 14 Share Area: No Device Shared in Other AD: No Aliases: To display all the device information matching the PID "0x020eef": switch:user> nodefind 0x020eef Remote: Type Pid COS PortName NodeName NL 020eef; 3;20:00:00:e0:8b:01:ce:d3;20:00:00:e0:8b:01:ce - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 528
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for log in to the switch. • Virtual - Contrived device by the switch. • NPV - Device connected to the NX_Port, using FDISC to log in to the switch. • iSCSI - - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 529
an iSCSI target. Examples To display local NS information with aliases: switch:admin> nsaliasshow { Type Pid COS PortName NodeName TTL(sec) N } To display local NS information with aliases with the -r option: switch:admin> nsaliasshow -r { Type Pid COS PortName NodeName SCR N 021200 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 530
: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> nsaliasshow -r -t { Type Pid COS PortName NodeName SCR N 021200; 2,3;10:00:00:60:69:00:03:19;30:00:00:60:69:00:03:19 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 531
See Also Fabric Port Name: 20:04:00:60:69:01:44:22 Permanent Port Name: 21:00:00:ad:bc:04:6f:70 Device type: Physical Target Aliases: The Local Name Server has 6 entries } nsAllShow, nsShow, switchShow nsAliasShow 2 Fabric OS Command Reference 501 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 532
is optional. The valid values for this operand are 0 to 255. Following are two specific FC-PH device type codes: 8 = FCP type device 4, 5 = FC-IP type device Other FC-PH types are displayed in the format "x ports supporting FC4 code," where x is the number of ports of a type and code is the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 533
No Entry is found!" For each remote switch found, this command displays the domain Fibre Channel address. COS A list of classes of service supported by the device. PortName The device's port world restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 534
Port Name: 20:02:00:60:69:00:68:19 Permanent Port Name: 10:00:00:60:69:00:ab:ba Device type: Physical Initiator Switch entry for 4 state rev owner known v320 0xfffc01 Device list: count 0 No entry is found! nsAllShow, nsShow, switchShow 504 Fabric OS Command Reference 53-1001337 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 535
nsAllShow to display NS information for all switches in the fabric. Each line of output displays the following information: Type U for unknown, N for N_Port, NL for NL_Port. PID 24-bit Fibre Channel address. COS List of classes of service supported by device. PortName Device port world wide - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 536
. After a nondisruptive upgrade from those Fabric OS versions, the device type displays as "Physical Unknown(initiator/target)". Examples To display local NS information: switch:admin> nsshow { Type Pid COS PortName NodeName TTL(sec) N 010100; 3;21:00:00:e0:8b:13:08:10;20:00:00:e0:8b - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 537
Device Shared in Other AD: No Redirect: No The Local Name Server has 2 entries } See Also To display local name server information with "-r" and "-t" options. switch:admin> nsshow -r -t { Type Pid COS PortName NodeName SCR N 010100; 3;21:00:00:e0:8b:13:08:10;20:00:00:e0:8b:13:08:10 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 538
The 24-bit Fibre Channel address. COS A list of classes of service supported by the device. PortName The device's port world wide name (WWN). any of the following information (the switch automatically registers SCSI inquiry data for FCP target devices): • FC4 supported • IP address (node) • - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 539
display information about all the online devices zoned with the given device: switch:admin> nszonemember 0x0416e2 3 local zoned members: Type Pid COS PortName To display information about all the online devices zoned with the given WWN: switch:admin> nszonemember 10:00:00:00:c8:23:0b:ad 3 local - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 540
0xb00e00 Aliases: dl360_130251a dl360_130251a Pid: 0xba1ae4 Aliases: trimm100a_2 See Also 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 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 541
in the fabric, the switches must be configured to accept the password database with the fddCfg command. The password database is distributed manually with the distribute command. If RADIUS authentication is enabled, password change is blocked for users changing their own password. Administrators - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 542
that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and account while logged in as admin: switch:admin> passwd Changing password for admin error Password length, strength, or history policy not met. "user" is not a valid user name You have not specified a valid recognized user - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 543
passwd 2 The password you entered contains less than the minimum required number of lowercase characters. Insufficient number of upper case letters The password you entered contains less than the minimum required number of uppercase characters. Insufficient number of digits in password The - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 544
. It is enforced only when a new password is defined. The password strength policy is enforced across all user accounts. When a password fails more than one of the strength attributes, an error is reported for only one of the attributes at a time. Password History Policy The password history policy - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 545
is maintained for each user on each switch instance. The counters for all user accounts are reset to zero Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, policy. The following arguments are supported: -lowercase value Specifies the minimum - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 546
The default value to 0. -lockoutthreshold value Specifies the number of times a user can specify an incorrect password during login before the account is locked. The .lockoutduration" duration. The particular account is unlocked manually using userconfig --change account name-u (requires root - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 547
that a password must contain at least two uppercase characters, and that passwords expire in 90 days from the date they are defined: switch:admin> passwdcfg --set -uppercase 2 -maxpasswordage 90 The passwdCfg command may fail for any of the following reasons: Permission failure You not permitted - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 548
out of range The -punctuation value specified must be greater than or equal to 0 and less than or equal to -minlength value. total strength specification out of range The total of -lowercase value, -uppercase value, -digits value, and -punctuation value must be less than or equal to -minlength value - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 549
retry if there is a timeout or failure. It may fail if a switch along the path is busy or does not support this feature. If the advanced performance tuning (APT) policy in effect on the intermediate switches is not a port-based policy, subsequent data streams may not take the same path as displayed - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 550
collect these statistics, this command uses a special pathInfo frame that is sent hop-by-hop from the source switch to the destination switch. To prevent such a frame to loop forever if an error occurs, a maximum number of hops for the frame to traverse is enforced. The hop count includes all hops - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 551
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" port can be selected manually by entering the value of MAX_PORT. MAX_PORT stands for the maximum number of ports supported by the local switch. Fabric OS Command - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 552
time allowed waiting for the response in milliseconds. The default is 10000 milliseconds. Examples To display basic path information to a specific domain in command line mode: switch:admin> pathinfo 91 Target port is Embedded Hop In Port Domain ID (Name) Out Port BW Cost 0 E 9 (web226 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 553
(Name) Time/hop 6 (Stealth_I) 108186 usec To display basic path information to a specific domain in a Virtual Fabric environment (the cost for this hop is the cost of the corresponding path in the base fabric): switch:admin> pathinfo 13 4 Target port is Embedded Hop In Port Domain ID (Name - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 554
See Also B/s (64s) - - 1 1 Txcrdz (1s) - - 0 - Txcrdz (64s) - - 0 - F/s (1s) - - 0 0 F/s (64s) - - 2743 0 Words - - 2752748 2822763 Frames - - 219849 50881 Errors - - - 0 Hop In Port Domain ID (Name) Out Port BW Cost 1 3 10 (web229) 12 1G 1000 Port - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 555
file available on the switch. If a panic dump file is specified as an argument, the contents of that specific file are displayed. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 556
of words transmitted, and number of CRC errors detected using either of the following two conditions storage device connected to an Encryption Switch, you must add two monitors because license. This command is not supported on virtual FC ports ( be in place. Refer to chapter 1, "Using Fabric OS - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 557
ID of 2, and an AL_PA ID of 0. SourceID and DestID both cannot be 0x000000. Examples To add an end-to-end monitor to blade 1 port 2: switch:admin> perfaddeemonitor 1/2 "0x050200" "0x1182ef" End-to-End monitor number 0 added. To add an end-to-end monitor to an Encryption - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 558
2 perfAddEEMonitor 2. Get name server information. Name server info shows four devices (two of which are virtual) connected to the Encryption Switch along with their PIDs: EncryptionSwitch:SecurityAdmin>nsshow { Type Pid COS PortName NodeName TTL(sec) N 0a0100; 3;2f:ff:00:06:2b:0e:b3:3c;2f: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 559
:SecurityAdmin> perfaddeemonitor 1 0x0a2001 0x01a000 End-to-End monitor number 1 added. See Also 5. Display the EE monitors on the Encryption Switch: EncryptionSwitch:SecurityAdmin> perfmonitorshow --class EE 1 There are 2 end-to-end monitor(s) defined on port 1. KEY SID DID OWNER_APP TX_COUNT - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 560
Fabric environment, performance monitors installed on a logical switch share the physical resources of the switches that make up the base fabric. To make efficient usage of existing system resources, such as link table size for all supported monitors, the resources reserved for a given logical - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 561
2 Examples To display the number of F_Port monitors that can be installed on the current logical switch: switch:admin> perfresourceshow --fportRes Max Installed Available Slot/PortRange 4 0 3 2/13 4 2 2 3/5,3/7,3/12 Port list information Slot 1 2 3 4 5 6 7 8 9 10 11 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 562
2/37 Slot/Port Max Installed Available 2/37 4 0 4 To display the number of EE monitors that can be installed on the current logical switch: switch:admin> perfresourceshow --eeRes Max Installed Available Slot/PortRange 256 1 255 2/13 256 0 129 3/5,3/7,3/12 Port list information Slot - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 563
of EE monitors that can be installed on port 10: switch:admin> perfresourceshow --eeRes 2/10 slot/Port Available Installed 2/0 30 3 To display the status of TT fabric mode on the current logical switch: switch:admin> perfresourceshow --fabRes Maximum Installed Available 1 1 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 564
Description Use this command to create a filter-based monitor that will count the number of IP and user-defined aliases. Notes This command requires an Advanced Performance Monitoring license. This command is not supported on IP monitor to a port: switch:admin> perfaddipmonitor 1/4 IP_MONITOR IP - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 565
Description Use this command to create a filter-based monitor that counts the number of SCSI and user-defined aliases. Notes This command requires an Advanced Performance Monitoring license. This command is not supported on read monitor to a port: switch:admin> perfaddreadmonitor 2/4 SCSI_R SCSI - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 566
Description Use this command to create a filter-based monitor that counts the number of SCSI and user-defined aliases. Notes This command requires an Advanced Performance Monitoring license. This command is not supported on write monitor to a port: switch:admin> perfaddrwmonitor 2/4 SCSI_RW SCSI - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 567
Use this command to create a filter-based monitor that counts the number of SCSI and user-defined aliases. Notes This command requires an Advanced Performance Monitoring license. This command is not supported on traffic frame monitor to a port: switch:admin> perfaddscsimonitor 2/4 "SCSI FR" SCSI - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 568
identifies the monitor. Use the perfMonitorShow command for a listing of valid keys and user-defined aliases. Notes This command requires an Advanced Performance Monitoring license. This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port, M (Mirror) ports and GbE ports. The - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 569
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: switch:admin> perfaddusermonitor 1/4 "4, 0xff, 0x22; 12, 0xff, 0x01" User monitor #0 added As a special case, to add a filter - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 570
Use this command to create a filter-based monitor that counts the number of SCSI and user-defined aliases. Notes This command requires an Advanced Performance Monitoring license. This command is not supported on command monitor to a port: switch:admin> perfaddwritemonitor 2/4 SCSI_W SCSI - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 571
Performance Monitoring license. This command is not supported on virtual FC ports (VE/VEX_Port), that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix performance monitoring information from nonvolatile memory: switch:admin> perfcfgclear This will clear Performance - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 572
Advanced Performance Monitoring license. This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port, that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix configuration information from nonvolatile memory: switch:admin> perfcfgrestore This will overwrite - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 573
• 16 filter monitors • A total number of 512 monitors per switch When there are more than 512 monitors in the system, monitors Performance Monitoring license. This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port may be in place. Refer to chapter 1, "Using Fabric OS commands" and - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 574
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is not supported on all platforms. Refer to the Fabric OS Administrator's Guide for specific hardware support. Operands This command has the following operands - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 575
Performance Monitoring license. This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port may be in place. Refer to chapter 1, "Using Fabric OS commands" or all such monitors: switch:admin> perfdeleemonitor 7/2 5 End-to-End monitor number 5 deleted switch:admin> perfdeleemonitor 7/2 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 576
. Examples To delete filter monitor 4 from a port, and then all filter monitors from the port: switch:admin> perfdelfiltermonitor 2/3 4 The specified filter-based monitor is deleted. switch:admin> perfdelfiltermonitor 2/3 This will remove ALL monitors on port 19, continue? (yes, y, no, n): [no - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 577
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability : switch:admin -to-end monitor Delete filter-based monitor Clear end-to-end/filter-based/ISL monitors Show end-to-end/filter-based/ISL monitors Set overall mask - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 578
Advanced Performance Monitoring license. This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port, be in place. Refer to chapter 1, "Using Fabric OS commands" counters for a filter-based monitor: switch:admin> perfmonitorclear --class FLT 1/2 4 Filter-based monitor number 4 counters - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 579
admin> perfmonitorclear --class FLT 1/2 This will clear ALL filter-based monitors' counters on port 2, continue? (yes, y, no, y): [no] y To clear statistics counters for an ISL monitor: switch:admin> perfmonitorclear --class ISL 1 This will clear ISL monitor on port 1, continue? (yes, y, no, n): [no - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 580
pass the IP address while adding the monitor. If the monitor is added using performance monitor commands, this field displays N/A. • For filter-based monitors (if no interval is specified), this command displays the following: Key The monitor number. Alias The monitor alias name. Owner_app The - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 581
supported on virtual FC ports (VE/VEX_Port), EX_Port, M (Mirror) ports and GbE ports. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter port 8: switch:admin> perfmonitorshow --class FLT 8 There are 2 filter-based monitors - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 582
6 ----Tx Rx ===== 0 0 0 0 7 ----Tx Rx ===== 0 0 0 0 To display cumulative filter monitor information on a port: switch:admin> perfmonitorshow --class FLT 8 There are 2 filter-based monitors defined on port 8. KEY ALIAS OWNER_APP FRAME_COUNT OWNER_IP_ADDR 0 IPFrame TELNET 0x0000000000000000 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 583
perfMonitorShow 2 See Also To display ISL monitor information on a port: switch:admin> perfmonitorshow --class ISL 1/1 Total transmit count for this ISL: 1462326 Number of destination domains monitored: 3 Number of ports in this ISL: 2 Domain 97: 110379 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 584
mask. Specify the following values to turn a specific field on or off: 00 Specifies that the field license. This command is not supported on virtual FC ports (VE ID address fields are masked separately, the switch cannot track frames sent to the upper 32 in place. Refer to chapter 1, "Using Fabric - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 585
monitor. 00 ff TxDIDMsk RxSIDMsk RxDIDMsk Specify the following values to turn a specific field on or off: Specifies that the field does not trigger EE format. Examples To set the overall mask for end-to-end monitors on a port: switch:admin> perfsetporteemask 1/6 "00:00:00" "ff:ff:ff" "00:ff:ff" - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 586
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is not supported on all platforms. Refer to the Fabric OS Administrator's Guide for specific hardware support. Operands This command has the following operands - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 587
an Advanced Performance Monitoring license. This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port, may be in place. Refer to chapter 1, "Using Fabric OS commands" and To display the end-to-end mask on a port: switch:admin> perfshowporteemask 2/4 The EE mask on port 20 is set - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 588
2 perfShowPortEEMask See Also RxSID ALPA: on RxDID Domain: on RxDID Area: on RxDID ALPA: on perfAddEEMonitor, perfDelEEMonitor, perfSetPortEEMask 558 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 589
the F_Port and flowing to different destinations. The output displays the data in a sorted order based on the data rate of each flow. • In Fabric Mode, Top Talker measures the top "n" bandwidth using flows on a given switch. Top Talker installs only on E_Ports and measures the data rate of all the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 590
joins the fabric, this command must be run again on the switch. The TT configuration information is not propagated automatically to the new switch. --show Displays the Top Talking flows on the switch for a given domain ID. dom dom_id Specifies the domain ID for the flow display. number of top - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 591
perfTTmon 2 See Also To add the Fabric Mode Top Talker: Switch:admin> perfttmon --add fabricmode To delete the Fabric Mode Top Talker: Switch:admin> perfttmon --del fabricmode To display the Fabric Mode Top Talker output: Switch:admin> perfttmon --show dom 1 pid perfttmon --show dom 1 pid - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 592
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To create PKI objects: switch:admin> pkicreate Installing Private Key and Csr... Switch key pair and CSR generated... Installing Root Certificate - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 593
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To remove PKI objects: switch:admin> pkiremove WARNING!!! Removing Pki objects will impair the security functionality - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 594
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To view PKI objects: switch:admin> pkishow Passphrase : Exist Private Key : Exist CSR : Exist Certificate : Empty - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 595
The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands Optional Operands The following operands are required: option Specifies the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 596
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 3DES SA Life (seconds): 28800 To display all IKE policy settings: switch:admin> policy --show ike all IKE Policy 1 Authentication Algorithm: SHA-1 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 597
Algorithm: SHA-1 Encryption: AES-128 Perfect Forward Secrecy: 0 Diffie-Hellman Group: 1 SA Life (seconds): 28800 See Also To delete a policy: switch:admin> policy ike --delete 10 The policy has been successfully deleted. portCfg, portCfgShow, portShow policy 2 Fabric OS Command Reference 567 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 598
option to unbind the port. This command returns an error if the chosen address is in use or is chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. This command is supported only on the Brocade DCX and the Brocade DCX-4S on (on the base switch and logical switches - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 599
the command usage. To bind a 16-bit address to the low two bytes of a port 24-bit Fibre Channel address: switch:admin>portaddress --bind 5/18 0x1a00 To unbind a given address from a port: switch:admin>portaddress --unbind 5/18 0x1a00 To display all port address bindings on the current partition - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 600
0x1400 8 bit 413 5 29 0x1500 8 bit 414 5 30 0x1600 8 bit 415 5 31 0x1700 8 bit To display the port address binding for port 28: See Also switch:admin>portaddress --show 5/18 Index Slot Port Area Mode 412 5 28 0x1400 8 bit To display the port bound to a specified address - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 601
present, this command prints an error. Note The execution of this command is subject to Virtual restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix Examples To display the AL_PAs of a port: switch:user> portalpashow 4/14 AL_PA type AL_PA 0xe2 public - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 602
if you are trying to locate a specific port. Beaconing mode takes over the port However, if diagnostic frame-based tests such as portLoopbackTest may be in place. Refer to chapter 1, "Using Fabric OS commands" switch:admin> portbeacon --enable 1/0 See Also To disable beaconing mode on a port: switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 603
user input. Max/Resv Buffers The maximum or reserved number of buffers that are allocated to the port based that is sent and then echoed back to the switch. LD mode supports distances up to 500 km. Distance measurement on in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 604
for bladed systems. Use switchShow for a list of valid ports. Examples To display the port buffer information for a port: switch:admin> portbuffershow 17 User Port Lx Max/Resv Buffer Needed Link Remaining Port Type Mode Buffers Usage Buffers Distance Buffers 16 - - 0 - - 17 E L1 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 605
Notes Operands Displays port-based filter CAM utilization. command cannot be executed on a logical port. Ports that support shared areas are divided into two ports: primary and secondary ports Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 606
To display port CAM entries on shared ports: In the following example, port 7/31 and 7/39 are shared ports and 7/31 is the primary port. switch:user> portcamshow 7/39 Area SID used DID used SID entries DID entries 207 3 1 03b380 03cf80 034100 03cf00 SID free, DID free: (2044, 1020 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 607
" on page 587 • "Commands supported only on the Brocade 7500/7500E switches" on page 596 Each of these command groups is documented in a separate section that includes function, synopsis, description, operands and examples. Use the hot links to jump to a specific section. To display command usage on - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 608
port or on a GbE port. After defining the IP interface of the remote switch, you can define destination routes for an interface. A maximum of 32 user-configurable routes per 1/10 GbE port or GbE port are supported. You cannot use this command to configure routes for inband management; use portCfg - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 609
subnet mask must be specified as well. Use a.b.c.d. format. Examples To create an IP interface using IPv4: switch:admin> portcfg ipif 4/ge0 create 11.81.0.110. 255.0.0.0 1500 Operation Succeeded switch:admin> portshow ipif 4/ge0 Port: ge0 Interface IP Address NetMask MTU 0 11.81.0.110 255 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 610
:800::3456/64 1080::8:800:200C:1234 To delete a static IP route using an IPv4 address: switch:admin> portcfg iproute ge0 delete 172.16.123.231 Operation Succeeded Function Synopsis Commands supported only on the Brocade 7800 and the Brocade FX8-24 platforms portcfg action [slot/]ve_port options - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 611
Creates a Fibre Channel over IP (FCIP) tunnel. The circuit-specific attributes are optional. An FCIP tunnel may consist of zero or for the remote end of the FCIP tunnel. IPv6 addresses are currently not supported. local_ip_addr Specifies the IP address for the local end of the FCIP tunnel. - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 612
Enables (1) or disables (0) FICON emulation on the specified FCIP tunnel. Optional FICON arguments for fciptunnel create allow you to control specific features including the following: --ficon-xrc 0|1 Enables (1) or disables (0) FICON XRC emulation. FICON XRC Emulation allows XRC (IBM eXtendedRemote - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 613
value will result in poor performance. The value should be chosen based upon the typical tape channel program that requires optimum performance. The the channel. This limits processing to what the network and device can support. Too small a value limits pipelining performance. Too large a value - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 614
Mb (3000000 bytes) The range is 1 Mb-5 Mb. --oxid-base value Defines the base value of an entry pool of 256 OXIDs supplied to emulation-generated exchanges. is 0xF7C80000. This parameter is primarily for use by technical support personnel. Optional FCIP circuit ID 0 arguments for fciptunnel create - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 615
Use this command to configure additional circuits. The circuit-specific parameters are optional. The syntax for portcfg fcipcircuit is local end of the FCIP circuit. IPv6 addresses are currently not supported. The following operands are exclusive: comm_rate Specifies the committed traffic rate - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 616
default value is 8. If tape pipelining is enabled, the default value is calculated based on the minimum retransmit time to ensure that the tunnel does not time out tunnel with a committed rate of 1544 Kbps on a Brocade FX8-24: switch:admin>portcfg fciptunnel 1/12 create 20.10.12.34 20.09.14.57 1000 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 617
delete circuit 1: switch:admin>portcfg fcipcircuit 1/12 delete 1 Operation succeeded Function Synopsis Commands supported only on the existing tunnel. - Create or modify a tunnel with VLAN tagging and Class of Service (CoS). - Create or modify a tunnel with Tape read/write Pipelining enabled or - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 618
for the remote end of the FCIP tunnel. IPv6 addresses are supported on systems running v6.0 or later. src_ipaddr Specifies the IP address for the local end of the FCIP tunnel. IPv6 addresses are supported on systems running v6.0 or later. comm_rate Specifies the committed traffic - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 619
example, "Tunnel 0 to San Jose Office". -c 0|1 Disables If Tape Piplelining is enabled, the minimum supported value is 80. -M 0|1 Enables (0) the default value is calculated based on the minimum retransmit time tunnel with VLAN Tagging and Class of Service (CoS). Specify a vlan_id in the range - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 620
the IEEE 802.1p specification. The range is 0-7. The default is 0. -P L2 CoS Specifies the PL2 Class of Service/Priority for the FCIP configured on the same port. Jumbo frames are not supported on secure tunnels. Only a single route is supported on an interface with a secure tunnel. Modifies the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 621
Supported range is 0-63. Specifies the L2 Class Of Service (COS) Tagging value. Use the portShow fciptunnel geport all -qosmap command to display current values. Supported . Port mirroring can aid in troubleshooting common FC end-to-end communication problems. The command prompts for confirmation - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 622
FCIP) take precedence over entries in this table. NOTE: This command supports --add and --delete options only. To modify a table entry is 1-4094. L2 CoS Specifies L2 Class of Service/Priority, as defined in the IEEE 802.1p specification. The range is 0-7. dst_ipaddr Specified an optional - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 623
byte count of exactly four bytes to be processed as emulated commands during write emulation processes. The following optional parameter-specific arguments are supported with the config and delete options. -a |--wrtMaxPipe value Defines the maximum number of tape write channel commands (CCWs) that - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 624
the channel. This limits processing to what the network and device can support. Too small a value limits pipelining performance. Too large a value bytes) The range is 1 Mb-5 Mb. -o |--oxidBase value Defines the base value of an entry pool of 256 OXIDs supplied to emulation-generated exchanges. - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 625
portcfg fciptunnel8/ge0 create 1 192.168.10.1 192.168.20.1 0 -m 20 -v 100 -p 3 -P 7 Operation Succeeded To modify an existing FCIP tunnel with VLAN tagging: switch:admin> portcfg fciptunnel8/ge0 modify 1 192.168.10.1 192.168.20.1 0 -m 20 -v 100 To create an FCIP tunnel with Fastwrite and read/write - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 626
write Tape Pipelining emulation features enabled using all default parameter arguments: switch:admin> portcfg ficon ge0 1 -x 1 -w 1 Function Synopsis Commands supported only on the Brocade 7500/7500E switches portcfg inbandmgmt ge_port option arguments Description Use this command to configure - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 627
.255.255.0 To add a route to a management station that is on the same subnet as the management interface IP addresses in the previous example: switch:admin> portcfg inbandmgmt ge0 routeadd 192.168.3.0 255.255.255.0 To configure a route for a management station that is on a different subnet (note the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 628
(default) or 0x13. Changes made by this command are persistent across switch reboots and power cycles. Note The execution of this command is subject chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. The Fabric OS port configuration commands are not supported - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 629
unless you specifically enable the feature back into service using the portEnable chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. The Fabric OS port configuration commands are not supported single port: switch:admin> portcfgautodisable --enable 1 To - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 630
0-8 To enable the auto disable feature on a range of ports, some of which were previously enabled. The following example enables port 4. switch:admin> portcfgautodisable --enable 2-4 Same configuration for port 2 Same configuration for port 3 See Also To disable the auto disable feature on a port - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 631
Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. The Fabric OS port configuration commands are not supported on FCoE usage. Examples To enable credit recovery on a port: switch:admin> portcfgcreditrecovery --enable 3/15 See Also To disable credit - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 632
place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. The Fabric OS port configuration commands are not supported on FCoE ports. factory defaults: switch:admin> portcfgdefault 1/3 To reset a GbE port to factory defaults: switch:admin> portcfgdefault - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 633
chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Regardless of how many E_Ports are connected between two switches, the maximum routing paths are limited to 16 E_Ports. The Fabric OS port configuration commands are not supported on FCoE - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 634
by the EX_Port's front phantom domain to request a domain ID from the principal switch. The domain ID received becomes the subsequent preferred domain ID, which is persistent and is displayed. Fabric OS v6.2.0 FCR supports FCR connections to McDATA Open Fabric Mode fabrics operating in 239 domain ID - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 635
The negotiated values are what the edge switch specifies in the ELP request. If the Parameter attribute value is "User configured", the port ID take place and a corresponding error message is displayed. The execution in place. Refer to chapter 1, "Using Fabric OS commands are supported: slotnumber - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 636
2 portCfgEXPort -i mode an error message is posted, and the command fails. Valid values are as to enable IDID, specify 2 to disable IDID. This command must be issued from a McDATA edge switch attached to a single or dual FCR configuration. Examples To set the fabric ID of port 2/1 to 5 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 637
is stored in nonvolatile memory and is persistent across switch reboots or power cycles. Notes This configuration cannot be set on user-configured fill word settings. The execution of this command is subject to Admin Domain or Virtual Fabric restrictions that may be in place. Refer to chapter - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 638
Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. The F_Port buffer feature does not support ports configured as free buffers. Examples To allocate 12 buffers to an F_Port: switch:admin> portcfgfportbuffers --enable 2/44 12 To disable the port - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 639
not set on VE/VEX_Ports. Changes made by this command are persistent across switch reboots or power cycles. Note The execution of this command is subject Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 640
chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. The Fabric OS port configuration commands are not supported ISL R_RDY mode. Examples To enable ISL R_RDY mode on a port: switch:admin> portcfgislmode 1/3, 1 ISL R_RDY Mode is enabled for port 3. Please - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 641
See Also To disable ISL R_RDY mode on a port: switch:admin> portcfgislmode 1/3, 0 configure, portCfgLongDistance, portCfgShow portCfgISLMode 2 Fabric OS Command Reference 611 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 642
distance can vary greatly depending on switch platform and available buffers. Refer to the Fabric OS Administrator's Guide for details on platform-specific buffer credit models, long distance mode support, and maximum distance supported for specific hardware configurations. Notes This command - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 643
given E_Port are automatically configured based on the actual link distance. measured during E_Port initialization. Fabric OS v6.1.0 or later supports up to 3000 km at 1 Gbps, up to 1500 the specified desired_distance value. vc_translation_link_init On switches running Fabric OS v6.2.0 or later - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 644
2 portCfgLongDistance Examples See Also To configure a switch port 63 to support a 100 km link and be initialized using the long distance link initialization protocol: switch:admin> portcfglongdistance 4/15 LS 1 100 switch:admin> portshow 4/15 portCFlags: 0x1 portFlags: 0x20001 PRESENT LED - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 645
Extension blade is inserted into the slot, the configuration is not honored. The system logs a RASLOG error supported on FCoE ports. Use fcoe --cfg to configure FCoE ports. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 646
Recovery Fport Buffers Port Auto Disable where AN:AutoNegotiate, ..:OFF, ??:INVALID, LM:L0.5 See Also To display the L_Port conditions: switch:admin> portcfglport [output from other slots suppressed] Ports of Slot 4 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 Locked L_Port ON ON - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 647
be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is supported only on the Brocade 7800 in optical mode: switch:admin> portcfggemediatype ge1 optical To display the current configuration: switch:admin> portcfggemediatype ge1 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 648
with all fabric services. The following conditions must be met for a switch port to respond per switch can be configured with the configure command. Refer to the Fabric OS Administrator's Guide for restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 649
ON ON Fport Buffers .. .. .. ON ON Port Auto Disable (output truncated) To disable NPIV functionality on port 7: switch:admin> portcfgnpivport 7 0 To verify the change: switch:admin> portcfgshow 7 Area Number: Speed Level: Fill Word: AL_PA Offset 13: Trunk Port Long Distance VC Link Init - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 650
automatically comes online if it is connected to an enterprise fabric switch that supports NPIV. Notes NPIV capability should be enabled on the ports connected to the Access Gateway. Use portcfgnpivport to enable NPIV capability on the specific port. By default, NPIV is enabled by default on all - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 651
commands do not enable a specific port or ports alone, but these commands succeed on a switch with one or more persistently be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is not supported on FCoE ports. To disable - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 652
to be persistently disabled. Port index ranges are supported only if PortSwap is disabled. Examples To disable a single port persistently: switch:admin> portcfgpersistentdisable 2/4 To disable a range of ports persistently: switch:admin> portcfgpersistentdisable 2/4-8 To disable multiple port - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 653
window. Persistently enabled ports remain enabled across power cycles, switch reboots, and switch enables. By default, a port is enabled persistently, place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is not supported on FCoE ports. - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 654
17-18 To enable multiple ports persistently by specifying multiple port index ranges: switch:admin> portcfgpersistentenable 17-18 30-39 To display the persistently enabled ports on the switch: switch:admin> portcfgpersistentenable Slot 9 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 Enabled YES YES - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 655
enable or disable Adaptive Networking/Quality of Service (AN/QoS) on a port, that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix Fabric OS port configuration commands are not supported on FcoE ports. Use fcoe --cfg enabled by best effort based on availability of buffers. - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 656
at 2 Gbps, no enforcement is needed. Specify an ingress rate in Mbps. Supported values for ratelimit are: 200, 400, 600, 800, 1000, 1500, 2000 usage. Examples To enable QoS on a port. switch:admin> portcfgqos --enable 3/15 To disable QoS on a port. switch:admin> portcfgqos --disable 3/15 To set the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 657
of this command is platform-specific; output varies depending on port type and platform, and not all options are supported on all platforms. "Non displays port configuration settings for all ports on a switch, except Gigabit Ethernet (GbE) ports. "Displays supported on the Brocade 7800 /FX8-24 and on - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 658
dynamically. LS The distance is determined statically by user input. This value is set by the portCfgLongDistance the portCfgNPIVPort command. Displays ON when Quality of Service (QoS) is enabled on the E_Port (or . In the AE state, QoS is enabled based on the availability of buffers. Use islShow to - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 659
Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. The Fabric OS port configuration commands are not supported on FcoE options and optional arguments to display specific FCIP-related parameters configured for a GbE port: Fabric OS Command Reference - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 660
IP interface for both ports of the tunnel. IPv6 addresses are supported on the Brocade 7500/7500E and FR4-18i platforms, but not To display the port configuration settings for all ports on a Brocade DCX enterprise class platform: switch:admin> portcfgshow Ports of Slot 1 0 1 2 3 4 5 6 7 8 9 10 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 661
portCfgShow 2 Trunk Port ON ON ON ON Long Distance .. .. .. .. VC Link Init .. .. .. .. Locked L_Port .. .. .. .. Locked G_Port .. .. .. .. Disabled E_Port .. .. .. .. ISL R_RDY Mode .. .. .. .. RSCN Suppressed .. .. .. .. Persistent Disable.. .. .. .. NPIV capability - - - - QOS - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 662
: Rate Limit F_Port Buffers 8 AUTO(HW) 0(Idle-Idle) ON OFF OFF ON AE OFF OFF OFF To display the configuration settings for all ports on a switch with Access Gateway enabled: Ports of Slot 0 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 Speed AN AN AN AN AN AN AN AN AN AN AN - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 663
00:00:05:1e:41:4a:45 "Tom_100" (fabric id = 25 )(Trunk master) switch:admin> portcfgshow 16 Area Number: 11 Speed Level: AUTO(HW) Fill Word: 0(Idle the portCfg help page for an explanation of the displayed parameters): switch:admin> portcfgshow 12/ge0 Mode: FCIP Persistent Disable: OFF - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 664
2 portCfgShow Iproute Configuration: IP Address Mask Gateway Metric IPv6ddress Len Gateway Metric Fciptunnel configuration: IPV4 FCIP TUNNEL(S) Tunnel ID 0 Remote IP Addr 192.168.100.40 Local IP Addr 192.168.100.50 Remote WWN Not Configured Local WWN 10:00:00:05:1e:40:68:78 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 665
VLAN tagging configured on a Brocade FR4-18i FC Router blade (refer to the portCfg help page for an explanation of the displayed parameters): switch: admin> portcfgshow vlantag 8/ge0 Port: 8/ge0 IpIfAddress VlanId L2 CoS Dest IP Address Flags 192.168.10.1 100 7 192.168.10.1 App 192 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 666
memory and is persistent across switch reboots or power cycles. Use the portShow command levels. Use the portCfgShow command to display user-specified speed settings. Notes This configuration cannot restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 667
ports of a switch. When the chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. The Fabric OS port configuration commands are not supported support frame-based trunking . If trunking is enabled for one of these ports in a slot, and a Brocade FX-24 Extension - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 668
enabled and the state is "OK", the edge fabric principal switch's domain ID and WWN also are displayed. If the Fabric enabled. If the Fabric Parameter attribute value is "User configured", port ID format, R_A_TOV, and E_D_TOV error message is displayed. 638 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 669
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and compared to the online ports. If the modes are different, an error message is displayed, and the command fails. Valid values are display the VEX_Port configuration of port 2/16: switch:admin> portcfgvexport 2/16 Port 2/16 Admin - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 670
set the fabric ID of port 2/21 to 5 and the port ID format to core: switch:admin> portcfgvexport 2/21 -f 5 -p 1 To configure port 2/20 as a VEX_Port and set the fabric ID to 4: switch:admin> portcfgvexport 2/20 -a 1 -f 4 See Also To disable fabric parameter negotiation on port 2/20 of a VEX_Port - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 671
in bytes and includes the IP header and payload. There is limited support for black hole PMTU detection. PTMUs of decreasing size are sent: Jumbo maintained by the ipperf application. The following portcmd features are platform-specific: Tperf Brocade FX-24 and 7800 only. VLAN tagging Brocade - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 672
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix which to probe the IP router path. -S Instructs the source mode to initiate the TCP connection. . This characterizes the end-to-end IP path performance based on the data rate configured for a tunnel between the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 673
application. See the portCfg help page for details on creating a VLAN tag table. VLAN tagging is currently not supported on the Brocade Extension platforms. -c L2 Class-of-Service Specifies Class of Service/Priority, as defined by IEEE 802.1p. Values must be in the range 0 to 7. The default is - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 674
not supported on the Brocade 7800 and FX-24. -c L2 Class-of-Service Specifies Class of Service/Priority, as defined by the IEEE 802.1p specification. Values sent by the switch acting as the data source. The process continues to run until it is either terminated by user intervention (Ctrl +C) - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 675
portCmd 2 bytes rx Number of bytes received. PDUs tx Number of protocol data units transmitted. PDUs rx Number of protocol data units received. bad CRC headers rx Number of bad CRC headers received. bad CRC payloads rx Number of bad CRC payloads received. out of seq PDUs rx Number of out- - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 676
3 To create a TPerf data sink on VE_Port 16: switch:admin> portcmd --tperf 16 -sink TPerf has been configured successfully for 16 TPerf is servicing requests on 16 priority: high TPerf is servicing requests on 16 priority: medium TPerf is servicing requests on 16 priority: low Tperf data source can - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 677
priority traffic with a random PDU size from 0 to 10112 bytes (1 MSS) and with a payload pattern determined by previous settings saved in memory: switch: admin> portcmd --tperf 16 -source -high -low -random TPerf has been configured successfully for 16 TPerf is generating traffic on 16 priority - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 678
to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details and verbose level of port modules: switch:admin> portdebug 3 4 See Also dbgShow 648 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 679
or a range of ports. If the port is connected to another switch when disabled, the fabric may reconfigure. Devices connected to this port can in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is not supported on FCoE ports. To - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 680
disable a range of ports by specifying the corresponding port index range: switch:admin> portdisable 170-176 To disable multiple ports by specifying multiple port index ranges: switch:admin> portdisable 30-36 170-176 portCfgPersistentDisable, portCfgPersistentEnable, portEnable, portShow, switchShow - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 681
: RSCN, SNMP trap, Web pop-up window. This command fails if the switch is disabled, the port's blade is not fully enabled (faulted, powered off in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is not supported on FCoE ports. To - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 682
> portenable 170-176 portenable: portSwap feature enabled. To enable multiple ports by specifying multiple port index ranges: switch:admin> portenable 30-36 170-176 portenable: portSwap feature enabled. portCfgPersistentDisable, portCfgPersistentEnable, portDisable, portShow, switchShow 652 Fabric - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 683
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To display error counters for ports on a switch: switch:admin> porterrshow frames enc crc crc too too bad enc disc - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 684
2 portErrShow 8: 527k 44k 0 0 0 0 0 0 32 0 7 6 9 0 0 9: 38m 37k 0 0 0 0 0 0 29 0 7 6 10 0 0 10: 34 38 0 0 0 0 0 0 12 0 0 4 8 0 0 11: 0 0 0 0 0 0 0 0 39k 0 39k 6.6k 13k 0 0 12: 777 37 0 0 0 0 0 0 13 0 0 5 10 0 0 13: 2.2k 38 0 0 0 0 0 0 12 0 0 5 10 0 0 14: 0 0 0 0 0 0 0 0 0 0 0 0 4 0 0 15: 0 0 0 0 0 0 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 685
errors for a certain Fabric Watch area. Supported port types include E_Ports, F_Ports, and physical ports. A specified port type can be configured to report errors or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 686
:admin> portFencing --enable e-port -area_type CRC To display the current port fencing configuration: switch:admin> portFencing --show Port type Error PF Status e-port CRC Enabled ITW Disabled Link reset Disabled C3_TO Disabled See Also fwConfigure, fwHelp 656 Fabric OS Command - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 687
restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the port status for all ports in the switch: switch:user> portflagsshow Slot Port SNMP Physical Flags 1 0 Online - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 688
be in place. Refer to chapter 1, "Using Fabric OS commands" and legacy reasons only and is longer supported on most current platforms. On switches, the command is still allowed to run, but may not run without errors user ports on which to run the test. If omitted, all the active ports in the switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 689
are preserved, but new events are not collected. The following errors disable the port log: FCPH, EXCHBAD FCPH, EXCHFREE NBFSM, chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands None Examples To clear the port log: switch:admin> portlogclear switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 690
. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the current port log configuration - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 691
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the port log facility: switch:admin> portlogdisable See Also portLogEnable Fabric OS Command Reference 661 53 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 692
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command This operand is optional. Examples To display the port log for a port: switch:user> portlogdump 20 time task event port cmd args 08:35:27.899 tShell pstate - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 693
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" the port log. Examples To display the port log dump for a port: switch:user> portlogdumpport 14 time task event port cmd args 08:35:27.899 tShell - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 694
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To enable the port log facility: switch:admin> portlogenable See Also portLogDisable 664 Fabric OS Command Reference 53 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 695
Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command for details. Operands none Examples To display information about port log events: switch:admin> portlogeventshow ID Event-Name Disabled 1 start 0 2 disable 0 3 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 696
Service Parameters or Virtual N_Port login. fe FLOGI, Fabric Login to Fabric F_Port. ff PLOGI, Port Login to specific Services supported. This can be a combination of the following bits: 4 Class 2 is supported. 8 Class 3 is supported chapter and two PLOGIs): switch:admin> portloginshow 23 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 697
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for the debug_pdisc_flag. The default is 0. Examples To set the debug_pdisc_flag: switch:admin> portlogpdisc 1 PDISC log setting = 1 See Also none - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 698
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To enable the port log: switch:admin> portlogreset See Also none 668 Fabric OS Command Reference 53-1001337 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 699
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for 768. Examples To resize the portlog: switch:admin> portlogresize 17288 See Also portLogConfigShow Fabric OS Command Reference 669 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 700
entries replace the oldest ones. The port log captures switch-to-device, device-to-switch, switch-to-switch, some device-to-device, and control information. If ctin A CT based request is received. ctout A CT based response is transmitted. errlog A message is added to the error log. loopscn - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 701
read operation. Indicates an information unit header log from a write operation. Indicates an information unit header log of an FC error frame. Indicates a Fibre Channel frame payload. Indicates an interswitch name server query. Indicates a Registered State Change Notification. Allocates an exchange - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 702
is valid, 0003 means arguments 1 and 2 are valid). [B] the CT-based service command code. Argument 1 is the first word of the CT payload, if reject, argument 1 contains the CT reject reason and explanation code. errlog Error type (refer to errShow). loopscn The meaning further depends on each - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 703
portLogShow 2 2 Offline 3 Testing 4 Faulty 5 E_Port 6 F_Port 7 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 OL1 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 704
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability . This operand is optional. Examples To view the port log for a port: switch:user> portlogshow 24 time task event port cmd args 17:05:30.384 PORT Rx - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 705
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" to display the log. Examples To display the port log for port 14: switch:user> portlogshowport 14 time task event port cmd args 08:35:28.483 tFabric scn - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 706
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details values corresponding to supported log types. Examples To disable logging of type 2 port log events: switch:admin> portlogtyedisable 2 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 707
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for of values corresponding to supported log types. Examples To enable logging of type 2 port log events: switch:admin> portlogtypeenable 2 See - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 708
switch. The portLoopbackTest and ceePortLoopbackTest commands are platform-specific Checks if any of the following eight statistic error counters report nonzero values: ENC_in, CRC_err, TruncFrm This command does not support High Availability (HA). 678 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 709
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and a functional test in default mode: switch:admin> portloopbacktest Running portloopbacktest Test Complete or more of the following error messages. If errors persist, contact Technical Support. DATA Data received does not - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 710
were found in the ASIC statistics. Port failed to initialize. A previously initialized port went to an uninitialized state. Errors were found in the ASIC statistics. Did not receive a frame in the given timeout period. Frame transmission failure. 680 Fabric OS Command Reference 53-1001337- - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 711
based platforms (including the Brocade 300, 5300, and most embedded switches) can participate only in one mirror connection if Virtual Fabrics are enabled on the switch. If Virtual platforms are disabled on these platforms, they can support an "order of delivery" error between the SourceID and DestID - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 712
all platforms. Refer to the Fabric OS Administrator's Guide for more information. In Fabric OS v6.3.0 and later, the port mirroring feature is supported in Virtual Fabric mode so long as the FC Routing service is not enabled on the logical switch. Use the fosConfig command to disable the FC Routing - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 713
2 See Also To add a port mirror connection between two local switch ports: switch:admin> portmirror --add 2/1 0x011400 0x012400 To add a port mirror connection between a local switch port and a remote switch port: switch:admin> portmirror --add 2/1 0x011400 0x240400 To delete a port mirror - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 714
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" . Examples To name a port tape drive 8: switch:admin> portname 1/3, "Tape drive 8" switch:admin> portname 1/3 Tape drive 8 See Also configDefault - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 715
Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command bandwidth. -tx -rx Displays the transmitter and receiver bandwidth. Examples To display port throughput for a switch: switch:user> portperfshow 20 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 716
00 00 00 4.00 4.00 00 00 00 00 2.00 2.00 00 00 2.00 2.00 switch:user> portperfshow -tx 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 00 00 00 4.00 00 00 2.00 00 2.00 To obtain bandwidth information at a 2 second interval: switch:user> portperfshow -tx -rx 2 0 1 2 3 4 5 6 7 4.00 4.00 00 00 00 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 717
ASIC pair. The arrangement of ports on an ASIC pair is specific to the system type. For any active port, this table or set of looped devices) attached to the local switch. The format of ports_bitmap is the same as the that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 718
2 portRouteShow Examples See Also To display the routing tables for a port: switch:user> portrouteshow 4/15 port address ID: 0x02bf00 external unicast routing table: 1: 0x4 (vc=3) 2: 0x10000 (vc=0) internal unicast routing table: 60: 0x8000 (vc=2) 63: 0x1000 (vc=5) broadcast - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 719
specific section. To display command usage on the switch, use portShow [action]. Notes The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter General port status display commands (supported on all platforms) portshow [slot - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 720
2 portShow The following general information is displayed when the command is issued for a non-GbE port without additional arguments: portName Name assigned to the port by the portName command. portHealth Current health of the port (requires a Fabric Watch license). Authentication - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 721
In the case of LD mode, the user configured distance and actual distance also are displayed. DH-CHAP is the only authentication type supported on EX_Ports. DH Group Displays DH group primary WWN If the EX_Port is connected to an edge switch with FCS policy enforcement, the WWN of the primary FCS - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 722
and fcoe --loginshow to display FCoE-specific configuration details. If the port is configured errors. 2_parity_err Secondary transmission parity errors. CMI_bus_err Control message interface errors. The second column displays link error state of a port: switch:admin> portshow 6 portName: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 723
: 0 Parity_err: 0 Ols_in: 0 2_parity_err: 0 Ols_out: 4 CMI_bus_err: 0 Port part of other ADs: No switch:admin> To display the state of a VE_Port on a chassis with an FX8-24 Extension blade: switch:admin> portshow 16 portName: portHealth: No Fabric Watch License Authentication: None - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 724
To display port status for a 1 GbE port on a Brocade 7800 Extension switch: switch:admin> portshow ge2 Eth Mac Address: 00.05.1e.54.b1.17 Front Phantom: State: OK Cur Dom ID: 160 WWN: 50:00:51:e3:60:ee:0e:14 Pr Switch Info: Dom ID: 5 WWN: 10:00:00:05:1e:34:02:04 Fabric params: R_A_TOV: 10000 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 725
part of other ADs: No To display an FCoE port: switch:admin> portshow 11/1 portName: portHealth: HEALTHY Authentication: None IPv6 addresses are not supported in the Fabric OS v6.3.0 release. You can display the content of the ARP table on the Brocade Extension platform but you cannot - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 726
the Brocade 7500/7500E and FR4-18i. Examples To display the IP Interface and static route configured on a chassis with a Brocade FX8-24 Extension blade: switch:admin> portshow ipif 11/ge1 Slot: 11 Port: ge1 Interface IP Address NetMask Effective MTU Flags 0 10.10.11.200 255.0.0.0 1500 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 727
Created(Interface) S=Static L=LinkLayer(Arp) To display the IP Interfaces and static routes configured on a chassis with an FR4-18i FC Router blade: switch:admin> portshow ipif 10/ge0 Interface IP Address NetMask MTU Flags 0 192.168.60.100 255.255.255.0 2200 32833 Interface IP Address - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 728
extension switch: switch:admin> portshow arp ge1 Port: ge1 IP Address Mac Address Flags 192.168.1.100 00:05:1e:54:b1:16 Resolved 192.168.1.101 00:05:1e:54:b1:16 Resolved switch :05:1e:37:0f:a5 Permanent Resolved Function Commands supported only on the Brocade 7800 and the Brocade FX8- - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 729
-help level -port Displays FICON and FCP emulation statistics and current runtime conditions for a specified set of parameters. The following arguments are supported: Displays the SCSI Fastwrite/Tape Pipelining command sub-menu. The syntax for -fcp is as follows: portshow xtun [slot/]\ve_port -fcp - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 730
command] [options] The following optional commands are supported with -ficon; if omitted, the usage for all parameters is displayed. -help Displays the command usage. -stats Displays FICON statistics. -fdpb adrs Displays FICON ports or a specific FICON Device Path Block. -fchb adrs Displays - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 731
information. The following additional option is supported. -clear Resets the specified statistics. FCIP tunnel configuration parameters on the Brocade 7800: switch:admin> portshow fciptunnel 16 Tunnel ID: 16 Base: 0x8000 FICON Debug Flags: 0xf7c80000 Fabric OS Command Reference 701 53-1001337- - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 732
WWN: 10:00:00:05:1e:55:68:05 Circuit Count: 4 Flags: 0x00000000 FICON: Off To display an FCIP tunnel with additional circuit information: switch:admin> portshow fciptunnel 17 -c Tunnel ID: 17 Tunnel Description: Admin Status: Enabled Oper Status: Up Compression: On (Moderate) Fastwrite: Off Tape - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 733
Circuit ID: 17.1 Circuit Num: 1 Admin Status: Enabled Oper Status: Up Remote IP: 100.83.0.101 Local IP: 100.80.0.101 Metric: 0 Min Comm Rt: 150000 Max Comm Rt: 150000 SACK: On Min Retrans Time: 100 Max Retransmits: 8 Keepalive Timeout: 5000 Path MTU Disc: 0 VLAN ID: 0 L2CoS: F: 0 H: 0 M: 0 L: 0 DSCP - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 734
21 Bps Lifetime Avg 2754 Input Packets 0 pkt/s 30s Avg, 0 pkt/s Lifetime Avg To display TCP connections for the circuits on the tunnel: switch:admin>portshow fciptunnel 17 -c --tcp Tunnel ID: 17 Tunnel Description: Admin Status: Enabled Oper Status: Up Compression: On (Moderate) Fastwrite: Off Tape - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 735
portShow 2 Admin Status: Enabled Oper Status: Up Remote IP: 101.83.0.110 Local IP: 101.80.0.110 Metric: 0 Min Comm Rt: 150000 Max Comm Rt: 150000 SACK: On Min Retrans Time: 100 Max Retransmits: 8 Keepalive Timeout: 5000 Path MTU Disc: 0 VLAN ID: 0 L2CoS: F: 0 H: 0 M: 0 L: 0 DSCP: F: 0 H: 0 M: 0 L: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 736
TCP Conn 17.0:68740859 |---> TCP Conn 17.0:68740782 |---> TCP Conn 17.0:68740705 To display all FCIP circuits on the Brocade 7800: switch:admin> portshow fcipcircuit all Tunnel Circuit OpStatus Flags Uptime TxMBps RxMBps ConnCnt CommRt Met 16 0 ge0 Up ----s 7h35m30s 0.00 0.00 3 150 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 737
0.00 3 150/150 0 21 3 ge5 Up ----s 7h34m58s 0.00 0.00 3 150/150 0 Flags: circuit: s=sack To display a single circuit (circuit 1 on tunnel 20): switch:admin> portshow fcipcircuit 20 1 Circuit ID: 20.1 Circuit Num: 1 Admin Status: Enabled Oper Status: Up Remote IP: 104.83.0.141 Local IP - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 738
Input Bytes 0 Bps 30s Avg, 4 Bps Lifetime Avg 757 Input Packets 0 pkt/s 30s Avg, 0 pkt/s Lifetime Avg To display QoS prioritization for a circuit: switch:admin> portshow fcipcircuit 20 1 --perf --qos Circuit ID: 20.1 Circuit Num: 1 Admin Status: Enabled Oper Status: Up Remote IP: 104.83.0.141 Local - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 739
Packets 0 pkt/s 30s Avg, 0 pkt/s Lifetime Avg To display FCP emulation statistics using the command with two levels and a single command: switch:admin> portshow xtun 1/13 -fcp -itl -itn -stats To display FCP emulation statistics, information, and configuration information using the command with - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 740
= 1 Current Read FDCBs Count = 0 Max Concurrent Read FDCB Count = 0 Current Read Limited FDCB Count = 0 To display the FICON Device Path Blocks: switch:admin> portshow xtun 16 -ficon -fdpb FDPB (FICON Device Path Block - one per path) Count = 1 (0x) Side Path: FastP Emul Type Tag - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 741
configuration parameters and status information for FCIP tunnels on the Brocade 7500/7500E FC Router switch and on the FR4-18i FC Router blade. The following display options are supported only on these platforms: • portShow fciptunnel - Displays Fibre Channel over IP (FCIP) tunnel configuration - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 742
2 portShow In Fabric OS v6.2.0 and later, each GbE port is associated with a TCP history, which tracks the state of statistics at the moment of a TCP connection failure. An entry is logged for the TCP connection when it encounters any of the following failures: • Maximum number of retransmits is - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 743
parameters related to the Byte Streaming feature. Byte streaming allows the Brocade switch to communicate with third party WAN optimization hardware. Refer to portCfg for RTT perceived in FCIP. Operands This command supports the following operands: Fabric OS Command Reference 713 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 744
for tportshow ficon is as follows: portshow ficon [Slot/] ge_port all | tunnel_Id [arg] [parm] [-clear] The following arguments are supported with ficon: -globals Displays general FICON controls and statistics. -images Displays discovered Images (FCUB). -emul Displays emulated FDCBs. 714 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 745
inbandmgmt Displays active FDCBs. Displays Emulation Control Block (port specific). Displays FICON Host Path Block. Displays FICON Device Path To display the connection parameter information for all FCIP tunnels on the switch and to show the current DiffServ markings being used for data connection - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 746
2 portShow VC QoS Mapping off DSCP Marking (Control): 0, DSCP Marking (Data): 0 VLAN Tagging Not Configured TCP Byte Streaming on Status : Inactive Connected Count: 0 Port: ge1 Tunnel ID 0 Tunnel Description "This is a test Description of this tunnel" Remote IP Addr 192.168.10.10 Local IP Addr - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 747
: time since last activity detected 0 s idle connection probe interval 1 s timeout 10 s To display the performance information on an FCIP tunnel: switch:admin> portshow fciptunnel 9/ge0 0 -perf Slot: 9 Port: ge0 Tunnel ID 0 Tunnel Description "This is a test Description of this tunnel" Remote - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 748
avg IKE Policy 1 IPSec Policy 1 Pre-Shared Key testingFIPSandIPSec To display the connection IPSec information on an FCIP tunnel on a GbE port: switch:admin> portshow fciptunnel 9/ge0 0 -ipsec Slot: 9 Port: ge0 Tunnel ID 0 Tunnel Description "This is a test Description of this tunnel" Remote IP - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 749
the TCIP connection history after the connection was severed: Switch:admin> portshow fciptunnel ge1 0 -hist Port: ge1 Tunnel May 29 17:03:10 2008| To display a snapshot of the TCP statistics: Switch:admin> portshow fciptunnel ge1 0 -snapshow Port: ge1 Tunnel ID 0 Tunnel Description "This - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 750
Rtx Rtx TO| | 0 CONTROL 4097 3225 0 0 0 0| | 0 0 0 2 0 0 0| | 0 DATA 4098 3226 0 0 0 0| | 0 0 0 1 0 0 0| To reset the TCIP statistics: Switch:admin> portshow fciptunnel ge1 0 -snapstart Port: ge1 Tunnel ID 0 Tunnel Description "This is a test Description - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 751
minutes, 26 seconds TCP data and control statistics snapshots have been reset for tunnel 0 To display the FC data path credit data: switch:admin> portshow fciptunnel 9/ge0 0 -credits Slot: 9 Port: ge0 Tunnel ID 0 Tunnel Description "This is a test Description of this tunnel" Remote IP Addr - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 752
11 3 3 15 3 4 19 3 5 23 3 6 27 0 7 31 0 8 35 0 9 39 0 10 43 4 11 47 4 12 51 4 13 55 4 14 59 4 15 63 0 To display Byte Streaming parameters: switch:admin> portshow fciptunnel ge1 0 -bstr Port: ge1 Tunnel ID 0 Remote IP Addr 192.168.32.2 Local IP Addr 192.168.32.1 Remote WWN Not Configured - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 753
.168.32.1:4130, Remote 192.168.32.2:3226 To display FICON EPCB for a GbE port 0 tunnel ID 1 with post display clearing of relevant statistics: switch:admin> portshow ficon ge0 1 -epcb -clear To display a list of discovered devices and selected path and status information on each. Get the adrs from - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 754
2 portShow See Also To display the routes that use internal management interfaces. switch:admin> portshow iproute ge1 Port: ge1 IP Address Mask Gateway Metric 192.168.112.0 255.255.255.0 192.168.112.61 0 Interface 192.168.255.0 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 755
er64_toolong Number of frames longer than maximum. er_bad_eof Number of frames with bad end-of-frame. er64_enc_out Number of encoding error outside of frames. er64_disc_c3 Number of class 3 frames discarded. stat64_rateTxFrame Tx frame rate (frames/second). stat64_rateRxFrame Rx frame rate - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 756
chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is not supported port: switch:user> errors inside of frames 0 bottom_int : Encoding errors inside of frames er64_crc 0 top_int : Frames with CRC errors 0 bottom_int : Frames with CRC errors - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 757
bad end-of-frame 0 bottom_int : Frames with bad end-of-frame er64_enc_out 0 top_int : Encoding error outside of frames 9131157 bottom_int : Encoding error outside of frames er64_disc_c3 0 top_int : Class 3 frames discarded 0 bottom_int : Class 3 frames discarded stat64_rateTxFrame 17 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 758
based performance monitor statistics. interswitch link (ISL) monitor statistics are not cleared by this command. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter a port: switch:admin> portstatsclear 4/15 See Also - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 759
to the attached device for 2.5 µs, indicating degraded performance (platform- and port-specific). er_enc_in The number of encoding errors inside frames. er_crc The number of frames with cyclic redundancy check (CRC) errors. er_trunc The number of frames shorter than the minimum frame length - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 760
. er_lun_zone_miss The number of frames with logical unit number (LUN) zoning miss. er_crc_good_eof The number of CRC errors with good end-of-frame (EOF) (platform- and port-specific). er_inv_arb The number of invalid arbitrated loops (ARBs). open The number of times the FL_Port entered OPEN - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 761
data checksum errors observed on the GbE port. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is not supported on FCoE - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 762
statistics on all FCIP tunnels. This operand is not supported on the Brocade 7800 and FX8-24 platforms. Optionally port 13 on a DCX backbone: switch:admin> portstatsshow 13 stat_wtx 1979747673 4-byte bad end-of-frame er_enc_out 71 Encoding error outside of frames er_bad_os 459786 Invalid - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 763
To display port statistics for all IP addresses, slot 8, and GbE port 1: switch:admin> portstatsshow ip 8/ge1 ip_err_crc ip_err_hdr_cksum ip_err_tcp_data_chksum 0 IP CRC Errors 0 IP Checksum Errors 0 IP TCP Data Checksum Errors To display port statistics for IP address 192.168.255.10, slot 8, and - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 764
GE lost carrier sense GE invalid length GE CRC Errors GE abort frames GE overruns GE Fifo overflow To display port statistics for a VE_Port with an active FCIP tunnel on a Brocade 7800 Extension switch: switch:admin> portstatsshow 16 stat_wtx 0 stat_wrx 0 stat_ftx 0 stat_frx 0 stat_c2_frx - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 765
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for systems. Examples To swap area numbers between a pair of ports: switch:admin> portswap 1/3 2/5 portswap done See Also portDisable, portEnable, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 766
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To disable the portswap feature: switch:admin> portswapdisable See Also portSwap, portDisable, portEnable, portShow - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 767
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To enable the portswap feature: switch:admin> portswapenable See Also portSwap, portDisable, portEnable, portShow - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 768
number. The default area number of a port is the same as its switch port number. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 769
Use this command to isolate problems in a single replaceable element and to trace problems to near-end terminal equipment, switch. Ports that are not on the default switch cannot be tested. Valid port connections for this test are: • From the default switch to legacy switches that do not support - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 770
chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operands: -ports itemlist Specifies the list of user ports to test. By default, all user ports in the switch to view the patterns supported with portTest. For each - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 771
• portTest stop time. • Timeout value. • Error code, if any. Note The execution of this be in place. Refer to chapter 1, "Using Fabric OS commands user ports in the current slot is assumed. Refer to the itemList help page for further details. Examples To display information from portTest: switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 772
Fabric Watch, this command supports monitoring Class 3 discard frames on all ports of a specified type. If frame discard errors or any other configured Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 773
specific area high/low thresholds, refer to the Fabric Watch Administrator's Guide F_Ports. Configuring copper F_Ports is currently not supported. -area area port Configures or displays LF Link failure RX Receive error TX Transmit error PE Protocol error LR Link reset ST State change - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 774
with the --set option. Defaults for these parameters vary depending on the area and platform. Refer to the Fabric Watch Administrator's Guide for specific details. -timebase time_base Specifies the time interval between two samples to be compared. Valid values for time_base are: day Samples are - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 775
use --set with the -nosave option and the switch reboots your changes will be lost. --apply Configuring copper F_Ports is currently not supported. -area area port Applies configuration -port area ve_port_area. -action_level default | custom Instructs Fabric Watch to use the default or custom - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 776
--apply port -area crc -action cust -thresh_level custom To display the port threshold configuration for all port types and areas: switch:admin> portthconfig --show PortType: E-port Area : CRC ThLevel : Def ActLevel: Def High : Custom: TimeBase: Minute Value : 1000 Trigger : Above Action - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 777
0 Trigger : Above Action: None Trigger : Below Action: None (output truncated) To display threshold configuration and current status for E_Port CRC errors: Switch:admin> portthconfig --show e-port -area crc PortType: E-port Area : CRC ThLevel : Def ActLevel: Def High : Custom: TimeBase: Minute Value - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 778
: Below Action: None Buffer: Custom: Value : 100 Default: Value : 100 To display current values for all port types and areas: Switch:admin> portthConfig --show -current PortType|Area |PortNo|C# |Value |State E-port |CRC |000005|n/a |0 |Info E-port |CRC |000007|n/a |0 |Info E-port |CRC - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 779
Port |CRC |000020|n/a |0 |Info Port |CRC |000021|n/a |0 |Info Port |CRC |000022|n/a |0 |Info To display current values for CRC errors on all Fop-ports: switch:admin> portthconfig --show fop-port -area CRC -current PortType|Area |PortNo|C# |Value |State FOP-port|CRC |000019|n/a |0 |Info - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 780
trunking interoperates between the Access Gateway (AG) and Condor-based platforms. It is designed to (1) prevent reassignments of virtual of the trunk group. TA On standalone switches, displays the user assigned TA number. DA On standalone switches, displays the default port area. The default - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 781
to enable Trunking on a port or on all ports of a switch. 7. N_Port ID Virtualization (NPIV) support is provided for up to 255 devices per TA. Note that this 's Guide. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 782
F_Port trunking is enabled). disabled Displays configuration details for all ports not included in a user assigned TA (all portson which masterless F_Port trunking is notenabled). all Displays configuration details for all ports on a switch. 752 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 783
porttrunkarea --disable 10-11 ERROR: port 11 has to be disabled Disable each port prior to removing ports from the TA. Then reissue the command: switch:admin> porttrunkarea --disable 10-11 Trunk area 11 disabled for ports 10 and 11. To display trunk details for a user assigned TA 38 that includes - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 784
10 13 -- -- -- 125 125 10 14 -- -- -- 125 126 4. Enable ports 13 and 14: switch:admin> portenable 10/13 switch:admin> portenable 10/14 5. Show the TA port configuration after enabling the ports: switch:admin> porttrunkarea --show enabled Slot Port Type State Master TI DI 10 13 F-port - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 785
Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the zone membership information of ports: switch:user> portzoneshow [OUTPUT TRUNCATED] PORT: 160 (160) Offline PORT: 161 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 786
each slot. Whenever a power supply goes out of service or a field-replaceable unit (FRU) RU is that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix none Examples To modify the power-off list order: switch:admin> powerofflistset Slot Current POL 10 1st 9 2nd - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 787
powerOffListSet 2 See Also 2nd slot to be powered off: (2..10) [9] 2 3rd slot to be powered off: (3..10) [8] 3 4th slot to be powered off: (4..10) [7] 4 5th slot to be powered off: (7..10) [7] 10 6th slot to be powered off: (7..9) [8] 9 7th slot to be powered off: (7..8) [8] 8 8th slot to be - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 788
. Whenever a power supply goes out of service or a field-replaceable unit (FRU) is restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, Examples To display the slot power off list order: switch:admin> powerofflistshow Slot 10 will be powered off 1st - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 789
, fuse blown, or other internal error). For certain switch models, the OEM serial ID data displays after each power supply status line. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 790
switches configured. After the Standby CP boots up, HA is still disabled. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter : switch:admin> reboot This command is being run on a control processor (CP) based system - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 791
to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. To display a list of routing-related commands: switch:admin> routehelp aptpolicy bcastshow dlsreset dlsset dlsshow fspfshow - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 792
switches running earlier versions of Fabric OS (up to v5.3.0), the maximum size is 256 Kilobytes. Notes The effective security DB size is the lowest supported or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 793
effective with the next authentication request. The configuration applies to a switch instance only. Note The execution of this command is subject to Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 794
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 -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] - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 795
switch, including Public Key Infrastructure (PKI) based supports IPV4 and IPV6 addresses. Use this command to do the following: • Generate a public/private key pair. • Delete a public/private key pair. • Generate a CSR. • Delete a CSR. • List existing certificates on a switch to chapter 1, "Using - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 796
locality locality Specifies the city. Provide the full name, for example, "San Jose". If the locality consists of multiple words, it must be Domain Name, or IP address. showcsr Displays the content of the CSR on the switch without page breaks. Use the pipe operator followed by the "more" option to - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 797
login name for the server. -password password Specifies the password for the user account. When using SCP, for security reasons, do not enter a is omitted, you are prompted for confirmation before importing an invalid switch certificate, however, you will be able to import the invalid certificate - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 798
password Specifies the password for the user account. When using SCP, for security all existing PKI-based certificates on the switch. The following operands a CSR in non-interactive mode: switch:admin> seccertutil gencsr -country US -state California -locality "San Jose" \ -org Brocade -orgunit - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 799
-ipaddr 195.168.38.206 \ -remotedir /users/home/remote_certs -certname ldap.cer -login abcd -passwd passwd Success: imported certificate [ldap.cert]. To import a PKI-based certificate with configure and enable option in interactive mode: switch:admin> seccertutil import -config swcert -enable https - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 800
-ldapcacert -protocol ftp -ipaddr 192.168.38.206 \ -remotedir /users/home/remote_certs -login abcd -passwd passwd -certname ldap.cer Success: exported LDAP certificate To delete an LDAP CA certificate in interactive mode: switch:admin> seccertutil delete -ldapcacert filename.pem WARNING!!! About to - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 801
For switches running earlier versions of Fabric OS (up to v5.3.0), the maximum size is 256 Kilobytes. The effective security DB size is the lowest supported by or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 802
display security server-specific information as by technical support staff. The information displayed may not be supported between releases chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands Examples none To view the current security state: switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 803
secGlobalShow 2 Security Defined DataSize 35 bytes Define Sum 215b Zone Size (include enabled configuration) 312 bytes Zone sum e04b215b sec_db: free primaryDLPhase 0 ----wwnDL State----- pid tid key sec usec See Also --------- LOG CACHE --------14:08:50 813905136 secipadm_ipchange - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 804
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for an existing policy Saves defined policy set and sends to all switches Shows members of one or more policies Resets security statistics Displays - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 805
issued only from the Primary FCS switch. Only the user who made the changes to the defined database may use this command to abort them. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 806
FCS policy is enabled, this command can be issued only from the Primary FCS switch. Any modifications to the SCC, DCC, and FCC DB are saved and Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 807
switch can be added to the policy. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter name has the common prefix DCC_POLICY_ followed by a string of user-defined characters. These characters do not have to be capitalized - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 808
be present in the fabric or the command fails. DCC_POLICY Members The DCC_POLICY_nnn is a list of device port names associated with a specific switch and port index combination. An empty DCC_POLICY does not stop access to the switch. The device port name is specified by its port WWN string. The - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 809
is enabled, this command can be issued only from the Primary FCS switch. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 810
Valid values for DCC_POLICY_nnn are user-defined alphanumeric or underscore characters. specific switch and port index combination. An empty DCC_POLICY does not stop access to the switch. The device is specified by its port WWN. The switch and port combination must be in the switch port format switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 811
included in the FCS list are FCS switches and the remaining switches in the fabric are non-FCS switches. Out of the FCS list, the switch that is in the first position becomes the Primary FCS switch and the remaining switches become backup FCS switches. If the first switch in the FCS list is not - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 812
Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, " DCC_POLICY_ followed by a string of user-defined characters. These characters do not are removed from a logical switch. SCC_POLICY Deletes the Switch Connection Control policy from the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 813
secPolicyDelete 2 See Also To delete all stale DCC policies in the fabric: primaryfcs:admin> secpolicydelete ALL_STALE_DCC_POLICY About to clear all STALE DCC policies ARE YOU SURE (yes, y, no, n): [no] y secPolicyAbort, secPolicyActivate, secPolicyAdd, secPolicyCreate, secPolicyDump, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 814
to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command can be issued from all FCS switches in 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 capitalize. If - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 815
00:05:1e:90:09:4a - Unknown DCC_POLICY_h1 Type WWN DId swName Switch 10:00:00:05:1e:39:5f:67 3 NeptuneSec. =Index=> 34 8b:13:5e:8e To display all security policies in the defined database: switch:admin> secpolicydump "Defined" DEFINED POLICY SET FCS_POLICY Pos Primary WWN DId - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 816
Unknown To display the SCC policies in the defined database: switch:admin> secpolicydump "Defined","SCC_POLICY" DEFINED POLICY SET SCC_POLICY WWN the SCC policies in the active database: See Also switch:admin> secpolicydump "Active","SCC_POLICY" ACTIVE POLICY SET SCC_POLICY - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 817
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. Notes Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 818
:admin> secpolicyactivate About to overwrite the current Active Policy Set. ARE YOU SURE (yes, y, no, n): [no] y secpolicyactivate command was completed successfully. switch:admin> secpolicyshow ACTIVE POLICY SET FCS_POLICY Pos Primary WWN DId swName 1 Yes 10:00:00:05:1e:35:cd:ef 200 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 819
DCC_POLICY_ followed by a string of user-defined characters. These characters do specific switch and port combination. The device is specified with a WWN string. The switch and port combination must be specified in the switch port format where switch can be specified by switch WWN, domain, or switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 820
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. Examples To remove a member that has a WWN of 12:24:45:10:0a:67:00:40 from SCC - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 821
Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Example To save a defined policy set to persistent memory: switch:admin> secpolicysave secpolicysave command was completed successfully. See - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 822
set. The command can be issued from all FCS switches. This command displays the policy database one page at restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, prefix DCC_POLICY_ followed by a string of user-defined characters. These characters do not - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 823
WWN DId swName 1 Yes 10:00:00:60:69:30:15:5c 1 primaryfcs 2 No 10:00:00:60:69:30:1e:62 4 switch fddCfg, secPolicyAbort, secPolicyActivate, secPolicyAdd, secPolicyCreate, secPolicyDelete, secPolicyDump, secPolicyRemove, secPolicySave Fabric OS Command Reference 793 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 824
, this command can reset security statistics for any or all switches in the fabric. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 825
are grouped together. domain(s) 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 and enclosed in quotation marks. This option can only be executed when an - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 826
retrieve and display the security statistics for any or all switches in the fabric. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 827
are grouped together. Specify one or more domains for which to display the security statistics. Specify an asterisk (*) in quotation marks to represent all switches in the fabric or specify a list of domains separated by semicolons. This option can only be executed when an FCS policy is enabled and - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 828
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To view all sensor values: switch:admin> sensorshow sensor 1: (Temperature) is Ok, value is 39 C sensor 2: (Temperature - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 829
, all commands are context-specific. When a user executes a switch-wide command, the command applies to the current logical switch context. On legacy platforms, or if a logical switch context is not set explicitly, switch commands apply to the default logical switch context (FID 128). When - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 830
the system response time. The set of supported modules and their current debug levels are displayed that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix for a module named NS to value 3: switch:admin> setdbg NS 3 switch:admin> dbgshow NS Module NS, debug level - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 831
to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is not supported on the Brocade DCX backbone. Operands The optional operands are as follows: -e Enables modem - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 832
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" To set the verbose level of a module named NS to value 3: switch:admin> setverbose NS 3 switch:admin> dbgshow NS Module NS, debug level = 0, verbose level = - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 833
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability of all SFPs on the switch. -f Refreshes the SFP information. This option is valid only when sfpShow is issued for a specific port. -all Displays detailed data - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 834
GE: Port 2: -- GE: Port 3: -- GE: Port 4: -- GE: Port 5: id To display detailed SFP information for a Finisar "smart" SFP: switch:user> sfpshow 11 Identifier: 3 SFP Connector: 7 LC Transceiver: 050c402001202020 100,200_MB/s M5,M6 sw Inter_dist Encoding: 1 8B10B Baud Rate: 21 (units 100 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 835
sfpShow 2 To display detailed information for GbE port 0 on a Brocade 7500: switch:admin> sfpshow ge0 Identifier: 3 SFP Connector: 7 LC Transceiver: 050c402000000000 100,200_MB/s M5,M6 sw Inter_dist Encoding: 1 8B10B Baud Rate: 21 (units 100 megabaud) Length 9u: 0 ( - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 836
2 sfpShow To display all SFP information: switch:user> sfpshow -all Port 0: Identifier: 3 SFP Connector: 7 LC Transceiver: 050c402000000000 100,200_MB/s M5,M6 sw Inter_dist Encoding: 1 8B10B Baud Rate: 21 (units 100 megabaud) Length 9u: 0 ( - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 837
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To disable flow control: switch:admin> shellflowcontroldisable Disabling flowcontrol flow control is now disabled See Also - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 838
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To enable flow control: switch:admin> shellflowcontrolenable Enabling flowcontrol flow control is now enabled See Also - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 839
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for . This operand is required. Examples To power off blade unit 3: switch:admin> slotpoweroff 3 Slot 3 is being powered off See Also powerOffListSet - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 840
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for operand is required. Examples To power on blade unit 3: switch:admin> slotpoweron 3 Powering on slot 3. See Also slotPowerOff, slotShow 810 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 841
ID, status, Brocade model name, and power usage for each slot in the switch or chassis. When no operand is specified, slotShow displays the blade type, blade blade 46 CR4S-8 core blade 50 CP8 control processor blade 52 Core8 switch blade 37 FC8-16 port blade 55 FC8-32 port blade 51 FC8 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 842
, the SAS Virtualization services are disabled. Only is faulty because an error was detected. UNKNOWN The chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands This command supports all slots and their status: switch:user> slotshow Slot Blade Type ID - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 843
efficiency (2908 BTU) Power Efficiency: 9.91 watts per port, 2.48 watts per Gb To display Brocade model names for each blade in a Brocade DCX: switch:user> slotshow -m Slot Blade Type ID Model Name Status 1 AP BLADE 33 FA4-18 ENABLED 2 SW BLADE 55 FC8-32 ENABLED 3 SW BLADE 37 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 844
2 slotShow See Also To display Brocade model names for each blade in a Brocade DCX-4S: switch:user> slotshow -m Slot Blade Type ID Model Name Status 1 SW BLADE 36 FC4-48 ENABLED 2 SW BLADE 36 FC4-48 ENABLED 3 SW BLADE 18 FC4-32 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 845
chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Informs are currently not supported for IPv6 addresses. Operands This command supports related configuration parameters. These parameters include the user name, authentication protocol and password, the - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 846
are by default disabled. IPv6 Informs are currently not supported. accessControl Selects access-control-related parameters. These parameters community strings can be changed on the primary FCS switch only, and only the primary FCS switch propagates changes across the fabric. For an SNMP management - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 847
SnmpConfig 2 2 Error 3 Warning 4 Informational 5 Debug SNMPv3 Configuration Parameters Two user roles, snmpadmin and snmpuser are supported. The snmpadmin role provides read-write access and the snmpuser role provides read-only access. Entries are added to the USM table corresponding to each - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 848
with an SNMP manager. The default value is yes. SW-TRAP Specifying yes means the SNMP management application can receive SW-TRAPS from the switch. The default value is yes. You may also turn individual SW Traps on or off. The individual SW traps are swFCPortScn, swEventTrap, swFabricWatchTrap and - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 849
The location of the system (switch). The default value is End User Premise. The string must be at least 4 characters in length; the maximum length is 255 characters. sysContact The contact information for this system (switch). The default value is Field Support. Refer to the definition of - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 850
f): [true] Access host subnet area in dot notation: [0.0.0.0] 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 FCIP-MIB: YES - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 851
--default systemGroup ***** This command will reset the agent's system group configuration back to factory default ***** sysDescr = Fibre Channel Switch sysLocation = End User Premise sysContact = Field Support authTraps = 0 (OFF) ***** Are you sure? (yes, y, no, n): [no] y To set the security level - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 852
yet Trap Entry 2: 10.35.52.34 Trap Port: 162 Trap User: snmpadmin2 Trap recipient Severity level: 5 Trap Entry 3: No trap recipient switch:admin>snmpconfig --set snmpv3 SNMP Informs Enabled (true, t, false, f): [false] t SNMPv3 user configuration(snmp user not configured in FOS user - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 853
OS MIB Reference SW_v5_x.mib, "Switch Management Information & Switch Enterprise Specific Trap" RFC1157, "A Simple Network Management Protocol (SNMPv1)" RFC1213, "Management information Base for Network Management of TCP/IP-based internets: MIB-II" RFC2574, "User-based Security Model (USM) for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 854
Base (MIB) objects and associated traps that are supported in Fabric OS. Use the --send option to send a specific may be in place. Refer to chapter 1, "Using Fabric OS commands" and the traps and MIBs supported in Fabric OS: switch:admin> snmpTraps --show # |Mib Name |Supported Traps 001|SW- - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 855
|fru-status-change-trap |fru-history-trap |cp-status-change-trap To send a link-rnid-device-registration message to recipient 172.16.0.12 switch:admin> snmptraps --send -trap_name link-rnid-device-registration -ip_address 172.16.0.12. snmpConfig Fabric OS Command Reference 825 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 856
, and ports in the base switch). When trunk groups are present, the entire trunk group must be included in the range of ports to test or false failures can occur. If multiple ISL links are present between two switches that support trunking, then it is likely that trunk groups are present and all - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 857
itemlist Specifies a list of user ports to test. By default, all of the ISL ports in the current switch are tested. Refer to itemList for further details. -setfail mode Instructs spinFab how to mark of the following error messages. If errors persist, contact Technical Support. DATA ERR_STAT - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 858
2 spinFab See Also MBUF_STATE_ERR NO_SEGMENT PORT_ABSENT PORT_DIED PORT_ENABLE PORT_M2M PORT_STOPPED PORT_WRONG RXQ_RAM_PERR STATS STATS_C3FRX STATS_FRX STATS_FTX TIMEOUT XMIT itemList, portLoopbackTest 828 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 859
the public keys associated with the configured user on the local switch. • Delete the private key on the local switch. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 860
The user must be in the switch user database and must have admin privileges on the switch. showuser Displays the currently configured user. This operation can only be performed by the default admin. importpubkey Imports a public key from a remote host to the local switch. This operation supports - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 861
to other machines. exportpubkey Exports the public key from the switch to a specified remote host to support outgoing connections from the switch to a remote host. This option can only be performed by a configured user. The successfully exported public key must be appended to the authorized_keys - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 862
QmdFjn6iyiNR2SGV7X9xqkjPN8H4EhIPXGxoDVOfY1Vdt3V3KUxVeEI+vTBI2KJd PmmLfyEKZqCHOlwBx+HuuZP2BnU= username@host To delete all imported public keys on a switch: switch:username> sshutil delpubkeys WARNING: It deletes all the ssh public keys for user. Do you want \ to proceed(Yes or No, default is No)?yes - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 863
user ports. You can issue this command on the FR4-18i blade in a Brocade chassis; however, the command is not supported may be in place. Refer to chapter 1, "Using Fabric OS commands" user ports specified in -uports. The default value is 0. Examples To clear port and diagnostic statistics: switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 864
may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operand: -ports itemlist Specify a list of user ports to test. By default, all the user ports in the switch are tested. Refer to itemList - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 865
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for command prints the usage. Examples To display the FFDC configuration: switch:admin> supportffdc --show First Failure Data Capture (FFDC) is - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 866
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability addresses are supported. To specify the host by name, a DNS entry must exist for the server. -u username Specifies the FTP account user name. The user name must be - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 867
supportftp: ftp parameters changed. To display the FTP parameters: switch:admin> supportftp Host IP Addr: 1080::8:800:200C:417A User name: njoe Remote Dir: support FTP Auto check: Off To set FTP parameters interactively: switch:admin> supportftp -s Host IP Addr[1080::8:800:200C:417A]:192 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 868
In a Virtual Fabric environment, supportSave saves all chassis-based information and iterates through the defined switch-based information for all logical switches. Chassis permissions are required to execute this command. System-wide supportSave is supported on platforms running Fabric OS v6.2.0 or - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 869
to configure the service correctly may result and other support information to an FTP server in interactive mode: switch:admin> User Name: admin Password: Protocol (ftp or scp): ftp Remote Directory: /temp/support Saving support information for chassis:HL_5100_66, module:RAS... Saving support - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 870
information on a Brocade 5100 and save it to an attached USB device: switch:admin> supportsave -U -d mysupportsave This command will collect RASLOG, TRACE, supportShow, core file, FFDC data and other support information and then transfer them to a FTP/SCP server or a USB device. This operation - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 871
commands, enabled by default. services Service group commands, enabled by default chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This is a diagnostic command and should only be run for diagnostic support. Output generated by this command may vary by switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 872
valid only with the slotnumber/portnumber parameters. Examples To display debugging information: switch:admin> supportshow VF Date: Wed Oct 22 09:31:41 UTC 2008 enabled exception enabled port enabled fabric enabled services enabled security enabled network enabled portlog enabled - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 873
supportShow 2 See Also 07:32:21.887 FCPH read 0 40 02fffffd,00fffffd,f4000000,00000000,1a 731af5 07:32:21.887 FCPH seq 0 28 22380000,1a731af5,000007c4,0000001c,00 000000 07:32:30.131 FCPH write 0 40 00fffffd,00fffffd,00000000,00000000,00 000000 07:32:30.131 FCPH seq 0 28 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 874
Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command the fabric group commands. services Disables the service group commands. security commands under the supportShow command: switch:admin> supportshowcfgdisable os Config - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 875
Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command the fabric group commands. services Enables the service group commands. security Enables under the supportShow command: switch:admin> supportshowcfgenable os Config update - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 876
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details command: switch:admin> supportshowcfgshow os enabled exception enabled port enabled fabric enabled services enabled security - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 877
this command to enable or disable switch beaconing mode. Switch beaconing can be used to locate pattern is shown. However, if diagnostic frame-based tests (such as portLoopbackTest) are executed, Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 878
Notes Performance Monitoring cannot be added to any port on a persistently disabled switch. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 879
switch remains the principal switch, it assigns itself a domain ID. If another switch assumes the principal role, then this switch becomes a subordinate switch, and accepts a domain ID from the principal. Refer to the FC-SW specification may be in place. Refer to chapter 1, "Using Fabric OS commands" - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 880
switchcfgspeed speed Description Use this command to configure the port speed on a switch. This command sets the speed for all user ports. If any port on the switch is not capable of the specified speed setting, an error message is displayed for that port. The configuration is saved in nonvolatile - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 881
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" on all ports. Examples To enable trunking on all ports of a switch: switch:admin> switchcfgtrunk 1 Configuration applied to all ports except the following \ - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 882
require the switch to be disabled generate an error message if invoked while the switch is enabled. It is not necessary to disable the switch before chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details Operands none Examples To disable the switch: switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 883
switchEnable Enables all user ports on a switch. Synopsis switchenable Description Use this command to enable all user ports on a switch. All Fibre chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To enable a switch: switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 884
switch name causes a domain address format registered state change notification (RSCN) to be issued. Refer to the FC-FLA specification for a description of RSCNs). Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 885
interswitch links (XILS) in the base fabric to carry traffic to this logical switch. Values are ON or OFF. LS Attributes Displays logical switch attributes, including the fabric ID associated with the logical switch and the switch role (default switch or base switch) and the fabric Address Mode - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 886
No_Module Mod_Val Mod_Inv No_Light No_Sync In_Sync Port Index is a number between 0 and the maximum number of supported ports on the platform. The port index identifies the port number relative to the switch. Slot number; 1-12 Port number; 0-15, 0-31, or 0-47. The 24-bit Address Identifier. Media - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 887
Proto Protocol support by GbE port. ISCSI The ports supports ISCSI. FCIP The port supports FCIP. FCoE The port supports Fibre Channel of the attached switch is the same as the router. F_Port Point-to-point port; displays the WWN of the attached N_Port. If that specific F_Port receives 1 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 888
service (QoS). (logical) Indicates a logical port. The switchshow output shows all logical ports currently present in the logical switch. The command displays -1 for the slot for logical ports and the user the following blade-specific information: slot Slot supported Refer to chapter 1, "Using - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 889
blade information. You can specify this operand with -portname, but not with any other operand. -portname Displays the name for each port on the switch. The port name is set by the portName command. You can specify this operand with -slot, but not with any other operand. -portcount Displays - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 890
:00:60:69:80:04:92 zoning: ON (testcfg1) switchBeacon: OFF FC Router: OFF Allow XISL use: ON LS Attributes: [FID: 10, Base Switch: No, Default Switch: No, Address Mode 0] Index Slot Port Address Media Speed State Proto 377 12 41 32f180 -- N8 No_Module 378 12 42 32f280 -- N8 No_Module - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 891
> switchshow -slot 5 -portname FC Router: OFF Allow XISL Use: OFF LS Attributes:[FID: 128, Base Switch: No, Default Switch: Yes, Address Mode 0] Slot Blade Type ID Status 5 COREBLADE 52 ENABLED Index Slot Port Name 384 5 0 MyName_portname0 385 5 1 ------ 386 5 2 ------ To - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 892
2 switchShow See Also switchRole: Principal DomainIDOffset: 0x20 switchDomain: 2 switchId: fffc25 switchWwn: 10:00:00:05:1e:35:71:8b zoning: OFF switchBeacon: OFF FC Router: OFF FC Router BB Fabric ID: 1 [output truncated] portCfgLongDistance, switchDisable, switchEnable, switchName - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 893
ports were faulty, then this contributor would set the overall switch status to DOWN. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 894
calculation. ** In addition, if the range of settable values in the prompt is (0..0), ** the policy parameter is NOT applicable to the switch. ** Simply hit the Return key. The minimum number of Bad PowerSupplies contributing to DOWN status: (0..4) [3] 2 Bad PowerSupplies contributing to MARGINAL - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 895
is set to 3, and three ports fail in the switch, then the status of the switch changes to DOWN. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 896
2 switchStatusPolicyShow Flash 0 1 MarginalPorts 2 1 FaultyPorts 2 1 MissingSFPs 0 0 See Also switchStatusPolicySet, switchStatusShow 866 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 897
status is based on the chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands Examples none To display a switch health report: To retrieve a switch health report for a switch that is configured with an IPv6 address: switch:user> switchstatusshow Switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 898
switchStatusShow Missing SFPs monitor HEALTHY 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 Switch Name: switch IP address: 10.32.89.26 SwitchState: MARGINAL Duration: 80:12 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 899
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To view the uptime for the switch: switch:user> switchuptime 9:50pm up for 20 mins See Also none Fabric OS Command - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 900
restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, and standby CPs. This command does not support High Availability (HA). Operands This command . Examples To display DCC violations for a switch: switch:admin> switchviolation --dump -dcc Device WWN - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 901
system messages to the appropriate log files or users, depending on the system configuration. The specified Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, the syslog facility to LOG_LOCAL1: switch:admin> syslogdfacility -l 1 Syslog facility - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 902
all error log entries to the syslog daemon (syslogd) of one or more specified servers. The syslog daemon 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. Up to six servers are supported - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 903
on the switch. IPv6 and IPv4 syslogd addresses are supported. Use syslogdIPShow to view the current syslog server configuration. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 904
by IP address. IPv4 and IPv6 addresses are supported. Note The execution of this command is subject to Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, " IP addresses configured on a switch: switch:admin> syslogdipshow syslog.1 1080::8: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 905
Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands This command supports the following the command usage. Examples To configure the threshold for memory usage monitoring: switch:admin>sysMonitor --config mem -poll 10 -retry 1 -limit 20 - - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 906
:admin>sysMonitor --config cpu -poll 20 -retry 4 -limit 70 -action snmp To display the current memory usage threshold: switch:admin>sysMonitor --show cpu CPU Usage: CPU Usage : 21.9 CPU Usage limit : 70 Number of Retries : 4 Polling Interval : 20 seconds Actions : snmp fwHelp 876 Fabric - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 907
off the system. To reboot the system, manually turn the power switch on. Notes This command is not supported on the standby CP. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 908
2 sysShutDown See Also To attempt a system shutdown from the standby CP (not supported): switch:admin> sysshutdown Shut down the whole system is not support from the standby CP For shut down the whole system please run the sysshutdown from the active CP haDisable 878 Fabric OS Command Reference - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 909
to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Refer to the hardware reference manual for your switch to determine the normal temperature range. Operands none Examples To display temperature and status sensors: switch:user> - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 910
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" current timeout value. Examples To set the idle timeout to 10 minutes: switch:admin> timeout 10 IDLE Timeout Changed to 10 minutes The modified IDLE - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 911
of the translate domain associated with that edge fabric. In this case the translate domain is considered local to both of the switches in the backbone. 5. If there is only one switch in the backbone, no domain details are displayed (all domains are local). Depending on the fabric, the display may - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 912
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command displays details for all domains, including local domains and local translate domains: switch:user> topologyshow 6 domains in the fabric; Local Domain ID: 7 Domain: - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 913
. The fabric has five domains, but details are only shown for the three remote domains, not for the two local translate domains. switch:user> topologyshow 5 domains in the fabric; Local Domain ID: 2 Local Translate Domain 4 owned by port: 24 Local Translate Domain 5 owned by port: 23 33 Domain - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 914
2 topologyShow See Also Path Count: 1 Hops: Out Port: In Ports: Total Bandwidth: Bandwidth Demand: Flags: 2 0 23 24 33 38 39 8.000 Gbps 350 % D fcrXlateConfig, portRouteShow, uRouteShow 884 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 915
, or to display the dump status on the switch. When executed without operands, this command defaults to dmp.gz The compressed trace dump archive file extension. Note The execution of this command is subject to Virtual that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 916
2 traceDump See Also To clear the status of a trace dump: switch:admin> tracedump -R trace dump removed To clear the content of the trace dump buffer: switch:admin> tracedump -c Cleared Trace Buffer contents supportFtp, supportSave, supportShow 886 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 917
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for Examples To display information on the track-changes commands: switch:admin> trackchangeshelp trackChangesSet Configure alert for login/logout/config - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 918
log for the switch. Use errDump or errShow to view the error log. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 919
log for the switch. Use the errDump command or errShow command to view the error log. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 920
based on the trunking properties of the two specified ports: • Switch does not support trunking • Trunking license required • Trunking not supported in switch or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 921
wide name of the connected port. Domain Displays the domain IDs of the switches directly connected to the physical ports. In case of an FC Router or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 922
:42:dd deskew 15 MASTER To display trunking information for a switch that is part of an FC Router backbone fabric interlinking several 4 deskew 16 4 deskew 16 4 deskew 17 4 deskew 17 4 deskew 15 4 deskew 16 switch:admin> switchshow 48 4 0 013000 id N4 Online EX-Port (Trunk port, master is Slot 4 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 923
:1e:37:12:13 "SW4900_43" (downstream)(Trunk master) To display trunking information along with the bandwidth and throughput for all trunk groups in a switch: switch:admin> trunkshow -perf 1: 6-> 4 10:00:00:60:69:51:43:04 99 deskew 15 MASTER Tx: Bandwidth 8.0GB, Throughput 6.0 GB (75%) Rx: Bandwidth - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 924
and broadcasts time service updates. All switches in the fabric and should be accessible from the switch. The NTP server must support a full NTP client. When a switch. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 925
LOCL To set the NTP server to a specified IP address: switch:admin> tsclockserver 123.123.123.123 Updating Clock Server configuration...done. switch:admin> tsclockserver 123.123.123.123 To configure multiple NTP servers: switch:admin> tsclockserver "12.134.125.24; 12.234.87.01" Updating - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 926
the default time zone setup. Time zone is used in computing local time for error reporting and logging. An incorrect time zone setup does not affect the switch operation in any way. System services started during the switch boot reflect a time zone change only at the next reboot. The time zone can - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 927
Hour Offset: -3 Time Zone Minute Offset: -30 To set the current timezone to the zone to Pacific Time using the interactive command mode: switch:admin> tsTimeZone --interactive Please identify a location so that time zone rules can be set correctly. Please select a continent or ocean. 1) Africa - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 928
System Time Zone change will take effect at next reboot See Also To revert back to the offset format and verify the configuration: switch admin> tstimezone --old 2 switch admin> tsttimezone Time Zone Hour Offset: 2 Time Zone Minute Offset: 0 date 898 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 929
specific versions of the same test. Use ceeTurboRamTest on FCoE platforms only. On all other supported platforms, use turboramtest. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter two passes: switch:admin> - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 930
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for display the length of time the system has been operational: switch:admin> uptime 12:03am up 4:56, 3 users, load average: 1.17, 1.08, 1.08 See Also - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 931
route is assigned to a specific path (defined by port number load sharing may be affected. The switch attempts to optimize load sharing, but 48000, Static route configuration is not supported on Brocade directors set to chassis configuration be in place. Refer to chapter 1, "Using Fabric OS commands - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 932
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for for all traffic coming in from port 1 and addressed to domain 2: switch:admin> urouteremove 1 2 done. See Also configShow, dlsShow, uRouteConfig, - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 933
2) on a switch, the value is equal to the port index field displayed by the switchShow command. Refer to Fabric OS Administrator's Guide for more information Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 934
to display a list of valid ports. This operand is optional; if omitted, the command displays routing information for all input ports in the switch. Specify a remote domain in the fabric for which routing information is to be displayed. This operand is optional; if omitted, the routing information - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 935
the help pages for these commands for specific information on how the USB device is restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix of the attached USB device: switch:admin> usbstorage -l firmwarekey\ 0B support\ 106MB support1034\ 105MB config - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 936
on usbstorage 74% To remove a firmware target from the firmware application area: switch:admin> usbstorage -r firmware FW_v6.0.0 To disable an attached USB device: switch:admin> usbstorage -d USB storage disabled supportSave, firmwareDownload, configUpload, configDownload, firmwareKeyupdate 906 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 937
to manage user accounts on a switch. The command supporting multiple switch domains, account information is saved only to the switch domain, in which the command was executed. Use the distribute command to distribute the account database manually to other switches in the fabric. Target switches - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 938
command operates on the switch-local user database only, regardless of whether the switch is configured to use RADIUS authentication or not. The account database supports a maximum of 256 customer created accounts. The backup account database is no longer supported on switches running Fabric OS v6 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 939
respective AD or LF permissions of the account that creates or modifies a user account. • In an LF-enabled environment, you can change the role associated new LFs or delete any existing LFs. The following operands are supported with the --add and --change options: username Specifies the login - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 940
password. Refer to the passwdCfg help page for more information. --addad | --deletead Adds one or more ADs to a user account or deletes ADs from a user account. The following operands are supported: username Specifies the account login name. 910 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 941
or a combination of both (1-5,7). --addlf | --deletelf Adds Logical Fabric or chassis permissions to a user account or deletes LF or chassis permission from a user account. The following operands are supported: username Specifies the account login name. -h LF_ID Specifies the account's home LF - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 942
options are displayed. In an AD-enabled environment, AD-specific options are displayed. Examples A. The following examples illustrate how to create and manage user accounts in an AD-enabled environment. To add a new account: switch:admin> userconfig --add joe -r admin -d "Joe Smith" Setting - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 943
change the test account's access permissions for the Logical l Fabrics 5 and 6 to ZoneAdmin and the chassis permission to user: switch:admin> userconfig --change test -r zoneadmin -l 1-5 -c user -h 4 Broadcast message from root (ttyS0) Sat Jun 14 01:05:28 2008... Security Policy, Password or Account - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 944
2 userConfig See Also To remove chassis permissions from the test account for the LFs 1-3. switch:admin> userconfig --deletelf test -l 1-3 -c Broadcast message from root (ttyS0) Sat Jun 14 01:10:02 2008... Security Policy, Password or Account Attribute Change: test will - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 945
as old_username. Notes This command is not supported on all platforms. The execution of this be in place. Refer to chapter 1, "Using Fabric OS user login name. new_username Specifies thee new user login name. Examples To rename the admin-level login name from "USERID" to "admin": switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 946
in the time period between firmwareDownload and the next reboot, the dates can differ. Operands none Examples To display the firmware version information in a switch: switch:admin> version Kernel: 2.6.14.2 Fabric OS: v6.1.0 Made on: Wed Feb 13 06:59:17 2008 Flash: Thu Feb 14 18:38:31 2008 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 947
digits between 0 and ff. The switch WWN is a factory-set parameter that cannot be changed by the end user. The WWN is used as the chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operands: -sn Displays the switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 948
device WWN supports the persistence of the PID based on the WWN of the device to which the PID is bound. If the PID is not bound to a device WWN, the device can get the same or a different PID irrespective of which port it logs in to a given switch Refer to chapter 1, "Using - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 949
2b:0f:76:5f To display all WWN address bindings on the current partition: switch:admin> wwnaddress --show # WWN Area Age Flag 1) 10:00:00:06:2b display the WWW address binding for device 20:22:00:05:1e:0b:61:cc: switch:admin> wwnaddress --findPid 20:22:00:05:1e:0b:61:cc WWN PID 20:22 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 950
[FCR | noFCR] zone --rddelete name The zone command supports three types of operations: specific zone operations, creation/management of Traffic Isolation Zones, and down the route within the backbone fabric based on EX_Ports and devices involved. 920 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 951
base RD zone, "red_______base". When the base zone is removed, the RD zone configuration "r_e_d_i_r_c__fg" is removed as well Notes TI zones are not supported in fabrics involving switches be in place. Refer to chapter 1, "Using Fabric OS Commands for performing specific zone operations: -- - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 952
buffer and the defined buffer. You cannot specify a mode or a zone object together with the -f option. Specifies the zone database location. Supported mode flag values are: 0 Uses the zone database from the current transaction buffer. 1 Uses the zone database stored in persistent storage. 2 Uses - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 953
of the TI Zone comes online again, the route is set up again and the switch generates another SCN or RSCN. TI zones with no-failover option are not supported in logical fabrics. TI zones defined in the Base Fabric for logical fabric traffic need to allow failover. f Enables failover mode. In - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 954
not wish to support FCR. Deletes the RD Zone specified by name. RD Zones are unique in that the zone name is not user-defined. It is derived based on members and the specified configuration. Use cdfgShow to display currently implemented RD zone by name. Examples 1. Specific zone operation commands - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 955
the member? (yes, y, no, n): [no] yes To validate all zones in the zone database in the current transaction buffer: switch:admin> zone --validate -m 0 Defined configuration: cfg: t_r_a_f_f_i_c_i_s_o_c__fg bluezone; greenzone cfg: ticonfig regzone zone: bluezone 1,1*; 1,2* zone: greenzone 1,1*; 20:01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 956
does not exist # - Invalid usage of broadcast zone To prune all the zone members that are not enforceable: switch:admin> zone --validate -f You are about to prune the zone configurations, based on zone --validate output. Do you want to prune the zone configurations (yes, y, no, n): [no] y 2. Traffic - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 957
30:30:30:30:30:30), and VT (40:40:40:40:40:40:40:40): switch:admin>zone --rdcreate 10:10:10:10:10:10:10:10 20:20:20:20:20:20 "red_0917_10_10_10_10_10_10_10_10_20_20_20_20_20_20_20_20", with a restrictedly policy and no FCR support. • The base zone object, "red_______base". • The RD zone configuration - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 958
: myHostTarget 00:3f:3f:3f:23:24:25:26 3f:3f:3f:30:32:00:00:00 To delete an RD Zone named "red_0917_10_10_10_10_10_10_10_10_20_20_20_20_20_20_20_20": switch:admin>zone --rddelete red_0917_10_10_10_10_10_10_10_10_20_20_20_20_20_20_20_20 ad, zoneHelp 928 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 959
the defined configuration. For the change to be preserved across switch reboots, save the configuration to nonvolatile memory with the cfgSave Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 960
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" by domain and port index, for example, "2, 20" specifies port index 20 on switch domain 2. When a zone member is specified by port index, all devices connected to - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 961
zone members. For example, a zone defined with the following members: "2,12; 2,14; 10:00:00:60:69:00:00:8a" contains all devices connected to switch 2, ports 12 and 14, and to the device with the world wide name "10:00:00:60:69:00:00:8a" (either node name or - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 962
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for is enabled, this command can be issued only from the primary FCS switch. Operands The following operand is required: "zonename" Specify the name of - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 963
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details Examples To display zone command help information: switch:admin> zonehelp aliadd alicreate alidelete aliremove alishow cfgactvshow - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 964
restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix specifications Examples To create a configuration containing three zones: switch:admin> cfgshow "*" cfg: USA_cfg Red_zone; White_zone; Blue_zone switch:admin> zoneobjectcopy "USA_cfg", "UK_cfg" switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 965
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command :37:0c:76:85; 21:00:00:20:37:0c:71:df switch:admin> zoneobjectexpunge "White_zone" switch:admin> cfgshow Defined configuration: cfg: USA_cfg Red_zone; Blue_zone zone: Blue_zone - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 966
that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix specifications. Examples To create a configuration containing three zones: switch:admin> cfgshow "*" cfg: USA_cfg Red_zone; White_zone; Blue_zone switch:admin> zoneobjectrename "USA_cfg", "UK_cfg" switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 967
Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" by semicolons. A member can be one or more of the following: • A switch domain and port index pair: for example, "2,20". Use switchShow for a list of - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 968
Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for policy is enabled, this command can be issued on any FCS switch in the fabric. Operands This command has the following operands: "pattern - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 969
Primary FCS commands Chapter 3 Primary FCS commands Table 24 summarizes the commands that are switch. Must be run from the primary FCS switch. Must be run from the primary FCS switch. Must be run from the primary FCS switch. Can be run on all FCS switches. Must be run from the primary FCS switch - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 970
. Must be run from the primary FCS switch. Must be run from the primary FCS switch. Must be run from the primary FCS switch. Must be run from the primary FCS switch. Must be run from the primary FCS switch. Must be run from the primary FCS switch. 940 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 971
Processor (CP). 2. Role Based Access Control (RBAC) availability: checks that the invoking user's role is permitted to invoke option- specific. Display options may be allowed, but set options may be subject to Admin Domain restrictions. • SwitchMember = Allowed to execute only if the local switch is - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 972
and Chassis context (VF/CH) = Command applies to the switch and the chassis. • Disallowed = Command can not be executed when Virtual Fabrics are enabled. 5. Command-specific: checks whether the command is supported on the platform for which it is targeted. Encryption commands and permissions There - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 973
RBAC availability and admin domain type Command Name User Admin Oper SW Zone Fabric BS Sec N O N OM Disallowed N OM N N N O N OM Disallowed Fabric OS Command Reference 53-1001337-01 Context Switch Type VF DS VF DS VF DS VF DS VF DS VF DS VF DS VF DS VF DS VF DS VF - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 974
TABLE 2 Fabric OS command RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin Admin Admin Admin Context Switch Type aaaConfig ad ag N OM N N N N N OM SwitchMember CH N/A N OM N N N N N O Allowed/ Disallowed N/A OM - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 975
Fabric OS command RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin VF VF VF VF CH CH CH VF CH VF VF CH CH CH CH CH VF VF VF VF VF VF Switch Type All All All All All All All All N/A N/A All N/A N/A All All N/A N/A N/A All N/A - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 976
OS command RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Disallowed OM OM OM N OM O N SwitchMember CH OM OM OM N OM O N SwitchMember CH Switch Type N/A All All All All All All All All N/A N/A N/A N/A N/A N/A N/A All N/A - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 977
RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin SwitchMember O OM O O O OM O N Disallowed O OM O O O OM O O Allowed Context Switch Type CH N/A Disallowed N/A CH N/A CH N/A VF All VF All VF All VF All VF All CH - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 978
Fabric OS command RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin Admin Admin Admin Context Switch Type fcoeLoginCfg fcoeLoginGroup fcPing fcpLogClear fcpLogDisable fcpLogEnable fcpLogShow fcpProbeShow fcpRlsShow fcrBcastConfig - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 979
and permissions A TABLE 2 Fabric OS command RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin Admin Admin Admin Context Switch Type firmwareCommit O OM OM OM O OM O OM SwitchMember CH N/A firmwareDownload O OM OM OM - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 980
RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Allowed O O O O O O O O Allowed O OM OM OM O OM O O Allowed Context CH CH Switch Type N/A N/A CH N/A VF All CH N/A CH N/A CH N/A CH N/A VF All VF All CH N/A CH - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 981
A TABLE 2 Fabric OS command RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin Admin Admin Admin Context Switch Type licensePort licenseRemove licenseShow licenseSlotCfg linkCost login logOut lsanZoneShow lsCfg LSDbShow memShow - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 982
Fabric OS command RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin Admin Admin Admin Context Switch Type pathInfo pdShow perfAddEEMonitor perfAddIPMonitor perfAddReadMonitor perfAddRWMonitor perfAddSCSIMonitor perfAddUserMonitor - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 983
A TABLE 2 Fabric OS command RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin Admin Admin Admin VF VF VF VF VF VF VF CH VF VF VF VF VF CH VF VF VF VF Switch Type All All All All All All All All All All All All All All All All All - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 984
OS command RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin Admin Admin Admin Context Switch Type portLogDumpPort portLogEnable portLogEventShow portLoginShow portLogPdisc portLogReset portLogResize portLogShow portLogShowPort - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 985
Fabric OS command RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin Admin Admin Admin Context Switch Type secAuthSecret secCertUtil secDefineSize secGlobalShow secHelp secPolicyAbort secPolicyActivate secPolicyAdd secPolicyCreate - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 986
Fabric OS command RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin VF VF VF VF VF VF VF VF VF VF CH VF CH CH CH CH CH CH CH CH CH VF CH Switch Type DS N/A N/A N/A All N/A N/A N/A All All All All All All All All All All All All N/A - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 987
2 Fabric OS command RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin Admin Admin Admin Context Switch Type trackChangesHelp O trackChangesSet O trackChangesShow O trunkDebug O trunkShow O tsClockServer O tsTimeZone - HP StorageWorks 8/8 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01, - Page 988
A General Fabric OS commands and permissions 958 Fabric OS Command Reference 53-1001337-01
53-1001337-01
28 July 2009
®
Fabric OS
Command Reference Manual
Supporting Fabric OS v6.3.0