background image

53-1002063-09
02 August 2012

®

Fabric OS

Documentation Updates

Supporting Fabric OS v6.4.x

Summary of Contents for Fabric OS v6.4

Page 1: ...53 1002063 09 02 August 2012 Fabric OS Documentation Updates Supporting Fabric OS v6 4 x ...

Page 2: ...ense agreements To find out which open source software is included in Brocade products view the licensing terms applicable to the open source software and obtain a copy of the programming source code please visit http www brocade com support oscd Brocade Communications Systems Incorporated Document History Corporate and Latin American Headquarters Brocade Communications Systems Inc 130 Holger Way ...

Page 3: ...nual September 2011 Fabric OS Documentation Updates 53 1002063 07 Added updates for the Fabric OS Command Reference December 2011 Fabric OS Documentation Updates 53 1002063 08 Added updates for the Fabric OS Administrator s Guide and the Fabric OS Command Reference May 2012 Fabric OS Documentation Updates 53 1002063 09 Added updates for the Fabric OS Administrator s Guide and the Fabric OS Command...

Page 4: ...iv Fabric OS Documentation Updates 53 1002063 09 ...

Page 5: ... chapter 3 Documentation updates for Fabric OS v6 4 0 3 Chapter 3 Standard CEE Integrations and Configurations 3 Chapter 9 Configuring QoS using the CEE CLI 3 Documentation updates for Fabric OS v6 4 1 4 Chapter 3 Standard CEE Integrations and Configurations 4 Chapter 7 Configuring LLDP using the CEE CLI 4 Chapter 9 Configuring QoS using the CEE CLI 5 Chapter 3 CEE Command Reference In this chapte...

Page 6: ... chapter 15 Documentation updates for Fabric OS v6 4 0 15 APM Performance Monitoring 17 Documentation updates for Fabric OS v6 4 1 28 New commands in Fabric OS v6 4 1 28 Command RBAC permissions and AD types 31 Revised commands in Fabric OS v6 4 1 32 Documentation updates for Fabric OS v6 4 2 34 Documentation updates for Fabric OS v6 4 3 36 Chapter 6 Fabric OS Message Reference In this chapter 43 ...

Page 7: ...d enabling FCFW 52 Disabling FCFW 53 Disabling FCFW flows without removing FCFW 54 Chapter 9 Brocade DCX Backbone Hardware Reference Manual In this chapter 55 Chapter 5 Removal and Replacement Procedures 55 Preparing for the WWN card replacement 55 Chapter 10 Brocade DCX 4S Backbone Hardware Reference Manual In this chapter 57 Chapter 5 Removal and Replacement Procedures 57 Preparing for the WWN c...

Page 8: ...viii Fabric OS Documentation Updates 53 1002063 09 ...

Page 9: ...0 only Updates on page 7 March 2010 Fabric OS Administrator s Guide v6 4 0 and later Updates on page 9 September 2010 Fabric OS Command Reference v6 4 3 and later Updated on page 15 April 2012 Fabric OS Encryption Administrator s Guide LKM v6 4 0 and later No Updates March 2010 Fabric OS Encryption Administrator s Guide RKM v6 4 0 and later No Updates November 2010 Fabric OS Encryption Administrat...

Page 10: ...iscussions about SAN design implementation and maintenance you can obtain Building SANs with Brocade Fabric Switches through http www amazon com For additional Brocade documentation visit the Brocade SAN Info Center and click the Resource Library location http www brocade com Release notes are available on the MyBrocade web site and are also bundled with the Fabric OS firmware Web Tools Administra...

Page 11: ...ss of this document However if you find an error or an omission or you think that a topic needs further development we want to hear from you Forward your feedback to documentation brocade com Provide the title and version number of the document and as much detail as possible about your comment including the topic heading and page number and your suggestions for improvement ...

Page 12: ...xii Fabric OS Documentation Updates 53 1002063 09 ...

