HP Brocade 8/12c Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186
HP Brocade 8/12c Manual
View all HP Brocade 8/12c manuals
Add to My Manuals
Save this manual to your list of manuals |
HP Brocade 8/12c manual content summary:
- HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 1
53-1001186-01 24 November 2008 Fabric OS Command Reference Manual Supporting Fabric OS v6.2.0 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 2
Reserved. Brocade, Fabric OS, File Lifecycle Manager, MyView, and StorageX are registered trademarks and the Brocade B-wing symbol, DCX, and SAN Health are trademarks of Brocade Communications Systems, Inc., in the United States and/or in other countries. All other brands, products, or service names - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 3
-0302 Email: [email protected] Document History The table below lists all versions of the Fabric OS Command Reference. Document Title Publication Number Summary of Changes Fabric OS Reference v2.0 53-0001487-03 Fabric OS Reference v2.2 53-0001558-02 Fabric OS Reference v2.3 53-0000067 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 4
01 Fabric OS Command Reference 53-1001186-01 Summary of Changes Publication Date June 2007 Added 13 new commands, Updated 23 commands with new options in support of v6.0. Removed 46 obsolete commands. Edit/revise ~ 150 commands. Added command syntax conventions to Preface.Updated FCS, standby CP - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 5
organized xix Supported hardware and software xix What is new in this OS Commands In this chapter 1 Understanding role-based access control 1 Understanding Virtual Fabric restrictions 2 Understanding Admin Domain restrictions 3 Using the command line interface 3 Chapter 2 Fabric OS - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 6
73 cfgShow 74 cfgSize 76 cfgTransAbort 78 cfgTransShow 79 chassisBeacon 80 chassisConfig 81 chassisEnable 82 chassisDisable 83 chassisName 84 chassisShow 85 cliHistory 87 configDefault 88 configDownload 90 configList 95 configRemove 96 vi Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 7
Fabric OS Command Reference 53-1001186-01 configShow 97 configUpload 101 configure 105 configureChassis 113 cryptoCfg 115 dataTypeShow 162 date 163 dbgShow 165 defZone 166 diagClearError 168 diagDisablePost 169 diagEnablePost 170 diagHelp 171 diagPost 172 diagRetry 173 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 8
246 fcrProxyConfig 248 fcrProxyDevShow 250 fcrResourceShow 252 fcrRouterPortCost 254 fcrRouteShow 256 fcrXlateConfig 257 fddCfg 260 fdmiCacheShow 262 fdmiShow 263 ficonClear 264 ficonCupSet 265 viii Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 9
Fabric OS Command Reference 53-1001186-01 ficonCupShow 267 ficonHelp 269 ficonShow 270 fipsCfg 276 firmwareCommit 279 firmwareDownload 280 firmwareDownloadStatus 285 firmwareKeyShow 288 firmwareKeyUpdate 289 firmwareRestore 291 firmwareShow 292 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 10
iscsiSwCfg 409 islShow 410 isnscCfg 411 itemList 413 killTelnet 415 ldapCfg 416 lfCfg 418 licenseAdd 422 licenseHelp 423 licenseIdShow 424 licensePort 425 licenseRemove 427 x Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 11
Fabric OS Command Reference 53-1001186-01 licenseShow 428 linkCost 429 login 431 logout 432 lsanZoneShow 433 lsCfg 435 lsDbShow 440 fosExec 443 memShow 445 msCapabilityShow 446 msConfigure 447 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 12
554 portCfgCreditRecovery 556 portCfgDefault 557 portCfgEport 558 portCfgEXPort 559 portCfgFportBuffers 562 portCfgGport 563 portCfgISLMode 564 portCfgLongDistance 566 portCfgLport 569 portCfgNPIVPort 571 portCfgNPort 573 xii Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 13
Fabric OS Command Reference 53-1001186-01 portCfgPersistentDisable 574 portCfgPersistentEnable 575 PortCfgQos 576 portCfgShow 578 portCfgSpeed 585 portCfgTrunkPort 586 portCfgVEXPort 587 portCmd 590 portDebug 594 portDisable 595 portEnable 596 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 14
699 secPolicyFCSMove 702 secPolicyRemove 704 secPolicySave 706 secPolicyShow 707 secStatsReset 709 secStatsShow 711 sensorShow 713 setContext 714 setDbg 715 setModem 716 setVerbose 717 xiv Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 15
Fabric OS Command Reference 53-1001186-01 sfpShow 718 shellFlowControlDisable 722 shellFlowControlEnable 723 slotPowerOff 724 slotPowerOn 725 slotShow 726 SnmpConfig 730 spinFab 737 sshUtil 740 statsClear 744 stopPortTest 745 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 16
816 userRename 824 version 825 wwn 826 zone 827 zoneAdd 836 zoneCreate 837 zoneDelete 839 zoneHelp 840 zoneObjectCopy 841 zoneObjectExpung 842 zoneObjectRename 843 zoneRemove 844 zoneShow 845 Primary FCS commands Primary FCS commands 847 xvi Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 17
Appendix A Appendix A: Command availability In this appendix 849 Command validation checks 849 Encryption commands and permissions 850 General Fabric OS commands and permissions 852 Fabric OS Command Reference xvii 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 18
xviii Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 19
. Supported hardware and software This document includes updated information specific to new functionality introduced in Fabric OS v6.2.0. The following hardware platforms are supported in this release: • Brocade 200E • Brocade 300 • Brocade 4016 • Brocade 4020 Fabric OS Command Reference xix - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 20
are tested and supported by Brocade Communications Systems, Inc. for Fabric OS v6.2.0, documenting all possible configurations and scenarios is beyond the scope of this document. This document is specific to Fabric OS v6.2.0. To obtain information about an OS version other than v6.2.0, refer to the - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 21
modified to set fillwords. • portCfg - New operands to support FCIP inband management, interface IP address and route configuration, byte streaming, and FCIP read Tape Piplelining. • portCfgShow - New parameters to support port auto disable and inband management. Fabric OS Command Reference xxi - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 22
• portShow - New operands to support FCIP inband management, interface IP address and route configuration display, byte streaming, and TCP connection history and snapshot display. • secPolicyDelete - New option to delete all stale security policies. • supportShowcfgDisable, supportShowcfgEnable, - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 23
CLI output Identifies syntax examples 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 in this manual. They reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 24
For definitions specific to Brocade and Fibre Channel, see the Brocade Glossary. For definitions of SAN-specific terms, visit the Storage Networking Industry Association online dictionary at http://www.snia.org/education/dictionary. Notice to the reader This document may contain references to the - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 25
for Fibre Channel, storage management, and other applications: http://www.t11.org For information about the Fibre Channel industry, visit the Fibre Channel Industry Association Web site: http://www.fibrechannel.org Getting technical help Contact your switch support supplier for hardware, firmware - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 26
and messages received • supportSave command output • Detailed description of the problem, including the switch or fabric behavior immediately • following the problem, and specific questions • Description of any troubleshooting steps already performed and the results • Serial console and Telnet - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 27
Document feedback Quality is our first concern at Brocade, and we have made every effort to a topic needs further development, we want to hear from you. Forward your feedback to: [email protected] Provide the title and version number and as much detail as possible about your issue, including - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 28
xxviii Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 29
tasks, typically of a more limited scope and effect. Admin May perform all administrative tasks, including encryption and chassis commands. SecurityAdmin Administrative use including admin, encryption, security, user management, and zoning. Fabric OS Command Reference 1 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 30
and are not supported at the same time on a switch. To use Admin Domains, you must first disable Virtual Fabrics; to use Virtual Fabrics, you must first delete all Admin Domains. Use ad --clear -f to remove all Admin Domains. Refer to the Fabric OS Administrator's Guide for more information - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 31
command line interface (accessed via Telnet, SSH, or serial console) provides full management capability on a Brocade switch. The Fabric OS CLI enables an administrator to monitor and manage individual switches, ports, and entire fabrics from a standard workstation. Selected commands must be issued - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 32
, and a set of examples. The same information can be accessed by issuing help command on a Brocade switch or director. This command displays the help page for the specified command. For example, to display the help page for ad, type: switch:admin> help ad 4 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 33
to the Fabric OS Message Reference manual for specific details. There are two modes of operation in LDAP authentication, FIPS mode and non-FIPS mode. However, there is no option to configure LDAP while the switch is in FIPS mode. The LDAP client checks if FIPS mode is set on the switch and uses FIPS - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 34
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 or 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 executed - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 35
enclosed in double quotation marks. The following AAA services and service pairs are valid: "local" Default setting. Authenticates the user against the local database only. If the password does not match or the user is not defined, the login fails. Fabric OS Command Reference 7 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 36
192.168.233.48 as an LDAP server: switch:admin> aaaconfig --change 192.168.233.48 -conf ldap -p 3002 -s newsecret -t 1 To add an AD/LDAP server to the configuration: switch:admin> aaaconfig --add 194.72.68.335 -conf ldap -p 3002 -d brocade.com -t 1 8 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 37
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-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 38
mode should be set to "No Access". To set the default zone mode to "No Access" execute the following command sequence: switch:admin> ad --select AD0 switch:admin> defzone --noaccess switch:admin> cfgsave Refer to defZone help for more information. 10 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 39
add arguments Adds new members to an existing Admin Domain. The add operation remains in the transaction buffer until you issue ad --apply or ad --save. --apply Saves the current transaction buffer contents to the defined configuration and enforces the defined configuration on all switches in the - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 40
the defined configuration on all switches in the fabric. The saved Admin Domain definition is enforced only when ad --apply is issued. Attempts to modify and save an Admin Domain that is currently enforced will fail. The command prompts for confirmation. 12 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 41
or mode. When executed in an AD255 context, all Admin Domain information from the transaction buffer, defined configuration and effective configuration is displayed. --validate arguments Checks whether Admin Domain members are from a non-Admin Domain aware switch or the members do not exist in the - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 42
valid only with the --exec option. Specifies a new Admin Domain name or number. This operand is valid only with the --rename option. Format is the same as ad_id. Displays the implicit members of AD0. This operand is valid only with the --show option. 14 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 43
ID and switch WWN: switch:admin> 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 Command Reference 15 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 44
save the changes to Defined configuration. Any changes made will be enforced only on ad --apply. Do you want to save admin domains (yes, y, no, n): [no] y To select a new Admin Domain context by specifying the AD number: switch:admin> ad --select 12 16 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 45
Defined configuration AD: 1 : AD1 Active Device WWN members: Switch port members: Switch WWN members: 21:00:00:80:e5:12:8b:37; 21:00:00:80:e5:12:8b:55; 1,0; 1,1; 1,2; 1,3; 1,4; 1,5; 1,6; 1,7; 1,8; 1,9; 1,10; 1,11; 1,12; 1,13; 1,14; 1,15; 10:00:00:60:69:00:02:53; Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 46
Switch port members: Switch WWN members: 21:00:00:80:e5:12:8b:37; 21:00:00:80:e5:12:8b:55; 1,0; 1,1; 1,2; 1,3; 1,4; 1,5; 1,6; 1,7; 1,8; 1,9; 1,10; 1,11; 1,12; 1,13; 1,14; 1,15; 10:00:00:60:69:00:02:53; To display the configuration information in the transaction buffer: switch:admin Switch port - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 47
WWN members: Switch port members: 10:00:00:00:00:17:00:00; 10:00:00:00:00:15:00:00; 2,52; 2,53; 2,54; 2,55; 21,5; 3,28; 3,29; 98,72; 98,75; 69,16; 69,18; 69,21; 1,336; 1,337; Member does not exist + - Member is AD Unaware Fabric OS Command Reference 19 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 48
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 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 49
) and manages AG-specific operations. Port group. • Display all policies and their status. • Enable or disable Auto Port configuration policy. • Enable or disable preferred Secondary N_Port policy. • Enable, disable, and manage Advanced Device Security (ADS) policy. Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 50
are saved persistently as config keys. Use the portCfgnPort command to set a port as N_Port. 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 mode, the only two actions - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 51
N_Port mapping. Displays 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 N_Ports. It cannot be removed or renamed. Fabric OS Command Reference 23 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 52
port group with the specified new name. Port Group ID must not exceed 64 characters. Deletes the specified port group. The N_Ports in the Port Group that was deleted are moved to the default Port . Failover is displayed as enabled (1) or disabled (0). 24 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 53
(0) or enabled (1). --prefset "F_Port [;F_Port2;...]" N_Port Sets the preferred Secondary N_Port for one or more F_Ports. N_Port can be configured. The list of F_Ports to be mapped must be enclosed in quotation marks. Port numbers must be succeed. Fabric OS Command Reference 25 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 54
enabled on N_Ports 9 and 12: switch:admin> ag --show Name : switch_ST1 NodeName : 10:00:00:05:1e:35:9b:e7 Number of Ports : 16 IP Address(es) : 10.115.74.53 Firmware Version : v6.0.0 N_Ports : 4 3 10 0x6d0c02 10:00:00:06:2b:0a:a3:93 2 0 26 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 55
auto All Port related configurations will be lost. Please save the current configuration using configupload. Do you want to continue? (yes, y, no, n): [no] y 5. To disable auto policy when the switch is disabled: switch:admin> ag --policydisable auto Default factory settings will be restored - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 56
the new mappings: switch:admin> ag --mapshow N_Port Configured_F_Ports Current_F_Ports Failover Failback PG_ID PG_Name 0 4;6 4;6 1 0 2 SecondFabric 1 7;8;9 7;8;9 0 1 0 pg0 2 5;10;11 5;10;11 1 0 2 SecondFabric 3 12;13 12;13 0 1 0 pg0 28 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 57
on N_Port 0 is not supported switch:admin> ag --failbackdisable 2 Failback policy is disabled for port 2 admin> ag --failbackshow 2 Failback on N_Port 2 is not supported switch:admin> ag --failbackenable 2 Failback policy is enabled for port 2 ag 2 Fabric OS Command Reference 29 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 58
rename port group with pgid 2 to "MyEvenFabric" switch:admin> ag --pgrename 2 MyEvenFabric Port Group 2 has been renamed as MyEvenFabric successfully switch:admin> ag --pgshow PG_ID N_Ports PG_Name 0 None pg0 2 0;2 MyEvenFabric 3 1;3 FirstFabric Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 59
Allow Lists of the F_Port[s] 3. To add a two new device to the lists of allowed devices for ports 1 and 9: switch:admin> ag --adsadd "3;9" "20:03:08:00:88:35:a0:12;21:00:00:e0:8b:88:01:8b" WWNs added successfully to Allow Lists of the F_Port[s] Fabric OS Command Reference 31 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 60
2 ag See Also 4. 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:00:88:35:a0:12 11 NO ACCESS 12 NO ACCESS 13 ALL ACCESS portCfgNPort, portCfgNPIVPort 32 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 61
34:e4:bd N-Port ID(s) : 0x010200 Number of Ports : 16 IP Address(es) : 10.202.90.231 Firmware Version : v1.0.0 N-Ports : 1 F-Ports : 2 Attached F-Port information: PortID Port WWN 0x010208 10:00:00:00:c9:3f:7c:86 0x01020a 10:00:00:00:c9:3f:7c:b9 Fabric OS Command Reference 33 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 62
: switch:admin> agshow --local Worldwide Name Ports Enet IP Addr Firmware Local/Remote Name 10:00: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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 63
change to be preserved across switch reboots, save the zone configuration to nonvolatile memory with cfgSave. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 64
change to be preserved across switch reboots, save the zone configuration to nonvolatile memory with the cfgSave command. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 65
change to be preserved across switch reboots, save the zone configuration to nonvolatile memory with the cfgSave command. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 66
change to be preserved across switch reboots, save the zone configuration to nonvolatile memory with the cfgSave command. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 67
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. Operands When invoked without operand, this command displays all zone configuration information - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 68
) are optimized for most SAN applications; in most environments, there is no need to modify the default policy. Distributed path selection (DSP) is supported in logical fabrics. APT policy settings affecting the DPS behavior can be configured per logical switch, and settings apply to the partition - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 69
. switch:admin> switchenable switch:admin> aptpolicy Current Policy: 3 0(ap) 3 0(ap): Default Policy 1: Port Based Routing Policy 3: Exchange Based Routing Policy 0: AP Shared Link Policy 1: AP Dedicated Link Policy See Also dlsReset, dlsSet, dlsShow, switchDisable Fabric OS Command Reference 41 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 70
. This operand is optional. Examples To configure the audit log filter, disable audit logging, and show the configuration: switch:admin> auditcfg --class 2,3 Audit filter is configured. switch:admin> auditcfg --disable Audit filter is disabled. 42 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 71
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 43 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 72
started. 2 AUDIT, 2008/08/11-13:17:30 (UTC), [SULB-1003], INFO, FIRMWARE, NONE/NONE/NONE/None/CLI, None/sw48000_100/FID CHASSIS, , Firmwarecommit has started. [output truncated] To clear the audit log: switch:admin> auditdump -C See Also auditCfg 44 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 73
in place. Refer to 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: --show --set value Displays local authentication configuration. Modifies the - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 74
the system for 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 75
a slash (/). portnumber Specify the port number. On enterprise-class platforms, use the slotnumber/portnumber format for specifying the port number. allE Specify all E_Ports in the switch. Examples To display authentication configuration on the switch: switch:admin> authutil --show AUTH TYPE - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 76
to ON 2008/03/24-23:13:06, [AUTH-1003], 112,, INFO, Stealth_3, Device authentication type has been successfully set to ON To start authentication on E/F_Ports 2, 3, and 4: switch:admin> authutil --authinit 2,3,4 To disable md5 hash type for FIPS configuration: switch:admin> authutil --show AUTH - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 77
new 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 116 characters. Examples To set a new banner for a switch: switch:admin> bannerset "My banner" switch:admin> bannerSet Please input - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 78
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 banner for a switch: switch:admin> bannershow Banner: Do not log into this switch if you are not an authorized administrator - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 79
In this example, from a switch with 128 ports, the member ports consist of ports 7, 13, 42, 84, 85, and 86. The final Member Ports bit set represents the embedded port (frames sent to be handled by firmware) and is typically set. See Also portRouteShow Fabric OS Command Reference 51 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 80
displays the Blade as ENABLED, , because ports may not be physically located on the local 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 81
VACANT 4 SW BLADE 2 ENABLED (User Ports Disabled) 5 CP BLADE 1 ENABLED 6 CP BLADE 1 ENABLED 7 SW BLADE 2 ENABLED 8 UNKNOWN VACANT 9 UNKNOWN VACANT 10 UNKNOWN VACANT switch:admin> bladeenable 4 slBlade 4 is being enabled...Done Fabric OS Command Reference 53 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 82
2 bladeEnable See Also switch:admin> slotshow Slot Blade Type ID Status 1 SW BLADE 2 ENABLED 2 UNKNOWN VACANT 3 UNKNOWN 10 UNKNOWN VACANT bladeDisable, chassisDisable, chassisEnable, portEnable, portDisable, switchDisable, switchShow 54 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 83
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 1, "Using Fabric OS - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 84
Brocade Encryption platforms, ports 80-103 are the only valid ports, because these are the only blade ports with access to the Vader chip. Refer to the itemlist help page for further information on the itemlist parameter. Examples To run the test on blade ports 80-90 with one frame: switch:admin - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 85
A previously initialized port went to an un-initialized state. STATS Errors were found in the ASIC statistics. TIMEOUT Did not receive a frame in the given timeout period. XMIT Frame transmission failure. See Also itemlist. portLoopbacktest Fabric OS Command Reference 57 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 86
is currently supported only on the Brocade Encryption platform. It complements the turboramTest, 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, "Using Fabric OS commands - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 87
is required: slotnumber Specify a nonzero value for the slot number from which to clear burn-in errors. Examples To clear burn-in errors from slot 2: switch:admin> burninerrclear 2 See Also burninErrShow Fabric OS Command Reference 59 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 88
is required: slotnumber A nonzero value that specifies the slot number from which to display burn-in errors. Examples To display burn-in errors from slot 2: switch:admin> burninerrshow 2 See Also burninErrClear 60 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 89
-show If specified, or if level is not specified, the current burn-in level setting displays. Examples To set the diagnostic burn-in level: switch:admin> burninlevel -show Burnin level is 0. See Also burninErrShow, diagDisablePost, diagEnablePost Fabric OS Command Reference 61 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 90
18 41 920 18 41 923 11 34 926 Script burnin burnin burnin burnin To display the burn-in status for slot 3: switch:admin> burninstatus --slot 3 Slot State Status Run Cmd TotCmds PID 3 ABORT PASS 3 18 41 923 Script burnin See Also none 62 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 91
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 effective zone configuration information: switch:admin> cfgactvshow Effective configuration: cfg: c4 zone: z3 33:07 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 92
must be separated by semicolons. Examples To add two new zones to the configuration "Test_cfg": switch:admin> cfgadd "Test_cfg", "greenzone; bluezone" See Also cfgClear, cfgCreate, cfgDelete, cfgDisable, cfgEnable, cfgRemove, cfgSave, cfgShow 64 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 93
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. When an FCS policy is enabled, this command can be issued only from the primary FCS switch. Operands none Examples To - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 94
member lists are not allowed. Examples To create a configuration containing three zones: switch:admin> cfgcreate "USA_cfg", "Purple_zone;Blue_zone;Green_zone" See Also cfgAdd, cfgClear, cfgDelete, cfgDisable, cfgEnable, cfgRemove, cfgSave, cfgShow 66 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 95
" Specify a name for the zone configuration to be deleted, in quotation marks. Examples To delete a zone configuration: switch:admin> cfgdelete "USA_cfg" See Also cfgAdd, cfgClear, cfgCreate, cfgDisable, cfgEnable, cfgRemove, cfgSave, cfgShow Fabric OS Command Reference 67 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 96
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. Operands none Examples To disable the current zone configuration: switch:admin> cfgdisable You - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 97
new configuration replaces the previous configuration. Refer to the cfgShow command for a description of defined and effective configurations. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 98
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" and - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 99
to be preserved across switch reboots, save the configuration to nonvolatile memory with the cfgSave command. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 100
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. Operands none Examples To save a zone configuration: switch:admin> cfgsave You are about - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 101
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 ,64 [output truncated] ... Effective configuration: cfg: switch set zone: switch1 dd:dd:dd:dd - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 102
is enabled with "No Access" mode, "No Effective configuration: (No Access)" is displayed. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 103
20:37:0c:71:df To display only configuration names: switch:admin> cfgshow "*" cfg: USA1 Blue_zone cfg: USA_cfg Red_zone; Blue_zone See Also cfgAdd, cfgClear, cfgCreate, cfgDelete, cfgDisable, cfgEnable, cfgRemove, cfgSave, cfgTransAbort, cfgTransShow Fabric OS Command Reference 75 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 104
includes both the defined and effective configurations. This size is displayed in bytes. Examples To display zone database information in non-AD255 context: switch:admin> cfgsize Zone DB max size - 1045274 bytes committed - 244 transaction - 0 76 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 105
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 available - 1041884 bytes Total AD and Zone Transaction buffer ): See Also ad, cfgShow, zoneHelp Fabric OS Command Reference 77 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 106
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. When an FCS policy is enabled, this command can be issued only from the primary FCS switch. Operands When invoked without - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 107
no, n): [no] y Clearing All zoning configurations... switch:admin> cfgtransshow Current transaction token is 271010736 It is abortable See Also cfgAdd, cfgClear, cfgCreate, cfgDelete, cfgDisable, cfgEnable, cfgRemove, cfgSave, cfgShow, cfgTransAbort Fabric OS Command Reference 79 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 108
the current value is displayed. Examples To turn chassis beaconing mode on: switch:admin> chassisbeacon 1 Chassis beacon success 1 See Also To turn beaconing mode off: switch:admin> chassisbeacon 0 Chassis beacon success 0 switchShow, switchbeacon 80 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 109
a Brocade 48000 director: switch:admin> chassisconfig Current Option: 5 All Supported Options Option 5: One 384-port switch Blade ID's 17, 18, 24, 31, 33, 36, 39, 37, 51, 55 in slots 1-4, 7-10 Blade ID 16 in slots 5-6 See Also configDownload, configUpload, slotShow Fabric OS Command Reference 81 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 110
Virtual Fabric-aware chassis. All Fibre Channel ports that passed the power-on self test (POST) are enabled. They may come online if connected to a device, or remain offline if disconnected. Use chassisEnable to re-enable the chassis after making configuration changes or running offline diagnostics - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 111
user ports in a chassis. Synopsis chassisdisable [-force] Description Use this command to disable a Virtual Fabric-aware chassis. All Fibre Channel ports are taken offline. This command prompts for confirmation unless the -force option is used. If the chassis is partitioned into logical switches - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 112
characters. Spaces are not permitted. This operand is optional; if omitted, the current chassis name displays. Examples To change the chassis name to "dilbert": switch:admin> chassisname dilbert switch:admin> chassisname dilbert See Also switchName 84 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 113
Object type: CHASSIS, FAN, POWER SUPPLY, SW BLADE (switch), CP BLADE (control processor), WWN (World Wide Name), set, these lines are suppressed. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 114
2 chassisShow Examples To display all FRUs for a switch: switch:user> chassisshow Chassis Backplane Revision: 1C SW BLADE Slot: 3 Header Version: Power Consume Factor: Factory Year: 2001 Day: 15 Month: 7 Year: 2001 88 days 16 days See Also slotShow 86 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 115
this command is 512. The CLI history is erased, if the switch is rebooted or a CP failover has occurred on the active CP. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 116
configuration settings to their factory defaults. Beginning with Fabric OS v6.2.0, configuration data is grouped into chassis information and switch information. Each configuration type is managed separately. For information on file format and specific parameters contained in each section, refer - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 117
to create new tunnels or modify the existing ones. When issuing configDefault on the Brocade 7500, it persistently disables the ports. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 118
USB device. Beginning with Fabric OS v6.2.0, configuration data is grouped into chassis information and switch information. Each configuration type is managed separately. For information on file format and specific parameters contained in each section, refer to the configUpload help page. The - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 119
Virtual Fabric-capable to a system in Virtual Fabric mode is not recommended. The configuration is applied to the default switch only, and only to the ports that are part of the default switch. If an FCS policy is enabled, the following rules and restrictions apply: • Both [Defined Security Policies - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 120
to reflect the new zoning configuration. 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. Do not manually edit a configuration file after - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 121
fid 8 -USB config.txt To download switch configurations belonging to a logical switch with FID 4 to a logical switch with FID 8 from an attached USB device (requires chassis permissions): switch:admin> configdownload -fid 8 -sfid 4 -USB config_fid8.txt Fabric OS Command Reference 93 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 122
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 94 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 123
of configuration files stored on the local chassis: switch:admin> configlist -local config.txt config2.txt next_cfg.txt 25679 25679 20977 2007 Jan 02 15:16 2007 Jan 06 15:16 2007 Jan 18 15:16 See Also configDownload, configUpload, configShow, configRemove Fabric OS Command Reference 95 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 124
-local first_config.txt To remove a configuration file from an attached USB device without specifying a filename: switch:admin> configremove -USB File Name [config.txt]: second_config.txt See Also configDownload, configUpload, configList, configShow 96 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 125
set by the configure and configureChassis commands. Beginning with Fabric OS v6.2.0, configuration data is grouped into chassis information and switch information. Each configuration type is managed separately. For information on file format and specific parameters contained in each section, refer - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 126
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 passwdcfg.sequence:1 passwdcfg.status:0 fips.mode:0 98 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 127
rule.5:0,0x23,0,0,6,111 ipfilter.0.rule.6:0,0x23,0,0,6,80 ipfilter.0.rule.7:0,0x23,0,0,6,443 ipfilter.0.rule switch configuration data for FID 20: switch :admin> configshow -fid 20 [Configuration upload Information] Configuration Format = 2.0 date = Tue Oct 7 14:53:12 2008 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 128
19:0x0 ag.port.nfporttopo.2:0x0 ag.port.nfporttopo.20:0x0 [output truncated] See Also agtCfgShow, configure, configureChassis, configDownload, configUpload, configList, configRemove, diagDisablePost, diagEnablePost, ipAddrShow, licenseShow, syslogdIpShow 100 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 129
upload. You can download a v6.1 configuration to a switch running v6.2 firmware, but a v6.2 configuration file is not accepted by a switch running pre-v6.2 firmware. For more information on compatibility, refer to the Fabric OS Administrator's Guide. The configuration file is divided into sections - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 130
, switch firmware version, time stamp, and number of logical switches. This section is the same in the switch configuration file. [fcRouting] Contains the Fibre Channel Router configuration. [chassis configuration] Contains configuration parameters relating to passwords, SNMP, ipFilter settings - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 131
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. Do not manually edit a configuration file after uploading the file and before downloading the - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 132
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, configShow, configList, configRemove, configure, configureChassis 104 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 133
to change switch configuration settings. Beginning with Fabric OS v6.2.0, configuration data is grouped into chassis information and switch information. Each configuration type is managed separately. For information on file format and specific parameters contained in each section, refer to the - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 134
, such as buffer-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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 135
out value for a WAN, if any, interconnecting the Fibre Channel islands. Maximum hops is an integer that denotes the upper limit on the number of hops a frame might have to traverse to reach any destination port from any source port across the fabric. Fabric OS Command Reference 107 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 136
by the per-port configuration on the E_Ports of each ISL. Both E_Ports in an ISL must be configured to run the same long-distance level; otherwise, the fabric will be segmented. An Extended Fabrics license is required to set this mode. BB Credit The buffer-to-buffer (BB) credit represents the - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 137
2 Virtual Channel Settings The switch enables fine-tuning for a specific application by configuring the parameters for eight virtual channels. The first two virtual channels are reserved for switch internal functions and are not available for modification. The default virtual channel settings have - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 138
switch IP address or name change. Arbitrated Loop Parameters The Arbitrated Loop Setting fields are described inTable 7. TABLE 7 Configure command arbitrated loop settings address. When set to 1, frames are sent; when set to 0, frames are not sent. 110 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 139
boolean boolean number not set not set 128 none no yes yes 7200 varies varies 40, 56, 128 varies no/yes yes/no yes/no 60 to 432000 Examples To enable XISL use on a logical switch with FID 20: switch:admin> setcontext 20 switch:admin>switchdisable Fabric OS Command Reference 111 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 140
Level Switching: (0..1) [0] Disable Device Probing: (0..1) [0] Suppress Class F Traffic: (0..1) [0] Per-frame Route Priority: (0..1) [0] Long Distance Fabric: (0..1) [0] BB credit: (1..27) [16] Disable FID Check (yes, y, no, n): [no] Virtual Channel parameters (yes, y, no, n): [no] F-Port login - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 141
a non-Virtual Fabric environment, disable the switch before configuring chassis parameters. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 142
.bladeFaultOnHwErrMsk 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 Configure... cfgload attributes (yes, y, no - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 143
and manage the Brocade Encryption Switch and the FS8-18 encryption blade. These platforms support the encryption of data-at-rest for tape devices and disk array logical unit numbers (LUNs). The cryptoCfg CLI consists of five command sets grouped around the following configuration functions: "1. Node - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 144
encryption switch or blade. • Certificate display and management. Note The initial setup includes preparatory steps that are outside the scope of the cryptoCfg command. For pre-initialization procedures, refer to the Fabric OS Encryption Administrator's Guide. 116 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 145
, and the FIPS User key pairs. Some of the certificates generated with this command may need to be exported so that they can be registered with external entities, such as the key vault or the group leader, for mutual authentication. Refer to the Fabric OS Encryption Administrator's Guide for details - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 146
the IP address of the host to which the file is to be exported. To specify the host by name, it must first be configured with dnsconfig. host_username Specifies the user name for the host. Depending on your host configuration, the command may prompt for a password. 118 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 147
must be performed for all nodes that participate in a two-way certificate exchange-based authentication mechanism with key vaults. Fabric OS v6.2.0 supports two-way certificate exchange only for the HP SKM key vault. -CPcert Exports the member node CP certificate. --import Imports a certificate - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 148
Management (LKM) appliance. This command generates the Diffie-Hellman challenge that is passed from the node to the specified NetApp LKM appliance. This command is valid on all nodes. Specifies the IP address of the NetApp LKM appliance. This operand is required. 120 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 149
-localEE -file -all Displays node configuration information. This command requires one of the set -keyvault LKM | RKM | SKM cryptocfg --set -failbackmode auto | manual cryptocfg --set -hbmisses value cryptocfg --set -hbtimeout value cryptocfg --add -membernode node_WWN Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 150
mode: Auto or Manual - Heartbeat misses: value - Heartbeat timeout: value in seconds • For each configured key vault, primary and secondary, the command shows: - IP address - Certificate ID - Certificate label: user-generated file name - State: connected, disconnected, up, authentication failure, or - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 151
RKM is configured) or primary link key ID (if LKM is configured). - Alternate master key ID (if RKM is configured) or secondary link keyID (if LKM is configured). - HA cluster name to which this encryption engine belongs, or "No HA cluster membership". Fabric OS Command Reference 123 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 152
, the same subnet, and the same VLAN. Configure the GbE Ports (I/O sync links) with an IP address for the eth0 Ethernet interface, and also configure a gateway for these I/O sync links. Refer to the ipAddrSet help page for instructions on configuring the Ethernet interface. These I/O sync link - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 153
has been restored or replaced. Automatic failback mode is enabled by default. manual Enables manual failback. In this mode, failback must be initiated manually after an encryption switch or blade that failed earlier has been restored or replaced. Fabric OS Command Reference 125 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 154
an encryption group before the node is declared unreachable. This value is set in conjunction with the time-out value. It must be configured at the group leader node and is distributed to all member nodes in to succeed. To remove a node that is 126 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 155
HA cluster and delete any CryptoTarget container and Crypto LUN configurations from this node prior to initiating a leave operation. attached key vaults, or optionally to a predetermined file on the switch. This command is valid only on the group leader. This OS Command Reference 127 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 156
a new configuration or a configuration change. Refer to section "5. Transaction management" for more information. Any operation related to an HA cluster performed without a commit operation will not survive across switch reboots, power cycles, CP failover, or HA reboots. 128 Fabric OS Command - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 157
as the group leader on which this command is issued. This command fails if the member nodes' IP addresses for the GbE Ports (I/O sync ports) are not configured. The following operands are supported: HA_cluster_name Specifies the name for the HA cluster. The name can be up to 31 characters long - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 158
the switch or operands are supported with configuration data is displayed. The following operands are mutually exclusive: -all Displays configuration information for all HA clusters. HA_cluster_name Displays configuration information for a specified HA cluster. 130 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 159
cryptoCfg 2 Function 4. Storage device configuration and management Synopsis cryptocfg --help -devicecfg cryptocfg --create -container disk | tape cryptocfg --discoverLUN crypto_target_container_name cryptocfg --show -container -all -cfg | -stat Fabric OS Command Reference 131 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 160
they take effect. Use the cryptocfg --commit command to commit the transaction. Refer to section "5. Transaction management" on page 148 for more information. This command set supports the following tasks: 1. Configure and manage CryptoTarget containers (CTCs). Create, move, or delete a CTC, add or - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 161
port WWN - VI PID: virtual initiator PID - Number of LUNs - LUN number - LUN type: disk or tape - LUN serial number: - Encryption mode: encrypt or cleartext - Encryption format: (brocade -cfg command for configuration information on all user-defined name Fabric OS Command Reference 133 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 162
for all Tape pools or for a specific tape pool. For each tape pool, the display includes the following information: • tape pool Label • Key Life: Life span in minutes • Encryption mode: encrypt or cleartext • Encryption format: native or DF compatible 134 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 163
Admin Guide, Appendix - Encryption algorithm: AES256 -XTS (disk), AES256-CCM (tape), or none - Compression algorithm - Key ID state - Key ID When used with -cfg the --show -LUN command displays LUN configuration information: • EE node: node WWN • EE slot: EE slot number Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 164
policy configuration details: - Tape pool or tape - Encryption or Cleartext - Key life span in days - Encryption Algorithm - Compression Algorithm • Number of Tape sessions in progress • For each Tape session the display includes: - Tape Session Number 136 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 165
all re-key sessions in progress for a specific Crypto LUN/initiator pair of a specific CryptoTarget container. The display includes the following information: • LUN number • LUN Serial Number (SN) • CryptoTarget container Name: user-defined name Fabric OS Command Reference 137 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 166
specific container. The display includes the following information: • Number of tape sessions in progress • Container name: user-defined label • EE node name: node WWN • EE Slot Number • Target PWWN • Target NWWN • Target PID • VT PWWN • VT NWWN • VT PID • Host PWWN 138 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 167
zone. 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 tape storage container depending on the target device. These operands are mutually exclusive. Fabric OS Command Reference 139 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 168
. target_PWWN Specifies the target port WWN of the device port hosted on the encryption engine CTC names. --failback -EE Performs a manual failback of all CTCs that were failed over the current encryption engine or the new encryption engine are offline. This OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 169
systems, specify the slot number of the new encryption engine. --move -container Moves the specified CTC from its currently configured encryption engine to another encryption engine. This be removed. initiator_PWWN Specifies the initiator port WWN. Fabric OS Command Reference 141 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 170
Range parameter is not supported for 64-bit LUN numbers configured. Refer to the Fabric OS Encryption Administrator's Guide for more information. The following LUN policy parameters can be optionally set: -lunstate encrypted | cleartext Sets for LUNS encrypted in Brocade native mode. However for - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 171
the Brocade metadata DataFort-compatible license to be present on the encryption switch or the chassis that houses the encryption blade. automatic re-keying is valid only if the LUN policy is set to encrypt. You must specify a time_period in days when OS Command Reference 143 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 172
LUNs once it has been set. • Exercise caution when modifying policy parameters while tape sessions are in progress. For information on the impact of encryption policy changes while tape sessions are in progress, refer to the Fabric OS Encryption Administrator's Guide. --rem -LUN Removes a LUN from - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 173
enabling a LUN while metadata exist on the LUN may result in a loss of data and should be exercised with caution. Refer to the Fabric OS Encryption Administrator's Guide for a description of conditions under which a LUN may be disabled and recommendations for re-enabling the LUN while minimizing the - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 174
tape pool policy parameters while tape sessions 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 175
manual the initiator port WWN for supported: -all -cfg Displays the configuration configuration or runtime status information for a single tape pool specified either by a tape pool label or a number. These operands must be used with either the -stat or the -cfg option. Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 176
information for all tape sessions in progress for a specified CryptoTarget container. Function 5. Transaction management Synopsis cryptocfg --help transcfg cryptocfg --commit [-force] cryptocfg --transabort transaction_ID cryptocfg --transshow 148 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 177
procedures, refer to the Fabric OS Encryption Administrator's Guide. A. Node configuration To initialize a node and generate certificates (output shows what is generated and where it is stored): SecurityAdmin:switch>cryptocfg --initnode This will overwrite all identification and authentication data - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 178
): SecurityAdmin:switch>cryptocfg --dhchallenge 10.33.54.231 Operation succeeded. To issue the DH response to retrieve the TAP from the NetApp Lifetime Key Management (LKM) appliance. SecurityAdmin:switch>cryptocfg --dhresponse 10.33.54.231 Operation succeeded. 150 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 179
membership EE Attributes: EE Route Mode : PARTITIONED Media Type : DISK B. Encryption group configuration To create an encryption group "brocade": SecurityAdmin:switch> cryptocfg --create -encgroup brocade Encryption group create status: Operation Succeeded. To delete the encryption group - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 180
succeeded. To display the encryption group configuration: SecurityAdmin:switch>cryptocfg --show -groupcfg Encryption Group Name: brocade Failback mode: Manual Heartbeat misses: 3 Heartbeat timeout: 2 Key Vault Type: LKM Primary Key Vault: IP address: 10.33.54.231 Certificate - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 181
Role: MemberNode IP Address: 10.32.244.60 Certificate: enc1_cpcert.pem Current Master Key State: Not configured Current Master KeyID: 00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00 Alternate Master Key State:Not configured Fabric OS Command Reference 153 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 182
switch> cryptocfg --set -hbtimeout 10 Set heartbeat timeout status: Operation Succeeded. D. High Availability (HA) cluster configuration NOTE: HA cluster configuration commands must be committed before they take effect. To display existing HA clusters in the encryption group "brocade :switch> - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 183
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 Fabric OS Command Reference 155 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 184
:00:00:c9:2b:c9:3a; 20:0c:00:06:2b:0f:72:6d" FabricAdmin:switch> cfgcreate itcfg, itzone FabricAdmin:switch> cfgenable itcfg You are about to enable a new zoning configuration. This action will replace the old zoning configuration with the current configuration selected. Do you want to enable 'itcfg - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 185
00:00:00:c9:2b:c9:3a Operation Succeeded FabricAdmin:switch>cryptocfg --commit Operation Succeeded 4. Display the CTC configuration. FabricAdmin:switch>cryptocfg --show -container my_disk_tgt -cfg Container name: my_disk_tgt :1d VT PID: 012001 Fabric OS Command Reference 157 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 186
89:c6:4f Key creation time: Sun Jun 1 20:21:32 2008 Operation Succeeded 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: 10: 00:05:1e:41:4e:1d zone: red_______base 158 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 187
:53:68: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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 188
04:03:48 2008 Operation Succeeded To display CryptoTarget container configuration information For a disk LUN with re-keying enabled: FabricAdmin:switch>cryptocfg --show -LUN my_disk_tgt 0x0 10:00:00:db: minute) Rekey status: 0 Operation Succeeded 160 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 189
Also To display all tape sessions in progress on the local node: FabricAdmin:switch>cryptocfg --show -tape_sessions -all Number of tape session(s): 2 Container name: uncompressed bytes: 0 Number of compressed bytes: 0 Operation succeeded. None Fabric OS Command Reference 161 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 190
to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix streams you can use with diagnostics: switch:admin> datatypeshow Pattern type example BYTE_FILL bd 7b f6 ec d8 b0 60 c0 11 55 16 fc d7 17 65 a9 87 5f 44 be 5a d0 de - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 191
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 is to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 192
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 164 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 193
the debug and verbosity levels. Module names are case-sensitive. This operand is optional. Examples To display information about a specific module named NS: switch:admin> dbgshow NS Module NS, debug level = 1, verbose level = 1 See Also setDbg Fabric OS Command Reference 165 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 194
a user-specified zone configuration is enabled, it overrides the Default Zone access mode. Notes This command must be run 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 195
Sets admin> defzone --noaccess primaryfcs:admin> cfgsave primaryfcs:admin> defzone --show Default Zone Access Mode committed - No Access transaction - No Transaction primaryfcs:admin> cfgactvshow Effective configuration: No Effective configuration: (No Access) none Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 196
clear. If no operand is specified, the default is to clear all bad port flags. Examples To clear the diag software flag: switch:admin> diagclearerror 8 ERROR: DIAG CLEARERR Diagnostics Errors Cleared, port: 8/31 Err# 0120041 081F See Also none 168 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 197
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 POST: switch:admin> diagdisablepost Config update Succeeded Diagnostic POST - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 198
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 POST: switch:admin> diagenablepost Config update Succeeded Diagnostic POST - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 199
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 diagnostic command information: switch:admin> diaghelp bpportloopbacktest bpturboramtest burninerrclear burninerrshow burninstatus - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 200
diagPost Synopsis Sets or displays diagnostic POST configuration. diagpost [ switch:admin> diagpost Diagnostic POST is currently disabled. switch:admin> diagpost 1 Config update Succeeded Diagnostic POST is now enabled. See Also diagDisablePost, diagEnablePost 172 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 201
this operand to display the current mode setting. If no operand is specified, the current value is displayed. Examples To view the current retry mode value: switch:admin> diagretry -show Diagnostic Retry Mode is currently enabled. See Also none Fabric OS Command Reference 173 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 202
new value is specified, the current value is left unchanged. If a new value is entered, its value is updated and stored in the configuration Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS value Sets the command parameters: switch:admin> diagsetcycle switchburnin. - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 203
diagnostics status for the specified list of blade or user ports. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 204
the debug and verbosity levels. Module names are case-sensitive. This operand is optional. Examples To display information about a specific module named NS: switch:admin> dbgshow NS Module NS, debug level = 1, verbose level = 1 See Also setDbg 176 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 205
Control Policy PWD Password Database and Password Configuration Policy AUTH E_Port and F_Port Authentication Policy FCS Fabric Configuration Server Policy IPFILTER IP-Filter Policy Each supported database has a switch-local configuration parameter that controls whether the database can - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 206
AUTH and FCS policies to all switches in the fabric that run v5.3.0 or later: switch:admin> distribute -p "AUTH;FCS" -d "*" To distribute the AUTH and SCC policies to domains 1 and 3 in the fabric: switch:admin> distribute -p "AUTH;SCC" -d "1;3" fddCfg 178 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 207
aptPolicy for more information on routing policies. Operands none Examples To disable the dynamic load sharing option: switch:admin> dlsreset Committing configuration...done. switch:admin> dlsshow DLS is not set See Also aptPolicy, dlsSet, dlsShow Fabric OS Command Reference 179 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 208
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 dynamic load sharing option: switch:admin> dlsset switch:admin> dlsshow DLS is set See Also aptPolicy, dlsReset, dlsShow - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 209
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 DLS option setting: switch:admin> dlsshow DLS is set See Also dlsSet, dlsReset Fabric OS Command Reference 181 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 210
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 3 Remove - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 211
are platform-specific. Options that do not apply to a platform are identified with a "Not supported on this platform" message. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 212
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 error log messages: switch:admin> errclear See Also errDump, errShow 184 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 213
this command to set the error log configuration. These delimiters are stored persistently. 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 end delimiters: switch:admin> errdelimiterset delimiter - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 214
chassis: switch:admin> errdump -a Fabric OS: v6.2.0 2008/08/25-10:10:41, [SEC-1203], 9036, CHASSIS, INFO, Spir_67, Login information : Login successful via TELNET/SSH/RSH. IP Addr: 10.106.7.62 2008/08/25-10:13:41, [ZONE-1022], 9037, CHASSIS, INFO, Spir_67, The effective configuration has changed - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 215
: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, Spir_67, Previous message repeated 1 time(s) [output truncated] errDelimiterSet, errFilterSet, errShow Fabric OS Command Reference 187 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 216
sensitive. Examples To display the current filter settings: switch:admin> errfilterset console: filter severity = WARNING See Also To set the filter severity level for the console: switch:admin> errfilterset -d console -v warning errDump, errShow 188 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 217
: switch:user> errmoduleshow Module IDs: 1 KT 2 UT 5 LOG 6 CDR 9 PIXE 10 EGR 13 PS 14 RTE 17 BLDE 18 BLM 21 CFLD 22 CFMN (output truncated) 3 TRCE 7 BLPU 11 BL 15 AS 19 BPRT 23 CHPS 4 KTRC 8 PISP 12 PIC 16 AUTH 20 CER 24 CONF See Also errDump, errShow Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 218
, INFO, Spir_67, Login information : Login successful via TELNET/SSH/RSH. IP Addr: 10.106.7.62 [Type to continue, Q to stop: 2008/08/25-10:13:41, [ZONE-1022], 9037, CHASSIS, INFO, Spir_67, The effective configuration has changed to meh. 190 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 219
, Q to stop: 2008/08/25-11:35:04, [FABR-1001], 9041, CHASSIS, WARNING, Spir_67, port 0, incompatible Long distance mode. [Type to continue, Q to stop: 2008/08/25-11:39 > to continue, Q to stop: q errDelimiterSet, errDump, errFilterSet Fabric OS Command Reference 191 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 220
the serial port returns to the login: prompt. The 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 192 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 221
0x00000010 Overlapping zones 0x00000020 Done PTIO ioctl 0x00000040 Sent an RJT to ELP 0x00000080 BF received from the port 0x00000100 Port truly connected to E_Port 0x00000200 Segmented by routing code 0x00000400 FSPF has completed routing Fabric OS Command Reference 193 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 222
switch's port lr_tid Link reset timer identifier and current state. red_ports All E_Ports that are connected to the same neighboring switch Note 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 223
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:00:00:60:69:80:06:cf 5 0x1005dbd8, IDLE STATE Open commands pending No commands pending portShow fabPortShow 2 Fabric OS Command Reference 195 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 224
commands. The SW_ISL (ISL ports) information displays the retry 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 225
or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" switch:admin> fabriclog -s Time Stamp Input and *Action S, P Sn,Pn Port Xid Wed Apr 6 01:08:52 2005 01:08:52.977 SCN Switch ,NA NA NA 01:08:52.977 *Cancel 24 * F_S_TOV Timer F2,NA F2,NA NA NA - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 226
clear the logs. Are your sure you want to do the resize [y/n]? 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 fabPortShow, fabStatsShow 198 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 227
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 mechanisms provide a preference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 228
the mode setting: switch:admin> fabricprincipal 1 Principal Selection Mode enabled To enable the mode setting and force fabric rebuild: switch:admin> fabricprincipal -f 1 Principal Selection Mode enabled (Forcing fabric rebuild) See Also fabricShow 200 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 229
the fabric. Examples The following example illustrates a fabric of four switches. "sw180" is the Principal switch. Three of the switches are configured to run IP over Fibre Channel. switch:admin> fabricshow Switch ID Worldwide Name Enet IP Addr FC IP Addr Name 64: fffc40 10:00:00:60:69:00 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 230
:admin> fabricshow -m Switch ID Name ENET IP Addr FC Router FC Router IP Addr Name 1: fffc01 fcr_sprint_01 10.33.59.224 160: fffca0 fcr_fd_160 0.0.0.0 10.33.59.25 fcr_meteor2 190: fffcbe fcr_mojo_6 10.33.59.32 The Fabric has 3 switches switchShow 202 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 231
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 fabric statistics: switch:admin> fabstatsshow Description Count Domain ID - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 232
2 fabStatsShow Sec Incompatibility: 0 Sec Violation: 0 ECP Error: 0 Duplicate WWN: 0 Eport Isolated: 0 See Also fabRetryShow 204 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 233
display the fabric switch state structure information. This command is strictly for debugging; it is not intended as a user command. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 234
fan unit by setting the RPM speed to 0. Notes This command is not available on non-bladed systems except for the Brocade 4100, 4900, and 5300. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 235
not available on non-bladed systems except for the Brocade 4100, 4900, and 5300. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 236
on switch type and number of fans present. Note This command is not available on non-bladed systems except for the Brocade 4100, 4900, and 5300. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 237
is not available on non-bladed systems except for the Brocade 4100 and 4900. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 238
four user ports per port group (0-7 or 8-15) may be configured as FC Fastwrite. This amounts to a maximum of eight FC Fastwrite ports per blade. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 239
-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 Fabric OS Command Reference 211 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 240
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 Brocade FR4-18i blades and Brocade 7500 platforms. Operands This command has - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 241
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 213 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 242
in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display FCIP command information: switch:admin> fciphelp fastwritecfg portcfg portcmd portshow Configure FC fastwrite feature Create/Delete a new ip interface - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 243
by comparing Fibre Channel frames or data packets transmitted from and received by the network processor due to the designated loopback. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 244
data compression is used. This setting is applicable only to path mode 1 and 2. Examples To run the test on slot 2 with PHY loopback sending 10 frames: switch:admin> fcippathtest --slot 2 -path PATH_TEST_GE_PORT_DISABLE_ERR fcipChipTest 216 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 245
which is used for any LUN query from this switch: switch:admin> fclunquery -s The following WWNs will be used for any lun query from this switch: Node WWN: 10:00:00:60:69:e2:09:c8 Port WWN: 21:fd:00:60:69:e2:09:c8 fosConfig, iscsiCfg, iscsiPortCfg Fabric OS Command Reference 217 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 246
fabric and is useful for validating link connectivity. The source and destination port identifiers can be specified as a 24-bit Fibre Channel port identifier, a port World Wide Name, or a node World Wide Name. The two port identifiers are then used to determine if the identifiers are zoned together - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 247
. This is useful for diagnosing data-dependent problems in the fabric link. The pattern bytes are displayed. Specifies the source port ID, port WWN, or node WWN. This device that does not respond to the request: switch:admin> fcping 0x020800 22:00:00:04:cf:75: OS Command Reference 219 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 248
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 0.0.0.0 "mps_daz_1" 55: fffc37 10 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 249
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:3f:7c:b8 [0x370501] with 12 bytes of data: received reply from 20:00:00:00:c9:3f:7c:b8: 12 bytes time:825 -trip min/avg/max = 713/774/880 usec ping Fabric OS Command Reference 221 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 250
to clear the debug information logged by the Fibre Channel Protocol 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 251
disable the logging of debug information by the Fibre Channel Protocol 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 252
Use this command to enable Fibre Channel Protocol daemon (FCPD) logging. Debug information logging is enabled 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 253
logged at various stages during the Fibre Channel Protocol daemon (FCPD) device probing. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 254
and SCSI INQUIRY commands sent over this port and a list of the attached devices. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 255
the Fibre Channel Protocol ports. This operand is required. Examples To display the FCP RLS information: switch:admin> fcprlsshow 2/5 0xda 0xdc link fail 0 0 loss sync 5 3 loss sig 0 0 prtc err 0 0 bad word 525 330 crc err 0 0 See Also portLoginShow, portLogShow Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 256
fcr:admin> fcrbcastconfig --disable -f 2 To display the new configuration: fcr:admin> fcrbcastconfig --show Broadcast configuration is disabled for FID: 2 33 128 To enable broadcast frame forwarding for FID 33: fcr:admin> fcrbcastconfig --enable -f 33 228 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 257
To display the new configuration: switch:admin> fcrbcastconfig --show Broadcast configuration is disabled for: fid 2 fid 128 SEE ALSO bcastshow, portRouteShow fcrBcastConfig 2 Fabric OS Command Reference 229 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 258
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 Brocade FR4-18i blades and Brocade 7500 platforms. Operands This command has - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 259
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 BIST_TIMEOUT BIST_FAIL fcrPathTest, portLoopbackTest Fabric OS Command Reference 231 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 260
using the switchShow command. Examples To configure FC Router parameters: fcr:admin> fcrconfigure FC Router parameter set. to skip a parameter Backbone fabric ID: (1-128)[100] See Also fosConfig, switchDisable, switchEnable, switchShow 232 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 261
:1e:41:1c:73, Dom ID: 4, Info: 10.33.36.12, "ttv12" EX_Port FID Neighbor Switch Info (enet IP, WWN, name) 9 2 10.33.35.80 10:00:00:05:1e:38:01:e7 "B10_3" 10 2 10.33.35.80 10:00:00:05:1e:38:01:e7 "B10_3" Fabric OS Command Reference 233 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 262
Neighbor Switch Info (enet IP, WWN, name) 16 80 10.32.66.180 10:00:00:05:1e:34:e8:46 "b4100_7x_1" 180::10:32:66:180 27 80 10.32.69.180 10:00:00:05:1e:37:12:e0 "Sprint_180" See Also fcrPhyDevShow, fcrProxyDevShow, fcrRouteShow, lsanZoneShow, switchShow 234 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 263
Fabric OS v6.2.0 or later. • The switch must be disabled when you configure enforce tags. Speed tags can be configured while the 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 in - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 264
switch:admin> fcrlsan --show -speed Total LSAN tags : 1 SPEED: mcdt switch:admin> fcrlsan --show -all Total LSAN tags : 3 ENFORCE : brocade ENFORCE : cisco SPEED: mcdt See Also fcrFabricShow, lsanZoneShow, fcrPhyDevShow, fcrProxyDevShow, fcrRouteShow, switchShow 236 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 265
. In addition, downgrading to a firmware version lower than v5.3 is blocked if the LSAN count is set to 5000. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 266
OS v6.1 switches, the information is saved only locally. 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 the backbone fabric. 238 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 267
saved value. • Display the information that is saved in the persistent memory (CLI command with no option). • Display the static and default/dynamic binding of the to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 268
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 01f001 78 4e0000 Imported 240 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 269
:91:24:dd: refer to the man page for the corrective action." Corrective actions: • Any new router added to backbone fabric automatically triggers a matrix merge. If a router does not support the matrix merge feature, the router can not join the backbone fabric. Make sure that all legacy FCR switches - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 270
on all the FCR switches in the backbone. • In a dual backbone configuration, use fcrlsanmatrix --fabricview on the FCR switches to confirm that the shared edge fabric FIDs have the same access in both backbones. Refer to the Fabric OS Message Reference manual for further diagnostic information - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 271
FC Router field-programmable gate array (FPGA) and the central ASIC by sending frames from the FC Router FPGA port N transmitter, and looping the frames back into the same port , ... CRPAT 0xbc, 0xbc, 0x23, 0x47, ... RANDOM0x25, 0x7f, 0x6e, 0x9a, ... Fabric OS Command Reference 243 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 272
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. The switch must be offline for this - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 273
SFP or indicate deeper problems in the main board or ASIC. Check for a faulty SFP. Replace the SFP if necessary. The specified port failed to transmit frames. This usually indicates an ASIC failure. Replace the blade or the switch. See Also fcrChipTest, portLoopbackTest Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 274
PID The port ID of the physical device. This port ID is only relevant on the fabric specified by the "Device Exists in Fabric" column. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 275
2 Examples To display the physical devices relevant to this FC Router: fcr:admin> fcrphydevshow Device WWN Physical Exists PID in Fabric 2 10 displayed: 3 See Also fcrFabricShow, fcrProxyDevShow, fcrRouteShow, lsanZoneShow, switchShow Fabric OS Command Reference 247 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 276
device configuration; otherwise, it sets the specified attributes to its new value. The proxy device must be inactive prior to setting 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 277
the persistent proxy device configuration: switch:admin> fcrproxyconfig Imported FID 002 switch:admin> fcrproxyconfig -r 5 00:11:22:33:44:55:66:77 WWN deleted from proxy device slot See Also fcrPhyDevShow, fcrProxyDevShow, fcrXlateConfig, lsanZoneShow, switchShow Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 278
Fibre Channel device. It has a name server entry and is assigned a valid port ID. Proxy device information is available only for proxy devices that are presented by FC Routers on the same backbone fabric as this FC Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 279
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 fcrFabricShow, fcrProxyDevShow, fcrRouteShow, lsanZoneShow, switchShow Fabric OS Command Reference 251 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 280
Description Use this command to display the FC Router-available resources. The maximum number phantom switch node WWNs. The phantom switch requires node WWNs for fabric-shortest-path-first (FSPF) and manageability port for routing decision purposes. 252 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 281
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 resource usage for the local FC Router: switch:Admin> fcrresourceshow Daemon Limits: LSAN Zones: LSAN Devices: Proxy - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 282
cost. In other words, 1 Gbps, 2 Gbps, 4 Gbps, and 8 Gbps EX_Port IFLs have the same cost value of 1000 as their FC Router port. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 283
7/10 Port Cost 7/10 10000 To set the default cost on the EX_port: switch:admin> fcrrouterportcost 7/10 0 switch:admin> fcrrouterportcost 7/10 Port Cost 7/10 1000 See Also switchShow, fcrRouteShow, portCfgEXPort fcrRouterPortCost 2 Fabric OS Command Reference 255 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 284
Dest. Fabric The World Wide Name of the principal switch in the destination 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 285
ID. You can set the preferred domain ID when the translate domain is not active and is persistently saved. The principal switch attempts to provide the 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 286
the translate domain configuration and the state of the persistxd parameter: switch:admin> fcrxlateconfig ImportedFid ExportedFid Domain 001 002 004 001 005 003 OwnerDid 000001 N/A XlateWWN N/A 50:00:51:e1:30:30:0f:05 Persist XD state: Enabled 258 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 287
fcrXlateConfig 2 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 288
-wide consistency policy. Switches can be locally configured to allow or reject a security policy. Supported policies are Switch Connection Control (SCC), Device Connection Control (DCC), Password (PWD), Fabric Configuration Server (FCS), Fabric Element Authentication (AUTH), and IP Filter (IPFILTER - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 289
Device Connection Control (DCC), and Fabric Configuration 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 290
FDMI cache: switch:admin> fdmicacheshow Switch entry for domain 3 state: known version: v310 wwn: 10:00:00:60:69:90:03:c7 HBAs: 10:00:00:00:c9:25:9b:96 Ports: 1 10:00:00:00:c9:25:9b:96 Total count of devices on the switch is 1 See Also fdmiShow 262 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 291
PCI Fibre Channel Adapter Hardware Version: 00000001 Driver Version: SLI-2 SW_DATE:May 3 2002, v5-2.11a2 **CT_TEST 1** Firmware Version: 03814101 OS Name and Version: Window 2000 Max CT Payload Length: 0x00061300 Local Port database contains: 10:00:00:00:c9:25:9b:96 Remote HBA database contains - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 292
To clear the RLIR database: switch:user> ficonclear RLIR successfully clear local RLIR Database. To clear the RNID database: switch:user> ficonclear RNID successfully clear not current entries from local RNID Database. See Also ficonHelp, ficonShow 264 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 293
to display current settings. Notes FICON Management Server (FMS) mode cannot be enabled if port ID (PID) Format 2 is used. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 294
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 266 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 295
Port) parameters for a 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 set (1) or not set (0). Valid values for bitname are: POSC Programmed offline state control UAM User alert - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 296
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 268 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 297
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 FICON commands: switch:admin> ficonhelp ficonclear Clears contents of the specified FICON management database ficoncupset Sets FICON-CUP - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 298
Indicates the node ID of the storage port for RNID switch for SwitchRNID is valid. 0x10 Indicates the node ID of the channel port is valid. 0x20 Indicates the node ID of the storage port is not current. 0x30 Indicates the node ID of the channel port is not current. 0x40 Indicates the node - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 299
bytes, 0xAABBCC: Byte AA 0x00 Reserved. 0x20 FC-SB-2 and updates. 0x40 Other FC-4s including FCP and updates. 0x60 FC-SB-2 and updates and other FC-4s including FCP and updates. 0x80 FC-4 support not specified. 0xa0 Reserved. 0xc0 Reserved. Fabric OS Command Reference 271 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 300
registered with the switch. 0xID CHIPID if channel port has registered with the switch. 0xPN If switch has registered with the channel, PN represents the FL port number. Part Number Displays the switch chassis part number. PID Displays the 24-bit Fibre Channel port address in 0xDDAAPP format - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 301
the device's channel or storage CU port World Wide Name associated with the device HBA. Sequence Number Displays the sequence number of the self-describing node. Serial Number Displays the switch serial number. Switch node WWN Displays the switch node World Wide Name. Switch Port WWN Displays - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 302
Number: 0000000169CA tag: 052e } } To display the local and remote LIRR database: switch:admin> ficonshow LIRR fabric {Fmt Type PID Listener Port WWN Switch Port WWN Listener Type 0x18 N 502b00 50:05:07:64:01:00:15:8d 20:2b:00:60:69:80:1e:4e Conditional 0x18 N 502e00 50:05:07:64:01:40:0f - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 303
33:33 10:00:00:60:69:80:1e:4e FRU part number: FRU serial number: 23000000602 FL2L0001060 {Listener Port Type Listener PID Listener Port WWN N 0x502b00 50:05:07:64:01:00:15:8d } } } The Local ILIR database has 2 entries. See Also ficonClear Fabric OS Command Reference 275 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 304
modified through configDownload. FIPS is not supported on all platforms. For FIPS-compliant hardware, refer to the Fabric OS Administrator's Guide. In a Virtual Fabric environment, FIPS is treated as chassis-wide configuration and applies to all logical switches in the chassis. Chassis permissions - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 305
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 SNMP is in read only - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 306
2 fipsCfg 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 See Also none 278 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 307
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 commit a new version of the firmware: switch:admin> firmwarecommit Validating primary partition - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 308
-e ] pfile Description Use this command to download switch firmware from an FTP or SSH server or local NFS directory to nonvolatile storage. Switch firmware can also be downloaded from an external USB device on platforms that support USB. The new firmware is downloaded in the form of RPM packages - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 309
. This option is valid only on platforms that support a USB port. Refer to your specific Hardware Reference Guide for details. The USB device must be enabled prior to firmware download with the usbStorage command. Firmware must be stored under the /firmware directory in the USB file system. On - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 310
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 telnet or SSH sessions be restarted. 282 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 311
firmware to both CPs on a dual-CP chassis with an attached USB device (You would execute the same command on a single-CP switch with USB support. Output may vary depending on platform.): switch:admin> firmwaredownload -U v6.2.0 Checking system settings Fabric OS Command Reference 283 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 312
corrupted. • The FTP or SSH service is not running on host. • The platform is not supported by the firmware indicated. • The USB device may not be plugged in correctly. On standalone switches, the device must be plugged into the switch USB port. On enterprise-class platforms, the USB device must be - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 313
be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples The following example shows the status of the firmwaredownload for an SAS image to the blades in slot 2 and 7. switch:admin> firmwaredownloadstatus [1]: Thu Jul - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 314
, active): Firmware is being download to standby CP. This step may take up to 30 minutes. [8]: Mon Dec 19 18:49:28 2007 Slot 8 (FR4-18i): Firmware has been downloaded successfully. Blade is rebooting with the new firmware. [9]: Mon Dec 19 18:50:12 2007 286 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 315
, active): Standby CP booted successfully with new firmware. [14]: Mon Dec 19 18:57:10 2007 Slot 5 (CP0, active): Firmware commit operation has started on both active and the firmware versions. See Also firmwareCommit, firmwareDownload, firmwareRestore, firmwareShow Fabric OS Command Reference 287 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 316
is not signed or if the signature validation fails, signed firmware download fails. Refer to the Fabric OS Administrator's Guide for complete details on upgrading or downgrading firmware. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 317
is not signed or if the signature validation fails, signed firmware download fails. Refer to the Fabric OS Administrator's Guide for complete details on upgrading or downgrading firmware. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 318
update the public key from an external USB device: switch:admin>firmwarekeyupdate -U /usb/usbstorage/brocade/firmwarekey/pubkey.pem Updating the public key, please wait... Public key successfully updated. firmwareDownload, firmwareKeyShow, configure 290 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 319
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 restore the former active firmware image: switch:admin> firmwarerestore Restore old image to - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 320
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 firmware versions in a Brocade director with FA4-18 blades installed in slot 2 and 7: switch:admin> firmwareshow Slot Name Appl Primary - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 321
operating status of features on a switch. This command can be run while the switch is online. The following features are supported (refer to the Notes for limitations): • FC Routing service (see fcrConfigure) • iSCSI service (see iscsiCfg) • iSNS client service (see isnscCfg) • Virtual Fabrics (see - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 322
service: switch:admin> fosconfig --enable fcr FC Routing service is enabled To enable the iSCSI service: switch:admin> fosconfig --enable iscsi iSCSI service is enabled To disable the iSCSI service: switch:admin> fosconfig --disable iscsi iSCSI service is disabled 294 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 323
To disable Virtual Fabrics: switch:admin> fosconfig --disable vf WARNING: This is a disruptive operation that requires a reboot to take effect. Would you like to continue [Y/N]y See Also fcrConfigure, iscsiCfg, iscsiPortCfg, isnscCfg, switchShow Fabric OS Command Reference 295 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 324
hardware component being replaced. WWN is the only supported value, specifying the replacement of the WWN card. Examples To replace the World Wide Name card: switch:admin command and follow the instructions to complete the operation. Please enter the word `continue' after the new WWN card has - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 325
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 trunk slave ports. Bit map of all the Fx_Ports. Bit map of all the segmented ports. Bit map of all the ONLINE ports. FSPF constant. FSPF constant. Internal - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 326
2 fspfShow Examples To display FSPF protocol information: switch:admin> fspfshow version = 2 domainID = 131 switchOnline = TRUE domainValid = = 1 ddb_sem = 0x1003e6e8 fabP: event_sch = 0x0 See Also bcastShow, topologyShow, uRouteShow 298 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 327
(alarms deactivated). This operand is optional. Examples To enable alarms in Fabric Watch: switch:admin> fwalarmsfilterset FW: Alarms are already disabled switch:admin> fwalarmsfilterset 1 FW: Alarms are already enabled See Also fwAlarmsFilterShow Fabric OS Command Reference 299 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 328
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 status of alarm filtering in Fabric Watch: switch:user> fwalarmsfiltershow FW: Alarms are - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 329
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 initialize all classes under Fabric Watch: switch:admin> fwclassinit fwClassInit: Fabric Watch is updating... fwClassInit: Fabric - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 330
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 reload the saved Fabric Watch configuration: switch:admin> fwconfigreload fwConfigReload: Fabric Watch - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 331
FCIP (includes VE_Ports, VEX_Ports) 3. SFP Class: SFPs connected to GbE ports are not monitored. For more Information, refer to the Fabric Watch Administrator's Guide. TABLE 13 fwConfigure Fabric Watch classes and areas Class Area Environment SFP Port Temperature Fan* Power Supply* Temperature - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 332
Front Panel Violations SCC Violations DCC Violations Login Violations Invalid Timestamps Invalid Signatures Invalid Certificates SLAP Failures SLAP Bad Packets TS Out of Sync No-FCS Incompatible Security DB Illegal Command Flash 304 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 333
Fabric logins SFP state changes Same as Port class Same as Port class Flash Admin Domain restrictions that may 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 you attempt to configure - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 334
associated with port 1: switch:admin> fwConfigure --disable --port 1 To configure thresholds in Access Gateway mode: switch:admin> fwconfigure 1 : Environment class 2 : SFP class 3 : Port class 4 : F/FL Port (Optical) class 5 : Resource class 6 : quit 306 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 335
2 Select a class => : 24 C inBetween Sat Oct 7 10:01:53 2006 21 C In_Range 1 : refresh 2 : disable a threshold 3 : enable a threshold 4 : advanced configuration 5 : return to previous page Select choice => : (1..5) [5] 5 See Also fwClassInit, fwConfigReload, fwShow Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 336
a FRU state changes. To configure email alerts, use fwMailCfg. Notes This command requires a Fabric Watch license. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 337
default Show thresholds monitored and port persistence time Display sensor readings Set policy parameters for overall switch status Print policy parameters for overall switch status Print overall switch status Print temperature readings See Also none Fabric OS Command Reference 309 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 338
switch:admin> fwmailcfg 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]1 Config Show Menu 1 : Environment class 2 : SFP - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 339
: 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 Mail Config Menu 1 : Environment class 2 : SFP class 3 : Port class 4 : Fabric class 5 : E-Port class 6 : F/FL Port (Optical) class 7 : Alpa Performance Monitor - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 340
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: --p portNumber Yields a port detail report for a specific user port. 312 Fabric OS Command - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 341
:24 To retrieve a port detailed report for a switch configured with an IPv4 address: switch:user> fwportdetailshow Port Detail Report Switch Name: switch IP address: 10.202.78.24 Port Exception report [by All] Report time: 09/11/2006 05:51:15 PM --------Port-Errors SFP-Errors---- Port - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 342
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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 343
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 requires a Fabric Watch license. Operands none Examples To generate a SAM report on an eighty-port switch: switch:user> fwsamshow - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 344
U 0 0 0 100 71 U 0 0 0 100 72 U 0 0 0 100 73 U 0 0 0 100 74 U 0 0 0 100 75 U 0 0 0 100 76 U 0 0 0 100 77 U 0 0 0 100 78 U 0 0 0 100 79 U 0 0 0 100 See Also portShow, switchShow 316 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 345
Specifies the time, in seconds, during which a port must be persistently in a marginal state before being recognized as such. Examples To set the port persistence time to 18 seconds: switch:user> fwset --port --persistence 18 See Also fwShow Fabric OS Command Reference 317 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 346
configuration...done. To view current temperature threshold settings: (Note that in this example, the values for custom settings are equal to the default values, which means that default values have not been modified.) switch:admin> fwconfigure 1 : Environment class 2 : SFP class 3 : Port class - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 347
enabled 24 C inBetween Thu Feb 14 01:21:36 2008 24 C : enable a threshold 4 : advanced configuration 5 : return to previous page Select 60 10 Custom C 0 60 10 Threshold alarm level is set at : Custom Errlog-1, SnmpTrap-2, RapiTrap-8 EmailAlert-16 Valid OS Command Reference 319 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 348
2 fwSetToCustom 8 : change custom buffer 18 : return to previous page 9 : apply threshold boundary changes 10 : cancel threshold boundary changes Select choice => : (1..18) [18] See Also fwSetToDefault, fwConfigure, fwHelp, fwShow 320 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 349
configuration...done. To view current temperature threshold settings: (Note that in this example, the values for custom settings are equal to the default values, which means that default values have not been modified.) switch:admin> fwconfigure 1 : Environment class 2 : SFP class 3 : Port class - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 350
24 C inBetween Thu Feb 14 01:21:36 2008 24 a threshold 4 : advanced configuration 5 : return to previous C 0 60 10 Threshold alarm level is set at : Default Errlog-1, SnmpTrap-2, RapiTrap-8 buffer 18 : return to previous page 9 : apply threshold boundary changes 322 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 351
10 : cancel threshold boundary changes Select choice => : (1..18) [18] See Also fwSetToCustom, fwConfigure, fwHelp, fwShow fwSetToDefault 2 Fabric OS Command Reference 323 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 352
for a fan in the SFP class: switch:user> fwshow 1 : Show class thresholds 2 : Detail threshold information 3 : Show port persistence time 4 : Quit Select an item => : (1..4) [3] 1 1 : Environment class 2 : SFP class 3 : Port class 4 : Fabric class 324 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 353
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 => : Event 0 occurred 1 time, last at 16:30:17 on 12/09/2011 Fabric OS Command Reference 325 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 354
:admin> 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 See Also fwClassInit, fwConfigReload, fwConfigure, fwSet 326 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 355
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 327 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 356
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 High Availability feature: switch:admin> hadisable HA is disabled See Also - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 357
a problem with the IP and Fibre Channel addresses configured for the switch. • Additional internal HA state information, subject to change. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 358
switch:admin> hadump Local CP (Slot 6, CP1): Active, Cold Recovered Remote CP (Slot 5, CP0): Standby, Healthy HA enabled, Heartbeat Up, HA State synchronized 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 359
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 High Availability feature: switch:admin> haenable HA is enabled See Also - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 360
, the port traffic light does not flash during the failover, even while traffic is continuing to flow. This command is supported only on dual-CP systems. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 361
has discovered a problem with the blade. Health Monitor has detected a configuration file error. • HA Brocade DCX, CP0 is in slot 6 and CP1 is in slot 7. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 362
To display CP status on a Brocade DCX with a healthy standby CP: switch:admin> hashow Local CP (Slot 7, CP1) : Active Remote CP (Slot 6, CP0) : Standby, Healthy HA Enabled, Heartbeat Up, HA State Synchronized See Also haDisable, haEnable, haFailover 334 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 363
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. Examples To enable the HA state synchronization: switch:admin> hasyncstart HA State synchronization has started - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 364
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: switch:admin> hasyncstop See Also haFailover, haShow, haSyncStart 336 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 365
user; command availability may vary depending on: • Login user role • License key • Hardware platform To access help information for a specific command help command: switch:admin> help help See Also diagHelp, fwHelp, licenseHelp, perfHelp, routeHelp, zoneHelp Fabric OS Command Reference 337 53- - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 366
in these units. All other platforms that contain FRUs support 28 history log entries. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 367
[ rot | fi ] Description Use this command to display or set the mode of the history buffer, 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 has reached its maximum size: Rotating mode Any - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 368
in these units. All other platforms that contain FRUs support 28 history log entries. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 369
2 Inserted at Tue Aug 14 15:52:10 2001 Factory Part Number: 60-0001536-02 Factory Serial Number: 1013456800 Records: 11 See Also historyLastShow Fabric OS Command Reference 341 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 370
of the Java plug-in supported by Web Tools. This command also displays the URL from which the plug-in can be downloaded. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 371
or about all processes running on the local switch. One line is displayed per process. Fields set if ptrace (0) has been called 020 tracing system calls 040 forked but did not exec 100 used super-user or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 372
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 diagHelp, routeHelp 344 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 373
usage. Examples To disable the ICL for ports 16-31: 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> iclcfg --persistentdisable 8/1 Fabric OS Command Reference 345 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 374
2 iclCfg See also To enable the ICL for ports 16-31 persistently: switch:user> iclcfg --persistentdnable 8/1 none 346 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 375
on a Brocade DCX or a DCX-S4 CP, valid interfaces are eth0 and eth3. On all other platforms, only eth0 is supported. Examples To advertise all modes of operation, when not entering this command through the serial console port, follow this scenario for the ifModeSet command: switch:admin> ifmodeset - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 376
configuration...done. To force the 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 [no] y Committing configuration...done. See Also ifModeShow 348 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 377
-HD, link ok MAC Address: 00:60:69:D0:24:40 To display the link operating mode for the eth3 Ethernet interface (in this example, the management port is disconnected): switch:admin> ifmodeshow eth3 Link mode: no link MAC Address: 00:05:1E:40:62:30 Fabric OS Command Reference 349 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 378
2 ifModeShow To display the active interface: ras010:root> ifmodeshow bond0 Currently Active Slave: eth0 See Also ifModeSet 350 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 379
to other switches. state Current state of this interface. This E_Port is used to route traffic to other switches only if the state is NB_ST_FULL. lastTransition Time the last state changed on this interface. nghbCap Neighbor capabilities. Should be 0. Fabric OS Command Reference 351 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 380
received from the neighbor switch. nLsaIn Number of LSAs received from the neighbor switch. attHloOut Number of attempted transmissions of Hello frames to the neighbor switch. nHloOut Number of Hello frames transmitted to the neighbor switch. 352 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 381
transmissions of LSAs to the neighbor 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 1, "Using Fabric OS commands" and Appendix A, "Command Availability - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 382
helloTo = 2000 rXmitTo = 5000 nCmdAcc = 7 nInvCmd = 0 nHloIn = 2 nInvHlo = 0 nLsuIn = 2 nLsaIn = 3 attHloOut = 2 nHloOut = 2 attLsuOut = 3 nLsuOut = 3 attLsaOut = 2 nLsaOut = 2 See Also nbrStateShow, portShow, switchShow 354 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 383
interop mode. Refer to the Fabric OS Administrator's Guide for details. • Zone commands in McDATA Open Fabric Mode (3) are disabled except display commands and two set commands, cfgDisable and cfgClear, which can only be called when the switch is offline. When changing From Brocade Native to McDATA - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 384
switch WWN is no longer replaced with a McDATA OUI. The Brocade OUI is used. However, upgrading from Fabric OS 5.2.1_NI to Fabric OS configure command. For information on supported hardware platforms and procedures regarding OS v5.2.1_NI to v6.x migration, refer to the Fabric OS Administrator's Guide - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 385
change to take effect. Do you want to continue? (yes, y, no, n): [no]y The configuration is being saved - a system reboot will cause the change to take effect. Please disable switch before changing the interop mode. cfgMcdtMode, cfgSaveActiveToDefined Fabric OS Command Reference 357 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 386
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 must be disabled before IOD delay can be reset. Notes The iodDelaySet command is deprecated in Fabric OS - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 387
the IOD delay setting for domain 5: switch:user> ioddelayshow 5 omain - Iod Delay 5 - 20 To display IOD settings for all domains in the fabric: switch:user> ioddelayshow 5 omain - Iod Delay (ms) 1- 2 5 - 20 10 - 20 20 - 30 21 - 23 See Also iodDelaySet Fabric OS Command Reference 359 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 388
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 360 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 389
IOD implementation. Lossless DLS is supported only in FICON environments, and the switch must be configured with a port-based policy. Refer to aptPolicy help for more information. Lossless DLS is not supported on extended interswitch links (ISLs). Fabric OS Command Reference 361 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 390
FID 128, INFO, 5100_sw, LossLess-DLS option has been disabled switch:admin>iodset --show IOD is set To remove the legacy IOD setting and display the status: switch:admin>iodreset switch:admin>iodset --show IOD is not set See Also iodShow, iodReset 362 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 391
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 setting of the IOD setting: switch:admin> iodshow IOD is not set See Also iodReset, iodSet Fabric OS Command Reference 363 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 392
or disable stateless IPv6 auto configuration, to assign a Fibre Channel IPv4 address and prefix to a logical switch IPFC network interface, and to configure a service port on the CP blade of a Brocade DCX. When run interactively in legacy mode, this command sets the Ethernet IPv4 address, subnet - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 393
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. The option to set the Fibre FC IP address and FC subnet mask interactively is no longer supported as of Fabric OS v6.2.0. Operands - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 394
To configure an IPv6 address and prefix on a single CP of a chassis: switch:admin> ipaddrset -cp 0 -ipv6 --add 1080::8:800:200C:417A/64 To delete any existing IPv6 address and prefix on CP0 on an enterprise-class platform: switch:admin> ipaddrset cp 0 -ipv6 --delete 366 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 395
address on an AP7600 with a hidden BP: switch:admin>ipaddrset -eth0 --add 10.12.34.123/24 To configure an IPv4 FC address for the IPFC interface associated with a logical switch with fabric ID 123: switch:admin>ipaddrset -ls 123 --add 11.1.2.4/24 IP address is being changed...Done. To verify the - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 396
.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]: on ipAddrShow 368 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 397
IPv6 Auto configuration Enabled: Yes or No If enabled, the command displays: • All local IPv6 Addresses • Gateway IP addresses for both CPs Local IPv6 addresses display the following identifiers: IP Address type: • static - A statically configured IPv6 address. Fabric OS Command Reference 369 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 398
2 ipAddrShow • stateless - Acquired through stateless auto configuration. IP Address state: • tentative • preferred • deprecated Refer to the RFC 2462 specification for more information. On modular platforms with intelligent blades, the addresses configured for each slot can be shown with the -slot - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 399
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 See Also ipAddrSet Fabric OS Command Reference 371 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 400
. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. In a Virtual Fabric environment, IP Filter policies are treated as chassis-wide configurations and apply to all logical switches in the chassis. Chassis permissions are required to manage IP Filter - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 401
policyname Adds a new rule to the specified IP filter policy. The change made to the specified IP filter policy is not saved to the persistent configuration until saved or activated. The following arguments are supported with the --addrule option: Fabric OS Command Reference 373 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 402
CLI or manageability sessions are blocked on the subcommands that would open a new transaction. Examples To create an IP filter for a policy with an IPv6 address: switch:admin> ipfilter --create ex1 -type ipv6 To add a new rule to the policy and specify the source IP address, destination port - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 403
activated 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 permit 3 any tcp 897 permit 4 any tcp 898 permit 5 any tcp 111 permit 6 any tcp 80 permit 7 any - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 404
, 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 permit 3 any tcp 897 permit 4 any tcp 898 permit 5 any tcp 111 permit 6 any tcp 80 permit - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 405
• Configure IP address for both IPv4 and IPv6 format. • Configure three types of policies and their respective components: - IPSec policy including selector, transform, SA-proposal, and SA. - IKE policy (automatic key management). - Manual SA (manual SA management). Fabric OS Command Reference 377 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 406
pre-shared keys in the local 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 for configuration procedures. This command accepts abbreviated - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 407
. The main components of an IPsec policy are: IP packet filter/selector (IP address, protocol, and port information) and transform set. A subtype is required when configuring an IPsec policy. The subtype specifies the components to be configured. The following are required subtypes for the IPsec - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 408
IP address must also be defined. sa-proposal Defines the security associations (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 OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 409
--flush manual-sa to remove authentication of IP packets, and protection against replay attacks. Authentication Header (AH) provides data integrity, data source authentication user-defined index. Valid SPI numbers consist of numeric characters (0-9). This operand is optional. Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 410
an IKE policy configuration. No subtype is required with this command. The command defines the following IKE policy parameters: IKE version, IP address of the remote entity, IP address of the local entity, encryption algorithm, hash algorithm, PRF algorithm, DH group, authentication method, path and - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 411
for SA connections in Phase2. When PFS is enabled, a new key is generated for keying the SAs. Enabling PFS may after version 1 was set. manual-sa Creates manually keyed SADB entries. When using this option, you must generate the keys manually, The lifetime of OS Command Reference 383 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 412
-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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 413
is executed. This command, unlike delete, does not remove the policies from the configuration database. Flushing any other policy parameters is not supported. --show type policy ips Displays current IPsec or IKE configuration. The syntax for the display option is as follows: --show type [subtype - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 414
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. 386 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 415
. Refer to your server administration guide for instructions. Example 2 Secure traffic between two systems using ESP protection with 3DES_CBC encryption and SHA1 authentication, and configure IKE with RSA Certificates signed by the certification authority (CA). The two systems are A SWITCH - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 416
peer to 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 417
using ipsecConfig --show manual-sa -a. Refer to the "IPsec display commands" section for an example. 5. Perform the equivalent steps on the remote peer to complete the IPsec configuration. Refer to your server administration guide for instructions. Fabric OS Command Reference 389 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 418
SA proposals: switch:admin> ipsecconfig --show policy ips sa-proposal -a ipsec-esp-a-b SA(s) used:sa-esp-1 sa-ah-1 lifetime in seconds:infinite lifetime in bytes:infinite ipsec-esp-def SA(s) used:sa-esp-1 lifetime in seconds:infinite lifetime in bytes:infinite 390 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 419
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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 420
[4302] Kent, S., "IP Authentication Header", RFC4302 (Dec 2005). [4303] Kent, S., "IP Encapsulating Security Payload (ESP)", RFC4303 (Dec 2005). [4306] Kaufman, C., Ed., "The Internet Key Exchange (IKEv2) Protocol", RFC 4306 (Dec 2005). See Also none 392 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 421
iscsiCfg Synopsis Configures or displays iSCSI entities. iscsicfg create auth -u username -s CHAP_secret [-h] iscsicfg --modify auth -u iscsicfg --show initiator [-i initiator_name] [-h] iscsicfg --abort transaction -x transaction_id [-h] Fabric OS Command Reference 53-1001186-01 iscsiCfg 2 393 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 422
commit all command is issued. Make all necessary configuration changes before issuing --commit all. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 423
be specified as a comma-separated list. The IQN may be a maximum of 64 characters. --add dd -d dd_name -m member_list [-h] Adds a new member to an existing DD. DD member lists also are acceptable. --clear dd [-h] Deletes the DD and DDset databases. Fabric OS Command Reference 395 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 424
dd_list [-h] Adds a new DD to an existing DD set. --delete ddset -n ddset_name [-d dd_list] [-h] Deletes the DD set with ddset_name. If [-i initiator_name][-h] Displays all iSCSI initiators that the switch is aware of. If an initiator has attempted discovery OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 425
.2005-10.com.brocade.tgt1 Offline/Defined Name: State/Status: iqn.2222-23.com.brocade:21:00:00:20:37:df:83:fc Online/Committed To delete a target entry: switch:admin> iscsicfg --delete tgt -t iqn.2005-10.com.brocade.tgt1 The operation completed successfully. Fabric OS Command Reference 397 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 426
. To display LUN maps: switch:admin> iscsicfg --show lun Number of records found: 2 Target: iqn.2005-10.com.brocade.tgt1 Number of LUN Maps: 1 FC WWN Virtual LUN(s) 22:00:00:04:cf:20:5d:33 0 Physical LUN(s) 0 Target: iqn.2222-23.com.brocade:50:06:0e:80:00:43:80:a2 Number of LUN Maps - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 427
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 -- Disabled Aggregated iSCSI database state for fabric: In Sync Fabric OS Command Reference 399 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 428
:50:06:0e:80:00:43:80:a2 iqn.2222-23.com.brocade:21:00:00:20:37:df:83:fc To display all targets that are accessible by a specified initiator: switch:admin> iscsicfg --show initiator -i iqn.1991-05.com.brocade:initiator1 The operation completed successfully. Index iSCSI Name IP Address Type - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 429
is supported only on the Brocade ports. Examples To run iscsichiptest: switch:admin> iscsichiptest --slot 7 -unit 1 -testtype 0 Running iscsichiptest Test Complete: iscsichiptest Pass 1 of 1 Duration 0 hr, 3 min & 12 sec (0:3:12:511). passed. See Also iscsiPathTest Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 430
. Manage/display iscsi switch configuration parameters. Create/Delete a new ip interface/route/arp entry on the GigE port Show configured ip interfaces/routes/arp entries on the GigE Port Display the number of sessions on each iSCSI port See Also switchShow 402 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 431
each port. The default value is 100. Examples To run iscsipathtest: switch:admin> iscsipathtest --slot 2 -path 2 -nframes 10 Running iscsipathtest Test Complete: iscsipathtest Pass 10 of 10 Duration 0 hr, 3 min & 1 sec (0:3:0:630). passed. See Also iscsiChipTest Fabric OS Command Reference 403 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 432
per session Header digest support Immediate data support First burst length value 0 1 Disabled Disabled No 512 Note Operands 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 433
number. This parameter only supports FC4-16IP blades in Brocade 48000 directors. Specifies the port number of a GbE port to be configured in the specified slot. Use -h on any option to display the help text for it. Examples To modify the port parameters: switch:admin> iscsiportcfg --modify 7/ge2 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 434
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 -iscsi.lab iqn.2002-12.com.tgt:21:00:00:04:cf:5d:cf:0e 0x400001370000 406 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 435
Switch Port 1 2743 Yes 8/ge4 Security Details CHAP Username: none FC Details Number of FC targets: 1 FC Target Information Index FC WWN 1 2f:df:00:06:2b:0d:10:b9 iSCSI Operating Login Parameters: Session Level Parameter Name Self Value Peer Value Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 436
Task Set: 0 iSCSI LUN Reset: 0 iSCSI Target Reset: 0 iSCSI Task Reassign: 0 Non FCP in PDU: 0 Non FCP in Octet: 0 Non FCP out PDU: 0 Non FCP out Octet: 0 See Also fosConfig, iscsiCfg, iscsiPortCfg 256KB 64KB 16 60s 0s 2 Off Peer Value 64KB On On On 408 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 437
to display the iSCSI switch level configuration and to configure the iSCSI connection redirection and target name prefix. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 438
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 When you issue islshow in a base fabric, the output displays as follows: switch:user> islshow 1: 2->300 10 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 439
parameter only supports Brocade FC4-16IP blades in Brocade 48000 directors. Specifies the IP address in dotted-decimal form. Examples To set the IP address of an external iSNS server with an attached GbE port: switch:admin> isnsccfg --set 7/ge0 -s 192.168.131.124 iSNS client configuration updated - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 440
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 412 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 441
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 parameters, the last one on the command line overrides previous settings. Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 442
User ports, ports with external connections Quadrants, group of (normally four) ports Chips, ASICs within a blade 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 1, "Using Fabric OS - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 443
be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Examples To terminate an open Telnet connection: switch:admin> killtelnet Collecting login information....Done List of telnet sessions (3 found) Session No USER TTY IDLE FROM - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 444
switch, or the "SAN maintenance" role to the switch "operator" role. But the command fails if you attempt to map an already mapped AD server role. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 445
to the switch role of "operator": switch:admin> ldapcfg --maprole SANoperator operator LDAP role SANoperator has been successfully mapped. switch:admin> ldapcfg --unmaprole SANoperator LDAP role SANoperator has been successfully unmapped. aaaConfig, userConfig Fabric OS Command Reference 417 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 446
and management isolation, and each logical fabric is independently scalable. The display options provided with this command show the logical fabric configuration for a given logical switch context or for a chassis context. Each logical switch displays only the user ports that are configured to - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 447
Fabric-aware and run Fabric OS v6.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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 448
2 384 24 sw0 PT Online Displays status information about the LISLs in the logical switch set by the context: switch:admin> lfcfg --show -lisl -v ID Port# remote-domain Name State Associated Physical Ports 2 384 24 sw0 PT Online 1/29, 2/41, 3/33, 4/24 420 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 449
in the chassis: switch:admin> lfcfg --showall -lisl FID Port# remote-domain Name State 2 384 24 sw0 PT Online 3 385 24 sw0 PT Online See Also FID Port# remote-domain Name State 2 384 24 sw0 PT Online 3 385 24 sw0 PT Online . none lfCfg 2 Fabric OS Command Reference 421 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 450
operand: "license" Specify a license key, in quotation marks. This operand is required. Examples To add a license key to the switch: switch:admin> licenseadd "aBcDeFGh12345" adding license key "aBcDeFGh12345" See Also licenseRemove, licenseShow 422 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 451
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 license commands: switch:admin> licensehelp licenseadd licensehelp licenseidshow licenseremove licenseshow Adds license - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 452
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 license ID: switch:admin> licenseidshow a4:f8:69:33:22:00:ea:18 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 453
to specific site requirements. These options are used in the case where 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 1, "Using Fabric OS - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 454
POD licenses. Use licensePort -release to allow these ports to be reassigned.] Ports not assigned to a license: None 0 license reservations are still available for use by unassigned ports See Also licenseAdd, licenseRemove, licenseShow, licenseHelp 426 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 455
key, in quotation marks. This operand is required. Examples To remove a license key from the switch: switch:admin> licenseremove "bQebzbRdScRfc0iK" removing license key "bQebzbRdScRfc0iK" See Also licenseAdd, licenseHelp, licenseIdShow, licenseShow Fabric OS Command Reference 427 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 456
are installed, the command displays "No license installed on this 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. Operands - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 457
. Notes This command sets a non-default, "static" cost for any port except EX/VEX ports. Use fcrRouterPortCost to configure EX/VEX ports. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 458
1000 2 13 1000 2 14 1000 2 15 1000 Type to continue, Q to stop: To set the ISL cost on a port: switch:admin> linkcost 2/4 500 To display the new cost value on the same port: switch:admin> linkcost 2/4 Interface2/4 Cost 500 (STATIC) To delete the cost value and reset to default - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 459
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 Fabric OS Command Reference 431 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 460
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 432 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 461
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 Displays state information for the device. Valid states include: Configured Device - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 462
2 lsanZoneShow 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 434 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 463
that are Virtual Fabric-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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 464
from the partition on which they are currently configured. This command prompts for confirmation, indicating that the specified ports will be disabled. The following operands are supported: FID Specifies the fabric ID of the logical switch. This operand is required. -slot slot | slot_range - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 465
. To assign ports to a logical switch without confirmation: switch:admin> lscfg --config 2 -port 0-4 -force Configuration change successful. Making this configuration change. Please wait... Please enable your ports/switch when you are ready to continue. Fabric OS Command Reference 437 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 466
logical switch configuration: switch:admin> lscfg --show Created switches: 128(ds) 1(bs) 2 Port 0 1 2 3 4 5 6 7 8 9 FID 1| 1| 1| 1| 1| 1| 1| 1| 2| 2| Port 10 11 12 13 14 15 16 17 18 19 FID 128 | 128 | 128 | 128 | 128 | 128 | 128 | 128 | 128 | 128 | Port 20 21 22 23 24 25 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 467
of a base switch requires that the proposed new base switch on this system be disabled. Would you like to continue [y/n]?: y Disabling the proposed new base switch... Disabling switch fid 1 Please enable your switches when ready. lfCfg, setContext Fabric OS Command Reference 439 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 468
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 LSR. It is identical to the domain ID. 440 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 469
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 Fabric OS - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 470
length = 60 chksum = 0x168a linkCnt = 2, flags = 0x0 LinkId = 91, out port = 28, rem port = LinkId = 91, out port = 29, rem port = 28, cost = 500, costCnt = 0, type = 1 29, cost = 500, costCnt = 0, type = 1 interfaceShow, nbrStateShow 442 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 471
to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, zone2_cfg) switchBeacon: OFF FC Router: OFF Allow XISL Use: ON LS Attributes: [FID: 20, Base Switch: No, Default Switch: Yes] Area Port Media Speed State Proto - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 472
2 fosExec 19 19 id 22 22 id 23 23 id 24 24 id 25 25 id 26 26 id 27 27 id 28 28 id 29 29 id 30 30 id 31 31 id No_Light N8 No_Light N8 No_Light N8 No_Light N8 No_Light N8 No_Module N8 No_Module N8 No_Module N8 No_Light See Also setContext, userConfig 444 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 473
: switch:admin> memshow total used Mem: 129740800 112562176 Swap: 0 0 switch:admin> memshow -m total used Mem: 123 107 Swap: 0 0 free 17178624 0 free 16 0 shared 0 buffers cached 139264 30396416 shared 0 buffers 0 cached 28 See Also supportSave Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 474
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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 475
Use this command to configure the MS Access Control List (ACL). The MS allows a Storage Area Network (SAN) management application to retrieve and administer the fabric and Interconnect Elements, such as switches. This application is located at the Fibre Channel well-known address, 0xFFFFFA - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 476
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, msTdReadConfig, secPolicyShow 448 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 477
Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the MS platform database for a fabric: switch:admin : HOST_BUS_ADAPTER Number of Associated M.A.: 1 Associated Management Addresses: [30] "http://java.sun.com/ - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 478
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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 479
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 clear the MS platform database: switch:admin> msplcleardb MS Platform Service is currently enabled - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 480
one switch does not support the service, the command fails. When an FCS policy 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 481
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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 482
configuration database for all affected switches. The change is persistent across power cycles and reboots. Notes Topology Discovery Management requires the attached devices (including attached switches) to support request node identification data (RNID) extended link service (ELS). When an FCS - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 483
configuration database for all affected switches. The change is persistent across power cycles and reboots. Notes Topology Discovery Management requires the attached devices (including attached switches) to support request node identification data (RNID) extended link service (ELS). When an FCS - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 484
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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 485
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 current login information: switch:admin> myid Current Switch: switch Session Detail: switch (123.123.123.123) Active Redundant - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 486
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 to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 487
nbrStateShow 2 Examples 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 See Also interfaceShow Fabric OS Command Reference 459 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 488
to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, , 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 489
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) See Also interfaceShow, portShow, switchShow nbrStatsClear 2 Fabric OS Command Reference 461 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 490
all the device information matching the alias "a320": switch:user> nodefind a320 Local: Type Pid COS PortName NodeName Port Name: 20:14:00:60:69:80:04:79 Permanent Port Name: 22:00:00:04:cf:9f:7d:e0 Device type: Physical Target Port Index: 20 Share Area: No 462 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 491
Target Port Index: 14 Share Area: No Device Shared in Other AD: No Aliases: No match: To display device information for a string for which there is no match: switch:user> nodefind abcd No device found. See Also aliShow, nsAllShow, nscamShow, nsShow Fabric OS Command Reference 463 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 492
belongs. If there are no defined configuration aliases for that device, no alias is displayed. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 493
and an iSCSI target. Examples To display local NS information with aliases: switch:admin> nsaliasshow { Type Pid COS PortName NodeName TTL(sec) N 021200; 2,3; Fabric Port Name: 20:03:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:02:d6 Fabric OS Command Reference 465 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 494
:00:60:69:01:44:22 Permanent Port Name: 21:00:00:fa:ce:04:83:c9 Device type: Physical Target Aliases: NL 0214ef; 3;21:00:00:ad:bc:04:6f:70;20:00:00:ad:bc:04:6f:70; 0 FC4s: FCP [STOREX RS2999FCPH3 JB09] 466 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 495
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 } See Also nsAllShow, nsShow, switchShow nsAliasShow 2 Fabric OS Command Reference 467 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 496
021300 0214e2 0214e4 0214e8 0214ef 12 Nx_Ports in the Fabric } switch:admin> nsAllShow 8 { 0118e2 0118e4 0118e8 0118ef 0214e2 0214e4 0214e8 0214ef 8 FCP Ports } switch:admin> nsAllShow 5 { 011200 021200 2 FC-IP Ports } See Also nsShow, switchShow 468 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 497
by the NS cache manager. If the NS cache manager does not discover new switches or new devices in the fabric 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). NodeName The device's node WWN. Permanent Port - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 498
" Fabric 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! See Also nsAllShow, nsShow, switchShow 470 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 499
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 Name (WWN - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 500
.03.06 DVR:v9.0.0.2 (w32 IP)" Fabric Port Name: 20:0e:00:05:1e:34:00:70 Permanent Port Name: 21:00:00:e0:8b:12:8a:be Port Index: 14 Share Area: No Device Shared in Other AD: No Redirect: No The Local Name Server has 2 entries } 472 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 501
IP)" Fabric Port Name: 20:0e:00:05:1e:34:00:70 Permanent Port Name: 21:00:00:e0:8b:12:8a:be Device type: Physical Initiator Port Index: 14 Share Area: No Device Shared in Other AD: No Redirect: No The Local Name Server has 2 entries } nsAllShow, switchShow Fabric OS Command Reference 473 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 502
. The command output displays the following information: Type U - known, N - N_Port, NL - NL_Port. Pid 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). NodeName The device's node WWN. Permanent - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 503
To display each local device's online zoned device data: switch:admin> nszonemember -a Port: 4 Pid: 0xb00400 Aliases: ix360_131_201_6a Zoned Members: 2 Port: 12 Pid: 0xb00c01 Aliases: dl360_130159a Zoned Members: 2 devices Pid: 0xb00c01 Aliases: dl360_130159a Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 504
Port: 14 Pid: 0xb00e00 Aliases: dl360_130251a dl360_130251a Zoned Members: 2 devices Pid: 0xb00e00 Aliases: dl360_130251a dl360_130251a Pid: 0xba1ae4 Aliases: trimm100a_2 To display all the unzoned devices in the fabric: switch:admin , nsShow 476 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 505
set by the administrator is recorded in the user's password history. The passwd command behaves as follows: • If you are changing your own password, you are prompted to enter the old password and, if your entry is valid, you are prompted to enter the new password. Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 506
place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Examples Diagnostics To change the password for the admin account while logged in as admin: switch:admin> passwd Changing password for admin Enter new password: Re-type new password: Password - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 507
the password before the minimum aging period expires. Password contains invalid characters. The password you entered contains invalid characters. See Also login, logout, passwdCfg Fabric OS Command Reference 479 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 508
set of rules that new passwords must satisfy. Configurable authentication process. A warning that password expiration is approaching is displayed when the user logs in. The number of days prior to password expiration during which warnings commence is a configurable OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 509
, -digits, -punctuation must be less than or equal to -minlength value. -history value Specifies the number of past password values that are disallowed when setting a new password. A value of 1 to 24 can be specified. The default value is 1. Fabric OS Command Reference 481 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 510
" value is set to 3, a password "passAAAword" is disallowed because it contains the repeated sequence "AAA". A password of "passAAword" would be allowed because no repeated character sequence exceeds two characters. The range of allowed values is 1-40. 482 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 511
set passwd configuration parameters, specifying 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 minlength value must be between 8 and 40. Fabric OS Command Reference 483 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 512
0 and less than or equal to -minlength value. total strength specification out of range The total of -lowercase value, -uppercase value, out of range The -history value must be between 1 and 24. minpasswordage value out of range The -minpasswordage value must be OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 513
for an illustration. Other command options allow the collection of information on the reverse path, or on a user-selected path (source route). For each hop, this command displays the following fields: Hop The hop number. The local switch is hop 0. Fabric OS Command Reference 485 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 514
Gbps. This parameter does not apply to the embedded port. If the bandwidth is zero, it is displayed as 1 Gbps. For logical interswitch links (LISL) ports, the bandwidth displays as 8 Gbps, the maximum bandwidth on hardware switch to the destination switch Credit. OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 515
of 4-byte Fibre Channel words. port index; otherwise, it is the port area. The embedded port (-1) is the default. The embedded 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 Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 516
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) 2 1G 1000 1 3 10 (web229) 8 1G 1000 2 8 8 (web228 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 517
path information when source port and destination port are provided along with the traceroute option: switch:admin> pathinfo 6 12 13 -t Target port is F_Port Hop Domain ID (Name) Time/hop 6 (Stealth_I) 108186 usec To display basic path information to a specific domain in a Virtual Fabric - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 518
0 0 0 0 Words 240434036 2294316 2119951 2121767 Frames 20025929 54999 162338 56710 Errors - 4 - 0 Hop In Port Domain ID (Name) Out Port BW Cost 2 14 8 (web228) E - - (output truncated) See Also portStatsShow, switchShow 490 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 519
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 1, "Using Fabric OS commands" and - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 520
device connected to an Encryption Switch, you must add two monitors 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 1, "Using Fabric OS - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 521
to blade 1 port 2: switch:admin> perfaddeemonitor 1/2 "0x050200" "0x1182ef" End-to-End Switch. Two EE monitors are added on port 1 of the Encryption Switch, which is an F_port that attaches to the target device. 1. Get the CryptoTarget container configuration OS Command Reference 493 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 522
virtual) connected to the Encryption Switch along with their PIDs: EncryptionSwitch:SecurityAdmin port 1 between the Initiator SID and the virtual initiator DID: EncryptionSwitch:SecurityAdmin> perfaddeemonitor 1 0x0a0100 0x0a2002 End-to-End monitor number 0 added. 494 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 523
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 perfAddWriteMonitor, perfDelEEMonitor, perfMonitorClear, perfMonitorShow Fabric OS Command Reference 495 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 524
license. This command is not 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 1, "Using Fabric OS commands" and Appendix A, "Command - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 525
FCP Read commands in Fibre Channel frames. Only frames transmitted 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 1, "Using Fabric OS - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 526
and Write commands in Fibre Channel frames. Only frames transmitted 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 1, "Using Fabric OS - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 527
license. This command is not 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 1, "Using Fabric OS commands" and Appendix A, "Command - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 528
license. This command is not 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 1, "Using Fabric OS commands" and Appendix A, "Command - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 529
, to add a filter-based monitor for SOFi3 to a port: switch:admin> perfaddusermonitor 1/4 "0, 0xff, 6" User monitor #1 added See Also perfAddEEMonitor, perfAddIPMonitor, perfAddReadMonitor, perfAddRWMonitor, perfAddSCSIMonitor, perfAddWriteMonitor Fabric OS Command Reference 501 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 530
FCP write commands in Fibre Channel frames. Only frames transmitted 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 1, "Using Fabric OS - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 531
license. This command is not 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 1, "Using Fabric OS commands" and Appendix A, "Command - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 532
: switch:admin> perfcfgrestore This will overwrite current Performance Monitoring settings in RAM. Do you want to continue? (yes, y, no, n): [no] y Please wait ... Performance monitoring configuration restored from FLASH. See Also perfCfgClear, perfCfgSave 504 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 533
supported on virtual FC ports (VE/VEX_Port), EX_Port, M (Mirror) ports and GbE ports. Monitors created by Web Tools are not saved in persistent memory. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 534
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 all platforms. Refer to the Fabric OS Administrator's Guide for specific hardware support. Operands This - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 535
license. This command is not 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 1, "Using Fabric OS commands" and Appendix A, "Command - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 536
license. This command is not 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 1, "Using Fabric OS commands" and Appendix A, "Command - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 537
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 commands related to performance monitoring: switch:admin> perfhelp perfAddEEMonitor perfAddIPMonitor perfAddReadMonitor perfAddRWMonitor - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 538
license. This command is not 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 1, "Using Fabric OS commands" and Appendix A, "Command - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 539
:admin> perfmonitorclear --class ISL 1 This will clear ISL monitor on port 1, continue? (yes, y, no, n): [no] y See Also perfAddEEMonitor, perfAddIPMonitor, perfAddReadMonitor, perfAddRWMonitor, perfAddSCSIMonitor, perfAddUserMonitor, perfAddWriteMonitor, perfMonitorShow Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 540
count for the whole ISL. Num_ports The number of ports in this ISL (one for a standalone ISL, more for trunks). Num_domains The total number of domains being monitored. Domain_count The 64-bit cumulative transmit counter for each individual domain. 512 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 541
license. This command is not 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 1, "Using Fabric OS commands" and Appendix A, "Command - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 542
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 26k 204 717 717 717 513 204 514 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 543
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 Domain 98: 13965 Domain 99: - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 544
E_Ports are over-written. 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. On the Brocade FC4-48, the Area ID address field and the AL_PA ID address field must be masked - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 545
ff" "ff:00:00" Changing EE mask for this port will cause ALL EE monitors on this port to be deleted. continue? (yes, y, no, n): [no] y The EE mask on port 6 is set and EE Monitors on this port are deleted See Also perfAddEEMonitor, perfShowPortEEMask Fabric OS Command Reference 517 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 546
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 all platforms. Refer to the Fabric OS Administrator's Guide for specific hardware support. Operands This - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 547
license. This command is not 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 1, "Using Fabric OS commands" and Appendix A, "Command - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 548
2 perfShowPortEEMask RxSID ALPA: on RxDID Domain: on RxDID Area: on RxDID ALPA: on See Also perfAddEEMonitor, perfDelEEMonitor, perfSetPortEEMask 520 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 549
Performance Monitor license. Most platforms supported under Fabric OS v6.0.0 and later support TopTalkers. The Brocade 200E does not support Top Talkers. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 550
--delete fabricmode Deletes the Fabric Mode Top Talker. Examples To add an F_Port Top Talker to blade 1 port 2 (which should be an F_Port): Switch:admin> perfttmon --add ingress 1/2 To delete the F_port Top Talker: switch:admin> perfttmon --del 1/2 522 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 551
the Fabric Mode Top Talker output: Switch:admin> perfttmon --show dom 1 pid perfttmon --show dom 1 pid Src_PID Dst_PID MB/sec Potential E-Ports 0x03f600 0x011300 121.748 2/0,2/2,2/3 0x03f600 0x011300 121.748 3/14,3/15 none Fabric OS Command Reference 523 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 552
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 switch:admin> pkicreate Pki objects already exist. If you want to regenerate new - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 553
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 of this fibre channel switch. If you want - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 554
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 view PKI objects: switch:admin> pkishow Passphrase : Exist Private Key : Exist - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 555
deleted and re-created with new parameters. A policy cannot be deleted while an active FCIP tunnel is using it. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 556
is 28800 to 250000000 or 0. The default is 28800. Examples To create a new policy: switch:admin> policy --create ike 10 -enc 3des -auth md5 The following policy has been set: IKE policy 10 Authentication Algorithm: MD5 Encryption: 3DES Perfect Forward Secrecy: 0 Diffie-Hellman Group: 1 SA Life - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 557
SHA-1 Encryption: AES-128 Perfect Forward Secrecy: 0 Diffie-Hellman Group: 1 SA Life (seconds): 28800 To delete a policy: switch:admin> policy ike --delete 10 The policy has been successfully deleted. See Also portCfg, portCfgShow, portShow policy 2 Fabric OS Command Reference 529 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 558
and the Brocade DCX-4S on (on the base switch and logical switches). On other platforms, the command returns a "not supported" message. Operands This command has the following operands: --bind Assigns the lower two bytes of the Fibre Channel address to the specified port. slot_number Specifies - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 559
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: switch:admin>portaddress --show Index Slot Port Area Mode - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 560
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. switch:admin>portaddress --findPID 0x2400 Index Port Port ID 36 36 0x 2400 none 532 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 561
to display, relative to its slot for bladed systems. Use switchShow to list valid ports. Examples To display the AL_PAs of a port: switch:user> portalpashow 4/14 AL_PA type AL_PA 0xe2 public 0xe4 type public AL_PA type See Also switchShow Fabric OS Command Reference 533 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 562
port configuration). If the number of Buffer Usage is less than the number of Needed Buffers, the port is operating in the buffer limited mode. Link Distance For L0 (not in long distance mode), the command displays the fixed distance based on port speed, for instance: 10 km (1 Gbps), 5 km (2 Gbps - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 563
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 - 54 54 50km 18 - - 0 - - 19 - - 0 - - 54 See Also portCfgLongDistance Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 564
proxy for the CAM entries of the secondary port, in this case using redirect filters. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 565
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) switch:admin> portcamshow - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 566
this command to manage configuration parameters for ports and gigabit Ethernet (GbE) ports. The following operations can be performed with this command: • Optionally add and delete Address resolution protocol (ARP) entries. Flush ARP table. • Create, modify, and delete Fibre Channel over IP (FCIP - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 567
. fciptunnel Creates Fibre Channel over IP (FCIP) tunnels. You can configure up to a maximum of eight FCIP tunnels per GbE port. This feature Services (DSCP) and Layer 2 Class of Service (L2CoS). If the -M option is set, the VC on the FCIP outbound frame is mapped to Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 568
other tunnels (IPSec or otherwise) can be 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. Creates an FCIP tunnel with VLAN Tagging and Class of Service (CoS). Specify a vlan_id in the range between - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 569
Brocade switch to communicate with third party WAN optimization hardware. The WAN optimization hardware connects on the GE ports configured for FCIP. The TCP Byte Streaming feature is supported only on the Brocade is 80. Services (DSCP) and Layer 2 Class of Service (L2CoS). If the -M option is set - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 570
tunnel_id Specifies the tunnel_id. Range is 0-7. -default Resets/sets VC QoS map to default values. -delete vc_num Deletes associated QoS map configuration file. Delete QoS mappings before downgrading to pre-v6.0.0 firmware versions that do not support QoS mapping. It removes the file from the - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 571
port. After defining the IP interface of the remote switch, you can define destination routes for an interface. A maximum of 40 routes per GbE port are supported. IPv6 addresses are supported on platforms running v6.0.0 or later. You cannot use this command to configure routes for inband management - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 572
on the port generate an RSCN to another end device that is zoned with this one. By default, RSCN suppression is disabled on all ports. Enables the configuration. When enabled, any device changes on the port will not generate an RSCN to any other end device. 544 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 573
connection can use this port to mirror traffic. fastwrite --enable --disable Configures the FC port for FC Fastwrite. Enables or disables FC Fastwrite between two Brocade 7500 routersor two Brocade 48000 directors with FR4-18i blades connected by Fibre Channel ISLs. FastWrite mitigateslatency - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 574
tag. Range is 1-4094. L2 CoS Specifies L2 Class of Service/Priority, as defined by IEEE 802.1p. Range is 0-7. dst_ipaddr Optional destination IP address (IPv4 or IPv6). All packets destined for this IP address are tagged accordingly. If a destination IP Address is not specified, all packets not - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 575
specific arguments are supported with the config and delete options. -a |--wrtMaxPipe value Defines the maximum number of tape write channel single channel program or in multiple channel programs. The setting has significance only for host (channel) initiated OS Command Reference 547 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 576
is a debug tool primarily for Tech Support personnel. It provides an FC Frame Header trace facility for all frames that go through an FTRACE enabled FCIP Tunnel. The trace facility allows a user to capture and display FC frame sequences that flow through the FCIP Tunnel. When configured, the FTRACE - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 577
the trace record size in bytes. The range is 80 to 240 bytes. The default is 80 bytes. inbandmgmt Configures IP addresses and routes for the CP or GbE port inband management interfaces on the Brocade 7500. Inband management allows a management station to communicate with the CP through GbE - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 578
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 pipelining enabled: switch:admin> portcfg fciptunnel 3/ge0 create 6 10.1.1.44 192.168.131.124 155000 -f -t 550 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 579
ge0 1 -x 1 -w 1 To configure FTRACE with ACo disabled and FTRACE enabled on port ge0/tunnel 3: switch:admin> portcfg ftrace ge0 3 cfg -a 0 -e 1 -p 5 -s 00000003 -t ffffffff To delete the FTRACE on the same port/tunnel: switch:admin> portcfg ftrace ge0 3 del Fabric OS Command Reference 551 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 580
for a management station that is on a different subnet (note the added gateway IP address): switch:admin> portcfg inbandmgmt ge0 routeadd 192.168.3.0 255.255.255.0 192.168.1.250 See Also portCfgShow, portCmd, portShow, switchShow, configure, fastWriteCfg 552 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 581
A value of 0 sets the default AL_PA to 0x0. This operand is required. Examples To configure a port with AL_PA 0x0 (default): switch:admin> portcfgalpa 1/3 0 To configure a port with AL_PA 0x13: switch:admin> portcfgalpa 1/3 1 See Also portCfgShow Fabric OS Command Reference 553 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 582
the auto disable feature on a port, on which this feature is already enabled: switch:admin> portcfgautodisable --enable 8 Same configuration for port 8 To enable the auto disable feature on a port range. switch:admin> portcfgautodisable --enable 0-8 554 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 583
example enables port 4. switch:admin> portcfgautodisable --enable 2-4 Same configuration for port 2 Same configuration for port 3 To disable the auto disable feature on a port range. switch:admin> portcfgautodisable --disable 0-8 See Also portCfgShow, portEnable : Fabric OS Command Reference 555 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 584
configuration on the specified port. --help Displays command usage. Examples To enable credit recovery on a port: switch:admin> portcfgcreditrecovery --enable 3/15 To disable credit recovery on a port: portcfgcreditrecovery --disable 3/15 See Also portCfgShow 556 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 585
1/3 To reset a GbE port to factory defaults: switch:admin> portcfgdefault 8/ge1 See Also portCfgEport, portCfgGport, portCfgLongDistance, portCfgLport, portCfgPersistentDisable, portCfgPersistentEnable, portCfgShow, portCfgSpeed, portCfgTrunkPort Fabric OS Command Reference 557 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 586
of the port to be configured, followed by a slash (/). port Specifies the number of the port to be configured, relative port: switch:admin> portcfgeport 1/3, 0 To enable E_Port capability on a port: switch:admin> portcfgeport 1/3, 1 See Also portShow, switchShow 558 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 587
domain ID is configurable. The preferred domain ID is used 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 588
are supported: slotnumber Specifies the slotnumber on enterprise-class platforms, followed by a slash (/). portnumber Specifies the portnumber. Use switchShow for a list of valid ports. When executed with [slotnumber]portnumber only, the command displays the current port configuration. -a admin - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 589
fabric parameter negotiation on port 2/0 of an EX_Port: switch:admin> portcfgexport 2/0 -t 2 To enable IDID on port 2: switch:admin>portcfgexport 2 -i 1 To display EX_Port settings configured for Mi10K connectivity: switch:admin> portcfgexport 10 Port 10 info Admin: enabled State: OK Pid - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 590
To allocate 12 buffers to an F_Port: switch:admin> portcfgfportbuffers --enable 2/44 12 To disable the port buffer configuration and return to the default buffer allocation: switch:admin> portcfgfportbuffers --enable 2/44 12 See Also portBufferShow 562 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 591
from the port. A value of 0 is the default port state. Mode must be preceded by a comma. This operand is required. Examples To configure port as a locked G_Port: switch:admin> portcfggport 1/3, 1 See Also configure, portCfgLport, portShow, switchShow Fabric OS Command Reference 563 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 592
are persistent across switch reboots and power cycles. This configuration can be cleared but not set on VE/VEX_Ports. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 593
To disable ISL R_RDY mode on a port: switch:admin> portcfgislmode 1/3, 0 See Also configure, portCfgLongDistance, portCfgShow portCfgISLMode 2 Fabric OS Command Reference 565 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 594
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 requires an - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 595
. The buffer credits for the given E_Port are automatically configured based on the actual link distance. Up to a total of 1452 full-size frame buffers are reserved depending on the distance measured during E_Port initialization. Fabric OS v6.1.0 or later supports up to 3000 km at 1 Gbps, up - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 596
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 configure, portCfgISLMode, portCfgTrunkPort, portCfgShow, portShow, switchShow 568 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 597
if omitted; the default value of 0 is used. Private devices are supported only on Brocade enterprise-class platforms with FC2-16 and FC2-16 blades. On all other platforms, option 1 is blocked. duplex_mode Specify 2 to configure the specified port as a full-duplex L_Port with fairness. Specify 0 to - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 598
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 Private L_Port ON Locked Loop HD Loop Fairness See Also configure, portShow, switchShow 570 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 599
different virtual port ID to each Fibre Channel protocol device without impacting your existing hardware implementation. The virtual port has the same properties as an N_Port, and is therefore capable of registering with all fabric services. The following conditions must be met for a switch port to - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 600
Port Rate Limit Credit Recovery where AN:AutoNegotiate, ..:OFF, ??:INVALID. LM:L0.5 (output from other ports suppressed) To disable NPIV functionality on a port: switch:admin> portcfgnpivport 1/3 0 See Also configure, portCfgDefault, portCfgShow 572 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 601
enable N_Port functionality for a port: switch:admin> portcfgnport 2 1 To enable N_Port functionality for a set of ports in a specific range: switch:admin> portcfgnport 2-3 1 To display the N_Port configuration for all the ports: switch:admin> portcfgnport Ports 0 1 2 3 4 5 6 7 8 9 10 11 12 13 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 602
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: slot For bladed systems only, specify the slot number of the port to configure, followed - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 603
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: slot For bladed systems only, specify the slot number of the port to configure, followed - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 604
Gbps and the port comes online only at 2 Gbps, no enforcement is needed. Specify an ingress rate in Mbps. Supported values for --setratelimit are: 200, 400, 600, 800, 1000, 1500, 2000, 2500, 3000, 3500, 4000, 5000, 6000, 7000, 8000. --help Displays command usage. 576 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 605
rate limit on a port to 2 Gbps: switch:admin> portcfgqos --setratelimit 3/15 2000 To set the default QoS configuration on a port: switch:admin> portcfgqos --default 3/15 See Also portCfg, portCmd, portShow, switchShow, configure : PortCfgQos 2 Fabric OS Command Reference 577 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 606
• Static routes on the IP interfaces • Fibre Channel over IP (FCIP) tunnel configuration settings - IKE and IPSec policy information - QoS mappings • Port Mode information • VLAN tag configuration • Inband Management IP addresses and routes configured on the Brocade 7500 The following information - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 607
ON when Credit Recovery is enabled on the port or (..) or OFF when disabled. This value is set by the portCfgCreditRecovery command. The credit recovery feature is enabled by default, but only ports configured as long distance ports can utilize this feature. Fabric OS Command Reference 579 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 608
This argument is optional. inbandmgmt Displays any inband management interfaces configured on the 7500 for a specified GbE port. Examples To display the port configuration settings on an enterprise-class platform: switch:admin> portcfgshow Ports of Slot 2 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 609
.. .. .. Ports of Slot 2 16 17 18 19 20 21 22 23 24 25 26 27 Port Mirror Port FC Fastwrite Rate Limit Credit Recovery ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON Port Auto Disable ON ON ON ON where AN:AutoNegotiate, ..:OFF, ??:INVALID, LM:L0.5 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 610
Auto Disable ON To display FCIP tunnels configured on a GbE port. (refer to the portCfg help page for an explanation of the displayed parameters): switch:admin> portcfgshow 10/ge0 Mode: FCIP Persistent Disable: OFF Ipif configuration: Interface IP Address NetMask MTU 0 192.168.60 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 611
IP Addr 192.168.60.181 Local IP Addr 192.168.60.101 Remote WWN Not Configured Local WWN 10:00:00:05:1e:39:80:65 Compression on Fastwrite off Tape Pipelining off Committed Rate 125000 Kbps (0.125000 Gbps 0 11 47 4 15 63 0 Vlantag configuration Fabric OS Command Reference 583 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 612
.1 100 7 192.168.10.1 App 192.168.10.1 100 3 0.0.0.0 Perm To display inband management interfaces configured on the Brocade 7500: switch:admin> portcfgshow inbandmgmt ge1 Inband management: Enabled Port: ge1 CP Interface IP Address NetMask MTU 0 192.168.255.1 255.255.255.252 1500 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 613
The port is set at a fixed speed of 2 Gbps. 4 The port is set at a fixed speed of 4 Gbps. 8 The port is set at a fixed speed of 8 Gbps. Examples To set the speed of a port to 4 Gbps: switch:admin> portcfgspeed 2/3, 4 See Also portCfgShow, portShow, switchCfgSpeed Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 614
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: slot For bladed systems only, specifies the slot number of the port to be configured, followed - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 615
portCfgVEXPort 2 portCfgVEXPort Synopsis Description Notes Configures a port as a VEX_Port connected to an FC-IP and sets and displays VEX_Port configuration parameters. portcfgvexport [slotnumber/]portnumber portcfgvexport [-a admin] portcfgvexport [-f fabricid] portcfgvexport [-r ratov] - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 616
Brocade setting interoperability modes with the interopMode command. Examples To display the VEX_Port configuration of port 2/16: switch:admin> portcfgvexport 2/16 Port 2/16 Admin: State: Pid format: Edge Fabric ID: Front Domain ID: info enabled OK core(N) 16 160 588 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 617
-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 To disable fabric parameter negotiation on port 2/20 of a VEX_Port: switch:admin> portcfgvexport 2/20 -t 2 See Also portCfgEXPort, portDisable, portEnable, portShow Fabric OS Command - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 618
(ipperf) characterization feature, or to ping or trace route to a destination IP host from an intelligent GbE port. Notes Virtual LAN (VLAN) tagging is supported on the Brocade FR4-18i and all 7500 platforms that run Fabric OS v6.0.0 or later. To ensure that test traffic traverses the same path - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 619
L2 Class-of-Service Specifies Class of Service/Priority, as defined by IEEE 802.1p. IP address from one of the source IP interfaces on the GbE port. Valid arguments include: Specifies the source IP address that originates the ping request. IPv6 addresses are supported. Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 620
-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 0. This operand is optional with the -v option. --traceroute Traces the IP router hops used to reach the host dst_ip from one of the source IP interfaces on the GbE port - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 621
-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 0. This operand is optional. with the -v option. Examples To verify if packets can be sent to the destination IP address with maximum wait_time specified: switch:admin - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 622
to be set for port modules; valid values are 1 to 5. vbs_lvl Specify the verbose level to be set for port modules; valid values are 1 to 5. Examples To set debug level and verbose level of port modules: switch:admin> portdebug 3 4 See Also dbgShow 594 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 623
, relative to its slot for bladed systems. Use switchShow to display a list of valid ports. Examples To disable a port: switch:admin> portdisable 2/4 See Also portCfgPersistentDisable, portCfgPersistentEnable, portEnable, portShow, switchShow Fabric OS Command Reference 595 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 624
, relative to its slot for bladed systems. Use switchShow to display a list of valid ports. Examples To enable a port: switch:admin> portenable 2/4 See Also portCfgPersistentDisable, portCfgPersistentEnable, portDisable, portShow, switchShow 596 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 625
Class 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 24 0 0 0 0 0 0 11 0 0 4 8 0 0 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 626
0 0 0 0 0 0 0 0 0 0 0 0 4 0 0 15: 0 0 0 0 0 0 0 0 0 0 0 0 4 0 0 16: 0 0 0 0 0 0 0 0 0 0 0 0 4 0 0 17: 0 0 0 0 0 0 0 0 0 0 0 0 4 0 0 18: 0 0 0 0 0 0 0 0 0 0 0 0 4 0 0 19: 0 0 0 0 0 0 0 0 0 0 0 0 4 0 0 (output truncated) See Also portShow, portStatsShow 598 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 627
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 port status for all ports in the switch: switch:user> portflagsshow Slot Port SNMP Physical - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 628
list of user ports on which to run the test. If omitted, all the active ports in the switch are assumed. For more information, refer to the itemList command. Examples To test port LEDs: switch:admin> portledtest -ports 1/1-1/5 passed. See Also itemList, switchDisable, switchEnable 600 Fabric OS - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 629
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 port log: switch:admin> portlogclear switch:admin> portlogshow port log is empty See Also portLogDump, portLogShow - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 630
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: switch:admin> portlogconfigshow max portlog entries = 8192 See Also portLogResize - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 631
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 603 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 632
of the information displayed by this command, refer to the Fabric OS Administrator's Guide. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 633
, device-to-switch, switch-to-switch, some device-to-device1, and control information If the port log is disabled, the following message displays as the first line. Refer to portLogClear command for more information. WARNING: port log is disabled Refer to the Fabric OS Administrator's Guide for more - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 634
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 606 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 635
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 information about port log events: switch:admin> portlogeventshow ID Event-Name Disabled 1 start 0 2 disable - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 636
24-bit Port ID of the attached device. WorldWideName The port's World Wide Name. credit The credit for this login as appropriate. This is BB (buffer-to-buffer) credit for Flogs and EE (end-to-end) credit for PLOGIs. df_sz The default frame size for this login. cos Class of Services supported - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 637
" for details. Operands This command has the following operand: 0|1 Specify 0 to clear or 1 to set 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 Fabric OS Command Reference 609 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 638
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 610 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 639
of port log entries. The valid range of values is 32,768 to 65,536 for the Brocade 7500, 7600, 48000, DCX, and DCX-4S. For all other platforms, the range is 8,192 to 16,384. Examples To resize the portlog: switch:admin> portlogresize 12288 See Also portLogConfigShow Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 640
file in the switch firmware, which can save up to 32,768 entries. Refer to portLogConfigShow to display the current port log size. Once the log has reached the maximum size, new entries displace the oldest ones. The port log captures switch-to-device, device-to-switch, switch-to-switch, some device - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 641
2 fcout read write err frame nsRemQ rscn xalloc xfree xerr xstate payload Port Cmd ioctl Tx & Rx scn pstate ctin fc f8 ctout errlog loopscn OLP LIP LIM BMP OLD TMO Args start disable enable Outgoing Fibre Channel information unit. Information unit header log from read operation. Information unit - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 642
FC-PH busy reason. ctin Argument 0 is divided into two 16-bit fields: [A] a bit map indicating whether subsequent arguments are valid (0001 means argument 1 is valid, 0003 means arguments 1 and 2 are valid). [B] the CT-based service 1 Online 614 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 643
LIP reason 8001 Retry loop init. 8002 Start loop after gaining sync. 8003 Restart loop after port reset. 8004 LIP when a loop hangs. 8005 Restart loop if LIP received when sending out . NF Negotiation follows. NC Negotiation complete. Fabric OS Command Reference 615 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 644
the saved port log from the last switch fault. Refer to upTime for a list of conditions that cause a fault. The count is ignored when the saved log is displayed. This operand is optional. Examples To view the port log for a port: switch:user> portlogshow 24 time task event port cmd args - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 645
. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operands: portid Specify the number of the port for which to display the log. Examples To display a port log for port 14: switch:user> portlogshowport - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 646
values corresponding to different log types can be obtained by running portLogEventShow. Examples To disable event 2 from reporting to the port log: switch:admin> portlogtypedisable 2 See Also portLogDisable, portLogEventShow, portLogTypeEnable 618 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 647
type to be enabled. The values corresponding to different log types can be obtained by running portLogEventShow. Examples To enable event 2 to report to the port log: switch:admin> portlogtypeenable 2 See Also portLogEventShow, portLogTypeDisable Fabric OS Command Reference 619 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 648
Notes This command does not support High Availability (HA). The Brocade DCX series cannot negotiate speeds of 1 Gbps. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 649
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 initialized port went to an uninitialized state. STATS Errors were found in the ASIC statistics. Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 650
2 portLoopbackTest TIMEOUT XMIT See Also itemList Did not receive a frame in the given timeout period. Frame transmission failure. 622 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 651
is not online. A connection that is "Enabled" has been configured in the hardware. A new connection cannot conflict with a "Defined" or "Enabled" port mirror connection. Use the portCfgShow command to display all configured mirror ports on a switch. Fabric OS Command Reference 623 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 652
not supported on all platforms. Refer to the Fabric OS Administrator's Guide for more information. The port mirror feature is blocked in Virtual Fabric mode. The mirror port location can impact the latency of mirrored frames. The execution of this command is subject to Virtual Fabric or Admin Domain - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 653
0x011400 0x240400 To display port mirror connections: switch:admin> portmirror --show Number of mirror connection(s) configured: 2 Mirror_Port SID DID State 10/12 0x791800 0x791900 Defined 10/15 0x791a00 0x799300 Enabled See Also portCfgShow Fabric OS Command Reference 625 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 654
as "|". Without operands, the port names of all ports present are displayed. 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, portCfgDefault, portShow 626 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 655
total for these ports. Results display every second or over the specified interval. Enter, Ctrl-c, or Ctrl-d to exit the display. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 656
Bit 16 set (value 0x10000), indicating this port always routes broadcast frames to the embedded port, for handling by the firmware. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 657
portRouteShow 2 Examples To display the routing tables for a port: switch:user> portrouteshow 4/15 port address ID: 0x02bf00 external unicast routing table: 1: 0x4 (vc=3) 2: 0x10000 (vc=0) internal unicast routing table: 60: 0x8000 (vc=2) 63: 0x1000 (vc=5) broadcast routing table: 0x10000 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 658
, the command displays specific FCIP related port configuration parameters, such as the following: • Address resolution protocol (ARP) entries • IP interfaces on the GbE port • Static routes on the IP interfaces • Fibre Channel over IP (FCIP) tunnel configuration settings • FCIP tunnel statistics - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 659
. portId The port's 24-bit port ID. portIfId The user port's interface ID. portWwn The port's World Wide Name. portWwn of devices(s) connected The World Wide Port Names of connected devices. Distance The port's long-distance level. In case of LD mode, the user configured distance and actual - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 660
Hash Algorithm Displays hash type (MD5 or SHA-1) if DH-CHAP authentication is used. Otherwise, displays N/A. Edge fabric's primary WWN If the EX_Port is connected to an edge switch with FCS policy enforcement, the WWN of the primary FCS is displayed when the edge fabric is secure and the primary - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 661
LIPs) received, number of LIPs transmitted, and the last LIP received. In Fabric OS v6.2.0 or later, each GbE port is associated with a TCP history, which tracks the state of statistics at the . The TCIP statistics include the following information: Fabric OS Command Reference 633 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 662
The type of TCP connection (CONTROL or DATA) LPort Local port RPort Remote port OOO Counter of out-of-order segments OOO H Out-of-order feature. Byte streaming allows the Brocade switch to communicate with third party WAN optimization hardware. Refer to portCfg for more information on - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 663
The output of this command may vary depending on the hardware platform and port type. 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. In an - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 664
post display statistics; requires a preceding argument. vlantag Displays VLAN tag configuration settings. ftrace FTRACE is a debug tool for developers and support (not intended for customer use). For usage information, execute portShow ftrace. 636 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 665
must be running a Brocade 7500 or a chassis with an FC4-18i blade. Note that the Front Domain ID is what is shown: switch:admin> portshow 8/4 portName: portHealth: No Fabric Watch License Authentication: None EX_Port Mode: Enabled Fabric ID: 20 Fabric OS Command Reference 637 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 666
Slot: 10 Port: ge0 Interface IP Address NetMask MTU 0 192.168.60.100 255.255.255.0 1500 Interface IP Address NetMask MTU 1 192.168.60.101 255.255.255.0 2348 Interface IP Address NetMask MTU 2 192.168.60.102 255.255.255.0 1260 638 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 667
this tunnel" Remote IP Addr 192.168.10.2 Local IP Addr 192.168.44.9 Remote WWN Not Configured Local WWN 10:00:00:05:1e:38:84:65 Compression off Fastwrite off Tape Pipelining off Committed Rate 900000 Kbps (0.900000 Gbps) SACK on Min Retransmit Time 100 Fabric OS Command Reference 639 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 668
: 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 192.168.10.2 Remote WWN Not Configured Local WWN 10:00:00:05:1e:39:37:5f Compression off Fastwrite off Tape Pipelining off Committed Rate 900000 Kbps (0.900000 Gbps - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 669
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 IP Addr 10.62.0.100 Local IP Addr 10.10.9.100 Remote WWN Not Configured Local WWN 10:00:00:05:1e:39 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 670
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 Addr 10.62.0.100 Local IP Addr 10.10.9.100 Remote WWN Not Configured Local WWN 10:00:00:05:1e:39 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 671
Switch:admin> portshow fciptunnel ge1 0 -hist Port: ge1 Tunnel ID 0 Tunnel Description "This is a test Description of this tunnel" Remote IP Addr 192.168.114.2 Local IP Addr 192.168.114.1 Remote WWN Not Configured 3225 Thu May 29 17:03:10 2008| Fabric OS Command Reference 643 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 672
test Description of this tunnel" Remote IP Addr 192.168.114.2 Local IP Addr 192.168.114.1 Remote WWN Not Configured Local WWN 10:00:00:05:1e:38:84:65 Compression off Fastwrite off Tape Pipelining off Committed Rate 900000 Kbps (0.900000 Gbps) SACK on 644 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 673
Resolved 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 10.62.0.100 Local IP Addr 10.10.9.100 Remote WWN Not Configured Local WWN 10:00 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 674
testingFIPSandIPSec To display QoS Mappings: switch:admin> portshow fciptunnel 9/ge0 0 -qosmap Slot: 9 Port: ge0 Tunnel ID 0 Tunnel Description "This is a test Description of this tunnel" Remote IP Addr 10.62.0.100 Local IP Addr 10.10.9.100 Remote WWN Not Configured Local WWN 10:00:00 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 675
: 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 Local WWN 10:00:00:05:1e:41:2f:2e Compression off Fastwrite on Tape Pipelining off Committed Rate 400000 Kbps (0.400000 Gbps) SACK - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 676
but post selected statistical areas: switch:admin> portshow ficon ge0 all -fdcb 10008000 -clear To display the inband management interfaces configured on the 7500: switch:admin> portshow inbandmgmt ge1 Port: ge1 Inband Management: Enabled CP Interface IP Address NetMask MTU 0 192.168 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 677
hardware statistics for a port. portstats64show [slotnumber/]portnumber Use this command to display the following hardware statistics for a port outside of frames. er64_disc_c3 Number of class 3 frames discarded. stat64_rateTxFrame Tx frame rate Fabric OS Command Reference 649 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 678
Occasions on which input buffers are full. stat64_rxClass1Frames Class 1 frames received. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 679
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 Tx frame rate 0 bottom_int : 4-byte words transmitted See Also portStatsClear, portStatsShow Fabric OS Command Reference 651 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 680
(/). port Specify a port number to be cleared, relative to its slot for bladed systems. Use switchShow to display a list of valid ports. Examples To clear hardware statistics for a port: switch:admin> portstatsclear 4/15 See Also portStats64Show, portStatsShow 652 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 681
Synopsis Description Displays port hardware statistics. portstatsshow [slotnumber/]portnumber portstatsshow [ge | ip | fcip ] [slotnumber/]geportnumber [ipaddress | tunnelnumber] Use this command to display port hardware statistics counters. Some counters are platform- or port-specific and display - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 682
sets (platform- and port-specific). er_c3_timeout The number of class 3 frames discarded due to timeout (platform- and port-specific). er_c3_dest_unreach The number of class Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 683
slot 8 and GbE port 1: switch:admin> portstatsshow ge 8/ge1 ge_stat_tx_frms ge_stat_tx_octets ge_stat_tx_ucast_frms ge_stat_tx_mcast_frms 0 GE transmitted frames 0 GE transmitted octets 0 GE transmitted unicast frames 0 GE transmitted multicast frames Fabric OS Command Reference 655 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 684
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 GbE port 1: switch:admin> portstatsshow ip 8/ge1 192 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 685
, relative to its slot for bladed systems. Examples To swap area numbers between a pair of ports: switch:admin> portswap 1/3 2/5 portswap done See Also portDisable, portEnable, portShow, portSwapDisable, portSwapEnable, portSwapShow, switchShow Fabric OS Command Reference 657 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 686
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 portswap feature: switch:admin> portswapdisable See Also portSwap, portDisable - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 687
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 portswap feature: switch:admin> portswapenable See Also portSwap, portDisable - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 688
area 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 details - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 689
Fabrics, this test can only be executed from the default 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 Virtual Fabrics. Fabric OS Command Reference 661 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 690
before you configure the logical switches or disable the Virtual Fabric feature on the switches connected to the ports you are testing. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 691
has the following operand: -ports itemlist Specify a list of user ports to test. By default, all user ports in the current slot is assumed. Refer to the itemList help page for further details. Examples To display information from portTest: switch:admin> porttestshow 1 Port 1 : PASS PortType - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 692
-class platforms, displays the trunk index. Trunk Area On single processor switches only, displays the TA of the trunk group. ptA->ptB ptA indicates the local user port; ptB indicates the remote user port. sp Port speed in Gbps. bw Port bandwidth in Gbps. 664 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 693
AG mode is enabled. This command is supported only on Brocade 48000 and Brocade DCX enterprise-class platforms running Fabric OS v6.1 or later. For Firmware compatibility and upgrade/downgrade considerations, refer to the Fabric OS Administrator's Guide. The execution of this command is subject - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 694
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. 666 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 695
Show switch/port information: switch:admin> switchshow switchName: SPIRIT_B4_01 switchType: 66.1 switchState: Online switchMode: Native switchRole: Principal switchDomain: 2 switchId: fffc02 switchWwn: 10:00:00:05:1e:41:22:80 zoning: OFF switchBeacon: OFF FC Router: ON FC Router - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 696
Trunk index 125 enabled for ports 10/13 and 10/14. 3. Show the TA port configuration (ports still disabled): switch:admin> porttrunkarea --show enabled Slot Port Type State Master TI DI 10 13 -- -- -- 125 125 10 14 -- -- -- 125 126 668 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 697
the TA port configuration after enabling the ports: switch:admin> porttrunkarea --show enabled Slot Port Type State Master TI DI 10 13 F-port Master 10/13 125 125 10 14 F-port Slave 10/13 125 126 portCfgTrunkPort, portCfgShow, portShow, switchCfgTrunk, switchShow Fabric OS Command Reference 669 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - 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 display the zone membership information of ports: switch:user> portzoneshow [OUTPUT TRUNCATED] PORT: 160 (160 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 699
Sets power supply goes out of service or a field-replaceable unit to cease executing the firmware. For example, if only Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To modify the power-off list order: switch:admin - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 700
to be powered off: (7..8) [8] 8 8th slot to be powered off: (7..7) [7] 7 Old POL New POL Power Off Order 10 1 1st 9 2 2nd 8 3 3rd 7 4 4th 4 10 5th Also chassisShow, powerOffListShow, psShow, slotPowerOff, slotPowerOn, slotShow 672 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 701
supply goes out of service or a field-replaceable processors to cease executing the firmware. For example, if only one Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the slot power off list order: switch:admin - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 702
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 view the status of the power supplies: switch:admin> psshow Power Supply #1 is OK DELTA - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 703
the new Active Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operand: -f Specify this operand when you want to fail over to the Standby CP and not affect any of the Fibre Channel ports : switch:admin> - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 704
Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display a list of routing-related commands: switch:admin delivery (IOD) option Configure in-order-delivery (IOD of the in-order delivery option Set or print the FSPF cost of - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 705
that runs Fabric OS v6.2.0. The Brocade 200E is unable to handle the maximum DB size supported in v6.2.0 and Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the size of the active security database: switch:admin - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 706
new data is saved persistently. New data is effective with the next authentication request. The configuration applies to a switch instance only. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 707
CHAP secret keys. If a fabric requires authentication, deleting this database may cause switch to segment from the fabric. Do want to remove secret key database? (yes, y, no, n): [no] y Deleting secret key database... Done. switch:admin> See Also none Fabric OS Command Reference 679 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 708
scp] [-ipaddr IP address] [-remotedir manage third-party certificates on a switch switch. • Display the contents of a certificate or CSR. • Delete a specified certificate. • Import or export a certificate. • Configure Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 709
new CSR for the switch. This is the second step in setting where ip_address is the IP address of the switch. -country country code Specifies full name, for example, "San Jose". If the locality consists name, for example, Brocade. If the organization OS Command Reference 681 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 710
from the switch to a IP address of the remote host. -remotedir remote directory Specifies the remote directory. Provide a fully qualified path name. -certname certificate name Specifies the certificate name. -login login name Specifies the login name for the server. 682 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 711
-org Brocade -orgunit software -cn 192.168.38.206 generating CSR, file name is: 192.168.38.206.csr Done To delete the CSR in interactive mode: switch:admin> seccertutil delcsr WARNING!!! About to delete CSR: 192.168.163.238.csr ARE YOU SURE (yes, y, no, n): [no] y Fabric OS Command Reference 683 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 712
]. To import a PKI-based certificate with configure and enable option in interactive mode: switch:admin> seccertutil import -config swcert -enable https Select protocol [ftp or scp]: ftp Enter IP address: 192.168.38.206 Enter remote directory: /users/home/mycerts Enter certificate name (must have - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 713
ldap ca certificate files: Sample.cer To display the content of the CSR one page at a time: switch:admin> seccertutil showcsr | more To display the content of a certificate: switch:admin> seccertutil show certificate_name See Also none secCertUtil 2 Fabric OS Command Reference 685 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 714
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 size of the defined security database switch:admin> secdefinesize Size of security defined data: 35 bytes (Max 1048576 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 715
Description Use this command to display security server (secd) specific information as a snapshot of its current state. The Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands Examples none To view the current security state: switch:admin - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 716
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----- completion [Output truncated] See Also secActiveSize, secDefineSize 688 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 717
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 security commands: switch:admin> sechelp fipscfg pkicreate pkiremove pkishow secactivesize secauthsecret seccertutil - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 718
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 1, "Using Fabric OS commands" and Appendix - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 719
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 activate the defined security policy set on all switches in the fabric: switch:admin> secpolicyactivate About to overwrite the current - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 720
reachable backup FCS switches are running pre-v5.3.0 versions of Fabric OS, a non-FCS v5.3.0 switch is allowed to modify the policy so that a new 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 721
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. To add a member to the SCC_POLICY using the device WWN: primaryfcs:admin> secpolicyadd "SCC_POLICY", "12:24:45:10:0a:67:00:40" Member(s) have been added - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 722
in Fabric OS v6.2.0 and can be configured on a logical switch basis. Notes When an FCS policy 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 723
enter an asterisk enclosed in quotation marks (*) as the member value. This feature cannot be used by the other security commands. Examples To create an FCS policy: primaryfcs:admin> secpolicycreate "FCS_POLICY", "3; 4" FCS_POLICY has been created. Fabric OS Command Reference 695 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 724
create a SCC policy in a Fabric with three switches: 1. Check if a policy exists. switch:admin> secpolicyshow ACTIVE POLICY SET DEFINED POLICY SET 2. Identify switches in the fabric. switch:admin> fabricshow Switch ID Worldwide Name Enet IP Addr FC IP Addr Name 2: fffc02 10:00:00:05:1e - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 725
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 The - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 726
primaryfcs:admin> secpolicydelete ALL_STALE_DCC_POLICY About to clear all STALE DCC policies ARE YOU SURE (yes, y, no, n): [no] y See Also secPolicyAbort, secPolicyActivate, secPolicyAdd, secPolicyCreate, secPolicyDump, secPolicyRemove, secPolicySave, secPolicyShow 698 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 727
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 can be issued from all FCS switches common prefix DCC_POLICY_ followed by a string of user-defined characters. These characters do not have - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 728
switch:admin> secpolicydump "active" ACTIVE POLICY SET DCC_POLICY_h1 Type WWN DId swName Switch 10:00:00:05:1e: defined database: switch:admin> secpolicydump "Defined" DEFINED POLICY SET FCS_POLICY Pos Primary DCC_POLICY_h1 Type WWN DId swName Switch 10:00:00:05:1e: - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 729
:5f:67 3 NeptuneSec 2 No 10:00:00:05:1e:90:09:4a - Unknown To display the SCC policies in the defined database: switch:admin> secpolicydump "Defined","SCC_POLICY" DEFINED POLICY SET SCC_POLICY WWN DId swName 10:00:00:05:1e:39:5f:67 3 NeptuneSec 10:00:00:05:1e:90:09:4a - Unknown To - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 730
this command, and the command must be issued 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 731
switch: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 , secPolicyShow Fabric OS Command Reference 703 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 732
associated with a 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 name. The port 704 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 733
SCC policy: switch:admin> secpolicyremove "SCC_POLICY", "12:24:45:10:0a:67:00:40" Member(s) have been removed from SCC_POLICY. See Also secPolicyAbort, secPolicyActivate, secPolicyAdd, secPolicyCreate, secPolicyDelete, secPolicyDump, secPolicySave, secStatsShow Fabric OS Command Reference 705 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 734
command is always a local switch operation. A fabric-wide consistency configuration does not affect the behavior of this command. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 735
DCC_POLICY_ followed by a string of user-defined characters. These characters do switch:admin> secpolicyshow "active ACTIVE POLICY SET FCS_POLICY Pos Primary 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 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 736
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 708 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 737
is issued on the primary FCS switch, 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 738
primary FCS switch. When domain is specified, the name operand is required. Examples To reset all statistics on the local switch: switch:admin> 69: primaryfcs:admin> secstatsreset DCC_POLICY, "1;69" Reset DCC_POLICY statistic. secStatsShow 710 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 739
on the primary FCS switch, this command can 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 740
from the primary FCS switch. primaryfsc:admin> secstatsshow TELNET_POLICY, "*" Fabric Statistics: Domain 1: Name Value TELNET_POLICY 0 Domain 69: Name Value TELNET_POLICY 0 Domain 70: Name Value TELNET_POLICY 0 secStatsReset 712 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 741
actual location of the sensors varies, depending on the switch type. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 742
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. If a logical switch FID is deleted, users logged into that switch are logged out. Operands This command has - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 743
the current debug and verbose level of the specified module. Examples To set the debug level for a module named NS to value 3: switch:admin> setdbg NS 3 switch:admin> dbgshow NS Module NS, debug level = 3, verbose level = 0 See Also dbgShow Fabric OS Command Reference 715 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 744
CP modem serial port. When the CP is active and dial-in is enabled, the modem is configured to answer an 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 745
-sensitive. level Specify the verbose level (0 to 9). Examples 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 = 3 See Also dbgShow, setDbg Fabric OS Command Reference 717 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 746
in the sfpShow output if any SFPs are replaced or removed while a port or a switch is disabled. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 747
display detailed SFP information for a Finisar "smart" SFP: switch:user> sfpshow 1/3 Identifier: 3 SFP Connector: detailed information for GbE port 0 on a Brocade 7500: switch:admin> sfpshow ge0 Identifier: 3 SFP Connector: 7 LC Transceiver Fabric OS Command Reference 719 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 748
To display all SFP information: switch:user> sfpshow -all Port 0: Identifier: 3 SFP Connector: 7 Port 1 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) 720 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 749
Rev: AA10 Wavelength: 0 (units nm) Options: 001a Loss_of_Sig,Tx_Fault,Tx_Disable BR Max: 5 BR Min: 5 Serial No: 21P70530005BW Date Code: 01062301 (output truncated) switchShow sfpShow 2 Fabric OS Command Reference 721 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 750
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 flow control: switch:admin> shellflowcontroldisable Disabling flowcontrol flow control - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 751
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 flow control: switch:admin> shellflowcontrolenable Enabling flowcontrol flow control - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 752
Specify the slot number of the blade to be powered down. This operand is required. Examples To power off blade unit 3: switch:admin> slotpoweroff 3 Slot 3 is being powered off See Also powerOffListSet, powerOffListShow, slotPowerOn, slotShow 724 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 753
the following operand: slotnumber Specify the slot number of the blade to be powered on. This operand is required. Examples To power on blade unit 3: switch:admin> slotpoweron 3 Powering on slot 3. See Also slotPowerOff, slotShow Fabric OS Command Reference 725 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 754
Core8 switch blade 37 FC8-16 port blade 55 FC8-32 port blade 51 FC8-48 port blade Status Displays the status of the blade as one of the following: VACANT The slot is empty. INSERTED, NOT POWERED ON The blade is present in the slot but is turned off. 726 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 755
To display a basic view of all slots and their status: switch:user> slotshow Slot Blade Type ID Status 1 SW BLADE 51 FAULTY 2 SW BLADE 51 DISABLED 3 SW BLADE 55 ENABLED(User Ports Disabled) 4 SW BLADE 51 DIAG RUNNING POST2 Fabric OS Command Reference 727 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 756
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 12 SW BLADE 51 FC8-48 ENABLED 728 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 757
model names for each blade in a Brocade DCX-4S: switch:user> slotshow -m lot Blade Type ID Model Name Status 1 SW BLADE 51 FC8-48 BLADE 37 FC8-16 ENABLED See Also bladeDisable, bladeEnable, chassisShow, slotPowerOff, slotPowerOn Fabric OS Command Reference 729 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 758
MIBs and traps supported by the SNMP agent. systemGroup Selects configuration parameters related to the system group. These parameters include sysDescr, sysLocation, sysContact, and authentication failure trap. secLevel Sets the SNMP security level. 730 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 759
initial set of authentication keys. You can change these passwords using this option. You can select the authentication protocol MD5/SHA or no authentication for each entry. The following combinations of protocols are supported: NoAuth/NoPriv Auth/NoPriv Auth/Priv Fabric OS Command Reference 731 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 760
. If an FCS policy is enabled, the configuration has to be updated on the primary switch and the nonprimary switches; unlike community strings, user names and passwords are not distributed for other switches in the fabric. When new passwords are entered for any user entry, a new authKey and privKey - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 761
Configuration Parameters sysDescr The system description. The default value is Fibre Channel switch. sysLocation The location of the system (switch). The default value is End User Premise. sysContact The contact information for this system (switch). The default value is Field Support. Refer - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 762
configured yet To set the SNMPv1 configuration of a switch: switch:admin> snmpConfig --set snmpv1 SNMP community and trap recipient configuration: Community (rw): [Secret C0de] Trap Recipient's IP t, false, f): [true] Committing configuration...done. 734 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 763
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: switch:admin> snmpconfig --set seclevel Select SNMP - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 764
on SNMP: Fabric 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 765
and media. If these pass, the fault lies in the cable, the remote switch, or media. The frame size depends on the amount of buffer credit available on the port. There are eight possible frames that can be sent. Especially with trunking groups, all eight possible frames are used unless there is - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 766
particularly at link speeds of 4 Gbps or higher. -ports 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 failed ports. Valid values are: 0 Does - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 767
ERR_STAT_ENCOUT ERR_STAT_TRUNC FINISH_MSG_ERR INIT 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 spinFab 2 Fabric OS Command Reference 739 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 768
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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 769
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 authentication for - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 770
Examples To configure a user for public key authentication: switch:admin> sshutil allowuser username Allowed user has been successfully changed to username. To display the configured user: switch:username> sshutil showuser username To set up SSH public key authentication on a switch for incoming - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 771
user. Do you want \ to proceed(Yes or No, default is No)?yes ssh public keys associated to username are deleted. To set up SSH public key authentication on a switch on a switch: switch:username> sshutil delprivkey private key is deleted successfully. See Also none Fabric OS Command Reference 743 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 772
the blade ports specified in -bports clears. A value of zero (0) clears the user ports specified in -uports. The default value is 0. Examples To clear port and diagnostic statistics: switch:admin> statsclear -bports 1/10-1/62 -use_bports 1 See Also itemList 744 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 773
list of user ports to test. By default, all the user ports in the switch are tested. Refer to itemList help pages for further details. Examples To stop the portTest command: switch:admin> stopporttest See Also portLoopbackTest, portTest, portTestShow, spinFab Fabric OS Command Reference 745 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 774
. Examples To display the FFDC configuration: switch:admin> supportffdc --show First Failure Data Capture (FFDC) is disabled. To enable the FFDC events: switch:admin> supportffdc --enable First Failure Data Capture (FFDC) is enabled. See Also none 746 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 775
to set, clear, or display support FTP parameters. The parameters set by this command are used by the supportSave and traceDump commands. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 776
: switch:admin> supportftp -s Host IP Addr[1080::8:800:200C:417A]:192.168.67.126 User Name[njoe]:admin Password[********]:password Remote Dir[support]:temp Auto file transfer parameters changed To set the time interval at which the FTP server connectivity is checked: switch:admin> supportftp -t 24 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 777
the command has finished. If there are blade processor (BP) blades installed on the switch, a support file (a.tar.gz file) is generated from each slot. This command accepts IPv4 and IPv6 addresses. If the configured IP address is in IPv6 format, the RAS auto file transfer and event notification to - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 778
. OK to proceed? (yes, y, no, n): [no] y Host IP or Host Name: 192.168.126.115 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 information for chassis:HL_5100_66, module:TRACE_OLD - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 779
information for chassis:HL_5100_66, module:SSHOW_NET... ......(output truncated) To collect support 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 780
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 is a diagnostic command and should only be run for diagnostic support. Output generated by this command may vary by switch configuration and - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 781
ports. lines Specifies the number of lines for the portLogDump output. This parameter is valid only with the slotnumber/portnumber parameters. Examples To display debugging information: switch:admin enabled: os enabled exception enabled port enabled fabric enabled services enabled - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 782
,00000834,00020182,00 000000 07:32:30.131 PORT Tx 0 40 07:32:30.131 PORT Rx 0 0 07:32:41.887 PORT Rx 0 40 07:32:41.887 PORT Tx 0 0 07:32:41.887 FCPH supportSave, supportShowCfgDisable, supportShowCfgEnable, supportShowCfgShow, traceDump 754 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 783
the FC Router group commands. asic_db Disables the ASIC DB group commands. iscsi Disables the ISCSI group commands. ag Disables the AG group commands. crypto Disables the encryption group commands Examples To disable the OS group of commands under the supportShow command: switch:admin - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 784
. Synopsis supportshowcfgenable os | exception | port | fabric | services | security | the FC Router group commands. asic_db Enables the ASIC DB switch:admin> supportshowcfgenable os Config update Succeeded supportShow, supportShowCfgDisable, supportShowCfgShow 756 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 785
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 supportShow command: switch:admin> supportshowcfgshow os enabled exception enabled port enabled fabric enabled services enabled security - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 786
beaconing mode. This operand is optional. If no operand is specified, the current value is displayed. Examples To turn beaconing mode on: switch:admin> switchbeacon 1 See Also To turn beaconing mode off: switch:admin> switchbeacon 0 switchShow 758 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 787
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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 788
enable a persistently disabled switch. All Fibre Channel ports that passed the power-on self-test (POST) are enabled and come online if connected to a device, or remain offline if disconnected. The switch may need to be enabled if it was previously disabled to make configuration changes or to run - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 789
2 Gbps. 4 The port is set at a fixed speed of 4 Gbps. 8 The port is set at a fixed speed of 8 Gbps. Examples To set the auto-sensing mode for all ports on a switch: switch:admin> switchcfgspeed 0 Committing configuration...done. See Also portCfgSpeed, portShow Fabric OS Command Reference 761 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 790
to all ports except the following \ VE/VEX_Ports (ports 176 - 191). See Also To disable trunking on all ports of a switch: switch:admin> switchcfgtrunk 0 Committing configuration...done. portCfgShow, portCfgTrunkPort, portShow, portTrunkArea, switchShow 762 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 791
disable all user ports on a switch. All Fibre Channel ports are taken offline. If the switch was part of a fabric, the remaining switches reconfigure. As each port is disabled, the front panel LED changes to a slow flashing yellow. The switch must be disabled before making configuration changes or - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 792
to enable all user ports on a switch. All Fibre Channel ports that passed the power-on self test (POST) are enabled. They can come online if connected to a device, or remain offline if disconnected. Use switchEnable to re-enable the switch after making configuration changes or running offline - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 793
the name operand to assign a new switch name. Enter this command without operand to display the current switch name. Changing the 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 794
on enterprise-class platforms. Slot Slot number; 1-4 and 7-10. Port Port number; 0-15, 0-31 or 0-47. Address The 24-bit Address Identifier. Address column is only displayed on enterprise-class platforms. Media Media types include: -- No module present 766 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 795
signaling a laser fault. The port is marked faulty. The port failed diagnostics. The port is locking to the reference signal. The port is running diagnostics. A port connection is not established (for virtual ports only). The port is up and running. Fabric OS Command Reference 767 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 796
is capable of quality of service (QoS). (logical) Indicates a logical port. Switchshow shows all logical ports currently present in the logical switch. The command displays -1 for the slot for logical ports and the user port number for slot port. The logical port numbers are not persistent and - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 797
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. If a port is configured as a long distance port, the long distance level is displayed in the format - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 798
1 switchId: fffc01 switchWwn: 10:00: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] Index Slot Port Address Media Speed State Proto 770 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 799
-- OnlineE-Port 10:00:00:05:1e:40:f0:79 "Switch 1" (logical) 770 -1 770 -- -- -- Offline(logical) 785 -1 785 -- -- -- Offline Disabled (logical, reason why port was disabled) See Also portCfgLongDistance, switchDisable, switchEnable, switchName Fabric OS Command Reference 771 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 800
the overall switch status to MARGINAL. If two 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 801
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 448) [0] Policy parameter set has been changed switchStatusPolicyShow, switchStatusShow Fabric OS Command Reference 773 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 802
FaultyPorts DOWN parameter 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 803
Flash 0 1 MarginalPorts 2 1 FaultyPorts 2 1 MissingSFPs 0 0 See Also switchStatusPolicySet, switchStatusShow switchStatusPolicyShow 2 Fabric OS Command Reference 775 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 804
PM Switch Name: switch IP address: 1080::8:800:200C:417A SwitchState: MARGINAL Duration: 80:12 Power supplies monitor Temperatures monitor Fans monitor Flash monitor Marginal ports monitor Faulty ports monitor HEALTHY HEALTHY HEALTHY MARGINAL HEALTHY HEALTHY 776 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 805
2 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 Report - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 806
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 view the uptime for the switch: switch:user> switchuptime 9:50pm up for 20 mins See - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 807
. --dump Displays specified policy violation. -dcc Specifies the violation type as DCC. Examples To display DCC violations for a switch: switch:admin> switchviolation --dump -dcc Device WWN Port 22:00:00:04:cf:75:59:87 10 See Also none Fabric OS Command Reference 779 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 808
the appropriate log files or users, depending on the system configuration. The specified facility is set the syslog facility to LOG_LOCAL1: switch:admin> syslogdfacility -l 1 Syslog facility changed to LOG_LOCAL1 See Also syslogdIpAdd, syslogdIpRemove, syslogdIpShow 780 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 809
syslogd. Use dnsconfig to configure the DNS service before running syslogdipadd with the host_name parameter. Examples To add an IP address to the list of machines to which system messages are sent: switch:admin> syslogdipadd 1080::8:800:200C:417A switch:admin> syslogdipshow syslog.1 1080::8:800 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 810
2. Add the DNS name server to the switch: switch:admin> dnsconfig Enter option 1 Display Domain Name Service (DNS) configuration 2 Set DNS configuration 3 Remove DNS configuration 4 Quit Select an item: (1..4) [4] 2 Enter Domain Name: [] brocade.com Enter Name Server IP address in dot/colon notation - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 811
configuration 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 1, "Using Fabric OS - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 812
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 all syslog daemon IP addresses configured on a switch: switch:admin> syslogdipshow syslog.1 1080::8:800:200C:417A See - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 813
. 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 A, "Command - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 814
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 See Also haDisable 786 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 815
ports, the burn-in parameter min_lb_mode can be changed to 1 to test the Fibre Channel through the loopback plug. Notes The switch Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS starting the testing operation. -short Sets the burn-in parameters that control - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 816
BLADE is supported at this time. Since only one FRU type is supported, this parameter Refer to the Fabric OS Message Reference for more information. Examples To initiate a system verification test on all switches in the fabric: switch:admin> systemverification -short systemverification: Setting - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 817
temperature and status sensors: switch:user> tempshow Index Slot State Centigrade Fahrenheit 1 1 Ok 41 105 2 2 Ok 39 102 3 3 Absent 4 4 Absent 5 5 Ok 26 78 6 6 Ok 27 80 See Also fanShow, psShow, sensorShow, slotShow Fabric OS Command Reference 789 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 818
; if omitted, the command displays the 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 Timeout will be in effect after NEXT login See Also none 790 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 819
display varies depending on the hardware configuration. The following rules apply: 1. On all switches, the command displays the number of domains in the fabric and the local Domain IDs. If translate domains are configured, existing translate domains and associated ports are displayed. 2. On an edge - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 820
single switch: domain is local, details are not displayed. switch:user> Gbps 1275 % D Domain: Metric: Name: Path Count: 2 1000 fcr_fd_2 1 Hops: Out Port: In Ports: Total Bandwidth: Bandwidth Demand: Flags: 2 15 0 1 2 3 4 5 6 7 8 9 11 2.000 Gbps 4000 % D 792 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 821
by port: 24 Local Translate Domain 5 owned by port: 23 33 Domain: Metric: Name: Path Count: 1 500 pengsaturn104 1 Hops: Out Port: In Ports: Total Bandwidth: Bandwidth Demand: Flags: 1 0 23 24 33 38 39 8.000 Gbps 350 % D Domain: Metric: Name: 3 10500 fcr_xd_3_6 Fabric OS Command Reference 793 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 822
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 794 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 823
file name format for the trace dump file is as follows: chassisname-S#-YYYYMMDDHHMMSS..tracedump.dmp.gz S# Indicates the slot number (0 on nonbladed systems initiate a background trace dump from slot 5: switch:admin> tracedump -n -s 5 Fabric OS Command Reference 795 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 824
2 traceDump See Also To remove a trace dump: switch:admin> tracedump -r trace dump removed supportFtp, supportSave, supportShow 796 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 825
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 information on the track-changes commands: switch:admin> trackchangeshelp trackChangesSet Configure alert for login/logout/config update - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 826
the track-changes feature: switch:admin> trackchangesset 1, 1 Committing configuration...done. switch:admin> trackchangesshow Track changes status: ON Track changes generate SNMP-TRAP: YES See Also snmpConfig, trackChangesHelp, trackChangesShow 798 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 827
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 track-changes feature: switch:admin> trackchangesshow Track changes status: ON Track changes generate - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 828
for a port. This operand is required. Examples To debug a trunk connection: switch:admin> trunkdebug 43 44 Switch does not support trunking switch:admin> trunkdebug 62 63 port 62 and 63 are trunked together See Also portCfgTrunkPort, switchCfgTrunk, trunkShow 800 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 829
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 trunking information for a switch: switch:admin> trunkshow 1: 6 -> 4 10:00:00:60:69 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 830
) E-Port (Trunk port, master is Slot 7 Port 7 ) E-Port (Trunk port, master is Slot 7 Port 7 ) E-Port (Trunk port, master is Slot 7 Port 7 ) E-Port (Trunk port, master is Slot 7 Port 7 ) E-Port 10:00:00:05:1e:37:12:13 "SW4900_43" portCfgTrunkPort, switchCfgTrunk 802 Fabric OS Command Reference 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 831
can only modify the clock server value 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 command - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 832
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 Clock Server configuration...done. See Also date 804 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 833
the switch operation in any way. System services started during the switch boot configured. This includes any Pre-v6.2.0 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 834
switch:admin> tstimezone -3, -30 Updating Time Zone configuration...done. System Time Zone change will take effect at next reboot. switch:admin> tstimezone Time Zone Hour Offset: -3 Time Zone Minute Offset: -30 To set St Pierre 7) Belize 24) Guatemala 41) St OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 835
panhandle neck 22) Alaska Time - west Alaska 23) Aleutian Islands 24) Hawaii Enter number or control-D to quit ?18 The following configuration: switch admin> tstimezone --old 2 switch admin> tsttimezone Time Zone Hour Offset: 2 Time Zone Minute Offset: 0 See Also date Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 836
rate than the PCI operation. This test is supported on all 4 G and 8 G platforms. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 837
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 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 838
48000, Static route configuration is not supported on Brocade directors set to chassis configuration option 5 by chassisConfig. 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 Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 839
the destination domain of the static route to remove. Examples To remove a static route for all traffic coming in from port 1 and addressed to domain 2: switch:admin> urouteremove 1 2 done. See Also configShow, dlsShow, uRouteConfig, uRouteShow Fabric OS Command Reference 811 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 840
is received. Except for the cases in which you perform a port swap or enable extended-edge PID (PID Format 2) on a switch, the value is equal to the Area field displayed by the switchShow command. Refer to Fabric OS Administrator's Guide for more information regarding the extended edge PID format - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 841
routing information of port 11 to domain 4 only: switch:admin> urouteshow 1/11, 4 Local Domain ID: 3 In Port Domain Out Port Metric Hops Flags Next (Dom, Port) 11 4 16 500 1 D 4,16 See Also portRouteShow, topologyShow, uRouteConfig, uRouteRemove Fabric OS Command Reference 813 53 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 842
storage space. Valid applications are: firmware, support, config, or firmwarekey. A specified switch:admin> usbstorage -l firmwarekey\ 0B support\ 106MB support1034\ 105MB config\ 0B 2007 Aug 15 15:13 2007 Aug 24 05:36 2007 Aug 23 06:11 2007 Aug 15 15:13 814 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 843
74% To remove an 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 Fabric OS Command Reference 815 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 844
the fabric. Target switches must be configured to accept the database. Accounts that are not consistent with the distributed database are overwritten. Account recovery from backup or access to backup data is no longer supported as of Fabric OS v6.0. 816 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 845
) access. Admin All administrative commands. SecurityAdmin All switch security and user management functions. The userConfig 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 846
users with SecurityAdmin or Admin role may execute this command. Displays a list of users who have permission to execute chassis commands. --add |--change Creates a new user account or modifies an existing user or LF the user is authorized to access. 818 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 847
invalid 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. Fabric OS Command Reference 819 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 848
a user account or deletes LF or chassis permission from a user account. The following operands are supported: username the current home LF is deleted, the new home LF is set to the lowest numbered LF in the user's LF permissions. The account's existing LF Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 849
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 initial password for joe Enter - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 850
illustrate how to create and manage user accounts in an LF-enabled environment. To create a new account named "test" with admin role and admin chassis permissions in the LF member list 1-10: switch:admin> userconfig --add test -l 1-10 -r admin -c admin Setting initial password for test Enter - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 851
: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 be logged out LFs/chassis role for account test has been successfully deleted. See Also none Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 852
are case-sensitive. old_username Specifies the current user login name. new_username Specifies thee new user login name. Examples To rename the admin-level login name from "USERID" to "admin": switch:admin> userrename USERID admin See Also none 824 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 853
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 BootProm: 4.6.6 See Also firmwareDownload, reboot Fabric OS Command Reference 825 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 854
24-bit Fibre Channel address that is used for communicating with the switch. Use farbricShow to display the FC address in addition to the WWN. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 855
manage Traffic Isolation (TI) Zones. TI zones control the flow of interswitch traffic by provisioning certain E_Ports to carry only traffic flowing from a specific set of source ports. The provision (a.k.a TI Zone) is part of the defined zone configuration OS Command Reference 827 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 856
supported only on switches running Fabric OS v6.1.0 or later. Participating devices must be LSAN-zoned to enforce TI. Using TI zones in logical fabrics has several restrictions. For more information, refer to the Fabric OS Administrator's Guide. 3. Use the --rdcreate and --rddelete options to manage - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 857
existing TI zones. --remove Removes port list members from existing zones. Removal of the last member from an active TI zone generates a warning. If the last member of a TI zone is removed, the TI zone name is removed from the defined TI zone list. Fabric OS Command Reference 829 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 858
, 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 , port lists, failover option, configured status and, starting with Fabric OS v6.2, the active status for the specified zones. The configured status - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 859
across a Fibre Channel router (FCR). Specify FCR to support FCR. Specify noFCR if you do 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 860
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: 2,3 Invalid configuration * - Member does not exist # - Invalid usage of broadcast zone 832 Fabric OS Command Reference 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 861
bluezone -p "3,4; 3,6" To activate the TI zone "bluezone": switch:admin> zone --activate bluezone To deactivate the TI zone "purplezone": switch:admin> zone --deactivate purplezone To delete the TI zone "bluezone": switch:admin> zone --delete bluezone Fabric OS Command Reference 833 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 862
, and target4 communicate over VE_Ports consisting of FCR1's port number 4 and FCR2's port number 7: switch:admin>zone --create -t ti fcr_ti_zone p "1,1; 2,1;host_PWWN; support. • The base zone object, "red_______base". • The RD zone configuration, "r_e_d_i_r_c__fg". 834 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 863
configuration: cfg: myHTcfg zone: 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 See Also ad, zoneHelp Fabric OS - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 864
configuration with the cfgEnable command. Notes When an FCS policy 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 865
configuration with the cfgEnable command. Notes When an FCS policy 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 866
to switch 2, ports 12 and port numbers and zone aliases: sw5:admin> zonecreate "Purple_zone", "1,0" sw5:admin> zonecreate "Blue_zone", "1,1; array1; 1,2; array2" sw5:admin> zonecreate "Green_zone", "1,0; 1,2; array2" See Also zoneAdd, zoneDelete, zoneRemove, zoneShow 838 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 867
configuration with the cfgEnable command. Notes When an FCS policy 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 868
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 zone command help information: switch:admin> zonehelp aliadd alicreate alidelete aliremove alishow cfgactvshow cfgadd - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 869
the configuration with the cfgEnable command. Notes When FCS policy 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 870
the configuration with the cfgEnable command. Notes When FCS policy 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 871
. Refer to the zoneCreate command for more information on name and member 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:admin> cfgshow - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 872
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. When an FCS policy is enabled, this command can be issued only from the primary FCS switch. Operands The following operands - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 873
configuration are displayed. 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 details. When FCS of the transaction buffer (the contents of - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 874
2 zoneShow 846 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 875
from the primary FCS switch. defzone --show can be run on all switches. All other options 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. Fabric OS Command Reference 847 53-1001186 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 876
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. Must be run from the primary FCS switch. 848 Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 877
. For information on Admin Domain concepts and restrictions, refer to the Fabric OS Administrator's Guide. Admin Domain Types are one or more of the following. If more than one AD type is listed for a command, the AD type is option- specific. Display options may be allowed, but set options may be - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 878
Users authenticated with the Admin and FabricAdmin RBAC roles may perform routine encryption switch management functions including the following: • Configure virtual devices & crypto LUN. • Configure LUN/tape associations. • Perform re-keying operations. • Perform firmware download - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 879
and admin domain type Command Name User Admin Oper SW Zone Fabric BS Sec Admin Admin Admin Admin Admin Admin Domain Disallowed leave_encryption_group N OM N N N O N OM Disallowed Fabric OS Command Reference 53-1001186-01 Context Switch Type VF DS VF DS VF DS VF DS VF DS VF - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 880
N N OM N O Disallowed set N OM N N N O N OS commands and permissions Refer to Table 2 for Fabric OS commands. 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 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 881
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 aliShow aptPolicy auditCfg auditDump authUtil bannerSet bannerShow bcastInfoShow bcastShow bladeDisable bladeEnable - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 882
Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin Admin Admin Admin Context Switch Type chassisConfig chassisDisable chassisEnablle chassisName chassisShow cliHistory configDefault configDownload configList configRemove configShow configUpload configure configureChassis - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 883
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 O OM O O O OM O N Allowed Context CH CH CH Switch Type N/A N/A N/A VF N/A CH N/A VF N/A VF N/A VF OS Command Reference 855 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 884
OS commands and permissions 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 O OM OM OM N OM O N SwitchMember VF All 856 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 885
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 O OM O O N OM O N SwitchMember Context Switch Type VF All VF All VF All VF All Disallowed OS Command Reference 857 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 886
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 N Allowed O OM OM OM O OM O N Allowed Context Switch Type VF All VF All CH N/A CH N/A CH N/A CH OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 887
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 CH VF VF CH VF VF VF VF VF VF VF VF Switch Type All All All All All All N/A All All N/A All All All All OS Command Reference 859 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 888
OS commands and permissions 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 VF VF VF VF VF VF VF VF Switch Type All All All All All N/A N/A N/A N/A All All All All - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 889
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 VF CH VF VF VF VF VF VF VF VF VF VF Switch Type All All N/A All All All All N/A All All All All All All All All All All - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 890
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 OM OM OM N OM O N SwitchMember CH N/A O OM OM OM N OM O N PortMember VF All 862 Fabric OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 891
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 shellFlowControlDisable O shellFlowControlEnable O slotPowerOff O slotPowerOn O slotShow O slTest - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 892
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 OM O O Allowed Context CH CH CH CH CH CH CH Switch Type N/A N/A N/A N/A N/A N/A N/A VF All CH N/A Disallowed OS Command Reference 53-1001186-01 - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 893
Admin Admin Admin Admin Admin zoneObjectExpunge zoneObjectRename zoneRemove zoneShow O OM O O OM OM O O Allowed O OM O O OM OM O O Allowed O OM O O OM OM O O Allowed O OM O O OM OM O O Allowed Context VF VF VF VF Switch Type All All All All Fabric OS Command Reference - HP Brocade 8/12c | Brocade Fabric OS Command Reference Manual v6.2.0 (53-1001186 - Page 894
A General Fabric OS commands and permissions 866 Fabric OS Command Reference 53-1001186-01
53-1001186-01
24 November 2008
Fabric OS
Command Reference Manual
Supporting Fabric OS v6.2.0