COMMAND REFERENCE Brocade Fabric OS Command Reference, 8.0.1 Supporting Fabric OS 8.0.
Copyright © 2016, Brocade Communications Systems, Inc. All Rights Reserved. Brocade, Brocade Assurance, the B-wing symbol, ClearLink, DCX, Fabric OS, HyperEdge, ICX, MLX, MyBrocade, OpenScript, VCS, VDX, Vplane, and Vyatta are registered trademarks, and Fabric Vision is a trademark of Brocade Communications Systems, Inc., in the United States and/or in other countries. Other brands, products, or service names mentioned may be trademarks of others.
Contents Preface Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xv Text formatting conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xv Command syntax conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
aptPolicy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 auditCfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 auditDump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 authUtil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
configList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 configRemove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 configShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 configUpload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
fabricName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221 fabricPrincipal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223 fabricShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 fabStatsShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
fdmiShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305 femDump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308 ficonCfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310 ficonClear. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
historyMode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406 historyShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407 i. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409 iflShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
motd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540 msCapabilityShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541 msConfigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542 msPlatShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
portCfgCreditRecovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658 portCfgDefault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659 portCfgDPort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 660 portCfgEncrypt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
portDPortTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 767 portEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776 portEncCompShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 778 portErrShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
portZoneShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 922 powerOffListSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 923 powerOffListShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 925 psShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
sfpShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1002 shellFlowControlDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1013 shellFlowControlEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1014 slotPowerOff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1015 slotPowerOn. . . . .
trunkDebug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1114 trunkShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1115 tsClockServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1119 tsTimeZone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Preface • • • • Document conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv Brocade resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi Contacting Brocade Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Brocade resources {x|y|z} A choice of required parameters is enclosed in curly brackets separated by vertical bars. You must select one of the options. In Fibre Channel products, square brackets may be used instead for this purpose. x|y A vertical bar separates mutually exclusive elements. <> Nonprinting characters, for example, passwords, are enclosed in angle brackets. ... Repeat the previous element, for example, member[member...]. \ Indicates a “soft” line break in command examples.
Document feedback Brocade customers For product support information and the latest information on contacting the Technical Assistance Center, go to http://www.brocade.com/services-support/index.html. If you have purchased Brocade product support directly from Brocade, use one of the following methods to contact the Brocade Technical Assistance Center 24x7. Online Telephone E-mail Preferred method of contact for nonurgent Required for Sev 1-Critical and Sev support@brocade.
Document feedback xviii Brocade Fabric OS Command Reference 53-1004112-02
About this Document • • • Supported hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix What is new in this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx CLI usage conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
What is new in this document Brocade Gen 6 platform (32-Gbps) fixed-port switches • Brocade G620 Brocade Gen 6 platform (32-Gbps) Directors • • Brocade X6-4 Director Brocade X6-8 Director What is new in this document The Virtual Fabric restrictions for Fabric OS commands table in the “Command Availability” has been updated. The table lists the Context, Switch type, and Remote Domain Execution for the commands.
What is new in this document • • extnCfg - Added the --config -default and --config -clear operands. • • • • • • • • faPwwn - Added a note that the ports must be disabled before executing the --enable and --assign options. fanDisable - Added note that the fan units on a Brocade X6 Director do not change their RPM speed to 0 and they take few minutes to change the speed to minimum RPM after being disabled. fcipLedTest - Added the behavior of this command on the Brocade SX6 extension blade.
What is new in this document xxii • portCfgEportCredits - Modified the description of the credits option. Modified the description to state that E_Port credits are mutually exclusive with Buffer Optimized mode. ICL ports are supported with this command. Added valid credit range for ICL ports. • • • • portCfgGE - Added details for Brocade SX6 blade and removed Brocade 7800. • portCfgSpeed - Added 32 Gbps fixed speed.
What is new in this document • switchShow - Added the following disabled reasons: Disabled (EX_Port IR POD License Limit Exceeded), Disabled (License not Installed for Integrated Routing), and Disabled (Incompatible AMP Version). Added ‘ESC mismatch, AMP Version Conflict’ and ‘Incompatible AMP Version’ segmentation reasons. • • • traceDump - Added the ‘Reboot’ tracedump type. turboRamTest - Removed the ceeturboramtest command. userConfig - Added -at | -access option.
CLI usage conventions • switchName - Added a note in the description of the name field that the switchname which begins with numeric character should have atleast one alphabet. Switchname with all numeric character is not valid. Example switchname 12345678 is invalid. • zone - Removed all references of Admin Domain. CLI usage conventions xxiv • Some Fabric OS show commands display certain switch or fabric components in three-digit decimal numbers, for example, 003.
Using Fabric OS Commands • • • • Using the command line interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Understanding Role-Based Access Control. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Understanding Virtual Fabric restrictions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Understanding Role-Based Access Control TABLE 1 Role definitions (Continued) Role name Definition FabricAdmin Administrative use excluding user management management. BasicSwitchAdmi n A subset of administrative tasks, typically of a more limited scope and effect. Admin All administrative tasks, including encryption and chassis commands. SecurityAdmin Administrative use including admin, encryption, security, user management, and zoning. In addition to these predefined roles, Fabric OS v7.0.
Understanding Virtual Fabric restrictions Understanding Virtual Fabric restrictions All Fabric OS commands are subject to additional RBAC enforcement with regard to Virtual Fabric contexts and switch types. Commands can be executed in one or more of the contexts described in Table 2. Execution of chassis commands requires chassis permissions. TABLE 2 Virtual Fabric contexts Context type Definition Switch context Command applies to the current logical switch only, or to a specified logical switch.
Determining RBAC permissions for a specific command The following example shows how you can obtain permission information for the zone command. Suppose you want to know if a user with the SwitchAdmin role can create a zone. You issue the classconfig --showcli command for the zone command, which shows that the zone --add command belongs to the RBAC class “zoning”. You then issue the classconfig --showroles command for the zoning RBAC class.
Fabric OS Commands aaaConfig Manages RADIUS, LDAP, and TACACS+ configuration information.
aaaConfig Notes Customers can use centralized RADIUS servers to manage AAA services for a switch, as defined in the RFC 2865 RADIUS specification. This command can be executed when logged in through the console, Telnet or SSH connection. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
aaaConfig -s secret Specifies a common secret between the switch and the RADIUS or TACACS+ server. The secret must be 8 to 40 characters for RADIUS server, and 1 to 40 characters for TACACS+ server. This option is valid only with -conf radius or -conf tacacs+options, and it is optional. The default value is sharedsecret. -a Specifies the remote authentication protocol for the RADIUS or TACACS+ server. This operand is valid with -conf radius or -conf tacacs+ options, and it is optional.
aaaConfig --move server option Moves the specified server from the current position in a RADIUS, LDAP, or TACACS+ configuration list to the specified position. If the specified position is the same as the current position, no change takes place. Valid options include the following: -conf radius | ldap | tacacs+ Specifies the server configuration as RADIUS, LDAP, or TACACS+. This operand is required. to_position Specifies the new position for the server.
aaaConfig "tacacs+;local" Enables the current TACACS+ configuration as the primary AAA service and the switch-local database as the secondary AAA service. If "tacacs+" and "local" are specified, and if the AD servers are reachable and the user credentials are correct, the user authentication succeeds. If the user provides credentials from the switch database, AD authentication fails but login would still succeed through the switch database.
aaaConfig 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 To replace the AAA service with backup option: switch:admin> aaaconfig --authspec "ldap;local" -backup To change the authentication mechanism with the no logout provision: switch:admin> aaaconfig --authspec radius -nologout switch:admin> aaaconfig --show RADIUS CONFIGURATIONS ===================== Position : Server : Port : Timeout(s) : Auth-Protocol: 1 172.20.1.
aaaConfig Timeout(s) : 5 Auth-Protocol: PAP Primary AAA Service: TACACS+ Secondary AAA Service: None SEE ALSO None Brocade Fabric OS Command Reference 53-1004112-02 11
ad ad Manages Admin Domain operations.
ad The Admin Domain transaction buffer is linked to the current login shell and is lost on logout. Use the --transshow option to display the current Admin Domain transaction information. Before creating Admin Domains, the default zone 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.
ad --clear [-f] Deletes all ADs and clears AD0's explicit members. This command fails if AD1 through AD254's zone databases are not empty. The command prompts for confirmation before deleting all Admin Domains. The clear operation remains in the transaction buffer until you issue ad --apply or ad --save. When used with the -f option, this command deletes all ADs and clears all explicit members from AD0, even if the zone databases or AD1 through AD254 are not empty.
ad --save Saves the outstanding Admin Domain transaction to 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. --select arg Selects an Admin Domain context. This command fails if the corresponding Admin Domain is not activated. This operation succeeds only if you have the specified Admin Domain.
ad name An Admin Domain name can be up to 63 bytes, must begin with a letter, and can consist of letters, numbers, and underscore characters. The Admin Domain names with the format AD[0-255] are reserved for autoassigning Admin Domain names to Admin Domains created with an Admin Domain number. and can be assigned only to the corresponding Admin Domain. Using ad --rename, for example, in an attempt to assign a name of AD5 to an Admin Domain with ID not equal to 5 fails.
ad "command_list" Specifies one or more commands to execute in an Admin Domain context. This operand is valid only with the --exec option. new_ad_id Specifies a new Admin Domain name or number. This operand is valid only with the --rename option. Format is the same as ad_id. -i Displays the implicit members of AD0. This operand is valid only with the --show option. -m mode Specifies the mode in which Admin Domain configuration information is displayed. This operand is valid only with --show and --validate.
ad To clear all Admin Domain definitions: switch:admin> ad --clear You are about to delete all ADs definitions. This operation will fail if zone configurations \ exists in AD1-AD254 Do you want to clear all admin domains \ (yes, y, no, n): [no] y To create an Admin Domain with a mix of D,PI, WWNs, and zone alias device members (two different methods shown): switch admin> ad --create "AD1", \ -d "100,5; 1,3; 20:00:00:e0:8b:05:4d:05" switch admin> ad --create 1, \ -d "100,5; 1,3; 21:00:00:e0:8b:05:4d:05" T
ad To rename a user-assigned Admin Domain name to a reserved Admin Domain name (this operation fails if AD_test's AD number is not 200): switch:admin> ad--rename AD_test AD200 To remove the devices 100,5 and 1,3 from AD1: switch:admin> ad --remove "AD1", \ -d "100,5; 1,3; 21:00:00:e0:8b:05:4d:05" To remove the switch 100 from AD1: switch:admin> ad --remove "AD1", -s "100" To save any outstanding Admin Domain definition-related transaction buffer switch:admin> ad --save You are about to save the outstand
ad Switch port members: Switch WWN members: 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 AD1 configuration information in the transaction buffer: switch:admin> ad --show 1 -m 0 Current AD: 255 : AD255 Transaction buffer configuration: --------------------------------no configuration To display the AD10 configuration information in persistent storage: switch:admin> ad --show 10 -m 1 Current AD: 255
ad Defined configuration: ---------------------AD Number: 1 AD Name: AD1 Device WWN members: State: Inactive 10:00:00:00:00:01:00:00; 10:00:00:00:00:04:00:00; 10:00:00:00:00:05:00:00; 10:00:00:00:00:06:00:00; 10:00:00:00:00:08:00:00; 10:00:00:00:00:03:00:00; 10:00:00:00:00:02:00:00; 10:00:00:00:00:07:00:00; 10:00:00:00:00:15:00:00; 10:00:00:00:00:16:00:00; 10:00:00:00:00:17:00:00; 10:00:00:00:00:18:00:00; 10:00:00:00:00:11:00:00; 10:00:00:00:00:12:00:00; 10:00:00:00:00:13:00:00; 10:00:00:00:00:14:00:00
ag ag Enables Access Gateway (AG) and manages AG-specific operations. Synopsis ag --help ag --show ag --modeshow | --modeenable | --modedisable ag [--policyenable | --policydisable] policy ag --policyshow ag --mapshow [N_Port] ag [--mapset | --mapadd | --mapdel] N_Port [F_Port1; F_Port2;...] ag [--staticadd | --staticdel ] N_Port [F_Port1; F_Port2;...] ag --pgshow [pgid] ag --pgcreate pgid "N_Port1 [;N_Port2;...]" [-n pgname] [-m "lb; mfnm"] ag [--pgadd | --pgdel] pgid "N_Port1 [; N_Port2;...
ag ag --printalpamap F_Port ag --deletepwwnfromdb PWWN ag --clearalpamap F_Port ag --addwwnmapping N_Port "WWN [;WWN2;...]" | --all ag --delwwnmapping N_Port "WWN [;WWN2;...]" | --all ag --addwwnpgmapping Port_Group "WWN [;WWN2;...]" | --all ag --delwwnpgmapping Port_Group "WWN [;WWN2;...]" | --all ag --addwwnfailovermapping N_Port "WWN [;WWN2;...]" | --all ag --delwwnfailovermapping N_Port "WWN [;WWN2;...]" | --all ag --wwnmappingenable "WWN [;WWN2;...]" | --all ag --wwnmappingdisable "WWN [;WWN2;...
ag Description Use this command to perform the following Access Gateway management functions: • • • • • • • • • • • • • • • • • • • • • Enable or disable Access Gateway mode. • • Delete the backup mappings for the given N_Port, if any. Display current configuration and state of AG. Configure and display F_Port to N_Port mapping. Configure and display N_Port failover and failback policies. Configure and display Port Group policy. Create or remove a Port group.
ag Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. AG is supported only on selected Brocade hardware platforms. Refer to the Access Gateway Administrator's Guide for hardware support and AG configuration procedures. In non-AG mode, only two actions are available: --modeenable and --modeshow.
ag • • • • Port Grouping (pg) policy: This policy manages failover of an F_Port to a set of related N_Ports in a port group. Auto Port Configuration (auto): When this policy is enabled, the AG enabled switch automatically detects available ports and maps F_Ports to N_Ports. Auto port configuration is disabled by default. Advanced Device Security (ADS) policy. This policy restricts access to the fabric at the AG level to a set of authorized devices.
ag wwnloadbalance Disables the device WWN load balancing policy. --mapshow [N_Port | device_WWN] Displays the F_Ports that are configured and currently mapped to a given "primary" N_Port. Optionally specify an N_Port to display the F_Ports that are mapped to the specified N_Port only, or specify a device WWN to display the N_Port to which the device WWN is mapped. Failover and failback policies are displayed as enabled (1) or disabled (0). --mapset N_Port [F_Port1;F_Port2;...
ag --pgdel pgid "N_Port1 [; N_Port2;...]" Deletes one or more N_Ports from the specified port group. Deleted ports are added to the default port group "pg0". The port list must be enclosed in quotation marks. Ports must be separated by semicolons. --pgrename pgid newname Replaces the name of an existing port group with the specified new name. The port group ID must not exceed 64 characters. --pgremove pgid Deletes the specified port group.
ag --pgdelmodes pgid "lb;mfnm" Disables the specified modes on a given port group. The mode list must be enclosed in double quotation marks and the modes must be separated by a semicolon. For a description of supported modes, refer to --pgsetmodes. --pgfnmtov new_tov Displays the fabric name monitoring timeout value in seconds when used without specifying a new value. To change the current value, specify a new timeout value in seconds. The valid range is 30 to 120 seconds. The default value is 120 seconds.
ag --prefset "F_Port [;F_Port2;...]" N_Port Sets the preferred secondary N_Port for one or more F_Ports. Preferred mapping is optional. Preferred F_Port to N_Port Mapping provides an alternate N_Port for F_Ports to come online for predictable failover and failback. An F_Port must have primary N_Port mapping before a secondary N_Port can be configured. The list of F_Ports to be mapped must be enclosed in double quotation marks. Port numbers must be separated by semicolons. --prefdel "F_Port [;F_Port2;...
ag mode Specifies the manner in which the ALPA is obtained in the event that the ALPA value is already taken by another host. Valid modes include the following: -s Specifies a stringent ALPA request mode. In stringent mode, the login is rejected if the ALPA is not available. -f Specifies a flexible ALPA request mode. In flexible mode, the host login is accepted either with the requested ALPA value or with a different ALPA value if the requested ALPA is not available.
ag --delwwnpgmapping PG "WWN [;WWN2;...]" | --all Removes the mapping between the specified device WWNs and the specified port group. The port group is identified by its port group ID. The --all option removes the mapping of all device WWNs currently mapped to the specified port group. The WWN list must be enclosed in double quotation marks. WWNs must be separated by semicolons. The mappings are removed upon execution of this command. --addwwnfailovermapping N_Port "WWN [;WWN2;...
ag The port becomes reliable again if it does not receive any SCN messages for a period of five minutes. Preferred N_Port settings are not enforced on unreliable N_Ports. When the port becomes reliable again, the behavior is as follows: • • • If a FAILBACK flag is set, the port will fail back the configured F_Ports. Configured F_Ports that are offline will come back online. If LB mode or auto policy is configured, load rebalancing resumes.
ag 3 8 9 10 11 0x010100 0x010d00 0x010c00 0x010e00 0x010f00 50:00:51:ed:6f:8e:60:28 20:0d:00:05:1e:d6:f8:c9 20:0c:00:05:1e:d6:f8:c9 20:0e:00:05:1e:d6:f8:c9 20:0f:00:05:1e:d6:f8:c9 Spirit\ Spirit\ Spirit\ Spirit\ Spirit\ Switch FO FB IP_Addr F_Ports ----------------------------------------0 1 1 10.17.31.170 4;5;23; 0 1 1 10.17.31.170 None 0 1 1 10.17.31.170 None 0 1 1 10.17.31.170 None 13 1 1 10.17.31.170 6; 12 1 1 10.17.31.170 7; 14 1 1 10.17.31.170 None 15 1 1 10.17.31.
ag AG group policy commands To show current policies: switch:admin> ag --policyshow AG Policy Policy Name State ----------------------------------------------------Port Grouping pg Enabled Auto Port Configuration auto Disabled Advanced Device Security ads Disabled WWN Based Load Balancing wwnloadbalance Disabled ----------------------------------------------------- To enable a port grouping policy: switch:admin> ag --policyenable pg To disable a port grouping policy switch:admin> ag --policydisable pg T
ag AG port mapping commands To display current port mappings and port grouping policies: switch:admin> ag --mapshow N_Port Configured Static Current Failover Failback PG_ID PG_Name _F_Ports _F_Ports _F_Ports ----------------------------------------------------------------0 4;5;6 None 4;5;6 1 0 2 SecondFabric 1 7;8;9 None 7;8;9 0 1 0 pg0 2 10;11 None 10;11 1 0 2 SecondFabric 3 12;13 None 12;13 0 1 0 pg0 ------------------------------------------------------------------ Explanation of fields in --mapshow ou
ag To delete F_Port 5 that was mapped to N_Port 2: switch:admin> ag --mapdel 2 "5" Preferred N_port is set for F_Port[s] Please delete it before removing primary N_Port ERROR:Unable to remove F_Port[s] from mapping, retry the command switch:admin> ag --prefshow F_Ports Preferred N_Port ----------------------------------------------10;11 0 4;5;6 2 7;8;9 3 ---------------------------------------------switch:admin> ag --prefdel 5 2 Preferred N_Port is deleted successfully \ for the F_Port[s] switch:admin> ag
ag 17 2 2 0 0 N/A N/A --------------------------------------------------Static N-Port to F-Port Mapping N-Port F-Port -----------------------------------------17 1 ------------------------------------------ AG failover policy commands To display failover policy settings for all N_Ports: switch:admin> ag --failovershow N_Port failover_bit --------------------------0 1 1 0 2 1 3 0 To set and display failover and failback policies on a single port: switch:admin> ag --failoverenable 1 Failover policy is ena
ag switch:admin> ag --failbackenable 3 Failback on N_Port 3 is not supported switch:admin> ag --failbackenable 2 Failback on N_Port 2 is supported Port Group commands To display Port Group information: switch:admin> ag --pgshow PG_ID PG_Name PG_Mode N_Ports F_Ports ----------------------------------------------0 pg0 lb,mfnm 1;3 10;11 2 SecondFabric 0;2 4;5;6 ----------------------------------------------- To create a port group "FirstFabric" that includes N_Ports 1 and 3 and has login balancing enabled:
ag To enable managed fabric name monitoring in port group 3: switch:admin> ag --pgsetmodes 3 "mfnm" Managed Fabric Name Monitoring mode has been \ enabled for Port Group 3 switch:admin> ag --pgshow PG_ID PG_Name PG_Mode N_Ports F_Ports ----------------------------------------------0 pg0 lb,mfnm 0;2 4;5;6 3 FirstFabric lb,mfnm 1;3 10;11 ----------------------------------------------- To disable managed fabric name monitoring in port group 3: switch:admin> ag --pgdelmodes 3 "mfnm" Managed Fabric Name Monito
ag ADS Policy commands To set the list of allowed devices for Ports 11 and 12 to 'no access': switch:admin> ag --adsset "11;12" "" WWN list set successfully as the Allow Lists of \ the F_Port[s] To set the list of allowed devices for Ports 1, 10 and 13 to 'all access': switch:admin> ag --adsset "1;10;13" "*" WWN list set successfully as the Allow Lists of \ the F_Port[s] To remove two devices from the lists of allowed devices for ports 1 and 9: switch:admin> ag --adsdel "3;9" \ "22:03:08:00:88:35:a0:12;2
ag To disable persistent ALPA mode: switch:admin> ag --persistentalpaenable 0 Persistent ALPA mode is enabled To display the ALPA database entries for F_Port 5: switch:admin> ag --printalpamap 5 Hash table for Port 5 data PWWN ALPA ============================================ 20:12:00:05:1e:85:92:88 1 20:07:00:05:1e:01:0b:4a 3 To attempt to remove a device entry from the database while the device is online and cannot be removed: switch:admin> ag --deletepwwnfromdb \ 0:12:00:05:1e:85:92:88 20:08:00:05:1e:
ag To create a WWN to port group mapping for all currently mapped devices (this command does not affect devices not already mapped or connecting later).
ag Backup mapping commands To save the configured, static, and preferred mapping of an N_Port: switch:admin> ag --backupmappingsave 43 Configured,static and preferred mappings have been saved \ for the N_port successfully.
agAutoMapBalance agAutoMapBalance Controls automatic remapping of F_Ports in AG mode. Synopsis agautomapbalance --enable [-fport | -nport] [-pg Port_Group_Number | -all] agautomapbalance --disable [-fport | -nport] [-pg Port_Group_Number | -all] agautomapbalance --force agautomapbalance --show agautomapbalance --help Description Use this command to control the automatic rebalancing of F_Ports for login distribution in the event that an F_Port goes offline or an N_Port comes online.
agAutoMapBalance -fport Enables automatic login redistribution in the event that one or more F_Ports go offline. When automatic login redistribution is enabled, the remaining F_Ports are remapped such that logins are balanced among the existing Imports. -nport Enables automatic login redistribution in the event that one or more N_Ports come online. When automatic login redistribution is enabled, the F_Ports mapped to the current N_Ports are rebalanced among the N_Ports.
agAutoMapBalance To display the automatic login redistribution settings for N_Ports and F_Ports.
agShow agShow Displays the Access Gateway information registered with the fabric. Synopsis agshow agshow --name ag_name agshow --local Description This command displays the details of the F_Ports and the configured N_Ports in the Access Gateway attached to the fabric. The command output displays the following information. Name The name of the Access Gateway. NodeName The World Wide Name of the Access Gateway node. Ports The number of ports in the Access Gateway.
agShow Notes NPIV capability should be enabled on the ports connected to the Access Gateway. NPIV capability is enabled by default. Use portCfgNPIVPort to enable NPIV capability a port if it was previously disabled. Note that enabling or disabling NPIV capability is no longer supported in Access Gateway mode. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
agShow Local/Remote Name ---------------------------------local L5D_B10_4016_1 local L5D_B14_4024_1 local L5D_B13_200_AG SEE ALSO 50 portCfgNPIVPort Brocade Fabric OS Command Reference 53-1004112-02
aliAdd aliAdd Adds a member to a zone alias. Synopsis Description aliadd "aliName","member[; member...]" Use this command to add one or more members to an existing zone alias. The alias member list cannot contain another zone alias. This command changes the defined configuration. For the change to become effective, enable the zone configuration with the cfgEnable command. For the change to be preserved across switch reboots, save the zone configuration to nonvolatile memory with the cfgSave command.
aliCreate aliCreate Creates a zone alias. Synopsis Description alicreate "aliName","member[; member...]" Use this command to create a new zone alias. The zone alias member list must have at least one member (empty lists are not allowed). The alias member list cannot contain another zone alias. Refer to the zoneCreate command for more information on name and member specifications. This command changes the defined configuration.
aliDelete aliDelete Deletes a zone alias. Synopsis Description alidelete "aliName" Use this command to delete a zone alias. This command changes the defined configuration. For the change to become effective, enable the zone configuration with the cfgEnable command. For the 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 restrictions that may be in place.
aliRemove aliRemove Removes a member from a zone alias. Synopsis Description aliremove "aliName","member[; member...]" Use this command to remove one or more members from an existing zone alias. If all members are removed, the zone alias is deleted. This command changes the defined configuration. For the change to become effective, enable the zone configuration with the cfgEnable command.
aliShow aliShow Displays zone alias information. Synopsis alishow [--ic] ["pattern"][, mode] alishow --help Description Use this command to display zone configuration information. Use the pattern operand to display only matching zone alias names in the defined configuration. If no parameters are specified, all zone configuration information (both defined and effective) is displayed. Refer to cfgShow for a description of this display.
aliShow To display all zone alias names beginning with "arr", regardless of the case: switch:admin> alishow --ic "arr*" alias: array1 20:e0:00:05:33:11:1f:00 alias: ARRAY2 2f:11:00:05:33:c1:37:a2 SEE ALSO 56 aliAdd, aliCreate, aliDelete, aliRemove Brocade Fabric OS Command Reference 53-1004112-02
appLoginHistory appLoginHistory Displays the history of HTTP login sessions. Synopsis apploginhistory --show apploginhistory --help Description Use this command to display the history of HTTP login sessions from external management applications such as Brocade Network Advisor or Web Tools. The command displays both current sessions and a history of past sessions.
appLoginHistory active currently: 2011/10/13-15:51:31.203814, 2011/10/13-15:51:33.095638, 2011/10/13-15:52:14.178299, 2011/10/13-15:53:57.547672, SEE ALSO 58 10.20.10.160, 10.20.10.160, 10.20.10.161, 10.20.10.
aptPolicy aptPolicy Changes or displays the Advanced Performance Tuning (APT) policy. Synopsis Description aptpolicy [policy] Use this command to display and change the advanced performance tuning (APT) policies on a switch. Distributed path selection (DPS) is supported in logical fabrics. APT policy settings affecting the DPS behavior can be configured per logical switch, and settings apply to the partition for which they are set.
aptPolicy 2 Device Based Routing Policy. Device-based routing is supported in FICON environments, and in open environments only when FICON coexists. With this policy, the path chosen for an ingress frame is based on the following items: • • • The ingress port on which the frame was received. The FC address of the source fabric device (SID) for this frame. The FC address of the destination fabric device (DID) for this frame.
aptPolicy To change the current APT policy to the exchange-based routing policy: switch:admin> aptpolicy 3 Switch must be disabled in order to modify \ this configuration parameter. To disable the switch, \ use the "switchDisable" command. switch:admin> switchdisable switch:admin> aptpolicy 3 Policy updated successfully.
auditCfg auditCfg Modifies and displays the audit log filter configuration. Synopsis auditcfg --class audit_class auditcfg --enable | --disable auditcfg --severity severity_level auditcfg --show Description Notes Use this command to configure the audit logging and to display the audit log configuration.
auditCfg --show Displays the current configuration. This operand is optional. Examples To configure the audit log filter: switch:admin> auditcfg --class 2,3,8 Audit filter is configured. To enable audit logging: switch:admin> auditcfg --enable Audit filter is enabled. To display the configuration: switch:admin> auditcfg --show Audit filter is enabled.
auditDump auditDump Displays or clears the audit log. Synopsis auditdump -s | -show auditdump -c | -clear Description Use this command to display or clear the audit log on the switch. The audit log persistently saves the most recent 256 log entries on the switch. On modular platforms, the entries are not shared across CPs. Each CLI executed on a switch from non-root user account is saved as an audit log. To display or clear the logs, this command must be issued for each CP separately.
auditDump To clear the audit log: switch:admin> auditdump -c SEE ALSO auditCfg Brocade Fabric OS Command Reference 53-1004112-02 65
authUtil authUtil Displays and sets the authentication configuration. Synopsis authutil authutil --show authutil --set option value authutil --policy -sw option | -dev option authutil --authinit [slot/]port[, [slot/]port...] | allE Description Use this command to display and set local switch authentication parameters. Use --set to change authentication parameters such as protocol, Diffie-Hellman group (DH group), or hash type. When no protocol is set, the default setting of "FCAP, DH- CHAP" is used.
authUtil --set option value Modifies the authentication configuration. Valid options and their values include the following: -a fcap | dhchap | all Sets the authentication protocol. Specify "fcap" to set only FCAP authentication. Specify "dhchap" to set only DH-CHAP authentication. Specify "all" to set both FCAP and DH-CHAP, which is the default setting. When authentication is set to "all", the implicit order is FCAP followed by DH-CHAP.
authUtil on Sets the switch authentication policy to ON mode. Strict authentication is enforced on all E_Ports. The interswitch link (ISL) goes down (port disable), if the connecting switch does not support the authentication or the authentication policy is switched off. -dev off | passive | on Sets the device authentication policy. Three modes are supported. Device authentication policy is off by default. This option and suboptions are supported in AG mode. off Turns off the device authentication policy.
authUtil To enable sha1 hash type: switch:admin> authutil --set -h sha1 Hash is set to sha1. To enable all hash types: switch:admin> authutil --set -h all Hash is set to sha256,sha1,md5. To check the hash types set: switch:admin> authutil --show AUTH TYPE HASH TYPE GROUP TYPE -------------------------------------fcap,dhchap sha256,sha1,md5 1 Switch Authentication Policy: PASSIVE Device Authentication Policy: OFF To enable Sha256 hash type: sha256 hash type is recommended for FIPS configuration.
authUtil To set the Device policy to passive mode: switch:admin> authutil --policy -dev passive Warning: Activating the authentication policy requires DH-CHAP secrets on both switch and device. Otherwise, the F-port will be disabled during next F-port bring-up.
bannerSet bannerSet Sets the banner on the local switch. Synopsis Description bannerset [banner] Use this command to set the banner on the local switch. The banner is a string of alphanumeric characters. It is displayed after you log in to a switch. The banner can be created using the banner operand or interactively by entering the bannerSet command without an operand. If you enter the banner text using the interactive method, the valid length is 1022 characters.
bannerShow bannerShow Displays the banner text. Synopsis Description Notes bannershow Use this command to display the text of the local switch banner. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. Operands None Examples To display the banner for a switch: switch:admin> bannershow Banner: Do not disturb the setup on this switch.
bcastShow bcastShow Displays broadcast routing information. Synopsis Description bcastshow Use this command to display the broadcast routing information for all ports in the switch. The broadcast routing information indicates all ports that are members of the broadcast distribution tree: ports that are able to send and receive broadcast frames. Normally, all F_Ports and FL_Ports are members of the broadcast distribution tree.
bladeCfgGeMode bladeCfgGeMode Configures the operating mode of the Brocade FX8-24 blade to allow 1 GbE, 10 GbE, or both. Synopsis bladecfggemode --set mode -slot slot bladecfggemode --show -slot slot | -all bladecfggemode --help Description Notes Use this command to configure the GbE port mode on the Brocade FX8-24 extension blade or to display the configuration. The mode configuration controls which ports are enabled.
bladeCfgGeMode To display the GbE port mode for the Brocade FX8-24 blade in slot 4: switch:admin> bladecfggemode --show -slot 4 bladeCfgGeMode: Blade in slot 4 is configured in 10GigE Mode 10GigE mode: only xge0 and xge1 are enabled (ge0-9 ports \ are disabled) To display the GbE port mode for all configured slots: switch:admin> bladecfggemode --show -all bladeCfgGeMode: Blade in slot 1 is configured in 1GigE Mode 1GigE mode: only the ge0-9 ports are enabled (xge0 and xge1 \ are disabled) bladeCfgGeMode:
bladeDisable bladeDisable Disables all user ports on a blade. Synopsis Description bladedisable slot Use this command to disable all user ports on a blade. All Fibre Channel ports on the blade are taken offline. If the switch was connected to a fabric through this blade, the remaining switches reconfigure, and the switch reconfigures based on the other blade ports. As each port is disabled, the front panel LED changes to a slow-flashing amber.
bladeDisable Slot Blade Type ID Model Name Status ----------------------------------------------------5 COREBLADE 52 CORE8 ENABLED Index Slot Port Address Media Speed State Proto =================================================== 384 5 0 -----cu 8G In_Sync FC 385 5 1 -----cu 8G In_Sync FC 386 5 2 -----cu 8G In_Sync FC 387 5 3 -----cu 8G In_Sync FC 388 5 4 -----cu 8G In_Sync FC 389 5 5 -----cu 8G In_Sync FC 390 5 6 -----cu 8G In_Sync FC 391 5 7 -----cu 8G In_Sync FC 392 5 8 -----cu 8G In_Sync FC 393 5 9 --
bladeEnable bladeEnable Enables all user ports on a blade. Synopsis Description bladeenable slot Use this command to enable all user ports on a blade. All ports within the blade that did not fail the power-on self-test (POST) are enabled (except for persistently disabled ports). They may come online if connected to a device, or remain offline if disconnected. Use the bladeEnable command to re-enable the blade after making configuration changes or running offline diagnostics.
bladeEnable switch:admin> slotshow Slot Blade Type ID Status --------------------------------1 SW BLADE 2 ENABLED 2 UNKNOWN VACANT 3 UNKNOWN VACANT 4 SW BLADE 2 ENABLED 5 CP BLADE 1 ENABLED 6 CP BLADE 1 ENABLED 7 SW BLADE 2 ENABLED 8 UNKNOWN VACANT 9 UNKNOWN VACANT 10 UNKNOWN VACANT SEE ALSO bladeDisable, chassisDisable, chassisEnable, portEnable, portDisable, switchDisable, switchShow Brocade Fabric OS Command Reference 53-1004112-02 79
bladeSwap bladeSwap Swaps the area numbers for matching port pairs of two blades. Synopsis Description bladeSwap -src source_slot -dest destination_slot Use this command to swap the area numbers for matching port pairs of two blades. All ports must qualify for swapping for this command to succeed. It validates that the blades in the indicated slots are of the same type, have the same number of ports, and that the port pairs are in the same partition.
bootLunCfg bootLunCfg Transparently configures the boot LUN for an HBA. Synopsis bootluncfg --add HBA_WWN PWWN LUN_ID bootluncfg --delete HBA_WWN [PWWN LUN_ID] bootluncfg --show bootluncfg --help Description Use this command to configure the boot LUN for an HBA. Existing fabric-based boot LUN discovery allows the host's boot LUN information to be stored in the fabric zone database by using a zone name that contains the PWWN of an HBA port. The zone members consist of storage target PWWN and LUN ID.
bootLunCfg --help Displays the command usage. Examples To configure a boot LUN: switch:admin> bootluncfg --add 11:22:ab:44:44:ff:44:ca \ 1b:6c:55:55:55:3a:55:ff 9abc345fa1112410 Operation Successful To display existing Port/LUN mappings: switch:admin> bootluncfg --show 00:11:22:33:44:55:66:77 00:00:00:00:aa:bb:cc:dd;00:00:00:01:ee:ff:11:22; \ 00:00:00:02:9a:bc:34:5f;00:00:00:03:a1:11:24:10 aa:aa:aa:aa:aa:aa:aa:aa 00:00:00:00:11:11:11:11;00:00:00:01:11:11:11:11; \ 00:00:00:02:9a:bc:34:5f;00:00:00:03:a1:1
bufOpMode bufOpMode Changes or displays the Buffer Optimized Mode. Synopsis bufopmode --set slot [-force | -f] bufopmode --setall [-force | -f] bufopmode --reset slot bufopmode --resetall [-force | -f] bufopmode --show slot bufopmode --showall Description Use this command to display or change the buffer optimized mode on a switch. When buffer optimized mode is enabled on a slot, additional buffers are allocated on the internal ports.
bufOpMode Operands This command has the following operands: slot Specifies the slot number. --set [-force | -f] Enables buffer optimized mode on the specified slot. This commands prompts for confirmation before removing any F_Port buffers or long distance configurations on that slot. Use the -force or -f option to execute this command without confirmation. --setall [-force | -f] Enables buffer optimized mode on all slots.
bufOpMode Buffer optimized mode is turned off for slot 12 switch:admin> slotpoweron 11 switch:admin> slotpoweron 12 To display the changes: switch:admin> bufopmode --showall Slot 1: buffer optimized mode - Off Slot 2: buffer optimized mode - Off Slot 3: buffer optimized mode - Off Slot 4: buffer optimized mode - On Slot 9: buffer optimized mode - Off Slot 10: buffer optimized mode - Off Slot 11: buffer optimized mode - On Slot 12: buffer optimized mode - Off -----------------------------------------------
bufOpMode To clear buffer optimized mode on all slots: switch:admin> bufopmode --resetall Buffer optimized mode is turned Buffer optimized mode is turned Buffer optimized mode is turned Buffer optimized mode is turned off off off off for for for for slot slot slot slot 5 8 10 12 WARNING: Must reboot switch for changes to take effect.
cfgActvShow cfgActvShow Displays effective zone configuration information. Synopsis Description cfgactvshow Use this command to display the effective zone configuration information. The current configuration is a single zone configuration that is currently in effect. The devices that an initiator sees are based on this configuration. The effective configuration is built when a specified zone configuration is enabled.
cfgAdd cfgAdd Adds a member to a zone configuration. Synopsis Description cfgadd "cfgName", "member[; member...]" Use this command to add one or more members to an existing zone configuration. This command changes the Defined Configuration. For the change to take effect, enable the configuration with the cfgEnable command. For the change to be preserved across switch reboots, save the configuration to nonvolatile memory with the cfgSave command.
cfgClear cfgClear Clears all zone configurations. Synopsis Description cfgclear Use this command to clear all zone information in the transaction buffer. All defined zone objects in the transaction buffer are deleted. If an attempt is made to commit the empty transaction buffer while a zone configuration is enabled, you are warned to first disable the enabled zone configuration or to provide a valid configuration with the same name.
cfgCreate cfgCreate Creates a zone configuration. Synopsis Description cfgcreate "cfgName", "member[;member...]" Use this command to create a new zone configuration. This command changes the Defined Configuration (see cfgShow). For the change to become effective, enable the configuration with the cfgEnable command. For the change to be preserved across switch reboots, save the configuration to nonvolatile memory with the cfgSave command.
cfgDelete cfgDelete Deletes a zone configuration. Synopsis Description cfgdelete "cfgName" Use this command to delete a zone configuration. This command changes the Defined Configuration (see cfgShow). For the change to become effective, enable the configuration with the cfgEnable command. For the change to be preserved across switch reboots, save the configuration to nonvolatile memory with the cfgSave command.
cfgDisable cfgDisable Disables a zone configuration. Synopsis Description cfgdisable Use this command to disable the current zone configuration. The fabric returns to non-zoning mode, a mode in which all devices can see each other. This command ends and commits the current zoning transaction buffer to both volatile and nonvolatile memory. If a transaction is open on a different switch in the fabric when this command is run, the transaction on the other switch is automatically aborted.
cfgEnable cfgEnable Enables a zone configuration. Synopsis Description cfgenable "cfgName" Use this command to enable a zone configuration. The command builds the specified zone configuration. It checks for undefined zone names, zone alias names, or other inconsistencies, by expanding zone aliases, removing duplicate entries, and then installing the effective configuration.
cfgEnable command to display a list of domains with open transactions switch:admin> cfgtransabort 271010736 switch:admin> cfgenable "USA_cfg" You are about to enable a new zoning configuration. This action will replace the old zoning configuration with the current configuration selected.
cfgRemove cfgRemove Removes a member from a zone configuration. Synopsis Description cfgremove "cfgName","member[; member...]" Use this command to remove one or more members from an existing zone configuration. If all members are removed, the zone configuration is deleted. This command changes the Defined Configuration (see cfgShow). For the change to become effective, enable the configuration with the cfgEnable command.
cfgSave cfgSave Saves the zone configuration to nonvolatile memory. Synopsis Description cfgsave Use this command to save the current zone configuration. This command writes the defined configuration and the name of the effective configuration to nonvolatile memory in all switches in the fabric. The saved configuration is automatically reloaded at power on, and, if a configuration was in effect at the time it was saved, the same configuration is reinstalled with an automatic cfgEnable command.
cfgSave switch:admin> cfgtransabort 271010736 switch:admin> cfgsave You are about to save the Defined zoning configuration. This action will only save the changes on Defined configuration. If the update includes changes to one or more traffic isolation zones, you must issue the 'cfgenable' command for the changes to take effect.
cfgShow cfgShow Displays zone configuration information. Synopsis cfgshow [--ic] ["pattern"] [, mode] cfgshow [--transdiffs] cfgshow [--transdiffsonly] cfgshow --help Description Use this command to display zone configuration information. If no operand is specified, all zone configuration information (both defined and effective) is displayed. If the local switch has an outstanding transaction, this command displays the most recently edited zone configuration that has not yet been saved.
cfgShow "pattern" A regular expression that matches zone configuration names. The pattern must be enclosed in quotation marks and can contain the following: Question mark (?) Matches any single character Asterisk (*) Matches any string of characters. Range Matches any character within the range. Ranges must be enclosed in square brackets, for example, [0-9] or [a-f].
cfgShow zone: 21:00:00:20:37:0c:76:8c 21:00:00:20:37:0c:71:02 1,2 21:00:00:20:37:0c:76:22 21:00:00:20:37:0c:76:28 Red_zone 1,0 21:00:00:20:37:0c:76:85 21:00:00:20:37:0c:71:df To display only configuration names: switch:admin> cfgshow "*" cfg: USA1 Blue_zone cfg: USA_cfg Red_zone; Blue_zone To display changes in the current transaction: switch:admin> cfgshow --transdiffs Defined configuration: cfg: fabric_cfg Blue_zone zone: *zone: Blue_zone 1,1; array1; 1,2; array2 green_zone -1,1; 1,2; +6, 15 *zone:
cfgShow SEE ALSO *zone: green_zone 1,1; -1,2;+5,4;+ 21:00:00:20:37:0c:76:55 *zone: +red_zone 5,4; 5,6 cfgAdd, cfgClear, cfgCreate, cfgDelete, cfgDisable, cfgEnable, cfgRemove, cfgSave, cfgTransAbort, cfgTransShow Brocade Fabric OS Command Reference 53-1004112-02 101
cfgSize cfgSize Displays zone database size details. Synopsis Description cfgsize [integer] Use this command to display the size details of the zone database. The size details include maximum size, the committed size, and the transaction size of the Zone database in bytes. Zone DB maximum size Defines the upper limit for the Zone defined configuration, determined by the amount of nonvolatile memory available for storing the defined configuration.
cfgSize Examples To display the zone database on a Brocade 6510 switch:admin> cfgsize Zone DB max size - 1045274 bytes Available Zone DB size - 1041503 bytes committed - 2759 transaction - 0 SEE ALSO ad, cfgShow, zoneHelp Brocade Fabric OS Command Reference 53-1004112-02 103
cfgTransAbort cfgTransAbort Aborts the current zoning transaction. Synopsis Description cfgtransabort [token] Use this command to abort the current zoning transaction without committing it. All changes made since the transaction was started are removed and the zone configuration database is restored to the state before the transaction was started. If a transaction is open on a different switch in the fabric when this command is run, the transaction on the other switch remains open and unaffected.
cfgTransShow cfgTransShow Displays information about the current zoning transaction. Synopsis cfgtransshow cfgtransshow --opentrans cfgtransshow --help Description Use this command to display the ID of the current zoning transaction. In addition, the command provides information on whether or not the transaction can be aborted. The transaction cannot be aborted if it is an internal zoning transaction. Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place.
cfgTransShow To display the current transaction and the list of domains with open transactions: switch:admin> cfgtransshow --opentrans Current transaction token is 0x3109 It is abortable Transactions Detect: Capable Current Open Transactions Domain List: ------------------------1 2 3 4 SEE ALSO 106 cfgAdd, cfgClear, cfgCreate, cfgDelete, cfgDisable, cfgEnable, cfgRemove, cfgSave, cfgShow, cfgTransAbort Brocade Fabric OS Command Reference 53-1004112-02
chassisBeacon chassisBeacon Sets chassis beaconing mode. Synopsis Description chassisbeacon [mode] Use this command to enable or disable beaconing on a chassis. Chassis beaconing can be used to locate a failing chassis in a group of chassis. Use the portBeacon command to locate a failing port, and use the switchBeacon command to locate a failing (logical) switch. When beaconing mode is turned on, the port LEDs flash green at various rates across the chassis.
chassisBeacon Examples To turn chassis beaconing mode on: switch:admin> chassisbeacon 1 Chassis beacon success 1 To turn beaconing mode off: switch:admin> chassisbeacon 0 Chassis beacon success 0 To display the chassis beaconing mode: switch:admin> chassisbeacon Value = 0 SEE ALSO 108 portBeacon, switchShow, switchBeacon, portPeerBeacon Brocade Fabric OS Command Reference 53-1004112-02
chassisCfgPerrThreshold chassisCfgPerrThreshold Configures parity error threshold and fault capability on a blade or switch. Synopsis chassiscfgperrthreshold --enable [-threshold threshold_value] chassiscfgperrthreshold --disable chassiscfgperrthreshold --show chassiscfgperrthreshold --help Description Use this command to enable or disable the fault capability on a blade and switch based on the parity error threshold, to set the threshold value for parity errors, or to display the configuration.
chassisCfgPerrThreshold To display the configuration: switch:admin> chassiscfgperrthreshold --show Configured Threshold is 76 and the Fault is enabled.
chassisDisable chassisDisable Disables all user ports in a chassis. Synopsis Description chassisdisable [-force] 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 that are part of logical fabrics, the remaining switches in these fabrics reconfigure. As each port is disabled, the front panel LED changes to a slow-flashing amber.
chassisDistribute chassisDistribute Distributes IP filter policies. Synopsis chassisdistribute -db ipfilter -fid target_FID [-force] chassisdistribute -db ipfilter -domain target_domain_list [-force] Description Use this command to manually distribute the IP Filter policy database. The behavior of this command depends on whether Virtual Fabrics are enabled or disabled.
chassisDistribute Notes This command distributes the IP Filter database only. To distribute other security databases, use the distribute command. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. Operands This command has the following operands: -db ipfilter Specifies the policy database to be distributed with this command. The only accepted value for -db is ipfilter.
chassisDistribute 128 98 10:00:00:05:1e:41:22:9f Brocade6510 no ChassisDistribute will distribute the database(s) to \ above topology.
chassisEnable chassisEnable Enables all user ports in a chassis. Synopsis Description chassisenable Use this command to enable a 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.
chassisName chassisName Displays or sets the chassis name. Synopsis Description chassisname [name] Use this command to display or change the name associated with the chassis. The configured chassis name appears in all the chassis event RASLog messages. Use this command without parameters to display the current chassis name. Use this command with the name operand to assign a new chassis name. Notes Operands The execution of this command is subject to Virtual Fabric restrictions that may be in place.
chassisShow chassisShow Displays all field replaceable units (FRUs). Synopsis Description chassisshow Use this command to display the Field Replaceable Unit (FR) header content for each object in the chassis and chassis backplane version. This command displays the following information: 1. The chassis family, for example, DCX 8510. 2. The backplane version number, in hexadecimal: Chassis Backplane Revision: xx 3. The first line of each record contains the object ID.
chassisShow Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
classConfig classConfig Displays RBAC class permissions. Synopsis classconfig --show class_name | -all | -classlist classconfig --showcli command classconfig --showroles class_name classconfig --help Description Use this command to display information about role-based access control (RBAC) permissions for one or all meta-object format (MOF) classes, to display permissions for a specified command, or to display the permissions for a specified MOF class.
classConfig --showcli command Displays the RBAC permissions for the specified command and associated command options. The output displays the command name, the command options, the RBAC class permissions for each command option, the MOF class, and the context restriction for the command in VF mode only. If the length of a row is too long to fit in one line, the strings displayed under RBAC Class and Option column will be split and displayed in two lines.
classConfig 42. 43. 44. 45. 46. 47. 48. 49. 50. 51. 52. 53. 54. 55. 56. 57. 58. 59. 60. 61. 62. 63. 64. 65. 66. 67. 68.
classConfig To display the RBAC permissions for the UserManagement class: switch:admin> classconfig --showroles UserManagement Roles that have access to the RBAC class 'usermanagement' are: Role Name --------Admin Factory Root SecurityAdmin Permission ---------OM OM OM OM To display the RBAC permissions for a command: switch:admin> classconfig --showcli classconfig CLI Option Permission RBAC Class Context ---------------------------------------------------------classconfig help O RoleConfig chassis class
cliHistory cliHistory Displays switch command history. Synopsis clihistory clihistory --show clihistory --showuser username clihistory --showall clihistory --clear clihistory --help Description This command saves the following information whenever a command is executed on the switch: • • • • • • Timestamp Username FID (VF mode only) IP address of the Telnet session Options Arguments This command displays the local CLI command history.
cliHistory --help Displays the command usage. Examples To display the command history on a switch: switch:admin> clihistory Date & Time Message Fri Sep 19 09:43:53 2014 root, FID 10, console, tracedump Fri Sep 19 09:43:59 2014 root, FID 10, console, coreshow Fri Sep 19 09:44:21 2014 root, , console, firmwareshow Fri Sep 19 09:44:25 2014 root, , console, errdump switch:admin> firmwaredownload -s -p scp 10.70.4.109,fvt,/dist,pray4green Server IP: 10.70.4.
configDefault configDefault Resets the nonpersistent configuration data to factory defaults. Synopsis Description configdefault [-fid FID | -all | -switch] [-force] Use this command to reset the nonpersistent configuration settings to their factory default values. Configuration data is grouped into chassis information and switch information. Each configuration type is managed separately.
configDefault Note that configDefault does not completely remove all FCIP tunnels and GbE IP address information. This may be an issue when attempting to use the same information to create new tunnels or modify the existing ones. The execution of this command is subject to Virtual Fabric restrictions may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
configDownload configDownload Downloads configuration data to the system.
configDownload Description This command downloads configuration parameters to the local system. Two types of configuration files can be downloaded with this command: Virtual Fabric configuration parameters and system configuration parameters. You must download both types of configuration data for the system to behave as expected.
configDownload The following rules apply to configuration download in Virtual Fabric mode: • When downloading the chassis configuration, the number of logical switches defined in the configuration download must match the number of logical switches currently defined on the switch. • When downloading the switch configuration, the target FID must be defined in both the configuration download and the current system.
configDownload If the configuration file contains the keyword "enable:" followed by a zone_configuration, that zoning configuration is enabled in the fabric. If there is no "enable:" keyword in the configuration file or no zoning configuration by that name exists, or if enable fails for any reason (such as dangling aliases), then the following conditions apply: Notes • The effective configuration remains as it was prior to the configuration download. The "enable:" action is ignored.
configDownload -switch Downloads the switch configuration only. This operand is valid only in non-VF mode. -map Downloads the port-to-area addressing mode configuration files. "host" Specifies the name or the IP address of the external host, from which to download the configuration. IPv4 and IPv6 addresses are supported. To be able to mention the FTP server by name, you need to set up two DNS servers with dnsConfig. Quotation marks are optional. "user" Specifies the login name for the external host.
configDownload Diagnostics Examples The configuration download may fail for one or more of the following reasons: • The switch has not been disabled. Disabling the switch is not necessary for configuration files containing only certain SNMP or MAPS parameters. You can run configDownload first without disabling the switch, and if there is at least one changed parameter outside of SNMP or MAPS, you are prompted to disable the switch before proceeding.
configDownload To download all system configuration data for the chassis and all logical switches (requires chassis permissions): switch:admin> configdownload -all -ftp 192.168.38.245, \ jdoe,config.txt,password To download the switch configurations to a logical switch with FID 8 from an attached USB device (requires chassis permissions): switch:admin> configdownload -fid 8 -USB config.
configList configList Lists uploaded configuration files. Synopsis configlist -local | -USB | -U Description This command displays a list of names, sizes, and creation dates of configuration files saved on the local chassis or on an attached USB device. These files are created when the configUpload command is executed with the -local or the -USB option. Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place.
configRemove configRemove Deletes a saved configuration file. Synopsis Description Notes Operands configremove -local | -USB | -U [file] This command deletes a configuration file that was previously saved to the local chassis or to an attached USB device by using the configUpload command. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
configShow configShow Displays system configuration settings. Synopsis configshow configshow [-all | -fid FID | -chassis | -switch] | [-local | -USB | -U] [file] [-pattern "pattern"] Description Use this command to display system configuration settings. Some but not all of these parameters are set by the configure and configureChassis commands. Configuration data is grouped into chassis information and switch information. Each configuration type is managed separately.
configShow -local [file] Displays the content of a configuration file that was previously created by configUpload and stored on the chassis. The output can be optionally filtered by -pattern "pattern". If file is omitted, the command prompts for a file name. The output format when -local is specified matches that of configUpload and contains a superset of the information provided when -local is not specified.
configShow passwdcfg.history:1 passwdcfg.minpasswordage:0 passwdcfg.maxpasswordage:0 passwdcfg.warning:0 passwdcfg.lockoutthreshold:0 passwdcfg.lockoutduration:30 passwdcfg.adminlockout:0 passwdcfg.repeat:1 passwdcfg.sequence:1 passwdcfg.status:0 fips.mode:0 fips.selftests:0 ipfilter.0.name:default_ipv4 ipfilter.0.numofrules:12 ipfilter.0.rule.1:0,0x23,0,0,6,22 ipfilter.0.rule.10:0,0x23,0,0,17,123 ipfilter.0.rule.11:0,0x63,0,0,6,600,1023 ipfilter.0.rule.12:0,0x63,0,0,17,600,1023 ipfilter.0.rule.
configShow passwdcfg.lockoutduration:30 passwdcfg.adminlockout:0 passwdcfg.repeat:1 passwdcfg.sequence:1 passwdcfg.status:0 To display switch configuration data for FID 20: switch :admin> configshow -fid 20 [Configuration upload Information] Configuration Format = 2.0 date = Tue Oct 7 14:53:12 2008 FOS version = v6.2.0.0 Number of LS = 3 [Switch Configuration Begin : 0] SwitchName = Spirit_66 Fabric ID = 20 [Boot Parameters] boot.name:Spirit_66 boot.ipa:10.32.228.66 boot.
configUpload configUpload Uploads system configuration data to a file.
configUpload Description This command uploads configuration data to a file. Two types of configuration files can be uploaded with this command: Virtual Fabric configuration parameters and system configuration parameters. Use the -vf option to upload Virtual Fabric configuration parameters. The Virtual Fabric configuration includes logical switch definitions and Virtual Fabric status (enabled or disabled). The file should be named vf-conf_xx.
configUpload Do not manually edit a configuration or a vf-conf.xx file after uploading the file and before downloading the file to a switch. Manual editing bypasses sanity checks for some configuration parameters and results in unpredictable system behavior. Operands This command has the following operands: -p ftp | -ftp or -p scp | -scp or -p sftp | -sftp Specifies the data transmission protocol as either file transfer protocol (FTP), secure copy protocol (SCP), or secure FTP (SFTP).
configUpload "path" Specifies the file name and path of the configuration file. When used with the -map option, this parameter specifies a folder that contains all port-to-area mapping files. Absolute path names may be specified using a forward slash (/). Relative path names upload the file to the login account's home directory on UNIX hosts and into the directory on which the FTP server is running on Windows hosts. This operand is valid only when the file is uploaded to an external host.
configUpload To upload the switch configuration that belongs to a logical switch with FID 100: switch:admin> configupload Protocol (scp, ftp, sftp, local) [ftp]: sftp Server Name or IP Address [host]: 10.32.220.100 User Name [user]: jdoe File Name [/config.txt]: config.fid100.
configure configure Changes switch configuration settings. Synopsis Description configure Use this command to change switch configuration settings. 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.
configure Interrupt (Ctrl-C) Aborts the command immediately and ignores all changes made. End-of-file (Ctrl-D) When entered at a prompt with no preceding input, terminates the command and saves changes made. The following parameters can be modified with the configure command: Fabric Parameters Fabric settings control the overall behavior and operation of the fabric. Some of these settings, such as the domain, are assigned automatically and may differ from one switch to another in a given fabric.
configure Fabric parameters are defined as follows: Domain The domain number uniquely identifies a switch in a fabric. This value is automatically assigned by the fabric. The range is 1-239. Enable 8-bit Dynamic Area Mode When enabled, this feature supports Dynamic Area Mode in default partitions on the Brocade DCX 8510-8 and DCX 8510-4. Dynamic Area Mode is disabled by default. When enabled, Dynamic Area Mode supports both static and dynamic area assignment.
configure Brocade DCX 8510-8 and DCX 8510-4 the switch cannot be a default switch or include interchassis link (ICL) ports. This feature is enabled by default (yes=enabled). On the Brocade 6510 default switch, the feature is disabled by default (no=disabled). The XISL feature is supported on the Brocade extension blade (FX8-24). You do not need to disable the logical switch before changing the value of this parameter.
configure E_D_TOV Error detect time out value specified in milliseconds. This timer is used to flag a potential error condition when an expected response is not received within the set time limit. If the time for an expected response exceeds the set value, then an error condition occurs. WAN_TOV Wide area network time out value specified in milliseconds. This timer is the maximum frame time out value for a WAN, if any, interconnecting the Fibre Channel islands.
configure Long Distance Fabric When this mode is set to 1, ISLs in a fabric can be up to 100 km long. The exact distance level is determined 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 number of buffers available to attached devices for frame receipt.
configure The edge hold time configuration is a chip-based value and the configuration varies between 8 Gbps-capable, 16 Gbps-capable, and 32 Gbps-capable platforms. 8 Gbps-capable platform provides one register to store the edge hold time value and any change in this value will affect all ports in the chip. Therefore, the edge hold time configuration will not be changed for 8 Gbps-capable platform ports in a logical switch.
configure The values for virtual channel settings are as follows: Field Default Range ____________________________________ VC Priority 2 2 2 to 3 VC Priority 3 2 2 to 3 VC Priority 4 2 2 to 3 VC Priority 5 2 2 to 3 VC Priority 6 3 2 to 3 VC Priority 7 3 2 to 3 F_Port Login Parameters Specifies the F_Port login parameters. The following F_Port login settings are configurable. Unless there are issues with F_Port staging, do not change default values.
configure non-NPIV F-Ports. When mode is set to 2, on FLOGI login the first FLOGI takes precedence. On FDISC login, the second FDISC takes precedence. For more information, refer to "Configure FLOGI-time handling of duplicate PWWNs" section in the Fabric OS Administrator's Guide. You must disable the switch to change this parameter. MAX num. of FLOGIs allowed Specifies the number of FLOGIs the port can accept per second. The default value is 100. When the FLOGI limit is reached, the port will be fenced.
configure Enable CLOSE on OPEN received? If this is set, a CLS is returned immediately to an OPN if no buffers are available. This is required for TachLite. The valid range is 0 to 4. The default value is 0. Always send RSCN? Following the completion of loop initialization, a remote state change notification (RSCN) is issued when FL_Ports detect the presence of new devices or the absence of preexisting devices.
configure The SNMP attributes are no longer configurable with this command. Use the snmpConfig --set seclevel command to configure SNMP attributes. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. Operands None Examples To enable XISL use on a logical switch with FID 20: switch:admin> setcontext 20 switch:admin> switchdisable switch:admin> configure Configure...
configure Portlog events enable (yes, y, no, n): [no] ssl attributes (yes, y, no, n): [no] rpcd attributes (yes, y, no, n): [no] webtools attributes (yes, y, no, n): [no] switch:admin> switchenable To enable Dynamic Area Mode on the default partition of the Brocade DCX: switch:admin> switchdisable switch:admin> configure Configure... Change fabric parameters? Y Domain: (1..239) [160] Enable 8 bit Dynamic Area Mode (0 = No, 1 = Zero Based Area Assignment): (0..1) [0] 1 R_A_TOV: (4000..
configureChassis configureChassis Changes chassis-level system configuration settings. Synopsis Description configurechassis Use this command to modify chassis-level system configuration settings. Configuration data is grouped into chassis information and switch information. Each configuration type is managed separately. Use the configure command to modify switch configuration parameters.
configureChassis Custom Attributes The following custom attributes can be modified. config Index OEM custom configuration. The range is 0 through 10000. The default is 0. This attribute is for internal use only. System attributes The following system-related parameters are configurable on a Virtual Fabric-aware switch. system.blade.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.
configureChassis 0 Clears any previously configured CS_CTL to VC mapping and sets one-to-one mapping between a CS_CTL value and VC number for 8 Gbps-capable and 16 Gbps-capable ASIC. The CS_CTL values are divided into three groups: 1-8 (low priority), 9-16 (medium priority), and 17-24 (high priority). This is the default mode. 1 Sets the CS_CTL to VC mapping to support three CS_CTL values: 1 (low priority), 2 (medium priority), and 3 (high priority).
configureChassis To change the slow drain device quarantine limit: switch:admin> configurechassis Configure... cfgload attributes (yes, y, no, n): [no] Custom attributes (yes, y, no, n): [no] system attributes (yes, y, no, n): [no] fos attributes (yes, y, no, n): [no] y CSCTL QoS Mode (0 = default; 1 = auto mode): (0..1) [1] Chassis SDDQ Limit: (0..
creditRecovMode creditRecovMode Enables credit loss recovery on back-end ports of 8Gbps-capable, 16Gbps-capable, 32 Gbps-capable blades, and time-out based credit loss detection of 8 Gbps-capable front-end ports.
creditRecovMode If you suspect complete credit loss on a particular virtual channel (VC) on a particular backend port, use the --check option to examine that particular backend port and VC for credit loss. If the command detects complete credit loss, it reports the information. If, in addition, you have enabled link resets on backend ports, this command will perform a link reset on the link in an attempt to recover from the problem. You must explicitly initiate this check and it is a one-time operation.
creditRecovMode --fe_crdloss Configures time-out based credit loss detection of 8 Gbps-capable front-end ISL links. This feature is disabled by default. off Disables credit loss detection on 8 Gbps-capable front-end ports. on Enables credit loss detection on 8 Gbps-capable front-end ports. --be_crdloss Activates link reset when credit loss occurs on backend ports. This feature is disabled by default. off Disables link reset for credit loss on backend ports.
creditRecovMode Examples To enable backend port credit loss recovery with the link reset only option and to display the configuration: switch:admin> creditrecovmode --cfg onLrOnly switch:admin> creditrecovmode --show Internal port credit recovery is Enabled with LrOnly C2 FE Complete Credit Loss Detection is Enabled To enable backend port credit loss recovery with the link reset threshold option and to display the configuration: switch:admin> creditrecovmode --cfg onLrThresh switch:admin> creditrecovmode
creditRecovMode To disable link reset for credit loss alone: switch:admin> creditrecovmode --be_crdloss off switch:admin> creditrecovmode --show Internal port credit recovery is Disabled Back end port Loss of Sync's Link Reset is Enabled with LrThresh LR threshold (currently activated): 2 Fault Option : COREBLADE C2 FE Complete Credit Loss Detection is Disabled To enable link reset for loss of sync alone: switch:admin> creditrecovmode --be_losync on switch:admin> creditrecovmode --show Internal port credi
dataTypeShow dataTypeShow Displays sample data stream types used in some diagnostic commands. Synopsis Description Notes Operands datatypeshow [-seed value] Use this command to display sample data stream types used in diagnostic commands. There are 25 different sample data types. The command displays an example of each data stream. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
date date Displays or sets the switch date and time. Synopsis Description date ["newdate"] Use this command to display or set the date and time. All switches maintain current date and time in flash memory. Date and time are used for logging events. Normal switch operation does not depend on the date and time; a switch with incorrect date values continues to function properly. This command sets a common date and time for the entire fabric.
date yy Specifies the year, valid values are 00 to 37 and 70 to 99. Year values from 70 to 99 are interpreted as 1970 to 1999; year values from 00 to 37 are interpreted as 2000 to 2037.
dbgShow dbgShow Displays current values of debug and verbosity levels of the specified module. Synopsis Description Notes Operands dbgshow [module_name] Use this command to display the current values of debug and verbosity levels of the specified module. If no module name is specified, this command displays a listing of all modules along with debug and verbosity levels. The execution of this command is subject to Virtual Fabric restrictions that may be in place.
defZone defZone Sets or displays the default zone access mode. Synopsis Description defzone [--noaccess | --allaccess | --show] Use this command to display or set the Default Zone access mode. Setting the Default Zone mode initializes a zoning transaction (if one is not already in progress), and create reserved zoning objects. A default zone controls device access when zoning is not enabled.
defZone When No Access default zone is activated, the following conditions apply: • • If the current effective zone configuration is disabled with the cfgDisable command, the local switch converts this command to the equivalent of cfgEnable "d_efault_Cfg".
diagClearError diagClearError Clears the diagnostics failure status. Synopsis Description Notes Operands diagclearerror [[--slot] slot] -all Use this command to clear the diagnostics failure status. When used without operands, this command clears all port failure flags. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
diagDisablePost diagDisablePost Disables the power-on self-test (POST). Synopsis Description Notes diagdisablepost Use this command to disable POST. A reboot is not required for this command to take effect. Use the diagPost command to display the current POST status, and use diagEnablePost to enable POST. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
diagEnablePost diagEnablePost Enables the power-on self-test (POST). Synopsis Description diagenablepost Use this command to enable POST. A reboot is not required for this command to take effect. POST includes two phases: POST Phase I mainly tests hardware and POST Phase II tests system functionality. Use the diagPost command to display the current POST status, and use diagDisablePost to disable POST. Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place.
diagHelp diagHelp Displays diagnostic command information. Synopsis Description diaghelp Use this command to display a short description of diagnostic commands. Use default operands when running diagnostics commands. Non-default settings require detailed knowledge of the underlying hardware and are intended for support personnel only. Contact support if you want to use these operands. Notes The diagHelp command displays diagnostic commands that may not be available.
diagPost diagPost Displays the diagnostic power-on self-test (POST) configuration. Synopsis diagpost Description Use this command to display the current POST configuration. Use diagEnablePost or diagDisablePost to modify the POST configuration. Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
diagRetry diagRetry Sets or displays diagnostic retry mode. Synopsis Description diagretry [mode | -show] Use this command to enable retry mode if the mode value is nonzero and to disable the retry mode if the mode value is 0. The mode value is saved in nonvolatile memory until you change the mode. Changes made by this command do not require a reboot to take effect. Retry mode modifies the behavior of the diagnostic test methods, power-on self-test (POST), and burn-in scripts.
diagShow diagShow Displays diagnostics status. Synopsis Description Notes diagshow [--slot number] [-post] [-port number] [-use_bports value] Use this command to display the diagnostics status for the specified list of ports. You cannot interrupt the test by pressing the return key (). The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
diagStatus diagStatus Displays currently running diagnostic tests. Synopsis Description Notes Operands diagstatus [slotnumber] Use this command to display currently running diagnostic test names. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. This command has the following operand: slotnumber Specifies the slot number to display diagnostic test names.
distribute distribute Distributes data to switches in a fabric. Synopsis Description distribute -p policy_list -d switch_list Use this command to distribute data to a specified list of switches in the fabric.
distribute Examples To distribute the Switch Connection Control Policy and Device Connection Control Policy to domains 3 and 5 in the fabric: switch:admin> distribute -p "SCC;DCC" -d "3;5" To distribute the Switch Connection Control Policy, Fabric Configuration Server Policy, and Password database to all domains in the fabric that support the distribute feature: switch:admin> distribute -p "SCC;FCS;PWD" -d "*" Wildcard domains are: 1 3 5 To distribute the FCS policy, and the Password database to all dom
dlsReset dlsReset Disables Dynamic Load Sharing (DLS). Synopsis Description dlsreset Use this command to disable Dynamic Load Sharing. If DLS is turned off, load sharing calculations are used only to place new routes. Once placed, existing routes are never moved from one output E_Port to another, unless the original output E_Port is no longer a recognized path to the remote domain. Optimal balance is rarely achieved with this setting.
dlsSet dlsSet Enables Dynamic Load Sharing (DLS) without frame loss. Synopsis dlsset dlsset --enable -lossless dlsset --enable -eportbal dlsset --enable -twohop dlsset --disable -lossless dlsset --disable -eportbal dlsset --disable -twohop dlsset --rebalance dlsset --rebalance -all dlsset --help Description Use this command to enable or disable lossless Dynamic Load Sharing (DLS) in the event of a fabric change, to configure DLS without frame loss, and to display the DLS configuration.
dlsSet For example, assume a chassis is partitioned as follows: logical switch LS1 consists of ports 1/0-1/5, and logical switch LS2 consists of ports 1/6-1/10. Lossless is enabled on logical switch LS1. Because the ports 1/0-1/10 share the same chip, traffic in LS2 is affected whenever traffic for LS1 on ports 1/0-1/5 is rebalanced.
dlsSet --enable -eportbal Enables the E_Port Balance Priority feature. The E_Port load is rebalanced when topology changes occur, such as an E_Port going offline and then online. If DLS is disabled on the switch, it remains disabled with this command. --disable -eportbal Disables the E_Port Balance Priority feature. --enable -twohop Enables two-hop lossless DLS.
dlsSet switch:admin> dlsset --enable -lossless Lossless is set switch:admin> dlsset --disable -lossless Lossless is not set switch:admin> dlssshow DLS is set by default with current routing policy E-port Balance Priority is not set DLS configuration commands on a switch with a port-based policy: switch:admin> dlsshow DLS is set by default with current routing policy DLS is set with Lossless enabled E-port Balance Priority is not set switch:admin> dlsreset DLS is not set switch:admin> dlsshow DLS is not se
dlsSet To attempt to enable Lossless while XISL use is enabled: switch:admin> dlsset --enable -lossless Lossless option cannot be enabled when XISL use is allowed. Please disable the switch with 'switchdisable' and run \ 'configure' to disallow XISL use before enabling Lossless.
dlsShow dlsShow Displays the setting of Dynamic Load Sharing (DLS). Synopsis Description dlsshow Use this command to display information about Dynamic Load Sharing configuration settings on the switch. Depending on the configuration, the command output displays one of the following messages: • DLS is set with Lossless enabled - DLS is enabled with the Lossless feature. Load sharing is recomputed with every change in the fabric, and existing routes can be moved to maintain optimal balance.
dnsConfig dnsConfig Sets, displays, or removes domain name service (DNS) parameters. Synopsis dnsconfig dnsconfig --add -domain name -serverip1 ipaddr serverip2 ipaddr dnsconfig --delete dnsconfig --show dnsconfig --help Description Use this command to display, set, or remove the domain name service parameters. The domain name service parameters are the domain name and the name server IP address for primary and secondary name servers. The dnsconfig command displays IPv4 and IPv6 addresses.
dnsConfig 3 Remove DNS configuration 4 Quit Select an item: (1..4) [4] 2 Enter Domain Name: [] domain.com Enter Name Server IP address in dot notation: [] \ 123.123.123.123 Enter Name Server IP address in dot notation: [] \ 123.123.123.124 DNS parameters saved successfully Enter option 1 Display Domain Name Service (DNS) configuration 2 Set DNS configuration 3 Remove DNS configuration 4 Quit Select an item: (1..
enclosureShow enclosureShow Displays attributes of the switch enclosure. Synopsis Description enclosureshow attribute Use this command to display attributes of the switch enclosure, including the vendor-specific enclosure identifier and the identifier of the enclosure interface to which the switch is attached. This command applies to products that are embedded in a blade server or storage chassis. Most options are platform-specific.
enclosureShow conntype The connector type used by the enclosure manager for this model of switch. connloc The switch location within the enclosure. connpres Information about the presence of the switch that is used by the enclosure manager. connfuse Information about whether or not the switch has a fuse. uuid The Universal Unique ID for the switch if visible to the enclosure manager. mmmacaddr The enclosure manager's Ethernet MAC Address.
errClear errClear Clears all error log messages for all switch instances on this Control Processor (CP). Synopsis errclear Description Use this command to clear all internal and external error log messages for all switch instances on the CP where the command is executed. For products with a single processor, all error log messages are cleared. For products that contain multiple processors, this command can be executed on either control processor.
errDelimiterSet errDelimiterSet Sets the error log start and end delimiters for messages sent to the console and syslog. Synopsis Description errdelimiterset [-s "start_delimiter_string"] [-e "end_delimiter_string"] Use this command to set the error log start and end delimiters for log messages sent to the console and syslog. An empty string clears the start and the end delimiters (including the colon) so that they are not displayed.
errDump errDump Displays the error log without pagination. Synopsis errdump [--all] errdump [--count number] errdump [--reverse] errdump [--severity severity] errdump [--slot slotnum] errdump [--attribute attribute] errdump [--message msgID] errdump [--start YYYY/MM/DD-HH:MM:SS] errdump [--stop YYYY/MM/DD-HH:MM:SS] errdump [--help] Description Use this command to dump external error log messages without any page breaks.
errDump Switch name Switch name for the generator of this message, or "chassis". Message Message body. End delimiter Delimiter string for the end of a message. Notes Operands The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. This command has the following operands: --all Displays messages for the entire chassis for a user with chassis permissions.
errDump --help Displays command usage. Examples To display the error log for the chassis: switch:admin> errdump --all Fabric OS: v8.0.1 2015/12/17-22:29:17, [SEC-1203], 9036, CHASSIS, INFO,\ Spir_67, Login information : Login successful via \ TELNET/SSH/RSH. IP Addr: 10.106.7.62 2015/12/17-22:29:17, [ZONE-1022], 9037, CHASSIS, INFO, \ Spir_67, The effective configuration has changed to meh. 2015/12/17-22:29:17, [FABR-1001], 9041, CHASSIS, WARNING, \ Spir_67, port 0, incompatible Long distance mode.
errDump 2015/06/18-20:36:11, [FABR-1001], 9, SLOT 5 | FID 128, WARNING, \ sw0, port 281, ESC detected Fabric ID conflict with neighbor \ (FID 20). 2015/06/18-20:36:11, [FABR-1001], 10, SLOT 5 | FID 128, WARNING, \ sw0, port 265, ESC detected Fabric ID conflict with neighbor\ (FID 1). To display messages based on attributes: switch:admin> errdump --attribute FFDC Fabric OS: v8.0.1 2015/06/19-03:58:42, [LOG-1001], 81, SLOT 5 | FFDC | CHASSIS, \ WARNING, pluto_19, A log message was dropped To display messag
errDump CP0 resetting other CP (double 2015/10/10-20:42:07, [XTUN-1997], FTRACE buffer 0 on slot 1 dp 2 2015/10/10-20:42:07, [PLAT-1001], CP0 resetting other CP (double reset may occur). 20, CHASSIS, WARNING, ch3456789012345678901234, \ has been triggered. 21, CHASSIS, INFO, ch3456789012345678901234, \ reset may occur). To display messages from beginning of the log to the specified time: switch:admin> errdump --stop 2015/10/10-20:42:05 Fabric OS: v8.0.
errFilterSet errFilterSet Sets a filter for an error log destination. Synopsis Description errfilterset [-d destination][-v severity] Use this command to set a filter for an error log destination. A filter is set based on the severity level of the messages. When used without operands, this command displays the filters that are currently in configured. Notes Operands The execution of this command is subject to Virtual Fabric restrictions that may be in place.
errModuleShow errModuleShow Displays all the defined error log modules. Synopsis Description Notes errmoduleshow Use this command to display a list of all defined error log modules. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
errShow errShow Displays the error log messages with pagination. Synopsis Description errshow [-a | -r | -t | -o] Use this command to display external error log messages one at a time. When executed without operands, this command prints the error messages for the logical switch context in which the command is executed. When used with the -a option, the command prints the error messages for the entire chassis. The messages are displayed with page breaks.
errShow Notes Operands The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. This command has the following operands: -a Displays messages for the entire chassis for a user with admin and chassis permissions. This operand is optional; if omitted, the messages for the current logical switch context are displayed. -r Displays messages in reversed order.
errShow To display messages from specified time to the end of the log: switch:admin> errshow -t 2016/10/31-19:17:23 Fabric OS: v8.0.0 2015/10/31-19:17:25, [IPAD-1000], 15, CHASSIS, INFO, Brocade5300, \ SW/0 Ether/0 IPv6 autoconf 2012::90/64 DHCP Off. Type to continue, Q to stop: 2015/10/31-19:17:25, [HAM-1004], 16, CHASSIS, INFO, Brocade5300, \ Processor rebooted - Hareboot. Type to continue, Q to stop: 2015/10/31-19:17:29, [FV-1001], 17, CHASSIS, INFO, switch, \ Flow Vision daemon initia
errShow Off. Type to continue, Q to stop: 2015/10/31-19:01:06, [HAM-1004], 8, CHASSIS, INFO, Brocade5300, \ Processor rebooted - Fastboot. Type to continue, Q to stop: 2015/10/31-19:01:06, [IPAD-1000], 9, CHASSIS, INFO, Brocade5300, \ SW/0 Ether/0 IPv6 autoconf 2620:100:4:f801:205:33ff:fe00:9b28/64 DHCP Off. Type to continue, Q to stop: 2015/10/31-19:01:11, [FV-1001], 10, CHASSIS, INFO, switch, \ Flow Vision daemon initialized.
ethIf ethIf Displays and sets the link operating mode for a network interface. Synopsis ethif --set interface -auto-negotiate | -an [on | off] -speed [speed] -duplex [full | half] ethif --reseterror interface ethif --show interface ethif --help Description Use this command to set and view the link operating mode for a network interface. Changing the link mode is not supported for all network interfaces or for all Ethernet network interfaces.
ethIf Notes Operands The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. This command has the following operands: --set Sets a link operating mode for a network interface. interface Specifies the name of the interface, optionally enclosed in double quotation marks. Valid interfaces include the following: eth0 | eth3 Displays the link operating mode of the specified interface.
ethIf Examples To reset the link operating attributes on eth0: switch:admin> ethif --reseterror eth0 Statistics cleared for eth0 To view the link operating attributes on bond0: switch:admin> ethif --show bond0 bond0 interface: bond0 includes physical interfaces: eth0 eth3 Currently Active Interface: eth0 Currently Slave Interface: eth3 Link mode: negotiated 1000baseT-FD, link ok MAC Address: 00:05:1E:86:7B:79 bond0 Link encap:Ethernet HWaddr 00:05:1E:86:7B:79 inet addr:10.38.18.135 Bcast:10.38.31.
ethIf To check the link operating attributes: switch:admin> ethif --show eth0 Link mode: negotiated 100baseTx-FD, link ok MAC Address: 00:05:1E:86:7B:79 eth0 Link encap:Ethernet HWaddr 00:05:1E:86:7B:79 UP BROADCAST RUNNING SLAVE MULTICAST MTU:1500 Metric:1 RX packets:2397 errors:0 dropped:0 overruns:0 frame:0 TX packets:56 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 SEE ALSO ipAddrSet, ipAddrShow Brocade Fabric OS Command Reference 53-1004112-02 209
exit exit 210 Description See logout.
extnCfg extnCfg Sets the extension mode configuration. Synopsis extncfg --ve | --ve-mode [--slot slot/] 10VE | 20VE extncfg --app-mode fcip | hybrid extncfg --config -default | -clear [-slot slot | -all] extncfg --show extncfg --help Description Notes Use this command to set the extension mode configuration. This command switches the Field Programmable Gate Array (FPGA) images or the VE_Port mappings. The execution of this command is disruptive and requires the switch reboot.
extnCfg Examples To display the current extension mode configuration: switch:admin> extncfg --show App Mode is FCIP VE-Mode: configured for 10VE mode. To switch the extension mode configuration: switch:admin> extncfg --ve-mode 20VE This operation will require a reboot of the switch and will disrupt any running traffic. Are you sure you want to proceed? (y/n): y Operation Succeeded. Rebooting Switch.
fabRetryShow fabRetryShow Displays the retry count of the fabric commands. Synopsis Description fabretryshow Use this command to display the retry count of the fabric commands.
fabRetryShow ESA Exchange Security Attributes DIAG_CMD Diagnostic Command Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. Operands None Examples To display the retry count of Fabric OS Commands: switch:user> fabretryshow SEE ALSO 214 E_Port ELP EFP SW_ILS HA_EFP DIA RDI BF FWD EMT ETP RAID \ 34 35 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 GAID ELP_TMR GRE
fabRetryStats fabRetryStats Displays or manages the retry count of fabric commands. Synopsis fabretrystats --show fabretrystats --clear fabretrystats --help Description Use this command to view and clear the retry count of the fabric commands. The --clear option clears the counters for all the Switch Internal Link Service (SW_ILS) requests.
fabRetryStats ESC Exchange Switch Capabilities EFMD Exchange Fabric Membership Data ESA Exchange Security Attributes DIAG_CMD Diagnostic Command Notes Operands The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. This command has the following operands: --show Displays the retry count of fabric commands for all E_Ports and D_Ports. --clear Clears the retry count of fabric commands.
fabricLog fabricLog Displays (all users) or manipulates (admin) the fabric log. Synopsis fabriclog -s | --show [dport] fabriclog -c | --clear [dport] fabriclog -d | --disable fabriclog -e | --enable fabriclog -h | --help Description Use this command to display, clear, disable, or enable the fabric log. When used with the --show option, this command displays the following information: Time Stamp Time of the event in the following format HH:MM:SS:MS. Input and *Action Fabric log message.
fabricLog A1 The non-principal switch is sending a DIA. A2 The non-principal switch is waiting for an RDI. A3 The non-Principal switch is processing an RDI. S0 The switch is in offline state. P Port state. Port states include the following: PO The port is offline. P1 The port is online. P2 Exchange Link Parameters (ELP) Accept Frame (ACC) received. P3 Link reset occurred on master or E_Port. I0 Trunk Initiator: Exchange Mark Timestamp (EMT) sent.
fabricLog Sn Next switch state. Refer to switch states for valid states. Pn Next port state. Refer to port states for valid states. Port Port number, if applicable, or NA Xid OXID (Exchange ID) Port number, if applicable, or NA Refer to the FC-SW-5 specification for more information on the port and switch states logged by this command. Notes Operands The execution of this command is subject to Virtual Fabric restrictions that may be in place.
fabricLog To display the cleared fabric log: switch:admin> fabriclog -s Time Stamp Input and *Action S, P Sn,Pn Port Xid ======================================================== Number of entries: 0 Max number of entries: 64 SEE ALSO 220 None Brocade Fabric OS Command Reference 53-1004112-02
fabricName fabricName Configures the fabric name parameter. Synopsis fabricname --set fabric_name fabricname --clear fabricname --show fabricname --help Description Use this command to configure a name for the fabric. With Virtual Fabrics it is not uncommon to have multiple fabrics in a single chassis. These logical fabrics are identified by their Fabric ID. With the fabricName command, you can address a fabric by name. This command provides an option for addressing fabrics by name.
fabricName To set a fabric name that includes spaces: switch:user> fabricname --set "my new fabric" Fabric Name set to "my new fabric" switch:user> fabricname --show Fabric Name: "my new fabric" To clear the fabric name: switch:user> fabricname --clear Fabric Name cleared! switch:user> fabricname --show Fabric Name is not configured SEE ALSO 222 switchShow, fabricShow Brocade Fabric OS Command Reference 53-1004112-02
fabricPrincipal fabricPrincipal Sets the principal switch selection mode. Synopsis fabricprincipal --help | -h fabricprincipal [--show | -q] fabricprincipal --enable [ -priority | -p priority] [-force | -f ] fabricprincipal --disable fabricprincipal [-f] mode Description Use this command to set principal switch selection mode for a switch and to set priorities for principal switch selection.
fabricPrincipal 0x00 Reserved. This value cannot be assigned. 0x01 Highest priority. This is a user-defined value 0x02 Switch was principal prior to sending or receiving a build fabric (BF) request. This value is generated by the switch to initiate a fabric reconfiguration. This value should not be assigned. 0x3 - 0xFE Priority value range. Choose a value in this range to indicate priority. Higher numbers mean lower priority. 0xFF Switch is not capable of acting as a principal switch.
fabricPrincipal To enable 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) To display the principal switch selection priority: switch:admin> fabricprincipal --show Principal Selection Mode: Enable Principal Switch Selection Priority: 0x10 SEE ALSO fabricShow Brocade Fabric OS Command Reference 53-1004112-02 225
fabricShow fabricShow Displays fabric membership information. Synopsis fabricshow [-membership | -chassis | -paths | -version] fabricshow -help Description Use this command to display information about switches in the fabric. If the switch is initializing or is disabled, the message "no fabric" is displayed. Running this command on an FCR or edge switch does not provide any router information; running this command on an edge switch with the -membership option does provide router information.
fabricShow Path Count The number of currently available paths to the remote domain. Version The firmware version of the domain. Notes Operands The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. This command has the following operands: -membership Displays fabric membership information with additional details of the FC Router, if present in the fabric.
fabricShow To show additional details of the FC Router, if present: switch:admin> fabricshow -membership 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.
fabStatsShow fabStatsShow Displays fabric statistics. Synopsis Description fabstatsshow Use this command to display statistics for the fabric.
fabStatsShow Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
fanDisable fanDisable Disables a fan unit. Synopsis Description Notes fandisable unit Use this command to disable a nonfaulty fan unit by setting the RPM speed to 0. This command is not available on nonbladed systems. Disabling the fan units on a Brocade X6 Director does not change their RPM speed to 0. Fan units on a Brocade X6 Director take few minutes to change the speed to minimum RPM after being disabled. The execution of this command is subject to Virtual Fabric restrictions that may be in place.
fanEnable fanEnable Enables a fan unit. Synopsis Description Notes fanenable unit Use this command to set a previously disabled fan unit back to the default RPM speed. This command is not available on nonbladed systems. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. Operands This command has the following operand: unit Specify the fan unit number to enable.
fanShow fanShow Displays fan status and speed. Synopsis Description fanshow Use this command to display the current status and speed of each fan in the system. Fan status is displayed as follows: OK Fan is functioning correctly. absent Fan is not present. below minimum Fan is present but rotating too slowly or stopped. above maximum Fan is rotating too quickly. unknown Unknown fan unit installed. faulty Fan has exceeded hardware tolerance and has stopped.
faPwwn faPwwn Manages fabric-assigned port world wide names.
faPwwn Description Use this command to create and manage fabric-assigned port world wide names (FA-PPWWNs) for Dynamic Fabric Provisioning (DFP). A FA-PWWN is a "virtual" port WWN that will bind to a device port and can be later assigned to a physical device. A FA-PWWN can be either user-generated or automatically assigned by the fabric. The automatically assigned FA-PWWN is created by default when you enable the feature without explicitly providing a VPWWN.
faPwwn The following information is displayed for both AG and FC switch ports: PID Port ID. Enable Displays "yes" if the configuration is enabled; displays "No" if the configuration is disabled. MapType Displays the type of mapping: Access Gateway (AG) or switch port (port), user-assigned (user) or automatically assigned (auto). Notes This command is supported only on the Brocade DCX 8510-4 and DCX 8510-8,and the and Brocade 6510. The AG port must be configured on the switch to which the AG is connected.
faPwwn --delete Deletes the active FA-PWWN from the specified ports. If a port is bound to a user-assigned FA-PWWN, this command deletes the currently active FA-PWWN and activates the automatically assigned FA-PWNN. If the active FA-PWWN is automatically assigned and no user-assigned FA-PWWN exists, this command deletes the FA-PWWN. When deleting VPWWNs from an AG, you must specify the AG node WWN and the -port operand is optional; if omitted, all active FA-PWWNs are deleted from the AG.
faPwwn -srcport source_port Specifies the port from which to move the PWWN. -dstport dest_port Specifies the destination port for the moved PWWN. --help Displays the command usage.
faPwwn To display the active FA-PWWN for a single FC port (the real device PWWN is hidden): switch:admin> fapwwn --show -port 10 ----------------------------------------------------------------------Port PPWWN VPWWN PID Enable MapType ----------------------------------------------------------------------10 --:--:--:--:--:--:--:-- 52:00:10:00:00:0f:50:45 -- Yes Port/Auto To display the active FA-PWWNs for all FC switch ports: switch:admin> fapwwn --show -port all -------------------------------------------
faPwwn To display the active FA-PWWNs of all ports associated with a single AG (in the following example, one VPWWN is not unassigned): switch:admin> fapwwn --show -ag 10:00:00:05:1e:d7:3d:dc ----------------------------------------------------------AG Port Port Device Port WWN \ ----------------------------------------------------------10:00:00:05:1e:d7:3d:dc/16 ---:--:--:--:--:--:--:-- \ 10:00:00:05:1e:d7:3d:dc/9 20 20:09:00:05:1e:d7:2b:73 \ 10:00:00:05:1e:d7:3d:dc/8 20 20:08:00:05:1e:d7:2b:74 \ \ 10:00:
fastBoot fastBoot Reboots the Control Processor (CP), bypassing the Power-On Self-Test (POST). Synopsis Description fastboot Use this command to perform a "cold reboot" (power off/restart) of the CP bypassing POST when the system comes back up. Bypassing POST can reduce boot time significantly. If POST was previously disabled using the diagDisablePost command, then fastBoot is the same as reBoot. The fastBoot operation is disruptive, and the command prompts for confirmation before executing.
fastBoot To reboot a DCX without executing POST on startup (in the example, HA is enabled): switch:admin> fastboot Warning: This command is being run on a control processor (CP) based system and will cause the active CP to reboot. Are you sure you want to reboot the active CP [y/n]? y Broadcast message from root (pts/0) Sun Feb 28 19:49:45 2010...
fcipHelp fcipHelp Displays FCIP command information. Synopsis fciphelp Description Use this command to display a listing of Fibre Channel over IP (FCIP) commands with short descriptions for each command. FCIP commands require an FCIP license. Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
fcipLedTest fcipLedTest Exercises the GbE port LEDS on the Brocade 7840, FX8-24, and SX6 extension blade. Synopsis Description fcipledtest [--slot slot | all] Use this command to exercise the GbE port LEDs on the Brocade Brocade 7840, FX8-24, and SX6 extension blade. The behavior of this command varies according to platform: • On Brocade FX8-24, this test cycles through the port LEDs by lighting GREEN and then flashing GREEN on all ports for 3 seconds.
fcipPathTest fcipPathTest Tests the data path of the FCIP complex. Synopsis Description fcippathtest [--slot slot] [-lb_mode mode] [-nframes count] Use this command to verify the data paths in the FCIP complex. All data path modes run tests by comparing Fibre Channel frames or data packets transmitted from and received by the network processor due to the designated loopback. This command is supported only on the Brocade 7840, FX8-24, SX6 platforms.
fcipPathTest Diagnostics When it detects failures, the test may report one or more of the following error messages: PATH_TEST_ERR PATH_TEST_CHIP_INIT_ERR PATH_TEST_IMAGE_ERR PATH_TEST_TIMEOUT_ERR PATH_TEST_HEARTBEAT_ERR PATH_TEST_INVALID_RESULT PATH_TEST_GE_PORT_ENABLE_ERR PATH_TEST_GE_PORT_DISABLE_ERR Examples To run the test on slot 2: switch:admin> fcippathtest --slot 2 Running fcippathtest .............. Test Complete: fcippathtest Pass 10 of 10 Duration 0 hr, 1 min & 50 sec (0:1:50:942). passed.
fcPing fcPing Sends a Fibre Channel Extended Link Service (ELS) Echo request to a pair of ports or to a single destination, or executes a SuperPing.
fcPing Logical Fabrics: When executed in a Logical Fabric from a switch to a destination device connected through the base fabric, SuperPing exercises all paths in the base fabric along with the ISLs in the logical fabric. The path output indicates the LISLs and the base switch. Refer to the Examples section for an illustration. Notes The ELS Echo may not be supported on all devices. In such cases, the response could be either an ELS reject or a request timeout.
fcPing --pattern pattern Specifies up to 16 "pad" bytes, which are used to fill out the request frame payload sent. This is useful for diagnosing data-dependent problems in the fabric link. The pattern bytes are specified as hexadecimal characters. For example, --pattern ff fills the request frame with instances of the number 1. If a non-byte-aligned pattern is specified, the upper nibble of the last pattern byte is filled with zeros. For example, --pattern 123 fills the payload with a pattern of 0x1203.
fcPing -errstats Collects error statistics of each user port that is part of ISLs covered through SuperPing to reach destination domain. -vc Displays the ISL and internal port statistics per VC. --help Displays the command usage.
fcPing To use fcping with a single destination: switch:admin> fcping 20:03:00:05:33:7e:97:e9 Pinging 20:03:00:05:33:7e:97:e9 [0x022300] with 12 bytes of data: Request rejected Request rejected by 0x022300: Command not supported: time: 1159 usec Request rejected by 0x022300: Command not supported: time: 1006 usec Request rejected by 0x022300: Command not supported: time: 1008 usec Request rejected by 0x022300: Command not supported: time: 1038 usec Request rejected by 0x022300: Command not supported: time:
fcPing 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 usec received reply from 20:00:00:00:c9:3f:7c:b8:12 bytes time:713 usec received reply from 20:00:00:00:c9:3f:7c:b8:12 bytes time:714 usec received reply from 20:00:00:00:c9:3f:7c:b8:12 bytes time:741 usec received reply from 20:00:00:00:c9:3f:7c:b8:12 bytes time:880 usec 5 frames sent,5 frame
fcPing 2. 3. 4. 5. ( ( ( ( 3/EMB, 3/EMB, 3/EMB, 3/EMB, 3/205)[128] 3/205)[128] 3/204)[128] 3/204)[128] ( ( ( ( 2/25 2/25 2/27 2/27 , , , , 2/1 )[128] 2/42 )[128] 2/42 )[128] 2/1 )[128] \ \ \ \ SWITCH3 STATUS --------------------------------(101/16 ,101/EMB)[128] SUCCESS (101/8 ,101/EMB)[128] FAILED (101/3 ,101/EMB)[128] FAILED 4(101/3 ,101/EMB)[128] FAILED 101/8 ,101/EMB)[128] FAILED Completed superping for all paths.
fcPing ISL COVERAGE ------------SNO ISL STATUS ---------------------------------------------------1 ( 3/205-->207/25 ) SUCCESS(4025/4025) 2 ( 3/204-->207/27 ) SUCCESS(5/5) 3 (207/42 -->101/3 ) SUCCESS(4030/4030) 4 (101/16 -->165/99 ) SUCCESS(4030/4030) INTERNAL PORT COVERAGE ----------------------SNO DOMAIN INTRNL_PORT STATUS ----------------------------------------- SEE ALSO 254 None Brocade Fabric OS Command Reference 53-1004112-02
fcpLogClear fcpLogClear Clears the FCPD debug information log. Synopsis Description Notes fcplogclear Use this command to clear the debug information logged by the Fibre Channel Protocol daemon (FCPD). The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
fcpLogDisable fcpLogDisable Disables the FCPD debug information log. Synopsis Description Notes fcplogdisable Use this command to disable the logging of debug information by the Fibre Channel Protocol daemon (FCPD). The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
fcpLogEnable fcpLogEnable Enables the FCPD debug information log. Synopsis Description Notes fcplogenable Use this command to enable Fibre Channel Protocol daemon (FCPD) logging. Debug information logging is enabled by default. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
fcpLogShow fcpLogShow Displays the FCPD debug information log. Synopsis Description Notes fcplogshow Use this command to display the debug information logged at various stages during the Fibre Channel Protocol daemon (FCPD) device probing. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
fcpProbeShow fcpProbeShow Displays the Fibre Channel Protocol (FCP) probe information. Synopsis Description fcpprobeshow [slot/]port Use this command to display the Fibre Channel Protocol daemon (FCPD) device probing information for the devices attached to the specified F_Port or FL_Port. This information includes the number of successful logins and SCSI INQUIRY commands sent over this port and a list of the attached devices. This command includes probing information for NPIV devices.
fcpProbeShow list of devices(may include old NPIV devices): 0x500e8: SEAGATE ST318452FC 0005 0x500e4: SEAGATE ST318452FC 0001 0x500e2: SEAGATE ST318452FC 0005 SEE ALSO 260 portLoginShow, portLogShow Brocade Fabric OS Command Reference 53-1004112-02
fcpRlsProbe fcpRlsProbe Initiates the Fibre Channel Protocol (FCP) Read Link Status (RLS) probing for F_Port and displays the RLS information. Synopsis fcpRlsProbe --start [slot/]port_list fcpRlsProbe --show [slot/]port fcpRlsProbe --help Description Use this command to initiate the FCP RLS probing or to display the RLS information. This information describes the number of link failures, loss-of-signal, loss-of-sync, CRC errors, and other failure events detected on the specified port.
fcpRlsProbe Examples To start the RLS probing: switch:admin> fcprlsprobe --start 1 RLS probing initiated... Please use the fcprlsprobe --show port command to view the RLS info.
fcpRlsShow fcpRlsShow Displays the Fibre Channel Protocol (FCP) Read Link Status (RLS) information. Synopsis Description fcprlsshow [slot/]port Use this command to display the FCP RLS information for an F_Port or FL_Port. This information describes the number of loss-of-signal, loss-of-sync, CRC errors, and other failure events detected on the specified port.
fcpRlsShow AL_PA 0x3 ========== RLS Probe Status : SUCCESS Last Updated : Mar 4 03:17:52 2012 -----------------------------------------------------------link fail loss sync loss sig prtc err bad word crc err -----------------------------------------------------------147 1035 118 0 306278 72 SEE ALSO 264 portLoginShow, portShow Brocade Fabric OS Command Reference 53-1004112-02
fcrBcastConfig fcrBcastConfig Displays or sets the broadcast frame forwarding option. Synopsis fcrbcastconfig --show fcrbcastconfig --enable -f fabric_id fcrbcastconfig --disable -f fabric_id fcrbcastconfig --help Description Notes Operands Use this command to enable or disable the broadcast frame option or to display the current configuration. If no operands are specified, this command displays the usage. By default, frame forward option is disabled.
fcrBcastConfig To display the new configuration: fcr:admin> fcrbcastconfig --show Broadcast configuration is enabled for FID: 2 33 128 To disable broadcast frame forwarding for FID 33: fcr:admin> fcrbcastconfig --disable -f 33 To display the new configuration: switch:admin> fcrbcastconfig --show Broadcast configuration is enabled for FID: 2 128 SEE ALSO 266 bcastShow, portRouteShow Brocade Fabric OS Command Reference 53-1004112-02
fcrConfigure fcrConfigure Displays or sets FC Router configuration parameters. Synopsis fcrconfigure --bbfid fcrconfigure --enable -shortestifl fcrconfigure --disable -shortestifl fcrconfigure --add -alias Alias_name -fid FID fcrconfigure --delete -alias [FID | -all] fcrconfigure --resetphantomdomain [-force] fcrconfigure --show [-alias] fcrconfigure --help Description Use this command to change the backbone fabric ID, or to enable or disable the shortest inter-fabric link (IFL) mode.
fcrConfigure You should identify the FCIP links in the backbone fabric and then the direction of the FCIP path (across the backbone fabric) from the source to the destination edge fabric. Once the direction of the FCIP path is identified, set the cost of the FCIP link greater than or equal to 10000 by using the linkCost command. The link cost must be set for all FC Routers in the identified FCIP link path. Likewise, identify and set the cost for other FCIP paths of all destination edge fabrics.
fcrConfigure To display the current configuration: fcr:admin> fcrconfigure --show Backbone fabric ID: 32 Shortest IFL feature is disabled To assign a name to a FID: fcr:admin> fcrconfigure --add -alias Red_fabric -fid 10 To display a name associated to a FID: fcr:admin> fcrconfigure --show -alias FIDAlias ======================= 10Red_fabric To delete the name of a FID: fcr:admin> fcrconfigure --delete -alias 10 To reset all the phantom domain to the default range: fcr:admin> fcrconfigure --resetphanto
fcrEdgeShow fcrEdgeShow Displays the FIDs of all configured EX_Ports. Synopsis fcredgeshow fcredgeshow [-fid FabricID] fcredgeshow --help Description Use this command without operand to display information about all Fabric IDs (FIDs) that have been created on the chassis and are assigned to EX_Ports. When a FID is specified, fcredgeshow displays information for all EX_Ports configured with the specified FID. For each FID, the command output includes the following: FID Fabric ID of the EX_Port.
fcrEdgeShow Examples To display the EX_Ports configured in the switch: switch:admin> fcredgeshow FID EX-port E-port Neighbor Switch (PWWN, SWWN ) Flags ----------------------------------------------------------------25 1/13 244 20:f4:00:05:1e:38:a4:cb 10:00:00:05:1e:38:a4:cb FEC \ ENCRYPTION COMPRESSION 35 1/12 299 2e:2b:00:05:1e:40:44:02 10:00:00:05:1e:40:44:02 ENCRYPTION \ COMPRESSION 11 5/13 273 2e:11:00:05:33:b3:39:00 10:00:00:05:33:b3:39:00 FEC To display the EX_Ports configured with a specified FID
fcrFabricShow fcrFabricShow Displays the FC Routers on a backbone fabric. Synopsis fcrfabricshow fcrfabricshow --name fcrfabricshow --help Description Use this command to display information about FC Routers that exist in an FC Router backbone fabric. The existing syntax is maintained for IPv6 support. When IPv6 addresses are not configured, the output of fcrFabricShow displays the IPv4 format. Use the --name option to display the fabric name along with EX-port, FID, and switch name.
fcrFabricShow --help Displays the command usage. Examples To display the FC Routers in the backbone fabric: switch:admin> fcrfabricshow FC Router WWN: 10:00:00:05:1e:41:59:81, Dom ID: 2, Info: 10.33.36.8, "swd77" EX_Port FID Neighbor Switch Info (enet IP, WWN, name) -----------------------------------------------------12 5 10.33.35.81 10:00:00:05:1e:34:01:d0 "B10_4" FC Router WWN: 10:00:00:05:1e:41:1c:73, Dom ID: 4, Info: 10.33.36.
fcrIclPathBWMonitor fcrIclPathBWMonitor Sets or displays FC Router ICL bandwidth monitor parameters for EX_Ports. Synopsis fcriclpathbwmonitor --enable fcriclpathbwmonitor --disable fcriclpathbwmonitor --show fcriclpathbwmonitor --help Description Use this command to enable or disable the Inter Chassis Link (ICL) EX_Ports bandwidth Monitor feature on an FC Router, or to display the current status of ICL bandwidth feature and the ICL slot bandwidth assigned to connected edge fabrics.
fcrIclPathBWMonitor To display the current configuration: fcr:admin> fcriclpathbwmonitor --show ICL Path Bandwidth state :Enabled FABRIC SLOT-3 BW SLOT-6 BW STATE ======================================== 48 128 128 BALANCED 126 64 128 UNBALANCED SEE ALSO fosConfig, switchDisable, switchEnable, switchShow Brocade Fabric OS Command Reference 53-1004112-02 275
fcrLsan fcrLsan Configures and displays LSAN policies. Synopsis fcrlsan fcrlsan --add -enforce tag | -speed tag fcrlsan --remove -enforce tag | -speed tag fcrlsan --show -enforce | -speed | -all fcrlsan --help Description Use this command to add or remove LSAN tags, or to display existing tags in the configuration. LSAN tagging optimizes an FC Router's behavior based on a specified subset of LSANS.
fcrLsan --show Displays the specified tag from the LSAN tag configuration. --help Displays the command usage. -enforce tag Accepts only the LSANs from the edge fabric that matches the specified tag string into the local FCR database. A valid tag is a string of a maximum of eight characters. The maximum configurable enforced tags is eight. -speed tag Allows the FCR to always import these target devices to the hosts specified in the LSANs that match the speed tag. Only one speed tag is allowed per FC router.
fcrLsan switch:admin> fcrlsan --show -all Total LSAN tags : 3 ENFORCE : brocade ENFORCE : cisco SPEED: mcdt SEE ALSO 278 fcrFabricShow, lsanZoneShow, fcrPhyDevShow, fcrProxyDevShow, fcrRouteShow, switchShow Brocade Fabric OS Command Reference 53-1004112-02
fcrLsanCount fcrLsanCount Displays or sets the maximum LSAN count. Synopsis Description fcrlsancount [max_lsan_count] Use this command to set or display the maximum number of LSAN zones that can be configured on the edge fabric. By default, the maximum LSAN count is set to 3000, which is also the minimum. This command allows you to create up to 5000 LSAN zones in the backbone fabric, if needed to support additional devices. The maximum number of supported LSAN devices is 10,000.
fcrLsanMatrix fcrLsanMatrix Creates, modifies, and displays the LSAN fabric matrix or the FCR matrix.
fcrLsanMatrix Once a fabric is removed from an FCR, the communication with other fabrics of the two FCRs is also removed. It is advisable to update the matrix to reflect the change. If FCR Binding is enabled in the edge fabrics, the edge fabrics can still communicate with the backbone fabric. The LSAN matrix provides a higher level of granularity than the FCR matrix. Therefore, communication between two fabrics could pass the FCR matrix, but fail due to restriction of the FID matrix.
fcrLsanMatrix Corrective actions: • Any new router added to the backbone fabric automatically triggers a matrix merge. If a router does not support the matrix merge feature, the router cannot join the backbone fabric. Make sure that all legacy FCR switches in the backbone support the matrix merge feature, otherwise the feature is not supported. • Use fcrlsanmatrix --fabricview -lsan | -fcr to confirm that all the switches in the backbone have the same LSAN and FCR Binding matrix.
fcrLsanMatrix To display the information from the cache: switch:admin> fcrlsanmatrix --display -lsan Fabric ID 1 Fabric ID 2 ----------------------------------4 5 4 7 10 19 To apply the changes persistently: switch:admin> fcrlsanmatrix --apply -lsan To view the persistent changes: switch:admin> fcrlsanmatrix -lsan LSAN MATRIX is activated Fabric ID 1 Fabric ID 2 -------------------------------------4 5 4 7 10 19 To view the LSAN Zone static and default/dynamic binding in the backbone where online fabric
fcrLsanMatrix 82 10:00:00:06:2b:0d:29:30 82 10:00:00:06:2b:0d:2f:ed 82 10:00:00:06:2b:0d:33:4d 82 10:00:00:06:2b:0e:4d:c9 Total devices displayed: 12 01f002 03f002 01f001 03f001 78 52 78 52 4e1400 480200 4e1800 482000 Imported Imported Imported Imported To display the information from the cache: switch:admin> fcrlsanmatrix --display -lsan Fabric ID 1 Fabric ID 2 -------------------------------------52 78 52 82 78 82 To apply the changes persistently: switch:admin> fcrlsanmatrix --apply -lsan To view
fcrLsanMatrix To apply the changes persistently: switch:admin> fcrlsanmatrix --apply -fcr To view the persistent changes: switch:admin> fcrlsanmatrix --fabricview -fcr SAVED FCR PAIRS =================================== FCR FCR ----------------------------------------------------10:00:00:60:69:e2:09:fa (2) 10:00:00:60:69:e2:09:fb (unknown) SEE ALSO fcrFabricShow, lsanZoneShow, fcrPhyDevShow, fcrProxyDevShow, fcrRouteShow, switchShow Brocade Fabric OS Command Reference 53-1004112-02 285
fcrPhyDevShow fcrPhyDevShow Displays the FC Router physical device information. Synopsis Description fcrphydevshow [-a][-f FID][-w wwn][-c][-d] [-h] Use this command to display the physical (real) devices that are configured to be exported to other fabrics. A device is considered to be configured to be exported to another fabric if it is a member of an LSAN zone.
fcrPhyDevShow -d Displays the following login-related counters. Counters are cleared upon reboot or failover. login try The number of times the device attempted to log in. local failure the number of times the device login failed because of missing LSAN zones within the device fabric. remote failure the number of times the device login failed due to missing LSAN zones within the remote fabric. -h Displays command usage.
fcrProxyConfig fcrProxyConfig Displays or configures proxy devices presented by an FC Router. Synopsis Description fcrproxyconfig [-s importedFID devWWN slot] [-r importedFID devWWN] Use this command to display or set the persistent configuration of proxy devices presented by the local FC Router. When used without operand, this command displays the persistent proxy device configuration; otherwise, it sets the specified attributes to its new value.
fcrProxyConfig If no proxy device WWN is stored in any slot for all edge fabrics, the following message is displayed: "All slots empty." Notes Operands The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
fcrProxyDevShow fcrProxyDevShow Displays FC Router proxy device information. Synopsis Description fcrproxydevshow [-a][-f fabricid][-w wwn] Use this command to display the proxy devices presented by FC Router EX_Ports and information about the proxy devices. A proxy device is a virtual device presented in to a fabric by an FC Router. A proxy device represents a real device on another fabric.
fcrProxyDevShow Notes Operands The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. This command has the following operands: -a Display all proxy devices for all FC Routers in the same backbone fabric whether or not they are relevant to this FC Router.
fcrResourceShow fcrResourceShow Displays FC Router physical resource usage. Synopsis Description fcrresourceshow Use this command to display the FC Router-available resources. The maximum number allowed versus the currently used is displayed for various resources. The command output includes: LSAN Zones The maximum versus the currently used LSAN zones. LSAN Devices The maximum versus the currently used LSAN device database entries. Each proxy or physical device constitutes an entry.
fcrResourceShow Notes Only configured EX/VEX_Ports are displayed The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
fcrRouterPortCost fcrRouterPortCost Displays or sets an FC Router port cost. Synopsis Description fcrrouterportcost [[slot/]port] [cost] Use this command to set or display the cost of the FC Router ports. You can set the cost of the link to one of two fixed values: 1000 or 10000. The option 0 sets the cost of the link to the default value based on link type (EX/VEX). The router module chooses the router port path based on the minimum cost per fabric ID (FID) connection.
fcrRouterPortCost Examples To display the cost of all EX_Ports: switch:admin> fcrrouterportcost Port Cost -----------------------7/3 1000 7/4 1000 7/9 1000 7/10 1000 7/16 10000 10/0 10000 To display the cost on an EX_Port: switch:admin> fcrrouterportcost 7/10 0 switch:admin> fcrrouterportcost 7/10 Port Cost -----------------------7/10 1000 To set the cost of an EX_Port and display the result: switch:admin> fcrrouterportcost 7/10 10000 switch:admin> fcrrouterportcost 7/10 Port Cost ----------------------
fcrRouteShow fcrRouteShow Displays FC Router route information. Synopsis Description fcrrouteshow Use this command to display routes through the FC Router backbone fabric to accessible destination fabrics. An FC Router backbone fabric is the fabric that contains the E_Ports of this platform and routes inter-fabric traffic between imported fabrics, creating a meta-SAN. There are FC Router ports that reside on the backbone fabric. These ports are known as NR_Ports.
fcrRouteShow Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. Operands None Examples To display the route information: switch:admin> fcrrouteshow Destination NR_Port FCRP Cost WWN of Principal Fabric Id PID Switch in the Dest.
fcrXlateConfig fcrXlateConfig Configures a translate (xlate) domain's domain ID and state of persistence for both the EX_Port-attached fabric and the backbone fabric.
fcrXlateConfig Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. Information displayed is not related to the entire backbone. The FC Router displays only connections to an edge fabric for which there are translate domain IDs. Any changes you intend to make using this command should be issued on the switches to which the edge fabrics are directly attached.
fcrXlateConfig --show stalexd [importedFID] Displays stale translate domains associated with the specified Fabric ID (1-128). A translate domain becomes stale when the remote edge fabric for which this translate domain was created in the specified edge fabric becomes unreachable. When issued without specifying an imported FID, this command lists all stale translate domains in all edge fabrics connected to the FCR.
fcrXlateConfig To remove the stale translate domain (only the translate domain owned by the current owner can be removed; note that trailing zeros must be removed from the FID and Xlate domain ID.
fddCfg fddCfg Manages the fabric data distribution configuration parameters. Synopsis fddcfg --showall fddcfg --localaccept policy_list fddcfg --localreject policy_list fddcfg --fabwideset policy_list Description Use this command to manage the fabric data distribution configuration parameters. These parameters control the fabric-wide consistency policy. Switches can be locally configured to allow or reject a security policy.
fddCfg --localaccept policy_list Configures the switch to accept distributions of the specified policies. The policies in policy_list must be separated by semicolons and enclosed in quotation marks; for example, "SCC;DCC;FCS". --localreject policy_list Configures the switch to reject distributions of the specified policies in policy_list. However, a database cannot be rejected if it is specified in the fabric-wide consistency policy.
fdmiCacheShow fdmiCacheShow Displays abbreviated remote FDMI device information, according to remote domain ID. Synopsis Description fdmicacheshow Use this command to display FDMI cache information for remote domains only. The state of each remote domain, identified by its domain ID, is shown to be unknown, known, unsupported, or error. The revision of the switch also displays, followed by the world wide name of the switch. For HBAs, only the HBA identifiers and registered port lists are displayed.
fdmiShow fdmiShow Displays detailed FDMI information. Synopsis fdmishow [-hexoutput] fdmishow --help Description Use this command to display Fabric-Device Management Interface (FDMI) information for all Host Bus Adapters (HBAs) and ports. Detailed FDMI information is displayed for local HBAs and ports. Only abbreviated FDMI information is shown for HBA and ports on remote switches. Notes Operands The execution of this command is subject to Virtual Fabric restrictions that may be in place.
fdmiShow Model: Brocade-1860-2p Model Description: Brocade-1860-2p Hardware Version: Rev-A Driver Version: 3.2.0.0705 Option ROM Version: 3.2.0.0_alpha_bld02_20120831_0705 Firmware Version: 3.2.0.0_alpha_bld02_20120831_0705 OS Name and Version: Windows Server 2008 R2 Standard | N/A Max CT Payload Length: 0x00000840 Symbolic Name: Brocade-1860-2p | 3.2.0.0705 | X3650050014 | Number of Ports: 2 Fabric Name: 10:00:00:05:1e:e5:e8:00 Bios Version: 3.2.0.
fdmiShow Hardware Version: Rev-A Driver Version: 3.2.0.0705 Option ROM Version: 3.2.0.0_alpha_bld02_20120831_0705 Firmware Version: 3.2.0.0_alpha_bld02_20120831_0705 OS Name and Version: Windows Server 2008 R2 Standard | N/A Max CT Payload Length: 0x00000840 Symbolic Name: Brocade-1860-2p | 3.2.0.0705 | X3650050014 | Number of Ports: 2 Fabric Name: 10:00:00:05:1e:e5:e8:00 Bios Version: 3.2.0.
femDump femDump Collects limited debug information to a remote directory through FTP, SFTP, or SCP. This command is a minimal version of supportsave command. Synopsis Description femdump [-u user_name -p password -h host_ip -d remote_dir -l protocol] Use this command to collect limited debug information to a remote directory through FTP or SCP. This command is a minimal version of a supportsave command. The files generated by this command are compressed before being sent off the switch.
femDump If you plan to use SCP to transfer files, it is important to test the command prior to its use with various SCP-mode services. Because the femDump command makes several access requests to copy files, it is important that the SCP-mode service be configured so that passwords are not required for each attempted transfer. Failure to configure the service correctly may result in significant delays in obtaining transferred output from the femDump command.
ficonCfg ficonCfg Configures the specified FICON database. Synopsis ficoncfg --set database port ficoncfg --reset database ficoncfg --help Description Use this command to configure a FICON database on a specified port. Refer to ficonShow for a description of the database content. Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
ficonCfg To set the LIRR database using a hexadecimal index number that contains the Area field (middle byte) of the three-byte Fibre Channel Port Address: switch:user> ficoncfg --set LIRR 0x1b switch:user> ficonshow LIRR The Local LIRR database has 0 entries.
ficonClear ficonClear Clears the records from the specified FICON database. Synopsis Description Notes Operands ficonclear database Use this command to remove records from the local FICON database. The command effect depends on the specified database. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
ficonCupSet ficonCupSet Sets FICON-CUP parameters for a switch. Synopsis ficoncupset fmsmode enable | disable | reset ficoncupset modereg bitname 0 | 1 ficoncupset MIHPTO seconds ficoncupset CRP PID CHID Description Use this command to set FICON-CUP (Control Unit Port) parameters for a switch. All parameters can be set while the switch is online. Changes made by this command take effect immediately. A reboot is not required. Use ficonCupShow to display current settings.
ficonCupSet ASM Active=saved mode DCAM Director clock alert mode ACP Alternate control prohibited HCP Host control prohibited MIHPTO Sets the missing interrupt handler primary timeout (MIHPTO) value for the CUP. The following operand is required: seconds Specifies the timeout value in seconds. Provide a decimal value in the range between 15 and 600 seconds. The default timeout value is 180 seconds.
ficonCupSet To display the current reporting path: switch:admin> ficoncupshow LP FICON CUP Logical Paths for CUP 0x08FE00 PID -----082300 082300 082300 082400 082400 612400 612400 LP CHID ---1A 1B 1C 1A 1B 1E 1F Reporting State ---Oper*** Oper Oper Reset Reset Reset Reset Path -----Curr Prim To reset the FMS mode for a switch: switch:admin> ficoncupset fmsmode reset FMS_001(I) - FMSMODE RESET completed - FMSMODE(Disabled) Conditions prior to reset: All CUP states nominal, no conditions reset ----- EN
ficonCupShow ficonCupShow Displays FICON-CUP parameters for a switch. Synopsis ficoncupshow fmsmode ficoncupshow modereg [bitname] ficoncupshow MIHPTO ficoncupshow DD_LOG ficoncupshow diag_info ficoncupshow hlthchk_log ficoncupshow LP Description Notes Operands Use this command to display FICON-CUP (Control Unit Port) parameters for a switch. The execution of this command is subject to Virtual Fabric restrictions that may be in place.
ficonCupShow HCP Host control prohibited MIHPTO Displays the FICON-CUP missing interrupt handler primary timeout (MIHPTO) value in seconds. DD_LOG Displays the latest Director Diagnostics Log.
ficonCupShow To display the logical paths for the switch: switch:user> ficoncupshow LP FICON CUP Logical Paths for CUP 0x08FE00 LP Operational Reporting PID CHID State Path State ------ -----------082300 1A Oper*** Current 082300 1B Oper 082300 1C Oper 082400 1A Reset 082400 1B Reset 612400 1E Reset Primary 612400 1F Reset SEE ALSO 318 ficonCupSet, ficonHelp Brocade Fabric OS Command Reference 53-1004112-02
ficonHelp ficonHelp Displays a list of FICON support commands. Synopsis Description Notes ficonhelp Use this command to display a list of FICON support commands with descriptions. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
ficonShow ficonShow Displays the contents of the specified FICON database. Synopsis Description ficonshow database [fabric | table | port port_index] Use this command to display the contents of a FICON database. The ficonShow database operand is the name of the database to display. If the fabric operand is absent, the command displays the members of the named database that are local to the switch on which the command was issued.
ficonShow Blower [unit number] The Blower FRU Part Number Displays the FRU part number. FRU Serial Number Displays the FRU serial number. Incident Count Displays the incident count. This number increases by 1 for each incident within the individual switch. Link Incident Description Same as Link Incident Type.
ficonShow Byte BB 0x0a Switch Byte CC 0x00 Port number. It is dynamically assigned whenever a link incident occurs. Parm Displays the incident node parameters type in three bytes, 0xAABBCC: Byte AA Possible values include the following: 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. 0xe0 Vendor-specific.
ficonShow 0x06 Controller, if it is a storage port; otherwise, a reserved field for a channel port. 0x07 Terminal - Full screen if it is a storage port; otherwise, a reserved field for a channel port. 0x08 Terminal - Line mode if it is a storage port; otherwise, an emulated control unit support only. 0x09 Reserved. 0x10 Switch, if it is a switch device; otherwise, reserved. 0x0b-0xff Reserved. Byte CC Possible values include the following: 0x00 If storage CU port has registered with the switch.
ficonShow N N_Port NL NL_Port Protocol Displays whether the traffic is using FICON or FCP. Registered Node WWN Displays the device's node world wide name associated with the device HBA. Registered Port WWN Displays the device's channel or storage CU port world wide name associated with the device HBA. 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.
ficonShow LIRR Devices registered to receive link incident reports. Entries can have the following flags: -C* A user-configured LIRR entry defined as current (set with the ficonCfg command). -C A LIRR entry defined by the management server demon as current based on order. -S A LIRR entry defined by the management server demon as secondary. SwitchRNID Switch node identification. RLIR Link incident reports. ILIR Implicit link incident reports. fabric Displays FICON database information for the entire fabric.
ficonShow Plant of Manufacture: 02 Sequence Number: 0000000169CA tag: 052e } } To display the local RNID database in tabular format: switch:admin> ficonshow RNID table { Fmt Type PID Registered Port WWN Registered Node WWN 0x18 N 252500 50:05:07:60:28:bf:42:cf 50:05:07:64:00:cd:01:b6 0x18 N 255800 50:05:07:60:28:bf:3e:98 50:05:07:64:00:cd:01:b6 0x18 N 255A00 50:05:07:60:28:bf:2c:9e 50:05:07:64:00:cd:01:b6 0x18 N 255B00 50:05:07:60:28:bf:3f:0b 50:05:07:64:00:cd:01:b6 0x18 N 255C00 50:05:07:60:28:bf:3f:0a 5
ficonShow To display the local LIRR database: switch:admin> ficonshow LIRR {Fmt Type PID Listener Port WWN 0x18 N 255800 50:05:07:60:28:bf:3e:98 0x18 N 255a00 50:05:07:60:28:bf:2c:9e 0x18 N 255b00 50:05:07:60:28:bf:3f:0b 0x18 N 255c00 50:05:07:60:28:bf:3f:0a 0x18 N 255d00 50:05:07:60:28:bf:2c:9f 0x18 N 255e00 50:05:07:60:28:bf:18:63 0x18 N 255f00 50:05:07:60:28:bf:18:64 Switch Port WWN 20:58:00:05:33:0d:b7:05 20:5a:00:05:33:0d:b7:05 20:5b:00:05:33:0d:b7:05 20:5c:00:05:33:0d:b7:05 20:5d:00:05:33:0d:b7:05 20
ficonShow To display the local RLIR database: switch:user> ficonshow RLIR { {Fmt Type PID Port Incident Count TS Format Time Stamp 0x18 N 502e00 46 1 Time server Mon Jan 13 04:29:33 2003 Port Status: Link not operational Link Failure Type: Loss of signal or synchronization Registered Port WWN Registered Node WWN Flag Node Parameters 50:05:07:64:01:40:0f:ca 50:05:07:64:00:c1:69:ca 0x50 0x200105 Type Number: 002064 Model Number: 101 Manufacturer: IBM Plant of Manufacture: 02 Sequence Number: 0000000169CA tag
fipsCfg fipsCfg Configures FIPS (Federal Information Processing Standards) mode. Synopsis fipscfg --enable [fips | selftests | bootprom | dh | sha256] [-nowarn] [-dp] [enable | disable] fipscfg --disable [selftests | bootprom | dh | sha256] [-nowarn] [-dp] [enable | disable] fipscfg --zeroize [-nowarn] [-dp] fipscfg --show | --showall fipscfg --force fips [-dp] fipscfg --verify fips [-dp] Description Use this command to configure FIPS mode on the switch.
fipsCfg --enable [fips | selftests] [-nowarn] Enables FIPS or selftests mode. Selftests must be enabled before FIPS mode is enabled. --zeroize [-nowarn] [-dp] Erases all passwords, shared secrets, private keys, etc. in the system. Specify the -dp option to zeroize both CP and dual-CP. --show | --showall Displays the current FIPS configuration.
fipsCfg To verify FIPS prerequisites: switch:admin> fipscfg --verify fips Standby firmware supports FIPS - PASS SELF tests check has passed - PASS Root account is enabled - FAIL Radius check has passed - PASS Authentication check has passed - PASS Inflight Encryption check has passed - PASS IPSec check has passed - PASS Telnet port number <23> for the policy is in permit state. HTTP port number <80> for the policy is in permit state.
fipsCfg Telnet port number <23> for the policy \ is in permit state. HTTP port number <80> for the policy \ is in permit state. RPC port number <898> for the policy \ is in permit state. Telnet port number <23> for the policy \ is in permit state. HTTP port number <80> for the policy \ is in permit state. RPC port number <898> for the policy \ is in permit state. SNMP is not in read only mode.
fipsCfg Operation cancelled. Zeroizing Radius configuration: RADIUS configuration does not exist. LDAP configuration does not exist. Zeroizing IPSec static SA configuration. Zeroizing SSH key. Permission denied to perform this operation. Failed to zeroize SSH public key. switch:admin> To disable bootprom: switch:root> fipscfg --disable bootprom You are disabling bootprom. Do you want to continue? (yes, y, no, n) [no] : no Operation cancelled.
firmwareActivate firmwareActivate Activates switch firmware. Synopsis firmwareactivate firmwareactivate [-l | -local] firmwareactivate --help Description Use this command to activate the firmware that has been downloaded to the secondary partition using the firmwareDownload -r command. This command swaps partitions and reboots the system to activate the new image. Execute this command with the -local or -l option to activate the firmware on a local control processor (CP).
firmwareCheck firmwareCheck Performs firmware integrity test. Synopsis firmwarecheck Description Use this command to check the integrity of software image that is stored on a switch. This command also detects the files whose checksum has changed. The firmware integrity test fails if the files or packages are modified manually. Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
firmwareCleanInstall firmwareCleanInstall Recovers the switch firmware. Synopsis firmwarecleaninstall firmwarecleaninstall [-p | -protocol protocol] [host,user,path,passwd] firmwarecleaninstall --help Description Use this command to initiate a clean reinstall of the firmware in cases where the loaded firmware does not function correctly, the normal firmware download fails, or to recover from a rolling reboot situation.
firmwareCleanInstall Examples To perform a clean firmware install interactively: switch:admin> firmwarecleaninstall Server Name or IP Address: 10.10.2.10 User Name: admin File Name: /admin/dist/FOS7.4.0/ Network Protocol(1-FTP, 2-SCP, 3-SFTP) [1]: 1 Password: This command will erase all the data on the Compact Flash before installing a new firmware. There are also disruptive reboots during the process.
firmwareCommit firmwareCommit Commits switch firmware. Synopsis Description firmwarecommit Use this command to commit a firmware download to a CP. This command copies an updated firmware image to the secondary partition and commits both partitions of the CP to an updated version of the firmware. This must be done after each firmware download and after the switch has been rebooted and a sanity check is performed to make sure the new image is fine.
firmwareDownload firmwareDownload Downloads firmware from a remote host, a local directory, or a USB device.
firmwareDownload Notes Firmware download and subsequent POST failure may occur on some platforms, if the firmware commit operation coincides with the execution of POST. The recommended work around is to disable POST (diagDisablePost) before you initiate a firmware download and re-enable POST (diagEnablePost) after the firmware commit operation has completed. Firmware download procedures may vary depending on which Fabric OS version you are migrating from.
firmwareDownload user Specify a user name for FTP or SSH server access. This operand can be omitted, if the firmware is accessible on a local directory, a USB device, or by anonymous FTP server access. A user name other than "anonymous" is required for SSH server access. path Specify a fully qualified path for the firmware. Absolute path names may be specified using forward slashes (/). password Specify a password.
firmwareDownload Diagnostics The command checks the network connection and other system parameters before initiating firmwareDownload. It may fail if at least one of the following conditions is encountered: • • • • • • • The host is not reachable from the switch. • The USB device is not enabled. Use the usbStorage command on the switch to enable the USB device. On enterprise-class platforms, the command must be run on the Active CP to enable the USB device.
firmwareDownload To download firmware without a password using public key authentication: switch:admin> firmwaredownload Server Name or IP Address: 10.38.17.17 User Name: admin File Name: /users/home25/admin/dist Network Protocol(1-auto-select, 2-FTP, 3-SCP, 4-SFTP) [1]: 3 Verifying if the public key authentication is available. Please wait ...Success. Do Auto-Commit after Reboot [Y]: y Reboot system after download [N]: y Server IP: 10.38.17.17, Protocol IPv4 Checking system settings for firmwaredownload..
firmwareDownloadStatus firmwareDownloadStatus Displays the status of a firmware download. Synopsis firmwaredownloadstatus Description Use this command to display an event log that records the progress and status of events during a firmware download. The event log is created by the firmware download process and is kept until you issue another firmwareDownload command. A timestamp is associated with each event.
firmwareDownloadStatus 10 minutes. [5]: Fri Mar 25 16:58:44 2011 Slot 7 (CP1, standby): Firmware commit operation has started to restore the secondary partition. [6]: Fri Mar 25 16:58:45 2011 Slot 7 (CP1, standby): The firmware commit operation has started. This may take up to 10 minutes. [7]: Fri Mar 25 17:05:34 2011 Slot 7 (CP1, standby): The commit operation has completed successfully.
firmwareKeyShow firmwareKeyShow Displays the public key used for signed firmware validation. Synopsis Description Notes firmwarekeyshow This command displays the contents of the public key used for validating the integrity of firmware images when signed firmware validation is enabled. A firmware key should be installed on every switch as a part of the Fabric OS installation. The presence of a firmware key does not imply that the firmware signature is checked during firmwareDownload.
firmwareRestore firmwareRestore Restores the former active firmware image. Synopsis Description firmwarerestore Use this command to restore the former active Fabric OS firmware image. This command can only be run if autocommit was disabled during the firmwareDownload process. After a firmwareDownload and a reboot (with autocommit disabled), the downloaded firmware becomes active. If you do not want to commit the firmware and want to restore the former firmware, issue the firmwareRestore command.
firmwareShow firmwareShow Displays the firmware version and download history. Synopsis firmwareshow firmwareshow --history firmwareshow --help Description Use this command to display the firmware versions and the firmware download history. The command shows the firmware versions on both the primary and secondary partitions of the storage device. When this command is issued while a firmware download is in process, an appropriate warning message is displayed.
firmwareShow To display the firmware download history: switch:admin> firmwareshow --history Firmware version history SEE ALSO Sno Date & Time Switch Name Slot PID 1 Fri Feb 18 12:58:06 2011 CDCX16 7 1556 FOS Version Fabos Version v7.0.0d 2 Wed Feb 16 07:27:38 2011 Fabos Version v7.0.
firmwareSync firmwareSync Synchronizes the firmware from the active control processor (CP) to the standby CP. Synopsis firmwaresync [-force] firmwaresync --help Description Notes Use this command to manually synchronize the firmware from the active CP to the standby CP. Execute the command without arguments to synchronize the active CP firmware to the standby CP. This command is applicable only for the dual CP systems.
flow flow Creates, manages, and displays flows in Flow Vision.
flow Notes This command requires a Fabric Vision license. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. Function Creating a flow Synopsis flow --create flow_name -feature feature_list port_options frame_options [config_options] Description Use this command to create a flow and by default activate the flow for the specified features.
flow The following configuration considerations apply for the Flow Monitor feature: • • • • • • • The ingress port and egress port can be an SIM Port, F_Port, E_Port, or EX_Port (Gen 5 or later) on the local switch. The ingress port must be a Gen 5 or later port and egress port can be a Gen 4, Gen 5 or later port. The SIM Port must be a Gen 5 or later port. VE_Port, VEX_Port, FCoE ports, and GigE are not supported.
flow The following configuration considerations apply for the Flow Mirror feature: • • • • • • The ingress port or the egress port must be an F_Port, which is 8G or less, on the local switch. The Flow Mirror feature is supported only on Gen 5 or later ports. EX_Ports, XISL ports, DISL ports, E_Ports, trunked E_Ports, and trunked F_Ports are not supported. AG mode is not supported. The Flow Mirror feature is not supported on SIM ports.
flow -frametype type Specifies the predefined frame type. Valid values for type include the following: SCSI, SCSIRead, SCSIWrite, SCSIRW, SCSI2Reserve, SCSI3Reserve, scsicmdsts, ABTS, BAACC, SCSI2Release, SCSI3Release, SCSITur, SCSI2ReserveRelease, SCSI3ReserveRelease, SCSIGoodStatus, SCSICheckStatus, SCSIResvConflict, SCSIInquiry, SCSIXferrdy, Srr, and BARJT. This operand is not supported by the Flow Generator feature. config_options Specifies the flow configuration options.
flow To create a flow to monitor bidirectional traffic from a particular source to destination: switch:admin> flow --create endtoendflow -feature monitor -ingrport 2/5 -srcdev 010500 -dstdev 040900 -bidir To create a flow to monitor traffic from source devices to destination devices in learning mode: switch:admin> flow --create flowLearn -feature monitor -ingrport 3/5 -srcdev "*" -dstdev "*" To create a flow to mirror ingress and egress traffic flowing through a port to an embedded port: switch:admin> fl
flow feature_list Specifies a comma-separated list of features to activate for a flow. Specify "all" to activate all features for a flow. Valid values for feature_list include the following: monitor, generator, and mirror.
flow Description Operands Use this command to modify the port or device addressing mode and to change the control parameters of a flow or features. The --control command has the following operands: flow_name Specifies the flow name. Specify "all" to modify the control parameters for all flows. If a flow name is not specified, the default values of the control parameters, -size and -pattern will be modified; the flows which are already present does not intake the modified control parameters.
flow The following operands are specific to the flow mirror feature. You can use these operands only if the Flow Mirror feature is not activated for a flow. The flow name is not required for enabling or disabling this option. -enable_wrap Enables the wrapping of mirrored frame logs. This is the default value. The Flow Mirror flow must be deactivated before using this command. The statistics of the Flow Mirror flow are reset during this operation. -disable_wrap Disables the wrapping of mirrored frame logs.
flow port_options Specifies the options to configure the ingress or mirror port. -ingrport port Specifies the ingress port. The port can be in either [slot/]port or D,I (Domain, Index) format depending on the port mode configured using the -portIdMode operand, or a wildcard (*). -mirrorport port Specifies the port from which mirrored frames exits. The port must be in the D,I (Domain, Index) format.
flow Description Displays the flow definitions and frame statistics. When used without operand, the --show command displays the list of all flows configured in Flow Vision. The show on demand feature allows you to display the statistics of the features without creating a flow. To display the statistics of the features without creating a flow, you must specify the operands without a flow name and provide a flow definition.
flow -srcdev device_id Specifies the 3-byte source ID of the originator device. The device_id can be in PID or PWWN format depending on the device ID mode configured using the -deviceIdMode operand. The PID format is 0xDDAAPP, where DD is the Domain ID, AA is the Area ID and PP is the AL_PA ID. The PWWN format is "XX:XX:XX:XX:XX:XX:XX:XX". Specify "*" to enumerate all originator devices. -dstdev device_id Specifies the 3-byte destination ID of the destination device.
flow -increase [count] Displays the monitoring statistics in ascending order based on the throughput. The count parameter is optional and it can be used to specify the number of entries to be displayed. This operand is supported only with the monitor feature. -decrease [count] Displays the monitoring statistics in descending order based on the throughput. The count parameter is optional and it can be used to specify the number of entries to be displayed.
flow To display the statistics of the Flow Monitor feature: switch:admin> flow --show myflow1 -feature monitor ======================================================================== Name : myflow1 Features: mon(Activated) Definition: IngrPort(10),SrcDev(0x020a00),DstDev(0x030000) Flow Monitor (Activated): Monitor time: | Tue Jun 25 04:20:06 PDT 2013 | -------------------------------------------------------------------------------------------------------------------------------| Frame Count | Frames Per S
flow Monitor time: | Thu Jun 06 15:15:39 UTC 2013 | ------------------------------------------------------------------------------------------------------------------------------ \ | Frame Count | Frames Per Sec. | Byte count \ | Tx / Rx / Total | Tx / Rx / Total | Tx / Rx / Total \ ---------------------------------------------------------------------- \ | 2.92M/ 2.96M/ 5.88M | 159.31k/161.78k/321.10k | 5.99G/ 5.99G/ 11.99G \ ---------------------------------------------------------------------- \ --------
flow To display the statistics for the Flow Mirror feature in learning mode: switch:admin> flow --show mirFlow -feature mirror Name : mirFlow Features: mir(Activated) Definition: EgrPort(17),DstDev(0x051100),BiDir Flow Mirror: ------------------------------------------------------------ \ | SID(*) | DID(*) | OXID | RXID | SOF | EOF | Frame_type \ ------------------------------------------------------------ \ | 051600 | 051100 | 0883 | ffff | SOFi3 | EOFt | SCSIRead \ | 051600 | 051100 | 0191 | 0bce | SOFn3
flow To display all the zoned devices for a flow: switch:admin> flow --create flow3 -fe mon -src "*" -dst 0x190b00 -egr 11 switch:admin> flow --show flow3 -allzoned Active Flows: ------------------------------------------------------| SrcDev | DstDev | ------------------------------------------------------| 0x21400 0x21e00 0x21f00 0x31000 0x31100 | 0x190b00 | ------------------------------------------------------- To display the statistics for the Flow Mirror feature in verbose mode: switch:admin> flow --
flow To display the SCSI frame statistics for the Flow Monitor feature: switch:admin> flow --show scsicsflow -feature monitor ------------------------Frame Statistics ----------------------------------------| Tx Frames Count | Tx Frames per Sec. | ----------------------------------------| 238 | 5 | ----------------------------------------- To display the control parameters: switch:admin> flow --show -ctrlcfg SimPort Information -----|------|--------|-------------------------|----------------- \ Slot | Por
flow SwitchDomain Name: sw0 Model FirmwareVersion OperationalStatus RebootReason Fenced Ports Decommissioned Ports Quarantined Ports MAPS violation: --------------Port Health(24) Port Health(15) |6 |2 : : : : : : : : 3 (0x3) 121.3 Uptime: (41 days 0 hrs 02 mins) v8.0.
flow |Ingr(*)|SID(*)|DID(*)| Rx Frames Count | Rx Frames per Sec. | Throughput(Bps) | Avg Rx Frm Sz(Bytes)| Rx Bytes Count | Rx -------------------------------------------------------------------------------------------------------------------------|13 |010d00|010a00| 2.26M | 377.30k | 1.51G | 259.38M | 720 | |14 |010e00|010d00| 1.98M | 330.81k | 1.74G | 298.36M | 948 | |18 |011200|010c00| 2.28M | 381.04k | 1.76G | 300.72M | 828 | |20 |011400|011200| 1.89M | 315.93k | 1.78G | 303.
flow 06(1) ITW 32(11) 33(3) 34(3) 35(3) 06(1) 47(20) 46(5) 35(1) - 35(7) 32(8) 33(3) 34(3) 35(3) 45(2300) 40(2282) 44(2276) 41(2269) 45(539) 40(522) 41(519) 44(517) 32(3) 33(1) 34(1) 35(1) 0(1) - 32(21) 33(7) 34(7) 35(7) Function Deleting a flow Synopsis flow --delete flow_name Description Operands Use this command to delete the specified flow from Flow Vision. All the data associated with the flow will be cleared.
flow --delete --control --reset --activate --deactivate --show [flowname] [-feature ] [-deviceIdMode | -portIdMode ] [-simport -enable/-disable] [-size | -pattern ] [-enable_wrap/-disable_wrap] -feature -feature -feature [flowname] [-feature ] [ ] [-count | -time | -verbose] [-sortby ] [-ctrlcfg] To display the command
fosConfig fosConfig Displays or modifies Fabric OS features. Synopsis fosconfig --enable feature fosconfig --disable feature fosconfig --show Description Use this command to enable or disable a feature, or to display the current operating status of features on a switch. This command can be run while the switch is online.
fosConfig --disable feature Disables a feature on the switch. Valid values for feature include the following: fcr Disables the FC Routing service on the switch. All enabled EX_Ports and VEX_Ports on the switch must be offline for this command to succeed. To use this command to disable the FC Routing service only instead of disabling the switch, issue this command, then change the BB fabric ID using fcrConfigure.
fosConfig 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 To enable the Ethernet Switching service: switch:admin> fosconfig --enable ethsw WARNING: This operation will enable the \ Ethernet Switch Service on this switch. Would you like to continue [Y/N]: y Enabling the Ethernet Switch Service. Please wait ... Create Ethernet switch instance 0 All service instances in sync.
fosExec fosExec Executes any Fabric OS command on a specified remote domain or logical switch context or on all remote domains or logical switches. Synopsis fosexec --fid FID -cmd "cmd [args]" fosexec --fid all [-force] -cmd "cmd [args]" fosexec --domain DID -cmd "cmd [args]" fosexec --domain all -cmd "cmd [args]" Description Use this command to execute any Fabric OS command on a specified remote domain or logical switch context or on all remote domains or logical switches.
fosExec -force Executes the specified command on all logical switches in your permission list without prompting for confirmation. --domain DID Specifies the Domain ID of the remote switch for which the command is executed. --domain all Executes the specified command on all switches in the fabric.
fosExec To display the firmware version for all logical switches: switch:user> fosexec --fid all -cmd "firmwareshow -v" LF permission does not exist for one or more \ logical switches. Would you like to continue [Y/N] : y -----------------------------------------"firmwareshow" on FID 10: Appl Primary/Secondary Versions -----------------------------------------FOS v7.0.0 v7.0.
fosExec Domain 4 ========= Switch ID Worldwide Name Enet IP Addr FC IP Addr Name ------------------------------------------------------------------------3: fffc03 10:00:00:05:1e:61:28:0a 10.17.33.66 0.0.0.0 >"TOM-1" 4: fffc04 10:00:00:05:1e:61:28:22 10.17.33.68 0.0.0.
frameLog frameLog Displays information about discarded frames.
frameLog SFID Source Fabric ID DFID Destination Fabric ID Type Reason for the frame discard. Frames can be discarded for a variety of reasons. The discard reasons currently handled by the frame log are timeout, unroute, and du. Count The number of discarded frames logged in the frame log that have the log timestamp, TX port, RX port, SID, DID, SFID and DFID values listed on this line of output.
frameLog -type timeout | du | unroute Specifies the discard frame types to enable. Specify timeout for timeout discard frames, du for destination unreachable frames, and unroute for unroutable frames. --clear Clears the stored history of discarded frames. This operation is permitted only when the feature is enabled. --status Displays the current status of the frame log service, and the type of discard frames that are being logged.
frameLog -mode summary | dump Specifies the command output mode. In dump mode, the command prints the 64 bytes of frame contents. In summary mode, the frame contents are not displayed. Summary mode is the default. -n num_items Displays the specified number of items. In summary mode, an item is a record of frames with the same values of log timestamp, TX port, RX port, SID, DID, SFID and DFID.
frameLog To display the frame contents in dump mode: switch:user> framelog --show -mode dump -n 4 ==================================================================== Mon Jan 31 18:34:47 UTC 2011 ==================================================================== Log TX RX timestamp port port Type Frame contents (first 64 bytes) ==================================================================== Jan 31 18:34:46 7/32 7/33 timeout 00 03 a0 00 00 03 a1 00 00 28 00 00 00 00 00 00 80 00 00 00 00 00 00 00 00 0
fspfShow fspfShow Displays Fabric Shortest Path First (FSPF) protocol information. Synopsis Description fspfshow Use this command to display FSPF protocol information and internal data structures of the FSPF module. The command displays the following fields: version Version of the FSPF protocol. domainID Domain number of the local switch. switchOnline State of the local switch. switchGenNum Switch generation number. switchGenNum(mmap) Switch's current generation number managed by the switch driver.
fspfShow fspfQ FSPF input message queue. fabP Pointer to fabric data structure. agingTID Aging timer ID. agingTo Aging time out value in milliseconds. lsrDlyTID Link State Record delay timer ID. lsrDelayTo Link State Record delay time out value in milliseconds. lsrDelayCount Counter of delayed Link State Records. ddb_sem FSPF semaphore ID. event_sch FSPF scheduled events bit map. Notes The output displays only the lines with a bit set.
fspfShow SEE ALSO fabP agingTID agingTo lsrDlyTID lsrDelayTo lsrDelayCount ddb_sem = = = = = = = 0x11209bc8 0x11329ae0 10000 0x1132ac90 5000 0 0x11209bd8 fabP: event_sch max port max phy port = 0x0 = 200 = 40 bcastShow, topologyShow, uRouteShow Brocade Fabric OS Command Reference 53-1004112-02 387
gePortErrShow gePortErrShow Displays error statistics of Gigabit Ethernet (GbE) port and XGE ports. Synopsis geporterrshow geporterrshow --help Description Use this command to display error statistics of Gigabit Ethernet (GbE) ports on the Brocade FX8-24 extension blade. Values for the following parameters are displayed: frames tx Number of frames transmitted (Tx). frames rx Number of frames received (Rx). crc err Number of CRC errors.
h h Displays shell history. Synopsis h history Description Operands Examples Use this command to view the shell history. The shell history mechanism is similar to the UNIX shell history facility. The h command displays the 20 most recent commands typed into the shell; the oldest commands are replaced as new ones are entered.
haDisable haDisable Disables the High Availability feature. Synopsis Description Notes hadisable Use this command to disable the High Availability (HA) feature on a switch. If the HA feature is already disabled, this command does nothing. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
haDump haDump Displays High Availability status information. Synopsis Description hadump Use this command to display information about the status of the High Availability (HA) feature on a switch or a chassis.
haDump Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. Operands None Examples To view information about the High Availability feature status on a Brocade DCX 8510-8: switch:admin> hadump --------------------------------------TIME_STAMP: Mar 30 12:57:35.
haEnable haEnable Enables the High Availability feature. Synopsis Description haenable Use this command to enable the High Availability (HA) feature on a switch. If the HA feature is already enabled, this command has no effect. If the HA feature is disabled, this command enables it. The standby CP reboots as part of the process. The command displays a warning message and prompts for confirmation before rebooting the CP.
haFailover haFailover Forces the failover mechanism so that the standby control processor (CP) becomes the active CP. Synopsis Description Notes hafailover Use this command to force the failover mechanism to occur so that the standby CP becomes the active CP. In case the active and standby CPs are not synchronized or the system is not in redundant mode, the command aborts.
haReboot haReboot Performs high availability (HA) reboot. Synopsis Description hareboot Use this command to perform warm reboot in the switch-based systems. On chassis-based systems, this command behaves similar to the haFailover command so that the standby CP becomes the active CP. In chassis-based systems, if the active and standby CPs are not synchronized or the system is not in the redundant mode, the command aborts.
haRedundancy haRedundancy Displays switch uptime. Synopsis haredundancy --show haredundancy --help Description Use this command to display the switch uptime and the chassis control processor redundancy statistics. For chassis, the command displays the control processor redundancy settings and switch uptime. For switches, the command displays the switch uptime only. The display includes the following information: • Current active session: Displays the settings for the current session.
haRedundancy Standby Slot = CP0 Start Time: 17:49:46 UTC Fri Jan 03 2014 End Time: 17:54:10 UTC Fri Jan 03 2014 System Uptime: 17:42:11 UTC Fri Jan 03 2014 To display switch uptime without a standby CP: switch:admin> haredundancy --show === HA Redundancy Statistics === Non-redundant System Uptime: 17:42:11 UTC Fri Jan 03 2014 To display switch uptime: switch:admin> haredundancy --show === HA Redundancy Statistics === Not supported on this platform System Uptime: 09:42:12 UTC Wed Nov 22 2013 SEE ALSO ha
haShow haShow Displays control processor (CP) status. Synopsis Description hashow Use this command to display the control processor status. The display includes the following information: • • • • • • Local CP state (slot number and CP ID), warm or cold, recovering or recovered. Remote CP state (slot number and CP ID). High Availability (enabled or disabled). Heartbeat (up or down).
haShow Notes This command may not be supported on nonbladed systems. Slot numbers for CP1 and CP0 vary depending on the hardware platform. On the Brocade DCX 8510-8, CP0 is in slot 6 and CP1 is in slot 7. On the Brocade DCX 8510-4, CP0 is in slot 4 and CP1 is in slot 5. On the Brocade X6 Director, CP0 is in slot 1 and CP1 is in slot 2. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
haSyncStart haSyncStart Enables High Availability state synchronization. Synopsis Description hasyncstart Use this command to enable the High Availability (HA) state synchronization. After issuing haSyncStop, the switch does not go back to sync start unless you perform one of the following actions: reboot the active CP, reboot the standby CP, insert a new standby CP (blade), or issue the haSyncStart command The time it takes for the HA sync to complete depends on the system configuration.
haSyncStop haSyncStop Disables High Availability state synchronization. Synopsis Description hasyncstop Use this command to temporarily disable High Availability (HA) synchronization. After issuing haSyncStop, the switch does not go back to sync start unless you perform one of the following actions: reboot the active CP, reboot the standby CP, insert a new standby CP (blade), or issue the haSyncStart command The time it takes for the HA sync to complete depends on the system configuration.
help help Displays command help information. Synopsis help [command] help [-p | -page] help --help Description Use this command without operands to display an alphabetical listing of commands for which help is available. When used without an operand, the command listing displays without page break. Pipe the output through the Unix grep command to filter the output. Use the -page operand to display the commands for which help is available one page at a time. Press Enter to go to the next page.
help alidelete aliremove alishow aptpolicy auditcfg auditdump (output truncated) Delete a zone alias Remove a member from a zone alias Print zone alias information Get and set Advanced Performance Tuning policy Modifies and displays audit log filter configuration.
historyLastShow historyLastShow Displays the latest entry in the field replaceable unit (FRU) history log. Synopsis Description historylastshow Use this command to display the latest entry of the history log, which records insertion and removal events for field-replaceable units (FRUs), such as blades, power supplies, fans, and world wide name (WWN) cards. The type of FRU supported depends on the hardware platform. Each history record contains three lines of information.
historyLastShow Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
historyMode historyMode Displays the mode of the field replaceable unit (FRU) history log. Synopsis Description historymode Use this command to display 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 new entry exceeding the maximum buffer size overwrites the oldest entry in the log. This is the default mode.
historyShow historyShow Displays the entire field replaceable unit (FRU) history log. Synopsis Description historyshow Use this command to display the entire history log, which records insertion and removal events for field-replaceable units (FRUs), such as blades, power supplies, fans, and world wide name (WWN) cards. The type of FRU supported depends on the hardware platform. Each history record contains three lines of information.
historyShow Factory Part Number: Factory Serial Number: 60-0001536-02 Not Available FAN Unit 3 Factory Part Number: Factory Serial Number: Inserted at Tue Aug 14 10:23:45 2001 20-123456-12 1013456800 WWN Unit 1 Factory Part Number: Factory Serial Number: Inserted at Tue Aug 14 11:03:45 2001 40-0000031-03 1013456800 SW BLADE Slot 3 Factory Part Number: Factory Serial Number: Removed at Tue Aug 14 12:10:09 2001 60-0001532-03 1013456800 CP BLADE Slot 6 Factory Part Number: Factory Serial Number: Remo
i i Displays a process summary. Synopsis Description i [processID] Use this command to display information about a specified process or about all processes running on the local switch. One line is displayed per process.
i UID The effective user ID number of the process PID The process ID of the process PPID The process ID of the parent process C Processor utilization for scheduling PRI Priority number of the process; higher numbers mean lower priority NI Nice value used in priority computation ADDR Memory address of the process SZ The total size of the process in virtual memory, in pages WCHAN The address of an event for which a process is sleeping (if blank, process is running) TTY The controlling terminal of the process
iflShow iflShow Displays the interfabric link (IFL) information. Synopsis iflshow iflshow --help Description Use this command to display the current connection and information of the interfabric links (IFL) on an edge switch.
iflShow Examples To display the interfabric links: switch:admin> iflshow EEXFCR WWN FCR FCR Speed BW # Port Port FID Name ---------------------------------------------------------------1: 7-> 8 10:00:00:05:1e:8b:68:10 8 fcr1 4G 4G TRUNK 2: 12-> 13 10:00:00:05:1e:a1:e3:3a 15 fcr2 4G 4G TRUNK 3: 15-> 15 10:00:00:05:1e:a1:e1:f9 12 sw87 4G 4G TRUNK QOS 4: 16-> 16 10:00:50:eb:1a:00:00:02 4 fcr3 4G SEE ALSO 412 fcrEdgeShow, fcrFabricShow Brocade Fabric OS Command Reference 53-1004112-02
interfaceShow interfaceShow Displays FSPF interface information. Synopsis Description interfaceshow [slot/][port] Use this command to display the two data structures associated with FSPF interfaces (E_Ports) on the switch: • • The permanently allocated interface descriptor block (IDB). The neighbor data structure. This data structure is allocated when a switch port becomes an E_Port.
interfaceShow delay Conventional delay incurred by a frame transmitted on this ISL. A fixed value required by the FSPF protocol. lastScn Type of the last State Change Notification received on this interface. lastScnTime Time the last State Change Notification was received on this interface. upCount Number of times this interface came up, with respect to FSPF. lastUpTime Last time this interface came up. downCount Number of times this interface went down. lastDownTime Last time this interface went down.
interfaceShow firstHlo Time of the first hello sent on this interface. nbstFull Time of the last finishing state, NB_ST_FULL, on this interface. &dbRetransList Pointer to the database retransmission list. &lsrRetransList Pointer to the link state records (LSR) retransmission list. &lsrAckList Pointer to the link state acknowledgements (LSA) retransmission list. inactTID Inactivity timer ID. helloTID Hello timer ID. dbRtxTID Database retransmission timer ID. lsrRtxTID LSR retransmission timer ID.
interfaceShow nLsuIn Number of LSUs 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. attLsuOut Number of attempted transmissions of LSUs to the neighbor switch. nLsuOut Number of LSUs transmitted to the neighbor switch. attLsaOut Number of attempted transmissions of LSAs to the neighbor switch.
interfaceShow DECOM_SEND (8) Preparing to update routes of the local port; negotiates for the necessary before updating the routes. DECOM_TIMER (9) The request for one or more locks failed; delay for a short interval before retrying. DECOM_DONE (10) The local routes are updated; waiting for acknowledgement from the neighbor. DECOM_BLOCK (11) The local routes are updated; the neighbor sent acknowledgement.
interfaceShow When invoked without operands, this command displays the interface information for all ports on the switch (including non-E_Ports).
interfaceShow attHloOut nHloOut attLsuOut nLsuOut attLsaOut nLsaOut StuckCnt = = = = = = = 35 35 1 1 2 2 0 Port Sub-State Data: state = DONE (5) chassis_lock = 0 lock_request = 0 nbr_lock_lock = 0 r_rdy_rcvd = 0 nbr r_rdy flags = 0x0 lock_busy_cnt = 0 decom_active = 0 decom_initiator = 0 decom_active_port = -1 decom_trunk_member = 0 SEE ALSO nbrStateShow, portShow, switchShow Brocade Fabric OS Command Reference 53-1004112-02 419
iodReset iodReset Disables in-order delivery (IOD) on a switch. Synopsis Description iodreset Use this command to disable in-order delivery enforcement on the local switch. IOD is disabled by default, and can only be disabled after it has been enabled with the iodSet command. This command disables the legacy IOD enforcement only. Disabling IOD allows faster rerouting after a fabric topology change, but it may cause out-of-order delivery of frames during fabric topology changes.
iodSet iodSet Enables in-order delivery (IOD). Synopsis iodset iodset --help Description Use this command to enforce in-order delivery of frames during a fabric topology change. In a stable fabric, frames are always delivered in order, even when the traffic between switches is shared among multiple paths. However, when topology changes occur in the fabric (for instance, a link goes down), traffic is rerouted around the failure and some frames might be delivered out of order.
iodShow iodShow Displays the in-order delivery (IOD) setting. Synopsis Description Notes iodshow Use this command to display the IOD setting on the switch. By default, IOD is disabled. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
ipAddrSet ipAddrSet Sets the Ethernet and FC IP addresses. Synopsis ipaddrset [-ipv6 ] [--add x:x:x:x:x:x:x/n | --delete] ipaddrset [-cp cp_number | -chassis] [-ipv6 ] [--add x:x:x:x:x:x:x/n | --delete] ipaddrset [-slot slot] [-eth0 | -eth1] [--add x.x.x.x/n | --delete] ipaddrset [-slot slot] -gate [--add x.x.x.
ipAddrSet • • • The command accepts the -ipv6 command line syntax with the --add or --delete option on all platforms that support IPv6 addresses. The --add option configures a single static IPv6 address and prefix for the specified managed entity (chassis, CP, or AP). The --delete option deletes a static IPv6 address and prefix for the specified managed entity. On modular platforms, the command can be executed only on the active CP.
ipAddrSet Notes • To set the CP Ethernet IPv4 address, use the -cp option; to set the Ethernet IP address for the entire chassis, use the -chassis option. When setting the chassis IP address, the command prompts for the Ethernet IP address and Ethernet subnet mask. When setting the CP Ethernet IP address, the command prompts for the host name, Ethernet IP address, Ethernet subnet mask, and Gateway IP address. Valid switch and CP numbers depend on the platform on which the command is run.
ipAddrSet -slot number On a chassis with a blade processor (BP), specifies the slot number. On standalone platforms with a hidden BP, such as the AP76500, this parameter is not accepted. -ipv6 [-auto | -noauto] Enables or disables stateless IPv6 autoconfiguration on a switch or chassis. When autoconfiguration is enabled, the host automatically performs configuration of IPv6 addresses and periodic nondisruptive reconfiguration. By default, autoconfiguration is disabled.
ipAddrSet -ipv4 Specifies IP address type as static IPv4. -add Sets the specified IPv4 address. -host hostname Sets the hostname. -ethip ipaddress Sets the ethernet IP address. -ethmask mask Sets the ethernet mask. -gwyip gateway_ip Sets the gateway IP address. -dhcp[ON | OFF] Enables or disables DHCP. -dhcpv6 Enables DHCPv6. DHCPv6 is supported only on Brocade 6547 and Brocade 6549. -nodhcpv6 Disables DHCPv6. DHCPv6 is supported only on Brocade 6547 and Brocade 6549.
ipAddrSet To verify the IPv4 FC address for the logical switch: switch:admin> ipaddrshow CHASSIS Ethernet IP Address: 10.32.220.10 Ethernet Subnetmask: 255.255.240.0 CP0 Ethernet IP Address: 10.32.220.11 Ethernet Subnetmask: 255.255.240.0 Host Name: cp0 Gateway IP Address: 10.32.208.1 CP1 Ethernet IP Address: 10.32.220.12 Ethernet Subnetmask: 255.255.240.0 Host Name: cp1 Gateway IP Address: 10.32.208.1 IPFC address for logical fabric ID 128: 1.2.3.4/24 Backplane IP address of CP0 : 10.0.0.
ipAddrSet To enable DHCPv6 on a device: switch:admin> ipaddrset -ipv6 -dhcpv6 To clear all IP address information on a management interface and verify the changes: switch:admin> ipaddrset --clear Warning: All management interface will be closed, \ which will result in all network connections \ being terminated. Please initiate a connection to the serial console of \ the switch to configure the management interface. Would you like to continue with clearing the IP \ configuration?(y/n)y switch:admin> ipaddr
ipAddrShow ipAddrShow Displays IP address information for a switch or control processor (CP). Synopsis ipaddrshow ipaddrshow [-cp cp_number] | -chassis ipaddrshow -slot slot [-eth0 | -eth1 | -gate] Description Use this command to display the IP addresses configured in the system. The -cp option displays the IP address for a specified CP on modular platforms, or use the command without arguments to display the IP address on a standalone switch, or the IP addresses for both CPs on a chassis.
ipAddrShow Local IPv6 addresses display the following identifiers: • IP Address type: • static - A statically configured IPv6 address. stateless - Acquired through stateless autoconfiguration. 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 option. On standalone platforms, all command options are ignored.
ipAddrShow To display all IP addresses on a Brocade DCX backbone: switch:admin> ipaddrshow Chassis Ethernet IP Address: 10.33.60.85 Ethernet Subnetmask: 255.255.240.0 CP0 Ethernet IP Address: 10.33.60.86 Ethernet Subnetmask: 255.255.240.0 Host Name: cp0 Gateway IP Address: 10.33.48.1 CP1 Ethernet IP Address: 10.33.60.87 Ethernet Subnetmask: 255.255.240.0 Host Name: cp1 Gateway IP Address: 10.33.48.1 Backplane IP address of CP0 : 10.0.0.5 Backplane IP address of CP1 : 10.0.0.
ipAddrShow 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.
ipFilter ipFilter Manages the IP filter policies.
ipFilter Operands This command has the following operands: policyname Specifies an IP filter policy name. The policy name is a unique string composed of a maximum of 20 alphanumeric or underscore characters. The default_ipv4 and default_ipv6 names are reserved for default IP filter policies. The policy name is case-insensitive and is always stored as lower case. The policy type identifies the policy as an IPv4 or IPv6 filter. You can create a maximum of eight IP filter policies.
ipFilter --addrule 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: -sip source_IP Specifies the source IP address. For filters of type IPv4, the address must be a 32-bit address in dot notation, or a CIDR-style IPv4 prefix.
ipFilter --clrcounters Clears the IP filter counters. This command requires root permissions. --showcounters Displays the IP filter counters. This command requires root permissions. 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, and protocol, and to permit the rule: switch:admin> ipfilter --addrule ex1 \ -sip fec0:60:69bc:60:260:69ff:fe80:d4a -dp 23 \ -p
ipFilter 6 7 8 any any any udp tcp udp 123 permit 600 - 1023 permit 600 - 1023 permit Name: Rule 1 2 3 4 5 6 7 8 default_ipv6, Type: ipv6, State: defined Source IP Protocol Dest Port any tcp 22 any tcp 23 any tcp 80 any tcp 443 any udp 161 any udp 123 any tcp 600 - 1023 any udp 600 - 1023 Action permit permit permit permit permit permit permit permit Name: ex1, Type: ipv6, State: active Rule Source IP Protocol Dest Port Action 1 fec0:60:69bc:60:260:69ff:fe80:d4a tcp 23 permit To create an IPv4-type
ipFilter 3 4 5 6 7 8 any any any any any any tcp tcp udp udp tcp udp Name: ex2, Type: ipv4, State: defined Rule Source IP Protocol 1 10.32.69.99 tcp 80 443 161 123 600 - 1023 600 - 1023 permit permit permit permit permit permit Dest Port Action 23 permit To add a rule for traffic of type FORWARD and to display the result: switch:admin> ipfilter --addrule ex2 -rule 1 -sip \ 10.32.69.99 -dp 23 -proto tcp -act permit -type fwd \ -dip 10.32.69.
ipSecConfig ipSecConfig Configures Internet Protocol security (IPSec) policies for Ethernet management interfaces.
ipSecConfig • In IKE the IPSec protocol negotiates shared security parameters and keys. Security Associations (SAs) used in IKE use automatically generated keys for authentication negotiation between peers. • Manual key/SA entry requires the keys to be generated and managed manually, and it is therefore suited for small static environments. For the selected authentication or encryption algorithms, the correct keys must be generated. The key length is determined by the algorithm selected.
ipSecConfig This command accepts abbreviated operands. The abbreviated string must contain the minimum number of characters necessary to uniquely identify the operand within the set of available operands. Operands This command has the following operands: --enable Enables IPSec on the switch. Existing IPSec configurations are enabled by this command. IPSec is disabled by default. It must be enabled before you can configure the policies and parameters.
ipSecConfig -remote IP_address[/prefixlength] Specifies the peer IPv4 or IPv6 address -transform name Specifies the transform to be included in the selector. You must create the transform before you can use in the selector. Use ipsecConfig --show policy ips transform to display existing transforms. -protocol protocol_name Specifies the upper layer protocols to be selected for IPSec protection. Valid protocols include tcp, udp, icmp or any.
ipSecConfig 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-generated name. The name must be between 1 and 32 characters in length, and may include alphanumeric characters, dashes (-), and underscores (_). -sa name[,name] Specifies the SAs to include in the SA proposal.
ipSecConfig -enc algorithm Specifies the encryption algorithm. This operand is required. Valid algorithms include the following: 3des_cbc 3DES encryption algorithm blowfish_cbc Blowfish encryption algorithm null_enc Null encryption algorithm aes256_cb AES-256 algorithm -spi number Specifies the security parameter index (SPI) for the SA. This is a user-defined index. Valid SPI numbers consist of numeric characters (0-9). This operand is optional. policy ike Creates or modifies an IKE policy configuration.
ipSecConfig aes256_cbc AES 256-bit algorithm -hash algorithm Specifies the hash algorithm. Valid hash algorithms include the following: hmac_md5 MD5 algorithm hmac_sha1 SH1 algorithm -prf algorithm Specifies the PFR algorithm. Valid PRF algorithms include the following: hmac_md5 MD5 algorithm hmac_sha1 SH1 algorithm -auth psk | dss | rsasig Specifies the authentication method as one of the following: psk Authenticate using preshared keys. dss Authenticate using digital signature standard.
ipSecConfig -lttime number Specifies the key lifetime in seconds. If a lifetime is not specified, the keys do not expire. If a lifetime is specified both in seconds and in bytes, the keys expire when the first expiration criterion is met. -ltbyte number Specifies the key lifetime in bytes. The keys expire after the specified number of bytes have been transmitted. -pfs on | off Enables or disables Perfect Forward Secrecy (PFS). PFS is disabled by default.
ipSecConfig -direction in | out Specifies traffic flow direction as inbound or outbound. -mode tunnel | transport Specifies the IPSec mode. In tunnel mode, the IP datagram is fully encapsulated by a new IP datagram using the IPSec protocol. In transport mode, only the payload of the IP datagram is handled by the IPSec protocol; it inserts the IPSec header between the IP header and the upper-layer protocol header. -enc algorithm Specifies the encryption algorithm.
ipSecConfig --delete Deletes a specified policy or all policies of a certain typefrom the configuration database. You can delete IPSec policies, IKE policies, and SADB entries. When deleting IPSec policies, you have the option to delete specific components only, such as the transform or the selector, and recreate these components without having to recreate the entire policy.
ipSecConfig --flush manual-sa Flushes all SA entries (including manually keyed and automatically keyed SAs) from the kernel SADB. All active TCP sessions that are using IPSec protection are terminated when this command is executed. This command, unlike delete, does not remove the policies from the configuration database. Flushing any other policy parameters is not supported. --show Displays current IPSec or IKE configuration.
ipSecConfig -tag name Displays configuration information for the specified IPSec policy only. --help Displays the command usage. Optionally use --help with a specified command, type, and subtype to display the syntax for specific commands. Do not include a double dash when specifying the command.
ipSecConfig Examples Example 1 The following example illustrates how to secure traffic between two systems using AH protection with MD5 and configure IKE with preshared keys. The two systems are a switch, BROCADE300 (IPv4 address 10.33.74.13), and an external UNIX server (10.33.69.132). 1. On the system console, log in to the switch as Admin and enable IPSec. switch:admin> ipsecconfig --enable 2. Create an IPSec SA policy named AH01, which uses AH protection with MD5.
ipSecConfig Example 2 The following example illustrates how to secure traffic between two systems using ESP protection with 3DES_CBC encryption and SHA1 authentication, and how to configure IKE with RSA Certificates signed by the certification authority (CA). The two systems are A SWITCH, BROCADE300 (IPv6 address fe80::220:1aff:fe34:2e82), and an external UNIX host (IPv6 address fe80::205:1fff:fe51:f09e). 1. On the system console, log in to the switch as Admin and enable IPSec.
ipSecConfig switch:admin> seccertutil import -ipaddr 10.103.6.139 \ -remotedir /root/certs -certname remote-peer.pem 6. Import the CA certificate that was used to sign the public certificates of BROCADE300 and the remote peer as IPSECCA.pem. switch:admin> seccertutil import -ipaddr 10.103.6.139 \ -remotedir /root/certs -certname IPSECCA.pem 7. Configure an IKE policy for the remote peer UNIX host. switch:admin> ipsecconfig --add policy ike -t IKE01 -remote \ fe80::205:1fff:fe51:f09e -id fe80::220:1aff:
ipSecConfig Example 3 The following example illustrates how to secure traffic between two systems using AH with SHA1 and ESP protection with 3DES and configure IKE with preshared keys. The two systems are a switch, a Brocade 300 (IP address 10.33.74.13), and an external UNIX host (IPv4 address 10.33.69.132). 1. On the system console, log in to the switch as Admin and enable IPSec. switch:admin> ipsecconfig --enable 2. Create an IPSec SA policy named AH01, which uses AH protection with SHA1.
ipSecConfig Example 4 The following example illustrates how to secure traffic between two systems using protection with MD5 and Manually keyed SAs. The two systems are a switch, the BROCADE300 (IPv4 address 10.33.74.13), and an external UNIX host (IPv4 address 10.33.69.132). 1. On the system console, log in to the switch as Admin and enable IPSec. switch:admin> ipsecconfig --enable 2.
ipSecConfig 10.33.74.13[0] 10.33.69.
ipSecConfig -direction -local -remote -transform [-protocol ] traffic flow direction source IPv4 or IPv6 address peers IPv4 or IPv6 address transform name protocol nam switch:admin> ipsecconfig --help modify policy ike Usage: ipsecConfig --modify policy ike ARGUMENTS ARGUMENTS -tag -remote -id -remoteid -enc -hash -prf -dh ike policy name peers ipaddress local identifier peers identif
islShow islShow Displays interswitch link (ISL) information. Synopsis Description islshow Use this command to display the current connections and status of the interswitch link (ISL) for each port on a switch.
islShow Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. Operands None Examples To execute islshow in a base fabric: switch:user> islshow 1: 2->300 10:00:00:05:1e:43:00:00 100 DCX \ sp: 8.000G bw: 32.000G TRUNK QOS 2: 8-> 3 10:00:00:05:1e:41:8a:d5 30 B5300\ sp: 4.000G bw: 16.000G TRUNK QOS 3: 19-> 10 10:00:00:05:1e:41:43:ac 50 B300 sp:\ 8.000G bw: 64.
islShow 7:341-> 25 10:00:00:05:33:7e:69:c4 1 sw0 \ sp: 16.000G bw: 16.000G QOS CR_RECOV FEC 8:342-> 32 10:00:00:05:33:7e:69:c4 1 sw0 \ sp: 4.000G bw: 4.000G QOS CR_RECOV 9:343-> 24 10:00:00:05:33:7e:69:c4 1 sw0 \ sp: 16.000G bw: 16.
itemList itemList Lists parameter syntax information. Synopsis item_list = element | element white item_list element = item | item - item item = num | slot [white]/ [white] num slot = num num = hex | int int = int digit | digit hex = 0x hex digit | hex hex digit digit = 0|1|2|3|4|5|6|7|8|9 hex digit = digit |A|B|C|D|E|F|a|b|c|d|e|f white = *["\\t\\f\\r ,"] Description All kernel diagnostics have at least one item list parameter to specify which ports to test.
itemList The exact type of list varies, depending on the test and the parameter; however, the most common are blade ports and user ports. A list of blade ports is most commonly used by ASIC-level tests such as turboRamTest and represents which ports on the current blade (specified with --slot number) are tested. A list of user ports is used by higher-level tests to specify which user-accessible external ports within the current switch (selected during Telnet login) are tested.
killTelnet killTelnet Terminates an open Telnet session. Synopsis killtelnet Description Use this command to terminate an open Telnet session. The command lists all current Telnet and serial port login sessions and information such as session number, login name, idle time, IP address of the connection, and timestamp of when the login session was opened. The command prompts you to specify the number of the session you want to terminate.
ldapCfg ldapCfg Maps LDAP AD server roles to default switch roles. Synopsis ldapcfg --maprole ldaprole switchrole ldapcfg --unmaprole ldaprole ldapcfg --show ldapcfg --help Description Use this command to map a Lightweight Directory Access Protocol (LDAP) Active Directory (AD) server role to one of the default roles available on a switch. This command also provides an option to remove an existing mapping.
ldapCfg switchrole Specifies the switch role to which the LDAP role is mapped. Valid switch roles include the following: • • • • • • • • admin user switchadmin zoneadmin fabricadmin basicswitchadmin operator securityadmin --unmaprole Removes the mapping between an LDAP role and a switch role. Use the --show option for a listing of existing mappings. The following operand is required: ldaprole Specifies the LDAP AD sever role to be removed from the mapping.
lfCfg lfCfg Configures and displays logical fabrics. Synopsis lfcfg [--show | --showall] -cfg lfcfg [--show | --showall] -lisl [-v] lfcfg [--show -xisl [slot/]port | --showall -xisl lfcfg --lislenable lfcfg --help Description Use this command to display logical fabric configuration information, to determine the status of logical interswitch links (LISLs), to enable LISLs between logical switches, and to display information about the XISLs and LISLs associated with each XISL.
lfCfg Switch WWN The logical switch world wide name. When issued with the -lisl option, the command displays the following information: FID Fabric ID of the logical switch. Port Number of the logical LISL port. remote-domain Domain ID of the base switch in the remote chassis. Name Switch name. State Port state: Online or Offline. Associated physical ports Physical ports associated with the LISL ports.
lfCfg -v Displays, in addition to the LISLs, the physical ports on the base switch that are associated with the LISL ports. This operand is optional with the -lisl option. --show -xisl [slot/]port Displays the XISL and the LISLs associated with it for the specified XISL port. For each LISL port, the output displays the FID, LISL State (online/offline) and the local and remote logical switch WWNs. This command must be executed from the base switch.
lfCfg State: Online(1) Switch WWN: 10:00:00:05:1e:39:81:66 ---------------------- Chassis: 2 ------------------------Chassis WWN: 10:00:00:05:1e:0b:a4:5e Number of Partitions: 2 Base switch domain: 2 Logical switch: 2 State: Online(1) Base switch: YES Fabric Id: 2 Switch WWN: 10:00:00:05:1e:0b:a4:41 Logical Switch: 1 State: Online(1) Base switch: NO Fabric Id: 1 Switch WWN: 10:00:00:05:1e:0b:a4:40 To display the LISLs in the logical switch: switch:admin> lfcfg --show -lisl FID Port# remote-domai Name
lfCfg To display a specific XISL and the LISLs associated with it switch:admin> lfcfg --show -xisl 12/31 XISL Port No. : 12/31 LISL Pt.
licenseAdd licenseAdd Adds a license key to a switch. Synopsis Description licenseadd license Use this command to add a license key to a switch. Some features of the switch and the fabric to which it is connected are optional, licensed products. Without a valid license installed for such products, their services are not available. A license key is a string of any length consisting of upper- and lowercase letters and numbers. License keys are case-sensitive.
licenseIdShow licenseIdShow Displays the system license ID. Synopsis Description licenseidshow Use this command to display the license ID of the system. Some features of the switch and the fabric are optional, licensed products. Without a license installed for such products, the services provided by these features are not available. This command displays the system license ID used for generating and validating licenses on the system.
licensePort licensePort Manages Dynamic Ports On Demand (DPOD) licenses. Synopsis licenseport --release port1[-port2] licenseport --reserve port1[-port2] licenseport --show licenseport --method dynamic | static Description Use this command to manage and display Dynamic Ports on Demand (DPOD) license assignments. Dynamic Ports On Demand (DPOD) is an optional feature available on all embedded platforms.
licensePort static Selects the static POD method. The --method operand is not supported on Brocade G620 switch. Examples To activate Dynamic Ports On Demand: switch:admin> licenseport --method dynamic The POD method has been changed to dynamic. Please reboot the switch now for this change to take effect.
licensePort 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35, 36, 37, 38, 39, 40 41, 42, 43, 44, 45, 46, 47 39 license reservations are still available for use by unassigned ports 6 license assignments are held by offline ports (indicated by *) To disable Dynamic Ports On Demand: switch:admin> licenseport --method static The POD method has been changed to static. Please reboot the switch now for this change to take effect.
licenseRemove licenseRemove Removes or deactivates a license key. Synopsis Description licenseremove license Use this command to remove an existing license key from a switch or to deactivate the license key. The existing license key must be entered exactly as shown by the licenseShow command. License keys are case-sensitive. When the key has been removed, use the licenseShow command to verify that the key and the associated product have been uninstalled.
licenseRemove Expiry Date 03/06/2009 License is expired Hf7MBEEGCFNmTAWXXF99RtHXQN4RRtM3mLGtrWZLAMaTaAY9EB: Storage Application Services license Expiry Date 03/07/2009 SEE ALSO 478 licenseAdd, licenseIdShow, licenseShow Brocade Fabric OS Command Reference 53-1004112-02
licenseShow licenseShow Displays current license keys. Synopsis Description licenseshow Use this command to display current license keys, along with a list of licensed products enabled by these keys.
licenseShow RyeSzRScycTzfT09: Entry Fabric license RyeSzRScycazfT0G: Trunking license RyeSzRScycS0fT09: 4 Domain Fabric license To display the license keys on a switch with temporary (expired) licenses installed: switch:admin> licenseShow 7QmYFYJrmDgE9tTS4AYXB9trYSGtMtrQZSTK4ZSC7FC9ZAYAgE: Integrated Routing license Expiry Date 01/16/2008 License is expired 33YBfZfKZ3tQKrRJJRtgmS3JDtCL99P4fYrJYQP7GffS4ASmNE: Enterprise Bundle license Expiry Date 01/16/2008 License is expired To display the license keys o
licenseShow To display an ICL license on a Brocade DCX 8510-8: switch:admin> licenseshow X3ffNTZM9CNmM4SKFLYTGS4WmCRCgAZZBJDTB: Inter Chassis Link (2nd POD) license To display an ICL license on a Brocade DCX before and after a firmware upgrade to Fabric OS v7.0.0.
licenseSlotCfg licenseSlotCfg Configures and displays slot-based licensed features. Synopsis licenseslotcfg --add feature slot licenseslotcfg --remove feature slot licenseslotcfg --show licenseslotcfg --help Description Use this command to configure and manage licenses for the Brocade FX8-24 extension blade on the slot where the blade is installed.
licenseSlotCfg FTR_UPG1 WAN Rate Upgrade 1 license FTR_UPG2 WAN Rate Upgrade 2 license slot Specifies the slot number for the Brocade FX8-24 extension blade. This number corresponds to the physical blade slot number on the chassis. --add Adds a slot-based license to the specified slot. --remove Removes a slot-based license from the specified slot. This operation frees up the license to be assigned to another slot.
licenseSlotCfg FTR_AFA license - blade slots configured = 3,4 switch:admin> licenseslotcfg --remove FTR_AE 12 Blade slot-12 removed from FTR_AE slot-based license configuration switch:admin> licenseslotcfg --show FTR_10G license - blade slots configured = 1,3,5,12 FTR_AFA license - blade slots configured = 3,4 To view the WAN Rate Upgrade licenses: switch:admin> licenseslotcfg --show licenseslotcfg: Command is not supported on this platform SEE ALSO 484 licenseAdd, licenseIdShow, licenseRemove Brocade
linkCost linkCost Sets or displays the Fabric Shortest Path First (FSPF) cost of a link. Synopsis Description linkcost [[slot/]port [cost]] Use this command to set or display the cost of an interswitch link (ISL). The cost of a link is a dimensionless positive number. The Fabric Shortest Path First (FSPF) protocol compares the cost of various paths between a source switch and a destination switch by adding the costs of all the ISLs along each path. FSPF chooses the path with minimum cost.
linkCost Examples To display the link costs for all ports on a switch: switch:admin> linkcost Port Cost ------------------------1/0 (E_PORT) 500 1/1 500 1/2 500 1/3 500 1/4 500 1/5 500 1/6 500 1/7 500 1/8 500 1/9 (E_PORT) 500 1/10 500 1/11 500 1/12 500 1/13 500 1/14 500 1/15 500 Type to continue, Q to stop: To set the ISL cost on a port: switch:admin> linkcost 1/9 1000 To display the new cost value on the same port: switch:admin> linkcost 1/9 Interface1/9 (E_PORT) Cost 1000 (STATIC) To dele
linkCost To set the ISL cost to the maximum value: switch:admin> linkcost 1/9 65535 The link cost entered will cause the port to become unusable. If you do not want this to happen, choose n|no and run 'linkcost' again with a value lower than 65535.
logicalGroup logicalGroup Creates and manages groups of monitored elements.
logicalGroup member_list Specifies the elements in the group. The member list must be enclosed in double quotation marks and can consist of the following: Port and SFP groups: • • • A single port, for example, "8" or "2/8" on bladed systems. A port range where the beginning and end port are separated by a dash, for example, "8-13" or "2/8-13" on bladed systems. A set of ports and port ranges separated by commas, for example, "3,5,7-10,15" or "2/3,2/5,3/7-10,4/15" on bladed systems.
logicalGroup --delmember group_name Deletes members from the group. -members member_list Specifies the elements that are to be deleted from the group. --clone Creates a replica of an existing group. The new group has all of the members of the existing group. You can further modify the newly created group. The following operands are required: existing_group_name Specifies the name of an existing group. The group can be a predefined group or a user-defined group.
logicalGroup To add members to a group: switch:admin> logicalgroup --addmember CRITICAL_PORTS -members "4, 5" To delete members from a group: switch:admin> logicalgroup --delmember CRITICAL_PORTS -delmember "5" To clone a group: switch:admin> logicalgroup --clone CRITICAL_PORTS -name LONG_DISTANCE_PORTS To display the members of a group: switch:admin> logicalgroup --show CRITICAL_PORTS Group Name |Predefined |Type |Member Count |Members ---------------------------------------------------------------CRIT
login login Logs in as new user. Synopsis Description login Use this command to log in to the switch with another user name and password, without first logging out from the original session. If you originally connected through a Telnet or rlogin session, that session is left open. This command allows you to access commands that you cannot access at your current user level. Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place.
logout logout Logs out from a shell session. Synopsis Description logout Use this command to log out from a shell session. Remote login connections are closed and the local serial connections return to the login prompt. The exit command is accepted as a synonym for logout, as is Ctrl-D at the beginning of a line.
lsanZoneShow lsanZoneShow Displays logical SAN zone information. Synopsis Description lsanzoneshow [-s] [-f fabricid] [-w wwn] [-z zonename] [-d | -deviceinfo] [-o | -sort] Use this command to display the inter-fabric zones or LSAN zones. These zones are normal WWN zones created in FC Router EX_Port-connected fabrics and backbone fabrics. The LSAN zones are identified by the text string "lsan_" in the zone name. Note that the string is case insensitive so "LSAN_" also is valid.
lsanZoneShow Imported Device has been imported (proxy created) into this fabric. -f fabricid Displays LSAN zones in the specified fabric. -w wwn Displays LSAN zones containing the specified port WWN. The WWN format is xx:xx:xx:xx:xx:xx:xx:xx. -z zonename Displays LSAN zones with the specified zone name. The database for zones is displayed per switch, which can differ from the database stored on the other FCR switches. -d | -deviceinfo Displays the fabric IDs of the LSAN devices.
lsanZoneShow To display state information for the device and sort the WWNs in ascending order: switch:admin> lsanzoneshow -s -sort Fabric ID: 12 Zone Name: lsan_zone1 30:06:00:05:1e:61:23:8f EXIST 30:0c:00:05:1e:61:23:8f Imported Fabric ID: 16 Zone Name: lsan_zone1 30:06:00:05:1e:61:23:8f Imported 30:0c:00:05:1e:61:23:8f EXIST Fabric ID: 20 Zone Name: lsan_bb 10:06:00:01:1e:61:23:8f Configured 10:06:00:05:1e:61:23:8f Configured 20:03:00:05:1e:61:23:8f Configured 20:06:00:05:1e:61:23:8f Configured SEE ALSO
lsCfg lsCfg Configures and manages a logical switch Synopsis lscfg --create FID [-b | -base] [-f | -force] lscfg --delete FID [-f |-force] lscfg --config FID [-slot slot1[-slot2]] [-port [ port1[-port2]] [-q | -qsfp] [-f |-force] lscfg --restore_to_default FID lscfg --restore_slot_to_default slot lscfg --change FID [[-newfid FID] | [-base]] [-force] lscfg --show [-ge] [-provision] [-n | -name] lscfg --help Description Use this command to create a logical switch and to modify logical switch configuratio
lsCfg -b | -base Creates a base logical switch on the chassis. A base logical switch communicates among different logical switches. Legacy switches can be connected to the base logical switch through EX_Ports, and interswitch links (ISLs) between base logical switches enable communication among different logical switches. This operand is optional. -f | -force Executes the command without confirmation. This operand is optional. --delete Deletes a logical switch with the specified fabric ID.
lsCfg --change Changes the fabric ID of a logical switch, creates a base logical switch out of an existing logical switch, or removes base switch properties. The -newfid and -base operands are exclusive and may not be combined. The following operands are supported: FID Specifies the Fabric ID of the logical switch. This operand is required. -n | -newfid FID Changes the fabric ID of an existing logical switch.
lsCfg To create a logical switch identified by fabric ID 2: switch:admin> lscfg --create 2 A Logical switch with FID 2 will be created with default configuration. Would you like to continue [y/n]?: y About to create switch with fid=2. Please wait... switch1 Updating flash ... 2013/05/02-10:13:59, [ZONE-1034], 373, SLOT 4 | FID 2, INFO, switch_2, \ A new zone database file is created. 2013/05/02-10:14:15, [FSSM-1002], 374, SLOT 5 | CHASSIS, INFO, switch, \ HA State is in sync.
lsCfg 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. To move all ports in a QSFP group to a logical switch: switch:admin> lscfg --config 10 -slot 5 \ -port 0-20 -qsfp This operation requires that the affected ports be disabled and will move all \ ports(0-23) in qsfp to fid 10.
lsCfg 7 8 9 10 11 | | | | | | | | | | 2 2 2 2 2 | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | To display the partition configuration for all slots with the -ge option: switch:admin> lscfg --show -provision -ge Created switches FIDs(Domain IDs): 128(ds)(118) 2(bs)(1) 1(1) Slot 1 2 3 4 5 6 7 8 ------------------------------------------------------Port 0 | 128 | 2 | | | | | 128 | 128 | 1 | 128 | 2 | | | | | 128 | 128 | 2 | 128 | 2 | | | | | 128 | 128 | 3 | 128 | 2 | | | | |
lsCfg To make logical switch FID 1 the base switch without confirmation: switch:admin> lscfg --change 1 -base -force Disabling the current base switch... Disabling switch fid 1 Disabling the proposed new base switch... Disabling switch fid 1 Please enable your switches when ready. To make logical switch FID 1 the base switch with confirmation: switch:admin> lscfg --change 1 -base Creation of a base switch requires that the proposed new base switch on this system be disabled.
lsDbShow lsDbShow Displays the Fabric Shortest Path First (FSPF) link state database. Synopsis Description lsdbshow [domain] Use this command to display an FSPF link state database record for switches in the fabric or for a specified domain. There are two types of database entries: • • The link state database entry, which is permanently allocated. The link state record (LSR), which is allocated when a switch is connected to the fabric.
lsDbShow uPathCount The number of currently available paths to the remote domain. mOutIfsP Internal variable. parent Internal variable. mPathCost Internal variable. mHopsFromRoot Internal variable. Link State Record pointer Pointer to LSR. The same as lsrP. lsAge Age, in seconds, of this LSR. An LSR is removed from the database when its age exceeds 3,600 seconds. reserved Reserved for future use. type Type of the LSR. Always 1. options Always 0. lsId ID of this LSR. It is identical to the domain ID.
lsDbShow rem port Port number of the port on the other side of the link. cost Cost of this link. The default cost for a 1 Gbps link is 1,000. bw The rounded bandwidth of the output link, in Gbps. type Always 1. Notes Beginning Fabric OS v7.3.0, the output displays only the lines with a bit set. If a port bitmap does not have any bits set, the output displays as "None" for the first line of the bitmap. The execution of this command is subject to Virtual Fabric restrictions that may be in place.
lsDbShow length = 60 chksum = 0x168a linkCnt = 2, flags = 0x0 LinkId = 91, out port = 28, rem port = LinkId = 91, out port = 29, rem port = SEE ALSO 28, cost = 500, bw = 16G, type = 1 29, cost = 500, bw = 48G, type = 1 interfaceShow, nbrStateShow Brocade Fabric OS Command Reference 53-1004112-02 507
mapsConfig mapsConfig Sets MAPS configurations.
mapsConfig -type member_type Specifies the type of elements on which to pause monitoring. Valid types include the following: port The elements are FC ports. circuit The elements are FCIP circuits. sfp The elements are SFP transceivers. -members member_list Specifies the specific elements on which to pause or continue monitoring.
mapsConfig sddq Isolates the slow-drain flows to a low priority VC from the existing VC (medium or high) thus freeing up the resources for the regular flows in the existing VC. Th slow drain device quarantine (SDDQ) feature is not supported in the Access Gateway mode. fms Notifies the configured MAPS threshold events to the FICON Management Server (FMS). toggle Enables port toggling to recover a port from bottleneck condition caused by the target device. Port toggle is supported only for the F_Ports.
mapsConfig --deimport Removes a flow from MAPS. The following operand is required: flow_name [-force] Specifies the name of the flow to be removed from MAPS. The -force operand is optional. You cannot remove a flow that is used by any rules. The -force option overrides the default behavior. If a flow is present in user-defined rules, the -force option deletes all the rules that are configured with the given flow and then removes the flow.
mapsConfig To display the global MAPS configuration: switch:admin> mapsconfig --show Configured Notifications: RASLOG,EMAIL,FENCE,SW_CRITICAL,SW_MARGINAL,SDDQ Mail Recipient: admin@myCompany.
mapsDb mapsDb Displays or clears the dashboard showing an at-a-glance snapshot of switch health status. Synopsis mapsdb --show [all | history | details [-day mm/dd/yyyy | -hr hour_of_day]] mapsdb --clear [all | history | summary] mapsdb --help Description Use this command to view the summary of the events or rules triggered and the objects on which the rules were triggered over a specified period of time, and to clear the dashboard data.
mapsDb Rules Affecting Health Displays the conditions that contributed to the current switch status. The following information is displayed: number of rules triggered in a category, repeat count, triggered rules, execution time, the elements for which rules were triggered, and the triggered value. History Data Displays the following historical data for a specific time window: the monitoring system, the current value that triggered the rule, and the elements for which rules were triggered.
mapsDb --clear Clears the dashboard data. This command clears all database data except the History Data of the current day because it is directly displayed from hardware. The following operands are supported with the --clear command. all Clears all dashboard data. history Clears the dashboard history data. summary Clears the dashboard summary data. --help Displays the command usage.
mapsDb Value(Units)| -------------------------------------------------------------------------------------------4 History Data: =============== Stats(Units) Current 01/05/15 --/--/---/--/---/--/-Port(val) Port(val) -----------------------------------------------------------------------CRC(CRCs) ITW(ITWs) 10(95) LOSS_SYNC(SyncLoss) LF 10(4) LOSS_SIGNAL(LOS) 10(48) PE(Errors) STATE_CHG 10(48) LR 10(32) C3TXTO(Timeouts) RX(%) TX(%) UTIL(%) CRED_ZERO(Million) 10(4) BN_SECS(Seconds) 5 History Data for Backend
mapsDb Category |Today |Last 7 days | ---------------------------------------------------------------------Port Health |No Errors In operating range | BE Port Health |No Errors |No Errors | Fru Health |In operating range |In operating range | Security Violations |No Errors |No Errors | Fabric State Changes |No Errors |In operating range | Switch Resource |In operating range |In operating range | Traffic Performance |In operating range |In operating range | FCIP Health |Not applicable |Not applicable | Fabr
mapsDb Configured Notifications: SW_CRITICAL,SW_MARGINAL 2 Switch Health Report: ======================= Current Switch Policy Status: MARGINAL Contributing Factors: --------------------*FAULTY_BLADE (MARGINAL). *HA_SYNC (MARGINAL). 3.1 Summary Report: =================== Category |Today Last 7 days | ---------------------------------------------------------Fru Health |Out of operating range |No Errors | Switch Resource |No Errors |No Errors | 3.
mapsHelp mapsHelp Displays MAPS command information. Synopsis Description Notes mapshelp Use this command to display a listing of Monitoring and Alerting Policy Suite (MAPS) commands with short descriptions for each command. MAPS commands require a Fabric Vision license. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
mapsPolicy mapsPolicy Creates and manages MAPS policies. Synopsis mapspolicy --create policy_name mapspolicy --addrule policy_name -rulename rule_name mapspolicy --delrule policy_name -rulename rule_name mapspolicy --enable policy_name mapspolicy --clone existing_policy_name -name new_policy_name mapspolicy --delete policy_name mapspolicy --show policy_name | -summary | -all [-concise] mapspolicy --help Description Notes Use this command to create and manage monitoring policies.
mapsPolicy --enable Activates a policy on the switch. The dashboard data will be cleared after the policy is activated. policy_name Specifies the name of the policy to be enabled. The name can be a predefined or a user-defined policy. If another policy is already enabled, that policy is disabled and the specified policy is enabled instead. The predefined policies are as follows: dflt_conservative_policy Contains rules with more lenient thresholds that allow a buffer and do not immediately trigger actions.
mapsPolicy -concise Displays legends instead of the complete action names in the output. The legends for the action names are as follows: RS (RASLOG), PF (FENCE), EML (EMAIL), SN (SNMP), PT (TOGGLE), PD (DECOM), FMS (FMS), SDDQ (SDDQ), SWD (SW_CRITICAL), SWM (SW_MARGINAL), and SFPM (SFP_MARGINAL). This operand is optional. --help Displays the command usage.
mapsPolicy To display the details of a policy: switch:admin> mapspolicy --show dflt_base_policy -concise Policy Name: dflt_base_policy Rule Name |Condition |Actions | ----------------------------------------------------------------------------------------------defALL_TSTEMP_OUT_OF_RANGE |ALL_TS(TEMP/NONE==OUT_OF_RANGE) |RS,SN,EML | defCHASSISFLASH_USAGE_90 |CHASSIS(FLASH_USAGE/NONE>=90) |RS,SN,EML | defCHASSISMEMORY_USAGE_75 |CHASSIS(MEMORY_USAGE/NONE>=75) |RS,SN,EML | defCHASSISCPU_80 |CHASSIS(CPU/NONE>=8
mapsRule mapsRule Creates and manages monitoring rules.
mapsRule monitor Specifies the monitoring system. Valid monitoring systems for each category include the following: Port health Monitors port statistics.
mapsRule Backend Port Health Monitors backend port statistics. Valid values for the port health category include the following: CRC Cyclic redundancy check errors ITW Invalid transmit words LR Link reset BAD_OS Invalid ordered set FRAME_TRUNC The frame is too short (less than 36 bytes). FRAME_LONG The frame is longer than expected (greater than 2148 bytes). GE Port Health Monitors backend port statistics.
mapsRule SFP_STATE SFP state has changed WWN WWN card state has changed FCIP health Monitors the FCIP circuit.
mapsRule Fabric performance impact Monitors the fabric performance. Valid values for the Fabric performance impact category include the following: CRED_ZERO Buffer credit zero counter increments are indirect indication of latency when frames could not transmitted on a port due to the delay in receiving R_RDY frames. THPUT_DEGRADE Throughput degradation UTIL Trunk utilization IT_FLOW IT flow ration Security health Monitors security violations on the switch.
mapsRule EXPIRED_CERTS Expired certificates DID_CHG Domain ID change FLOGI FLOGI FAB_CFG Fabric reconfigurations Fabric state change Monitors fabric state changes, including zone changes, fabric segmentation, E_Port down, fabric reconfiguration, domain ID changes, and fabric logins.
mapsRule Switch status policy Monitors the health of the switch.
mapsRule Traffic performance Monitors traffic load and flow on an FC Port. Valid values for the traffic performance category include the following: TX_FCNT Transmit frame count RX_FCNT Receive frame count TX_THPUT Transmit throughput RX_THPUT Receive throughput IO_RD IO read command count IO_WR IO write command count IO_RD_BYTES IO read data IO_WR_BYTES IO write data group_name Specifies the name of a user-defined group. flow_name Specifies the name of a user-defined flow.
mapsRule le Less than or equal to g Greater than ge Greater than or equal to eq Equal to value Specifies the threshold value. Valid values include the following: • • • • • • For numerical values: 1-9999. For percentage values: 1-100. For FRU states: ON, OFF, IN, OUT, or FAULTY. For temperature monitoring: IN_RANGE or OUT_OF_RANGE. For FPI states: IO_FRAME_LOSS, IO_PERF_IMPACT, IO_LATENCY_CLEAR.
mapsRule sddq Isolates the slow-drain flows to a low priority VC from the existing VC (medium or high) thus freeing up the resources for the regular flows in the existing VC. The slow drain device quarantine (SDDQ) feature is not supported in the Access Gateway mode. fms Notifies the configured MAPS threshold events to the FICON Management Server (FMS). toggle Enables port toggling to recover a port from bottleneck condition caused by the target device. Port toggle is supported only for the F_Ports.
mapsRule --delete rule_name [-force] Deletes a monitoring rule. The -force option provides the capability to override the default behavior. This option allows deleting only user-defined rules. The -force option fails if a default rule is input as an argument. --config rule_name Modifies a monitoring rule. You cannot modify a default rule. Specify only the operands that you want to modify. Refer to mapsrule --create for a listing of operands and their descriptions.
mapsRule To delete a rule: switch:admin> mapsrule --delete New_Cntr_High To clone a rule with a modified timebase: switch:admin> mapsrule --clone Rule1 -rulename NewRule2 -timebase Hour To display a single rule: switch:admin> mapsrule --show defRuleITWAboveHighPF Rule Data: ---------RuleName: defRuleITWAboveHighPF Actions: Raslog Condition: ALL_PORTS(ITW/MIN>25) Policies Associated: none To display all of the rules configured on a switch: switch:admin> mapsrule --show -all Rule Name |Condition |Actions
mapsRule To display all of the rules configured on a switch with legends for action names: switch:admin> mapsrule --show -all -concise Rule Name |Condition |Actions | ----------------------------------------------------------------------------------------------------------defNON_E_F_PORTSCRC_0 |NON_E_F_PORTS(CRC/MIN>0) |RS,SN,EM | defNON_E_F_PORTSCRC_2 |NON_E_F_PORTS(CRC/MIN>2) |PF,SN,EM | defNON_E_F_PORTSCRC_10 |NON_E_F_PORTS(CRC/MIN>10) |RS,SN,EM | defNON_E_F_PORTSCRC_20 |NON_E_F_PORTS(CRC/MIN>20) |PF,SN
mapsSam mapsSam Generates or clears reports to display CPU, RAM, and flash memory usage, and the port status for every physical and virtual Fibre Channel port on the switch. Synopsis mapssam --show[cpu | memory | flash] mapssam --clear mapssam --help Description Use this command to generate the reports to display CPU, RAM, and flash memory usage, and the port status for every physical and virtual Fibre Channel port on the switch. This command provides an option to clear the reports.
mapsSam --clear Clears the SAM report. --help Displays the command usage.
memShow memShow Displays the amounts of free and used memory in a switch. Synopsis memshow [-b | -k | -m] Description Use this command to display free and used memory in the switch, as well as the shared memory and buffers used by the kernel. Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
motd motd Sets the banner on the chassis. Synopsis motd --set string motd --show Description Use this command to set the banner on the chassis. The banner is a string of alphanumeric characters. It is displayed before you log in to a switch. Notes Operands The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
msCapabilityShow msCapabilityShow Displays the Management Server (MS) capabilities. Synopsis Description Notes mscapabilityshow Use this command to display the supported capabilities of the Management Server for each switch in the fabric. An asterisk displays next to the name of the local switch. Reliable commit service (RCS) is a fabric-wide capability and is supported only if all the switches in the fabric support the service.
msConfigure msConfigure Configures the Management Server (MS) access control list (ACL). Synopsis Description msconfigure 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. If the MS ACL is empty (default), The MS is available to all systems connected to the fabric.
msConfigure 20:03:00:60:69:00:60:10 20:02:00:60:69:00:60:03 20:02:00:60:69:00:60:15 0 Done 1 Display the access list 2 Add member based on its Port/Node WWN 3 Delete member based on its Port/Node WWN select : (0..3) [1] 0 done ...
msPlatShow msPlatShow Displays the Management Server (MS) platform database. Synopsis Description Notes msplatshow Use this command to display information from the MS platform database. This command displays the name of each platform object with the platform type (GATEWAY, HOST_BUS_ADAPTER, and so forth), associated management addresses, and associated node names. The execution of this command is subject to Virtual Fabric restrictions that may be in place.
msPlatShowDBCB msPlatShowDBCB Displays the Management Server (MS) platform service database control block. Synopsis Description Notes msplatshowdbcb Use this command to display the control block fields associated with the platform database. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
msPlClearDB msPlClearDB Clears the Management Server (MS) platform database on all switches in the fabric. Synopsis Description Notes msplcleardb Use this command to clear the MS platform database in the entire fabric. Because this operation cannot be undone, it should not be performed unless it is intended to resolve a database conflict between two joining fabrics or to establish an entirely new fabric with an empty database.
msPlMgmtActivate msPlMgmtActivate Activates the Management Server (MS) platform service. Synopsis Description Notes msplmgmtactivate Use this command to activate the MS platform service throughout the fabric. This command attempts to activate the MS platform service for each switch in the fabric. The change takes effect immediately and is committed to the configuration database of each affected switch. MS activation is persistent across power cycles and reboots.
msPlMgmtDeactivate msPlMgmtDeactivate Deactivates the Management Server (MS) platform service. Synopsis Description Notes msplmgmtdeactivate Use this command to deactivate the MS platform service throughout the fabric. This command deactivates the MS platform service for each switch in the fabric and commits the change to nonvolatile storage. When an FCS policy is enabled, this command can be issued only from the primary FCS switch.
msTdDisable msTdDisable Disables the Management Server (MS) topology discovery service. Synopsis mstddisable ["ALL"] Description Use this command to disable the management server topology discovery service on a local switch or an entire fabric. This change takes effect immediately and commits to the configuration database for all affected switches. The change is persistent across power cycles and reboots.
msTdEnable msTdEnable Enables the Management Server (MS) topology discovery service. Synopsis mstdenable ["ALL"] Description Use this command to enable the MS topology discovery service on the local switch or throughout the fabric. The change takes effect immediately and commits to the configuration database for all affected switches. The change is persistent across power cycles and reboots.
msTdReadConfig msTdReadConfig Displays the status of The Management Server (MS) topology discovery service. Synopsis Description Notes mstdreadconfig Use this command to check whether or not the management server topology discovery service is enabled. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
myId myId Displays the current login session details. Synopsis Description myid Use this command to display the status of the system and the login session details. This includes IPv4 or IPv6 addresses associated with the login session. The login session gives details of the following: • • • • Notes CP/switch (or console/serial port) used to log in. The IP address of the current login session for Telnet or the name of the current console port or the serial port (if modem login used).
nbrStateShow nbrStateShow Displays the state of FSPF neighbors. Synopsis Description nbrstateshow [slot/][port] Use this command to display information about fabric shortest path first (FSPF) neighbors to the local switch or information about a neighbor to a specified port. FSPF defines a neighbor as a remote E_Port interface that is directly attached to the local switch. However, if ports are trunked, the command displays data only about the trunk master.
nbrStateShow ROUTABLE The port is ready to receive frames. ROUTABLE_WAIT The port is waiting for notification from the neighbor. ROUTABLE_SEND The port is preparing for local route update; negotiates for the necessary locks before updating the routes. ROUTABLE_TIMER The request for one or more locks failed; delay for a short interval before retrying. DONE The port is online and in use. DECOM_START The decommissioning request is sent to the neighbor and waiting for a response.
nbrStateShow 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 Sub-State ----------------------------------------------------16 2 48 NB_ST_FULL DONE SEE ALSO interfaceShow Brocade Fabric OS Command Reference 53-1004112-02 555
nbrStatsClear nbrStatsClear Resets FSPF interface counters. Synopsis nbrstatsclear [slot/][port] Description Use this command to reset the counters of fabric shortest path first (FSPF) frames transmitted and received on all interswitch links (ISLs) or on a specified ISL Use this command without operands to reset counters on all interfaces. Use interfaceShow to view the FSPF counters. Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place.
nbrStatsClear To reset the counters on a port: switch:admin> nbrstatsclear 1/0 To verify the changes: switch:admin> interfaceshow 1/0 idbP = 0x10050a38 Interface 0 data structure: nghbP ifNo masterPort defaultCost cost = = = = = 0x1004ce68 0 0 (self) 500 500 (output truncated) SEE ALSO interfaceShow, portShow, switchShow Brocade Fabric OS Command Reference 53-1004112-02 557
nodeFind nodeFind Displays all device Name Server (NS) entries matching a given WWN, device PID, or alias. Synopsis Description nodefind WWN | PID | ALIAS Use this command to display the NS information for all devices in the fabric that have either a port world wide name (WWN) or a node WWN matching the given WWN; or have a device PID matching the given PID; or have a defined configuration alias to which the device belongs matching the given alias.
nodeFind To display device information for a string for which there is no match: switch:user> nodefind abcd No device found.
nsAliasShow nsAliasShow Displays local Name Server (NS) information, with aliases. Synopsis Description nsaliasshow [-r][-t] | -domain domain_id | --help Use this command to display local name server information with the added feature of displaying the defined configuration aliases to which the device belongs. If there are no defined configuration aliases for that device, no alias is displayed.
nsAliasShow -t Displays the device type. The device type is defined in terms of two attributes. The first attribute indicates the origination of the device as one of the following: • • • • Physical -The device is connected to the NX_Port, using FLOGI to log in to the switch. Virtual -The device is contrived by the switch. NPV -The device is connected to the NX_Port, using FDISC to log in to the switch. iSCSI Device is connected to the iSCSI port. The second attribute indicates the role of the device.
nsAliasShow Device Shared in Other AD: No Redirect: No Partial: No Aliases: DeviceAlias The Local Name Server has 3 entries } To display local NS information with aliases with the -r option: switch:user> nsaliasshow -r { Type Pid COS PortName NodeName SCR N 010600;3;20:06:00:05:1e:38:81:71;10:00:00:05:1e:38:81:71; 0 Fabric Port Name: 20:06:00:05:1e:7a:7a:00 Permanent Port Name: 20:06:00:05:1e:38:81:71 Port Index: 6 Share Area: No Device Shared in Other AD: No Redirect: No Partial: No Aliases: MyAlias1 MyA
nsAliasShow N 010601;3;23:0d:00:05:1e:38:81:71;50:00:51:e3:88:17:10:0d; 3 FC4s: FCP PortSymb: [44] "Brocade Ioblaster Port Entity #00,pid#10601." Fabric Port Name: 20:06:00:05:1e:7a:7a:00 Permanent Port Name: 20:06:00:05:1e:38:81:71 Device type: NPIV Unknown(initiator/target) Port Index: 6 Share Area: No Device Shared in Other AD: No Redirect: No Partial: No Aliases: N 010602; 3;10:00:00:00:00:00:00:01;10:00:00:00:00:00:00:01; 3 FC4s: FCP PortSymb: [41] "Brocade Ioblaster Initiator#00,pid#10602.
nsAliasShow Device Shared in Other AD: No Redirect: No Partial: No Aliases: N 5c1700; 3;23:00:00:05:1e:53:e3:8a;50:00:51:e5:3e:38:a0:00; FC4s: FCP PortSymb: [34] "Brocade DPC Entity-Slot#00,DPC#00.
nsAllShow nsAllShow Displays global name server information. Synopsis nsallshow [type] Description Use this command to display the 24-bit Fibre Channel addresses of all devices in all switches in the fabric. When used with the type operand, the command displays only devices of the specified FC-4 type. FC-4 type codes are referenced in the Fibre Channel Framing and Signaling (FC-FS) standards documentation (see "TYPE codes FC-4"). When used without operand, all devices are displayed.
nsCamShow nsCamShow Displays information about remote devices in the Name Server (NS) cache. Synopsis Description nscamshow [-t] Use this command to display the local NS cache information about the devices discovered in the fabric by the NS cache manager.
nsCamShow Notes Operands The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. The following operand is optional: -t Displays the device type. The device type is defined in terms of two attributes. The first attribute indicates the origination of the device as one of the following: Physical The device is connected to the NX_Port, using FLOGI to log in to the switch.
nsCamShow PortSymb: [45] "Brocade VDPC Entity-Slot#00,DPC#00,Entity#02." Fabric Port Name: 20:12:00:05:1e:53:e3:8a Permanent Port Name: 23:04:00:05:1e:53:e3:8a Port Index: 18 Share Area: No Device Shared in Other AD: No Redirect: No Partial: No Port Properties: SIM Port N 5c1300; 3;23:02:00:05:1e:53:e3:8a;50:00:51:e5:3e:38:a0:02; FC4s: FCP PortSymb: [45] "Brocade VDPC Entity-Slot#00,DPC#00,Entity#01.
nsCamShow Device Shared in Other AD: No Redirect: No Partial: No Port Properties: SIM Port (output truncated) SEE ALSO nsAllShow, nsAliasShow, nsShow, switchShow Brocade Fabric OS Command Reference 53-1004112-02 569
nsDevLog nsDevLog Manages device history logging. Synopsis nsdevlog --show [[-slot slot] -port port | -pid pid | -wwpn wwpn | -wwnn nwwn | -event event] nsdevlog --enable nsdevlog --disable nsdevlog --clear nsdevlog --help Description Notes Operands Use this command to manage Name Server (NS) device logging. By default, logging is enabled. The NS records the PortIndex, PID, world wide node name (WWNN), world wide port name (WWPN) and the event (login and logout).
nsDevLog -event event Displays device logs for the specified event. The events are the following: • • • • • • • • • "Register": Entry created by explicit NS registration, "Deregister": Entry deleted by explicit NS deregistration. "Device Add": Entry created based on UPD Area. "Device Del": Entry deleted based on UPD Delete. "Device Add (Query)": Entry created by NS query from the device. "Port Del": Entries deleted based on DEL Area. "Dup WWN": Entry deleted based on Duplicate WWN.
nsDevLog To clear device logs: switch:admin> nsdevlog --clear Device History logs cleared To display device logs: switch:admin> nsdevlog --show Total number of Logged entries = 0 Total number of Entries displayed = 0 Max number of entries: 65536 Device Logging is currently disabled SEE ALSO 572 nsAliasShow, nsAllShow, nsCamShow, nsShow, nsZoneMember Brocade Fabric OS Command Reference 53-1004112-02
nsShow nsShow Displays local Name Server (NS) information. Synopsis Description nsshow [-r][-t] Use this command to display local NS information about devices connected to a switch. If no information is available for the switch, the command displays the following message: "There is no entry in the Local Name Server." Use nsAllShow to display NS information for all switches in the fabric. Each line of output displays the following information: Type Displays U for unknown, N for N_Port, NL for NL_Port.
nsShow Redirect Displays "Yes" if the device is involved in frame redirection; otherwise displays "No". The device involved in frame redirection is specified as either "virtual" , "host", or "target". Partial Displays "Yes" if the device entry is incomplete; otherwise displays "No". Devices that are incomplete are displayed by the nsShow and nsCamShow commands, and have routing established, but are not considered during device discovery (for example, during FC-GS Name Server Queries).
nsShow SCR=0x00000003 Register to receive all RSCN requests issued. The RSCN request returns all effected N_Port_ID pages. The following SCR values use the 4th byte of the SCR value and can coexist with the SCR values of 0x00000000, 0x00000001, 0x00000002, and 0x00000003. SCR=0x01000000 Principal switch RSCN registration. Register to receive proprietary RSCN (principal switch change). SCR=0x02000000 AG_QOS RSCN registration. -t Displays the device type.
nsShow Redirect: No Partial: No LSAN: No Device link speed: 8G N 010e00;3;21:00:00:e0:8b:12:8a:be;20:00:00:e0:8b:12:8a:be;na FC4s: FCP NodeSymb: [41] "QLA2340 FW:v3.03.06 DVR:v9.0.0.
nsShow To display local name server information with -r and -t options. switch:user> nsshow -r -t { Type Pid COS PortName NodeName SCR N 010100; 3;21:00:00:e0:8b:13:08:10;20:00:00:e0:8b:13:08:10; \ 0x00000001 FC4s: FCP NodeSymb: [41] "QLA2340 FW:v3.03.06 DVR:v9.0.0.
nsZoneMember nsZoneMember Displays the information on online devices zoned with a specified device. Synopsis nszonemember pid | wwn nszonemember -a | -n | -u nszonemember [-domain domain] [-index index] nszonemember --help Description Use this command to display information on all online devices zoned with the specified device. The device can be specified by WWN or Port ID (PID). Use this command with the -u option to display all unzoned devices in the entire fabric.
nsZoneMember Additional lines may display if the device has registered any of the following information (the switch automatically registers SCSI inquiry data for FCP target devices): • • • • • • Notes Operands FC4 supported IP address (node) IPA port and node symbolic name (local device only) fabric port name hard address or port IP address The execution of this command is subject to Virtual Fabric restrictions that may be in place.
nsZoneMember FC4s: FCP [SEAGATE ST318304FC 0005] Fabric Port Name: 20:06:00:60:69:50:06:78 Permanent Port Name: 22:00:00:20:37:d9:61:ac Device type: Physical Target No remote zoned members To display information about all the online devices zoned with the given WWN: switch:admin> nszonemember 10:00:00:00:c8:23:0b:ad 3 local zoned members: Type Pid COS PortName NodeName SCR NL 041901;2,3;10:00:00:00:c9:26:0e:ae;20:00:00:00:c9:26:0e:ae;3 Fabric Port Name: 20:09:00:60:69:50:06:78 Permanent Port Name: 10:00:0
nsZoneMember Pid: 0xe07d00 Aliases: hds9200_6p4 hds9200_6p4 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 device data for a local device with the specified port index: switch:admin> nszonemember -index 2 Port Index: 2 Pid: 0x015200 Zoned Members: 2 devices Pid: 0x015200 Aliases: ali_b1 Pid: 0x03a840 Aliases: ali_b1 To display zoned device data for a device (either loca
nsZoneShow nsZoneShow Displays the zone names. Synopsis nszoneshow -pid pid nszoneshow -wwn wwn nszoneshow -pid "pid1,pid2" nszoneshow -wwn "wwn1,wwn2" Description Use this command to display the zone names that a specified device or device-pair are part of. The devices can be zoned as part of regular zones, Traffic Isolation (TI) zones, or Frame Redirect (RD) zones.
nsZoneShow Examples To display the zone names for a device with a specified PID: switch:admin> nszoneshow -pid 0x010200 Zone Names ================= zn_test1 zn_test2 ================= To display the common zone for two devices specified by a WWN pair: switch:admin> nszoneshow \ wwn "20:08:00:05:1e:a3:01:d9,20:01:00:05:1e:a3:01:d9" Zone Names ================= zn_test2 ================= To display the RD zone name: switch:admin> cfgshow Defined configuration: cfg: myHTcfg myHostTarget cfg: r_e_d_i_r_c__
openSource openSource Displays open-source licenses. Synopsis Description Notes opensource Displays listing of open source elements, licenses, and code samples used in Fabric OS. Refer to the Linux documentation for more information on how to use this command. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
passwd passwd Changes the password for a specified user. Synopsis Description passwd [user_account] [-old old_password] [-new new_password] Use this command to change a user account password. Passwords can be changed locally on any switch. For the password database to be distributed to other switches in the fabric, the switches must be configured to accept the password database with the fddCfg command. The password database is distributed manually with the distribute command.
passwd 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. Alternately, you may specify the old and new password on the command line. • If a you are changing another user's password with greater privileges than your current login level, you are prompted to enter that user level's old password and, if your entry is valid, you are prompted for a new password.
passwd Password unchanged You have entered the carriage return special input case, choosing not to change the password. Passwords do not match You have not correctly verified the new password. Invalid length of password You have entered a password length that is not between minlength and 40. Insufficient number of lower case letters The password you entered contains less than the minimum required number of lowercase characters.
passwd To change the password for user "brocadeUser" from an admin account noninteractively: switch:admin> passwd brocadeUser -old brcdPasswd -new mynewPasswd Password changed. Saving password to stable storage. Password saved to stable storage successfully.
passwdCfg passwdCfg Manages the password policies. Synopsis passwdcfg --set options value passwdcfg --setuser username options value passwdcfg --disableadminlockout passwdcfg --enableadminlockout passwdcfg --setdefault passwdcfg --showall passwdcfg --showuser username passwdcfg --deleteuser username passwdcfg --deleteuser -all passwdcfg --hash md5 | sha256 | sha512 [-manual] passwdcfg --showhash [username | -all] passwdcfg --help Description Use this command to manage password policies.
passwdCfg The password expiration policy forces expiration of a password after a specified period of time. When a user's password expires, the user must change the password to complete the 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 parameter. Password expiration does not disable or lock out the account.
passwdCfg -uppercase value Specifies the minimum number of uppercase alphabetic characters that must occur in the password. The default value is 0. The maximum value must be less than or equal to the -minlength value. -digits value Specifies the minimum number of numeric digits that must occur in the password. The default value is 0. The maximum value must be less than or equal to the -minlength value.
passwdCfg -lockoutduration value Specifies the time, in minutes, after which a previously locked account automatically unlocks. lockoutduration values range from 0 to 99999. The default value is 30. Setting this parameter to 0 disables lockout duration, requiring an administrative action to unlock the account. The lockout duration begins with the first login attempt after the lockout threshold has been reached. Subsequent failed login attempts do not extend the lockout period.
passwdCfg --enableadminlockout Enables the admin lockout policy and sets the config parameter "passwdcfg.adminlockout" to 1. If the parameter "passwdcfg.lockoutthreshold" is set to greater than 0 and Admin Lockout policy is enabled, then, if the number of failed login attempts from the last successful login equals the "passwdcfg.lockoutthreshold", the account gets locked for the "passwdcfg.lockoutduration" duration.
passwdCfg Digits value out of range The -digits value specified must be greater than or equal to 0 and less than or equal to -minlength value. Punctuation value out of range The -punctuation value specified must be greater than or equal to 0 and less than or equal to -minlength value. Total strength specification out of range The total of -lowercase value, -uppercase value, -digits value, and -punctuation value must be less than or equal to -minlength value.
passwdCfg Examples To display the current password configuration parameters: switch:admin> passwdcfg --showall passwdcfg.minlength: 8 passwdcfg.lowercase: 0 passwdcfg.uppercase: 0 passwdcfg.digits: 0 passwdcfg.punctuation: 0 passwdcfg.history: 1 passwdcfg.minpasswordage: 0 passwdcfg.maxpasswordage: 0 passwdcfg.warning: 0 passwdcfg.lockoutthreshold: 0 passwdcfg.lockoutduration: 30 passwdcfg.status: 0 passwdcfg.
pathInfo pathInfo Displays routing information and statistics along a path covering multiple switches. Synopsis pathinfo pathinfo -f FID dest_switch_domain [source_port] [dest_port] [-sid source_pid] [-did dest_pid] [-r] [-t] pathinfo dest_switch_domain [source_port] [dest_port] [-sid source_pid] [-did dest_pid] [-r] [-t] pathinfo --help Description Use this command to display routing information from a source port on the local switch to a destination port on another switch.
pathInfo In a Virtual Fabric environment, pathInfo displays port numbers beyond physical port numbers while displaying information for a hop that corresponds to a path in the base fabric. The cost for this hop is the cost of the corresponding path in the base fabric plus a small offset. Refer to the Examples section for an illustration. Other command options allow the collection of information on the reverse path, or on a user-selected path (source route).
pathInfo Basic statistics Basic statistics report parameters that may indicate ISL congestion along the path. They include the following: B/s Bytes per second received or transmitted. This value is reported for multiple time periods displayed in parentheses. Txcrdz The length of time, in milliseconds, that the port was unable to transmit frames because the transmit BB credit was zero. The purpose of this statistic is to detect congestion or a device affected by latency.
pathInfo The source route can specify a full route from source to destination or a partial route. In a partial route the remaining hops are chosen as the path from the input port on the first hop not listed in the source route to the destination. The maximum hop count is enforced in both cases. If the source route does not specify all the switches along a section of the path, you can specify a strict or a loose path.
pathInfo --help Displays the command usage. When executed without operands, pathInfo runs interactively. Specifying a destination switch is required; the values for the source and destination ports can be -1 to indicate the embedded port. You must specify the source and destination PID to display the correct TI-enabled path information across the FCR. Reverse-path tracing is optional.
pathInfo 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) 9 1G 1000 3 6 91 (web225) E - To display basic path information in traceroute format: switch:admin> pathinfo 91 -t traceroute to domain 91(web225) , 25 hops Hop Domain ID (Name) time taken for the
pathInfo To display basic and extended statistics in interactive mode: switch:admin> pathinfo Max hops: (1..127) [25] Fabric Id: (1..128) [-1] Domain|Wwn|Name: [] 8 Source port: (0..200) [-1] Destination port: (0..1800) [-1] Source pid: (0x0..0xefff00) [ffffffff] Destination pid: (0x0..0xefff00) [ffffffff] Basic stats (yes, y, no, n): [no] y Extended stats (yes, y, no, n): [no] y Trace reverse path (yes, y, no, n): [no] Source route (yes, y, no, n): [no] Timeout: (1000..
pathInfo To display the TI-enabled path information over an FCR in interactive mode: switch:admin> pathinfo Max hops: (1..127) [25] Fabric Id: (1..128) [-1] 8 Domain|Wwn|Name: [] 5 Source port: (0..400) [-1] 2 Destination port: (0..400) [-1] 24 Source pid: (0x0..0xefff00) [ffffffff] 0x061600 Destination pid: (0x0..0xefff00) [ffffffff] 0x01f001 Basic stats (yes, y, no, n): [no] Extended stats (yes, y, no, n): [no] Trace reverse path (yes, y, no, n): [no] y Source route (yes, y, no, n): [no] Timeout: (1000..
pdShow pdShow Displays data from a panic dump file. Synopsis Description pdshow [panic_dump_file] Use this command to display data from a panic dump file. The panic dump file contains information that might be useful to determine the cause of the system panic. When executed without any arguments, this command displays output from the latest panic dump file available on the switch. If a panic dump file is specified as an argument, the contents of that specific file are displayed.
portAddress portAddress Assigns the lower 16 bits of the Fibre Channel Port ID. Synopsis portaddress --bind [slot/]port [16-bit_address] [--auto] portaddress --unbind [slot/]port portaddress --show [[slot/]port] portaddress --findPID 24-bit_Port_ID portaddress --help Description Use this command to bind the 16-bit address to the lower two bytes of a port 24-bit Fibre Channel address, or to unbind the currently bound address for the specified port.
portAddress 16-bit_address Specifies the 16-bit address, in hexadecimal format, to be bound to the FC address. Leading zeros are optional in the hexadecimal value (for example, you can either specify 0x1a00 or 1a00). Note that only the upper 10 bits of the PID can be used for a unique route. Therefore, not all addresses in the 16-bit range are available. --auto Enables autobinding on the specified port. If the auto feature is enabled, the entire area field of the PID is bound to a single port.
portAddress To display all port address bindings on the current partition: switch:admin> portaddress --show Partition Address Mode :0 Index Slot Port Area Mode =============================== 384 5 0 0x0800 8 bit 385 5 1 0x0900 8 bit 386 5 2 0x0a00 8 bit 387 5 3 0x0b00 8 bit 388 5 4 0x0c00 8 bit 389 5 5 0x0d00 8 bit 390 5 6 0x0e00 8 bit 391 5 7 0x0f00 8 bit 392 5 8 0x0000 8 bit 393 5 9 0x0100 8 bit 394 5 10 0x0200 8 bit 395 5 11 0x0300 8 bit 396 5 12 0x0400 8 bit 397 5 13 0x0500 8 bit 398 5 14 0x0600 8 bit
portAlpaShow portAlpaShow Displays the Arbitrated Loop Physical Addresses (AL_PAs) of devices attached to a port. Synopsis portalpashow [slot/]port Description Use this command to display the AL_PAs of devices connected to a port, and whether these devices are public or private. If the specified port is not an active FL_Port or if no AL_PAs are present, this command prints an error. Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place.
portBeacon portBeacon Sets port beaconing mode. Synopsis portbeacon --enable [slot/]port portbeacon --disable [slot/]port portbeacon --show [slot/]port portbeacon --show -all portbeacon --help Description Use this command to enable or disable beaconing mode on a specified port. When beaconing mode is enabled on a port, the port LED flashes amber and green for 2.5 seconds each in an alternating pattern. The beaconing mode continues until you turn it off.
portBeacon Operands This command has the following operands: slot For bladed systems only, specifies the slot number of the port group to display, 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. --enable Enables beaconing mode on the specified port. --disable Disables beaconing mode on the specified port. --show Displays the port beaconing mode on the specified port as ON or OFF.
portBufferCalc portBufferCalc Calculates the number of buffers required per port. Synopsis portbuffercalc [slot/]port [-distance distance] [-speed speed] [-framesize framesize] portBufferCalc --help Description Notes Use this command to calculate how many buffers are required for a given distance, speed, and framesize. You can use the same number of buffers and port speed, when configuring the portCfgLongDistance command.
portBufferCalc Examples To calculate the buffers required per port: switch:admin> portbuffercalc 9/4 \ -distance 100 -speed 8 -framesize 512 1606 buffers required for 100km at 8G and framesize of 512 bytes SEE ALSO 612 portCfgLongDistance Brocade Fabric OS Command Reference 53-1004112-02
portBufferShow portBufferShow Displays the buffer usage information for a port group or for all port groups in the switch. Synopsis Description portbuffershow [[slot/]port] Use this command to display the current long distance buffer information for the ports in a port group. The port group can be specified by giving any port number in that group. If no port is specified, then the long distance buffer information for all of the port groups of the switch is displayed.
portBufferShow 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), 2 km (4 Gbps), or 1 km (8 Gbps). For static long distance mode (LE), the fixed distance of 10 km displays. For LD mode, the distance in kilometers displays as measured by timing the return trip of a MARK primitive that is sent and then echoed back to the switch. LD mode supports distances up to 500 km.
portBufferShow 192 - 8 - ( - ) - ( - )\ 193 8 - ( - ) - ( - )\ 0 194 8 - ( - ) - ( - ) 0 195 8 - ( - ) - ( - )\ 0 196 8 - ( - ) - ( - )\ 0 197 8 - ( - ) - ( - )\ 0 198 8 - ( - ) - ( - )\ 0 199 8 - ( - ) - ( - )\ 0 4556 -----------------------------------------------------------0 SEE ALSO portCfgLongDistance Brocade Fabric OS Command Reference 53-1004112-02 615
portCamShow portCamShow Displays port-based filter CAM utilization. Synopsis Description portcamshow [slot/]port Use this command to display the current filter Content-Addressable Memory (CAM) utilization of a specified port. The command displays the following information: SID used Total number of CAM entries used by this port. Note that each CAM entry, either source ID (SID) or destination ID (DID) CAM, can be shared among a certain number of ports, depending on the ASIC.
portCamShow port Specifies the port number to display, relative to its slot for bladed systems. Use switchShow to list valid ports. This operand is required.
portCfg portCfg Manages port configuration parameters for FC ports, VE_ports, and GbE/10GbE ports. Synopsis portcfg action [slot/] port arguments portcfg action [slot/] ge_port arguments portcfg action [slot/]ve_port options arguments portcfg action [slot/][ge_port options arguments Description Use this command to manage port configuration parameters on FC ports as well as on Gigabit Ethernet (GbE) ports on the Brocade 7840 switch and on the Brocade FX8-24 and Brocade SX6 blades.
portCfg Notes IPv6 addresses are supported except for inband management. IP Security enabled FCIP Tunnels cannot use IPv6 circuits on FX8-24 blade. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. Some of the features supported by this command may require a license. The Fabric OS port configuration commands are not supported on FCoE ports.
portCfg mirrorport Configures a mirror port on the local port. The port mirroring feature reroutes data frames between two devices to the mirror port. Port mirroring can aid in troubleshooting common FC end-to-end communication problems. The command prompts for confirmation that the specified port be enabled as a mirror port. Once a port is configured as a mirror port, the port can only be used as part of a mirror connection. Port Mirroring is not supported over FCIP links (VE tunnels).
portCfg Description Use this command to configure the local IP interfaces and static routes on the Brocade 7840 switch, and Brocade FX8-24 and Brocade SX6 blades. You must configure the local IP interfaces before you can create and configure FCIP tunnels. You can also create a VLAN configuration at the IP interface on the Brocade 7840 switch, and Brocade FX8-24 and Brocade SX6 blades. • • • Operands portcfg ipif - Configure the local IP interfaces.
portCfg The IP network connection is configured by defining IP interfaces for origin and destination virtual ports, and then defining one or more IP routes to connect them. The syntax for portCfg ipif is as follows: portcfg ipif [slot/]ge_port option args [optional_args] Valid options and arguments for ipif include the following: create src_ipaddr netmask mtu [mask] mtu_size vlan [vlan_id] Creates IP interfaces.
portCfg Valid options and arguments for iproute include the following: create dest_ipaddr netmask [mask] [gateway_router] Creates an IP route. Specify the following: dest_ipaddr Specifies the destination IP address in either IPv6 or IPv4 format: dest_IPv6_addr/prefix_len Specifies the destination IPv6 address of the port, if IPv6 is used. The address must be an IPv6 global, unicast address, followed by a prefix. This is used for IPv6 addresses instead of a netmask. The prefix_len operand is required.
portCfg vlantag Use this command to maintain the VLAN tag table associated with a particular network interface. This command is suppoted on Brocade FX8-24 blade. This table is mainly used during ingress processing to filter VLAN tagged frames. You can configure multiple VLAN IDs per IP interface; however, if you provide a destination address, there cannot be two entries to the same destination, including 0.0.0.0.
portCfg This command supports create, modify, and delete options only. The syntax for portcfg ipsec-policy is as follows: portcfg ipsec-policy name option [args] Valid options and arguments for ipsec-policy include the following: create name [-k | --preshared-key key] Creates the IPsec policy. name Specifies the name for the IPsec policy. -k | --preshared-key key Specifies the preshared key to be used for authentication. This operand is optional.
portCfg --enable -autoneg Enables the auto negotiation mode for the LAG port members. --disable -autoneg Disables the auto negotiation mode for the LAG port members. tcl Creates a TCL. This command supports create, modify, and delete options only. The syntax for portcfg tcl is as follows: portcfg tcl name option [args] Valid options and arguments for tcl include the following: name Specifies the name of the TCL. The TCL name can be up to 31 characters long and cannot contain special characters.
portCfg -v | --vlan value Set the VLAN input filter for the specified TCL. The range is from 0 to 4095. --l2cos value Sets the Layer 2 CoS input filter for the specified TCL. --l4proto num | name Sets the Layer 4 protocol input filter for the specified TCL. Valid values for name are TCP, UDP, ICMP, VRRP and the valid range for num is from 0 through 255, or 'none' to clear the Layer 4 protocol input filter.
portCfg enable Re-enables the inband management interface at the specified GbE Port after it has been disabled. The interface is by default enabled when it is created. mgmtroute Configures the management route for the inband management interface (needed only if the management interfaces are on different subnets).
portCfg --loss percentage Sets the packet-loss percentage. The valid range is from 0.05 through 5.0 percentage. --runtime min Sets duration time for the test to run. The valid range is from 1 through 1440 minutes. The default value is 5 minutes. --timeout min | none Sets the timeout duration for the test. If the timeout value is reached during the SLA session, the session is terminated and the circuit is put into service. Specify none to run the test until the runtime and packet-loss values are met.
portCfg To create an interface for a failover crossport on a Brocade FX8-24: 1. Configure the interface for the local XGE port (xge0). switch:admin> portcfg ipif 8/xge0 create \ 192.169.0.20 netmask 255.255.255.0 mtu 1500 Operation Succeeded 2. Configure the interface for the nonlocal XGE port (xge1). switch:admin> portcfg ipif 8/xge1 create \ 192.169.0.20 netmask 255.255.255.0 -x Operation Succeeded 3. The IP address 192.168.11.
portCfg ge0 2000::1:250 / 128 * U H L ge0 2010:: / 64 2000::1:250 U G S -------------------------------------------------------------------------------Flags: U=Usable G=Gateway H=Host C=Created(Interface) S=Static L=LinkLayer X=Crossport To create an IP route for a failover crossport on a Brocade FX8-24: 1. Configure the iproute for the local XGE port (xge0). switch:admin> portcfg iproute 8/xge0 create 2.2.2.0 \ netmask 255.255.255.0 192.168.11.250 Operation Succeeded 2.
portCfg To display the VLAN tag configuration (for an explanation of the flags, refer to portShow): switch:admin> portshow vlantag ge2 Port: ge2 Interface Address VlanId L2CoS Flags Destination Address ------------------------------------------------------------192.168.2.10 200 5 Perm Net 0.0.0.0 192.168.0.20 100 0 Perm 192.168.0.10 192.168.0.21 200 0 Perm 192.168.0.
portCfg To create a LAG: switch:admin> portcfg lag lag0 --create Operation Succeeded To add ports to a LAG and verify the configuration: switch:admin> portcfg lag lag0 --add ge2-ge4,ge7 Operation Succeeded switch:admin> portshow lag LAG Name State Port Count Member Ports -----------------------------------------------lag0 Online 4 GE2,GE3,GE4,GE7 ------------------------------------------------ To remove a port from a LAG: switch:admin> portcfg lag lag0 --remove ge7 Operation Succeeded To create a TCL:
portCfg To enable the autonegotiation of a 1GbE port: switch:admin> portcfg autoneg 1/ge2 --enable Operation Succeeded switch:admin> portshow autoneg 1/ge2 Auto-Negotiation Configuration: Port: 1/ge2 Auto-Negotiate: Enabled To create an SLA session: switch:admin> portcfg sla netA create --loss 0.5 \ --runtime 15 --timeout 60 Operation Succeeded Function Configure tunnels, circuits, and management interfaces on the Brocade 7840 switch and Brocade FX8-24 and Brocade SX6 extension blades.
portCfg ve_port Specifies the number of the VE_Port associated with the tunnel. The VE_Ports are numbered 24-43 on the Brocade 7840, 16-35 on the Brocade SX6, and 12-31 on the Brocade FX8-24. fciptunnel Creates, modifies, or deletes an extension tunnel. Note the following port mapping rules: DP0 ports DP1 ports 7840 24-33 34-43 SX6 16-25 26-35 FX8-24 22-31 (xge0) 12-21 (ge0-ge9,xge1) The valid VE ports on the Brocade 7840 switch are VE_Ports 24-43.
portCfg -b | --min-comm-rate value -B | --max-comm-rate value You may set a minimum and a maximum for the committed rate to configure the tunnel for Adaptive Rate Limiting (ARL), which allows for a more effective sharing of bandwidth between applications. For Brocade FX8-24, the valid range is 10,000 Kbps to 1,000,000 Kbps for 1G ports and 10,000 Kbps to 10,000,000 Kbps for 10G ports. For Brocade 7840, the valid range is 20,000 Kbps to 10,000,000 Kbps.
portCfg -c | --compression compression_level Configures compression on the specified FCIP tunnel. By default, compression is disabled. Specify one of the following values on the FX8-24 blades: none Compression disabled hardware Enable standard compression. moderate Enable moderate compression. aggressive Enable aggressive compression. auto enable auto compression. Automatically adjusts compression level based on the maximum configured tunnel bandwidth.
portCfg default Enable default compression level. deflate Enable deflate compression. fast-deflate Enable fast-deflate compression. none Compression disabled. --ip-compression compression_level Configures IP compression on the specified FCIP tunnel. By default, compression is disabled. This operand is supported on the Brocade 7840 switch and the Brocade SX6 extension blade only. Specify one of the following values for compression_level: aggr-deflate Enable aggressive deflate compression level.
portCfg -i | --ipsec [policy_name | none] Sets the Internet Protocol Security (IPsec) on the specified tunnel to use the specified IPsec Policy, or to disable IPsec for the tunnel if the 'none' operand is used. This argument is supported on the Brocade 7840 switch and the Brocade SX6 extension blade only. -p | --distribution mode[,ratio,...] Sets tunnel bandwidth distribution mode. The valid modes are protocol, priority, and default.
portCfg --ficon-tape-read [disable | enable] Enables or disables FICON Tape Read Pipelining. This feature improves performance for certain applications when reading from FICON tape over extended distances. --ficon-tin-tir [disable | enable] Enables or disables FICON TIN/TIR emulation. This feature enhances recovery when a TIN/TIR exchange occurs as part of a channel recovery operation during tape emulation. This feature is enabled by default (recommended setting).
portCfg --max-write-devs value Defines the maximum number of concurrent emulated tape write operations. As concurrency increases, the value of emulation decreases. Excessive concurrency has the potential to oversubscribe packet data memory. The setting has significance only for host (channel) initiated operations at this side and will not affect tape write operations initiated by hosts (channels) attached The default value is 16. The range is 1 to 32.
portCfg -C | --connection-type [default | listener | initiator] Specifies whether the circuit is the listener or the initiator. In default mode, the initiator and listener are automatically chosen based on the lower and higher-order IP address. This can cause a problem in Network Address Translation (NAT) environments, if both sides of the circuit have lower-order addresses. -L | --load-leveling [default | failover | spillover] Configures spillover or failover load-balancing method.
portCfg -v | --vlan-tagging vlan_id Creates an extension tunnel with VLAN Tagging and Class of Service (CoS). Specify a vlan_id in the range between 1 and 4094. If any other VLAN option is specified, the VLAN ID must also be specified. Refer to the IEEE 802.1p specification for more information. You can configure VLAN tags when you create a circuit or after the fact by modifying a circuit. Note that adding or modifying the VLAN configuration after a circuit has been created is a disruptive operation.
portCfg --dscp-high dscp Specifies the DSCP value for FC High Priority. The range is 0 to 63. The default value is 0. --dscp-medium dscp Specifies the DSCP value for FC Medium Priority. The range is 0 to 63. The default value is 0. --dscp-low dscp Specifies the DSCP value for FC Low Priority. The range is 0 to 63. The default value is 0. --dscp-ip-high dscp Specifies the DSCP value for IP High Priority. The range is 0 to 63. The default value is 0.
portCfg --local-ha-ip ipaddress | none Sets the local HA IP address to use for the circuit. This argument is applicable on the Brocade 7840 switch and the Brocade SX6 extension blade only. --remote-ha-ip ipaddress | none Sets the remote HA IP address to use for the circuit. This argument is applicable on the Brocade 7840 switch and the Brocade SX6 extension blade only. -S | --local-ip local_ip_addr Specifies the IP address for the local end of the circuit.
portCfg switch:admin> portcfg fcipcircuit 1/12 create 1 192.168.50.61 192.168.51.68 -b 300000 -B 500000 Operation succeeded To display circuit 1: switch:admin> portshow fcipcircuit 1/12 1 ------------------------------------------Circuit ID: 1/12.1 Circuit Num: 1 Admin Status: Enabled Oper Status: In Progress Remote IP: 192.168.51.61 Local IP: 192.168.51.
portCfg To create a circuit on the tunnel with the failover group ID and verify the configuration (in this example, the OpStatus "FGrpWrn" indicates that the failover group is defined but there is not at least one metric 0 and one metric 1 circuit as part of the failover group): switch:admin> portcfg fcipcircuit 1/22 create 2 \ --remote-ip 1.42.128.93 --local-ip 1.42.128.
portCfg operation will bring the existing circuit down (if circuit is up) before applying new configuration. Continue with Modification (Y,y,N,n): [n] y Operation Succeeded 4. Modify existing circuit to change DSCP marking values switch:admin> portcfg fcipcircuit 16 modify 0 \ --dscp-f 32 --dscp-h 16 --dscp-m 8 --dscp-l 4 Operation Succeeded 5. Display the tunnel configuration and circuit values.
portCfg Failover Group : VLAN-ID : L2Cos (FC:h/m/l) : L2Cos (IP:h/m/l) : DSCP (FC:h/m/l) : DSCP (IP:h/m/l) : cfgmask : Flow Status : ConCount/Duration : Uptime : Stats Duration : Receiver Stats : Sender Stats : TCP Bytes In/Out : ReTx/OOO/SloSt/DupAck: RTT (min/avg/max) : Wan Util : 0 NONE 0 / 0 / 0 (Ctrl:0) 0 / 0 / 0 16 / 8 / 4 (Ctrl:32) 0 / 0 / 0 0x40000000 0x01e10c2f 0 2 / 2h42s 1h31m59s 1h31m59s 515664 bytes / 3307 pkts / 415636 bytes / 3269 pkts / 19805096 / 23191360 0 / 0 / 0 / 0 1 / 1 / 1 ms 0.
portCfg To modify an existing circuit so it becomes the listener: switch:admin> portcfg fcipcircuit 16 modify 2 -C 1 !!!! WARNING !!!! Modify operation can disrupt the traffic on the fcipcircuit specified \ for a brief period of time. This operation will bring the existing \ circuit down (if circuit is up) before applying new configuration.
portCfgAlpa portCfgAlpa Configures the AL_PA offset on a specified port or range of ports. Synopsis Description portcfgalpa [slot/]port, mode Use this command to set the Arbitrated Loop Physical Address (AL_PA) offset on a port or a range of ports to either 0x0 (default) or 0x13. Changes made by this command are persistent across switch reboots and power cycles. Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place.
portCfgAutoDisable portCfgAutoDisable Manages the port autodisable configuration.
portCfgAutoDisable port[-port] Specifies a port or a port range, relative to the slot number on bladed systems, for example, 5/17-29. --enable Enables the autodisable feature on the specified ports. --disable Disables the autodisable feature on the specified ports. --add Specifies one or more trigger conditions that will disable the specified ports. Trigger conditions must be separated by a space, for example, LOSN OLS LIP. Trigger conditions are case insensitive.
portCfgAutoDisable LIP Loop Initialization Primitive Sequence Examples To disable the port autodisable feature on single port: switch:admin> portcfgautodisable --disable 18 switch:admin> portcfgautodisable --show 18 Port Auto Disable: OFF Configured Option(s):No events configured. Port will not be automatically disabled.
portCfgAutoDisable MODE : RESUME Configured Option(s):No events configured. Port will not be automatically disabled. Port Auto Disable: ON MODE : RESUME Configured Option(s):No events configured. Port will not be automatically disabled.
portCfgCompress portCfgCompress Configures a port for compression. Synopsis portcfgcompress --enable [slot]/port portcfgcompress --disable [slot]/port portcfgcompress --help Description Use this command to configure a port for compression. This command enables or disables the compression configuration on the specified port, and saves the configuration persistently. Configuring a port for compression is disruptive. You must disable the port before you can enable compression on the port.
portCfgCompress --help Displays the command usage. Examples To enable the compression configuration: switch:admin> portcfgcompress --enable 2 switch:admin> lscfg --config 15 -port 2 This operation requires that the affected ports be disabled. Would you like to continue [y/n]?: y Checking for cap port 2 After Checking for cap port 2 val 1 port 2 lscfg: The port cannot be moved to the requested switch because port or ports have Encryption/Compression enabled.
portCfgCreditRecovery portCfgCreditRecovery Enables or disables credit recovery on a port. Synopsis portcfgcreditrecovery --enable [slot/]port portcfgcreditrecovery --disable [slot/]port portcfgcreditrecovery --help [slot/]port Description Use this command to enable or disable credit recovery on a port. The credit recovery feature enables credits or frames to be recovered. The default credit recovery configuration is enabled. Notes This command is supported in Access Gateway mode.
portCfgDefault portCfgDefault Resets the port configuration to factory default value. Synopsis portcfgdefault [slot/][ge]port portcfgdefault --help Description Use this command to reset all configuration values on a specified port to their factory defaults. This command persistently disables ports capable of routing, which is the factory default value. Use the portCfgShow command to display the port configuration. This command does not change the state of a port.
portCfgDPort portCfgDPort Configures a port as a D_Port. Synopsis portcfgdport --enable [-dwdm] [slot/]port_list portcfgdport --disable [-dwdm] [slot/]port_list portcfgdport --provision [-add] [-dwdm] [slot/]port_list portcfgdport --provision [-delete] [-dwdm] [slot/]port_list portcfgdport --provision [-show] [slot/]port_list portcfgdport --help Description Use this command to configure a diagnostic port (D_Port). The D_Port is not part of the fabric.
portCfgDPort Do not run D_Port tests on more than eight links at a time for normal (not long distance) links on FC16-64 blade. On a FC 16-64 blade, do not enable the On-Demand D_Port with bladeInsert or slotPowerOn. Run D_Port test on one link at a time for 100 Km long distance ports on FC 16-64 blade. D_Port tests on other long distance links must be started only after the D_Port test completes on the previous long distance link.
portCfgDPort -show Lists all the ports in the provision list. If the port range is specified, the status of each port on the provision list displays. Displays ON if the port is in the provision list or OFF if the port is not in the provision list. --help Displays the command usage. Examples To configure a single port as a D_Port: switch:admin> portdisable 42 switch:admin> portcfgdport --enable 42 Caution: D_Port functionality is only available on 16Gb-capable platforms \ with 16Gb FC SFPs, 10Gb FC SFPs,
portCfgEncrypt portCfgEncrypt Configures a port for encryption. Synopsis portcfgencrypt --enable [slot]/port portcfgencrypt --disable [slot]/port portcfgencrypt --help Description Use this command to configure a port for encryption. This command enables or disables the encryption configuration on the specified port and saves the configuration persistently. Before you can configure a port for encryption, you must configure the port for authentication.
portCfgEncrypt --enable Enables the encryption configuration on the specified port. --disable Disables the encryption configuration on the specified port. --help Displays the command usage. Examples To enable the encryption configuration: switch:admin> portcfgencrypt --enable 2 To attempt to move a configured port to another logical switch: switch:admin> lscfg --config 15 -port 2 This operation requires that the affected ports be disabled.
portCfgEport portCfgEport Enables or disables E_Port capability on a port or locks down a port as an E_Port. Synopsis portcfgeport [slot/]port mode portcfgeport -i [index1[-index2] [...] [-f] mode] portcfgeport -slot [slot1[-slot2] [...] portcfgeport -h Description Use this command to enable or disable E_Port capability on a port or to lock down a port as an E_Port. E_Port capability is enabled by default.
portCfgEport -slot [slot1[-slot2] Specifies all ports on a slot or on a range of slots, for example, -s 3-5. You may specify multiple slot ranges separated by a space, for example, -s 3-5 8-10. mode Specifies the E_Port configuration as one of the following: 0 Disables E_Port capability for the specified ports. 1 Enables the ports as E_Ports. This is the default port state. 2 Locks down the ports as E_Ports. This command effectively disables the port's F_Port capability. -h Displays the command usage.
portCfgEportCredits portCfgEportCredits Configures normal distance E_Port buffer allocation. Synopsis portcfgeportcredits --enable [slot/]port credits portcfgeportcredits --disable [slot/]port portcfgeportcredits --show [slot/]port portcfgeportcredits --help Description Use this command to change the default credit allocation for a normal distance E_Port or EX_Port by allocating the specified number of credits to the port.
portCfgEportCredits port Specifies the port number. credits Specifies the number of credits to be allocated to the specified port. The specified credit allocation takes effect when the E_Port comes online. This operand is required with the --enable option. The minimum credit allocation is 5 and the maximum is 40 for Gen5 platform (16Gbps-capable blades). For ICL ports of Gen5 platform, the valid range is from 5 through 16.
portCfgEXPort portCfgEXPort Sets a port to be an EX_Port, and sets and displays EX_Port configuration parameters.
portCfgEXPort Encryption and compression are not supported on an ICL EX_Ports. When this command is executed on ICL EX_Port without optional parameters, encryption and compression states are not displayed. Notes The fabric ID must be the same for every router port connected to the same edge fabric, and different for every edge fabric. If two ports are connected to the same fabric but have been assigned different fabric IDs, one of them will be disabled due to a fabric ID oversubscription.
portCfgEXPort -d domainid Specifies the preferred domain ID. For Brocade native mode (-m 0), valid values are 1 to 239. -p pidformat Specifies the Port ID format. Valid values are 0-native, 1-core, 2-extended edge. This operand is applicable only when port mode is set to 0 (native mode). If port mode is not "Brocade Native", the Port ID format displays as "Not applicable". -t fabric_parameter Enables or disables negotiation of the fabric parameters. Valid values are 1 for enable and 2 for disable.
portCfgEXPort To view the configuration of an EX_Port: switch:admin> portcfgexport 1/5 Port 1/5 info Admin: enabled State: OK Pid format: core(N) Operate mode: Brocade Native Edge Fabric ID: 128 Alias name: Red_fabric Preferred Domain ID: 160 Front WWN: 50:00:51:e4:44:40:0e:80 Fabric Parameters: Auto Negotiate R_A_TOV: 10000(N) E_D_TOV: 2000(N) Authentication Type: DHCHAP DH Group: 4 Hash Algorithm: SHA-1 Encryption: ON Compression: ON Forward Error Correction: ON Edge fabric's primary wwn: N/A Edge fabric
portCfgFaultDelay portCfgFaultDelay Configures the fault delay for a single FC port. Synopsis portcfgfaultdelay [slot/]port delay portcfgfaultdelay --help Description Use this command to configure the fault delay of an FC port. In the event that the link is noisy after a host power cycle, the switch may go into a soft fault state, which means a delay of R_A_TOV. Setting the mode value to 1 reduces the fault delay value to 1.2 seconds.
portCfgFaultDelay To display the configuration switch:admin> portcfgshow 2/3 Area Number: Octet Speed Combo: Speed Level: AL_PA Offset 13: Trunk Port Long Distance VC Link Init Locked L_Port Locked G_Port Disabled E_Port Locked E_Port ISL R_RDY Mode RSCN Suppressed Persistent Disable LOS TOV enable NPIV capability QOS E_Port Port Auto Disable: Rate Limit EX Port Mirror Port Credit Recovery F_Port Buffers Fault Delay: NPIV PP Limit: CSCTL mode: D-Port mode: D-Port over DWDM Compression: Encryption: FEC: 21
portCfgFaultDelay Fport Buffers .. .. .. .. .. .. .. .. .. .. .. .. .. .. Port Auto Disable. .. .. .. .. .. .. .. .. .. .. .. .. .. CSCTL mode .. .. .. .. .. .. .. .. .. .. .. .. .. .. D-Port mode .. .. .. .. .. .. .. .. .. .. .. .. .. .. D-Port over DWDM .. .. .. .. .. .. .. .. .. .. .. .. Compression .. .. .. .. .. .. .. .. .. .. .. .. .. .. Encryption .. .. .. .. .. .. .. .. .. .. .. .. .. .. FEC .. .. .. .. .. .. .. .. .. .. .. .. .. ..
portCfgFec portCfgFec Enables or disables Forward Error Correction (FEC) or FEC through Transmitter Training Signal (TTS) on 16 Gbps and 10 Gbps Fibre Channel links.
portCfgFec FEC via TTS Configured Displays OFF if TTS is disabled on the port (default). Displays ON if the FEC negotiation via TTS feature is enabled. FEC State The FEC state can be active or inactive. An active FEC state indicates that FEC is enabled and actually running. An inactive state can indicate two conditions: FEC is enabled, but not running due to some error condition (for example, FEC may not be enabled on both ends of the link). Or FEC is disabled and therefore inactive.
portCfgFec --disable [-FEC] [-TTS] Disables FEC, FEC through TTS on the specified ports.Use the -FEC option to disable FEC only, use the -TTS option to disable TTS only, or use both -FEC and -TTS options together to disable FEC through TTS. -force | -f Enables or disables FEC or FEC through TTS without prompting for a confirmation. --show Displays the FEC and TTS configurations on the specified ports. --help Displays the command usage.
portCfgFec To enable the FEC feature on a range of ports, some of which were previously enabled (the following example enables port 4): switch:admin> portcfgfec --enable -FEC 2-4 Warning : FEC changes will be disruptive to the traffic Same configuration for port 2 Warning : FEC changes will be disruptive to the traffic Same configuration for port 3 Warning : FEC changes will be disruptive to the traffic Same configuration for port 4 To disable the FEC feature on a port range: switch:admin> portcfgfec --di
portCfgFec To enable both FEC and TTS on a port: switch:admin> portcfgfec --enable -FEC -TTS 2 WARNING: 16G FEC with TTS is only supported on F-Ports. \ Other port types will be disabled. FEC changes are disruptive. Are you sure you want to continue? (yes, y, no, n): [no]: y FEC & TTS have been enabled for port 2. To disable both FEC and TTS on a port: switch:admin> portcfgfec --disable -FEC -TTS 2 WARNING: 16G FEC with TTS is only supported on F-Ports. \ Other port types will be disabled.
portCfgFec To disable FEC and TTS feature when FEC is previously disabled and TTS is enabled: switch:admin> portcfgfec --disable -FEC -TTS 1 WARNING: 16G FEC with TTS is only supported on F-Ports. \ Other port types will be disabled. FEC changes are disruptive. Are you sure you want to continue? (yes, y, no, n): [no]: y Same FEC configuration; and TTS has been disabled for port 1.
portCfgFillword portCfgFillword Configures the fill word for a single 8G FC port. Synopsis portcfgfillword [slot/]port, mode [passive] portcfgfillword --help Description Notes Use this command to configure the fill word of an 8G FC port. By default, this command disables and re-enables the port and the port comes online with the new fill word setting. When passive option 1 is used after the mode, the new settings are not applied until the next time the port goes offline and comes back online.
portCfgFillword passive Specifies the fill word configuration changes to take effect immediately or next port toggle. This operand is optional. Valid values are one of the following: 0 Specify 0 for the new settings to take effect immediately. 1 Specify 1 to postpone the new settings to take effect only after the next time the port goes offline and comes back up. It prevents immediate application of the new settings through a disruptive portDisable and portEnable operation.
portCfgFillword Fill Word(Current) AL_PA Offset 13: Trunk Port Long Distance SEE ALSO 684 3(A-A then SW I-A) OFF OFF OFF portCfgShow Brocade Fabric OS Command Reference 53-1004112-02
portCfgFlogiLogout portCfgFlogiLogout Enables the Base Device Logout functionality on the port. Synopsis portcfgflogilogout --enable [slot/]port | -all portcfgflogilogout --disable [slot/]port | -all portcfgflogilogout --help Description Use this command to enable or disable Base Device Logout functionality on a specified port or port range. By default, the functionality is disabled on all the ports. This functionality allows NPIV devices to remain logged in even after the base device logs out.
portCfgFportBuffers portCfgFportBuffers Configures F_Port buffer allocation. Synopsis portcfgfportbuffers --enable [slot/]port buffers portcfgfportbuffers --disable [slot/]port Description Use this command to change the default buffer allocation for an F_Port and to allocate a specified number of buffers to the port. When port buffer allocation is enabled, the number of buffers specified override the default F_Port buffer allocation.
portCfgGE portCfgGE Manages the port configuration of the GbE/10GbE ports.
portCfgGE --mediatype media Specifies transmit mode for the GE ports. The valid types are optical or copper. Specifying optical selects the optical mode for the GbE port. Specifying copper selects a copper mode for the GbE port. -channel channel_num Configures the tunable small form-factor pluggable (TSFP) channel ID for the 10 GE ports. The valid channel ID range is 1 through 102. This option is supported only on the Brocade 7840 switch and the Brocade SX6 extension blade.
portCfgGE To configure the port speed to 1G for ge8 and verify the configuration: switch:admin> portcfgge ge8 --set -speed 1G switch:admin> portcfgge --show Port Speed Flags LAG-ID -----------------------------------------ge0 40G A---ge1 40G A---ge2 10G A-LGlag0 ge3 10G A-LGlag0 ge4 10G A---ge5 10G A---ge6 10G A---ge7 1G --LGedgeSw1 ge8 1G A---ge9 10G A---ge10 10G A---ge11 10G A---ge12 10G A---ge13 10G A---ge14 10G A---ge15 10G A---ge16 10G A---ge17 10G A--------------------------------------------- To co
portCfgGeMediaType portCfgGeMediaType Sets the selected mode for the ge0 and ge1 ports on the Brocade 7840. Synopsis portcfggemediatype ge_port [optical | copper] portcfggemediatype --help Description Use this command to set the mode for ge0 and ge1 ports on the Brocade 7840. Each of the ge0 and ge1 ports on the Brocade 7840 can be configured as a copper port (RJ45) or an optical port (SFP). The copper ports (RJ45) can only accept copper connections.
portCfgGeMediaType optical | copper Specifies which mode to select. Specifying optical selects the optical mode for the GbE port. Specifying copper selects a copper mode for the GbE port. This operand is optional; if omitted, the current media type is displayed for the specified GbE port. --help Displays the command usage.
portCfgGport portCfgGport Designates a port as a G_Port; removes G_Port designation. Synopsis portcfggport [slot/]port,mode Description Use this command to designate a port as a G_Port. After successful execution of this command, the switch attempts to initialize the specified port as an F_Port only, and does not attempt loop initialization (FL_Port) on the port. A port designated as a G_Port can become an E_Port. This configuration can be cleared but not set on VE/VEX_Ports.
portCfgISLMode portCfgISLMode Enables or disables ISL R_RDY mode on a port. Synopsis Description portcfgislmode [slot/]port,mode Use this command to enable or disable interswitch link read-ready (ISL R_RDY) mode on a port. Use the portCfgShow command to determine whether ISL R_RDY mode is enabled on a port. In ISL R_RDY mode, the port sends a primitive signal that the port is ready to receive frames. The port sends an exchange link parameter (ELP) with flow control mode 02.
portCfgISLMode Examples To enable ISL R_RDY mode on a port: switch:admin> portcfgislmode 1/3, 1 ISL R_RDY Mode is enabled for port 3. Please make sure the PID formats are consistent across the entire fabric.
portCfgLongDistance portCfgLongDistance Configures a port to support long distance links. Synopsis Description portcfglongdistance [slot/]port [distance_level] [vc_translation_link_init] [-distance distance] | [-buffer buffers] [-framesize frame_size] [-fecenable | -fecdisable] Use this command to allocate frame buffer credits to a port or to configure a specified long distance link. The port can only be used as an E_Port.
portCfgLongDistance port Specifies the number of the port to be configured relative to its slot for bladed systems. Use switchShow to display a list of valid ports. This operand is required. distance_level Specifies the long distance level as one of the following (the numerical value representing each distance_level is shown in parentheses): L0 (0) Specifies L0 to configure the port as a regular port.
portCfgLongDistance -distance distance This parameter is required when a port is configured as an LD or an LS mode link. In LD mode, the value of desired_distance is the upper limit of the link distance and is used to calculate buffer availability for other ports in the same port group. When the measured distance exceeds the value of distance, this value is used to allocate the buffers. In this case, the port operates in degraded mode instead of being disabled due to insufficient buffers.
portCfgLongDistance FC Fastwrite: Interrupts: Unknown: Lli: Proc_rqrd: Timed_out: Rx_flushed: Tx_unavail: Free_buffer: Overrun: Suspended: Parity_err: 2_parity_err: CMI_bus_err: OFF 0 0 70 205 0 0 0 0 0 0 0 0 0 Link_failure: Loss_of_sync: Loss_of_sig: Protocol_err: Invalid_word: Invalid_crc: Delim_err: Address_err: Lr_in: Lr_out: Ols_in: Ols_out: 0 0 0 0 0 0 0 0 9 5 0 6 Frjt: 0 Fbsy: 0 To configure desired buffers: switch:admin> portcfglongdistance 2/35 \ LS 1 -buffers 400 Reserved Buffers = 420 To c
portCfgLossTov portCfgLossTov Enables or disables de-bouncing of signal loss for front end ports. Synopsis portcfglosstov [slot/]port [-disable | 0] portcfglosstov [slot/]port [-enable_fixed | 1] portcfglosstov [slot/]port [-enable_all | 2] portcfglosstov -help Description Use this command to enable or disable the de-bouncing of loss of signal for 100 ms for front end ports. Use portCfgShow to display the current setting. If executed without operands, the command prints the usage.
portCfgLossTov Trunk Port Long Distance VC Link Init Locked L_Port Locked G_Port Disabled E_Port Locked E_Port ISL R_RDY Mode RSCN Suppressed Persistent Disable LOS TOV mode (Output truncated) ON OFF OFF OFF OFF OFF OFF OFF OFF OFF 1(ON:FixSpd) To disable the configuration on port 1/5: switch:admin> portcfglosstov 1/5 0 SEE ALSO 700 portCfgShow Brocade Fabric OS Command Reference 53-1004112-02
portCfgLport portCfgLport Configures a port as an L_Port. Synopsis Description Notes portcfglport [[slot/]port] locked_mode [private_mode] [duplex_mode]] Use this command to designate a port as an L_Port, and to configure its behavior. When a port is designated as an L_Port, the switch attempts to initialize that port as a fabric L_Port (FL_Port). The switch will never attempt a point-to-point (F_Port) initialization on the port. By default the L_Port will be a public L_Port.
portCfgLport Examples To configure ports 8, 14, and 15 as locked L_Ports: switch:admin> portcfglport 4/8 4/14-15, 1 To display the L_Port conditions: switch:admin> portcfglport [...] Ports of Slot 4 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 ---------------+--+--+--+--+---+--+--+--+--+--+--+--+---+--+--+-[...] Locked L_Port .. Private L_Port .. Locked Loop HD .. Loop Fairness .. (output truncated) SEE ALSO 702 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. ON ..
portCfgNonDfe portCfgNonDfe Enables or disables non-Decision Feedback Equalization (DFE) mode on 8 Gbps Fibre Channel links. Synopsis portcfgnondfe --enable [slot/]port[-port] portcfgnondfe --disable [slot/]port[-port] portcfgnondfe --show [slot/]port[-port] portcfgnondfe --help Description Use this command to enable or disable non-DFE mode on a specified port or on a range of ports, or to display the configuration and state.
portCfgNonDfe Notes This command is applicable only on an 8 Gbps 16 Gbps-capable port. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. Operands This command has the following operands: slot/ Specifies the slot number to be configured on bladed systems. port[-port] Specifies a port or a port range, relative to the slot number on bladed systems.
portCfgNonDfe 8G Non-DFE State: Inactive switch:admin> portcfgnondfe --show 9 Port: 9 8G Non-DFE Configured: ON (Static) 8G Non-DFE State: Active SEE ALSO portCfgShow Brocade Fabric OS Command Reference 53-1004112-02 705
portCfgNPIVPort portCfgNPIVPort Enables or disables N_Port ID virtualization (NPIV) functionality on a port and sets the per-port login limit. Synopsis portcfgnpivport --enable [slot/]port portcfgnpivport --disable [slot/]port portcfgnpivport --setloginlimit [slot/]port login_limit portcfgnpivport --help portcfgnpivport [slot/]port mode Description Use this command to enable or disable NPIV functionality on a port and to configure the maximum number of logins for this port.
portCfgNPIVPort Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. When using portCfgNPIVPort --disable or --enable on trunked ports, you must disable all trunk member ports before changing the NPIV capability on a trunk member and then re-enable the trunked ports to ensure that the configuration changes take effect.
portCfgNPIVPort Locked E_Port .. ISL R_RDY Mode .. RSCN Suppressed .. Persistent Disable.. LOS TOV enable .. NPIV capability ON NPIV PP Limit 80 (output truncated) .. .. .. .. .. ON 80 .. .. .. ON .. ON 80 .. .. .. ON .. ON 80 .. .. .. .. .. ON 80 .. .. .. .. .. ON 80 .. .. .. .. .. ON 80 .. .. .. .. .. ON 80 .. .. .. .. .. ON 95 .. .. .. .. .. ON 95 .. .. .. .. .. ON 95 .. .. .. .. .. ON 95 .. .. .. .. .. ON 95 .. .. .. .. .. ON 95 .. .. .. .. .. ON 95 .. .. .. .. ..
portCfgNPIVPort SEE ALSO Disabled E_Port Locked E_Port ISL R_RDY Mode RSCN Suppressed Persistent Disable LOS TOV enable NPIV capability QOS E_Port Port Auto Disable: OFF OFF OFF OFF OFF OFF OFF AE OFF Rate Limit EX Port Mirror Port Credit Recovery F_Port Buffers Fault Delay: NPIV PP Limit: CSCTL mode: Frame Shooter Port D-Port mode: OFF OFF OFF ON 12 0(R_A_TOV) 255 OFF OFF OFF configure, portCfgDefault, portCfgShow Brocade Fabric OS Command Reference 53-1004112-02 709
portCfgNPort portCfgNPort Enables or disables N_Port functionality for an Access Gateway port. Synopsis portcfgnport [slot/]port1[-port2] [mode] Description Use this command to enable or disable N_Port functionality for an Access Gateway port or for a range of ports. The enabled N_Ports automatically come online if they are connected to an enterprise fabric switch that supports NPIV. When used without operands, this command displays the port configuration.
portCfgNPort Fill Word(Current )0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 Trunk Port ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON Locked N_Port .. .. ON ON .. .. .. .. .. .. .. .. .. .. .. .. Persistent Disable.. .. .. .. .. .. .. .. .. .. .. .. .. .. .. ..
portCfgOctetSpeedCombo portCfgOctetSpeedCombo Sets port speed combination for a port octet. Synopsis portcfgoctetspeedcombo [slot]port combo portcfgoctetspeedcombo [slot]port -default Description Use this command to configure the speed for a port octet. Each port octet contains eight ports. You can configure any three different speed combinations. When you configure a given port, the combination applies to all ports in the octet. You can specify the octet by any port within the octet.
portCfgOctetSpeedCombo combo Specifies the speed combination for the ports in the octet. The following speed combinations are supported: 1 Supports autonegotiated or fixed port speeds of 32 Gbps, 16 Gbps,8 Gbps,4 Gbps, and 2 Gbps. 2 Gbps speed is not supported on Brocade G620 switch. 2 Supports autonegotiated or fixed port speeds of 10 Gbps,8 Gbps,4 Gbps, and 2 Gbps. 2 Gbps speed is not supported on Brocade G620 switch. 3 Supports autonegotiated or fixed port speeds of 16 Gbps and 10 Gbps.
portCfgPersistence portCfgPersistence Sets or removes the persistent disable flag on a port or a range of ports. Synopsis portcfgpersistence --set [-persistentenable | -pe] [-persistentdisable | -pd] [slot/]port1[-port2] [...] portcfgpersistence --set [-persistentenable | -pe] [-persistentdisable | -pd] -i [index1[-index2] [...] [-f]] portcfgpersistence --set [-persistentenable | -pe] [-persistentdisable | -pd] -x [index1[-index2] [...
portCfgPersistence port1[-port2] Sets the flag for a single port or a range of ports identified by port numbers. The port range cannot span slots, but you can specify multiple port range pairs separated by a space, for example 3/1-4 4/7-9. -f Ignores nonexisting ports. -i index1[-index2] Sets the flag for a port or a range of ports identified by port index numbers. You can specify multiple index ranges separated by a space, for example, -i 33-38 40-60.
portCfgPersistentDisable portCfgPersistentDisable Persistently disables a port or a range of ports. Synopsis portcfgpersistentdisable portcfgpersistentdisable [slot/]port1[-port2] [...] portcfgpersistentdisable -i [index1[-index2] [...] [-f]] portcfgpersistentdisable -x [hex1[-hex2] [...] [-f]] portcfgpersistentdisable -slot [slot1[-slot2] [...
portCfgPersistentDisable Operands This command has the following operands: slot On bladed systems only, specifies the slot number of the ports to be disabled persistently, followed by a slash (/). port1[-port2] Persistently disables a single port or a range of ports identified by port numbers. The port range cannot span slots, but you can specify multiple port ranges pairs separated by a space, for example 3/1-4 4/7-9.
portCfgPersistentDisable To disable a range of ports persistently by specifying the corresponding port index range: switch:admin> portcfgpersistentdisable -i 17-18 To disable multiple ports persistently by specifying multiple port index ranges: switch:admin> portcfgpersistentdisable -i 17-18 30-39 To disable all ports on slots 3-5 persistently: switch:admin> portcfgpersistentdisable -s 3-5 To disable all ports on slots 3-5 and 8-10 persistently: switch:admin> portcfgpersistentdisable -s 3-5 8-10 To dis
portCfgPersistentEnable portCfgPersistentEnable Persistently enables a port or a range of ports. Synopsis portcfgpersistentenable portcfgpersistentenable [slot/]port1[-port2] [...] portcfgpersistentenable -i [index1[-index2] [...] [-f]] portcfgpersistentenable -x [hex1[-hex2] [...] [-f]] portcfgpersistentenable -s[lot] [slot1[-slot2] portcfgpersistentenable -h Description Use this command to persistently enable a port or a range of ports.
portCfgPersistentEnable Operands This command has the following operands: slot On bladed systems only, specifies the slot number of the ports to be enabled persistently, followed by a slash (/). port1[port2] Persistently enables a single port or a range of ports identified by port numbers. The port range cannot span slots, but you can specify multiple port ranges pairs separated by a space, for example 3/1-4 4/7-9.
portCfgPersistentEnable To enable all ports on slots 3-5 persistently: switch:admin> portcfgpersistentenable -s 3-5 To display the persistently enabled ports on the switch: switch:admin> portcfgpersistentenable Slot 9 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 -------+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+--Enabled YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES YES (output truncated) SEE ALSO ficonCupSet, ficonCupShow, portDisable, portEnable, portCfgPersistentDisable, port
portCfgQoS portCfgQoS Enables or disables QoS, sets the default configuration, and sets and resets the ingress rate limit. Synopsis portcfgqos --disable | --enable [slot/]port portcfgqos --setratelimit [slot/]port ratelimit portcfgqos --resetratelimit [slot/]port portcfgqos --enable | --disable [slot/]port[-port] csctl_mode portcfgqos --default [slot/]port portcfgqos --help Description Use this command to configure traffic prioritization on a port.
portCfgQoS The Fabric OS port configuration commands are not supported on FCoE ports. Operands This command has the following operands: slot For bladed systems only, specifies the slot number of the port to configure, followed by a slash (/). port[-port] Specifies the port or port range to be configured, relative to the slot for bladed systems. Use switchShow for a listing of valid ports. --disable Disables the current configuration on the specified ports.
portCfgQoS To set the default QoS configuration on a port: switch:admin> portcfgqos --default 12/41 To set the ingress rate limit on a port to 2 Gbps: switch:admin> portcfgqos --setratelimit 12/41 2000 To reset the ingress rate limit on a port: switch:admin> portcfgqos --resetratelimit 12/41 To enable CS_CTL VC mode on a port when QoS is enabled: switch:admin> portcfgqos --enable 1/10-16 csctl_mode Enabling CSCTL mode flows causes QoS zone flows to \ lose priority on such ports Do you want to proceed?(y
portCfgShow portCfgShow Displays port configuration settings. Synopsis portcfgshow portcfgshow [slot/]port portcfgshow -i [ndex1[-index2] [...] [-f]] portcfgshow -slotslot1[-slot2] [...] portcfgshow [option] [slot/]ge_port portcfgshow [fciptunnel | fcipcircuit] [all | [slot/]veport] [optional_argument] portcfgshow ipsec-policy portcfgshow lag portcfgshow tcl portcfgshow sla Description Use this command to display the current configuration of a port.
portCfgShow Displays supported only on the Brocade 7840 switch, and Brocade FX8-24 and Brocade SX6 blades Use this command with optional arguments to display the following parameters configured for a GbE port on the Brocade 7840 switch and on the Brocade FX8-24 and Brocade SX6 blades.
portCfgShow AL_PA Offset 13 Displays (..) or OFF when the arbitrated loop physical address (AL_PA) on the port is configured to use a 0x0 AL_PA address (default). Displays ON when the address configuration is 0x13 AL_PA. This value is set by the portCfgAlpa command. Trunk Port Displays ON when port is set for trunking. Displays (..) or OFF when trunking is disabled on the port. This value is set by the portCfgTrunkPort command. Long Distance Displays (..
portCfgShow RSCN Suppressed Displays ON when RSCN suppression is enabled on the port. Displays (..) or OFF when RSCN suppression is disabled. This value is set by the portCfg rscnsupr command. Persistent Disable Displays ON when the port is persistently disabled; otherwise displays (..) or OFF. This value is set by the portCfgPersistentDisable command. LOS TOV mode Displays 1 (ON:FixSpd) or 2 (ON:AN&FixSpd) when LOS TOV is enabled on the port; otherwise displays (..) or 0 (OFF).
portCfgShow Rate Limit Displays ON when ingress rate limit is set on the port or (..) or OFF when the ingress rate limiting feature is disabled. This value is set by the portCfgQos --setratelimit command. The default value is OFF. Credit Recovery Displays ON when Credit Recovery is enabled on the port. Displays (..) or OFF when the feature is disabled. This value is set by the portCfgCreditRecovery command. The credit recovery feature is enabled by default.
portCfgShow Encryption Displays ON when encryption is enabled on a port. Displays (..) or OFF when the configuration is disabled. Encryption is enabled by the portCfgEncrypt command; it is disabled by default. 10G/16G FEC Displays ON when Forward Error Correction (FEC) is enabled on a port and the port is online. Displays (..) or OFF when the configuration is disabled. FEC is enabled by the portCfgFec command; it is enabled by default.
portCfgShow ge_port Specifies the number of the GbE Port to be displayed. The GbE ports are numbered ge0 ge9 on the Brocade FX8-24 blade. The 10GbE ports on the Brocade FX8-24 blade are numbered xge0 and xge1. Use the switchShow command for a list of valid ports. Use portCfgShow with a GbE port or with one of the optional arguments to display specific FCIP-related parameters.
portCfgShow ve_port Displays information for the specified FCIP tunnel. To display the tunnel, specify the VE_Port number associated with the tunnel configured on one of the GbE ports. VE_Ports are numbered 16-23. optional_argument The following optional argument is supported with fciptunnel: -ipsec Displays whether IPSec is enabled or disabled. If enabled, the key is displayed. If IPSec is enabled and configured in legacy mode, the mode is displayed as "legacy".
portCfgShow CSCTL mode: TDZ mode: D-Port mode: D-Port over DWDM: Compression: Encryption: 10G/16G FEC: 16G FEC via TTS: OFF OFF ON ON OFF OFF ON ON To display the port configuration settings on a Brocade 7840 for a range of ports specified by their index numbers: switch:admin> portcfgshow -i 24-31 Index: 24 25 26 27 28 29 30 31 --------------------+---+---+---+-----+---+---+---+----Speed AN AN AN AN AN AN AN AN Fill Word(On Active) 0 0 0 0 0 0 0 0 Fill Word(Current) 0 0 0 0 0 0 0 0 AL_PA Offset 13 .. ..
portCfgShow Locked E_Port .. ISL R_RDY Mode .. RSCN Suppressed .. Persistent Disable.. LOS TOV mode 0 NPIV capability ON NPIV PP Limit 90 NPIV FLOGI Logout ON QOS E_Port AE EX Port .. Mirror Port .. Rate Limit .. Credit Recovery ON Fport Buffers .. Port Auto Disable .. CSCTL mode .. TDZ mode .. D-Port mode .. D-Port over DWDM .. Compression .. Encryption .. 10G/16G FEC ON 16G FEC via TTS .. Fault Delay 0 SIM Port .. .. .. .. .. 2 ON 90 ON AE .. .. .. ON .. .. .. .. .. .. .. .. ON .. 0 .. .. .. .. ..
portCfgShow Fault Delay SIM Port 0 0 0 0 .. .. .. .. 0 0 0 0 .. .. .. .. 0 0 0 0 .. .. .. .. 0 0 0 0 .. .. .. .. where AE:QoSAutoEnable, AN:AutoNegotiate, ..
portCfgShow Eport Credits Port Auto Disable CSCTL mode D-Port mode D-Port over DWDM Compression 10G/16G FEC 16G FEC via TTS Fault Delay SIM Port TDZ mode [output truncated] .. .. .. .. .. .. ON .. 0 .. .. .. .. .. .. .. .. ON .. 0 .. .. .. .. .. .. .. .. ON .. 0 .. .. .. .. .. .. .. .. ON .. 0 .. .. .. .. .. .. .. .. ON .. 0 .. .. .. .. .. .. .. .. ON .. 0 .. .. .. .. .. .. .. .. ON .. 0 .. .. .. .. .. .. .. .. ON .. 0 .. ..
portCfgShow To display the QoS configuration for an EX_Port (QoS over FCR deployment): switch:admin> switchshow | grep EX-Port 16 16 id N4 Online FC EX-Port \ 10:00:00:05:1e:41:4a:45 "Tom_100" (fabric id = 25 )(Trunk master) switch:admin> portcfgshow 16 Area Number: 11 Octet Speed Combo: 1(16G|8G|4G|2G) Speed Level: AUTO(HW) Fill Word(On Active) 0(Idle-Idle) Fill Word(Current) 0(Idle-Idle) AL_PA Offset 13: OFF Trunk Port ON Long Distance LS VC Link Init OFF Desired Distance 10 Km Reserved Buffers 86 Locked
portCfgShow Local WWN: 10:00:00:05:1e:52:fe:00 Flags: 0x00000000 FICON: Off switch:admin> portcfgshow fciptunnel 1/12 ------------------------------------------Tunnel ID: 1/12 Tunnel Description: Compression: Off Fastwrite: Off Tape Acceleration: Off TPerf Option: Off IPSec: Enabled (legacy) QoS Percentages: High 50%, Med 30%, Low 20% Remote WWN: Not Configured Local WWN: 10:00:00:05:1e:52:fe:00 Flags: 0x00000000 FICON: Off SEE ALSO 738 portCfg, portCfgAutoDisable, portCfgCreditRecovery, portCfgEport, p
portCfgSpeed portCfgSpeed Configures the speed for a port or a range of ports. Synopsis portcfgspeed [slot/]port speed portcfgspeed -i index1[-index2] [-f] speed [-m] max_auto_speed portcfgspeed -x hex1[-hex2] [...] speed portcfgspeed -slot slot1[-slot2] [...] speed [-m] max_auto_speed portcfgspeed -h Description Use this command to set the speed on a specified port or port range. This command disables and then re-enables the ports, and the ports come online with the new speed setting.
portCfgSpeed -i index1[-index2] Configures a port or a range of ports identified by port index numbers. Multiple port ranges are not supported with this command. -f Ignores nonexisting ports. This operand is valid only with the -i option. -x hex1 [-hex2] Configures a port or a range of ports identified by port numbers, index number in hexadecimal format. You may specify multiple port ranges separated by a space, for example, -x 21-26 28-3c.
portCfgSpeed -m Sets auto-negotiation maximum speed. This operand is optional. Valid values are one of the following. 2 Sets the maximum auto-negotiation speed to 2 Gbps (not supported on 32G platforms). 4 Sets the maximum auto-negotiation speed to 4 Gbps. 8 Sets the maximum auto-negotiation speed to 8 Gbps. 16 Sets the maximum auto-negotiation speed to 16 Gbps. 32 Sets the maximum auto-negotiation speed to 32 Gbps. -h Displays the command usage.
portCfgTdz portCfgTdz Configures a port for Target Driven Zoning (TDZ). Synopsis portcfgtdz --enable [slot/]port_list portcfgtdz --disable [slot/]port_list portcfgtdz --show [slot/]port_list portcfgtdz --help Description Use this command to configure a port to support Target Driven Zoning. This command enables or disables the Target Driven Zoning configuration on the specified port and saves the configuration persistently.
portCfgTdz Examples To enable Target Driven Zoning configuration on a port: switch:admin> portcfgtdz --enable 8 To display Target Driven Zoning configuration status for a specific port: switch:admin> portcfgtdz --show 8 Port Mode ============ 8 ON To enable Target Driven Zoning configuration on a range of ports: switch:admin> portcfgtdz --enable 8-18 To enable Target Driven Zoning configuration on all ports: switch:admin> portcfgtdz --enable "*" To disable Target Driven Zoning configuration on a port:
portCfgTrunkPort portCfgTrunkPort Enables or disables trunking on a port. Synopsis Description portcfgtrunkport [slot/]port[,] mode Use this command to enable or disable trunking on a port. Use switchCfgTrunk to enable or disable trunking on all ports of a switch. When the command is executed to update the trunking configuration, the port to which the configuration applies is disabled and subsequently re-enabled with the new trunking configuration.
portCfgVEXPort portCfgVEXPort Configures a port as a VEX_Port connected to an FC-IP and sets and displays VEX_Port configuration parameters.
portCfgVEXPort The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. Operands This command has the following operands: slot On bladed systems only, specifies the slot number followed by a slash (/). port[-port] Specifies a port or a port range, relative to the slot number on bladed systems, for example, 5/17-29. Use switchShow for a list of valid ports.
portCfgVEXPort Examples To display the VEX_Port configuration of port 2/16: switch:admin> portcfgvexport 2/16 Port 2/16 info Admin: enabled State: OK Pid format: core(N) Edge Fabric ID: 16 Front Domain ID: 160 Front WWN: 50:06:06:9e:20:9f:ce:10 Principal Switch: 7 principal WWN: 10:00:00:60:69:c0:05:8a Fabric Parameters: Auto Negotiate R_A_TOV: 9000(N) E_D_TOV: 2000(N) Authentication Type: DHCHAP DH Group: 4 Hash Algorithm: SHA-1 Edge fabric's primary wwn: N/A Edge fabric's version stamp: N/A To set the
portChannelShow portChannelShow Displays the port channels from a domain to the remote domains. Synopsis portchannelshow [domain] portchannelshow --help Description Use this command to display information about port channels from a domain to one or all reachable remote domains. The command output includes the following information: # domain(s) in the fabric Total number of domains in the fabric. Local Domain ID The domain number of local switch. Domain The domain number of destination switch.
portChannelShow --help Displays the command usage.
portCmd portCmd Diagnoses intelligent ports.
portCmd bad CRC payloads rx Number of bad CRC payloads received. out of seq PDUs rx Number of out-of-sequence PDUs received. flow control count Flow control count. last rtt Last Round trip in milliseconds (RT traffic only). VLAN tagging ensures that test traffic traverses the same path as real FCIP traffic. A VLAN tag entry must exist prior to issuing the --ping or --traceroute commands; this includes both the local and remote sides.
portCmd -q service_type Specifies the type of service in the ping request. The default is 0 and service_type can be hex (0x0-0xFF) or decimal (0-255). This operand is optional. -t ttl Specifies the time to live. Valid values are 1 to 255. The default is 100. This operand is optional. -w wait_time Specifies the time to wait for the response of each ping request in seconds. The default is 5 seconds and the maximum wait time is 9 seconds. This operand is optional.
portCmd -f first_ttl Specifies the starting point for the "time to live" parameter. The default is 1. The command skips processing for those intermediate gateways that are less than the first_ttl hops. This operand is optional. -q service_type Specifies the type of service in the traceroute request. The default is 0 and service_type must be an integer from 0 to 255. This operand is optional. -w wait_time Sets the time, in milliseconds, to wait for a response to a probe. The default is 5000 milliseconds.
portCmd The following optional arguments are ignored on the data sink, because it services all requests from the data source: -high, -medium, -low, -unidirectional, -random, -pattern, and -size. When -source is specified, TPerf generates traffic until it is interrupted by user intervention (Ctrl + c) or, if a value for duration is specified with the -t option, until the process completes the set time frame.
portCmd -size pdu_size Specifies the PDU size to use (not including headers). The valid range is between 2048 and 10112 bytes. The default is equivalent to the maximum segment size (MSS). This is the maximum size if the -random option is specified. -interval interval Specifies the interval at which the statistics display is refreshed, in seconds. The default is 30 seconds. --pmtu Generates the ICMP messages to discover the maximum MTU available on a specific network path.
portCmd -d | --dst dst_ip Specifies the destination IP address to which to probe the IP router path. IPv6 addresses are supported. -r | --rate rate Specifies the test rate in kbps. -t | --time time Specifies the test time in seconds. i | --ipsec-policy ip-sec_policy Specifies the policy name for an ipsec configuration. -b | --bi-directional Specifies the test session is running on bi-directional traffic. By default, the WAN test session is configured for uni-directional traffic.
portCmd --all-ls Displays statistics for all configured WAN test sessions from all logical switches. start Starts the WAN test session associated with the test ID. This command supports following option: -t Specifies the test time in seconds. Use this option if the test time is not configured with create or modify options. stop Stops the WAN test session associated with the test ID. Use all to stop all WAN test sessions. delete Deletes the WAN test session associated with the test ID.
portCmd To trace the IP router hops used to reach the remote host using VLAN tagging with the -c option. switch:admin> portcmd --traceroute 8/ge0 \ -s 192.168.10.1 -d 192.168.20.1 -v 10 To ping a failover crossport: switch:admin> portcmd --ping 8/xge0 \ 192.168.11.20 -d 1.1.1.1 -x To trace the route to a failover crossport: switch:admin> portcmd --traceroute 8/xge0 \ 192.168.11.20 -d 1.1.1.1 -x To set the path characteristic to source mode on the remote host using VLAN tagging with the -c option.
portCmd To configure a TPerf source so it generates round-trip high and low priority traffic with a random PDU size from 2048 to 10112 bytes (1 MSS) and with a payload pattern determined by previous settings saved in memory: switch: admin> portcmd --tperf 16 -source -high -low -random TPerf has been configured successfully for 16 TPerf is generating traffic on 16 priority: high TPerf is generating traffic on 16 priority: low *************************************************************** Tunnel ID: 16 High
portCmd To create a WAN test session: switch:admin> portcmd --wtool 0 create -d 76.196.3.76 -s 77.195.3.77 -r 5000000 Operation Succeeded To start a WAN test session: switch:admin> portcmd --wtool 0 start -t 1200 Operation Succeeded To display WAN test session for a specified session: switch:admin> portcmd --wtool 0 show wantool-id: (0) ========================================= State : Established Up Time : 1m6s Run Time : 0s Time remaining : 0s IP Addr (L/R) : 76.196.3.76 - 77.195.3.
portCmd RTT VAR (Min/Max) : Local Session Statistics Tx pkts : Peer Session Statistics Rx pkts : Ooo pkts : Drop pkts : (output truncated) 1 ms/1 ms 810024 792029 0 0 (0.
portDebug portDebug Sets debug level and verbose level of port modules. Synopsis Description Notes Operands portdebug dbg_lvl, vbs_lvl Use this command to set the debug level and verbose level of port modules. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. This command has the following operands: dbg_lvl Specify the debug level to be set for port modules; valid values are 1 to 5.
portDecom portDecom Decommissions and disables an E_Port without frame loss. Synopsis portdecom portdecom [slot/]port portdecom --help Description Use this command to disable an E_Port without frame loss. The E_Port can either be a single redundant E_Port or an E_Port which is part of a trunk group. The port must be an operational E_Port with at least one other redundant E_Port available to reach all domains that the E_Port can reach.
portDisable portDisable Disables a port or a range of ports. Synopsis portdisable [slot/]port1[-port2] [...] portdisable -i [index1[-index2] [...] [-f]] portdisable -x [hex1[-hex2] [...]] portdisable -slot [slot1[-slot2] [...]] portdisable [slot/]port -r disable_reason_string portdisable -h Description Use this command to disable a port or a range of ports. If the port is connected to another switch when disabled, the fabric may reconfigure.
portDisable -x [hex1 [-hex2]] Disables a port or a range of ports identified by port numbers, index number in hexadecimal format. You may specify multiple port ranges separated by a space, for example, -x 21-26 28-3c. -slot [slot1[-slot2]] Disables all ports on a slot or on a range of slots, for example, -s 3-5. You may specify multiple slot ranges separated by a space, for example, -s 3-5 8-10. -r disable_reason_string Specifies the reason for disabling the port.
portDisable To disable a port with a disable reason: switch:admin> portdisable 2/2 -r "laser fault" SEE ALSO 766 portCfgPersistentDisable, portCfgPersistentEnable, portEnable, portShow, portSwapDisable, portSwapShow, switchShow Brocade Fabric OS Command Reference 53-1004112-02
portDPortTest portDPortTest Initiates or terminates a D_Port test, or displays D_Port test results.
portDPortTest Remote port index The port number on the remote side of the link Mode The testing mode: Automatic (initiated due to port online event) or Manual (manually restarted using this command). No. of test frames Number of frames sent for link traffic test. Test frame size The test frame size in bytes. Pattern The predefined pattern name. Payload The user-defined payload pattern. FEC (enabled/option/active) The forward error correction (FEC) status. This option is not supported for D_Port HBA.
portDPortTest Roundtrip link latency Displays roundtrip link latency in nanoseconds or unknown when the test is in progress. Roundtrip link latency is the time required for the light to travel from a given port to the port at the remote side of the link and back again. Estimated cable distance The estimated physical distance of the interswitch link in meters.
portDPortTest The approximate cable distance is calculated and displayed instead of estimated cable distance if the "electrical loopback" and "optical loopback" tests statuses are SKIPPED. The associated value of Approximate/Estimated cable distance will be UNKNOWN if the "electrical loopback" and "optical loopback" tests statuses are "SKIPPED" and the link distance is less than 150 meters. The D_Port long duration test can be run on only one port at a time.
portDPortTest -cr Enables the credit recovery (CR) during D_Port test. --setarg Sets the D_Port test parameters and exits. The sub-options of --setarg are same as --start. This option is not supported for D_Port HBA connections. --stop Terminates the diagnostics on the specified D_Ports. Brocade recommends that you execute this command on both the local port and the remote port to properly terminate the D_Port tests. --restart Restarts the D_Port diagnostic tests with the configured parameters.
portDPortTest To set OWRAP on a port: switch:admin> portdporttest --set owrap 10/32 To clear both EWRAP and OWRAP on a port: switch:admin> portdporttest --clear all 10/32 To display the D_Port test results for a port while the test is in progress or after the test has completed: switch:admin> portdporttest --show 16 D-Port Information: =================== Port: 16 Remote WWNN: 10:00:00:27:f8:f0:21:60 Remote port index: 8 Mode: Manual No.
portDPortTest CR (enabled/option/active): Yes/No/No Start time: Mon Apr 8 12:16:12 2013 End time: Mon Apr 8 12:16:29 2013 Status: FAILED ================================================================= Test Start time Result EST(HH:MM:SS) Comments ================================================================= Electrical loopback 12:16:13 PASSED ----------------Optical loopback 12:16:18 PASSED ----------------Link traffic test 12:16:29 FAILED -------Remote port is not ready to start the test ===========
portDPortTest stat_mc_rx 0 stat_mc_to 0 stat_mc_tx 0 tim_rdy_pri 0 tim_txcrd_z 3489 tim_txcrd_z_vc 0- 3: 3489 tim_txcrd_z_vc 4- 7: 0 tim_txcrd_z_vc 8-11: 0 tim_txcrd_z_vc 12-15: 0 er_enc_in 0 er_crc 0 er_trunc 0 er_toolong 0 er_bad_eof 0 er_enc_out 0 er_bad_os 0 er_pcs_blk 0 er_rx_c3_timeout 0 er_tx_c3_timeout 0 er_unroutable 0 er_unreachable 0 er_other_discard 0 er_type1_miss 0 er_type2_miss 0 er_type6_miss 0 er_zone_miss 0 er_lun_zone_miss 0 er_crc_good_eof 0 er_inv_arb 0 er_single_credit_loss0 er_multi_
portDPortTest tim_txcrd_z_vc 8-11: 0 tim_txcrd_z_vc 12-15: 0 er_enc_in 0 er_crc 0 er_trunc 0 er_toolong 0 er_bad_eof 0 er_enc_out 0 er_bad_os 0 er_pcs_blk 0 er_rx_c3_timeout 0 er_tx_c3_timeout 0 er_unroutable 0 er_unreachable 0 er_other_discard 0 er_type1_miss 0 er_type2_miss 0 er_type6_miss 0 er_zone_miss 0 er_lun_zone_miss 0 er_crc_good_eof 0 er_inv_arb 0 er_single_credit_loss0 er_multi_credit_loss0 porterrshow =========== frames loss frjt fbsy tx rx sig 1: 4 4 0 0 0 11: 0 0 0 0 0 21: 0 0 0 0 0 31: 0 0 0
portEnable portEnable Enables a port or a range of ports. Synopsis portenable [slot/]port1[-port2] [...] portenable -i [index1[-index2] [...]] [-f] portenable -x [hex1[-hex2] [...]] portenable -slot [slot1[-slot2]] portenable -h Description Use this command to enable a port or a range of ports. If a port is connected to another switch when this command is issued, the fabric may reconfigure. After the port is enabled, devices connected to the port can again communicate with the fabric.
portEnable -f Ignores nonexisting ports. This operand is valid only with the -i option. -x [hex1 [-hex2]] Enables a port or a range of ports identified by port numbers, index number in hexadecimal format. You may specify multiple port ranges separated by a space, for example, -x 21-26 28-3c. -slot [slot1[-slot2]] Enables all ports on a slot or on a range of slots, for example, -s 3-5. Multiple slot ranges are not supported with this command. -h Displays the command usage.
portEncCompShow portEncCompShow Displays encryption and compression port configuration details. Synopsis Description portenccompshow Use this command to display a list of ports that can be configured for encryption or compression. The command displays one section per ASIC and the ports configurable for that ASIC. The output includes the following information: User Port The port index number of the port to be configured. Use the switchShow command to identify the corresponding slot and port number.
portEncCompShow 18 No No No No 19 No No No No 20 No No No No 21 No No No No 22 No No No No 23 No No No No 144 Yes Yes Yes No 145 No No No No 146 No No No No 147 No No No No 148 No No No No 149 Yes No Yes No 150 No No No No 151 No No No No ----------------------------------88 No No No No 89 No No No No 90 No No No No 91 No No No No 92 No No No No 93 No No No No 94 No No No No 95 No No No No 208 No No No No 209 No No No No 210 No No No No 211 No No No No 212 No No No No SEE ALSO 16G 16G portCfgEncrypt, p
portErrShow portErrShow Displays a port error summary. Synopsis porterrshow porterrshow [[slot/]port1[-[slot/]port2]] porterrshow -i | -index [index1[-index2]] porterrshow -x [hex1[-hex2]] porterrshow --help Description Use this command to display an error summary for a port or a range of ports. Counts are reported on frames transmitted by the port (Tx) or on frames received by the port (Rx). The display contains one output line per port.
portErrShow disc c3 Number of Class 3 frames discarded (Rx). This counter includes the sum of the following class 3 discard counters reported by the portStatsShow command: er_rx_c3_timeout, er_tx_c2_timeout, er_c2_dest_unreach, and er_other_disc. Refer to portStatsShow help for a description of these counters. link fail Number of link failures (LF1 or LF2 states) received (Rx). loss sync Number of times synchronization was lost (Rx).
portErrShow -x [hex1 [-hex2]] Displays port error summary for a port or a range of ports identified by port index numbers in hexadecimal format. You may specify port ranges separated by "-", for example, -x 21-26. --help Displays the command usage. Examples To display error counters for ports on a switch: switch:admin> porterrshow frames enc crc crc too too bad enc \ tx rx in err g_eof shrt long eof out ============================================================= \ 0: 0 0 0 0 0 0 0 0 0 \ 1: 2.
portFlagsShow portFlagsShow Displays the port status bitmaps for all ports in a switch. Synopsis Description portflagsshow Use this command to display the following status for a port: SNMP Displays whether the port is online or offline. Physical Displays the port physical status. Valid values are In_Sync, No_Light (8 Gbps-capable ports only), and No_SigDet (quad small form-factor pluggables (QSFPs) installed without cables). Refer to switchShow help for more information on these states.
portFlagsShow 19 Offline No_Module 20 Offline No_Module 21 Offline No_Module 22 Offline No_Module (output truncated) PRESENT PRESENT PRESENT PRESENT U_PORT U_PORT U_PORT U_PORT LED LED LED LED To display the port status for QSFPs installed without cables (partial output) : 6 6 6 6 16 Offline No_SigDet PRESENT U_PORT LED 17 Offline No_SigDet PRESENT U_PORT LED 18 Offline No_SigDet PRESENT U_PORT LED 19 Offline No_SigDet PRESENT U_PORT LED To display the port status for QSFPs installed and connected wi
portLedTest portLedTest Cycles user port LEDs. Synopsis Description portledtest [--slot slot_number] [-ports itemlist] [-uports itemlist] [-npass count] [-action value] Use this command to exercise the user port LEDs in the current switch. When used without a port specifier, all user ports are tested. For each port, the command cycles through the ON and OFF state by setting the ATTN LEDs to green for the ON condition and unlighted for the OFF condition.
portLedTest -action action Specifies the LED color. Valid values include the following: 0 This is the default action. Cycle all Port LEDs. C3 cycles are faster than C2 cycles. 1 Turn Port status LED off. 2 Turn Port status LED amber. 3 Turn Port status LED green. 4 Blink Port status LED Green. Supported only on C4 platforms. 5 Blink Port status LED Amber. Supported only on C4 platforms. 16 Not supported for C2, C3, and C4 platforms. 17 Not supported for C2, C3, and C4 platforms.
portLogClear portLogClear Clears the port log. Synopsis Description portlogclear Use this command to clear the port log. It is recommended that you clear the port log before triggering an activity so that the log displays only the log events related to that activity. If the port log is disabled, portLogClear enables it. The port log is disabled automatically when certain errors occur to allow the collection of all the information needed to understand the cause of the error.
portLogConfigShow portLogConfigShow Displays the current port log configuration. Synopsis Description Notes portlogconfigshow Use this command to display the current port log configuration. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
portLogDisable portLogDisable Disables the port log facility. Synopsis Description Notes portlogdisable Use this command to disable the port log facility. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
portLogDump portLogDump Displays the port log without page breaks. Synopsis Description portlogdump [count[, saved]] Use this command to display the port log, listing all entries in the log without page breaks. This command displays the same information as portLogShow, but portLogShow prompts you to press Enter between each page. For an explanation of the information displayed by this command, refer to the portLogShow command.
portLogDump 03fffffd,00fffffd,00000000,00008000,06fe0000 21:52:15.218 FCPH seq 106 7f0 \ ed980000,06fe0000,00004143,0004001c,00008000 21:52:15.
portLogDumpPort portLogDumpPort Displays the port log of a specified port without page breaks. Synopsis Description portlogdumpport port_index Use this command to display the port log for a single port specified by its port index number. The command displays all entries in the log without any page breaks. This command is identical to portLogShowPort, except that portLogShowPort prompts you to press Enter to display the next page.
portLogEnable portLogEnable Enables the port log facility. Synopsis Description Notes portogenable Use this command to enable the port log facility. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
portLogEventShow portLogEventShow Displays information about port log events. Synopsis Description Notes portlogeventshow Use this command to display information about the ID associated with the various port log events. The Disabled field indicates whether the port log for that event ID is disabled (1) or enabled (0). The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
portLoginShow portLoginShow Displays port login status of devices attached to the specified port and the details of the last logged out device. Synopsis Description portloginshow [slot/]port [-history] Use this command to display port login status received from devices attached to the specified port. For each login, this command displays the following fields: Type Type of login can display one of the following: fd FDISC, Discover F_Port Service Parameters or Virtual N_Port login.
portLoginShow Operands This command has the following operands: slot For bladed systems only, specify the slot number of the port to be displayed, followed by a slash (/). port Specify the port for which to display login status information, relative to its slot for bladed systems. Use switchShow for a list of valid ports. -history Displays the details of the last logged out device on a port for the login types "fe" and "fd". The time stamp displayed under the column "logout time" is in the UTC format.
portLogPdisc portLogPdisc Sets or clears the debug_pdisc_flag. Synopsis Description Notes Operands portlogpdisc 0 | 1 Use this command to set or clear the debug_pdisc_flag. This command is part of the environmental monitor. A setting of 1 enables logging of Port Discovery parameters. The PDISC log is disabled by default. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
portLogReset portLogReset Enables the port log facility. Synopsis Description Notes portlogreset Use this command to enable the port log facility. Refer to portLogClear for events that may disable the port log facility. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
portLogResize portLogResize Resizes the port log to include a specified number of entries. Synopsis portlogresize num_entries Description Use this command to resize the port log to include a specified number of entries. If the specified number of entries is less than the already configured port log size, there is no change. Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
portLogShow portLogShow Displays the port log with page breaks. Synopsis Description portlogshow [count[, saved]] Use this command to display the port log with page breaks. This command displays the same information as portLogDump, but one page at a time. The port log is a circular log file in the switch firmware which can save up to 65,536 entries depending on the hardware platform. Use portLogConfigShow to display the current port log size.
portLogShow busy A received frame is busy. ctin A CT based request is received. ctout A CT based response is transmitted. errlog A message is added to the error log. loopscn A loop state change notification is posted. create A task is created. debug Indicates a debug message. nbrfsm Indicates a neighbor state transition. sn Indicates a speed negotiation state. fcin Indicates an incoming Fibre Channel information unit. fcout Indicates an outgoing Fibre Channel information unit.
portLogShow xstate Indicates an exchange state. payload Indicates a frame payload. Port Displays the port number that logged the event. Cmd Defined by the event. Displays a value defined by the event as follows: ioctl I/O control command code. Tx & Rx Frame payload size. scn New state (see state codes below). pstate New physical state (see pstate codes below). ctin The CT-subtype: fc Simple Name Server. f8 Alias Server. ctout The same as ctin. errlog Error level (refer to errShow).
portLogShow Args Displays additional information about the event as follows: start Start type: 0 = enable ports, 100 = disable ports. disable State (refer to state codes). enable Mode: 0 normal; nonzero loopback. Tx & Rx Header words 0,1,4 (R_CTL,D_ID,S_ID,OX_ID,RX_ID) and the first payload word. reject FC-PH reject reason. busy FC-PH busy reason.
portLogShow OLD Usually zero. TMO Encoded value of the state when loop initialization timed out This value is usually equal to the first word of a loop init frame payload. Other possible values include the following: 2 LIP (req. INITIALIZING) timeout. 94 F0F0 ARB(F0) timeout. 40 CLS timeout.
portLogShow LF2 Link Failure: NOS Receive State OL1 Offline: OLS Transmit State OL2 Offline: OLS Receive State OL3 Offline: Wait for OLS State LIP reason Valid LIP reason codes include the following: 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 ARB(F0). 8006 LIP when an OPN returns. 8007 Restart loop when LIPs received in OLD_PORT AC state.
portLogShow NC Negotiation complete. Notes Operands The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. This command has the following operands: count Specifies the maximum number of lines to display. Only the most recent count entries are displayed. This operand is optional. saved Specifies a nonzero value to display the saved port log from the last switch fault.
portLogShowPort portLogShowPort Displays the port log of a specified port with page breaks. Synopsis Description portlogshowport port_index Use this command to display the port log of a specified port with page breaks. This command displays the same information as portLogDumpPort, except that portLogDumpPort does not prompt you to press Enter to display the next page. If the command is executed while the port log is disabled, a warning message is displayed.
portLogTypeDisable portLogTypeDisable Disables the port log of a specified type. Synopsis Description Notes Operands portlogtypedisable id Use this command to disable the port log for a specified port log type. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. This command has the following operand: id Specifies a nonzero value that corresponds to the port log type to be disabled.
portLogTypeEnable portLogTypeEnable Enables the port log of a specified port log type. Synopsis Description Notes Operands portlogtypeenable id Use this command to enable the port log for a specified port log type. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. This command has the following operand: id Specifies a nonzero value that corresponds to the port log type to be enabled.
portLoopbackTest portLoopbackTest Performs a functional test of port N->N path. Synopsis Description portloopbacktest [--slot slot] [-nframes count] [-lb_mode mode] [-spd_mode mode] [-ports itemlist] [-uports itemlist] Use this command to verify the functional operation of the switch by exercising the blade ports of the switch. This test sends frames from a given port's transmitter and loops them back into the same port's receiver. The loopback is done at the parallel loopback path.
portLoopbackTest CSPAT: 0x7e, 0x7e, 0x7e, 0x7e, ... BYTE_LFSR: 0x69, 0x01, 0x02, 0x05, ... CHALF_SQ: 0x4a, 0x4a, 0x4a, 0x4a, ... QUAD_NOT: 0x00, 0xff, 0x00, 0xff, ... CQTR_SQ: 0x78, 0x78, 0x78, 0x78, ... CRPAT: 0xbc, 0xbc, 0x23, 0x47, ... RANDOM: 0x25, 0x7f, 0x6e, 0x9a, .... Notes Do not abort this test prematurely, using CTRL-C or q to quit. Doing so may cause the test to report unexpected errors. Errors may vary depending on the hardware platform.
portLoopbackTest -lb_mode mode Specifies the loopback mode for the test. By default, this test uses the internal loopback. Valid values depend on the platform on which the command is executed. Unsupported values are rejected with an appropriate message. To run this test with mode values of 1 and 7, loopback cables must be connected to all front end ports or the test will fail. 1 Port Loopback (loopback plugs) 2 External (SERDES) loopback 5 Internal (parallel) loopback.
portLoopbackTest -uports itemlist Specifies a list of user ports to test. If this operand is omitted, by default the test will run on all valid blade ports in the slot. Refer to itemList for more information on the itemlist parameter. This option is only available for 16 Gbps-capable and 32 Gbps-capable blades. Diagnostics When it detects failures, the test may report one or more of the following error messages. If errors persist, contact Technical Support.
portName portName Assigns or displays port names. Synopsis portname portname [slot/]port [-n name] portname -i [index1[-index2][...][-f] [-n name]] portname -x [hex1[-hex2] [...][-f] [-n name]] portname -slot slot1[-slot2] [...][-n name] portname -d [format_string | -default | -help] portname -h Description Use this command to assign a port name to a specified port or to a range of ports. The port name is included in the portShow output; it should not be confused with the world wide port name.
portName port Assigns a name to a single port identified by its port number. -i index1[-index2] Assigns a name to a single port or to a range of ports identified by port index numbers, for example, -i 1/3-8 -n backup. You may specify multiple index ranges separated by a space, for example, -i 35-45 61-68 -n backup. -x [hex1 [-hex2]] Specifies a port or a range of ports identified by port index numbers in hexadecimal format.
portName -default Sets the dynamic port name format to the default format string "S.T.I.A". -help Displays the syntax and usage guidelines for the -d operand. -h Displays the command usage.
portPeerBeacon portPeerBeacon Sets the port peer beaconing to physically identify the interconnections between ports. Synopsis portpeerbeacon --enable [slot/]port portpeerbeacon --disable [slot/]port portpeerbeacon --show -all portpeerbeacon --help Description Use this command to turn on or off the port peer beaconing to physically identify the interconnections between ports.
portPeerBeacon To determine whether or not beaconing is enabled or disabled on the switch or chassis, use the switchBeacon or chassisBeacon command without operands. A value of 0 indicates that the command is disabled, a value of 1 indicates that the command is enabled. Issue the portBeacon --show -all command to display beaconing status. The switchShow command displays the status of the switchBeacon command only.
portPeerBeacon To display the trunk port port peer beacon information (in this example, 2/4, 2/8, and 3/4 are the master ports of their trunking group, and the other ports are the slave ports in their trunking group): switch:admin> portpeerbeacon --show -all PortPeerBeacon enabled port(s): FID 128: Trunk-2/4, 2/5, 2/7, 2/0, 2/1, 2/3, 2/2, 2/6,Trunk-2/8, 2/9, 2/10, 2/11, FID 10: Trunk-3/4, 3/5, 3/6, 3/7, SEE ALSO chassisBeacon, portBeacon, switchBeacon Brocade Fabric OS Command Reference 53-1004112-02 8
portPerfShow portPerfShow Displays port throughput performance. Synopsis portperfshow portperfshow [[slot/]port1[-[slot/]port2]] [-tx -rx | -tx | -rx] [-t interval]] portperfshow -x hex1[-hex2] portperfshow --help Description Use this command to display throughput information for all ports on a switch or chassis or to display the information for a specified port or port range.
portPerfShow -t time_interval Specifies the interval, in seconds, between each sample. The default interval is one second. If no interval is specified, the default is used. To run this command one time only, specify an interval of zero. -tx Displays the transmitter throughput. -rx Displays the receiver throughput. -tx -rx Displays the transmitter and receiver throughput.
portPerfShow 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 ==================================================================== 0 210.1m 840.6m 210.1m 0 112 0 0 0 0 0 0 0 0 0 0 32 33 34 35 36 37 38 39 Total ============================================== 0 0 0 0 0 0 0 0 2.5g 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 ===================================================================== 630.4m 0 0 0 0 0 0 0 0 0 630.
portPerfShow To display port performance on a chassis for range of ports ('*' indicates a SIM port): switch:user> portperfshow 0-2 0 1 2 Total ========================== * 0 * 0 To display port performance on a chassis for range of ports at an interval of 5 seconds: switch:user> portperfshow 12/0-12/6 -t 5 0 1 2 3 4 5 6 Total =============================================================== slot 12: 840.6m 0 0 0 0 0 630.4m 1.
portRouteShow portRouteShow Displays routing tables for the specified port. Synopsis Description portrouteshow [slot/]port Use this command to display the port address ID for a specified port and the contents of the following port routing tables: External unicast routing table Displays how the specified port forwards unicast frames to remote domains in the following format: domain_number: ports_bitmap domain_number The remote domain ID to which frames are ultimately routed.
portRouteShow Examples To display the routing tables for a port: switch:user> portrouteshow 4/15 port address ID: 0x02bf00 external unicast routing table: 1: 0x4 (vc=3) 2: 0x10000 (vc=0) internal unicast routing table: 60: 0x8000 (vc=2) 63: 0x1000 (vc=5) broadcast routing table: 0x10000 SEE ALSO bcastShow, fabricShow, switchShow, topologyShow, uRouteShow Brocade Fabric OS Command Reference 53-1004112-02 825
portShow portShow Displays status and configuration parameters for ports and GbE ports. Synopsis portshow [slot/][ge]port portshow [slot/]port -link [-force] portshow -i [ index1 [-index2] [...]] [-f] portshow -pid pid portshow -x [hex1[-hex2] [...
portShow The behavior of this command is platform-specific. Some command options are not available on all platforms. Use the following section headings to navigate this page. • • • Display general port status information on all platforms Display IP Interface configurations on the Brocade 7840, SX6, or FX8-24 platforms: - portshow ipif - Displays the local IP interfaces. - portshow autoneg - Displays autonegotiation status. - portshow mgmtif - Displays the inband management interfaces.
portShow Description Use this command to display general port status and configuration parameters for the specified port. This command is valid on all platforms, but the output is platform-specific and not all fields are displayed on all platforms. The following general information is displayed when the command is issued for a non-GbE port without additional arguments: portIndex Index number assigned to the port. portName Name assigned to the port by the portName command.
portShow Online Up and running. Offline Not online, see portPhys for more detail. Testing Running diagnostics. Faulty Failed diagnostics. Persistently Disabled Persistently disabled. Protocol Protocol used by the port: FC or FCoE. portPhys The port's physical state: No_Card No interface card present. No_Module No module (GBIC or other) present. No_Light Module is not receiving light (8 Gbps-capable ports only).
portShow port generation number The port's generation number for the last offline state change. 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. If the base device logs out and one or more NPIVs are online, the PWWN of the NPIVs online are displayed. Distance The port's long-distance level.
portShow BB XLate Information on the xlate (translate) phantom domain presented at this port. Includes the preferred (if not active) or actual (if active) domain ID for the xlate phantom domain and the WWN of the xlate phantom domain. The xlate phantom domain connected at this port is in the same fabric as the router and represents the edge fabric connected to the EX_Port. Authentication Type Displays NONE or DH-CHAP. DH-CHAP is the only authentication type supported on EX_Ports.
portShow Overrun Buffer overrun interrupts. Suspended Transmission suspended interrupts. Parity_err Central memory parity errors. 2_parity_err Secondary transmission parity errors. CMI_bus_err Control message interface errors. FEC Corrected Blocks FEC corrected block errors. FEC Uncorrected Blocks FEC uncorrected block errors. The second column displays link error status block counters. The third column shows the number of F_RJTs and F_BSYs generated.
portShow Examples To display the current state of a D_Port: switch:admin> portshow 28 portName: port28 portHealth: Fabric vision license not present Authentication: None portDisableReason: None portCFlags: 0x1 portFlags: 0x10004103 PRESENT ACTIVE E_PORT \ G_PORT D_PORT U_PORT LOGIN LED LocalSwcFlags: 0x0 portType: 24.
portShow portState: 1 Online Protocol: FC portPhys: 6 In_Sync portScn: 1 port generation number: 44 state transition count: 12 Online Trunk master port To display the state of a VE_Port on a chassis with an FX8-24 blade: switch:admin> portshow 7/12 portIndex: 140 portName: slot7port12 portHealth: Fabric vision license not present Authentication: None portDisableReason: None portCFlags: 0x1 portFlags: 0x490b PRESENT ACTIVE VIRTUAL E_PORT \ G_PORT U_PORT LOGICAL_ONLINE LOGIN LED portType: 12.
portShow state transition count: 1 portId: 850800 portIfId: 43020028 portWwn: 20:08:00:05:1e:76:60:80 portWwn of device(s) connected: Distance: normal portSpeed: 10Gbps To display the cached data for a port: switch:admin> portshow 32 portIndex: 32 portName: port32 portHealth: Authentication: None portDisableReason: None portCFlags: 0x1 portFlags: 0x18024b03 PRESENT ACTIVE T_FPORT T_FMASTER F_PORT G_PORT U_PORT LOGICAL_ONLINE LOGIN NOELP LED ACCEPT FLOGI LocalSwcFlags: 0x0 portType: 24.
portShow FEC Uncorrected Blocks: 0 PEER PORT portWwn: 20:20:00:27:f8:81:85:69 nodeWwn: 20:20:00:27:f8:81:85:69 PN_PORT Phy Type: PN Port/PF Port [PN Port/PF Port, lossless Ethernet MAC] Link_failure: 0 Loss_of_sync: 0 Loss_of_sig: 0 Protocol_err: 0 Invalid_word: 0 Invalid_crc: 0 FEC Corrected Blocks: 0 FEC Uncorrected Blocks: 0 To display the information of a remote switch port: switch:admin> portshow -pid 0x010500 SWITCH PORT0xDDAA00 portWwn: 20:20:00:27:f8:81:85:69 nodeWwn: 20:20:00:27:f8:81:85:69 PN_PO
portShow Description Notes Operands Use this command to display FCIP-related configuration parameters on the Brocade 7840 switch, on the Brocade SX6 extension blade, and on the Brocade FX8-24 blade. The parameters displayed by this command are set with the portCfg command. The following displays are supported with this command: • • • • • • portshow ipif - Displays the local IP interfaces. • • • portshow mgmtif - Displays the inband management interfaces.
portShow --link-local Displays the link-local interface routes. This operand is optional. arp Displays the address resolution protocol (ARP) and IPv6 neighbor discovery table. You can display the content of the ARP table, but you cannot modify its contents. --link-local Displays the neighbor discovery entries for the link-local addresses. This operand is optional. -lmac Displays the local MAC address. This operand is optional. vlantag Displays the VLAN Tagging configuration.
portShow tcl Displays TCL information. The following options are supported: -s | --summary Displays summary view of all the TCLs. -d | --detail Displays detailed view of all the TCLs. -p | --priority Sorts the TCL list based on the priority. -s | --sort sort_field Sorts the TCL list based on specified sort field. Valid values for sort_field are name (TCL name), priority (priority ID of the TCL), src-addr (source IP address), and dst-addr (destination IP address).
portShow -tcp Displays the TCP error counter values for the LAN connections. Use this operand with -top or -bottom to display TCP error counter values for the specified number of top or bottom compression connections. --known-apps Displays the list of supported well-known applications for the aggregation statistics. --global Displays the global LAN statistics for the switch. -dp Displays the global LAN statistics of each dual processor within the switch. -reset Resets the global LAN statistics.
portShow --filter filter_args Filters the portShow output based on the specified filter arguments. The filter arguments can be specified in any combination or as a conditional statement using the logical AND or OR operator. A conditional statement can have up to 30 conditions. This operand is supported with ipif, iproute, tcl, and lan-stats options. The following filter arguments are supported: -ipaddr ip_address Filters the output based on the specified IP address.
portShow 8/xge0 192.168.0.111 / 32 * U H L 8/xge0 192.168.1.0 / 24 * U C X 8/xge0 192.168.1.111 / 32 * U H L X -------------------------------------------------------------------------------Flags: U=Usable G=Gateway H=Host C=Created(Interface) S=Static L=LinkLayer X=Crossport To display the IP interface and static route configured on Brocade 7840: switch:admin> portshow iproute -l Port IP Address / Pfx Gateway Flags ------------------------------------------------------------------------ge0.dp0 192.168.0.
portShow ge14.dp0 fe80:e::5:33ff:f065:7b16 / 64 1500 0 U R M ge14.dp1 fe80:e::5:33ff:f165:7b16 / 64 1500 0 U R M ge15.dp0 fe80:f::5:33ff:f065:7b17 / 64 1500 0 U R M ge15.dp1 fe80:f::5:33ff:f165:7b17 / 64 1500 0 U R M ge16.dp0 fe80:10::5:33ff:f065:7b18 / 64 1500 0 U R M ge16.dp1 fe80:10::5:33ff:f165:7b18 / 64 1500 0 U R M ge17.dp0 fe80:11::5:33ff:f065:7b19 / 64 1500 0 U R M ge17.
portShow To display the LAG information: switch:admin> portshow lag LAG Name State Port Count Member Ports -----------------------------------------------lag0 Online 3 ge2,ge3,ge4 edgeSw1 Online 2 ge7,ge8 ------------------------------------------------ To display detailed LAG information: switch:admin> portshow lag --detail LAG: lag0 -----------------------------------------Oper State: Online Port Count: 3 Port AdminSt OperState Speed AutoNeg ge2 Enabled Online 10G Enabled ge3 Enabled Online 10G Enabled
portShow L4 Protocol: Protocol Port: Segment Preservation: Action: Cfgmask: Hit Count: ANY ANY Disabled Deny 0x08c9007 0 To display the LAN connections based on the throughput (in the following example, the number of connections is more than 25): switch:admin> portshow lan-stats --per-flow ***Displaying Top 25 connections by throughput*** Src-Address Dst-Address Sport Dport Pro Tx(B/s) Rx(B/s) --------------------------------------------------------------------192.168.20.223 192.168.10.
portShow To display the TCP error counter values: switch:admin> portshow lan-stats --per-flow -tcp ***Displaying Top 1 connections by throughput*** Src-Address Dst-Address Sport Dport Pro Tx(B/s) Rx(B/s) TCP TxPkt RxPkt TxDrp RxDrp ReTx DpAck OOO RTT FlwCtrl ---------------------------------------------------------------------------192.168.20.223 192.168.10.225 49679 49864 TCP 17.4m 17.4m 0 1.
portShow LDAP 389,8404,636 MS-SQL 1443 MySQL 3306 NETAPP-SNAP-MIRROR 10566 NFS 2049 ORACLE-SQL 66,1525,1521 RSYNC 873 SRDF 1748 SSH 22 SSL-SHELL 614 TELNET 23,107,513,992 TFTP 69 VERITAS-BACKUP 6101-6102,6106,3527,1125 VTS-GRID Control 1415-1416 VTS-GRID Data 350 ----------------------------------------------- To display the global LAN statistics: switch:admin> portshow lan-stats --global LAN Global stats -----------------------------------------------Active TCP conn :25 Establish TCP conn :116 Closed TCP
portShow RX UDP Tcl lookup fail PDUs :85 RX UDP Tcl-Deny PDUs :1012 Total RX UDP PDU drops :1104 RX UDP PDU drops due to stream flow control :0 TX ICMP PDUs :0 TX ICMP PDU drops :0 RX ICMP PDUs :3 RX ICMP Tcl lookup fail PDUs :3 RX ICMP Tcl-Deny PDUs :0 Total RX ICMP PDU drops :3 RX ICMP PDU drops due to stream flow control :0 TX ASIS IP PDUs :0 TX ASIS IP PDU drops :0 RX ASIS IP PDUs :36 RX ASIS IP Tcl lookup fail PDUs :20 RX ASIS IP Tcl-Deny PDUs :8 Total RX ASIS IP PDU drops :28 RX ASIS IP PDU drops due
portShow Dst IP Address: 192.79.10.
portShow To thaw the LAN statistic table: portshow lan-stats --hist-stats -thaw DP0 Connection Summary:(Thawed) -------------------------------------------------------------------------------Idx Src-Address Dst-Address Sport Dport Pro Tx(B) Rx(B) -------------------------------------------------------------------------------First 5 Connections: 0 192.78.10.242 192.79.10.243 53786 49374 TCP 271 72 1 192.78.10.242 192.79.10.243 53785 59038 TCP 120 8 2 192.78.10.242 192.79.10.243 53788 59039 TCP 711.1m 689.
portShow Description Use this command to display configuration parameters and status information for FCIP tunnels and FCIP circuits on the GbE/10GbE ports on the Brocade 7840, Brocade SX6, and FX8-24 platforms. The FCIP tunnels on the local and remote GbE ports act as Virtual E_Ports (VE_Ports) connecting the local and remote fabrics.
portShow -p | --perf Displays additional performance information for the specified FCIP tunnels. --lifetime Displays the entire lifetime statistics for FCIP Tunnels, Circuits and the associated TCP connections. This option will ignore any time based deltas that were created previously set using the --reset option. -q | --qos Displays the QoS statistics including performance for each priority. This operand is optional with the --perf option.
portShow --lifetime Displays the entire lifetime statistics for FCIP Tunnels, Circuits and the associated TCP connections. This option will ignore any time based deltas that were created previously set using the --reset option. -p | --perf Displays additional performance information for the specified FCIP circuit. --lifetime Displays the entire lifetime statistics for FCIP Tunnels, Circuits and the associated TCP connections.
portShow command Specifies the type of information to be displayed. This operand is optional; if omitted, the default (-stats) is used. You can specify more than one command option. Valid commands include the following: -stats Displays FCP emulation statistics. This is the default display. -info Displays general FCP emulation information. -cfg Displays the FCP emulation configuration. -dump Displays a raw data dump including data for all information types.
portShow -stats Displays global FICON Emulation statistics for the tunnel including FICON XRC Emulation, FICON Tape Write, FICON Tape Read, FICON Teradata Write, and FICON Teradata Read statistics. -fdpb adrs Displays FICON ports or a specific FICON Device Path Block. -fchb adrs Displays FICON logical partitions (LPARs) or a specific FICON Channel Control Block. -fcub adrs Displays FICON images (the same output as with -images) or a specific FICON Control Unit Block. -images Displays FICON images.
portShow -emultera Displays FICON Teradata emulation statistics. -emulprint Displays FICON Printer emulation statistics. -act Displays the current Active Exchange information. options The following additional option is supported. -clear Resets the specified statistics. This operand is optional; it requires a preceding command. -mem adrs length Specifies the SE memory length in words to display. The valid range for length is 0 to 1024. -dram2 Display the current usage of the dynamic memory allocator.
portShow -rtt ms Filters the output based on the specified circuit round trip time in milliseconds. -connect-count value Filters the output based on the connected count exceeding specified value. -bps value[k | m] Filters the output based on bandwidth (bytes per second) exceeding the specified value. Specify k for KBps and m for MBps. -or The logical OR operator. -and The logical AND operator. -default show | hide Sets the default display action if the specified filter statement is not supported.
portShow Uptime : Stats Duration : Receiver Stats : Sender Stats : TCP Bytes In/Out : ReTx/OOO/SloSt/DupAck: RTT (min/avg/max) : Wan Util : TxQ Util : 50m13s 35m19s 846212584 bytes / 4594438 pkts / 560.99 KBps Avg 216803637504 bytes / 29122536 pkts / 144.36 MBps Avg 3135072280 / 223666014748 0 / 0 / 0 / 0 1 / 1 / 1 ms 26.3% 0.
portShow Peer WWN : RemWWN (config) : FICON : XRC : Tape Pipelining : Read Block id : Tin Tir : DevAck : Tera Read : Tera Write : Print : FICON Max Read Pipe : FICON Max Write Pipe : FICON Max Read Devs : FICON Max Write Devs : FICON Write Timer : FICON Write Chain : FICON OXID Base : FICON Debug Flags : cfgmask : Flow Status : ConCount/Duration : Uptime : Stats Duration : Receiver Stats : Sender Stats : TCP Bytes In/Out : ReTx/OOO/SloSt/DupAck: RTT (min/avg/max) : Wan Util : TxQ Util : 10:00:00:05:33:65:
portShow FICON Max Read Pipe : FICON Max Write Pipe : FICON Max Read Devs : FICON Max Write Devs : FICON Write Timer : FICON Write Chain : FICON OXID Base : FICON Debug Flags : cfgmask : Flow Status : ConCount/Duration : Uptime : Stats Duration : Receiver Stats : Sender Stats : TCP Bytes In/Out : ReTx/OOO/SloSt/DupAck: RTT (min/avg/max) : Wan Util : TxQ Util : 32 32 16 16 300 3200000 0x8000 0x77c90000 0x003fc7ff 0x40000208 0 1 / 33m59s 48m53s 33m59s 811663752 bytes / 4406845 pkts / 554.
portShow Configured Comm Rates: Peer Comm Rates : Actual Comm Rates : Keepalive (Cfg/Peer) : Metric : Connection Type : ARL-Type : PMTU : SLA : Failover Group : VLAN-ID : L2Cos (FC:h/m/l) : L2Cos (IP:h/m/l) : DSCP (FC:h/m/l) : DSCP (IP:h/m/l) : cfgmask : Flow Status : ConCount/Duration : Uptime : Stats Duration : Receiver Stats : Sender Stats : TCP Bytes In/Out : ReTx/OOO/SloSt/DupAck: RTT (min/avg/max) : Wan Util : 2000000 / 5000000 kbps 2000000 / 5000000 kbps 2000000 / 5000000 kbps 1000 (1000 / 1000) ms
portShow FICON Write Chain : FICON OXID Base : FICON Debug Flags : cfgmask : Flow Status : ConCount/Duration : Uptime : Stats Duration : Receiver Stats : Sender Stats : TCP Bytes In/Out : ReTx/OOO/SloSt/DupAck: RTT (min/avg/max) : Wan Util : TxQ Util : 3200000 0x8000 0x77c90000 0x003fc7ff 0x40000208 0 1 / 36m53s 51m46s 36m52s 888449704 bytes / 4823789 pkts / 518.43 KBps Avg 227615878740 bytes / 30565366 pkts / 133.07 MBps Avg 3293193644 / 234818572912 0 / 0 / 0 / 0 1 / 1 / 1 ms 31.1% 0.0% Circuit 8/27.
portShow Pkts InFlight Recv Window Size / Scale SendQ Nxt / Min / Max RecvQ Nxt / Min / Max RecvQ Pkts Sender Stats Sent Bytes / Pkts Unacked Data Retransmits Slow / Fast SlowStart Reciever Stats Recv Bytes / Pkts Out-of-Order Duplicate ACKs RTT / Variance (High) [output truncated] : 0 : : : : 20832768 (Max:20832768) / 9 0x8e5c8b31 / 0x8e5c8b31 / 0x8e5c8b31 0x0e776252 / 0x0e776252 / 0x0fb54402 0 : : : : 510608 / 5742 0 0 / 0 (High:0) 0 : : : : 536792 / 5742 0 (High:0) 0 0 ms (0 ms) / 0 ms (0 ms) To
portShow Sender Stats : TCP Bytes In/Out : ReTx/OOO/SloSt/DupAck: RTT (min/avg/max) : Wan Util : TxQ Util : 230389776820 bytes / 31031771 pkts / 7012468568 / 237786788876 0 / 0 / 0 / 0 1 / 1 / 1 ms 3.2% 0.0% 14.02 MBps Avg Circuit 8/27.0 (DP1) ==================================================== Admin/Oper State : Enabled / Online Flags : 0x00000000 IP Addr (L/R) : 192.168.2.170 8/ge2 <-> 192.168.2.164 HA IP Addr (L/R) : 192.168.2.70 8/ge2 <-> 192.168.2.
portShow DSCP (IP:h/m/l) : cfgmask : Flow Status : ConCount/Duration : Uptime : Stats Duration : Receiver Stats : Sender Stats : TCP Bytes In/Out : ReTx/OOO/SloSt/DupAck: RTT (min/avg/max) : Wan Util : 0 / 0 / 0 0x40000000 0x00013c2f 0 1 / 38m38s 53m33s 38m38s 2245929472 bytes / 2681187 pkts / 44.17 MBps Avg 115198570188 bytes / 15516010 pkts / 7.00 MBps Avg 3514474436 / 118900788176 0 / 0 / 0 / 0 1 / 1 / 1 ms 3.
portShow TxQ Util : 0.0% Circuit 8/27.0 (DP1) ==================================================== Admin/Oper State : Enabled / Online Flags : 0x00000000 IP Addr (L/R) : 192.168.2.170 8/ge2 <-> 192.168.2.164 HA IP Addr (L/R) : 192.168.2.70 8/ge2 <-> 192.168.2.
portShow Reciever Stats Recv Bytes / Pkts Out-of-Order Duplicate ACKs RTT / Variance (High) : : : : 682504 / 7292 0 (High:0) 0 0 ms (0 ms) / 0 ms (0 ms) To display IPSec parameters on an IPSec-enabled tunnel: switch:admin> portshow fciptunnel 24 -i Tunnel: VE-Port:24 (idx:0, DP0) ==================================================== Oper State : Enabled TID : 24 Flags : 0x00000000 IP-Extension : Disabled Compression : None QoS BW Ratio : 50% / 30% / 20% Fastwrite : Disabled Tape Pipelining : Disabled IPS
portShow | TCP Bytes In: 842506236 | TCP Bytes Out: 1446465008 | TCP Packets In: 16072571 | TCP Packets Out: 16063156 | Retransmits: 0 | Longest RTT: 0 ms | Out Of Sequence: 0 | Slow Starts: 0 | Circuit Count: 2 | TCP Count: 24 | Circuits: |--> Circuit 1/12.
portShow | Aggregate TCP Stats: | TCP Bytes In: 773873596 | TCP Bytes Out: 1272254116 | TCP Packets In: 13433108 | TCP Packets Out: 13423689 | Retransmits: 0 | Longest RTT: 0 ms | Out Of Sequence: 0 | Slow Starts: 0 | TCP Count: 12 | TCP Connections: |---> TCP Conn 1/12.0:15240899 |---> TCP Conn 1/12.0:15240900 |---> TCP Conn 1/12.0:15240901 |---> TCP Conn 1/12.0:15241489 |---> TCP Conn 1/12.0:15241490 |---> TCP Conn 1/12.0:15241491 |---> TCP Conn 1/12.0:15241292 |---> TCP Conn 1/12.
portShow a=aggressive compression A=Auto compression f=fastwrite t=Tapepipelining F=FICON T=TPerf i=IPSec l=IPSec Legacy Flags: circuit: s=sack v=VLAN Tagged x=crossport 4=IPv4 6=IPv6 L=Listener I=Initiator To display a tunnel on a Brocade FX8-24 with IPSec enabled in legacy mode: switch:admin> portshow fciptunnel 1/12 ------------------------------------------Tunnel ID: 1/12 Tunnel Description: Admin Status: Enabled Oper Status: Up Compression: Off Fastwrite: Off Tape Acceleration: Off TPerf Option: Off
portShow To display a summary view of the QoS configuration on FCIP tunnels and circuits on the Brocade FX8-24: switch:admin> portshow fciptunnel 7/12 --summary --qos -------- --------------------------------------------------------Tunnel Circuit Priority Uptime Tx Bps Rx Bps TxPkts/s RxPkts/s ------- ---------------- ----------------- - ----------------------1/22 2d23h10m 0.00 0.00 0.00 0.00 1/22 F-Class 2d23h10m 0.00 0.00 0.00 0.00 1/22 High 2d23h10m 0.00 0.00 0.00 0.00 1/22 Medium 2d23h10m 0.00 0.00 0.
portShow 1/21 1 1/xge0 Up ---4-xs 3d2m 0.00 0.00 1 2500/2500 1/1/22 0 1/xge0 Up ---4--s 3d1m 0.00 0.00 1 2500/2500 0/1/22 1 1/xge1 Up ---4-xs 3d2m 0.00 0.00 1 2500/2500 1/1/31 0 1/xge0 Up ---4--s 3d2m 0.00 0.00 1 2500/2500 0/1/31 1 1/xge1 Up ---4-xs 3d2m 0.00 0.
portShow Flags: 0x00000000 ------------------------------------------Circuit ID: 1/21.
portShow To display QoS prioritization for the default circuit: switch:admin> portshow fcipcircuit 1/12 0 --perf --qos ------------------------------------------Circuit ID: 1/12.0 Circuit Num: 0 Admin Status: Enabled Oper Status: Up Connection Type: Default Remote IP: 192.168.12.200 Local IP: 192.168.12.
portShow 0 Input Packets 0 pkt/s 30s Avg, 0 pkt/s Lifetime Avg TCP Stats: 308550696 Output Bytes 3310618 Output Packets 176126080 Input Bytes 3310620 Input Packets Retransmits: 0 Round Trip Time: 0 ms Out Of Order: 0 Slow Starts: 0 Performance Statistics - Priority: Medium Oper Status: Up Flow Ctrl State: Off Connected Count: 1 Duration: 3 days, 19 hours, 57 minutes, 43 seconds 26358236 Output Bytes 17 Bps 30s Avg, 79 Bps Lifetime Avg 29611 Output Packets 0 pkt/s 30s Avg, 0 pkt/s Lifetime Avg 61983140 Inpu
portShow To display a summary view for the circuits on the Brocade 7840: switch:admin> portshow fciptunnel --circuit Tunnel Circuit OpStatus Flags Uptime TxMBps RxMBps ConnCnt CommRt Met/G -------------------------------------------------------------------------------24 Up -------36s 0.00 0.00 1 -/24 0 ge2 Up ---ah--4 36s 0.00 0.00 1 2500/5000 0/24 1 ge3 Up ---ah--4 10s 0.00 0.00 1 2500/5000 0/28 Up -------13s 0.00 0.00 1 -/28 0 ge4 Up ---a---4 13s 0.00 0.00 1 2500/5000 0/34 InProg -------0s 0.00 0.
portShow Failover Group : VLAN-ID : L2Cos (f/h/m/l) : DSCP (f/h/m/l) : cfgmask : Flow Status : ConCount/Duration : Receiver Stats : Sender Stats : TCP Bytes In/Out : ReTx/OOO/SloSt/DupAck: RTT (min/avg/max) : 0 NONE 0/0/0/0 0/0/0/0 0x00003c2f 0x40000000 1 0 / 0s 0 bytes / 0 pkts / 0.00 Bps Avg 0 bytes / 0 pkts / 0.00 Bps Avg 0 / 0 0 / 0 / 0 / 0 0 / 0 / 0 ms Circuit 24.
portShow TotalEgressFrames = 21636019 TotalFCEgressFrames = 10323404 TotalCmds = 7420486 TotalEmulDvcLvlAcks = 734 TotalEmulatedOps = 1889025 Idle Accepted Status = 92 Idle Not Accpt Status = 14 Idle Accepted ATTN = 4 MaxRetryQueueDepth = 0 MaxEgressQueueDepth = 3360 TotalCUBusyResponses = 5 TotalCUEndResponses = 5 TotalEmulatedCUBusys = 5 TotalEmulCUEnd = 5 WIRE Buffer Percentages LocalFree= 99 LocalLow= 99 PeerFree= 99 PeerLow=99 XBAR Buffer Percentages LocalFree=100 LocalLow=100 PeerFree=100 PeerLow=100
portShow FICON Debug Flags (ftrace and others) = 0x77c90000 (Default = 0x77c90000) ---------------------------------------------------Bit 31 [0x80000000] = 0 : TRIGGER_ON_SELRESET Bit 30 [0x40000000] = 1 : TRIGGER_ON_PURGEPATH Bit 29 [0x20000000] = 1 : TRIGGER_ON_RRS_MISS Bit 28 [0x10000000] = 1 : TRIGGER_ON_LRJ Bit Bit Bit Bit 27 26 25 24 [0x08000000] [0x04000000] [0x02000000] [0x01000000] = = = = 0 1 1 1 : : : : TRIGGER_ON_UNIT_CHECK TRIGGER_ON_LOOKUP_FAIL TRIGGER_ON_FDCB_ABORT TRIGGER_ON_NOFDCB_AB
portShow -----------------------EgrOx IngOx Valid VTN ===== ===== ===== === 0 1 Y 1 sq=0000000E77DF tg=80F0 0 0 Y 1 0 0 Y 1 sq=0000000E77DF tg=80F2 1 1 Y 1 sq=0000000E77DF tg=80F2 (Output split) To display the FICON Channel Blocks (all blocks and a specified block): switch:admin> portshow xtun 16 -ficon -fchb 041055B680 FCHB (FICON CHannel Block - one per LPAR) Count = 1 -------------------------------------------------------------(0x) Side Path: CU Count Emul ChTIN CuTIN =========== ==== ================
portShow 0410076880 0410078000 0410078880 041007A000 H H H H 0x176308640E0603** 0x176308640E0604** 0x176308640E0605** 0x176308640E0606** - 0x00 0x00 0x00 0x00 Type LPE BL ==== === == TAPE Yes TAPE Yes TAPE Yes TAPE Yes UNKN No DISK Yes DISK Yes UNKN No UNKN No UNKN No UNKN No UNKN No UNKN No UNKN No UNKN No (output split FC Egress parms: CHPID Tag V Ve P B P VC EGID ===== ========== = == = = = == ==== 00F0 0x15698E1E Y Y 2 0 1 02 000D 00F0 0x15B5E15F Y Y 2 0 2 02 000D 00F0 0x15D1509C Y Y 2 0 4 02 000
portShow MISC (hex) ========== state = statusFlags = errorCode = egressOxid = lastStatus = lastCmdArray= 0x00 prevState = 0x18 lastStateArray= 0x1C371415 0x4000 0x00 ingressOxid = 0xFFFF 0xFFFF allocatedOxid= 0xFFFF unsolIngrOxid = 0xFFFF 0x0C lastCmd = 0x00 tokenFlags = 0x00 0x773E3E64 lastStsArray= 0x08040C0Cl \ astXprtArray=0x08040C0C lastSeqId = 0x00 curSeqId = 0xB1 lastXportEmulMsg = 0x4F statusFctlHi = 0x18 curIuCnt = 0x0001 token = 0x00000000 endingChOxid = 0xFFFF endingCuOxid= 0xFFFF emulDvcAckSeq
portShow emulTeraWriteOps = 0x00043085 emulTeraReadOps = 0x00000000 emulTeraWrtBytes = 0x00000001679cb8b0 emulTeraReadBytes = 0x0000000000000000 emulTeraWriteCcws = 0x00043085 emulTeraReadCcws= 0x00000000 multUnitCheckCnt = 0x00000000 currentWriteChain = 160 largestWriteChain = 43936 bytesInWritePipe = 0 atMaxWrtBytesCount = 0 IU Pacing Values:crrsIssued=0 creditsOutstanding=0 currentCreditBurst=0 Historic Emulation Headers: =========================== current index = 1 ToPeerEmulHdr[0]=funct=2:msg=1:p1=0x
portShow To display FICON emulation statistics on the Brocade SX6 (as the following examples show, this command can display emulation statistics for Teradata, Tape, XRC, and Printer depending on the FICON devices and FICON Emulation Features that are enabled on the tunnel.
portShow Type LPE BL ==== === == DISK Yes DISK Yes FCTC Yes TAPE Yes (Output split CHPID Tag ===== ========== 0000 0x02908700 0000 0x0290E841 0000 0x02C4D969 0000 0x023D22B4 and truncated) V Ve P B P VC EGID cbState = == = = = == ==== ======= Y Y 2 0 0 05 0010 0 Y Y 2 0 0 05 0010 0 Y Y 2 0 0 15 0013 0 Y Y 2 0 3 15 0012 0 To display FICON emulation statistics for the FCIP tunnel: switch:admin> portshow xtun 23 -ficon -stats FICON FCIP Tunnel=7 Statistics: Emulation Common Statistical Counts (decimal) ===
portShow Total number of emulated Write Bytes= Number of emulated Write Chains = Total number of emulated Write CCWs = Average Emulated Writes Blocksize = Average Writes in Emulated Chains = Write emulation slowdowns = Slowdowns at Start of Chain = Slowdowns at End of chain = Current Host side Write FDCB Count = Max Concurrent Write FDCB Count = Current Write Limited FDCB Count = 1374007085422 11665734 39204146 35047 3 138931 83938 54993 4 16 0 Tape Read Emulation Statistical Counts (decimal) -----------
portShow Maximum Bytes in write pipe = Largest write chain processed = Total number of emulated Write Bytes= Number of emulated Write Chains = Total number of emulated Write CCWs = Average Emulated Writes Blocksize = Average Writes in Emulated Chains = Current Host side Write FDCB Count = Max Concurrent Write FDCB Count = Current Write Limited FDCB Count = 45627 9150 27375500 3500 6500 4211 1 1 1 1 FICON Debug Flags (ftrace and others) = 0xffc98030 (Default = 0xf7c90000) ---------------------------------
portShow Tera Read Performance Data: ---------------------------Emulated Chains per sec: Emulated CCWs per sec: Ave Read Block Size: Emulated Read BPS: 1069 1069 10780 11531104 To display FICON Printer performance data: switch:admin> portshow xtun 23 -ficon -printperf Printer Performance Monitor Data: =================================== Sample Time Period in ms: 7460 ---------------------------No Emulated Printer operations ---------------------------No Emulated Read operations To display FICON tape per
portStats64Show portStats64Show Displays the 64-bit hardware statistics for a port. Synopsis Description portstats64show [slot/]port [-long] Use this command to display 64-bit hardware statistics for a specified port. When used without the -long option, two integers are reported for most values, the lower and upper 32-bits are reported as two separate numbers. In this case, the top word is the most significant.
portStats64Show er64_toolong Number of frames longer than maximum. er_bad_eof Number of frames with bad end-of-frame. er64_enc_out Number of encoding error outside of frames. er64_disc_c3 Number of class 3 frames discarded. er64_pcs_blk Number of Physical Coding Sublayer (PCS) block errors. This counter records encoding violations on 10 Gbps or 16 Gbps ports. stat64_fec_cor The number of errors corrected by FEC. Displayed only on 16 Gbps-capable platforms and not on 32 Gbps-capable platforms.
portStats64Show stat64_inputBuffersFull Number of occasions on which input buffers are full. stat64_rxClass1Frames Number of class 1 frames received. stat64_aveTxFrameSize Average Tx Frame size, based on the word and frame counts during the last five seconds. stat64_aveRxFrameSize Average Rx Frame size, based on the word and frame counts during the last five seconds. The following counters provided by SNMP are displayed with portStats64Show -long on switches running Fabric OS v6.4.
portStats64Show swConnUnittStatRxMulticastToObjects, stat_mc_to The number of multicast timeouts. Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. This command is not supported on FCoE ports. Operands This command has the following operands: slot For bladed systems only, specify the slot number of the port to be displayed, followed by a slash (/).
portStats64Show er64_toolong 0 top_int : Frames longer than maximum 0 bottom_int : Frames longer than maximum er64_bad_eof 0 top_int : Frames with bad end-of-frame 0 bottom_int : Frames with bad end-of-frame er64_enc_out 0 top_int : Encoding error outside of frames 135762 bottom_int : Encoding error outside of frames er64_disc_c3 0 top_int : Class 3 frames discarded 0 bottom_int : Class 3 frames discarded er64_pcs_blk 0 top_int : PCS block errors 0 bottom_int : PCS block errors stat64_fec_cor 0 top_int :
portStatsClear portStatsClear Clears port hardware statistics. Synopsis portstatsclear [slot/]port portstatsclear -i [index1[-index2] [...] [-f]] portstatsclear -x [hex1[-hex2] [...]] portstatsclear -slot [slot1[-slot2][...] portstatsclear -h Description Use this command to clear the hardware statistics for the specified ports. Including ALPA-based CRC monitor, End-to-End monitor, and Filter-based performance monitor statistics.
portStatsClear -slot [slot1[-slot2] Clears all ports on a slot or on a range of slots, for example, -s 3-5. You may specify multiple slot ranges separated by a space, for example, -s 3-5 8-10. -h Displays the command usage.
portStatsShow portStatsShow Displays port hardware statistics. Synopsis portstatsshow [slot/]port portstatsshow -i [index1[-index2][...] [-f]] portstatsshow -x [hex1[-hex2] [...]] portstatsshow -slot [slot1[-slot2][...] portstatsshow ge [slot/]ge port portstatsshow ip [slot/]ge port [ip_address] portstatsshow fcip [slot/]ge port [tunnel_number] portstatsshow -h Description Use this command to display port hardware statistics counters.
portStatsShow stat_lc_rx The number of link control frames received. stat_mc_rx The number of multicast frames received. stat_mc_to The number of multicast timeouts. stat_mc_tx The number of multicast frames transmitted. tim_rdy_pri The number of times that sending R_RDY or VC_RDY primitive signals was a higher priority than sending frames, due to diminishing credit reserves in the transmitter at the other end of the fiber. This parameter is sampled at intervals of 1.
portStatsShow fec_uncor_detected The number of errors left uncorrected by FEC. er_enc_in The number of encoding errors inside frames. er_crc The number of frames with cyclic redundancy check (CRC) errors. er_trunc The number of frames shorter than the minimum frame length. er_toolong The number of frames longer than the maximum frame length. er_bad_eof The number of frames with bad end-of-frame. er_enc_out The number of encoding error outside frames.
portStatsShow er_type2_miss The number of frames with routing errors. er_type6_miss The number of FCR frames with receive errors. er_zone_miss , er_lun_zone_miss The number of frames discarded due to hard zoning miss or LUN zoning miss. If Rx port hard zoning is enabled, frames will be discarded at the Rx port. If TX port hard zoning is enabled, frames will be discarded at the TX port. If both RX and TX port hard zoning is enabled, frames will be discarded at the RX port.
portStatsShow ge_stat_tx_ucast_frms The number of unicast frames transmitted on the GbE port. ge_stat_tx_mcast_frms The number of multicast frames transmitted on the GbE port. ge_stat_tx_bcast_frms The number of broadcast frames transmitted on the GbE port. ge_stat_tx_vlan_frms The number of VLAN frames transmitted on the GbE port. ge_stat_tx_pause_frms The number of pause frames transmitted on the GbE port. ge_stat_rx_frms The number of frames received on the GbE port.
portStatsShow ip_err_tcp_data_chksum The number of IP TCP data checksum errors observed on the GbE port. Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. This command is not supported on FCoE ports. Operands This command has the following operands: slot For bladed systems only, specifies the slot number of the port to be displayed, followed by a slash (/).
portStatsShow Examples To display the basic set of statistics for port 1/13 on a 16 Gbps-capable platform: switch:admin> portstatsshow 1/13 stat_wtx 0 4-byte words transmitted stat_wrx 0 4-byte words received stat_ftx 0 Frames transmitted stat_frx 0 Frames received stat_c2_frx 0 Class 2 frames received stat_c3_frx 0 Class 3 frames received stat_lc_rx 0 Link control frames received stat_mc_rx 0 Multicast frames received stat_mc_to 0 Multicast timeouts stat_mc_tx 0 Multicast frames transmitted tim_rdy_pri 0
portStatsShow er_inv_arb compression_ratio open transfer opened starve_stop fl_tenancy nl_tenancy zero_tenancy phy_stats_clear_ts lgc_stats_clear_ts 0 Invalid ARB 6 Average compression ratio 0 loop_open 0 loop_transfer 0 FL_Port opened 0 tenancies stopped due to starvation 0 number of times FL has the tenancy 0 number of times NL has the tenancy 0 zero tenancy 04-22-2013 MDT Mon 17:08:41 Timestamp of phy_port stats clear 04-22-2013 MDT Mon 17:08:41 Timestamp of lgc_port stats clear To display the basic s
portSwap portSwap Swaps two ports or removes swapping of ports. Synopsis portswap [slot1/]port1 [slot2/]port2 portswap --restore Description Use this command to swap the 24-bit port address (PID) for a pair of ports or to remove swapping of ports. When swapping both ports must be disabled prior to executing this command and the port-swapping feature must be enabled using portSwapEnable. The result of this operation is persistent across reboots and power cycles.
portSwap Examples To swap area numbers between a pair of ports: switch:admin> portswap 8/1 8/2 portswap done switch:admin> portswapshow PortSwap is enabled Slot Slotport Swport Address ============================================ 8 1 193 0x01c200 8 2 194 0x01c100 To cancel the swapping of ports: switch:admin> portswap --restore portswap done switch:admin> SEE ALSO portDisable, portEnable, portShow, portSwapDisable, portSwapEnable, portSwapShow, switchShow Brocade Fabric OS Command Reference 53-1004112
portSwapDisable portSwapDisable Disables the PortSwap feature. Synopsis Description portswapdisable Use this command to disable the PortSwap feature. The portSwap command cannot be used after this feature is disabled. The disabled state of the PortSwap feature is persistent across reboots and power cycles. Enabling or disabling the PortSwap feature does not affect previously performed PortSwap operations.
portSwapEnable portSwapEnable Enables the PortSwap feature. Synopsis Description portswapenable Use this command to enable the PortSwap feature. The portSwap command cannot be used unless the feature is first enabled with this command. The enabled state of the PortSwap feature is persistent across reboots and power cycles. Enabling or disabling the PortSwap feature does not affect previously performed PortSwap operations.
portSwapShow portSwapShow Displays the state of the PortSwap feature. Synopsis portswapshow Description Use this command to display the state of the PortSwap feature and information about swapped ports. If portSwap is enabled and ports have been swapped, the command displays the enabled status as well as the swapped ports and the new port address (the 24-bit PID) for these ports.
portTest portTest Performs a functional test of a switch in a live fabric. Synopsis Description porttest [-ports itemlist] [-iteration count] [-userdelay time] [-timeout time] [-pattern pattern] [-patsize size] [-seed seed] [-listtype porttype] Use this command to isolate problems in a single replaceable element and to trace problems to near-end terminal equipment, far-end terminal equipment, or the transmission line.
portTest This command supports E_Ports, F_Ports (must support ELS Echo), L_Port, and N->N loopback ports. In addition, on switches running Fabric OS v6.4.0 and later, you can now use portTest on port configurations that previously caused nonspecific test results or were skipped by portTest. The following ports are now support the portTest diagnostics. • • • • • • • • • • E_Ports Static D_Ports N->N Loopback Ports F_Ports connected to Brocade-branded HBA Ports with index numbers greater than 255.
portTest Notes The test is skipped if the F_Ports are connected to non-Brocade-branded devices. The test is also skipped on F_Ports if Virtual Fabric is enabled on any platform. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. Operands This command has the following operands: -ports itemlist Specifies the list of user ports to test. By default, all user ports in the switch are tested.
portTest -5 All N->N loopback ports.
portTestShow portTestShow Displays information from portTest. Synopsis porttestshow [-ports itemlist] porttestshow -i | -index [index1[-index2]] porttestshow -x [hex1[-hex2]] Description Use this command to display a snapshot of information from portTest. The command output displays statistical data about past test runs and values for parameters that were set when the test was run. Refer to the portTest help page for more information on the displayed parameters.
portTestShow Timeout Number of timed out tests. ErrorCode Error code, if any. Notes Operands The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. This command has the following operand: -ports itemlist Displays test results for the specified ports. This operand is optional; if omitted, data for all ports are displayed. Refer to the itemList help page for further details.
portTestShow To display information from portTest on a port specified by the index number in hexadecimal format: switch:admin> porttestshow -x 0x21 Port 33 : PASS PortType: E PORT PortState: TEST DONE PortInternalState: INIT PortTypeToTest: NO_TEST Pattern: 0xb Seed: 0xaa UserDelay: 10 TotalIteration: 20 CurrentIteration: 20 TotalFail: 0 ConsecutiveFail: 0 StartTime: Wed Aug 13 06:39:59 2014 StopTime: Wed Aug 13 06:40:19 2014 Timeout: 0 ErrorCode: 0 SEE ALSO portLoopbackTest, portTest, spinFab, stopPortT
portTrunkArea portTrunkArea Assigns or removes a trunk area (TA) from a port or port trunk group; displays masterless F_Port trunking configuration.
portTrunkArea DI On enterprise-class platforms, displays the default port index. The default port index can be a port swapped area. The --show trunk option displays the following information: Trunk Index Displays the trunk index. ptA->ptB ptA indicates the local user port; ptB indicates the remote user port. sp Port speed in Gbps. Bandwidth The bandwidth (Rx, Tx, and the combined total for Tx+Rx) of the trunk group.
portTrunkArea Execution of this command is subject to the following restrictions: Notes • Only F_Port trunk ports are allowed to be part of a TA. E/F/L/EX_Port will be persistently disabled. Private L_Ports remain online but will not run traffic. • • • • Only one trunk master per TA is permitted. The second trunk master is persistently disabled. • You must enable trunking on all ports to be included in a TA before you can create a TA.
portTrunkArea --enable Creates a TA assigned to the specified ports. Use this option with one of the following operands: -area area_number On single processor switches, specifies the port area number for the static TA to be created. The TA must fall within the 8 port trunk group starting from port 0 on a switch or blade. The TA must be a default area of an existing port in a given port group.
portTrunkArea Examples To enable masterless F_Port trunking on a standalone switch: 1. Disable ports 10-11 by executing portdisable port for each port to be included in the TA. 2. Enable Trunk Area for ports 10-11 with area number 37: switch:admin> porttrunkarea --enable 10-11 -index 11 2009/05/15-12:43:10, [SWCH-1012], 60, FID 128, INFO, sw0, Trunk Area (11) has been enabled for one or more ports Trunk area 11 enabled for ports 10 and 11. 3.
portTrunkArea To configure a TA on an enterprise-class platform including ports 13 and 14 on slot 10 with port index of 125: 1. Disable the ports to be included in the TA. 2. Enable TA for ports 13 and 14 on slot 10 with port index of 125: switch:admin> porttrunkarea --enable 10/13-14 -index 125 Trunk index 125 enabled for ports 10/13 and 10/14. 3.
portZoneShow portZoneShow Displays the enforced zone type of the F_Ports and FL_Ports of a switch. Synopsis Description portzoneshow Use this command to display the enforced zone type of the F_Ports and FL_Ports of a switch. Output shows virtual port number (decimal), physical port number (decimal), online status, and if online, port type. If the current zone configuration has been disabled by cfgDisable, the fabric is in non-zoning mode, in which all devices see each other.
powerOffListSet powerOffListSet Sets the order in which slots are powered off. Synopsis Description powerofflistset Use this command to modify the order in which slots are powered off. This command displays the current order, and then prompts you interactively to confirm or modify the power-off position for each slot.
powerOffListSet 2nd 3rd 4th 5th 6th 7th 8th slot slot slot slot slot slot slot to to to to to to to be be be be be be be power power power power power power power off: off: off: off: off: off: off: (4..12) [11] 4 (5..12) [10] 5 (6..12) [9] 6 (9..12) [9] 9 (10..12) [10] 10 (11..12) [11] 11 (12..
powerOffListShow powerOffListShow Displays the order in which slots are powered off. Synopsis Description powerofflistshow Use this command to display the order in which the physical slots are powered off. Whenever a power supply goes out of service or a field-replaceable unit (FRU) is inserted, the system's available power is compared to the system's required power to determine if there is enough power to operate.
powerOffListShow Slot Slot Slot Slot Slot SEE ALSO 926 9 4 3 6 5 will will will will will be be be be be powered powered powered powered powered off off off off off 4th 5th 6th 7th 8th chassisShow, powerOffListSet, psShow, slotPowerOff, slotPowerOn, slotShow Brocade Fabric OS Command Reference 53-1004112-02
psShow psShow Displays power supply status. Synopsis Description psshow Use this command to display the current status of the switch power supplies. The status of each supply is displayed as: OK Power supply functioning correctly. absent Power supply not present. unknown Unknown power supply unit installed. predicting failure Power supply is present but predicting failure. faulty Power supply present but faulty (no power cable, power switch turned off, fuse blown, or other internal error).
rasAdmin rasAdmin Configures RASlog message generation.
rasAdmin -log MODULE-ID Enables or disables logging for all message included in the specified module. -syslog MSG-ID Enables or disables logging for an internal message. --set -log MSG-ID Changes the default severity level of the specified message. -severity value Specifies a new severity level for the message. Valid values include INFO, WARNING, ERROR, CRITICAL, and DEFAULT. --show -disabled Displays all messages that have been disabled.
rasAdmin To change the severity level of a RASlog message: switch:admin> rasadmin --set -log SEC-1203 -severity WARNING Message Severity SEC-1203: WARNING To display a list of all messages that have been disabled: switch:admin> rasadmin --show -disabled Message Status Default Severity IPAD-1002 DISABLED INFO IPAD-1003 DISABLED INFO Current Severity INFO INFO To display the status and configuration of messages that belong to the specified module: switch:admin> rasadmin --show -module RM Message Status De
rasMan rasMan Displays RASlog message text and documentation. Synopsis rasman message_id rasman --help Description Use this command to display documentation for a specified RASlog message. The message is specified by its message ID. The command output is identical to the documentation provided in the Fabric OS Message Reference. For each message, the command displays the following information: MESSAGE Displays the message text. MESSAGE TYPE Displays the message type.
rasMan Examples To display documentation for a ZONE audit message: switch:admin> rasman ZONE-3018 Log Messages ZONE-3018(7m) MESSAGE ZONE-3018 - Event: Status: success, Info: has been deactivated. MESSAGE TYPE AUDIT CLASS FABRIC SEVERITY INFO PROBABLE CAUSE Indicates that the specified Admin Domain been deactivated. (AD) object has RECOMMENDED ACTION Verify that the event was planned. If the event was planned, no action is required.
reboot reboot Reboots the control processor (CP). Synopsis Description reboot [-f] Use this command to perform a "cold reboot" (power off/restart) of the control processor. This operation may be disruptive, and the command prompts for confirmation before executing. When you reboot a switch connected to a fabric, all traffic to and from that switch stops. All Fibre Channel ports on that switch including E_Ports become inactive until the switch comes back online.
reboot To reboot a CP on a DCX when HA is enabled: switch:admin> reboot Warning: This command is being run on a control processor (CP) based system and will cause the active CP to reboot. Are you sure you want to reboot the active CP [y/n]? y Broadcast message from root (pts/0) Sun Feb 28 19:49:45 2010... The system is going down for reboot NOW !! To reboot a CP on a DCX when haFailover is disabled: switch:admin> reboot This command is being run on a control processor (CP) based system.
relayConfig relayConfig Sets and displays the relay host IP address. Synopsis relayconfig --config -rla_ip relay_ip -rla_dname domain_name relayconfig --delete relayconfig --show relayconfig --help Description Use this command to configure or display the relay host that is used to send the Monitoring and Alerting Policy Suite (MAPS) e-mail notifications. You can configure the e-mail recipients using the mapsConfig --emailcfg command.
relayConfig To display the relay host configuration: switch:admin> relayconfig --show Relay Host: 10.70.212.168 Relay Domain Name: mail.brocade.
roleConfig roleConfig Manages user-defined roles.
roleConfig role_name Specifies the name for the role to be created or modified. The name must be unique; it is case-insensitive and can contain only alpha characters. The role name must be at least 4 characters long and cannot exceed 16 characters. The maximum number of user-defined roles allowed on a chassis is 150. This operand is required. The following operands are optional with --add and --change: -desc description Specifies a description for the role of up to 63 characters.
roleConfig -all [default] Displays a listing of all user-defined roles. When used together with the optional -default option, both the user-defined roles and the predefined Fabric OS roles are displayed. --help Displays the command usage. Examples To create a role with Zoning and SecurityAdmnin permissions and OM access: switch:admin> roleconfig --add myzonesec \ -d "Zone and Security Admin" -c Security,zoning -p OM To change the access permissions of the previously created role and to display the resul
rootAccess rootAccess Configures root access through CLI. Synopsis rootaccess --set [none | consoleonly | all] rootaccess --show rootaccess --help Description Use this command to display and set root access settings. Use the --set command to configure the root user to login to the switch through console or other interfaces such as SSH, Telnet or Web Tools, or to block root login from the interfaces. By default, access to the root account is allowed through console only.
rootAccess To display root access settings: switch:admin> rootaccess --show RootAccess: all SEE ALSO userConfig Brocade Fabric OS Command Reference 53-1004112-02 941
routeHelp routeHelp Displays a list of FSPF-related commands. Synopsis Description Notes routehelp Use this command to display a list of fabric-shortest-path-first (FSPF)-related commands. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
rtLogTrace rtLogTrace Manages real-time trace logging. Synopsis rtlogtrace --enable rtlogtrace --disable rtlogtrace --show rtlogtrace --help Description Use this command to enable or disable real-time trace logging and to indicate whether the feature is enabled or disabled. The RTLog facility captures the most recent hardware events and low-level software interrupts on Brocade DCX platforms in real time. When enabled, the RTLog traces are collected as part of the supportSave utility.
sddQuarantine sddQuarantine Clears or displays the quarantined ports. Synopsis sddquarantine --clear [[slot/]port | all] [-force] sddquarantine --show sddquarantine --help Description Use this command to clear or display ports that are quarantined by the MAPS action "SDDQ".
sddQuarantine Examples To clear quarantined state for a port: switch:admin> sddquarantine --clear 33 Initiated clearing port from quarantined state To clear quarantined state for all ports: switch:admin> sddquarantine --clear all The clear action was not initiated for the following port(s).
secActiveSize secActiveSize Displays the size of the active security database. Synopsis Description secactivesize Use this command to display the size of the active security database. The command also displays the maximum database size. For switches running Fabric OS v6.2.0 and later, the maximum security database size is 1 megabyte per logical switch. With up to eight partitions, the total database size on a chassis can be up to 8 megabytes.
secAuthSecret secAuthSecret Manages the DH-CHAP shared secret key information. Synopsis secauthsecret --show secauthsecret --set secauthsecret --remove value | --all Description Use this command to manage the DH-CHAP shared secret key database used for authentication. This command displays, sets, and removes shared secret key information from the database or deletes the entire database. If you are performing set or remove operations, when the command is completed new data is saved persistently.
secAuthSecret To list the shared secret WWN in Access Gateway mode: switch:admin> secauthsecret --show WWN DId Name --------------------------------------10:00:00:60:69:80:5b:e8 -1 Unknown To set the shared secret: switch:admin> secAuthSecret --set This command sets up secret keys for the DH-CHAP authentication. The minimum length of a secret key is 8 characters and maximum 40 characters. Setting up secret keys does not initiate DH-CHAP authentication.
secCertUtil secCertUtil Manages certificates on a switch.
secCertUtil Description Use this command to manage third-party certificates on a switch, including Public Key Infrastructure (PKI) based certificates, Lightweight Directory Access Protocol (LDAP) certificates, FCAP certificates, and syslog CA certificates. This command also imports or exports Certificate Signing Requests (CSRs) from or to a remote host. This command supports IPV4 and IPV6 addresses. Use this command to do the following: • • • • • • • • • • Generate a public/private key pair.
secCertUtil delkey Deletes all public/private key pairs with the exception of Encryption-related certificates and key pairs. This command prompts for confirmation unless -nowarn is specified. -nowarn Executes the delete operation without confirmation. -all Deletes all public/private key pairs including Encryption-related certificates and key pairs. gencsr Generates a new CSR for the switch. This is the second step in setting up a third-party certificate.
secCertUtil -commoncert Generates the CSR and key file with key size of 1024 or 2048 for the common certificate. -keysize 1024 | 2048 Specifies the size of the key. Valid values are 1024 or 2048. bits. The greater the value, the more secure is the connection; however, performance degrades with size. -hash sha1 | sha256 Specifies the hash type. Valid values are "sha256" or "sha1". -nowarn Generates the certificate without confirmation. -https Generates HTTPS certificate.
secCertUtil certificate name The name of the certificate to be deleted. -nowarn Deletes the specified file without confirmation. This operand is optional. export Exports a CSR to a host. This command is typically used to submit a CSR to the Certification Authority (CA) that issues the certificate. The following operands are optional; if omitted, the command prompts interactively for your input. -ldapcacert -certname certificate name Exports an LDAP CA certificate from the switch to a remote host.
secCertUtil -password password Specifies the password for the user account. When using SCP, for security reasons, do not enter a password on the command line. Use the interactive version instead. Use CTRL-C to skip the password. import Imports a certificate. Use this command to import a certificate from the server or to download a certificate issued by a CA after sending the CSR to the CA. If the certificate type is not mentioned, a generic certificate is imported.
secCertUtil -login login name Specifies the login name for the server. -password password Specifies the password for the user account. When using SCP, for security reasons, do not enter a password on the command line. Use the interactive version instead. show Lists all existing PKI-based certificates on the switch. The following operands are optional and exclusive. -ldapcacert Displays the LDAP certificate file name. -syslogcacert [certificate name] Displays the list of imported syslog CA certificates.
secCertUtil Locality Name (eg, city name):"San Jose" Organization Name (eg, company name):Brocade Organizational Unit Name (eg, department \ or section name): IT Common Name (Fully qualified Domain Name, \ or IP address):192.168.38.206 generating CSR, file name is: 192.168.38.206.csr Done To generate a CSR in noninteractive mode: switch:admin> seccertutil gencsr -country US \ -state California -locality "San Jose" \ -org Brocade -orgunit software -cn 192.168.38.
secCertUtil To import an FCAP switch certificate in interactive mode: switch:admin> seccertutil import -fcapswcert Select protocol [ftp or scp]: scp Enter IP address: 10.32.2.25 Enter remote directory: /users/myname/OPENSSL Enter certificate name (must have ".pem" suffix):01.pem Enter Login Name: myname myname@10.32.2.25's password: Success: imported certificate [01.pem].
secCertUtil To export the switch certificate from the switch to the remote host in noninteractive mode: switch:admin> seccertutil import -commonswcert \ -ipaddr 10.32.2.25 -remotedir /users/myname/OPENSSL \ certs -certname 01.pem -login myname -password passwd Success: imported certificate [01.pem]. To export an LDAP CA certificate from the local switch to a remote host in interactive mode: switch:admin> seccertutil export -ldapcacert Select protocol [ftp or scp]: scp Enter IP address: 192.168.38.
secCertUtil To delete all FCAP PKI objects: switch:admin> seccertutil delete -fcapall WARNING!!! About to delete FCAP-Files: ARE YOU SURE (yes, y, no, n): [no] y To generate FCAP PKI objects: switch:admin> seccertutil generate \ -fcapall -keysize 1024 Generating a new key pair will automatically do the following: 1. Delete all existing CSRs. 2. Delete existing switch certificate. 3. Reset the certificate filename to none. Continue (yes, y, no, n): [no] y Installing Private Key and Csr...
secCryptoCfg secCryptoCfg Configures and displays cryptographic parameters and templates.
secCryptoCfg Notes Operands The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. This command has the following operands: --replace -type SSH | https Configures the specified ciphers, kex, and MAC algorithms for SSH or HTTPS and restarts the SSH or HTTPS daemon. -cipher cipher_string Specifies the SSH or HTTPS cipher list.
secCryptoCfg -kex value Specifies the SSH kex algorithms list. You can either specify one or more kex algorithms separated by a comma, for example, ecdh-sha2-nistp256,diffie-hellman-group-exchange-sha256. The following kex algorithms are configured by default. You can modify the kex algorithms list using this operand.
secCryptoCfg -proto scp | sftp | ftp Specifies the protocol as either SCP, SFTP, or FTP. -file remote_file_name Specifies the remote directory. Provide a fully qualified path name. --lstemplates Displays the list of templates available. --verify template_name Verifies the running configuration against a required configuration specified in the template file. --delete template_name Deletes the specified template file. --show [template_name] Displays the configured cipher, kex, and MAC algorithms.
secCryptoCfg To set the default CC configuration template: switch:admin> seccryptocfg --apply default_cc Validating.... Applying... Template configurations applied successfully To import a template file: switch:admin> seccryptocfg --import cc_import -server 10.70.12.10 \ -name brocade -proto scp -file /users/home40/brocade/default_cc brocade@10.70.12.10's password: Import successful To export a template file: switch:admin> seccryptocfg --export default_cc -server 10.70.12.10 \ -name brocade -proto scp -f
secCryptoCfg To display the configured ciphers, kex, and MAC algorithms: switch:admin> seccryptocfg --show HTTPS Cipher List : !ECDH:!DH:HIGH:-MD5:!CAMELLIA:!SRP:!PSK:!AESGCM SSH Cipher List : aes128-ctr,aes192-ctr,aes256-ctr,aes128-cbc, \ 3des-cbc,aes192-cbc,aes256-cbc SSH Kex Algorithms List : ecdh-sha2-nistp256,ecdh-sha2-nistp384, \ ecdh-sha2-nistp521, \ diffie-hellman-group-exchange-sha256, \ diffie-hellman-group-exchange-sha1, \ diffie-hellman-group14-sha1, \ diffie-hellman-group1-sha1 SSH MACs List :
secDefineSize secDefineSize Displays the size of the defined security database. Synopsis Description secdefinesize Use this command to display the size of the defined security database. The command also displays the maximum database size. For switches running Fabric OS v6.2.0 and later, the maximum security database size is 1 Megabyte per logical switch. With up to eight partitions, the total database size on a chassis can be up to 8 Megabytes.
secGlobalShow secGlobalShow Displays the current internal security state information. Synopsis Description secglobalshow Use this command to display security server-specific information as a snapshot of its current state.
secGlobalShow Active Sum 215b Security Defined DataSize 35 bytes Define Sum 215b Zone Size (include enabled configuration) 312 bytes Zone sum e04b215b sec_db: free primaryDLPhase 0 ----wwnDL State----pid tid key sec usec --------- LOG CACHE --------14:08:50 813905136 secipadm_ipchange receives notification 14:08:50 850588912 secProcessIPChange starts processing 14:08:50 850588912 secProcessIPChange acks completion (Output truncated) SEE ALSO 968 secActiveSize, secDefineSize Brocade Fabric OS Command R
secHelp secHelp Displays information about security commands. Synopsis Description Notes sechelp Use this command to display a list of security commands with a brief description of the commands. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
secPolicyAbort secPolicyAbort Aborts all unsaved changes to the defined database. Synopsis Description Notes secpolicyabort Use this command to abort all changes to the defined security database that have not been saved to flash memory and to abort changes to policy creation and modification operations from all the switches if a fabric-wide consistency policy is not set for the particular policy. When an FCS policy is enabled, this command can be issued only from the Primary FCS switch.
secPolicyActivate secPolicyActivate Saves and activates the Defined Security Policy Set. Synopsis Description secpolicyactivate Use this command to activate the current defined security policy to all switches in the fabric. This activates the policy set on the local switch or all switches in the fabric depending on the fabric-wide consistency policy.
secPolicyAdd secPolicyAdd Adds members to an existing security policy. Synopsis Description secpolicyadd "name","member[;member...]" [-legacy] Use this command to add one or more members to an existing access policy. Each policy corresponds to a management method. The list of members of a policy acts as an access control list for that management method. Before a policy is created, there is no enforcement for that management method; all access is granted.
secPolicyAdd Operands This command has the following operands: "name" Specify the name of an existing policy to which you want to add members. Valid values for this operand include the following: • • • DCC_POLICY_nnn FCS_POLICY SCC_POLICY The specified policy name must be capitalized. The DCC_POLICY_nnn name has the common prefix DCC_POLICY_ followed by a string of user-defined characters. These characters do not have to be capitalized like regular policy names, but they are case-sensitive.
secPolicyAdd Examples 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 to SCC_POLICY. To add two devices to attach to domain 3, ports 1 and 3, in an existing empty DCC policy; the port WWN of the first device is 11:22:33:44:55:66:77:aa and port WWN of the second device is 11:22:33:44:55:66:77:bb: primaryfcs:admin> secpolicyadd "DCC_POLICY_abc", \ "11:22:33:44:55:66:77:aa;11:22:33:44:55:66:77:bb;3(1,3
secPolicyCreate secPolicyCreate Creates a new security policy. Synopsis Description secpolicycreate "name" [, "member[;member...]"] [-legacy] Use this command to create a new policy and to edit Switch Connection Control (SCC), Device Connection Control (DCC), and Fabric Configuration Server (FCS) policies on the local switch. All policies can be created only once, except for the DCC_POLICY_nnn. Each DCC_POLICY_nnn must have a unique name.
secPolicyCreate Operands This command has the following operands: "name" Specify the name of the policy you want to create. Valid values for this operand include the following: • • • DCC_POLICY_nnn SCC_POLICY FCS_POLICY The specified policy name must be capitalized. The DCC_POLICY_nnn name has the common prefix DCC_POLICY_ followed by a string of user-defined characters. These characters do not have to be capitalized like regular policy names.
secPolicyCreate [*] Selects all ports on the switch and devices currently attached to those ports. SCC_POLICY and FCC_POLICY Members This policy type requires member IDs to be specified as WWN strings, domains, or switch names. If domain or switch names are used, the switches associated must be present in the fabric or the command fails. To add all switches in the current fabric as members of the policy, enter an asterisk enclosed in quotation marks (*) as the member value.
secPolicyCreate To 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:39:5f:67 10.32.69.53 10.20.30.
secPolicyDelete secPolicyDelete Deletes an existing security policy. Synopsis Description secpolicydelete name Use this command to delete an existing security policy from the defined security database. Run secPolicyActivate to delete the policies from the active security policy list. Deleting a security policy does not cause any traffic disruption. Each policy corresponds to a management method. The list of members of a policy acts as an access control list for that management method.
secPolicyDelete To delete all existing DCC policies in the fabric: primaryfcs:admin> secpolicydelete ALL_DCC_POLICY About to clear all the DCC policies ARE YOU SURE (yes, y, no, n): [no] y To delete all stale DCC policies in the fabric: primaryfcs:admin> secpolicydelete ALL_STALE_DCC_POLICY About to clear all STALE DCC policies ARE YOU SURE (yes, y, no, n): [no] y SEE ALSO 980 secPolicyAbort, secPolicyActivate, secPolicyAdd, secPolicyCreate, secPolicyDump, secPolicyRemove, secPolicySave, secPolicyShow
secPolicyDump secPolicyDump Displays the members of one or all existing security policies. Synopsis Description Notes secpolicydump ["listtype"][,"name"] Use this command to display, without page breaks, the members of an existing policy in the active and defined (saved) databases. When issued without operands, this command displays the members of all security policies. The execution of this command is subject to Virtual Fabric restrictions that may be in place.
secPolicyDump To display all security policies in the active database: switch:admin> secpolicydump "active" ____________________________________________________ ACTIVE POLICY SET FCS_POLICY Pos Primary WWN DId swName -------------------------------------------------1 Yes 10:00:00:05:1e:39:5f:67 3 NeptuneSec 2 No 10:00:00:05:1e:90:09:4a - Unknown SCC_POLICY WWN DId swName -------------------------------------------------10:00:00:05:1e:39:5f:67 3 NeptuneSec 10:00:00:05:1e:90:09:4a - Unknown DCC_POLICY_h1 Typ
secPolicyDump To display the FCS policies in the defined database: switch:admin> secpolicydump "Defined","FCS_POLICY" ____________________________________________________ DEFINED POLICY SET FCS_POLICY Pos Primary WWN DId swName -------------------------------------------------1 Yes 10:00:00:05:1e:39: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" _______________________________________________
secPolicyFCSMove secPolicyFCSMove Moves a member in the FCS policy. Synopsis Description Notes secpolicyfcsmove [from, to] Use this command to move an FCS member from one position to another position in the FCS list. Only one FCS can be moved at a time. The first FCS switch in the list that is also present in the fabric is the Primary FCS. If a backup FCS is moved to the first position, it becomes the primary FCS after activation.
secPolicyFCSMove To move Backup FCS switch from position 3 to position 1 in the FCS list(non-interactively): switch:admin> secpolicyshow ____________________________________________________ ACTIVE POLICY SET 1 Yes 10:00:00:05:1e:39:5f:67 2 switch1 2 No 10:00:00:05:1e:04:ef:0e 4 switch2 3 No 10:00:00:05:1e:35:cd:ef 200 switch3 switch:admin> secpolicyfcsmove 3,1 ____________________________________________________ DEFINED POLICY SET FCS_POLICY Pos Primary WWN DId swName --------------------------------------
secPolicyRemove secPolicyRemove Removes members from an existing security policy. Synopsis Description secpolicyremove "name" ,"member[;member...]" Use this command to remove one or more members from an existing security policy. It is not possible to remove all members from the FCS_POLICY; the local switch WWN cannot be deleted from the FCS policy. In the case of SCC policy, if it is empty after removing all members, all access to the switch itself would be disallowed. Beginning Fabric OS v7.
secPolicyRemove DCC_POLICY Members The DCC_Policy_nnn is a list of devices 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 parameter can be specified by port number separated by commas, and enclosed in either brackets or parentheses: for example, (2, 4, 6).
secPolicySave secPolicySave Saves a defined security policy to persistent memory. Synopsis Description Notes secpolicysave Use this command to save a defined security policy to persistent memory. SecPolicySave saves the modified SCC, DCC, and FCS policies to the Defined Security Policy Set on the local switch. This command is always a local switch operation. A fabric-wide consistency configuration does not affect the behavior of this command.
secPolicyShow secPolicyShow Displays an existing security policy including the FCS policy. Synopsis Description secpolicyshow ["policy_set"[", name"]] Use this command to display the members of an existing policy in the Active or Defined security policy set. The command can be issued from all FCS switches. This command displays the policy database one page at a time. Use the secPolicyDump command to display the policy database without page breaks.
secPolicyShow To display all security policies from defined databases: switch:admin> secpolicyshow "defined" __________________________________________________ DEFINED POLICY 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 ___________________________________________________ SEE ALSO 990 fddCfg, secPolicyAbort, secPolicyActivate, secPolicyAdd, secPolicyCreate, secPolicyDelete, secPoli
secStatsReset secStatsReset Resets one or all security statistics to 0. Synopsis secstatsreset [name][,"domain[;domain]"] Description Use this command to reset one or all security statistics to 0. This command can be issued on any switch to reset the security statistics on the local switch or chassis. If an FCS policy is enabled and secStatsReset is issued on the primary FCS switch, this command can reset security statistics for any or all switches in the fabric.
secStatsReset To reset DCC_POLICY statistics on domains 1 and 69: primaryfcs:admin> secstatsreset DCC_POLICY, "1;69" Reset DCC_POLICY statistic.
secStatsShow secStatsShow Displays one or all security statistics. Synopsis Description Notes Operands secstatsshow [name[,"domain[;domain]"]] Use this command to display one or all security statistics. This command can be issued on any switch to display local security statistics. If an FCS policy is enabled and secStatsShow is issued on the primary FCS switch, this command can retrieve and display the security statistics for any or all switches in the fabric.
secStatsShow Examples To display the LOGIN policy statistics for the local domain. switch:admin> secstatsshow LOGIN Fabric Statistics: Domain 1: Name Value ========================================= LOGIN 2 To display statistic information for TELNET_POLICY for all switches in the fabric from the primary FCS switch.
sensorShow sensorShow Displays sensor readings. Synopsis Description Notes sensorshow Use this command to display the current temperature, fan, and power supply status and readings from sensors located on the switch. The actual location of the sensors varies, depending on the switch type. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
serDesTuneMode serDesTuneMode Configures and displays SerDes tuning values. Synopsis serdestunemode --set serdestunemode --reset serdestunemode --show serdestunemode --autoenable serdestunemode --autodisable serdestunemode --autoreset serdestunemode --autoshow serdestunemode --help Description Use this command to configure and display SerDes tuning values on the Brocade FC8-16 blade and to control tuning optimization of backend links for all Brocade FC8-xx blades.
serDesTuneMode Operands This command has the following operands: --set Enables SerDes tuning mode and sets new SerDes values on FC8-16 blades in slots 1, 2 and 7 and on peer ports in the CR4S-8 core blade. --reset Disables SerDes tuning mode and resets SerDes values to default on FC8-16 blades in slots 1, 2 and 7 and on peer ports in the CR4S-8 core blade. --show Indicates whether the SerDes tuning mode is enabled or disabled. --autoenable Enables SerDes tuning optimization on all backend ports.
serDesTuneMode To enable SerDes tuning optimization on all backend ports and to display the configuration: switch:admin> serdestunemode --autoenable Autotunemode is turned on switch:admin> serdestunemode --show Autotunemode is turned 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 a
setContext setContext Sets the logical switch context to a specified FID. Synopsis Description setcontext [FID | switchname] Use this command to set the logical switch context to a specified fabric ID (FID) or unique switch name. The FID uniquely defines a partition as a logical switch. Use lscfg --show to display currently configured partitions and their FIDs. A logical switch context defines the boundaries within which a user can execute commands in a Virtual Fabric-aware environment.
setDbg setDbg Sets the debug level of the specified module. Synopsis Description setdbg [module_name][level] Use this command to set the debug level of a specified module. Debug levels filter the display of debug messages to the serial console. By default, no debug messages are displayed. High debug level values can generate a large volume of messages, degrading the system response time. The set of supported modules and their current debug levels are displayed by the command dbgShow.
setVerbose setVerbose Specifies module verbose level. Synopsis Description Notes Operands setverbose [module_name][level] Use this command to set the verbose level of the specified module. These levels filter the display of the debug message to the serial console. By default, no debug messages are displayed. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
sfpShow sfpShow Displays Small Form-factor Pluggable (SFP) transceiver information. Synopsis sfpshow sfpshow [slot/]port -link [-force] sfpshow [slot/]geport [ -f] sfpshow -pid pid sfpshow -all sfpshow -health sfpshow --help Description Use this command to display information about Serial Identification SFPs, also known as module definition "4" SFPs. These SFPs provide extended information that describes the SFP capabilities, interfaces, manufacturer, and other information.
sfpShow The identifier field has the following values to indicate the various transceiver types: • • • • • • • Operands 1 for GBIC 2 for On-board 3 for SFP 6 for XFP 12 for QSFP 13 for QSFP+ 17 for QSFP28 This command has the following operands: slot For bladed systems only, specifies the slot number of the port to display, followed by a slash (/) port Specifies the number of the port for which to display the SFP information, relative to its slot for bladed systems.
sfpShow Unknown This state displays for 8 Gbps, 4 Gbps and 2 Gbps SPF types not supported by this feature. Paused Health monitoring is not enabled on the switch. --help Displays the command usage.
sfpShow To display detailed information about a single 16G QSFP: switch:user> sfpshow 3/44 QSFP No: 11 Channel No:0 Identifier: 13 QSFP+ Connector: 12 MPO Parallel Optic Transceiver: 0000000000000000 16_Gbps sw Short_dist Encoding: 5 64B66B Baud Rate: 140 (units 100 megabaud) Length 9u: 0 (units km) Length 50u (OM4): 100 (units m) Length 62.
sfpShow Alarm flags[0,1] = 0x0, 0x0 Warn Flags[0,1] = 0x0, 0x0 Temperature: Not Available Current : Not Available Voltage : Not Available RX Power : Not Available TX Power : Not Available Last poll time: Polling has not started To display detailed information about all SFPs: switch:user> sfpshow -all (output truncated) ============= Slot 8/Port 50: ============= ============= Slot 8/Port 51: ============= ============= Slot 8/Port 52: ============= QSFP No: 13 Channel No:0 Identifier: 13 QSFP+ Connector:
sfpShow To display mini-SFPs on a X6 with a FC32-48 blade: switch:user> setcontext 52 switch:user> sfpshow Slot 8/Port 34: id (sw) Vendor: BROCADE \ Serial No: AA1041J0134 Speed: 4,8,16_Gbps Slot 8/Port 35: -Slot 8/Port 36: id (sw) Vendor: BROCADE \ Serial No: HAA21338102SEP2 Speed: 4,8,16_Gbps Slot 8/Port 37: id (sw) Vendor: BROCADE \ Serial No: JAF115100000F7T Speed: 8,16,32_Gbps Slot 8/Port 38: -Slot 8/Port 39: -Slot 8/Port 40: id (sw) Vendor: BROCADE \ Serial No: HAA21403104VFR2 Speed: 4,8,16_Gbps Slo
sfpShow RX Power:-2.2 dBm (598.0uW) TX Power:-2.8 dBm (525.9 uW) State transitions: 1 Last poll time: 03-17-2016 UTC Thu 02:45:52 To display detailed information for GbE port on a X6 with a SX6 blade: switch:admin> sfpshow ge0 Identifier: 13 QSFP+ Connector: 12 MPO Parallel Optic Transceiver: 0000000000000004 40_Gbps \ sw Short_dist Encoding: 5 64B66B Baud Rate: 103 (units 100 megabaud) Length 9u: 0 (units km) Length 50u (OM3): 100 (units m) Length 62.
sfpShow Tx_Fault,Tx_Disable BR Max: 0 BR Min: 0 Serial No: AAF210300000PW1 Date Code: 100721 DD Type: 0x68 Enh Options: 0xf0 Status/Ctrl: 0xb0 Alarm flags[0,1] = 0x5, 0x0 Warn Flags[0,1] = 0x5, 0x0 Temperature: 42 Centigrade Current: 8.236 mAmps Voltage: 3333.1 mVolts RX Power:-1.8 dBm (662.8uW) TX Power:-2.5 dBm (561.
sfpShow To display detailed information of SFP on G620: switch:admin> sfpshow 0 Identifier: 3 SFP Connector: 7 LC Transceiver: 700c406000000000 4,8,16_Gbps \ M5,M6 sw Inter,Short_dist Encoding: 6 64B66B Baud Rate: 140 (units 100 megabaud) Length 9u: 0 (units km) Length 9u: 0 (units 100 meters) Length 50u (OM2): 4 (units 10 meters) Length 50u (OM3): 10 (units 10 meters) Length 62.
sfpShow Options: 0007ffde Loss_of_Sig,Loss_of_Sig_Inverted Max Case Temp: 0 (C) Device Tech: 0x00 Serial No: ZTA11517000001F Date Code: 150528 DD Type: 0xc Enh Options: 0x0 Status/Ctrl: 0x0 Alarm flags[0,1] = 0x0, 0x0 Warn Flags[0,1] = 0x0, 0x0 Temperature: 50 Centigrade Current: 7.494 mAmps Voltage: 3315.4 mVolts RX Power: -inf dBm (0.0 uW) TX Power: -25.2 dBm (3.
sfpShow Current: 6.418 mAmps Voltage: 3327.2 mVolts RX Power: -3.9 dBm (403.5uW) TX Power: -2.6 dBm (553.2 uW) Signal Loss (Upstream): 50 uW Signal Loss (Downstream): 48 uW Port Speeed Capabilities 16Gbps, 8Gbps, 4Gbps, 2Gbps To display the information of a remote switch port: switch:admin> sfpshow -pid 0x010500 SWITCH PORT SFP Optical Port: Optical Port Optical Type: Long Wave Laser LC Temperature: 52 Centigrade Current: 6.418 mAmps Voltage: 3327.2 mVolts RX Power: 395.4 uW TX Power: 544.
shellFlowControlDisable shellFlowControlDisable Disables XON/XOFF flow control on the console serial port. Synopsis Description shellflowcontroldisable Use this command to disable XON/XOFF flow control on the console serial port. Flow control is disabled by default. Because this command changes the flow control on the console serial port, it must be executed from a session that is logged in from the console serial port. This command cannot run from a Telnet session.
shellFlowControlEnable shellFlowControlEnable Enables XON/XOFF flow control on the console serial port. Synopsis Description shellflowcontrolenable Use this command to enable XON/XOFF flow control to the shell task. Flow control is disabled by default. Because this command changes the flow control on the console serial port, it must be executed from a session that is logged in from the console serial port. This command cannot run from a Telnet session.
slotPowerOff slotPowerOff Removes power from a slot. Synopsis slotpoweroff slot [-force] slotpoweroff --help Description Use this command to turn off the power to a blade unit. The slot must have a valid blade unit present and the blade unit must be of a type that can be powered off. This command is supported on 8 Gbps-capable, 16 Gbps-capable, and 32 Gbps-capable core blades also. There is no frame loss when there are no ICLs connected.
slotPowerOn slotPowerOn Restores power to a slot. Synopsis slotpoweron slot slotpoweron --help Description Use this command to turn on the power to a blade unit. The slot must have a valid blade unit present and the blade unit must be currently powered off. The slotShow command reports such slots as being in the state of INSERTED, NOT POWERED ON. This command is supported on 8 Gbps-capable, 16 Gbps-capable, and 32 Gbps-capable core blades also. There is no frame loss when there are no ICLs connected.
slotShow slotShow Displays the status of all slots in the system. Synopsis Description slotshow [-m] [-p] Use this command to display the current status of each slot in the system. Depending on the option used, the command retrieves information on blade type, blade ID, status, Brocade model name, and power usage for each slot in the switch or chassis. This command does not display the model names for unsupported blades.
slotShow 96 FC16-48 switch blade 97 FC16-32 switch blade 98 CR16-8 core blade 99 CR16-4 core blade 153 FC16-64 switch blade 175 CPX6 control processor blade 177 CR32-8 core blade 178 FC32-48 switch blade 186 SX6 application processor 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. POWERING UP The blade is present and powering on.
slotShow FAULTY The blade is faulty because an error was detected. A fault code of 53 may also indicate the possibility of a rolling reboot detection (RRD) on the specified blade. In the case of an RRD, investigate and correct the cause, then reboot the control processor (CP) to recover the blade. UNKNOWN The blade is inserted but its state cannot be determined. Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place.
slotShow To display the Brocade model name for each blade on a Brocade X6-8: switch:user> slotshow -m Slot Blade Type ID Status ------------------------------------------------1 CP BLADE 175 CPX6 ENABLED 2 CP BLADE 175 CPX6 ENABLED 3 AP BLADE 186 SX6 ENABLED 4 AP BLADE 186 SX6 ENABLED 5 SW BLADE 178 FC32-48 ENABLED 6 SW BLADE 178 FC32-48 ENABLED 7 CORE BLADE 177 CR32-8 ENABLED 8 CORE BLADE 177 CR32-8 ENABLED 9 AP BLADE 186 SX6 ENABLED 10 SW BLADE 178 FC32-48 ENABLED 11 SW BLADE 178 FC32-48 ENABLED 12 AP BL
slotShow 5 6 7 8 CORE BLADE CORE BLADE SW BLADE AP BLADE 176 176 178 186 CR32-4 CR32-4 FC32-48 SX6 ENABLED ENABLED ENABLED ENABLED To display power consumption information on a Brocade X6-4: switch:user> slotshow -p Slot Blade Type ID DC Power Status Consumption ------------------------------------------------1 CP BLADE 175 55 ENABLED 2 UNKNOWN VACANT 3 UNKNOWN VACANT 4 UNKNOWN VACANT 5 CORE BLADE 176 250 ENABLED 6 UNKNOWN VACANT 7 SW BLADE 178 260 ENABLED 8 SW BLADE 178 260 ENABLED Total DC Power Co
snmpConfig snmpConfig Manages the SNMP agent configuration.
snmpConfig The SNMPv3 configuration supports sending inform requests as an alternative to trap requests. Traps are unreliable because the receiver does not send any acknowledgment when it receives a trap. The sender cannot determine if the trap was received. However, an SNMP manager that receives an inform request acknowledges the message with an SNMP response protocol data unit (PDU). If the manager does not receive an inform request, it does not send a response.
snmpConfig Access Control Configuration Parameters The ACL check is as follows: there are six ACLs to restrict SNMP get, set, and trap operations to hosts under an host-subnet-area. The host-subnet-area is defined by comparing nonzero IP octets. For example, an ACL of 192.168.64.0 enables access by any hosts that start with the specified octets. The connecting host is enabled to set each host-subnet-area to be read-write or read-only. The closest match out of six entries is given access.
snmpConfig fruStatusChanged (1) 0x2 Enabled cpStatusChanged (2) 0x4 Enabled fruHistoryTrap (3) 0x8 Enabled ____________________________________________________ FCIP-MIB 0x1 Enabled ____________________________________________________ IF-MIB 0x1 Enabled linkUpTrap (3) 0x8 Enabled linkdownTrap (4) 0x10 Enabled ____________________________________________________ MAPS-MIB 0x1 Enabled mapsTrapAM (1) 0x2 Enabled ___________________________________________________ T11-FC-ZONE-SERVER-MIB 0x1 Disabled t11ZsRequest
snmpConfig snmpv1 Selects SNMPv1-related configuration parameters. These parameters include the community string, trap recipient IP address, and trap severity level associated with each trap recipient IP address. When "0" is configured as a trap port, traps can be received at the default port 162. snmpv3 Selects SNMPv3-related configuration parameters.
snmpConfig -enable | -disable [informs] Enables or disables informs. If informs are enabled, all trap destinations receive inform requests. If informs are disabled, all trap destinations receive trap requests. When informs are enabled, the engine ID must be set to correspond to the management engine IP address. Informs are by default disabled. IPv6 Informs are currently not supported. -user user_name Specifies the name of the user that connects to the agent.
snmpConfig -mib_name mib_name Specifies the name of the MIB to be configured. This operand is required if you want to configure MIB traps noninteractively. Valid MIB names include the following. • • • • • • • • • • FE-MIB SW-MIB FA-MIB FICON-MIB HA-MIB FCIP-MIB ISCSI-MIB IF-MIB MAPS-MIB T11-FC-ZONE-SERVER-MIB -bitmask bit_mask Specifies the bit mask for the MIB. Refer to the table above for valid values. -trap_name trap_name Specifies the name of the trap to be enabled or disable.
snmpConfig -authtrapenabled [ON | OFF] Enables or disables the authentication traps. When enabled, the authentication trap (authenticationFailure) is transmitted to a configured trap recipient in the event that the agent receives a protocol message that is not properly authenticated. In the context of SNMPv1 and SNMPv2c, this means that a request contains a community string that is not known to the agent.The default value for this parameter is OFF (disabled). secLevel Sets the SNMP security level.
snmpConfig To set the SNMPv3 configuration of a switch noninteractively: switch:admin> snmpconfig --set snmpv3 -index 2 -user user1 \ -host 1.3.4.5 -port 178 -severity 5 -auth_proto 2 \ -auth_passwd "password1" -priv_proto 3 -priv_passwd "password2" \ -engine_id "80:00:08:08:08:98:AB:5C:01" -notify_type informs \ Committing configuration.....done To set the severity level for switch events and MAPS alerts interactively: switch:admin> [...
snmpConfig To enable the SW-MIB MIB only without changing the current trap configuration: switch:admin> snmpconfig --enable mibcapability \ -mib_name SW-MIB Operation succeeded switch:admin> snmpconfig --show mibcapability [...
snmpConfig BD-MIB: YES BROCADE-MAPS-MIB: YES T11-FC-ZONE-SERVER-MIB: NO SW-TRAP: YES swFCPortScn: YES swEventTrap: YES DesiredSeverity:None swIPv6ChangeTrap: YES DesiredSeverity:None swPmgrEventTrap: YES swFabricReconfigTrap: YES swFabricSegmentTrap: YES swExtTrap: NO swStateChangeTrap: NO swPortMoveTrap: NO swBrcdGenericTrap: YES swDeviceStatusTrap: YES swZoneConfigChangeTrap: NO FA-TRAP: YES connUnitStatusChange: YES connUnitEventTrap: YES connUnitPortStatusChange: YES FICON-TRAP: YES linkRNIDDeviceRegis
snmpConfig To display the access control configuration: switch:admin> snmpconfig --show accesscontrol SNMP access list configuration: Entry 0: Access host subnet area 2.3.4.
snmpConfig Auth Protocol: Priv Protocol: User 5 (ro): snmpuser2 Auth Protocol: Priv Protocol: User 6 (ro): admin Auth Protocol: Priv Protocol: noAuth noPriv noAuth noPriv noAuth noPriv SNMPv3 Trap/Informs configuration: Trap Entry 1: 1.2.3.
snmpConfig SNMPv3 trap/inform recipient configuration: Notify Type [TRAP(1)/INFORM(2)]:(1..2)[1] 2 Inform Recipient's IP address : [0.0.0.0] 10.70.12.115 UserIndex: (1..6) [1] Inform recipient Severity level : (0..5) [0] 5 Inform recipient Port : (0..65535) [162] Notify Type [TRAP(1)/INFORM(2)]:(1..2)[1] 2 Inform Recipient's IP address : [0.0.0.0] 1.2.3.4 UserIndex: (1..6) [2] Informs recipient Severity level : (0..5) [0] 2 Informs recipient Port : (0..65535) [162] Notify Type [TRAP(1)/INFORM(2)]:(1..
snmpTraps snmpTraps Sends or displays SNMP traps. Synopsis snmptraps --send [-trap_name trap_name] [-ip_address ip_address] snmptraps --show [port] snmptraps --block -port [slot]port | ALL snmptraps --unblock -port [slot]port | ALL snmptraps --help Description Use this command to manage specific Simple Network Management Protocol (SNMP) traps. Use the --send option to send a specific SNMP trap to a recipient indicated by its IP address.
snmpTraps --show [port] Displays all configured SNMP traps and MIBs. When used with the optional port argument, this command displays the ports that are blocked from receiving certain software traps. --help Displays the command usage. Examples To send all traps to the configured recipients: switch:admin> snmpTraps --send Number of traps sent : 27 To send a FRU history trap to recipient 172.16.0.12 switch:admin> snmptraps --send -trap_name \ fru-history-trap -ip_address 172.16.0.12.
snmpTraps Note: The Zone Mib parameters are for restricted usage only.
spinFab spinFab Runs functional test of interswitch link (ISL) cabling and trunk group operation. Synopsis Description spinfab [-nmegs count] [-framesize bytes] [-ports itemlist] [-setfail mode] [-fports flag] [-nframes number] [-pattern number/name] [-timeout length] Use this command to verify the intended functional operation of interswitch links (ISLs) at the maximum speed by setting up the routing hardware so that test frames received by each E_Port are retransmitted on the same E_Port.
spinFab Notes The following port types support the spinFab diagnostics.
spinFab The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. Operands This command has the following operands: -nmegs count Specifies the number of frames to send in millions. The test progresses until the specified number of frames has been transmitted on each port. The default value is 10 million frames.
spinFab -timeout length Defines a time limit (in seconds) for the running of spinfab. Spinfab will keep track of how long the test has run and stop testing once the timeout limit has been reached. The overall accuracy will be in the tens of seconds. Diagnostics When it detects failures, the test may report one or more of the following error messages. If errors persist, contact Technical Support.
sshUtil sshUtil Manages public key authentication.
sshUtil Description Use this command to enable and manage SSH public key authentication on a switch. SSH public key authentication provides a mechanism for authenticating an authorized user without a password. SSH public key authentication is more secure than password authentication and can be used to securely access services that require automatic login.
sshUtil importpubkey Imports a public key from a remote host to the local switch. The protocol used is SCP. This operation supports authentication for incoming connections. For this operation to succeed, a public/private key pair must be generated on the remote host prior to the import by issuing ssh-genkey -t dsa (a UNIX command). The command prompts for a user name for whom the public key is imported.
sshUtil genkey prompts for user input on the following parameters: passphrase Accepts a string of arbitrary length. This operand is optional, but creating a pass phrase is strongly recommended. A strong pass phrase is 10-30 characters long, fairly complex and difficult to guess. and contains a mix of upper and lowercase letters, numbers, and nonalphanumeric characters. There is no way to recover a lost pass phrase.
sshUtil To display the configured user: switch:admine> sshutil showuser username To set up SSH public key authentication on a switch for incoming connections: 1. Generate a private/public key pair on a remote host (accept default directory and file name): username@remotehost> ssh-keygen -t dsa Generating public/private dsa key pair. Enter file in which to save the key \ (/users/home/username/.
sshUtil To delete all imported public keys for a single user: switch:username> sshutil delpubkeys Enter user name for whom ssh public key is to deleted \ or all for all users:username WARNING: It deletes all the ssh public keys for 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 for outgoing connections: 1.
statsClear statsClear Clears port and diagnostic statistics. Synopsis Description Notes Operands statsclear [--slot slot] [-uports itemlist] [-bports itemlist] [-use_bports value] Use this command to clear the port and diagnostics statistics for the specified list of blade or user ports. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
stopPortTest stopPortTest Terminates the running portTest. Synopsis Description Notes Operands stopporttest [-ports itemlist] Use this command to terminate the portTest command. Refer to the portTest help page for more information. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
supportFfdc supportFfdc Modifies or displays the first-fault data capture (FFDC) daemon. Synopsis Description Notes Operands supportffdc [--disable | --enable | --show] Use this command to disable or enable the FFDC events, or to display the current configuration. If disabled, the daemon does not capture any data even when a message with FFDC attributes is logged. FFDC is enabled by default. When executed without operands, the command prints the usage.
supportFtp supportFtp Sets, clears, or displays support FTP parameters and enables or disables auto file transfer. Synopsis supportftp [-S] supportftp -s [-h host][-u username][-p password] [-d remotedirectory] [-l protocol] supportftp -t hours supportftp -R supportftp -e supportftp -d Description Use this command to set, clear, or display supportFtp parameters. The parameters set by this command are used by the supportSave and traceDump commands.
supportFtp -t hours Specifies the time interval, in units of hours, at which the server connectivity is checked. The fractional value for time interval is converted to the nearest lower integer value, for example, a value of 6.5 hours is truncated to 6 hours. -R Clears all supportFtp parameters. -e Enables auto file transfer. Trace dump files are automatically transferred to a designated FTP server. The server parameters must be set before you can enable auto file transfer. -d Disables auto file transfer.
supportInfoClear supportInfoClear Clears all the default port statistic counters and portlogs in a chassis or switch. Synopsis supportinfoclear --clear [ -RASlog] [-force] supportinfoclear --help Description Notes Operands Use this command to clear all the default port statistic counters, and portlogs in a chassis or switch. Use the -RASlog option to clear error logs along with statistics and portlogs on the active CP. On the standby CP, the -RASlog option clears only the error logs.
supportSave supportSave Saves RASLOG, TRACE, supportShow, core file, FFDC data, and other support information Synopsis supportsave supportsave [-n] [-c] [-k] [-a] [-u user_name -p password -h host_ip -d remote_dir -l protocol] supportsave [-R] supportsave [-U -d remote_dir] supportsave [-t timeout_multiplier] Description Use this command to collect RASLOG, TRACE, supportShow, core file, FFDC data and other support information to a remote FTP location.
supportSave -c Uses the FTP, SCP, or SFTP parameters saved by the supportFtp command. This operand is optional; if omitted, specify the FTP, SCP, or SFTP parameters through command line options or interactively. To display the current supportFTP parameters, run supportFtp (on a dual-CP system, run supportFtp on the active CP). The -c option is mutually exclusive with -u, -p, -h, and -d. -k Used to transfer the core and FFDC files. This operand can be specified with the -c and -c -n operands.
supportSave -t timeout_multiplier Extends predefined SupportSave timeout values by the value of the timeout multiplier. Use this option to repeat the supportSave operation when supportSave completion indicates that one or more modules timed out during the process. For example, -t 2 doubles the timeout values for each of the SupportSave modules. Valid multiplier values are 2 to 5. The default is 1.
supportSave files transferred after this command. OK to proceed? (yes, y, no, n): [no] y Saving support information Saving support information Saving support information Saving support information Saving support information No core or FFDC data files Saving support information Saving support information Saving support information Saving support information Saving support information (output truncated) for chassis:ras9,module:RAS... for chassis:ras9,module:TRACE_OLD... for chassis:ras9,module:TRACE_NEW...
supportShow supportShow Displays switch information for debugging purposes. Synopsis supportshow supportshow slot[/port1-port2] [lines] Description Use this command to display support information from groups of preselected Fabric OS and Linux commands and other support and debugging information. You can specify a port or a range of ports for which to display this information.
supportShow iswitch FC Router group commands, disabled by default. asic_db ASIC DB group commands, disabled by default. fcip FCIP group commands, disabled by default. ag Access Gateway group commands, disabled by default. dce_hsl DCE group commands, enabled by default. crypto Encryption group commands, disabled by default. Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
supportShow Fabric OS: Made on: Flash: BootProm: v6.4.0_main_bld09 Tue Dec 1 20:04:36 2009 Wed Dec 2 11:54:49 2009 1.0.
supportShowCfgDisable supportShowCfgDisable Disables a group of commands under the supportShow command. Synopsis Description supportshowcfgdisable os | exception | port | fabric | services | security | network | portlog | system | extend | filter | ficon | iswitch | asic_db | ag | dce_hsl | crypto | fcip Use this command to disable a group of commands under the supportShow command. Use the supportShowCfgEnable command to enable groups of commands.
supportShowCfgDisable iswitch Disables the FC Router group commands. asic_db Disables the ASIC DB group commands. ag Disables the Access Gateway group commands. dce_hsl Disables the DCE group commands. crypto Disables the encryption group commands fcip Disables the FCIP group commands. Supported only on the Brocade FX8-24.
supportShowCfgEnable supportShowCfgEnable Enables a group of commands to be displayed under the supportShow command. Synopsis Description supportshowcfgenable os | exception | port | fabric | services | security | network | portlog | system | extend | filter | ficon | iswitch | asic_db | ag | dce_hsl |crypto | fcip Use this command to enable a group of commands to be displayed under the supportShow command. Use the supportShowCfgDisable command to disable groups of commands.
supportShowCfgEnable iswitch Enables the FC Router group commands. asic_db Enables the ASIC DB group commands. ag Enables the Access Gateway group commands. dce_hsl Disables the DCE group commands crypto Enables the encryption group commands. fcip Enables the FCIP group commands. Supported only on the Brocade FX8-24 platform.
supportShowCfgShow supportShowCfgShow Displays the groups of commands enabled for display by the supportShow command. Synopsis Description supportshowcfgshow Use this command to display the groups of commands enabled for display by the supportShow command. Use the supportShowCfgEnable and the supportShowCfgDisable commands to modify which groups are displayed.
supportShowCfgShow iswitch asic_db fcip ag dce_hsl SEE ALSO enabled enabled enabled enabled enabled supportShow, supportShowCfgDisable, supportShowCfgEnable Brocade Fabric OS Command Reference 53-1004112-02 1067
switchBeacon switchBeacon Sets switch beaconing mode on or off. Synopsis Description switchbeacon [mode] Use this command to enable or disable switch beaconing mode. Switch beaconing can be used to locate a failing unit. When beaconing mode is turned on, the port LEDs flash amber, left to right and right to left, from port 0 to the highest port number and back to port 0. The beaconing mode continues until you turn it off. The beaconing LED pattern continues until you turn it off.
switchBeacon Examples To turn beaconing mode on and to verify the configuration: switch:admin> switchbeacon 1 switch:admin> switchbeacon value = 1 To turn beaconing mode off to verify the configuration:: switch:admin> switchbeacon 0 switch:admin> switchbeacon value = 0 SEE ALSO chassisBeacon, portBeacon, portPeerBeacon, switchShow Brocade Fabric OS Command Reference 53-1004112-02 1069
switchCfgPersistentDisable switchCfgPersistentDisable Disables a switch persistently. Synopsis switchcfgpersistentdisable switchcfgpersistentdisable --setdisablestate switchcfgpersistentdisable --disable switchcfgpersistentdisable --help Description Use this command to persistently disable the switch immediately or after reboot. All Fibre Channel ports are taken offline. If the switch was part of a fabric, the remaining switches reconfigure. The switch remains disabled even after a reboot.
switchCfgPersistentEnable switchCfgPersistentEnable Enables a switch persistently. Synopsis Description switchcfgpersistentenable Use this command to persistently 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 diagnostics.
switchCfgSpeed switchCfgSpeed Configures the speed for all ports on a switch. Synopsis Description switchcfgspeed speed Use this command to configure the port speed on a switch. This command sets the speed for all user ports. If any port on the switch is not capable of the specified speed setting, an error message is displayed for that port. The configuration is saved in nonvolatile memory and persists across switch reboots or power cycles.
switchCfgSpeed Examples To set the autosensing mode for all ports on a switch: switch:admin> switchcfgspeed 0 Committing configuration...done.
switchCfgTrunk switchCfgTrunk Enables or disables trunking on all the ports of a switch. Synopsis Description switchcfgtrunk mode Use this command to enable or disable trunking on all the ports of a switch. Use portCfgTrunkPort to enable or disable trunking on a single port. When the command is executed to update the trunking configuration, the ports to which the configuration applies are disabled and subsequently re-enabled with the new trunking configuration.
switchDisable switchDisable Disables all user ports on a switch. Synopsis Description switchdisable Use this command to 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 amber. The switch must be disabled before making configuration changes or before running offline diagnostic tests.
switchEnable switchEnable Enables all user ports on a switch. Synopsis Description switchenable Use this command 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 diagnostics. If the switch is connected to a fabric, it rejoins the fabric.
switchName switchName Displays or sets the switch name. Synopsis Description switchname [name] Use this command to display or set the switch name. Once you set the switchname, you must re-login for the change to be in effect. All switches have a symbolic name that is primarily used for switch management. This name is shown in the Fabric OS CLI prompt, under each switch icon in Web Tools, in all the switch event RASLog messages, and in the output of various Fabric OS Commands, such as fabricShow.
switchName To change the switch name to a name starting with a character (note that the dash (-) is converted to period (.) in the switch name because FMS mode is enabled): switch:admin> switchname brocade-174 Committing configuration... Done. Switch name has been changed.Please re-login into the switch for the change to be applied. 2015/11/30-13:13:43, [IPAD-1002], 191, FID 128, INFO, brocade-174, Switch name has been successfully changed to brocade-174. brocade-174:admin> Committing configuration...
switchShow switchShow Displays switch and port status. Synopsis switchshow switchshow [-slot slot] [-portname | -qsfp] switchshow [-portcount] Description Use this command to display switch, blade, and port status information. Output may vary depending on the switch model. When used without operands, switchShow displays the following information: switchName Switch name. switchType Switch model and revision numbers. switchState Switch state: Online, Offline, Testing, or Faulty.
switchShow Fabric Name The name assigned to the fabric. The fabric name is set with the fabricName command. HIF Mode Indicates HIF mode of the switch. Values are ON or OFF. The HIF mode can be set using the configure command. Allow XISL Use Allows the switch to use interswitch links (XILS) in the base fabric to carry traffic to this logical switch. Values are ON or OFF.
switchShow Speed The speed of the port.
switchShow No_Light The module is not receiving light. This state is not applicable to 16 Gbps-capable interchassis link (ICL) ports. No_SigDet No signal is detected on the port. For 16 Gbps-capable interchassis link (ICL) ports, this state replaces the No_Light indicator. It indicates that a quad small form-factor pluggable (QSFP) has been installed but is not connected with a cable. No_Sync The module is receiving light but is out of sync. In_Sync The module is receiving light and in sync.
switchShow comment Optionally displays one of the following: Copper or Optical Displays which GbE port is currently active: Copper indicates that the RJ45 GbE port is currently active. Only copper connections are accepted (default). Optical indicates that the currently active GbE port accepts both copper and optical connections (SFPs). This parameter is set by the portCfgGeMediaType command, and applies only to the ge0 and ge1 ports on the Brocade 7800. Disabled The port is disabled.
switchShow E_Port Fabric port; displays the world wide name (WWN) and name of the attached switch. If the port is configured as an EX_Port, the WWN of the attached switch is the same as the router. F_Port Point-to-point port; displays the WWN of the attached N_Port. If that specific F_Port receives 1 FDISK frame, switchShow displays the total number of NPIV Public ports as 1, for example: F_Port 1 NPort + 1 NPIV devices.
switchShow (downstream) The E_Port is a downstream path away from the principal switch of the fabric. FICON Persistent DID This port has been disabled, because the switch could not obtain its configuration domain ID during the fabric reconfiguration when fmsmode was enabled. See the ficonCupSet help page for more information. Fabric ID conflict Two different fabrics have been assigned the same fabric ID. Applicable only to EX_Ports and Logical Fabric environments.
switchShow (Type mismatch) D_Port configuration mismatch between local and remote switch. (D-port mode mismatch, Not D-port) The local port is configured as D_Port and remote port is not a D_Port. This segmentation reason is displayed for the local port. (D-port mode mismatch, Static D-port) The local port is configured as D_Port and remote port is not a D_Port. This segmentation reason is displayed for the remote port.
switchShow -portname Displays the name for each port on the switch. The port name is set by the portName command. -qsfp Displays the output of the switchShow command with a QSFP column added. If a QSFP is installed on the port, the QSFP number is displayed for the port. This number corresponds to the physical QSFP number that can be found on the front of each Core Blade. A double dash (--) indicates that QSFP is not supported on that blade. -portcount Displays the number of ports on the switch.
switchShow 22 23 24 25 26 27 28 29 30 31 32 22 -N8 No_Module FC 23 -N8 No_Module FC 24 -N8 No_Module FC 25 -N8 No_Module FC 26 -N8 No_Module FC 27 -N8 No_Module FC 28 -N8 No_Module FC 29 -N8 No_Module FC 30 -N8 No_Module FC 31 -N8 No_Module FC 32 id N8 Online FC 10:00:00:05:1e:43:e8:02 0x690100 33 33 -N8 No_Module FC 34 34 id N8 Online FC 10:00:00:05:1e:43:e8:02 0x690100 master is Port 32 )(AoQ) 35 35 -N8 No_Module FC 36 36 -N8 No_Module FC 37 37 -N8 No_Module FC 38 38 -N8 No_Module FC 39 39 -N8 No_Module
switchShow To display switch configuration information on the Brocade FCoE10-24: switch:admin> switchshow -slot 8 switchName: switch switchType: 77.3 switchState: Online switchMode: Native switchRole: Subordinate switchDomain: 2 switchId: fffc02 switchWwn: 10:00:00:05:1e:75:af:00 zoning: ON (longevity_cfg) switchBeacon: OFF FC Router: OFF Fabric Name: f1_2010_11_16_21_29_26__ Allow XISL Use: OFF LS Attributes: [FID: 128, Base Switch: \ No, Default Switch: Yes, Address Mode 0] Slot Blade Type ID Model Name
switchShow Slot Blade Type ID Status ------------------------------------------------5 COREBLADE 52 ENABLED Index Slot Port PortWWN Name ========================================================== 384 5 0 20:04:00:05:33:0e:df:00 MyName_portname0 385 5 1 20:04:00:05:33:0e:df:01 -----386 5 2 20:04:00:05:33:0e:df:02 ------ To display QSFP information on a Brocade DCX 8510-4: • • • Ports 3/60-63 indicate no QSFP is present. Slot 5 and 8 have QSFPs installed and the number is the group ID.
switchShow 405 406 407 408 409 410 5 5 5 5 5 5 E-Port 411 5 E-Port 412 5 E-Port 413 5 E-Port 414 5 415 5 1152 5 1153 5 1154 5 1155 5 1156 5 1157 5 1158 5 1159 5 1160 5 1161 5 1162 5 1163 5 1164 5 1165 5 1166 5 1167 5 1168 5 1169 5 1170 5 1171 5 1172 5 1173 5 1174 5 1175 5 1177 5 1178 5 1179 5 1180 5 1181 5 1182 5 1183 5 416 8 417 8 418 8 419 8 420 8 421 8 422 8 423 8 424 8 425 8 426 8 427 8 428 8 429 8 Brocade Fabric OS Command Reference 53-1004112-02 21 5 ------22 13 ------23 13 ------24 12 -----id 25
switchShow 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1092 8 14 14 ------8 15 14 ------8 16 13 ------8 17 13 ------8 18 5 ------8 19 5 ------8 20 5 ------8 21 5 ------8 22 13 ------8 23 13 ------8 24 12 -----id 8 25 12 -----id 8 26 4 -----id E-Port 10:00:00:05:1e:39:f0:ca 8 27 4 -----id E-Port 10:00:00:05:1e:39:f0:ca 8
switchShow To display media type information (relevant output excerpts only): • The following example shows switchshow output for the ge0 and ge1 ports on a Brocade 7800. The ge0 port is a copper port (default). The ge1 has an SFP installed (copper or optical): [...] ge0 cu ge1 id ge2 -ge3 -ge4 id ge5 -[...] • No_Sync No_Light No_Module No_Module Online No_Module FCIP FCIP FCIP FCIP FCIP FCIP Copper This example shows switchshow output for a Brocade 5100. Port 31 has an SFP installed.
switchShow 7 8 9 7 010700 id N8 No_Light FC Disabled (Persistent) 8 010800 -N8 No_Module FC Disabled (Persistent) 9 010900 id N4 Online FC E-Port \ 10:00:00:05:1e:a3:00:59 segmented,(RA TOV incompat) 10 10 010a00 id N8 No_Light FC Disabled (Persistent) To display the output when any of the ICL links get disabled with no Enterprise ICL (EICL) license installed: • If no EICL license is installed and the number of ICL-connected chassis in the fabric is more than 4, the port disable reason code displayed i
switchShow To display the port status information on 16 Gbps-capable Inter-Chassis Links (ICLs): switch:admin> switchshow switchName: ICL_DCX switchType: 120.
switchShow Fabric Name: Location ID: base 1 Index Port Address Media Speed State Proto ============================================== SEE ALSO 1096 fabricName, portCfgLongDistance, switchDisable, switchEnable, switchName Brocade Fabric OS Command Reference 53-1004112-02
switchUptime switchUptime Displays the amount of time the switch has been operating. Synopsis Description Notes switchuptime Use this command to display the current time and the amount of time that the switch has been operational. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
switchViolation switchViolation Dumps the DCC violations for a switch. Synopsis Description Notes switchViolation --dump -dcc Use this command to display all Device Connection Control (DCC) violations that have occurred on a switch. Internally the command searches "errdumpall" for the DCC violations. For each DCC violation, the command displays the device WWN and the port where the violation occurred. The execution of this command is subject to Virtual Fabric restrictions that may be in place.
syslogAdmin syslogAdmin Configures a syslog server host.
syslogAdmin 2 LOG_LOCAL2 3 LOG_LOCAL3 4 LOG_LOCAL4 5 LOG_LOCAL5 6 LOG_LOCAL6 7 LOG_LOCAL7 (default) --remove -ip ip_address | hostname Removes the specified syslog server. IPv4 and IPv6 addresses are supported. --show Displays the list of configured syslog servers and the facility level. -ip Displays all syslog server IP addresses and hostnames. -facility Display the configured syslog facility. --help Displays the command usage.
syslogAdmin To remove the IP address fec0:60:69bc:92:218:8bff:fe40:15c4 from the list of servers to which error log messages are sent: switch:admin> syslogadmin --remove -ip fec0:60:69bc:92:218:8bff:fe40:15c4 SEE ALSO None Brocade Fabric OS Command Reference 53-1004112-02 1101
sysShutDown sysShutDown Provides a graceful shutdown to protect the switch file systems. Synopsis Description sysshutdown On standalone platforms, use this command to shut down the switch operating system. On enterprise-class platforms, when sysShutDown is called on the active control processor (CP), the command shuts down the active CP, standby CP, and any AP blades.
sysShutDown Shutting down OCP at:0.0.0.0 Broadcast message from root (pts/0) Wed Nov 5 19:03:06 2008...
tempShow tempShow Displays temperature readings. Synopsis Description Notes tempshow [-details] Use this command to display the current temperature readings of all temperature sensors in a switch. For each sensor, this command displays the sensor ID (an index number), the slot number (if applicable), the sensor index (when issued with the --detail option), the sensor state (OK or absent), and the temperature. The temperature readings are given in both Centigrade and Fahrenheit.
tempShow 6 7 8 9 10 SEE ALSO |2 |4 |4 |4 |4 |0 |0 |1 |2 |3 |Absent |Ok |Ok |Ok |Ok |0 |33 |42 |42 |44 |0 |91 |107 |107 |111 | | | | | fanShow, psShow, sensorShow, slotShow Brocade Fabric OS Command Reference 53-1004112-02 1105
timeOut timeOut Sets or displays the idle timeout value for a login session. Synopsis Description timeout [timeval] Use this command without an operand to display the current timeout value (in minutes) after which idle logins are automatically terminated. Use this command with the timeval operand to set the login timeout value to the specified interval. A value of 0 disables timeout of login sessions. The new timeout value takes effect with the next logins.
topologyShow topologyShow Displays the unicast fabric topology. Synopsis topologyshow -index [domain] topologyshow -nopage [domain] topologyshow --help Description Use this command to display the fabric topology as it appears to the local switch. The display varies depending on the hardware configuration. The following rules apply: • On all switches, the command displays the number of domains in the fabric and the local Domain IDs.
topologyShow Out Port The port to which incoming frames are forwarded to reach the destination domain. In Ports The input ports that use the corresponding out port to reach the destination domain. This is the same information provided by portRouteShow and uRouteShow but in a different format. Total Bandwidth The maximum bandwidth of the out port. A bandwidth that is less than 0.512 Gbps is adjusted to the nearest power of 2 value. A bandwidth in the range of 0.
topologyShow Total Bandwidth: Bandwidth Demand: Flags: Domain: Metric: Name: Path Count: 2 1000 fcr_fd_2 1 Hops: Out Port: In Ports: Total Bandwidth: Bandwidth Demand: Flags: Domain: 3 Metric: 10500 Name: fcr_xd_3_5 Path Count: 1 Hops: Out Port: In Ports: Total Bandwidth: Bandwidth Demand: Flags: Domain: Metric: Name: Path Count: 8.000 Gbps 1275 % D 2 15 0 1 2 3 4 5 6 7 8 9 11 2.000 Gbps 4000 % D 2 11 0 1 2 3 4 5 6 7 8 9 15 8.
topologyShow Flags: Domain: Metric: Name: Path Count: D 3 10500 fcr_xd_3_6 1 Hops: Out Port: In Ports: Total Bandwidth: Bandwidth Demand: Flags: 2 0 23 24 33 38 39 8.000 Gbps 350 % D To display the topology with index numbers: switch:user> topologyshow -index 1 domain(s) in the fabric; Local Domain ID: 188 Domain: Metric: Name: Path Count: 178 500 dcx_178 1 Hops: Out Port (index): In Ports (index): Total Bandwidth: Bandwidth Demand: Flags: SEE ALSO 1110 1 112 246 247 24.
traceDump traceDump Initiates, or removes a trace dump or displays the trace dump status. Synopsis tracedump [-S] tracedump -n [-s slot] tracedump -r [-s slot] | -R tracedump -c Description Use this command to initiate a background trace dump, to remove the content of a trace dump, or to display the dump status on the switch. When executed without operands, this command defaults to traceDump -S. Execution of traceDump -n generates a local trace dump locally.
traceDump Notes Operands The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. This command has the following mutually exclusive operands: -S Displays the trace dump status This operand is optional. If omitted, the same status information is displayed. -n Initiates a background trace dump. -r Clears the status of a particular trace dump on a specified slot.
traceDump To clear the status of a trace dump: switch:admin> tracedump -R trace dump removed To clear the content of the trace dump buffer: switch:admin> tracedump -c Cleared Trace Buffer contents SEE ALSO supportFtp, supportSave, supportShow Brocade Fabric OS Command Reference 53-1004112-02 1113
trunkDebug trunkDebug Debugs a trunk link failure. Synopsis Description trunkdebug port1 port2 Use this command to debug a trunk link failure.
trunkShow trunkShow Displays trunking information. Synopsis Description trunkshow [-perf] [-swname] Use this command to display trunking information of both E_Ports and EX_Ports. The command displays the following fields: Trunking Group Number Displays each trunking group on a switch. All ports that are part of this trunking group are displayed. Port to port connections Displays the port-to-port trunking connections. WWN Displays the world wide name of the connected port.
trunkShow % Displays the percentage of link utilization (Rx, Tx, and the combined total for Tx+Rx) . Even when the link utilization is 100% , the throughput value will be lesser than the bandwidth value, due to the 8b/10b encoding and the control words transmitted. For example, the throughput for an 8Gbps link at 100% utilization would be approximately 6.8Gbps. Notes Operands The execution of this command is subject to Virtual Fabric restrictions that may be in place.
trunkShow switch:admin> switchshow 48 4 0 013000 id N4 Online EX-Port \ (Trunk port, master is Slot 4 Port 1 ) 49 4 1 013100 id N4 Online EX-Port \ 10:00:00:05:1e:35:b3:03 "SW4100_33" (fabric id = 100 )\ (Trunk master) E-Port \ 50:00:51:e3:70:bb:af:c1 "fcr_xd_9_100" 50 4 2 013200 id N4 Online EX-Port \ (Trunk port, master is Slot 4 Port 1 ) 51 4 3 013300 id N4 Online EX-Port \ (Trunk port, master is Slot 4 Port 1 ) 52 4 4 013400 id N4 Online EX-Port \ (Trunk port, master is Slot 4 Port 1 ) 53 4 5 013500 id
trunkShow To display trunking information along with switch name: switch:admin> trunkshow -swname 1: 0-> 10 10:00:00:05:1e:a1:99:09 2: 2-> 11 10:00:00:05:1e:a1:eb:39 MASTER 88 SW_88 deskew 15 MASTER 75 switchname01234567890123456789 deskew 15 To display trunking information, with switch name and bandwidth throughput information: switch:admin> trunkshow -pref -swname 1: 0-> 10 10:00:00:05:1e:a1:99:09 88 SW_88 deskew 15 MASTER Tx: Bandwidth 4.00Gbps, Throughput 0.00bps (0.00%) Rx: Bandwidth 4.
tsClockServer tsClockServer Displays or sets the Network Time Protocol (NTP) Server addresses. Synopsis Description tsclockserver [ipaddr [; ipaddr ...]] Use this command to synchronize the local time of the Principal or Primary FCS switch to one or more external NTP servers. This command accepts a list of NTP server addresses. The NTP server addresses can be passed in either IPV4 or IPV6 address format or as a DNS server name.
tsClockServer To set the NTP server to a specified IP address: switch:admin> tsclockserver 123.123.123.123 Updating Clock Server configuration...done. switch:admin> tsclockserver 123.123.123.123 To configure multiple NTP servers: switch:admin> tsclockserver "12.134.125.24; 12.234.87.01" Updating Clock Server configuration...done.
tsTimeZone tsTimeZone Displays or sets the system time zone. Synopsis tstimezone --interactive tstimezone timezonename tstimezone --old hourOffset[,minuteOffset] Description Use this command to display or set the system time zone. All switches maintain the current time zone setup in nonvolatile memory. Changing the time zone on a switch updates the local time zone setup and is reflected in local time calculations. All switches are by default in the 0,0 time zone:, which is, GMT.
tsTimeZone Operands This command has the following operands: --old Specifies the time zone in the offset format. hourOffset Specifies the number of hours relative to GMT. This operand must be specified as an integer. Valid values are -12 to 12. This operand is required with the --old option. minuteOffset Specifies the number of minutes relative to hour offset. This operand must be specified as an integer and is valid only with the --old option. Valid values are -30, 0, or 30.
tsTimeZone 6) Barbados 33) Montserrat 7) Belize 34) Nicaragua 8) Bolivia 35) Panama 9) Bonaire Sint Eustatius & Saba 36) Paraguay 10) Brazil 37) Peru 11) Canada 38) Puerto Rico 12) Cayman Islands 39) Sint Maarten 13) Chile 40) St Barthelemy 14) Colombia 41) St Kitts & Nevis 15) Costa Rica 42) St Lucia 16) Cuba 43) St Martin (French part) 17) Curacao 44) St Pierre & Miquelon 18) Dominica 45) St Vincent 19) Dominican Republic 46) Suriname 20) Ecuador 47) Trinidad & Tobago 21) El Salvador 48) Turks & Caicos I
tsTimeZone United States Mountain Time Therefore TZ='America/Denver' will be used. Local time is now: Tue Nov 6 02:43:16 MST 2012. Universal Time is now: Tue Nov 6 09:43:16 UTC 2012.
turboRamTest turboRamTest Performs a turbo SRAM test of ASIC chips. Synopsis Description Notes turboramtest [--slot slot] [-passcnt count] Use this command to verify the chip SRAM located in the ASIC using the turbo-RAM BIST circuitry. The BIST controller is able to perform the SRAM write and read operation at a much faster rate than the PCI operation. Do not abort this test prematurely, using CTRL-C or q to quit. Doing so may cause the test to report unexpected errors.
turboRamTest Reset the blade or the switch to recover. Running Condor3 turboramtest on slot 0 Condor 0 Condor3 turboramtest on slot 0 condor 0 PASSED PASSED.
upTime upTime Displays length of time the system has been operational. Synopsis Description uptime This command displays the current time, how long the system has been running, how many users are currently logged on, and the system load averages for the past 1, 5, and 15 minutes. If the uptime is less than 60 seconds, the time is displayed in seconds. For times greater than or equal to 60 seconds, the time is displayed in minutes. The output format adjusts accordingly.
uRouteShow uRouteShow Displays unicast routing information. Synopsis Description urouteshow [slot/][port] [domain] Use this command to display the unicast routing information for a port, as it is known by the FSPF path selection and routing task. The routing information describes how a frame that is received from a port on the local switch is to be routed to reach a destination switch. The following information displays: Local Domain ID Domain number of local switch.
uRouteShow Notes Operands The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details. This command has the following operands: slot For bladed systems only, specify the slot number of the input port whose routes are displayed, followed by a slash (/). port Specify the number of the input port whose routes are to be displayed, relative to its slot for bladed systems.
usbStorage usbStorage Manages data files on an attached USB storage device. Synopsis usbstorage [-e | --enable] usbstorage [-d | --disable] usbstorage [-l | --list] usbstorage [-r | --remove area target] usbstorage [-h | --help] Description Notes Use this command to control a USB device attached to the Active CP.
usbStorage To list the contents of the attached USB device: switch:admin> usbstorage -l firmwarekey\ 0B 2010 Aug support\ 106MB 2010 Aug support1034\ 105MB 2010 Aug config\ 0B 2010 Aug firmware\ 380MB 2010 Aug FW_v6.4.0\ 380MB 2010 Aug Available space on usbstorage 15 15:13 24 05:36 23 06:11 15 15:13 15 15:13 15 15:13 74% To remove a firmware target from the firmware application area: switch:admin> usbstorage -r firmware FW_v6.0.
userConfig userConfig Manages user accounts.
userConfig Notes The userConfig command operates on the switch-local user database only, regardless of whether the switch is configured to use RADIUS or LDAP authentication. The account database supports a maximum of 256 customer created accounts. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
userConfig --add | --change Creates a new user account or modifies an existing user account. The following restrictions apply when you create or modify a user account: • You cannot change the role, the Logical Fabric permissions, the home Logical Fabric of any default account. • You cannot change the role, the Logical Fabric permissions, or the description of accounts at the same or a higher authorization level.
userConfig -l LF_ID_list Specifies the Virtual Fabrics the user is authorized to access. The Logical Fabrics in LF_ID_list and the existing Logical Fabric permissions for username must be a subset of the Logical Fabric permissions of the account that executes this command. This operand is required with the --add option. It is optional with the --change option. -c chassis_role Specifies the account's access permissions at the chassis level.
userConfig --addlf | --deletelf Adds Logical Fabric or chassis permissions to a user account or deletes Logical Fabric or chassis permission from a user account. The following operands are supported: username Specifies the account login name. -h LF_ID Specifies the account's home Logical Fabric. This operand is optional. • If a home Logical Fabric is specified with the --addlf option, the home Logical Fabric must be one of the Logical Fabrics in LF_ID_list.
userConfig Examples To create a new account named "test" with admin role and admin chassis permissions in the Logical Fabric member list 1-10: switch:admin> userconfig --add test -l 1-10 \ -r admin -c admin Setting initial password for test Enter new password: Re-type new password: Account test has been successfully added.
userConfig To remove chassis permissions from the test account for the Logical Fabrics 1-3. switch:admin> userconfig --deletelf test -l 1-3 -c Broadcast message from root (ttyS0) Sat \ Jun 14 01:10:02 2008... Security Policy, Password or Account Attribute Change: \ test will be logged out LFs/chassis role for account test has been successfully\ deleted.
version version Displays firmware version information. Synopsis Description version Use this command to display firmware version information and build dates. The command output includes the following: Kernel The version of switch kernel operating system. Fabric OS The version of switch Fabric OS. Made on The build date of firmware running in switch. Flash The build date of firmware stored in flash proms.
wwn wwn Displays the world wide name (WWN) and factory serial number of the switch or chassis. Synopsis Description wwn [-sn] Use this command to display the WWN associated with a switch or chassis and to display the factory serial number. The WWN is a 64-bit number that has eight colon-separated fields each consisting of one or two hexadecimal digits between 0 and ff. The WWN is a factory-set parameter that cannot be changed by the end user.
wwn To display the WWN and the Fibre Channel address: switch:admin> fabricshow Switch ID Worldwide Name Enet IP Addr FC IP Addr Name -----------------------------------------------------------1:fffc01 10:00:00:05:1e:7a:7a:00 10.32.39.25 0.0.0.0 "sw03" 2:fffc02 10:00:00:05:1e:b3:00:9e 10.32.39.34 0.0.0.0 "ras39" 3:fffc03 10:00:00:05:1e:93:c4:00 10.32.39.20 0.0.0.0 "sw5" 4:fffc04 10:00:00:05:1e:55:5c:69 10.32.39.59 0.0.0.
wwnAddress wwnAddress Binds an FC Port ID to a device WWN. Synopsis wwnaddress --bind [WWN] [PID] wwnaddress --unbind [WWN] wwnaddress --show wwnaddress --findPID [WWN] wwnaddress --help Description Use this command to manage address assignments for a given device world wide name. The allocation of a PID to a specified device WWN supports the persistence of the PID based on the WWN of the device to which the PID is bound.
wwnAddress --unbind Removes the WWN-PID binding corresponding to the specified device WWN. WWN Specifies the WWN for the device from which to remove the PID binding. --show Displays all WWN-PID entries currently present in the partition. --findPID Displays the PID currently bound to the specified device WWN. WWN Specifies the device WWN. --help Displays the command usage. Examples To bind a 16-bit address to a device WWN: switch:admin> wwnaddress --bind \ 10:00:00:06:2b:0f:76:5f 0x9000 To unbind a given
wwnAddress To display the WWW address binding for device 20:22:00:05:1e:0b:61:cc: switch:admin> wwnaddress --findPid 20:22:00:05:1e:0b:61:cc WWN PID ============================= 20:22:00:05:1e:0b:61:cc 0x300 SEE ALSO 1144 portAddress Brocade Fabric OS Command Reference 53-1004112-02
wwnRecover wwnRecover Utility to recover mismatch of data in WWN card. Errors may be due to corruption, defect, or other causes. Synopsis Description wwnrecover Use this command to recover one or both WWN cards from errors detected by the audit routine. The audit routine is triggered upon first boot up of the system, periodically every 24 hours thereafter, and upon detection of insertion of either of the WWN card.
wwnRecover To perform WWN recovery (the following example shows the WWN errors and the recovery process): switch:admin> wwnrecover WWN Discrepancies (Error:64) detected. Please attempt recovery of these errors (where possible) by navigating to the required recovery selection from the following WWN Recovery Options Menu. Please note that in the event of a mismatch in the LicenseIds, between WWN1 and WWN2 cards, wwn recovery may not be possible.
zone zone Performs specific zone operations, manages Traffic Isolation (TI) Zones, and Frame Redirect (RD) Zones.
zone TI zones over FCR provide the ability to lock down a request and corresponding response to the same VE_Port tunnel for a given pair of devices in two separate fabrics. TI over FCR has two working parts: • • TI within edge fabric routes traffic between a real device and a Proxy device to a specified EX_Port. TI within backbone fabric locks down the route within the backbone fabric based on EX_Ports and devices involved.
zone Notes Device ports are allowed to be part of several TI zones to support enhanced TI zone deployment in FICON environments. You cannot swap E_Ports that are configured as part of a TI zone. The TI zone information is lost when you use portSwap to swap the E_Ports. To work around this issue, reconfigure your TI zones rather than swapping the E_Ports. The current zone commands, zoneCreate, aliCreate, cfgCreate, etc., cannot be used to manage special zones, such as TI zones or RD zones.
zone If a zone member is specified by Domain and Port (D,P) in the Admin Domain membership list, all zone elements specified with WWNs associated with that D,P are considered for zone enforcement. If a device WWN is specified in the Admin Domain member list, the corresponding D,P (the device the specified WWN is associated with) is not considered for zone enforcement. The following operands are optional: -f Specifies that zone members that are not enforceable should be expunged in the transaction buffer.
zone The following operands are supported: -t objecttype Specifies the zone object type. This operand is supported only with the --create option. To create a TI zone, the value is ti. -o optlist Specifies list of options to control activation, deactivation, and failover mode. If this option is not specified the zone is created, by default, with failover enabled, and the zone will be activated. This operand is supported only with the --create and --add options.
zone --delete name Deletes TI zones from the defined TI zone lists. This command prompts for confirmation. --show [name] Displays zone name, port lists, failover option, configured status and, the active status for the specified zones. The configured status reflects the latest change that may or may not have been activated. The active status reflects the state that is activated by cfgEnable. Without any specified name, this command displays all TI zones in the defined configuration.
zone Examples 1. Specific zone operation commands The following example shows a scenario of an invalid configuration. If you attempt to create a zone z10 with an alias a10, then create a zone with name a10, z10 expects a10 to be an alias and results in an invalid configuration.
zone To validate all zones in the zone database in the persistent storage (defined configuration): switch:admin> zone --validate -m 1 Defined configuration: cfg: t_r_a_f_f_i_c_i_s_o_c__fg bluezone; greenzone cfg: ticonfig regzone zone: bluezone 1,1*; 1,2* zone: greenzone 1,1*; 20:01:00:05:1e:01:23:e0* zone: regzone 1,4*; 1,5* zone: t_r_a_f_f_i_c_i_s_o_prop__zn 1,3*; 2,3* -----------------------------------~ - Invalid configuration * - Member does not exist # - Invalid usage of broadcast zone To validate a
zone 2. Traffic isolation zone commands To create an activated traffic isolation zone with failover enabled (default). switch:admin> zone --create -t ti purplezone \ -p "1,1; 2,4; 1,8; 2,6" To create a deactivated traffic isolation zone with failover disabled:. switch:admin> zone --create -t ti -o dn purplezone \ -p "1,1; 2,4; 1,8; 2,6" To add an E_Port and N_Port member as a portlist to an existing TI zone: switch:admin> zone --add purplezone \ -p "3,4; 3,6" To add the option to disable failover for a
zone To display all TI zones in the defined configuration in ascending order: switch:admin> zone --show -ascending Defined TI zone configuration: TI Zone Name: ti_blue Port List: 10:00:00:00:00:01:00:01; \ 10:00:00:00:00:01:00:04; 3,9; 4,55 Configured Status: Activated / Failover-Disabled Enabled Status: Deactivated TI Zone Name: Port List: ti_red 3,3; 4,4; 5,5 Configured Status: Activated / Failover-Enabled Enabled Status: Activated / Failover-Enabled To display a specified zone in the defined configur
zone To create an FCR TI zone within an Edge fabric where a host should talk to target1 and target4 through port number 2 on an Edge fabric switch with a domain ID of 3. (in the example, "3,1" is the host, and the remaining members are E_Ports): switch:admin> zone --create -t ti fcr_edge_ti_zone \ -p "3,1; 3,2; 4,-1; 5, -1" To create an FCR TI zone within a Backbone where a host, target1, and target4 communicate over VE_Ports consisting of FCR1 port number 4 and FCR2 port number 7: switch:admin> zone --cr
zone 3. Frame redirect zone commands To create an RD Zone, given a host (10:10:10:10:10:10:10:10), target (20:20:20:20:20:20:20:20), VI (30:30:30:30:30:30:30:30), and VT (40:40:40:40:40:40:40:40): switch:admin> zone --rdcreate \ 10:10:10:10:10:10:10:10 20:20:20:20:20:20:20:20 \ 30:30:30:30:30:30:30:30 40:40:40:40:40:40:40:40 \ restartable noFCR This command creates the following zone objects: • RD zone "red_0917_10_10_10_10_10_10_\ 10_10_20_20_20_20_20_20_20_20", with a restricted policy and no FCR supp
zoneAdd zoneAdd Adds a member to the zone or Peer Zone. Synopsis zoneadd "zoneName", "member[;member...]" zoneadd --peerzone "zoneName" -principal "principal[;principal...]" -members "member[;member...]" Description Use this command to add one or more members to an existing zone or Peer Zone. This command changes the defined configuration. For the change to be preserved across switch reboots, save the configuration to nonvolatile memory with the cfgSave command.
zoneAdd Examples To add aliases for three disk arrays to "Blue_zone": switch:admin> zoneadd "Blue_Zone", "array3; array4; array5" To add aliases for all the arrays that matches a pattern: switch:admin> zoneadd matt, "ze*;bond*; j*" switch:admin> cfgshow Defined configuration: zone: matt 30:06:00:07:1e:a2:10:20; 3,2; zeus; \ bond; jake; jeff; jones zone: sloth bawn; bolt; bond; brain; brit; bru; \ 10:00:00:00:01:1e:20:20 alias: bawn 3,5; 4,8 alias: bolt 10:00:00:02:1f:02:00:01 alias: bond 10:00:05:1e:a9:2
zoneCreate zoneCreate Creates a zone or a Peer Zone. Synopsis zonecreate "zonename", "member[;member...]" zonecreate --peerzone "zonename" -principal "principal[;principal...]" [-members "member[;member...]"] Description Use this command to create a new zone or a Peer Zone, or to create a "broadcast" zone. A broadcast zone is a special zone that specifies the nodes that can receive broadcast traffic. This zone must be named "broadcast". Only one "broadcast" zone can exist within a fabric.
zoneCreate A member can be specified in one or more of the following ways: • • • • Domain and port index pair: Specify a port by domain and port index, for example, "2, 20" specifies port index 20 on switch domain 2. When a zone member is specified by port index, all devices connected to that port are in the zone. If this port is an arbitrated loop, then all devices on the loop are in the zone. Use switchShow for a list of valid port index numbers.
zoneCreate alias: bru 5,3; 12,4 alias: geek 2,7; 4,11; 20:10:00:05:1e:a9:20:87 alias: jake 4,7; 8,9; 14,11 alias: jeff 30:00:00:05:1e:a1:cd:02; \ 40:00:00:05:1e:a1:cd:04 alias: jones 7,3; 4,5 alias: zeus 4,7; 6,8; 9,2 To create Peer Zones: switch:admin> zonecreate --peerzone peerzone_wwn_mbrs \ -principal "10:00:00:00:01:1e:20:20" -members "10:00:00:02:1f:02:00:01;10:00:05:1e:a9:20:00:01" switch:admin> zonecreate --peerzone peerzone_di_mbrs -principal "10,1" -members "20,1;20,2" SEE ALSO zoneAdd, zoneDe
zoneDelete zoneDelete Deletes a zone or Peer Zone. Synopsis Description zonedelete "zonename" Use this command to delete a zone or Peer Zone. This command changes the defined configuration. For the change to be preserved across switch reboots, save the configuration to nonvolatile memory using the cfgSave command. For the change to become effective, enable the configuration with the cfgEnable command. Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place.
zoneHelp zoneHelp Displays a description of zoning commands. Synopsis Description Notes zonehelp Use this command to display short descriptions of zoning commands. The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric OS Commands" and "Command Availability" for details.
zoneObjectCopy zoneObjectCopy Copies a zone object. Synopsis Description zoneObjectCopy "objectName", "newName" Use this command to make a copy of an existing zone object and give it a new name. The resulting object is of the same type as the original object. You can use this command for all zone object types, including cfg, zone, and alias. Target Driven Peer Zones are not allowed to be edited using this command. This command changes the defined configuration.
zoneObjectExpunge zoneObjectExpunge Expunges a zone object. Synopsis Description zoneObjectExpunge "objectName" Use this command to expunge a zone object. In addition to deleting the object, this command also removes the object from the member lists of all other objects. After successful execution of this command, the specified object no longer exists the database. You can use this command for all zone object types, including cfg, zone, and alias.
zoneObjectExpunge alias: array1 alias: array2 alias: loop1 SEE ALSO 1168 21:00:00:20:37:0c:76:8c; \ 21:00:00:20:37:0c:71:02 21:00:00:20:37:0c:76:22; \ 21:00:00:20:37:0c:76:28 21:00:00:20:37:0c:76:85; \ 21:00:00:20:37:0c:71:df cfgAdd, cfgClear, cfgDelete, cfgDisable, cfgEnable, cfgRemove, cfgSave, cfgShow, zoneObjectCopy, zoneObjectRename Brocade Fabric OS Command Reference 53-1004112-02
zoneObjectRename zoneObjectRename Renames a zone object. Synopsis Description zoneObjectRename "objectName", "newName" Use this command to rename a zone object. You can use this command for all zone object types, including cfg, zone, and alias. Target Driven Peer Zones are not allowed to be edited using this command. This command changes the defined configuration. For the change to be preserved across switch reboots, save the configuration to nonvolatile memory with the cfgSave command.
zoneObjectReplace zoneObjectReplace Replaces zone members. Synopsis zoneobjectreplace oldmember newmember zoneobjectreplace --help Description Use this command to replace the existing member of a zone or a Peer Zone with a new member. This command can be used to replace members of an alias, but an alias itself cannot be replaced. This command is not applicable for Traffic Isolation (TI) Zones, and Frame Redirect (RD) Zones. The property member of a Peer Zone cannot be replaced using this command.
zoneObjectReplace alias: zali_1 10:00:00:05:1e:a1:ef:b9; 2,3; 1,11 Effective configuration: cfg: cfg zone: lsan_m 20:15:00:05:1e:a2:f9:b1 20:13:00:05:1e:a2:f9:b1 SEE ALSO zoneAdd, zoneCreate, zoneDelete, zoneRemove, zoneShow Brocade Fabric OS Command Reference 53-1004112-02 1171
zoneRemove zoneRemove Removes a member and principal (Peer Zone) from a zone. Synopsis zoneremove "zonename", "member[;member...]" zoneremove --peerzone "zonename" -principal "principal[;principal...]" -members "member[;member...]" Description Use this command to remove one or more members from an existing zone, and to remove one or more members or principal members from a Peer Zone. If all members are removed, the zone is deleted.
zoneRemove -principal "principal" Specify a principal or list of principal members to be removed from a Peer Zone. The list must be enclosed in double quotation marks. Principal members must be separated by semicolons. You can specify either a WWN or D, I; zone alias is not a valid principal member. -members "member" Specify a member or list of members to be removed from a Peer Zone. You can specify either a WWN or D, I; zone alias is not a valid member.
zoneShow zoneShow Displays zone information. Synopsis zoneshow [--sort] [pattern][, mode] zoneshow [--ic] [pattern][, mode] zoneshow [--alias] [-ic] [pattern] zoneshow [--transdiffs] zoneshow [--transdiffsonly] zoneshow [--validate [pattern] [,mode] zoneshow [--peerzone [all | user | target]] zoneshow --help Description Use this command to display zone configuration information. This command includes sorting and search options to customize the output.
zoneShow • • • A question mark (?) to match any single character. An asterisk (*) to match any string of characters. A range of characters to match any character within the range: for example, [0-9] or [a-f]. mode Specify 0 to display the contents of the transaction buffer (the contents of the current transaction), or specify 1 to display the contents of the nonvolatile memory. The default value is 0. This operand is optional. --alias Displays all the zones containing the given alias pattern.
zoneShow target Displays configuration information for the target created Peer Zones. --help Displays the command usage.
zoneShow To display all green zones using pattern search, regardless of the case: switch:admin> zoneshow --ic GREEN* zone: GREEN 44,4; 21:00:00:20:37:0c:71:02; 8,9 zone: green 2,2; 2,3; 21:00:00:20:37:0c:76:8c To display the zone members of alias "ali10": switch:admin> zoneshow --alias ali10 zone: zone20 ali10 To display the zone members of aliases beginning with "ali1": switch:admin> zoneshow --alias ali1* zone: zone1 1,2; ali12; 3,3; 30:04:00:05:1e:0b:55:0f; 30:05:00:05:1e:0b:55:0f zone: zone 15 9,8; 2
zoneShow 20:1d:00:05:1e:57:b1:c6 zone10 20:1e:00:05:1e:57:b1:c6 20:1f:00:05:1e:57:b1:c6* zone: zone2 20:03:00:05:1e:57:b1:c6 20:1f:00:05:1e:57:b1:c6* -----------------------------------~ - Invalid configuration * - Member does not exist # - Invalid usage of broadcast zone zone: To display validated output for a zone: switch:admin> zoneshow --validate zone1 Defined configuration: zone: zone1 20:1c:00:05:1e:57:b1:c6*; 20:1d:00:05:1e:57:b1:c6 Effective configuration: zone: zone1 20:1c:00:05:1e:57:b1:c6* 20:1
zoneShow To display the complete Peer Zoning configuration: switch:admin> zoneshow --peerzone all Defined configuration: zone: peerzone_di_mbrs Property Member: 00:02:00:00:00:02:00:01 Created by: User Principal Member(s): 10,1 Peer Member(s): 20,1; 20,2 zone: peerzone_wwn_mbrs Property Member: 00:02:00:00:00:03:00:01 Created by: User Principal Member(s): 10:00:00:00:01:1e:20:20 Peer Member(s): 10:00:00:02:1f:02:00:01; \ 10:00:05:1e:a9:20:00:01 Effective configuration: zone: peerzone_wwn_mbrs Property Memb
zoneShow 1180 Brocade Fabric OS Command Reference 53-1004112-02
Primary FCS Commands Primary FCS commands Table 4 summarizes the commands that are available only on the primary Fabric Configuration Server (FCS) when FCS policy is enabled. TABLE 4 Primary FCS commands Command Description aliAdd Must be run from the primary FCS switch. aliCreate Must be run from the primary FCS switch. aliDelete Must be run from the primary FCS switch. aliRemove Must be run from the primary FCS switch. aliShow Can be run on all FCS switches.
Primary FCS commands TABLE 4 Primary FCS commands (Continued) Command Description secPolicyFCSMove Must be run from the primary FCS switch. secPolicyRemove Must be run from the primary FCS switch. secPolicySave Must be run from the primary FCS switch. secPolicyShow Can be run on all FCS switches. snmpConfig Can be run on all FCS switches. tsClockServer Can be run on all switches to view the NTP server's IP address. You can only modify the NTP server's IP address on the primary FCS switch.
Command Availability • • Command validation checks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1183 Command Virtual Fabrics and Remote Domain execution restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1184 Command validation checks Before a command is executed, it is validated against the following checks. 1.
Command Virtual Fabrics and Remote Domain execution restrictions Command Virtual Fabrics and Remote Domain execution restrictions TABLE 1 Virtual Fabric and Remote Domain execution restrictions for Fabric OS commands.
Command Virtual Fabrics and Remote Domain execution restrictions TABLE 1 Virtual Fabric and Remote Domain execution restrictions for Fabric OS commands.
Command Virtual Fabrics and Remote Domain execution restrictions TABLE 1 Virtual Fabric and Remote Domain execution restrictions for Fabric OS commands.
Command Virtual Fabrics and Remote Domain execution restrictions TABLE 1 Virtual Fabric and Remote Domain execution restrictions for Fabric OS commands.
Command Virtual Fabrics and Remote Domain execution restrictions TABLE 1 Virtual Fabric and Remote Domain execution restrictions for Fabric OS commands.
Command Virtual Fabrics and Remote Domain execution restrictions TABLE 1 Virtual Fabric and Remote Domain execution restrictions for Fabric OS commands.
Command Virtual Fabrics and Remote Domain execution restrictions TABLE 1 Virtual Fabric and Remote Domain execution restrictions for Fabric OS commands.
Command Virtual Fabrics and Remote Domain execution restrictions TABLE 1 Virtual Fabric and Remote Domain execution restrictions for Fabric OS commands.
Command Virtual Fabrics and Remote Domain execution restrictions TABLE 1 Virtual Fabric and Remote Domain execution restrictions for Fabric OS commands.
Command Virtual Fabrics and Remote Domain execution restrictions TABLE 1 Virtual Fabric and Remote Domain execution restrictions for Fabric OS commands.
Command Virtual Fabrics and Remote Domain execution restrictions TABLE 1 Virtual Fabric and Remote Domain execution restrictions for Fabric OS commands.