Page 13: ...ric OS v6 4 1 and later 1 Documentation updates for Fabric OS v6 4 1 and later Chapter 3 Managing Policies and Features in Access Gateway Mode Under the heading Trunking in Access Gateway Mode on page 48 add the following note at the bottom of the page NOTE N_Port Trunking is not supported for HBAs connected to switches running in Access Gateway mode This feature is only be supported for HBAs conn...

Page 14: ...2 Fabric OS Documentation Updates 53 1002063 09 Documentation updates for Fabric OS v6 4 1 and later 1 ...

Page 15: ... supported and cause the name to truncate Under the heading of Minimum CEE configuration to allow FCoE traffic flow on page 29 add the following note NOTE The name used in the cee map command must begin with a letter and can consist of letters digits hyphens and underscore characters Spaces are prohibited Special characters are not supported and cause the name to truncate Chapter 9 Configuring QoS...

Page 16: ...tep 3 Documentation updates for Fabric OS v6 4 1 Chapter 3 Standard CEE Integrations and Configurations Under the heading of Creating the CEE map on page 25 before the beginning of the procedure add the following note NOTE The name used in the cee map command must begin with a letter and can consist of letters digits hyphens and underscore characters Spaces are prohibited Special characters are no...

Page 17: ...sed in the cee map command must begin with a letter and can consist of letters digits hyphens and underscore characters Spaces are prohibited Special characters are not supported and cause the name to truncate Under the heading of Defining a priority group table on page 109 delete the example under step 4 Under the heading of Defining a priority table map on page 110 add the following note NOTE Th...

Page 18: ...6 Fabric OS Documentation Updates 53 1002063 09 Documentation updates for Fabric OS v6 4 1 2 ...

Page 19: ... the following Usage Guideline USAGE GUIDELINES The map name must begin with a letter and can consist of letters digits hyphens and underscore characters Spaces are prohibited Special characters are not supported and cause the name to truncate Documentation updates for Fabric OS v6 4 1 Revised commands in Fabric OS v6 4 1 Under the command cee map add the following Usage Guideline USAGE GUIDELINES...

Page 20: ...8 Fabric OS Documentation Updates 53 1002063 09 Documentation updates for Fabric OS v6 4 1 3 ...

Page 21: ... 125 the example is missing the command Add the following command line to the beginning of the example switch admin seccertutil import config swcert enable https Chapter 7 Configuring Security Policies In the section Import CA for FCAP on page 152 the command is incorrect in step 2 Change step 2 to the following 2 Enter the secCertUtil import fcapcacert command In the section Importing the FCAP sw...

Page 22: ...rcement is in effect if all members of a zone are identified the same way either using WWNs or D I notation but not both If the zone includes aliases then the aliases must also be defined the same way as the zone Session based hardware enforcement is in effect if the zone has a mix of WWN and D I members If a port is in multiple zones and is defined by WWN in one zone and by D I in another then se...

Page 23: ...icense SdSSc9SyRSTeXTdn Second Ports on Demand license additional 16 port upgrade license SdSSc9SyRSTuXTd3 Full Ports on Demand license additional 32 port upgrade license In Table 78 on page 368 add the following entry Chapter 17 Monitoring Fabric Performance In the section Limitations of Top Talker monitors on page 397 add the following item Fabric mode Top Talker monitors and FC FC routing are n...

Page 24: ...Top Talker monitors on page 396 for instructions Documentation Updates for Fabric OS v6 4 1 and later Chapter 19 Managing Trunking Connections In the section Trunking overview on page 425 add the following bullet N_Port Trunking configurations are between a switch and a Brocade Host Bus Adapter HBA See Configuring N_Port trunking for Brocade adapters and the Brocade Adapters Administrators Guide f...

Page 25: ...the portTrunkArea command switch admin porttrunkarea enable 3 40 41 index 296 Trunk index 296 enabled for ports 3 40 and 3 41 2 On the host side enable trunking as described in the Brocade Adapters Administrator s Guide 3 On the switch side enable the ports using the portEnable command switch admin portenable 3 40 switch admin portenable 3 41 ...

Page 26: ...14 Fabric OS Documentation Updates 53 1002063 09 Documentation Updates for Fabric OS v6 4 1 and later 4 ...

Page 27: ...dated with the following note This diagnostic cannot be run on an operational switch You must disable the switch using the chassisDisable command before you can run this test After the test completes re enable the switch using the chassisEnable command Do not use the switchDisable command followed by manually shutting down the ports before running the test This will not work because executing swit...

Page 28: ... platforms running Fabric OS v 6 2 0 or later On the Brocade 300 5100 5300 and 5410 platforms running earlier firmware versions the switch name can be up to 31 characters long On all other pre Fabric OS v6 2 0 platforms the name is limited to 15 characters When you configure a switch name with 31 characters on a switch running Fabric OS v 6 1 and upgrade from v6 1 X to v 6 2 the login prompt and s...

Page 29: ... MONITORING The following command help pages were accidental deleted from the code and in the v6 4 0 Command reference These commands are still valid in all v6 x firmware versions However the recommendation is to use the more recent commands perfMonitorShow and perfMonitorClear ...

Page 30: ...ace Refer to Chapter 1 Using Fabric OS Commands and Appendix A Command Availability for details Operands This command has the following operands slotnumber For bladed systems only specifies the slot number of the port on which the monitor is to be cleared followed by a slash portnumber Specifies the number of the port on which the monitor is to be cleared relative to its slot for bladed systems Us...

Page 31: ...ailability for details Operands This command has the following operands slotnumber For bladed systems only this operand specifies the slot number of the port on which the monitor is to be cleared followed by a slash portnumber Specifies the number of the port on which the monitor is to be cleared relative to its slot for bladed systems Use switchShow for a list of valid ports monitorId Specify the...

Page 32: ...ddWriteMonitor Add filter based monitor SCSI Write perfCfgClear Clear Performance settings from FLASH perfCfgRestore Restore Performance configuration from FLASH perfCfgSave Save Performance configuration to FLASH perfClearAlpaCrc Clears the CRC error count associated with a port perfCleareEEmonitor Clears statistics counters of one or more end to end performance monitors perfClearFilterMonitor Cl...

Page 33: ...ive to its slot for bladed systems Use switchShow for a list of valid ports interval Specify an interval in seconds 5 or more Tx and Rx counts are in the unit of bytes when this operand is specified This operand is optional if omitted this command displays cumulative counts Examples To display EE monitors configured on the switch port 0 switch admin perfshoweemonitor 0 There is 1 end to end monito...

Page 34: ... 0 53m 4 5m 0 53m 4 5m 0 53m 4 5m 0 53m 4 5m 0 53m 0 0 52m 4 5m 0 52m 4 5m 0 52m 4 5m 0 52m 4 5m 0 52m 0 output truncated To display cumulative information from EE monitors on a port switch admin perfshoweemonitor 4 5 There are 7 end to end monitor s defined on port 53 KEY SID DID OWNER_APP TX_COUNT RX_COUNT 0 0x21300 0x21dda TELNET 0x00000004d0ba9915 0x0000000067229e65 1 0x21300 0x21ddc TELNET 0x...

Page 35: ...ollowing operands slotnumber For bladed systems only this operand specifies the slot number of the port on which the monitor is to be cleared followed by a slash portnumber Specifies the number of the port on which the monitor is to be displayed relative to its slot for bladed systems Use switchShow for a list of valid ports interval Specify an interval in seconds 5 or more This operand is optiona...

Page 36: ...Y ALIAS OWNER_APP FRAME_COUNT OWNER_IP_ADDR 0 SCSI_Frame TELNET 0x00000000002c2229 N A 1 SCSI_WR TELNET 0x000000000000464a N A 2 SCSI_RW TELNET 0x000000000000fd8c N A 3 SCSI_RW WEB_TOOLS 0x0000000000007ba3 192 168 169 40 4 SCSI_RW WEB_TOOLS 0x0000000000004f0e 192 168 169 190 5 SCSI_RD WEB_TOOLS 0x0000000000002208 192 168 169 40 6 SCSI_WR WEB_TOOLS 0x000000000000033a 192 168 169 40 See Also perfMon...

Page 37: ...ctions that apply to some of the classes in terms of support for V VE VEX ports and GbE ports refer to the help page for fwConfigure or consult the Fabric Watch Administrator s Guide In Access Gateway mode only the following class thresholds are supported F FL Port Copper class threshold is supported only on Embedded platforms Notes This command requires a Fabric Watch license The execution of thi...

Page 38: ...Fan 3 Power Supply 4 return to previous page Select an area 1 4 4 2 Name Label Last value envFan001 Env Fan 1 2576 RPM envFan002 Env Fan 2 2518 RPM envFan003 Env Fan 3 2481 RPM switch user fwshow 1 Show class thresholds 2 Detail threshold information 3 Show port persistence time 4 Quit Select an item 1 4 3 2 Enter Threshold Name envFan001 Env Temperature 1 Monitored for 1283 21 mins Last checked 1...

Page 39: ...curred 10 times last at 16 49 02 on 12 09 2011 Event 5 occurred 1 time last at 16 30 23 on 12 09 2011 Callbacks No callbacks are registered To show port persistence time switch 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 fwCo...

Page 40: ...er off the slot before changing the buffer optimized mode Changes take effect immediately after the slot is powered on Enabling buffer optimized mode removes all long distance configurations on that slot You will be prompted if any long distance configuration is detected NOTES The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place For details o...

Page 41: ...switch admin bufopmode set 11 The operation is not supported when the slot is online switch admin bufopmode reset 12 The operation is not supported when the slot is online switch admin slotpoweroff 11 switch admin slotpoweroff 12 switch admin bufopmode set 12 Buffer optimized mode is turned on for slot 11 switch admin bufopmode reset 12 Buffer optimized mode is turned off for slot 12 switch admin ...

Page 42: ... Availability for details This command is not applicable to non FC ports OPERANDS This command has the following operands slot For bladed systems only specifies the slot number of the port to be configured followed by a slash port Specifies the number of the port to be configured relative to its slot for bladed systems Use switchShow for a listing of valid ports mode Specifies the fault delay valu...

Page 43: ...N ON ON ON ON ON ON ON ON ON ON ON ON ON QOS E_Port AE AE AE AE AE AE AE AE AE AE AE AE EX Port Mirror Port Rate Limit Credit Recovery ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON Fport Buffers Port Auto Disable Fault Delay 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 output truncated SEE ALSO portCfgShow Command RBAC permissions and AD types Refer to Table 2 for the RBAC and Admin Domain availability of ne...

Page 44: ...ou can configure Edge hold time only on the default switch Example To configure Edge hold time on a disabled switch Switch admin configure Configure Fabric parameters yes y no n no yes Domain 1 239 1 R_A_TOV 4000 120000 10000 E_D_TOV 1000 5000 2000 WAN_TOV 0 30000 0 MAX_HOPS 7 19 7 Data field size 256 2112 2112 Sequence Level Switching 0 1 0 Disable Device Probing 0 1 0 Suppress Class F Traffic 0 ...

Page 45: ...and Do NOT use the switchDisable command followed by manually shutting down the ports before running the test This will not work because executing switchEnable after the test completes will leave the ports in the same state as before The only way to bring the ports down before running the test and back up after the test completes is by using the chassisDisable command followed by the chassisEnable...

Page 46: ... ports When used with the recover onLrOnly option the recovery mechanism takes the following escalating actions When it detects credit loss it performs a link reset and logs a RASlog message RAS Cx 1014 If the link reset fails to recover the port the port reinitializes A RASlog message is generated RAS Cx 1015 Note that the port reinitialization does not fault the blade If the port fails to reinit...

Page 47: ...set mode or link reset threshold mode is configured EXAMPLES Add the following text to the example section backend port credit recovery examples To enable backend port credit recovery with the link reset only option and to display the configuration switch admin bottleneckmon cfgcredittools intport recover onLrOnly switch admin bottleneckmon showcredittools Internal port credit recovery is Enabled ...

Page 48: ...d triggers an SNMP and a RASlog alert when the ports on the configured switch experience a bottleneck Another alert is sent after the condition resolves You can configure alerts for latency for congestion or both Modify the description of the alert configuration in the operand section as follows alert Enables alerts when configured thresholds are exceeded on the ports that are enabled for bottlene...

Page 49: ... configuration on the logical switch to allow both congestion and latency alerts switch admin bottleneckmon config alert To change the bottleneck detection configuration on the logical switch to disable all alerts switch admin bottleneckmon config noalert To change the bottleneck detection configuration on port 5 to allow congestion alerts only overrides switch wide configuration switch admin bott...

Page 50: ...complete loss of credit on a Condor2 backend port causes frame timeouts a link reset will be performed on that port regardless of the configured setting even if that setting is recover off When used with the recover onLrOnly option the recovery mechanism takes the following escalating actions When it detects credit loss it performs a link reset and logs a RASlog message RAS Cx 1014 If the link res...

Page 51: ...dit recovery onLrOnly Enables the backend port recovery feature in link reset mode onLrThresh Enables the backend port recovery feature in link reset threshold mode off Disables the backend port credit recovery feature cfgcredittools intport check Performs the on demand detection of credit loss on a given backend port and VC This operand is optional and exclusive when you specify this option you c...

Page 52: ...ade FC8 16 and to control tuning optimization of backend links for all Brocade FC8 xx blades When used with the autoset autodisable autoreset and autoshow options this command configures tuning optimization for backend SerDes errors SerDes tuning optimization is indicated when you receive RASLog errors of type C2 5825 indicating a CRC error with a good EOF Brocade highly recommends that you contac...

Page 53: ...on To disable SerDes tuning optimization on all backend ports and retain all current tuning values switch admin serdestunemode autodisable Autotunemode is turned off switch admin serdestunemode show Autotunemode is turned off To disable SerDes tuning optimization on all backend ports and reset all tuning values to their default values switch admin serdestunemode autoreset AutoTune Resetting Defaul...

Page 54: ...42 Fabric OS Documentation Updates 53 1002063 09 serDesTuneMode 5 ...

Page 55: ...NOTE The updates are arranged by the chapter names as they appear in the original document Chapter 12 CDR System Messages Include the following messages in the chapter CDR System Messages on page 88 CDR 1007 Message timestamp CDR 1007 sequence number WARNING system name S slot number C chip index Internal link errors have been reported no hardware faults identified continuing to monitor for errors...

Page 56: ...Message timestamp CDR 1010 sequence number CRITICAL system name S slot number C chip index Internal monitoring of faults has identified suspect hardware blade may need to be reset or replaced fault1 fault1_cnt fault2 fault2_cnt thresh2 0x threshold_used Probable Cause Indicates above normal errors observed in hardware that may or may not impact data traffic Recommended Action Whenever this error i...

Page 57: ...the dummy DEK to the KV Keyvault IP Address failed Dummy DEK Dummy Key Id KeyCount Key Count Error code Error code string Error string Probable Cause Indicates that putting the Dummy failed to keyvault Recommended Action No action is required Severity ERROR KAC 1012 Message timestamp KAC 1012 sequence number ERROR system name Getting the dummy from the KV Keyvault IP Address failed Dummy DEK Dummy...

Page 58: ... 1015 sequence number ERROR system name KAC Key Vault Type communication Error Error connecting to Key Vault IP Error code Error code string Error string Probable Cause Indicates that key archival client is unable to communicate with the primary or backup key vault Recommended Action Change the switch key vault settings and or ensure that the configured key vault is operational Severity ERROR KAC ...

Page 59: ...able 14 SW MIB Traps SNMP trap counters The following SNMP information will be added in the next release of Fabric Watch When a counter is in the in between state Fabric Watch sends an informational SNMP trap See In between buffer values on page 48 for an explanation of the concepts of in between boundaries and high and low thresholds When a counter is above the high threshold or below the low thr...

Page 60: ...example the high threshold value is 5 and the buffer value is 1 Therefore the in between boundary value is 4 Enter the portThConfig command using the following parameters portthconfig set port area crc highth value 4 trigger below action raslog Above high threshold Above action 5 _______________________________________________________________________________ BUFFER 1 ______________________________...

Page 61: ...r Fabric OS v6 4 0 and v6 4 1 49 Documentation updates for Fabric OS v6 4 0 and v6 4 1 The following appendix is added to the Fibre Channel over IP Administrator s Guide Appendix A Fibre Channel Fast Write FCFW In this appendix FC Fast Write FCFW concepts 50 Configuring and enabling FCFW 52 Disabling FCFW 53 Disabling FCFW flows without removing FCFW 54 NOTE Fibre Channel Fast Write is currently o...

Page 62: ...is feature NOTE FCFW and FCIP tunnels cannot be used together on the same 7500 or FR4 18i blade Constraints for FCFW Consider the following constraints when configuring FCFW FCFW disables the local Ethernet ports ge0 and ge1 making it impossible to configure FCFW and FCIP tunnels on the same 7500 or FR4 18i blade FCFW does not work in FICON environments FCFW flows may be routed to another 7500 or ...

Page 63: ...re times a target device sends a Transfer Ready the greater the performance gain The number of outstanding I Os both Write and Read link speed and link congestion FCFW may not result in significant improvement if these factors suggest that the write data is delayed because it is sharing bandwidth Target response latency If the target is slow in responding to the write command the data must be held...

Page 64: ...one configuration to filter FCFW flows FCFW flows are configured by creating a zone name with an fcacc token as a prefix For LSAN configuration use lsan_fcacc as a prefix as shown in the following example 2 Ensure that FCFW is enabled on the switch or blade using the fastwritecfg show command If Fastwrite is not enabled enable FCFW using the fastwritecfg command The following example enables FCFW ...

Page 65: ...re plugged into the ports you disabled in step 1 rack1_6a1 root portshow 3 3 portName portHealth HEALTHY Authentication None portDisableReason None portCFlags 0x1 portFlags 0x20b03 PRESENT ACTIVE F_PORT G_PORT U_PORT LOGICAL_ONLINE LOGIN NOELP ACCEPT portType 10 0 portState 1 Online portPhys 6 In_Sync portScn 32 F_Port port generation number 0 portId 022300 portIfId 43320004 portWwn 20 23 00 60 69...

Page 66: ...nning Fabric OS version 6 2 0f or a later version you can disable FCFW flows on a single host without removing FCFW on the port 1 Verify you are using Fabric OS version 6 2 0f or a later version using the firmwareshow command 2 Disable the port on which you want to disable FCFW using the portdisable command 3 Enable a non FCFW zoning configuration to remove and replace the fcacc zone 4 Enable the ...

Page 67: ...being faulted row with the following information Before the subheading Removing the WWN card and WWN bezel logo plate on page 74 add the following section Preparing for the WWN card replacement If the WWN card requires replacement complete the following steps ATTENTION Follow ESD precautions see ESD Precautions in your chassis manual 1 Open a Telnet session to the chassis and log in to the active ...

Page 68: ...el and faulted WWN card ATTENTION Follow ESD precautions see ESD Precautions in your chassis manual 1 Open a Telnet session to the chassis and log in to the active CP as admin The default password is password 2 Verify that you are logged into the active CP Run the haShow command to determine the active CP 3 Run the supportsave command on the active CP to capture all settings If any problems occur ...

Page 69: ... is being faulted row with the following information Before the subheading Removing the WWN card and WWN bezel logo plate on page 69 add the following section Preparing for the WWN card replacement If the WWN card requires replacement complete the following steps ATTENTION Follow ESD precautions see ESD Precautions in your chassis manual 1 Open a Telnet session to the chassis and log in to the act...

Page 70: ...and faulted WWN card ATTENTION Follow ESD precautions see ESD Precautions in your chassis manual 1 Open a Telnet session to the chassis and log in to the active CP as admin The default password is password 2 Verify that you are logged into the active CP Run the haShow command to determine the active CP 3 Run the supportsave command on the active CP to capture all settings If any problems occur dur...

Reviews: