Page 1 53-1000599-02 12 March 2008 Fabric OS Command Reference Manual Supporting Fabric OS 6.1.0...
Page 2 Copyright © 2007-2008 Brocade Communications Systems, Inc. All Rights Reserved. Brocade, Fabric OS, File Lifecycle Manager, MyView, and StorageX are registered trademarks and the Brocade B-wing symbol, DCX, and SAN Health are trademarks of Brocade Communications Systems, Inc., in the United States and/or in other countries. All other brands, products, or service names are or may be trademarks or service marks of, and are used to identify, products or services of their respective owners.
Page 3 Brocade Communications Systems, Incorporated Corporate Headquarters Asia-Pacific Headquarters Brocade Communications Systems, Inc. Brocade Communications Singapore Pte. Ltd. 1745 Technology Drive 9 Raffles Place San Jose, CA 95110 #59-02 Republic Plaza 1 Tel: 1-408-333-8000 Singapore 048619 Fax: 1-408-333-8101 Tel: +65-6538-4700 Email: info@brocade.com Fax: +65-6538-0302 Email: apac-info@brocade.com European and Latin American Headquarters...
Page 4 Document Title Publication Number Summary of Changes Publication Date Fabric OS Command Reference 53-1000240-01 September 2006 Fabric OS Command Reference 53-1000436-01 15 Jun 2007 Fabric OS Command Reference 53-1000599-01 Added 13 new commands, 19 October 2007 Updated 23 commands with new options in support of v6.0.
Page 5: Table Of Contents
Contents About This Document How this document is organized ......xvii Supported hardware and software ......xvii What is new in this document .
Page 6 bladeEnable..........49 burninErrClear .
Page 7 diagEnablePost .........104 diagHelp.
Page 8 fcipPathTest ..........149 fcLunQuery .
Page 9 firmwareRestore ........218 firmwareShow .
Page 10 interopMode ......... . .279 iodDelayReset .
Page 11 msPlatShow ..........348 msPlatShowDBCB .
Page 12 perfSetPortEEMask........409 perfShowAlpaCrc ........411 perfShowPortEEMask .
Page 13 portLogClear ......... . .485 portLogConfigShow .
Page 14 secActiveSize ......... . .555 secAuthSecret .
Page 15 supportShowCfgDisable ........631 supportShowCfgEnable ........632 supportShowCfgShow.
Page 16 uRouteRemove .........685 uRouteShow .
Page 17: About This Document
About This Document This document is a command reference manual written to help system administrators and technicians operate, maintain, and troubleshoot Brocade storage area network (SAN) products. “About this document” contains the following sections: • “How this document is organized,” next •...
Page 18: What Is New In This Document
• Brocade 300 switch • Brocade 4016 switch • Brocade 4018 switch • Brocade 4020 switch • Brocade 4024 switch • Brocade 4100 switch • Brocade 4900 switch • Brocade 5000 switch • Brocade 5100 switch • Brocade 5300 switch •...
Page 19 • fcrresourceshow • fcrlsanmatrix • firmwareDownload • licenseShow • portCfgDefault • portDisable • portEnable • portCfgAlpa • portCfgExport • portCfgEport • portCfgGport • portCfgISLMode • portCfgLongDistance • portCfgLport • portCfgNPIVPort • portCfgPersistentDisable • portCfgPersistentEnable • portCfgQos • portCfgTrunkport • portCfgShow •...
Page 20: Document Conventions
• fabStateShow (Deprecated; use fabricLog -s.) • fazoneAdd (Not supported on v6.x platforms.) • fazoneCreate (Not supported on v6.x platforms.) • fazoneDelete (Not supported on v6.x platforms.) • fazoneRemove (Not supported on v6.x platforms.) • minisPropShow (Internal use only.) • perfClrAlpaCrc (Deprecated;...
Page 21: Command Syntax Conventions
Command syntax conventions Command syntax in the synopsis section follows these conventions: command Commands are printed in bold. --option, option Command options are printed in bold. -argument, arg Arguments. Optional element. variable Variables are printed in italics. In the help pages, values are underlined or enclosed in angled brackets <...
Page 22: Additional Information
Additional information This section lists additional Brocade and industry-specific documentation that you might find helpful. Brocade resources The following related documentation is provided on the Brocade Documentation CD-ROM and on the Brocade Web site, through Brocade Connect. To get up-to-the-minute information, join Brocade Connect. It is free! Go to http://www.brocade.com and click Brocade Connect to register at no cost for a user ID and password.
Page 23 • Brocade ISL Trunking - Optimizes performance in multi-switch SAN fabrics. When two or more adjacent ISLs are used to connect two switches, the switches automatically group the ISLs into a single logical ISL, or “trunk.” Up to eight ISLs can be combined into a single logical ISL with a total bandwidth of 32 Gbit/sec that can support any number of devices.
Page 24: Getting Technical Help
NOTE For more information about licensed features refer to the Fabric OS Administrator’s Guide. Getting technical help Contact your switch support supplier for hardware, firmware, and software support, including product repairs and part ordering. To expedite your call, have the following information available: 1.
Page 25: Document Feedback
If you cannot use the wwn command because the switch is inoperable, you can get the WWN from the same place as the serial number, except for the Brocade DCX. For the Brocade DCX, access the numbers on the WWN cards by removing the Brocade logo plate at the top of the nonport side of the chassis.
Page 26 xxvi Fabric OS Command Reference 53-1000599-02...
Page 27: Using Fabric Os Commands
Chapter Using Fabric OS Commands This chapter explains how to manage a Brocade SAN and Brocade switches and directors using the Fabric OS command line interface (CLI). The following topics discussed: • “Understanding role-based access control” on page 1 • “Understanding admin domain restrictions”...
Page 28: Understanding Admin Domain Restrictions
Understanding admin domain restrictions Understanding admin domain restrictions A subset of Fabric OS commands is subject to Admin Domain restrictions that may be in place. In order to execute an AD restricted command on a switch or device, the switch or device must be part of a given Admin domain, and the user must be logged into that Admin Domain.
Page 29 Using the command line interface The documentation for each command includes a synopsis of its syntax, a description of command use, and a set of examples. The same information can be accessed by issuing help command on a Brocade switch or director. This command displays the help page for the specified command. For example, to display the help page for ad, type: switch:admin>...
Page 30 Using the command line interface Fabric OS Command Reference 53-1000599-02...
Page 31: Fabric Os Commands
Chapter Fabric OS Commands aaaConfig Manages RADIUS and LDAP configuration information. Synopsis aaaconfig aaaconfig --show aaaconfig --add | --change server -conf radius|ldap [-p port] [-d domain][-t timeout] [-s secret] [-a chap | pap | peap-mschapv2] aaaconfig --remove server -conf radius|ldap aaaconfig --move server -conf radius|ldap to_position aaaconfig --authspec aaa1[;aaa2 [-backup] aaaconfig --help...
Page 32 aaaConfig The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, “Understanding Admin Domain Restrictions” and Appendix A, “Command Availability” for details. Operands This command takes as input an action and its associated arguments. Without any specified action, the command prints out the usage.
Page 33 aaaConfig Valid protocols are one of the following: Password Authentication Protocol chap Challenge-Handshake Authentication Protocol peap-mschapv2 Protected Extensible Authentication Protocol (requires Fabric OS v5.3.0 or later) The distinction between protocols is only applicable to the packets between a system and the RADIUS server. Between the user and system, passwords are always used.
Page 34 aaaConfig “ldap” When ldap is specified, the first ADir server is contacted. If the ADir server is not reachable, the next ADir server is contacted. If the authentication fails, the authentication process does not check for the next server in the sequence.
Page 35 Manages Admin Domain operations. Synopsis ad --activate ad_id ad --add ad_id [-d “dev_list”] [-s “switch_list”] ad --apply ad --clear ad --create ad_id [-d "dev_list"] [-s "switch_list"] ad --deactivate ad_id ad --delete ad_id ad --exec ad_id "command_list" ad --remove ad_id [-d "dev_list"] [-s "switch_list"] ad --rename ad_id new_ad_id ad --save ad --select ad_id...
Page 36 All switches, switch ports and devices in the fabric that are not specified in any other Admin Domain are treated as implicit members of AD0. Members added to AD0 are called explicit members. When a new Admin Domain is created, the members included in the new Admin Domain are automatically removed from the implicit member list of AD0.
Page 37 --deactivate arg Deactivates an Admin Domain. This operation fails if an effective zone configuration exists under the Admin Domain. This operation is not allowed on AD0. ad --deactivate does not disable any ports. Existing logins to a deactivated Admin Domain are not terminated; however, subsequent CLI execution is disallowed.
Page 38 --show arguments Displays the membership information of the specified Admin Domain or all Admin Domains. When executed in an AD255 context and an Admin Domain name is not specified, all information about all existing Admin Domains is displayed. When executed in an AD0-AD254 context, the command, by default, displays the members of the current Admin Domain’s effective configuration, and therefore you cannot specify an ad_id or mode.
Page 39 -d “dev_list” Specifies the list of devices in an Admin Domain, in quotation marks. Separate each entry in the device list with a semicolon (;). Valid formats include: D,PI Uses existing zone D,PI member types. Benefits include: • Grants port control and zoning on the switch port and the devices attached to that port.
Page 40 Examples To enable AD5: switch:admin> ad --activate 5 You are about to activate a new admin domain. Do you want to activate ‘5’ admin domain (yes, y, no, n): [no] y To enable AD_13: switch:admin> ad --activate AD_13 To add new device members to AD1: switch:admin>...
Page 41 This operation will fail if an effective zone configuration exists in the AD Do you want to delete ‘13’ admin domain (yes, y, no, n): [no] y To execute switchShow in an AD7 context (using the current user_id): switch:admin> ad --exec 7 “switchshow” To rename Eng_AD to Eng_AD2: switch:admin>...
Page 42 Switch port members: 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; Switch WWN members: 10:00:00:60:69:00:02:53; Effective configuration: ------------------------ AD: 1 : Active Device WWN members: 21:00:00:80:e5:12:8b:37; 21:00:00:80:e5:12:8b:55; Switch port members: 1,0; 1,1; 1,2; 1,3; 1,4; 1,5; 1,6;...
Page 43 To display the configuration information in the transaction buffer: switch:admin> ad --validate Current AD Number: 255 AD Name: AD255 Transaction buffer configuration: --------------------------------- no configuration Defined configuration: ---------------------- AD Number: AD Name: AD1 State: Inactive Device WWN members: 10:00:00:00:00:01:00:00; 10:00:00:00:00:04:00:00; 10:00:00:00:00:05:00:00;...
Page 44 Device WWN members: 10:00:00:00:00:17:00:00; 10:00:00:00:00:15:00:00; Switch port members: 2,52; 2,53; 2,54; 2,55; 21,5; 3,28; 3,29; 98,72; 98,75; 69,16; 69,18; 69,21; 1,336; 1,337; AD Number: AD Name: AD55 State: Inactive Device WWN members: 10:00:00:00:00:03:00:00; 10:00:00:00:00:04:00:00; 10:00:00:00:00:12:00:00; 10:00:00:00:00:11:00:00; 10:00:00:00:00:13:00:00; 10:00:00:00:00:14: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;...
Page 45 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 --pgshow [pgid] ag --pgcreate- pgid “N_Port1 [;N_Port2;...]” [-n pgname] ag [--pgadd | --pgdel] pgid “N_Port1 [;...
Page 46 AG configuration changes are saved persistently as config keys. Use the portCfgnPort command to set a port as N_Port. Notes AG is supported only on selected Brocade hardware platforms. Refer to the Access Gateway Administrator’s Guide for Hardware support and AG configuration procedures. In non-AG mode, the only two actions available are --modeenable and --modeshow.
Page 47 auto Enables the automatic port configuration policy. When enabled, this policy applies to all ports on the switch. All F_Port to N_Port mapping and port group configurations are ignored. Enables the advanced device security (ADS) policy. When enabled, this policy applies to all the ports on the switch.
Page 48 Creates a port group with the ID pgid and a specified list of N_Ports to be included in the policy. The list must be enclosed in quotation marks. Ports must be separated by semicolons. Maximum numbers of ports allowed in a port group is MAX_PORT.
Page 49 • If preferred Secondary F_Port to N_Port Mapping is in place, and the primary N_Port comes back online, then the F_Ports are re-routed through the primary N_Port. If the secondary N_Port comes online, while the primary N_Port is still offline, F_Ports are re-routed through the Secondary N_Port.
Page 50 Deletes the specified WWNs from the list of devices allowed to login to the specified F_Ports. Lists must be enclosed in double quotation marks. List members must be separated by semicolons. Replace the F_Port list with an asterisk (*) to remove the specified WWNs from all the F_Ports' allow lists. ADS policy must be enabled for this command to succeed.
Page 51 switch:admin> ag --modeshow Access Gateway mode is NOT enabled. AG group policy commands 1. To show current policies: switch:admin> ag --policyshow Policy_Description Policy_Name State ------------------------------------------------------------------ Port Grouping Enabled Auto Port Configuration auto Disabled Advanced Device Security ads Disabled ------------------------------------------------------------------ switch:admin> ag --policyshow Policy_Description Policy_Name State...
Page 52 AG port mapping commands 1. To display current port mappings and port grouping policies: switch:admin> ag --mapshow N_Port Configured_F_Ports Current_F_Ports Failover Failback PG_ID PG_Name ----------------------------------------------------------------------------- 4;5;6 4;5;6 SecondFabric 7;8;9 7;8;9 10;11 10;11 SecondFabric 12;13 12;13 ----------------------------------------------------------------------------- Explanation of fields in --mapshow output: Current F_Ports are the F_Ports that are currently online and mapped to a given N_Port either because they are mapped to that N_Port or as a result of N_Port failover.
Page 53 switch:admin> ag --prefdel 5 2 Preferred N_Port is deleted successfully for the F_Port[s] switch:admin> ag --mapdel 2 “5” F_Port to N_Port mapping has been updated successfully NOTE: Preferred Port commands are discussed in detail below. AG failover policy commands 1. To display failover policy settings for all N_Ports: switch:admin>...
Page 54 switch:admin> ag --failbackenable 2 Failback on N_Port 2 is supported Port Group commands 1. To display Port Group information: switch:admin> ag --pgshow PG_ID N_Ports PG_Name ------------------------------------- SecondFabric -------------------------------------- 2. To create a port group “FirstFabric” that includes N_Ports 1 and 3: switch:admin>...
Page 55 7;8;9 ------------------------------------------ 2. To delete secondary port mapping for F_Ports 7, 8 and 9: switch:admin> ag --prefdel “7;8;9” 3 Preferred N_Port is deleted successfully for the F_Port[s] 3. To set secondary port mapping for F_Ports 7, 8 and 9: switch:admin> ag --prefset “7;8;9” 3 Preferred N_Port is set successfully for the F_Port[s] ADS Policy commands 1.
Page 56: Agshow
agshow agshow Displays the Access Gateway information registered with the fabric. Synopsis agshow --name [ag_name] | [--local] Description This command displays the details of the F_Ports and the configured N_Ports in the Access Gateway attached to the fabric shows the following information. Name The name of the Access Gateway.
Page 57 agshow To display the locally registered Access Gateways: switch:admin> agshow --local Worldwide Name Ports Enet IP Addr Firmware Local/Remote Name --------------------------------------------------------------------------------- 10:00:00:05:1e:04:06:ae 10.32.173.64 v6.0.0 local L5D2_B14_4024_1 To display all Access Gateways attached to the fabric: switch:admin> agshow Worldwide Name Ports Enet IP Addr Firmware Local/Remote Name...
Page 58: Aliadd
aliAdd aliAdd Adds a member to a zone alias. Synopsis aliadd “aliName”, “member[; member...]” Description Use this command to add one or more members to an existing zone alias. The alias member list cannot contain another zone alias. This command changes the defined configuration. For the change to become effective, enable the zone configuration with the cfgEnable command.
Page 59: Alicreate
aliCreate aliCreate Creates a zone alias. Synopsis alicreate “aliName”, “member[; member...]” Description Use this command to create a new zone alias. The zone alias member list must have at least one member (empty lists are not allowed). The alias member list cannot contain another zone alias. Refer to the zoneCreate command for more information on name and member specifications.
Page 60: Alidelete
aliDelete aliDelete Deletes a zone alias. Synopsis alidelete “aliName” Description Use this command to delete a zone alias. This command changes the defined configuration. For the change to 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.
Page 61: Aliremove
aliRemove aliRemove Removes a member from a zone alias. Synopsis aliremove “aliName”, “member[; member...]” Description Use this command to remove one or more members from an existing zone alias. If all members are removed, the zone alias is deleted. This command changes the defined configuration. For the change to become effective, enable the zone configuration with the cfgEnable command.
Page 62: Alishow
aliShow aliShow Displays zone alias information. Synopsis alishow ["pattern"][, mode] Description Use this command to display zone configuration information. Use the pattern operand to display only matching zone alias names in the defined configuration. Note When FCS policy is enabled, this command can be issued only from the primary FCS switch. Operands When invoked without operand, this command displays all zone configuration information (defined and effective).
Page 63: Aptpolicy
aptPolicy aptPolicy Changes or displays the Advanced Performance Tuning (APT) policy. Synopsis aptpolicy [ap_policy] aptpolicy -ap <ap_policy> Description Use this command to manage advanced performance tuning (APT) policies on a switch or chassis. Several internal performance tuning parameters can be modified with this command. The default parameters (AP shared Link Policy) are optimized for most SAN applications;...
Page 64 aptPolicy This policy does not support static routes. DLS is always enabled and the DLS setting cannot change with this policy. Specifies an additional AP policy supported under exchange based policy (3). The following policies are supported: AP Shared Link Policy (default). AP Dedicated Link Policy.
Page 65: Auditcfg
auditCfg auditCfg Modifies and displays the audit log filter configuration. Synopsis auditcfg --class audit_class auditcfg --enable |--disable auditcfg --show Description Use this command to configure and display the audit log configuration. This command allows you to set filters by configuring certain classes, to add or remove any of the classes in the filter list, and to enable or disabled the filters.
Page 66: Authutil
authUtil authUtil Displays and sets the authentication configuration. Synopsis authutil authutil --show authutil --set option value authutil --policy -sw option | -dev option authutil --authinit [slotnumber]/portnumber[, [slotnumber/]portnumber...] | allE Description Use this command to display and set local switch authentication parameters. Use --set to change authentication parameters such as protocol, Diffie-Hellman group (DH group), or hash type.
Page 67 authUtil Sets the hash type. Valid values are “sha1”, “md5” or “all”, which sets both hash types. Use this option to disable md5 authentication access by setting the hash type to sha1 only. Disabling md5 access is required when configuring the system for FIPS. Refer to the Fabric OS Administrator’s Guide for details on FIPS configuration.
Page 68 authUtil allE Specify all E_Ports in the switch. Examples To display authentication configuration on the switch: switch:admin> authutil --show AUTH TYPE HASH TYPE GROUP TYPE -------------------------------------- fcap,dhchap sha1,md5 0,1,2,3,4 Switch Authentication Policy: PASSIVE Device Authentication Policy: OFF To set DH-CHAP as the authentication protocol: switch:admin>...
Page 69 authUtil fcap,dhchap sha1,md5 Switch Authentication Policy: PASSIVE Device Authentication Policy: OFF switch:admin> authutil --set -h sha1 Hash is set to sha1. switch:admin> authutil --show AUTH TYPE HASH TYPE GROUP TYPE -------------------------------------- fcap,dhchap sha1 Switch Authentication Policy: PASSIVE Device Authentication Policy: OFF See Also portShow, secAuthSecret Fabric OS Command Reference...
Page 70: Bannerset
bannerSet bannerSet Sets the banner on the local switch. Synopsis bannerset [banner] Description Use this command to set the banner on the local switch. The banner is a string of alphanumeric characters. It is displayed whenever you log in to a switch. The banner can be created using the banner operand or by entering the bannerSet command without an operand, making the session interactive.
Page 71: Bannershow
bannerShow bannerShow Displays the banner text. Synopsis bannershow Description Use this command to display the contents of the banner. Operands none Examples To display the banner for a switch: switch:admin> bannershow Banner: Do not log into this switch if you are not an authorized administrator. See Also bannerSet Fabric OS Command Reference...
Page 72: Bcastshow
bcastShow bcastShow Displays broadcast routing information. Synopsis bcastshow Description Use this command to display the broadcast routing information for all ports in the switch. The broadcast routing information indicates all ports that are members of the broadcast distribution tree: ports that are able to send and receive broadcast frames. Normally, all F_Ports and FL_Ports are members of the broadcast distribution tree.
Page 73: Bladebeacon
bladeBeacon bladeBeacon Enables or disables blade beaconing, or displays the current mode. Synopsis bladebeacon slotnumber [mode] Description Use this command to enable or disable blade beaconing or to display the current beaconing mode for one blade. When beaconing is enabled, the port LEDs flash amber in a running pattern from bottom to top and top to bottom.
Page 74: Bladedisable
bladeDisable bladeDisable Disables all user ports on a blade. Synopsis bladedisable slotnumber Description Use this command to disable all user ports on a blade. All ports on the blade are taken offline. If the switch was connected to a fabric through this blade, the remaining switches reconfigure, and this switch will configure based on the other blade ports.
Page 75: Bladeenable
bladeEnable bladeEnable Enables all user ports on a blade. Synopsis bladeenable slotnumber Description Use this command to enable all user ports on a blade. All ports within the blade that did not fail the power-on self-test (POST) are enabled (except for persistently disabled ports); they might come online if connected to a device or remain offline if disconnected.
Page 76 bladeEnable UNKNOWN VACANT UNKNOWN VACANT SW BLADE ENABLED CP BLADE ENABLED CP BLADE ENABLED SW BLADE ENABLED UNKNOWN VACANT UNKNOWN VACANT UNKNOWN VACANT See Also bladeDisable, portDisable, portEnable, switchShow Fabric OS Command Reference 53-1000599-02...
Page 77: Burninerrclear
burninErrClear burninErrClear Clears errors stored in nonvolatile memory during burn-in. Synopsis burninerrclear slotnumber Description Use this command to clear errors that were stored during burn-in in the nonvolatile memory of a specified slot. It is advisable to run the burninErrClear command prior to running diagSetBurnin and diagSetCycle Note The execution of this command is subject to Admin Domain restrictions that may be in place.
Page 78: Burninerrshow
burninErrShow burninErrShow Displays errors stored in nonvolatile memory on a slot during burn-in. Synopsis burninerrshow slotnumber Description Use this command to display errors generated during burn-in and stored in nonvolatile memory on a specified slot. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 79: Burninlevel
burninLevel burninLevel Sets the diagnostics burn-in level. Synopsis burninlevel [level | -show] Description Use this command to select or display the burn-in level. When you set the burn-in level to a value other than 0, this command behaves as follows: 1.
Page 80: Burninstatus
burninStatus burninStatus Displays the diagnostics burn-in status. Synopsis burninstatus [[--slot] slotnumber] Description Use this command to display the burn-in status of blade in a specified slot. Command output includes the slot number, state, current run number, current command in the run, total commands in a run, and the burn-in script name.
Page 81: Cfgactvshow
cfgActvShow cfgActvShow Displays effective zone configuration information. Synopsis cfgactvshow Description Use this command to display the effective zone configuration information. The current configuration is a single zone configuration that is currently in effect. The devices that an initiator sees are based on this configuration. The effective configuration is built when a specified zone configuration is enabled.
Page 82: Cfgadd
cfgAdd cfgAdd Adds a member to a zone configuration. Synopsis cfgadd "cfgName", "member[ ;member...]" Description Use this command to add one or more members to an existing zone configuration. This command changes the Defined Configuration. For the change to be preserved across switch reboots, save the configuration to nonvolatile memory with the cfgSave command.
Page 83: Cfgclear
cfgClear cfgClear Clears all zone configurations. Synopsis cfgclear Description Use this command to clear all zone information in the transaction buffer. All defined zone objects in the transaction buffer are deleted. If an attempt is made to commit the empty transaction buffer while a zone configuration is enabled, you are warned to first disable the enabled zone configuration or to provide a valid configuration with the same name.
Page 84: Cfgcreate
cfgCreate cfgCreate Creates a zone configuration. Synopsis cfgcreate "cfgName", "member[ ;member...]" Description 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.
Page 85: Cfgdelete
cfgDelete cfgDelete Deletes a zone configuration. Synopsis cfgdelete "cfgName" Description Use this command to delete a zone configuration. This command changes the Defined Configuration (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.
Page 86: Cfgdisable
cfgDisable cfgDisable Disables a zone configuration. Synopsis cfgdisable Description Use this command to disable the current zone configuration. The fabric returns to non-zoning mode, in which all devices see each other. This command ends and commits the current zoning transaction buffer to both volatile and nonvolatile memory.
Page 87: Cfgenable
cfgEnable cfgEnable Enables a zone configuration. Synopsis cfgenable "cfgName" Description Use this command to enable a zone configuration. The command builds the specified zone configuration by checking for undefined zone names, zone alias names, or other inconsistencies, by expanding zone aliases, removing duplicate entries, and then installing the effective configuration.
Page 88: Cfgmcdtmode
cfgMcdtmode cfgMcdtmode Configures zoning features in McDATA Fabric mode. Synopsis cfgMcdtMode [--enable | --disable | --help] [safezoning | defaultzoning] Description Use this command to enable or disable either the McDATA safe zoning feature or the McDATA default zoning feature. Enabling or disabling safezoning or default zoning on one switch in the fabric enables or disables the specific feature fabric-wide, meaning that the feature is disabled or enabled on all switches in the fabric.
Page 89: Cfgremove
cfgRemove cfgRemove Removes a member from a zone configuration. Synopsis cfgremove “cfgName”, “member[; member...]” Description Use this command to remove one or more members from an existing zone configuration. If all members are removed, the zone configuration is deleted. This command changes the Defined Configuration (see cfgShow). For the change to become effective, enable the configuration with the cfgEnable command.
Page 90: Cfgsave
cfgSave cfgSave Saves zone configuration to nonvolatile memory. Synopsis cfgsave Description 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.
Page 91: Cfgsaveactivetodefined
cfgSaveActiveToDefined cfgSaveActiveToDefined Saves the active (effective) zoning configuration to the defined configuration in McDATA Fabric mode. Synopsis cfgSaveActiveToDefined Description Use this command in McData Fabric mode to move the effective zoning configuration to the defined configuration database. If the Defined Database contains a configuration with the same name, it is replaced.
Page 92: Cfgshow
cfgShow cfgShow Displays zone configuration information. Synopsis cfgshow ["pattern"] [, mode] Description Use this command to display zone configuration information. If no operand is specified, all zone configuration information (both defined and effective) displays. If the local switch has an outstanding transaction, this command displays the most recently edited zone configuration that has not yet been saved.
Page 93 cfgShow To display all zone configuration information: switch:admin> cfgshow Defined configuration: cfg: USA1 Blue_zone cfg: USA_cfg Red_zone; Blue_zone zone: Blue_zone 1,1; array1; 1,2; array2 zone: Red_zone 1,0; loop1 alias: array1 21:00:00:20:37:0c:76:8c; 21:00:00:20:37:0c:71:02 alias: array2 21:00:00:20:37:0c:76:22; 21:00:00:20:37:0c:76:28 alias: loop1 21:00:00:20:37:0c:76:85; 21:00:00:20:37:0c:71:df Effective configuration: cfg: USA_cfg...
Page 94: Cfgsize
cfgSize cfgSize Displays zone and Admin Domain database size details. Synopsis cfgsize [integer] Description Use this command to display the size details of the zone database and the Admin Domain database. When executed in non-AD255 context, the size details include the Zone DB maximum size, the committed size, and the transaction size.
Page 95 cfgSize ---------------- committed - 3124 bytes transaction - 0 bytes Number of ADs in Effective Configuration Each AD's Zone Database Size: ---------------------------- cfgsize Info for AD Number:0 (AD Name: AD0, State=Active): committed - 242 bytes transaction - 0 bytes cfgsize Info for AD Number:1 (AD Name: AD1, State=Active): committed - 16 bytes...
Page 96: Cfgtransabort
cfgTransAbort cfgTransAbort Aborts the current zoning transaction. Synopsis cfgtransabort [token] Description Use this command to abort the current zoning transaction without committing it. All changes made since the transaction was started are removed and the zone configuration database is restored to the state before the transaction was started.
Page 97: Cfgtransshow
cfgTransShow cfgTransShow Displays information about the current zoning transaction. Synopsis cfgtransshow Description Use this command to display the ID of the current zoning transaction. 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.
Page 98: Chassisconfig
chassisConfig chassisConfig Displays or sets the configuration of the chassis. Synopsis chassisconfig [-f][option] Description Use this command to set the chassis configuration for products that support both single-switch and dual-switch operation. Each configuration specifies whether the chassis runs as one logical switch or two, and the port blade ID that is permitted on each logical switch.
Page 99 chassisConfig Notes This command is retained for legacy reasons only. There are no separate chassis configuration options on the Brocade DCX backbone. By default the switch supports 384 ports in a single Fibre Channel domain. The chassisConfig command is not available on this platform. Brocade 48000 directors support only option 5.
Page 100: Chassisname
chassisName chassisName Displays or sets the chassis name. Synopsis chassisname [name] Description Use this command to display or change the name associated with the chassis. Operands This command has the following operand: name Specify a new name for the chassis, optionally in quotation marks. Chassis names can be up to 15 characters long, must begin with a letter, and can consist of letters, digits, underscore or hyphen characters.
Page 101: Chassisshow
chassisShow chassisShow Displays all field replaceable units (FRUs). Synopsis chassisshow Description Use this command to inventory and display the FRU header content for each object in the chassis and chassis backplane version. Refer to the Table 1 for more information about the lines and their meaning. TABLE 1 Command output descriptions Line...
Page 102 chassisShow Chassis Backplane Revision: 1C SW BLADE Slot: 3 Header Version: Power Consume Factor: -180 Factory Part Num: 60-0001532-03 Factory Serial Num: 1013456800 Manufacture: Day: 12 Month: Year: 2001 Update: Day: 15 Month: Year: 2001 Time Alive: 28 days Time Awake: 16 days 555-374757 Part Num:...
Page 103: Clihistory
cliHistory cliHistory Name Displays switch command history. Synopsis clihistory Description This command saves the following information whenever a command is executed on the switch: • Timestamp • Username • IP address of the Telnet session • Options • Arguments This command displays the local CLI command history. This command cannot be executed on the standby CP.
Page 104: Configdefault
configDefault configDefault Restores system configuration parameters to default values. Synopsis configdefault Description Use this command to reset a subset of configuration settings to their factory defaults. All configuration parameters are reset to their default values with the exception of the following: •...
Page 105 configDefault See Also snmpConfig, configure, switchDisable, switchEnable Fabric OS Command Reference 53-1000599-02...
Page 106: Configdownload
configDownload configDownload Downloads switch configuration and other parameters from a host file. Synopsis configdownload configdownload -p ftp | -ftp [”host”,”user”,”path”,[”passwd”]] configdownload -p scp| -scp [”host”,”user”,”path”,[”passwd”]] configdownload --local | USB |-U [“file”] Description This command downloads the switch configuration and other parameters from a host file. The configuration file may have been generated previously by configUpload, or it may have been created by a user to download only specific changes.
Page 107 configDownload • In the [Active Security Policies] section, the FCS_POLICY must be exactly the same as the previous FCS_POLICY. Order of members must be maintained. • If either security policies section has an RSNMP_POLICY, then that section must have a WSNMP_POLICY.
Page 108 configDownload “host” A host name or IP address in quotation marks: for example, “citadel” or “192.168.1.48”. The configuration file is downloaded from this host. To be able to mention the FTP server by name, you need to set up two DNS servers with dnsConfig.
Page 109: Configlist
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.
Page 110: Configremove
configRemove configRemove Deletes a saved configuration file. Synopsis configremove -local|-USB|-U [file] Description 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. Operands This command has the following operands: -local Removes a configuration file that was previously created by configUpload -local from the local chassis.
Page 111: Configshow
configShow configShow Displays system configuration settings. Synopsis configshow [“pattern”] | -pattern [“pattern”] configshow -local|-USB|-U [file] [-pattern "pattern"] Description Use this command to display some system configuration settings in addition to the parameters set by the configure command. When executed without operands, this command displays all system configuration settings.
Page 112 configShow [Boot Parameters] boot.name:cp7 boot.ipa:10.33.36.41 boot.licid:10:00:00:05:1e:38:b0:db boot.mac:10:00:00:05:1e:38:b0:db boot.device:eth0 boot.gateway.ipa:10.33.32.1 [LicensesDB] 6122B8EE0FBB440F46E124E97B16277D6122B8EE0FBB440F0073B7A57B16277D6F61 [DMM_WWN] [Licenses] [Chassis Configuration] [Configuration] acl.clear:0 ag.port.nfportfailback:0x0 ag.port.nfportfailover:0x0 ag.port.nfporttopo.0:0x0 ag.port.nfporttopo.1:0x0 ag.port.nfporttopo.10:0x0 [output truncated] To display selected content of the local configuration file: switch:admin> configshow -local config.txt -pattern "passwdcfg" passwdcfg.adminlockout:0 passwdcfg.digits:0 passwdcfg.history:1 passwdcfg.lockoutduration:30...
Page 113: Configupload
configUpload configUpload Uploads switch configuration and other parameters to a host file. Synopsis configupload configupload -p ftp | -ftp [”host”,”user”,”path”,[”passwd”]] configupload -p scp| -scp [”host”,”user”,”path”,[”passwd”]] configupload [-force] -local | USB |-U [“file”] Description This command uploads the switch configuration to a host file. The first form of the configupload command uses FTP (File Transfer Protocol).
Page 114 configUpload • The first section contains the version of the Fabric OS from which this configuration was uploaded and the time stamp for the uploaded file creation. • The [Boot Parameters] section contains the switch boot parameters, also known as the switch’s identity.
Page 115 configUpload “file” A file name in quotation marks, for example, "config.txt". This parameter can be used only with the -local and -USB options, each of which stores files in a predefined directory on the local chassis or on an attached USB device. Therefore, subdirectories and absolute path names are not permitted.
Page 116: Configure
configure configure Changes system configuration settings. Synopsis configure Description Use this command to change the following system configuration settings for the switch: • Switch fabric settings • Virtual channel parameters • F_Port login parameters • Zoning operation parameters • Remote State Change Notifications (RSCN) transmission mode •...
Page 117 configure Switch Fabric Settings 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. Other parameters, such as buffer-to-buffer credit or timeout values, can be modified to suit specific applications or operating environments but must be in agreement among all switches to allow formation of the fabric.
Page 118 configure Note that the The R_A_TOV, E_D_TOV, WAN_TOV, and MAX_HOPS configuration parameters are interrelated. Assigning a specific value to one or more of these parameters can change the range of allowed values that can be assigned to the other parameters. As a result, you may not be able to set all the values within the range displayed against each parameter.
Page 119 configure Virtual Channel Settings The switch enables fine-tuning for a specific application by configuring the parameters for eight virtual channels. The first two virtual channels are reserved for switch internal functions and are not available for modification. The default virtual channel settings have already been optimized for switch performance. Changing the default values can improve switch performance but can also degrade performance.
Page 120 configure Zoning Operation Parameters Table 5 lists the configurable zoning operation parameters. TABLE 5 Zoning operation parameters Field Type Default Range Disable Nodename Zone Boolean Checking Disable NodeName Zone Checking Specify 1 to disable using node WWN when specifying nodes in the zone database, or specify 0 to enable using node WWN when specifying nodes in the zone data.
Page 121 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. 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 pre-existing devices.
Page 122 configure System Settings The following table lists system settings. TABLE 10 System settings Field Type Default Range system.blade.bladeFaultOn Number 0x0 to 0xffff HwErrMsk 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.
Page 123: Datatypeshow
dataTypeShow dataTypeShow Displays sample data stream types used in some diagnostic commands. Synopsis datatypeshow [-seed value] Description Use this command to display sample data stream types used in diagnostic commands. There are 20 different sample data types. The command displays an example of each data stream. Note The execution of this command is subject to Admin Domain restrictions that may be in place.
Page 124: Date
date date Displays or sets the switch date and time. Synopsis date [“newdate”] Description Use this command to display or set the date and time. All switches maintain 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;...
Page 125: Dbgshow
dbgShow dbgShow Displays current values of debug and verbosity levels of the specified module. Synopsis dbgshow [module_name] Description Use this command to display the current values of debug and verbosity levels of the specified module. If no module name is specified, displays debug and verbosity levels of all modules. Note The execution of this command is subject to Admin Domain restrictions that may be in place.
Page 126: Defzone
defZone defZone Sets or displays the default zone access mode. Synopsis defzone [--noaccess | --allaccess | --show] Description 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.
Page 127 defZone Sets the default zone access mode to All Access, initiates a zoning --allaccess transaction (if one is not already in progress), and deletes the reserved zoning objects by performing the equivalent to the following zoning commands: cfgDelete “d_efault_Cfg” zoneDelete “d_efault_Zone” A cfgSave, cfgEnable, or cfgDisable command must be performed subsequent to the use of this command to commit the changes and distribute them to the fabric.
Page 128: Diagclearerror
diagClearError diagClearError Clears the diagnostics failure status. Synopsis diagclearerror [[--slot] slotnumber] -all Description Use this command to clear the diagnostics failure status. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 129: Diagdisablepost
diagDisablePost diagDisablePost Disables power-on self-test (POST). Synopsis diagdisablepost Description Use this command to disable POST. A reboot is not required for this command to take effect. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 130: Diagenablepost
diagEnablePost diagEnablePost Enables power-on self-test (POST) execution at next reboot. Synopsis diagenablepost Description Use this command to enable POST. A reboot is not required for this command to take effect. POST includes two phases: POST Phase I mainly tests hardware and POST Phase II tests system functionality.
Page 131: Diaghelp
diagHelp diagHelp Displays diagnostic command information. Synopsis diaghelp Description 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.
Page 132: Diagpost
diagPost diagPost Sets or displays diagnostic POST configuration. Synopsis diagpost [mode | -show] Description Use this command to enable or disable Power-On-Self-Test) POST. The mode is saved in flash memory (and stays in that mode) until the next execution of diagPost. The mode becomes active as soon as this command is executed;...
Page 133: Diagretry
diagRetry diagRetry Sets or displays diagnostic retry mode. Synopsis diagretry [mode | -show] Description Use this command to enable retry mode if the mode value is nonzero and to disable the retry mode if the mode value is 0. The mode is saved in flash memory (and stays in that mode) until the next execution of diagRetry.
Page 134: Diagsetburnin
diagSetBurnin diagSetBurnin Initializes the blade for a burn-in run. Synopsis diagsetburnin [--slot slotnumber][script | -current] Description This sets up the blade burn-in parameters for the registered burn-in script. The burn-in starts at the next run of power-on self-test (POST) on the designated blades. The errors and activity logs are stored in flash memory.
Page 135: Diagsetcycle
diagSetCycle diagSetCycle Sets diagnostic script parameters. Synopsis diagsetcycle script [-show | -default | [-keyword value]] Description Use this command to update diagnostic command parameters. If only a script is specified, the command displays all configuration variables used by the specified script and enters an interactive session.
Page 136: Diagshow
diagShow diagShow Displays diagnostics status. Synopsis diagshow [--slot number][-uports itemlist][-bports itemlist][-use_bports value] Description Use this command to display the diagnostics status for the specified list of blade or user ports. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 137: Diagskiptests
diagSkipTests diagSkipTests Enables or disables diagnostics skip test flags. Synopsis diagskiptests [value | -show] Description Use this command to enable or disable the diagnostics skip test flags. The skip test flags are saved in flash memory and stay set until the next execution of diagSkipTests. The mode becomes active as soon as this command is executed.
Page 138: Diagstopburnin
diagStopBurnin diagStopBurnin Terminates a blade burn-in run. Synopsis diagstopburnin [--slot number] Description Use this command to determine which PID is running burn-in on a blade and terminate that activity. The burn-in script handles the logging cleanup. This command does not require a reboot to take effect. Note The execution of this command is subject to Admin Domain restrictions that may be in place.
Page 139: Dbgshow
dbgShow dbgShow Displays current values of debug and verbosity levels of the specified module. Synopsis dbgshow module_name Description Use this command to display the current values of debug and verbosity levels of the specified module. If no module name is specified, displays debug and verbosity levels of all modules. Note The execution of this command is subject to Admin Domain restrictions that may be in place.
Page 140: Distribute
distribute distribute Distributes data to switches in a fabric. Synopsis distribute -p policy_list -d switch_list Description Use this command to distribute data to a specified list of switches in the fabric. The distributed data must be from the list of currently supported policy sets: Switch Connection Control Policy Device Connection Control Policy Password Database and Password Configuration Policy...
Page 141 distribute To distribute the Switch Connection Control Policy, FCS 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 domains in the fabric that support the distribute feature: switch:admin>...
Page 142: Dlsreset
dlsReset dlsReset Disables the dynamic load sharing (DLS) option. Synopsis dlsreset Description Use this command to turn off DLS when a fabric change occurs. Refer to dlsSet for a full description of load sharing. This command should be used only if devices connected to the fabric cannot handle occasional routing changes correctly.
Page 143: Dlsset
dlsSet dlsSet Enables the dynamic load sharing (DLS) option. Synopsis dlsset Description Use this command to turn on DLS when a fabric change occurs. Routing is based on the incoming port and the destination domain. This means that all traffic coming in from a port (either from an E_Port or an Fx_Port) and directed to the same remote domain is routed through the same output E_Port.
Page 144: Dlsshow
dlsShow dlsShow Displays the setting of the dynamic load sharing (DLS) option. Synopsis dlsshow Description Use this command to display whether DLS is on or off. One of two messages displays: DLS is set The DLS option is turned on. Load sharing is reconfigured with every change in the fabric, and existing routes can be moved to maintain optimal balance.
Page 145: Dnsconfig
dnsConfig dnsConfig Sets, displays, or removes domain name service (DNS) parameters. Synopsis dnsconfig Description Use this command to display, set, or remove the domain name service parameters. The domain name service parameters are the domain name and the name server IP address for primary and secondary name servers.
Page 146: Enclosureshow
enclosureShow enclosureShow Displays attributes of the switch enclosure. Synopsis enclosureshow attribute Description Use this command to display attributes of the switch enclosure. Supported attributes include the vendor-specific enclosure identifier and the identifier of the enclosure interface to which the switch is attached.
Page 147: Errclear
errClear errClear Clears all error log messages for all switch instances on this control processor (CP). Synopsis errclear Description Use this command to clear all internal and external error log messages for all switch instances on this CP. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 148: Errdelimiterset
errDelimiterSet errDelimiterSet Sets the error log start and end delimiters for messages sent to the console and syslog. Synopsis errdelimiterset [-s "start delimiter string"][-e "end delimiter string"] Description Use this command to set the error log start and end delimiters for log messages sent to the console and syslog.
Page 149: Errdump
errDump errDump Displays the error log without pagination. Synopsis errdump [-s switch_instance][-r][-p] Description Use this command to display external error log messages for all switch instances and the chassis, without pagination. The -r operand displays the messages in reversed order. The following information displays in each message: Start delimiter Delimiter string for the start of a message.
Page 150: Errfilterset
errFilterSet errFilterSet Sets a filter for an error log destination. Synopsis errfilterset [-d "destination"][-v "severity"] Description Use this command to set a filter for an error log destination. A filter is set based on the severity level of the messages. If no parameters are specified, this command displays the filters that are currently in use.
Page 151: Errmoduleshow
errModuleShow errModuleShow Displays all the defined error log modules. Synopsis errmoduleshow Description Use this command to display a list of all defined error log modules. Operands none Examples To display a list of all defined error log modules: switch:user> errmoduleshow Module IDs: 1 KT 2 UT...
Page 152: Errshow
errShow errShow Displays the error log messages with pagination. Synopsis errshow [-s switch_instance][-r][-p] Description Use this command to display external error log messages for all switch instances and the chassis, one at a time. The -r operand displays the messages in a reversed order. The following information displays in each message: Start delimiter Delimiter string for the start of a message.
Page 153: Exit
exit exit Logs out from a shell session. Synopsis exit Description Use this command to log out from a Telnet, SSH, rlogin or serial port session. Telnet and rlogin connections are closed; the serial port returns to the prompt. login: The exit command is an accepted synonym for logout, as is typing Ctrl-D at the beginning of a line.
Page 154: Fabportshow
fabPortShow fabPortShow Displays fabric port information. Synopsis fabportshow [slotnumber/]portnumber Description Use this command to display the state of a port, relative to the fabric, as well as a list of pending commands. The following information displays: Port The port number. State The state of the port: Port Offline...
Page 155 fabPortShow 0x00000800 Zoning has completed 0x00001000 Segmented by Platform Management 0x00002000 Segmented due to no license 0x00004000 Segmented due to E_Port disabling 0x00008000 DIA already sent for that port 0x00010000 RDI already sent 0x00020000 Port is true T port 0x00040000 Port received an ELP 0x00080000 Port received an ELP RJT...
Page 156 fabPortShow Examples To display fabric port information: switch:admin> fabportshow 4/14 Fabric Port Information: ======================== Port: State: List: 0x10068418 List Count: Flags: 0x280120 nbrWWN: 10:00:00:60:69:80:06:cf nbrPort: lr_tid: 0x1005dbd8, IDLE STATE red_ports: 10 11 62 63 Open commands pending: ====================== No commands pending See Also portShow Fabric OS Command Reference...
Page 157: Fabretryshow
fabRetryShow fabRetryShow Displays the retry count of the fabric commands. Synopsis fabretryshow Description Use this command to display the retry count of the fabric commands. The SW_ISL (ISL ports) information displays the retry count for the following fabric commands: Exchange Link Parameters Exchange Fabric Parameters HA_EFP Exchange Fabric Parameters used during warm recovery...
Page 158: Fabriclog
fabricLog fabricLog Displays (all users) or manipulates (admin) the fabric log. Synopsis fabriclog -s | -c | -d | -e | -r size Description Use this command to display, clear, disable, enable, or resize the fabric log. Notes The execution of this command is subject to Admin Domain restrictions that may be in place.Refer to chapter 1, “Understanding Admin Domain Restrictions”...
Page 159 fabricLog switch:admin> fabriclog -r 64 Warning: This command will clear the logs. Are your sure you want to do the resize [y/n]? y switch:admin> fabriclog -s Time Stamp Input and *Action S, P Sn,Pn Port =========================================================================== See Also fabPortShow, fabStatsShow Fabric OS Command Reference 53-1000599-02...
Page 160: Fabricprincipal
fabricPrincipal fabricPrincipal Sets principal switch selection mode. Synopsis fabricprincipal [-fhq] [mode] Description Use this command to set principal switch selection mode for the switch. The implementation of the fabricPrincipal command is based solely on mechanisms specified in the Fibre Channel standards. These mechanisms provide a preference for a switch requesting to be the principal switch in a fabric, but they do not provide an absolute guarantee that a switch requesting to be the principal switch achieves this status.
Page 161: Fabricshow
fabricShow fabricShow Displays fabric membership information. Synopsis fabricshow Description Use this command to display information about switches in the fabric. If the switch is initializing or is disabled, the message “no fabric” is displayed. In a mixed fabric, fabricshow must be executed on a switch that runs Fabric OS v5.3.0 or later; otherwise, IPv6 information is lost, since switches running earlier versions do not recognize an IPv6-configured switch.
Page 162 fabricShow 1080::8:800:200C:1234/64 2: fffc42 10:00:00:60:69:00:05:91 192.168.64.60 192.168.65.60 "sw60" The Fabric has 2 switches. To show additional details of the FC Router, if present: switch:admin> fabricshow -m Switch ID Name ENET IP Addr FC Router FC Router IP Addr Name ------------------------------------------------------------------------- 1: fffc01 fcr_sprint_01 10.33.59.224 160: fffca0...
Page 163: Fabstatsshow
fabStatsShow fabStatsShow Displays the fabric statistics. Synopsis fabstatsshow Description Use this command to display the statistics for the fabric. The following information is displayed: • Number of times a switch domain ID has been forcibly changed • Number of E_Port offline transitions •...
Page 164 fabStatsShow Sec Incompatibility: Sec Violation: ECP Error: Duplicate WWN: Eport Isolated: See Also fabRetryShow Fabric OS Command Reference 53-1000599-02...
Page 165: Fabswitchshow
fabSwitchShow fabSwitchShow Displays the fabric switch state structure information. Synopsis fabswitchshow Description Use this command to display the fabric switch state structure information. This command is strictly for debugging; it is not intended as a user command. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 166: Fandisable
fanDisable fanDisable Disables a fan unit. Synopsis fandisable unit Description Use this command to disable a non-faulty fan unit by setting the RPM speed to 0. Notes This command is not available on non-bladed systems except for the Brocade 4100 and 4900. The execution of this command is subject to Admin Domain restrictions that may be in place.
Page 167: Fanenable
fanEnable fanEnable Enables a fan unit. Synopsis fanenable unit Description Use this command to set a previously disabled fan unit back to the default RPM speed. Notes This command is not available on non-bladed systems except for the Brocade 4100 and 4900. The execution of this command is subject to Admin Domain restrictions that may be in place.
Page 168: Fanshow
fanShow fanShow Displays fan status and speed. Synopsis fanshow Description Use this command to display the current status and speed of each fan in the system. Fan status is displayed as: Fan is functioning correctly. absent Fan is not present. below minimum Fan is present but rotating too slowly or stopped.
Page 169: Fastboot
fastboot fastboot Reboots the Control Processor (CP), bypassing Power-On Self-Tests (POST). Synopsis fastboot Description Use this command to immediately reboot the CP. This command is similar to reboot, but skips POST when the system comes back up, reducing boot time significantly. If POST was previously disabled using the diagDisablePost command, then fastboot is the same as reboot.
Page 170: Fastwritecfg
fastwritecfg fastwritecfg Enables or disables the FC fastwrite feature. Synopsis fastwritecfg action [slot] Description Use this command to configure FC fastwrite on a blade in a given slot. Fastwrite minimizes storage latency and improves the number of write transactions per second over long distances. A blade can be configured either to support FC fastwrite or FCIP (default supported when FC fastwrite is disabled).
Page 171 fastwritecfg Continue (Y,y,N,n): [ n] To disable FC fastwrite: switch:admin> fastwritecfg disable 7 !!!! WARNING !!!! Disabling this feature requires power-cycling of the affected blade to take effect and may take up to 5 minutes to complete. Non-bladed switches will be rebooted.
Page 172: Fcipchiptest
fcipChipTest fcipChipTest Tests functionality of components in the FCIP complex. Synopsis fcipchiptest [--slot slotnumber][-testtype type][-unit number] Description Use this command to verify the internal registers and memory of the network processor, FCIP FPGA, compression processor, and GigPHY. Notes The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 173 fcipChipTest Diagnostics When a failure is detected, the test might report one or more of the following error messages: CHIP_TEST_ERR CHIP_TEST_CHIP_INIT_ERR CHIP_TEST_IMAGE_VER_ERR CHIP_TEST_TIMEOUT_ERR CHIP_TEST_HEARBEAT_ERR CHIP_TEST_INVALID_RESULT See Also fcipPathTest Fabric OS Command Reference 53-1000599-02...
Page 174: Fciphelp
fcipHelp fcipHelp Displays FCIP command information. Synopsis diaghelp Description Use this command to display a short description of fibre channel over IP (FCIP) commands. FCIP commands require an FCIP license. Operands none Examples To display FCIP command information: switch:admin> diaghelp fciphelp fastwritecfg Configure FC fastwrite feature...
Page 175: Fcippathtest
fcipPathTest fcipPathTest Tests the data path of the FCIP complex. Synopsis fcippathtest [--slot slotnumber][-unit number][-path mode][-nframes count][-length data_length] [-compress mode] Description Use this command to verify the data paths in the FCIP complex. All data path modes run tests by comparing Fibre Channel frames or data packets transmitted from and received by the network processor due to the designated loopback.
Page 176 fcipPathTest -compress mode Specifies the compression device for which to select or to bypass data compression for the test. By default, data compression is used. This setting is applicable only to path mode 1 and 2. Examples To run the test on slot 2 with PHY loopback sending 10 frames: switch:admin>...
Page 177: Fclunquery
fcLunQuery fcLunQuery Displays a list of LUN IDs and LUNs for all accessible targets. Synopsis fclunquery [-w wwn | -s] Description Use this command to display a list of LUN IDs and LUNs for all accessible targets. Notes The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 178: Fcping
fcPing fcPing Sends a Fibre Channel Extended Link Service (ELS) Echo request to a pair of ports. Synopsis fcping [-h -b -q][-n frames][-l length][-i wait][-p pattern] source destination Description Use this command to perform a zoning check between the source and destination. In addition, two Fibre Channel ELS requests are generated.
Page 179 fcPing Examples To display one device that accepts the request and another device that rejects the request: switch:admin> fcping 10:00:00:00:c9:29:0e:c4 21:00:00:20:37:25:ad:05 Source: 10:00:00:00:c9:29:0e:c4 Destination: 21:00:00:20:37:25:ad:05 Zone Check: Not Zoned Pinging 10:00:00:00:c9:29:0e:c4 [0x20800] with 12 bytes of data: received reply from 10:00:00:00:c9:29:0e:c4: 12 bytes time:1162 usec received reply from 10:00:00:00:c9:29:0e:c4: 12 bytes time:1013 usec received reply from 10:00:00:00:c9:29:0e:c4: 12 bytes time:1442 usec received reply from 10:00:00:00:c9:29:0e:c4: 12 bytes time:1052 usec...
Page 180: Fcplogclear
fcpLogClear fcpLogClear Clears the FCPD debug information log. Synopsis fcplogclear Description Use this command to clear the debug information logged by the Fibre Channel Protocol daemon (FCPD). Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 181: Fcplogdisable
fcpLogDisable fcpLogDisable Disables the FCPD debug information log (debug command). Synopsis fcplogdisable Description Use this command to disable the logging of debug information by the Fibre Channel Protocol daemon (FCPD). Notes The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 182: Fcplogenable
fcpLogEnable fcpLogEnable Enables the FCPD debug information log (debug command). Synopsis fcplogenable Description Use this command to enable Fibre Channel Protocol daemon (FCPD) logging. Debug information logging is enabled by default. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 183: Fcplogshow
fcpLogShow fcpLogShow Displays the FCPD debug information log (debug command). Synopsis fcplogshow Description Use this command to display the debug information logged at various stages during the Fibre Channel Protocol daemon (FCPD) device probing. Notes The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 184: Fcpprobeshow
fcpProbeShow fcpProbeShow Displays the Fibre Channel Protocol (FCP) probe information. Synopsis fcpprobeshow [slotnumber/]portnumber Description 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.
Page 185: Fcprlsshow
fcpRlsShow fcpRlsShow Displays the Fibre Channel Protocol (FCP) Read Link Status (RLS) information. Synopsis fcprlsshow [slotnumber/]portnumber Description Use this command to display the FCP RLS information for the specified F_Port or FL_Port. This information describes the number of loss-of-signal, loss-of-sync, CRC-error, and other failure events that have been detected on this port.
Page 186: Fcrbcastconfig
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 Use this command to enable or disable the broadcast frame option or to display the current configuration.
Page 187 fcrBcastConfig To display the new configuration: switch:admin> fcrbcastconfig show Broadcast configuration is disabled for: fid 2 fid 128 SEE ALSO bcastshow, portRouteShow Fabric OS Command Reference 53-1000599-02...
Page 188: Fcrchiptest
fcrChipTest fcrChipTest Tests the functionality of FC Router FPGA. Synopsis fcrchiptest [--slot slotnumber] [-unit number] [-testtype type] Description Use this command to test the FC Router Field-programmable gate array (FPGA). This test verifies that all SRAM and register data bits in each ASIC can be independently written and read successfully.
Page 189 fcrChipTest switch:admin> fcrchiptest slot 7 -unit 1 -testtype 0 Running fcrchiptest ....Test Complete: fcrchiptest Pass 1 of 1 Duration 0 hr, 0 min & 4 sec (0:0:4:351). passed. Diagnostics When a failure is detected, the test might report one or more of the following: DMA_ALLOC_FAIL DMA_READ_ABORT DMA_READ_TIMEOUT...
Page 190: Fcrconfigure
fcrConfigure fcrConfigure Sets FC Router configuration parameters. Synopsis fcrconfigure Description Use this command to configure the FC Router parameters for this platform. This is an interactive command. This command cannot execute on a system with the FC Router feature enabled. First disable FC routing by using fosConfig or disable the switch with switchDisable.
Page 191: Fcrfabricshow
fcrFabricShow fcrFabricShow Displays the FC Routers on a backbone fabric. Synopsis fcrfabricshow 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.
Page 192: Fcrlsancount
fcrLsanCount fcrLsanCount Displays or sets the maximum LSAN count. Synopsis fcrlsancount [max-lsan-count] Description Use this command to set or display the maximum number of LSAN zones that can be configured on the edge fabric. By default, the maximum LSAN count is set to 3000, which is also the minimum. This command lets you create more LSANs on your edge fabric, up to 5000, if needed to support additional devices.
Page 193: Fcrlsanmatrix
fcrLsanMatrix fcrLsanMatrix Creates, edits and displays LSAN fabric or FCR matrix information, which binds the LSAN Zone and device database information to specified edge fabric IDs or FCRs. Synopsis fcrlsanmatrix fcrlsanmatrix --add -lsan FID FID | -fcr wwn wwn fcrlsanmatrix --remove -lsan FID FID | -fcr wwn wwn fcrlsanmatrix --apply -lsan | -fcr | -all fcrlsanmatrix --cancel -lsan | -fcr | -all fcrlsanmatrix --display -lsan | -fcr | -all...
Page 194 fcrLsanMatrix • Display the information saved in the cache. • Clear the information from the cache and revert to the saved value. • Display the information that is saved in the persistent memory (CLI command with no option). • Display the static and default/dynamic binding of the backbone to show which edge fabrics or FCRs can access each other.
Page 195 fcrLsanMatrix switch:admin > fcrlsanmatrix --add 10 19 To remove an entry: switch:admin > fcrlsanmatrix --remove 10 14 To display the information from the cache: switch:admin > fcrlsanmatrix --display Fabric ID 1 Fabric ID 2 ------------------------------------ To apply the changes persistently: switch:admin >...
Page 196 fcrLsanMatrix 10:32:16:91:25:dd:d0:03 08f001 520f00 Imported 10:00:00:06:2b:0d:29:30 01f002 4e1400 Imported 10:00:00:06:2b:0d:2f:ed 03f002 480200 Imported 10:00:00:06:2b:0d:33:4d 01f001 4e1800 Imported 10:00:00:06:2b:0e:4d:c9 03f001 482000 Imported Total devices displayed: 12 To display the information from the cache: switch:admin > fcrlsanmatrix --display -lsan Fabric ID 1 Fabric ID 2 -------------------------------------- To apply the changes persistently:...
Page 197 fcrLsanMatrix • In a dual backbone configuration, execute fcrlsanmatrix --fabricview on the FCR switches to confirm that the shared edge fabric FIDs have the same access in both backbones. • Execute fcrlsanmatrix --display -lsan | -fcr and fcrproxydevshow -a Check that the LSAN binding matrix in the cache is not in conflict with the existing import/export devices that are displayed on the FCR switch.
Page 198: Fcrpathtest
fcrPathTest fcrPathTest Tests the data path connection between the FC Router FPGA and the central ASIC. Synopsis fcrpathtest [--slot slotnumber][-unit number][-path mode][-nframes count] Description Use this command to verify the data path connecting the FC Router field-programmable gate array (FPGA) and the central ASIC by sending frames from the FC Router FPGA port N’s transmitter, and looping the frames back into the same port N’s receiver.
Page 199 fcrPathTest RANDOM0x25, 0x7f, 0x6e, 0x9a, ... Notes The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions" and Appendix A, "Command Availability" for details. This command is supported only on Brocade FR4-18i blades and Brocade 7500 platforms. Operands This command has the following operands: --slot slotnumber...
Page 200: Fcrphydevshow
fcrPhyDevShow fcrPhyDevShow Displays the FC Router physical device information. Synopsis fcrphydevshow [-a][-f fabricid][-w wwn][-c][-d] Description Use this command to display the physical (real) devices that are configured to be exported to other fabrics. A device is considered to be configured to be exported to another fabric if it is a member of an LSAN zone.
Page 201 fcrPhyDevShow Examples To display the physical devices relevant to this FC Router: fcr:admin> fcrphydevshow Device Physical Exists in Fabric ----------------------------------------- 10:00:00:00:c9:2b:6a:68 c70000 50:05:07:65:05:84:09:0e 0100ef 50:05:07:65:05:84:0b:83 0100e8 Total devices displayed: 3 See Also fcrFabricShow, fcrProxyDevShow, fcrRouteShow, lsanZoneShow, switchShow Fabric OS Command Reference 53-1000599-02...
Page 202: Fcrproxyconfig
fcrProxyConfig fcrProxyConfig Displays or configures proxy devices presented by an FC Router. Synopsis fcrproxyconfig [-s importedFID devWWN slot][-r importedFID devWWN] Description Use this command to display or set the persistent configuration of proxy devices presented by the local FC Router. If no optional operand is provided, the command displays the persistent proxy device configuration;...
Page 203 fcrProxyConfig “WWN does not exist in any proxy device slot” is displayed if the WWN does not exist in any slot for the specified edge fabric. “Too many proxy slots configured. Remove some unused proxy device WWNs from their slots using the -r operand and try again.” is displayed if all slots are used for the specified edge fabric.
Page 204: Fcrproxydevshow
fcrProxyDevShow fcrProxyDevShow Displays FC Router proxy device information. Synopsis fcrproxydevshow [-a][-f fabricid][-w wwn] Description Use this command to display the proxy devices presented by FC Router EX_Ports and information about the proxy devices. A proxy device is a virtual device presented in to a fabric by an FC Router. A proxy device represents a real device on another fabric.
Page 205 fcrProxyDevShow Examples To display the physical devices relevant to this FC Router: switch:admin> fcrphydevshow Device Physical Exists in Fabric ----------------------------------------- 10:00:00:00:c9:2b:6a:68 c70000 50:05:07:65:05:84:09:0e 0100ef 50:05:07:65:05:84:0b:83 0100e8 Total devices displayed: 33 See Also fcrFabricShow, fcrProxyDevShow, fcrRouteShow, lsanZoneShow, switchShow Fabric OS Command Reference 53-1000599-02...
Page 206: Fcrresourceshow
fcrResourceShow fcrResourceShow Displays FC Router physical resource usage. Synopsis fcrresourceshow Description Use this command to display the FC Router-available resources. The maximum number allowed versus the currently used is displayed for 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.
Page 207 fcrResourceShow Operands none Examples To display the resource usage for the local FC Router: switch:Admin> fcrresourceshow Daemon Limits: Max Allowed Currently Used ---------------------------------- LSAN Zones: 1000 LSAN Devices: 10000 1208 Proxy Device Slots: 10000 WWN Pool Size Allocated ---------------------------------- Phantom Node WWN: 8192 3790 Phantom Port WWN:...
Page 208: Fcrrouterportcost
fcrRouterPortCost fcrRouterPortCost Displays FC Router route information. Synopsis fcrrouterportcost [[slotnumber/]portnumber] [cost] Description Use this command to set or display the cost of the router ports. The cost of the link is a dimensionless positive number (which can be 0 or 1000 or 10000). The router module chooses the router port path based on the minimum cost per FID connection.
Page 209 fcrRouterPortCost To display the cost of one EX_Port: switch:admin> fcrrouterportcost 7/10 Port Cost ------------------------ 7/10 1000 To set the cost of an EX_Port: switch:admin> fcrrouterportcost 7/10 10000 See Also switchShow, fcrRouteShow, portCfgEXPort Fabric OS Command Reference 53-1000599-02...
Page 210: Fcrrouteshow
fcrRouteShow fcrRouteShow Displays FC Router route information. Synopsis fcrrouteshow Description Use this command to display routes through the FC Router backbone fabric to accessible destination fabrics. An FC Router backbone fabric is the fabric that contains the E_Ports of this platform and routes inter-fabric traffic between imported fabrics, creating a meta-SAN.
Page 211: Fcrxlateconfig
fcrXlateConfig fcrXlateConfig Displays or persistently configures a translate (xlate) domain ID for both the EX_Port-attached fabric and the backbone fabric. Synopsis fcrxlateconfig importedFabricID exportedFabricID preferredDomainID fcrxlateconfig [-r] importedFabricID exportedFabricID Description Use this command to display a translate domain ID or change the preferred domain ID. A translate domain is a phantom domain created by an FC Router.
Page 212 fcrXlateConfig importedFabricID Specifies the fabric ID (1 through 128) of the fabric that contains the translate domain. exportedFabricID Specifies the fabric ID (1 through 128) of the remote fabric represented by this translate domain. preferredDomainID Specifies the preferred domain ID (1 through 239) of the translate phantom. Examples To display the translate domain configuration: switch:admin>...
Page 213: Fddcfg
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.
Page 214 fddCfg To set the Fabric-Wide Consistency Policy as tolerant, omit the "S". A valid policy set should be of the form "SCC:S;DCC;FCS". To set the fabric-wide policy to NULL (default) or no fabric-wide consistency, use the policy Set "". Supported policies are Switch Connection Control (SCC), Device Connection Control (DCC), and Fabric Configuration Server (FCS).
Page 215: Fdmicacheshow
fdmiCacheShow fdmiCacheShow Displays abbreviated remote FDMI device information, according to remote domain ID. Synopsis fdmicacheshow Description Use this command to display FDMI cache information for remote domains only. The state of each remote domain, identified by its domain ID, is shown to be unknown, known, unsupported, or error.
Page 216: Fdmishow
fdmiShow fdmiShow Displays detailed FDMI device information. Synopsis fdmishow Description Use this command to display FDMI information for all HBAs and ports. Detailed FDMI information is displayed for local HBAs and ports. This information includes the HBA with its corresponding ports, along with their respective attributes. Only abbreviated FDMI information is shown for HBA and ports on remote switches.
Page 217: Ficonclear
ficonClear ficonClear Clears the records from the specified FICON database. Synopsis ficonclear database Description Use this command to remove records from the local FICON database. The command effect depends on the specified database. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, “Understanding Admin Domain Restrictions”...
Page 218: Ficoncupset
ficonCupSet ficonCupSet Sets FICON-CUP parameters for a switch. Synopsis ficoncupset fmsmode enable | disable ficoncupset modereg bitname 0 | 1 ficoncupset MIHPTO seconds 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.
Page 219 ficonCupSet To set the ASM bit in the mode register for the switch: switch:admin> ficoncupset modereg ASM 1 Active=Saved Mode bit is set to 1 To set the MIHPTO value to 60 seconds: switch:admin> ficoncupset MIHPTO 60 MIHPTO has been changed to 60 seconds See Also ficonCupShow Fabric OS Command Reference...
Page 220: Ficoncupshow
ficonCupShow ficonCupShow Displays FICON-CUP parameters for a switch. Synopsis ficoncupshow fmsmode ficoncupshow modereg [bitname] ficoncupshow MIHPTO Description Use this command to display FICON-CUP (Control Unit Port) parameters for a switch. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 221 ficonCupShow To display the ASM bit in the mode register for the switch: switch:user> ficoncupshow modereg ASM To display the MIHPTO value for the CUP: switch:user> ficoncupshow MIHPTO MIHPTO for the CUP: 60 seconds See Also ficoncupset Fabric OS Command Reference 53-1000599-02...
Page 222: Ficonhelp
ficonHelp ficonHelp Displays a list of FICON support commands. Synopsis ficonhelp Description Use this command to display a list of FICON support commands with descriptions. Operands none Examples To display a list of FICON commands: switch:admin> ficonhelp ficonclear Clears contents of the specified FICON management database ficoncupset Sets FICON-CUP parameters for a switch ficoncupshow...
Page 223: Ficonshow
ficonShow ficonShow Displays the contents of the specified FICON database. Synopsis ficonshow database [fabric] where database is one of the following: ficonshow RNID [fabric] ficonshow LIRR [fabric] ficonshow SwitchRNID [fabric] ficonshow RLIR [fabric] ficonshow ILIR [fabric] Description Use this command to display the contents of a FICON database. The ficonShow database operand is the name of the database to display.
Page 224 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.
Page 225 ficonShow 0xe0 Vendor-specific. Byte BB 0x00 Unspecified class. 0x01 Direct access storage device, if it is a storage port; otherwise, not channel-to-channel capable. 0x02 Magnetic tape, if it is a storage port; otherwise, a reserved field for a channel port. 0x03 Input unit record, if it is a storage port;...
Page 226 ficonShow Protocol Displays whether the traffic is using FICON or FCP. Registered Node WWN Displays the device's node World Wide Name associated with the device HBA. Registered Port WWN Displays the device's channel or storage CU port World Wide Name associated with the device HBA.
Page 227 ficonShow Sequence Number: 0000000169CA tag: 102b {Fmt Type PID Registered Port WWN Registered Node WWN flag Parm 0x18 N 502e00 50:05:07:64:01:40:0f:ca 50:05:07:64:00:c1:69:ca 0x10 0x200105 Type number: 002064 Model number: Manufacturer: Plant of Manufacture: 02 Sequence Number: 0000000169CA tag: 052e To display the local and remote LIRR database: switch:admin>...
Page 228 ficonShow Plant of Manufacture: 02 Sequence Number: 0000000169CA tag: 2e00 Switch Port WWN Switch Node WWN Flag Node Parameters 20:2e:00:60:69:80:1e:4e 10:00:00:60:69:80:1e:4e 0x00 0x200a2e Switch Part Number: 060-0001501-05 Switch Serial Number: 0FT02X801E4E Domain: 20480 The local RLIR database has 1 entry. To display the local ILIR database: switch:user>...
Page 229: Fipscfg
fipsCfg fipsCfg Configures FIPS (Federal Information Processing Standards) mode. Synopsis fipscfg --enable [fips | selftests] fipscfg --disable [fips | selftests] fipscfg --zeroize fipscfg --show | --showall fipscfg --force fips fipscfg --verify fips fipscfg --disable | --enable bootprom Description Use this command to configure FIPS mode in the switch. In this mode, only FIPS-compliant algorithms are allowed.
Page 230 fipsCfg --force fips This option enables FIPS mode even if prerequisites are not met, except under the following two conditions: 1. In a dual-CP system if HA is not in sync between the two CPs. 2. If selftests is in a disabled state. --verify fips This option runs through the prerequisites for enabling FIPS and print the failure/success cases.
Page 231 fipsCfg To enable FIPS after prerequisites have been met: switch:admin> fipscfg --enable fips FIPS mode has been set to : Enabled Please reboot the system switch:admin> fipscfg --show FIPS mode is : Enabled See Also none Fabric OS Command Reference 53-1000599-02...
Page 232: Firmwarecommit
firmwareCommit firmwareCommit Commits switch firmware. Synopsis firmwarecommit Description Use this command to commit a firmware download to a CP. This command copies an updated firmware image to the secondary partition and commits both partitions of the CP to an updated version of the firmware.
Page 233: Firmwaredownload
firmwareDownload firmwareDownload Downloads firmware from a remote host, a local directory, or a USB device. Synopsis To invoke the command in interactive mode: firmwaredownload To download FOS firmware over a network: firmwaredownload [ -s [ -b | -n ] ] [ -p ftp | scp ] [ -c ] [ -o ] host, user, pfile, passwd To download SAS/SA firmware over a network: firmwaredownload -a sas | dmm | application [ -t slotnumber(s) ] [ -p ftp | scp ] [ -c ] [ -o ] host, user, pfile, passwd...
Page 234 firmwareDownload For each non-director-class platform in your fabric, complete all firmware download changes before issuing the firmwareDownload command on the next switch to ensure a nondisruptive download. If firmwareDownload is interrupted due to an unexpected reboot as a result of a software error or power failure, the command automatically recovers the corrupted secondary partition.
Page 235 firmwareDownload pfile Specify a fully qualified path for the firmware pfile. Absolute path names may be specified using forward slashes (/). passwd Specify a password. This operand can be omitted, if the firmware is accessible through a local directory or an attached USB device, or if no password is required by the FTP server.
Page 236 firmwareDownload Do you want to continue [Y]: y The firmware is being downloaded to the Standby CP. It may take up to 10 minutes. To download the firmware to both CPs on a dual-CP chassis with an attached USB device. (You would execute the same command on a single CP processor with USB support.
Page 237 firmwareDownload WARNING: YOU HAVE ELECTED TO DISABLE THE VERSION COMPATIBILITY CHECKING FEATURE. THIS CAN CAUSE THE VIRTUALIZATION SERVICES TO STOP WORKING. If you want to check the version compatibility, please exit and re-enter this command without the "-c" option. Do you want to continue [Y]: y To download SAS firmware and remove the installed SA image at the same time: switch:admin>...
Page 238: Firmwaredownloadstatus
firmwareDownloadStatus firmwareDownloadStatus Displays the status of a firmware download. Synopsis firmwaredownloadstatus Description Use this command to display an event log that records the progress and status of events during FOS, SAS, and SA firmwaredownload. The event log is created by the current firmwaredownload command and is kept until another firmwaredownload command is issued.
Page 239 firmwareDownloadStatus To display the status of a firmware download on a switch: switch:admin> firmwaredownloadstatus [1]: Fri Feb 15 22:17:03 2007 Firmware is being downloaded to the switch. This step may take up to 30 minutes. [2]: Fri Feb 15 22:20:54 2007 Firmware has been downloaded to the secondary partition of the switch.
Page 240 firmwareDownloadStatus Slot 8 (FR4-18i): Firmware commit has started on the blade. This may take up to 10 minutes. [10]: Mon Dec 19 18:50:51 2007 Slot 8 (FR4-18i): The commit operation has completed successfully. [11]: Mon Dec 19 18:55:39 2007 Slot 5 (CP0, active): Firmware has been downloaded successfully on Standby CP. [12]: Mon Dec 19 18:55:46 2007 Slot 5 (CP0, active): Standby CP reboots.
Page 241: Firmwarekeyshow
firmwareKeyShow firmwareKeyShow Displays the public key used for signed firmware validation. Synopsis firmwarekeyshow Description This command displays the contents of the public key used for validating the integrity of firmware images when signed firmware validation is enabled. Notes 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.
Page 242: Firmwarekeyupdate
firmwareKeyUpdate firmwareKeyUpdate Updates the public key used for signed firmware validation. Synopsis firmwarekeyupdate firmwarekeyupdate [-p ftp|scp] host,user,keyfile,passwd firmwarekeyupdate -U keyfile Description Use this command to update the public key used for firmware signature validation. The firmware key can be updated over the network, or, if the switch supports this option, from an attached USB device.
Page 243 firmwareKeyUpdate user Specify a user name for FTP or SSH server access. This operand can be omitted, if the firmware key is accessible on a local directory or by anonymous FTP server access. A user name other than “anonymous” is required for SSH server access.
Page 244: Firmwarerestore
firmwareRestore firmwareRestore Restores the former active firmware image. Synopsis firmwarerestore Description Use this command to restore the former active Fabric OS firmware image. This command can only be run if autocommit was disabled during the firmwaredownload. This command cannot be used to restore SAS and SA images.
Page 245: Firmwareshow
firmwareShow firmwareShow Displays the Fabric OS versions on all firmware partitions in the system. Synopsis firmwareshow Description Use this command to display the FOS, SAS, and SA firmware versions. The command shows the firmware versions on both the primary and secondary partitions of the storage device. Note The execution of this command is subject to Admin Domain restrictions that may be in place.Refer to chapter 1, “Understanding Admin Domain Restrictions”...
Page 246: Fosconfig
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. The following features are supported (see Notes for limitations): •...
Page 247 fosConfig --disable feature Disables a feature on the switch. This command can be run while the switch is online. Valid values for feature are: 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. If there is an XPath OS switch in the BB fabric, it may take up to eight minutes to complete the disable process.
Page 248: Frureplace
fruReplace fruReplace Provides an interactive interface to help replace a field replaceable unit (FRU). Synopsis frureplace fru Description Use this command to replace a FRU. The command automatically performs the necessary backup and restore operations to accommodate the replacement. Note The execution of this command is subject to Admin Domain restrictions that may be in place.
Page 249: Fspfshow
fspfShow fspfShow Displays Fabric Shortest Path First (FSPF) protocol information. Synopsis fspfshow Description Use this command to display the FSPF protocol information and internal data structures of the FSPF module. The following fields display.: TABLE 11 fspfShow display fields Field Description version Version of FSPF protocol.
Page 250 fspfShow Examples To display FSPF protocol information: switch:admin> fspfshow version domainID = 131 switchOnline = TRUE domainValid = TRUE isl_ports[0] = 0x00000000 isl_ports[1] = 0x74000000 trunk_ports[0] = 0x00000000 trunk_ports[1] = 0x02000000 f_ports[0] = 0x00400000 f_ports[1] = 0x00000000 seg_ports[0] = 0x00000000 seg_ports[1] = 0x00000000 active_ports[0] = 0x00400000...
Page 251: Fwalarmsfilterset
fwAlarmsFilterSet fwAlarmsFilterSet Enables or disables alarms for Fabric Watch. Synopsis fwalarmsfilterset [mode] Description Use this command to configure alarm filtering for Fabric Watch. By turning off the alarms, all non-environment class alarms are suppressed. By turning on the alarms, all class alarms are generated.
Page 252: Fwalarmsfiltershow
fwAlarmsFilterShow fwAlarmsFilterShow Displays alarm filtering for Fabric Watch. Synopsis fwalarmsfiltershow Description Use this command to display whether alarm filtering is enabled or disabled. Notes This command requires a Fabric Watch license. The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 253: Fwclassinit
fwClassInit fwClassInit Initializes all classes under Fabric Watch. Synopsis fwclassinit Description Use this command to initialize all classes under Fabric Watch. The command should only be used after installing a Fabric Watch license to start licensed Fabric Watch classes. Refer to fwConfigure for a list of classes.
Page 254: Fwconfigreload
fwConfigReload fwConfigReload Reloads the Fabric Watch configuration. Synopsis fwconfigreload Description Use this command to reload the Fabric Watch configuration. This command should only be used after downloading a new Fabric Watch configuration file from a host. Notes This command requires a Fabric Watch license. The execution of this command is subject to Admin Domain restrictions that may be in place.
Page 255: Fwconfigure
fwConfigure fwConfigure Displays and modifies the Fabric Watch configuration. Synopsis fwconfigure fwconfigure --enable --port portNumber fwconfigure --disable --port portNumber Description Use this command to display and modify threshold information for the Fabric Watch configuration. Switch elements monitored by Fabric Watch are divided into classes, which are further divided into areas.
Page 256 fwConfigure TABLE 12 fwConfigure Fabric Watch classes and areas Class Area Fabric E_Port downs Fabric reconfigure Domain ID changes Segmentation changes Zone changes Fabric<->QL Fabric logins SFP state changes E_Port Link loss (E-port) Sync loss (E-port) Signal loss (E-port) Protocol error (E-port) Invalid words (E-port) Invalid CRCS E-port) RXPerformance (E-port)
Page 257 fwConfigure In Access Gateway mode, only the following classes are supported. F/FL_Port (Copper) class is supported only on Embedded platforms. TABLE 13 Access Gateway mode Class Area Environmental Temperature Fan* Power Supply* Temperature Current Voltage Port Link failure Sync loss Signal loss Protocol error Invalid words...
Page 258 fwConfigure --disable --port portNumber Disables all thresholds associated with a certain port. Examples To configure thresholds in Fabric OS mode: switch:admin> fwconfigure 1 : Environment class 2 : SFP class 3 : Port class 4 : Fabric class 5 : E-Port class 6 : F/FL Port (Optical) class 7 : Alpa performance Monitor class 8 : EE performance Monitor class...
Page 259 fwConfigure 3 : Power Supply 4 : return to previous page Select an area => : (1..4) [4] 1 Index ThresholdName Status CurVal LastEvent LasteventTime LastVal LastState ================================================================================ 1 envTemp001 enabled 23 C inBetween Sat Oct7 10:01:53 2006 21 C In_Range 2 envTemp002 enabled 24 C inBetween Sat Oct 7 10:01:53 2006 21 C In_Range 1 : refresh...
Page 260: Fwfrucfg
fwFruCfg fwFruCfg Displays or modifies FRU state alert configuration. Synopsis fwfrucfg [--show] Description Use this command to configure field-replaceable unit (FRU) states and actions. Based on these configuration settings, Fabric Watch generates action when a FRU state changes. To configure email alerts, use fwMailCfg.
Page 261: Fwhelp
fwHelp fwHelp Displays Fabric Watch command information. Synopsis fwhelp Description Use this command to display the commands that configure Fabric Watch. Operands none Examples To display a summary of Fabric Watch commands: switch:user> fwhelp fanShow Print fan Status fwAlarmsFilterSet Configure alarms filtering for Fabric Watch fwAlarmsFilterShow Show alarms filtering for Fabric Watch fwClassInit...
Page 262: Fwmailcfg
fwMailCfg fwMailCfg Displays and configures Fabric Watch email alerts. Synopsis fwmailcfg Description Use this command to display or modify the configuration and status of the Fabric Watch email alert in the switch. Switch elements monitored by Fabric Watch are divided into classes, and email alerts are based on the classes.
Page 263 fwMailCfg : Show Mail Configuration Information : Disable Email Alert : Enable Email Alert : Send Test Mail : Set Recipient Mail Address for Email Alert : Relay Host IP Configuration : Quit Select an item => : (1..7) [7]5 Mail Config Menu -------------------------------------- : Environment class...
Page 264: Fwportdetailshow
fwPortDetailShow fwPortDetailShow Displays the port information for specified user ports. Synopsis fwportdetailshow [--p portNumber] | [--s portState] Description Use this command to print the overall status of a specified port. The output of this command is different for IPv4 and IPv6 addresses. The overall status is calculated based on the following contributors: Port Errors: Number of link loss occurrences exceeded limit for time period...
Page 265 fwPortDetailShow --s portState Yields a port detail report for the specified portState. Valid portState entries are: Report based on all healthy ports Report based on all marginal ports Report based on all faulty ports Report based on all offline ports If no option is specified, all ports are displayed.
Page 266 fwPortDetailShow To retrieve a port detailed report: switch:user> fwportdetailshow Port Detail Report Report time: 05/21/2007 11:22:58 PM Switch Name: switch IP address: 192.168.163.237 Port Exception report [by Healthy] --------Port-Errors------------ -----SFP-Errors---- Port# Type State Dur(H:M) LFA LSY LSI PER INW CRC PSC BLP STM SRX STX SCU SVO ----------------------------------------------------------------------------- HEALTHY 409:09...
Page 267: Fwsamshow
fwSamShow fwSamShow Generates switch availability monitor (SAM) report. Synopsis fwsamshow Description Use this command to display a switch availability monitor (SAM) report. This report displays uptime and downtime for each port and enables you to check if a particular port is failing more often than the others.
Page 268 fwSamShow See Also portShow, switchShow Fabric OS Command Reference 53-1000599-02...
Page 269: Fwset
fwSet fwSet Sets the parameters controlled by Fabric Watch. Synopsis fwset --port --persistence seconds Description Use this command to set parameters controlled by Fabric Watch. It allows you to set the port persistence time (time in which a port must persistently be in a marginal state before being labeled as such).
Page 270: Fwsettocustom
fwSetToCustom fwSetToCustom Sets boundary and alarm levels to custom values. Synopsis fwsettocustom Description Use this command to set boundary and alarm levels to custom values for all classes and areas in Fabric Watch. Fabric Watch uses two types of settings: factory default settings and user-defined custom settings. •...
Page 271 fwSetToCustom 1 : Temperature 2 : Fan 3 : Power Supply 4 : return to previous page Select an area => : (1..4) [4] 1 Index ThresholdName Status CurVal LastEvent LasteventTime LastVal LastState ================================================================================ envTemp001 enabled 24 C inBetween Thu Feb 14 01:21:36 2008 24 C In_Range envTemp004...
Page 272 fwSetToCustom : change custom buffer 18 : return to previous page : apply threshold boundary changes 10 : cancel threshold boundary changes Select choice => : (1..18) [18] See Also fwSetToDefault, fwConfigure, fwHelp, fwShow Fabric OS Command Reference 53-1000599-02...
Page 273: Fwsettodefault
fwSetToDefault fwSetToDefault Returns boundary and alarm levels to the default values. Synopsis fwsettodefault Description Use this command to return boundary and alarm levels to defaults for all classes and areas in Fabric Watch. Fabric Watch uses two types of settings: factory default settings and user-defined custom settings. •...
Page 274 fwSetToDefault 3 : Power Supply 4 : return to previous page Select an area => : (1..4) [4] 1 Index ThresholdName Status CurVal LastEvent LasteventTime LastVal LastState ================================================================================ envTemp001 enabled 24 C inBetween Thu Feb 14 01:21:36 2008 24 C In_Range envTemp004 enabled...
Page 275 fwSetToDefault 10 : cancel threshold boundary changes Select choice => : (1..18) [18] See Also fwSetToCustom, fwConfigure, fwHelp, fwShow Fabric OS Command Reference 53-1000599-02...
Page 276: Fwshow
fwShow fwShow Displays the class thresholds monitored by Fabric Watch. Synopsis fwshow [--port --persistence] | [--disable --port] Description Use this command to display the thresholds monitored by Fabric Watch. This command also displays the port persistence time and ports with all disabled thresholds. For a description of the class thresholds supported in Fabric OS and the restrictions that apply to some of the classes in terms of support for V/VE/VEX ports and GbE ports, refer to the help page for fwConfigure or consult the Fabric Watch Administrator's Guide.
Page 277 fwShow : E-Port class : F/FL Port (Optical) class : Alpa Performance Monitor class : End-to-End Performance Monitor class : Filter Performance Monitor class 10 : Security class 11 : Resource class 12 : Quit => : (1..12) [12] 1 Select an item 1 : Temperature 2 : Fan...
Page 278 fwShow Event 1 occurred 10 times, last at 16:49:02 on 12/09/2011 * Event 5 occurred 1 time, last at 16:30:23 on 12/09/2011 Callbacks: No callbacks are registered. To show port persistence time: switch:admin> fwshow --port --persistence FW: current port persistence time = 18s To display ports that have all thresholds disabled: switch:user>...
Page 279 Displays shell history. Synopsis history Description Use this command to view the shell history. The shell history mechanism is similar to the UNIX Korn shell history facility. The h command displays the 20 most recent commands typed into the shell; the oldest commands are replaced as new ones are entered.
Page 280: Hadisable
haDisable haDisable Disables the High Availability feature. Synopsis hadisable Description Use this command to disable the High Availability (HA) feature on a switch. If the HA feature is already disabled, this command does nothing. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, “Understanding Admin Domain Restrictions”...
Page 281: Hadump
haDump haDump Displays High Availability status information. Synopsis hadump Description Use this command to display information about the status of the High Availability (HA) feature on a switch. This command displays the following information: • Local CP state (slot number and CP ID) •...
Page 282 haDump Ethernet IP Address: 10.32.227.64 Ethernet Subnetmask: 255.255.240.0 Fibre Channel IP Address: 220.220.220.64 Fibre Channel Subnetmask: 255.255.240.0 Ethernet IP Address: 10.32.227.66 Ethernet Subnetmask: 255.255.240.0 Host Name: cp0 Gateway IP Address: 10.32.224.1 Ethernet IP Address: 10.32.227.67 Ethernet Subnetmask: 255.255.240.0 Host Name: cp1 Gateway IP Address: 10.32.224.1 Slot 10 eth0: 10.32.227.69/20...
Page 283: Haenable
haEnable haEnable Enables the High Availability feature. Synopsis haenable Description Use this command to enable the High Availability (HA) feature on a switch. If the HA feature is already enabled, this command does nothing. Note The execution of this command is subject to Admin Domain Restrictions that may be in place. Refer to chapter 1, “Understanding Admin Domain Restrictions”...
Page 284: Hafailover
haFailover haFailover Forces the failover mechanism so that the standby control processor (CP) becomes the active CP. Synopsis hafailover Description Use this command to force the failover mechanism to occur so that the standby CP becomes the active CP. In case the active and standby CPs are not synchronized or the system is not in redundant mode, the command aborts.
Page 285: Hashow
haShow haShow Displays control processor (CP) status. Synopsis hashow Description Use this command to display control processor status. The display includes: • Local CP state (slot number and CP ID), warm or cold, recovering or recovered • Remote CP state (slot number and CP ID) •...
Page 286 haShow switch:admin> hashow Local CP (Slot 6, CP1): Active, Warm Recovered Remote CP (Slot 5, CP0): Standby, Failed Backplane PCI fail, severity: CRITICAL HA enabled, Heartbeat Up, HA State not in sync See Also haDisable, haEnable, haFailover Fabric OS Command Reference 53-1000599-02...
Page 287: Hasyncstart
haSyncStart haSyncStart Enables High Availability state synchronization. Synopsis hasyncstart Description Use this command to enable the High Availability (HA) state synchronization. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, “Understanding Admin Domain Restrictions” and Appendix A, “Command Availability” for details.
Page 288: Hasyncstop
haSyncStop haSyncStop Disables High Availability state synchronization. Synopsis hasyncstop Description Use this command to temporarily disable High Availability (HA) synchronization. Notes Disabling HA synchronization may cause failover to be disruptive. The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, “Understanding Admin Domain Restrictions”...
Page 289: Help
help help Displays help information for commands. Synopsis help [command] Description Use this command without an operand to display an alphabetical list commands for which help is available. At the end of the list are some additional commands which display more lists of grouped commands for a particular subsystem;...
Page 290: Historylastshow
historyLastShow historyLastShow Displays the latest entry in the field replaceable unit (FRU) history log. Synopsis historylastshow Description 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.
Page 291: Historymode
historyMode historyMode Displays or sets the mode of the field replaceable unit (FRU) history log. Synopsis historymode [ rot | fi ] Description Use this command to display or set the mode of the history buffer, which records the insertion and removal of FRUs on a switch or chassis.
Page 292: Historyshow
historyShow historyShow Displays the entire field replaceable unit (FRU) history log. Synopsis historyshow Description Use this command to display the entire history log, which records insertion and removal events for field-replaceable units (FRUs), such as blades, power supplies, fans, and World Wide Name (WWN) cards.
Page 293 historyShow SW BLADE Slot 3 Removed at Tue Aug 14 12:10:09 2001 Factory Part Number: 60-0001532-03 Factory Serial Number: 1013456800 CP BLADE Slot 6 Removed at Tue Aug 14 13:45:07 2001 Factory Part Number: 60-0001604-02 Factory Serial Number: FP00X600128 SW BLADE Slot 3 Inserted at Tue Aug 14 13:53:40 2001 Factory Part Number:...
Page 294: Httpcfgshow
httpCfgShow httpCfgShow Displays the Java plug-in version. Synopsis httpcfgshow Description Use this command to display the version of the Java plug-in supported by Web Tools. This command also displays the URL from which the plug-in can be downloaded. Operands none Examples To display the Java plug-in version: switch:admin>...
Page 295 Displays a process summary. Synopsis i [processID] Description 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. Fields displayed with this command include those shown in Table TABLE 15 Command field description...
Page 296 Operands This command has the following operand: processID Specifies the process name or process ID for the process to display. Examples To display information about process ID 433: switch:admin> i 433 PPID C PRI NI ADDR WCHAN TTY TIME 000 S 1283 5c64 ? 00:00:02 fabricd...
Page 297: Iclcfg
iclCfg iclCfg Enables or disables Inter-chassis links (ICL). Synopsis iclcfg --enable slot/icl_group iclcfg --disable slot/icl_group iclcfg --help Description Use this command to enable or disable an inter-chassis link (ICL) on a Brocade DCX. The command enables or disables the ICL by enabling or disabling the ports associated with the link. This command is supported only on the Brocade DCX backbone.
Page 298: Ifmodeset
ifModeSet ifModeSet Sets the link operating mode for a network interface. Synopsis ifmodeset [“interface”] Description Use this command to set the link operating mode for a network interface. An operating mode is confirmed with a y or yes at the prompt. If the operating mode selected differs from the current mode, the change is saved and the command exits.
Page 299 ifModeSet Are you sure you really want to do this? (yes, y, no, n): [no] y Proceed with caution. Auto-negotiate (yes, y, no, n): [no] y Advertise 100 Mbps / Full Duplex (yes, y, no, n): [yes] y Advertise 100 Mbps / Half Duplex (yes, y, no, n): [yes] y Advertise 10 Mbps / Full Duplex (yes, y, no, n): [yes] y Advertise 10 Mbps / Half Duplex (yes, y, no, n): [yes] y Committing configuration...done.
Page 300: Ifmodeshow
ifModeShow ifModeShow Displays the link operating mode and MAC address for a network interface. Synopsis ifmodeshow interface Description Use this command to display the link operating mode and MAC address for a network interface. Operands This command has the following operand: interface Specify the name of the interface.
Page 301: Interfaceshow
interfaceShow interfaceShow Displays FSPF interface information. Synopsis interfaceshow [slotnumber/][portnumber] Description Use this command to display the two data structures associated with FSPF interfaces (E_Ports) on the switch: • The permanently allocated Interface Descriptor Block (IDB). • The neighbor data structure. This data structure is allocated when a switch port becomes an E_Port.
Page 302 interfaceShow remPort Port number on the remote switch connected to this port. nflags Internal FSPF flags. initCount Number of times this neighbor was initialized without the interface going down. lastInit Time of the last initializing state, NB_ST_INIT, on this interface. firstHlo Time of the first hello sent on this interface.
Page 303 interfaceShow attLsaOut Number of attempted transmissions of LSAs to the neighbor switch. nLsaOut Number of LSAs transmitted to the neighbor switch. Operands This command has the following operands: slotnumber For bladed systems only, specify the slot number of the port to display, followed by a slash (/).
Page 304 interfaceShow lsrRtxTID = 0x1008c848 inactTo = 80000 helloTo = 2000 rXmitTo = 5000 nCmdAcc nInvCmd nHloIn nInvHlo nLsuIn nLsaIn attHloOut nHloOut attLsuOut nLsuOut attLsaOut nLsaOut See Also nbrStateShow, portShow, switchShow Fabric OS Command Reference 53-1000599-02...
Page 305: Interopmode
interopMode interopMode Enables or disables Brocade switch interoperability with McDATA switches. Synopsis interopmode [mode [-z McDataDefaultZone] [-s McDataSafeZone]] Description Use this command to enable or disable Brocade switch interoperability with McDATA switches within a Brocade fabric. Fabric OS v6.0.0 introduces a new M-EOS-compatible McDATA Open Fabric Mode (interopMode 3) on all platforms that support McDATA Fabric Mode (interopmode 2).
Page 306 interopMode In v6.0.0, when McDATA Fabric interoperability mode is turned on, the OUI portion of the switch WWN is no longer replaced with a McDATA OUI. The Brocade OUI is used. However, upgrading from Fabric OS 5.2.1_NI to Fabric OS v6.0.0 will be non-disruptive, preserving the McDATA OUI and the given interopMode.
Page 307 interopMode To turn Safe Zone on while in interopmode 2: switch:admin> interopMode 2 -s 1 InteropMode: McDATA Fabric Default Zone: Safe Zone: To disable interoperability mode on a disabled switch: switch:admin> interopmode O Interop mode is disabled The switch effective configuration will be lost. The system will reboot to allow the change to take effect.
Page 308: Ioddelayreset
iodDelayReset iodDelayReset Resets the user-defined IOD delay settings to default values. Synopsis ioddelayreset domain_id Description Use this command to reset the user-defined IOD delay settings to default values (-1). This command resets IOD delay values for a specified domainID that was previously configured with the iodDelaySet command.
Page 309: Ioddelayset
iodDelaySet iodDelaySet Sets the delay for the in-order delivery (IOD). Synopsis ioddelayset domain_id iod_delay Description Use this command to configure the IOD delay time on a switch for a specified domain.This operation reduces the frame drops during the rebalance time frame that may occur when dynamic load sharing (DLS) is set.
Page 310: Ioddelayshow
iodDelayShow iodDelayShow Displays the user-defined IOD delay settings for specified domains. Synopsis ioddelayshow [ domain_id ] Description Use this command to display the user-defined IOD delay settings for all domains in the fabric or for a specified domain ID. This command only displays delay values for domain IDs, for which the IOD delay parameter has been previously set with the iodDelaySet command.
Page 311: Iodreset
iodReset iodReset Disables the in-order delivery (IOD) option. Synopsis iodreset Description 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. Disabling IOD allows faster re-routing after a fabric topology change, but it may cause out-of-order delivery of frames during fabric topology changes.
Page 312: Iodset
iodSet iodSet Enables the in-order delivery (IOD) option. Synopsis iodset Description Use this command to enforce in-order delivery of frames during a fabric topology change. In a stable fabric, frames are always delivered in order, even when the traffic between switches is shared among multiple paths.
Page 313: Iodshow
iodShow iodShow Displays the state of the in-order delivery (IOD) option setting. Synopsis iodshow Description Use this command to display whether the IOD option is enabled or disabled. The default setting for IOD is disabled. Operands none Examples To display the current setting of the IOD option: switch:admin>...
Page 314: Ipaddrset
ipAddrSet ipAddrSet Sets the IP address details for a switch, a control processor (CP), an intelligent blade processor (BP), or a standalone application processor (AP). Synopsis ipaddrset ipaddrset [-cp number | -sw number] ipaddrset [-ipv6 ] [--add x:x:x:x:x:x:x/n | --delete] ipaddrset [-cp number | -sw number] [-ipv6 ] [--add x:x:x:x:x:x:x/n | --delete] ipaddrset [-slot number] [-eth0 | -eth1] [--add x.x.x.x/n | --delete] ipaddrset [-slot number] -gate [--add x.x.x.x | --delete]...
Page 315 ipAddrSet 3. Additionally, the -eth0, -eth1, and -gate command line options are available with the --add or --delete option on platforms with blade processors to set the BP Ethernet or Gateway addresses. On an enterprise-class system with a blade processor the values for the blade in slot n can be set from the command line using the -slot option.
Page 316 ipAddrSet Examples To set the IPv4 addresses for switch number 1 on an enterprise-class system in interactive mode: switch:admin> ipaddrset -sw 1 Ethernet IP Address [192.168.166.148]: Ethernet Subnetmask [255.255.255.0]: Fibre Channel IP Address [none]: Fibre Channel Subnetmask [none]: Committing configuration...Done. To enable DHCP on a standalone, non-AP platform: switch:admin>...
Page 317: Ipaddrshow
ipAddrShow ipAddrShow Displays the IP address information for a switch or control processor (CP). Synopsis ipaddrshow [-cp cp_number] ipaddrshow [-sw sw_number] ipaddrshow - slot n ipaddrshow [-eth0 -eth1 -gate] Description Use this command to display the IP addresses configured in the system. The -cp option displays the CP IP address and the -sw option displays the switch IP addresses.
Page 318: Ipfilter
ipfilter ipfilter Manages the IP filter policies. Synopsis ipfilter --create policyname -type ipv4 | ipv6 ipfilter --clone policyname -from src_policyname ipfilter --show [policyname] ipfilter --save [policyname] ipfilter --activate policyname ipfilter --delete policyname ipfilter --addrule policyname -rule rule_number -sip source IP -dp dest port -proto protocol -act permit | deny ipfilter --delrule policyname -rule rule number ipfilter --transabort...
Page 319 ipfilter --create policyname -type ipv4 | ipv6 Creates an IP filter policy with the specified name and type. The policy created is stored in a temporary buffer and is lost if the policy is not saved to the persistent configuration. --clone policyname -from src_policyname Creates a replica of an existing IP filter policy.
Page 320 ipfilter The following arguments are supported with the --addrule option: -sip 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. For filters of type IPv6, the address must be a 12- bit IPv6 address in any format specified by RFC, or a CIDR-style IPv6 prefix.
Page 321 ipfilter Name: default_ipv6, Type: ipv6, State: active Rule Source IP Protocol Dest Port Action permit permit permit permit permit permit permit permit permit permit 600 - 1023 permit 600 - 1023 permit Name: ex1, Type: ipv6, State: defined (modified) Rule Source IP Protocol Dest Port...
Page 322 ipfilter To create an IPv4-type IP filter policy: switch:admin> ipfilter --create ex2 -type ipv4 To add a rule to the created policy “ex2”: switch:admin> ipfilter --addrule ex2 -sip 10.32.69.99 -dp 23 -proto tcp -act permit To display the IP filter policies, including the new policy: switch:admin>...
Page 323: Iscsicfg
iscsiCfg iscsiCfg Configures or displays iSCSI entities. Synopsis iscsicfg create auth -u username -s CHAP_secret [-h] iscsicfg --modify auth -u username -s CHAP_secret [-h] iscsicfg --delete auth -u username [-h] iscsicfg --clear auth [-h] iscsicfg --show auth [-u username] [-h] iscsicfg --easycreate tgt [-w port_wwn] [-h] iscsicfg --easycreate tgt -s iscsicfg --create tgt -t target_name [-h]...
Page 324 iscsiCfg iscsicfg --show transaction [-h] iscsicfg --clear all [-h] iscsicfg --commit all [-f] [-h] Description Use this command to configure all iSCSI entities (such as authentication (CHAP), discovery domains (DD), discovery domain sets (DDSet), iSCSI virtual targets (VT), and LUN maps). Common actions include --add, --delete, --modify, --show, --enable and --disable;...
Page 325 iscsiCfg --modify tgt -t target_name -a auth_method [-h] Associates the authentication method auth_method with the target. Valid values for auth_method are CHAP and none. If CHAP is specified, then either one-way or mutual CHAP is enforced, based on the login frame from the host. --addusername tgt -t target_name -u user_list [-h] Binds user names defined in AUTH database to the specific target.
Page 326 iscsiCfg --clear dd [-h] Deletes the DD and DDset databases. --show dd [-d dd_name] [-h] Displays the DD database; dd_name is optional. ddset Discovery Domain Set parameters. Actions on ddset are: --create ddset -n ddset_name -d dd_list [-h] Creates a DD set entry with the specified ddset_name and dd_list. The DDs in dd_list must already exist.
Page 327 iscsiCfg --commit all [-f] [-h] Commits the iSCSI configuration database to nonvolatile memory. Any modifications made to the database are not saved until an explicit --commit all is issued. If multiple switches in the fabric have uncommitted changes, this operation is rejected. The -f option needs to be used in this case to force the commit operation, in which case uncommitted changes on other switches are erased.
Page 328 iscsiCfg To bind user CHAP to a target: switch:admin> iscsicfg --addusername tgt-t iqn.2005-10.com.brocade.tgt1 -u user1 The operation completed successfully. To unbind user CHAP from a target: switch:admin> iscsicfg --deleteusername tgt -t iqn.2005-10.com.brocade.tgt1 -u user1 The operation completed successfully. To clear the target database: switch:admin>...
Page 329 iscsiCfg To display the DD database: switch:admin> iscsicfg --show dd Number of records found: 1 Name: mynewdd Status: Defined Num. Members: iqn.2222-23.mytest1 iqn.2343-58.newtest1 iqn.2222-23.mytest3 To create a DD set entry: switch:admin> iscsicfg --create ddset -n myddset -d mynewdd The operation completed successfully. To add a new member to an existing DD set (the new DD, iscsidd3, must exist already) switch:admin>...
Page 330 iscsiCfg To display the iSCSI initiators that attempted to log in: switch:admin> iscsicfg --show initiator Number of records found: 1 Name IP Address iqn.1991-05.com.brocade:initiator1 172.16.14.101 switch:admin> iscsicfg --show initiator -i iqn.1991-05.com.brocade:initiator1 Initiator details are: Name IP Address iqn.1991-05.com.brocade:isi154116.englab.brocade.com 172.16.14.101 No. of targets currently accessible to the specified initiator are: 4 iqn.2222-12.com.brocade:tgt1 iqn.2222-12.com.brocade:tgt2 iqn.2002-12.com.brocade:50:06:0e:80:00:43:80:a2...
Page 331: Iscsichiptest
iscsiChipTest iscsiChipTest Performs functional test of components in iSCSI complex. Synopsis iscsichiptest --slot slotnumber -testtype type -unit gbEports Description Use this command to verify the memory of the network processor and iFlipper FPGA. Note This command is supported only on the Brocade FR4-16IP blade. On all other platforms, this command displays the message: “Command not applicable to this platform.
Page 332: Iscsihelp
iscsiHelp iscsiHelp Displays a list of iSCSI support commands. Synopsis iscsihelp Description Use this command to display a list of iSCSI support commands with descriptions. Operands none Examples To display the list of iSCSI support commands: switch:admin> iscsihelp fclunquery Display a list of LUNs of FC target(s). fosconfig Enable/disable FabOS services iscsicfg...
Page 333: Iscsipathtest
iscsiPathTest iscsiPathTest Performs functional test of components in iSCSI complex. Synopsis iscsipathtest --slot slotnumber -unit number -path mode -nframes count Description Use this command to verify the functions of the network processor and the iSCSI complex. The CP processor instructs the Network processor BCM1125H in each GigE port to run the tests Multiple frames or data packets are transmitted from the Network processor to designated loopback points and sent back.
Page 334: Iscsiportcfg
iscsiPortCfg iscsiPortCfg Displays or modifies iSCSI port parameters. Synopsis iscsiportcfg --clearstats slot/geport iscsiportcfg --default slot/geport iscsiportcfg --show slot/geport [-v] iscsiportcfg --modify slot/geport options Description Use this command to display or modify the iSCSI port parameters. The default iSCSI port settings are as follows: TABLE 16 Default iSCSI port settings Setting...
Page 335 iscsiPortCfg Displays port-level protocol parameters, statistics, and session information --show on the specified port. Options include: Specifies verbose mode, which displays the initiator IP, TSID, and the number of connections in addition to the other port-level information. slot Specifies the slot number. This parameter only supports FC4-16IP blades in Brocade 48000 directors.
Page 336 iscsiPortCfg iSCSI Abort Task Set: iSCSI Clear ACA: iSCSI Clear Task Set: iSCSI LUN Reset: iSCSI Target Reset: iSCSI Task Reassign: Non FCP in PDU: Non FCP in Octet: 2576 Non FCP out PDU: Non FCP out Octet: 1352 Session details: Session Number: iSCSI Session Type: Normal...
Page 337: Iscsisessioncfg
iscsiSessionCfg iscsiSessionCfg Displays iSCSI session/connection details, clears the associated counters, or deletes an iSCSI session/connection. Synopsis iscsisessioncfg clearstats [-i initiator_iqn] [-t target_iqn] iscsisessioncfg delete [-i initiator_iqn] [-t target_iqn] iscsisessioncfg show [-i initiator_iqn] [-t target_iqn] Description Use this command to display iSCSI session/connection details, clear the associated counters, or delete an iSCSI session/connection.
Page 338 iscsiSessionCfg Max. Burst Length 256KB 256KB First Burst Length 512B 64KB Max outstanding R2T Default time to retain Default time to wait Error recovery level Initial R2T iSCSI Operating Login Parameters: Connection Level Connection Index: Parameter Name Self Value Peer Value Max.
Page 339: Iscsiswcfg
iscsiSwCfg iscsiSwCfg Displays or configures the iSCSI switch level configuration. Synopsis iscsiswcfg enableconn -s slot number | all iscsiswcfg disableconn -s slot number | all iscsiswcfg showconn -s slot number | all iscsiswcfg modifygw -t target name iscsiswcfg showgw Description Use this command to display the iSCSI switch level configuration and to configure the iSCSI connection redirection and target name prefix.
Page 340 iscsiSwCfg See Also fosConfig, iscsiCfg, iscsiPortCfg Fabric OS Command Reference 53-1000599-02...
Page 341: Islshow
islShow islShow Displays inter-switch link (ISL) information. Synopsis islshow Description Use this command to display the current connections and status of the inter-switch link (ISL) for each port on a switch. The command output includes the following information: • Node World Wide Name (WWN) •...
Page 342: Isnsccfg
isnscCfg isnscCfg Displays or modifies the configuration state of the iSNS client operation. Synopsis isnsccfg --set slot | geport -s server_ip isnsccfg --set -m -s server_ip isnsccfg --reregister isnsccfg --show isnsccfg --clear Description Use this command to display and update the configuration state of the iSNS client daemon. Note The execution of this command is subject to Admin Domain restrictions that may be in place.
Page 343 isnscCfg To register the iSNS objects: switch:admin> isnsccfg --reregister Initiated re-register of iSNS objects with iSNS server To clear the IP address of iSNS server: switch:admin> isnsccfg --clear Cleared iSNS server configuration. See Also none Fabric OS Command Reference 53-1000599-02...
Page 344: Itemlist
itemList itemList Lists parameter syntax information. Synopsis item_list = element | element white item_list element = item | item - item item = num | slot [white]/ [white] num slot = num num = hex | int int = int digit | digit hex = 0x hex digit | hex hex digit digit = 0|1|2|3|4|5|6|7|8|9 hex digit = digit |A|B|C|D|E|F|a|b|c|d|e|f...
Page 345 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.
Page 346: Killtelnet
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.
Page 347: Ldapcfg
ldapCfg ldapCfg Maps LDAP ADir server roles to default switch roles. 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.
Page 348 ldapCfg Displays a table of existing mappings between LDAP roles and their --show corresponding switch role. Displays command usage. --help Examples To display current LDAP and switch role map: switch:admin> ldapcfg --show LDAP Role Switch Role ------------------------------------------------ ldapadmin admin ldapuser user SANfabadmin fabricadmin...
Page 349: Licenseadd
licenseAdd licenseAdd Adds license keys to switch. Synopsis licenseadd “license” Description Use this command to add license keys to the switch. Some features of the switch and the fabric to which it is connected are optional, licensed products. Without a license installed for such products, their services are not available. A license key is a string of approximately 16 upper- and lowercase letters and numbers.
Page 350: Licensehelp
licenseHelp licenseHelp Displays commands used to administer license keys. Synopsis licensehelp Description Use this command to display a list of the commands used to administer license keys. Operands none Examples To display license commands: switch:admin> licensehelp licenseadd Adds license keys to switch licensehelp Print license help info licenseidshow...
Page 351: Licenseidshow
licenseIdShow licenseIdShow Displays the system license ID. Synopsis licenseidshow Description Use this command to display the license ID of the system. Some features of the switch and the fabric are optional, licensed products. Without a license installed for such products, the services provided by these features are not available. This command displays the system license ID used for both generating and validating licenses on the system.
Page 352: Licenseport
licensePort licensePort Manages the Dynamic Ports On Demand (POD) license assignment. Synopsis licensePort --release portnum licensePort --reserve portnum licensePort --show lcensePort --method dynamic | static Description Use this command to manage the Dynamic Ports on Demand license assignments. In the Dynamic POD method, the ports are assigned to a POD license in order to come online until they equal the number of online licensed ports.
Page 353 licensePort Dynamic POD method is in use 15 port assignments are provisioned for use in this switch: 10 port assignments are provisioned by the base switch license 5 port assignments are provisioned by the first POD license * 5 more assignments are added if the second POD license is installed 15 ports are assigned to installed licenses: 10 ports are assigned to the base switch license...
Page 354: Licenseremove
licenseRemove licenseRemove Removes the license key from the system. Synopsis licenseremove "license" Description Use this command to remove an existing license key from a switch. The existing license key must be entered exactly as shown by licenseShow, including case. When the key has been entered, use the licenseShow command to verify that the key has been removed and the licensed product uninstalled.
Page 355: Licenseshow
licenseShow licenseShow Displays current license keys. Synopsis licenseshow Description Use this command to display current license keys, along with a list of licensed products enabled by these keys. The message "No license installed on this switch" is displayed when no licenses are installed.
Page 356: Linkcost
linkCost linkCost Sets or displays the Fabric Shortest Path First (FSPF) cost of a link. Synopsis linkcost [[slotnumber/]portnumber [cost]] Description Use this command to set or display the cost of an interswitch link (ISL). The cost of a link is a dimensionless positive number.
Page 357 linkCost cost Specify the static cost of the link connected to the specified port. Valid values are 0 to 65,535. Assigning a value outside this range will fail and generate an error. A value of 0 removes the static cost and the port reverts to its default link cost.
Page 358: Login
login login Logs in as new user. Synopsis login Description Use this command to log in to the switch with another user name and password, without first logging out from the original session. If you originally connected through a Telnet or rlogin session, that session is left open.
Page 359: Logout
logout logout Logs out from a shell session. Synopsis logout Description Use this command to log out from a shell session. Remote login connections are closed and the local serial connections return to the login prompt. The exit command is accepted as a synonym for logout, as is Ctrl-D at the beginning of a line. Operands none Examples...
Page 360: Lsanzoneshow
lsanZoneShow lsanZoneShow Displays logical SAN zone information. Synopsis lsanzoneshow [-s] [-f fabricid] [-w wwn] [-z zonename] Description 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_”...
Page 361 lsanZoneShow Examples To display the LSAN zones: switch:admin> lsanzoneshow Fabric ID: 4 Zone Name: lsan_fcr10_0 50:05:07:65:05:84:0b:83 50:05:07:65:05:84:09:0e 10:00:00:00:c9:2b:6a:68 21:00:00:20:37:18:22:55 Fabric ID: 5 Zone Name: lsan_fcr11_0 10:00:00:00:c9:2b:6a:68 21:00:00:20:37:18:22:55 50:05:07:65:05:84:0b:83 50:05:07:65:05:84:09:0e switch# See Also fcrFabricShow, fcrPhyDevShow, fcrProxyDevShow, fcrRouteShow, switchShow Fabric OS Command Reference 53-1000599-02...
Page 362: Lsdbshow
lsDbShow lsDbShow Displays the Fabric Shortest Path First (FSPF) link state database. Synopsis lsdbshow [domain] Description Use this command to display an FSPF link state database record for switches in the fabric, or one domain within it. There are two types of database entries: 1.
Page 363 lsDbShow TABLE 19 lsDbShow display fields (Continued) Field Description advertiser ID (domain number) of the switch that originated this LSR. incarn Incarnation number of this LSR. length Total length, in bytes, of this LSR. Includes header and link state information for all links. chksum Checksum of total LSR, with exception of lsAge field.
Page 364 lsDbShow advertiser incarn = 0x80000014 length = 284 chksum = 0x8453 linkCnt = 16, flags = 0x0 LinkId = 2, out port = 16, rem port = 48, cost = 500, costCnt = 0, type = 1 LinkId = 2, out port = 17, rem port = 49, cost = 500, costCnt = 0, type = 1 LinkId =...
Page 365: Memshow
memShow memShow Displays the amounts of free and used memory in a switch. Synopsis memshow [-b | -k | -m] Description Use this command to display free and used memory in the switch, as well as the shared memory and buffers used by the kernel. Operands This command has the following operands: Specify to display memory usage in bytes.
Page 366: Minicycle
miniCycle miniCycle Runs a functional test of internal and external transmit and receive paths at full speed. Synopsis minicycle [--slot slotnumber][-nmegs count][-lb_mode mode][-spd_mode mode][-splb_mode 0 | 1] [-ports itemlist] Description Use this command to verify the intended functional operation of an ASIC pair (miniswitch) at the maximum or selected speed by setting up the routing hardware so that frames received by port M are retransmitted by way of port N.
Page 367 miniCycle d. 200 bytes of RANDOM 5. Periodically checks for the following conditions: a. Each port has not died. b. Each port's frames-transmitted counter is still incrementing. Each port's statistic error counters are nonzero: ENC_in, CRC_err, TruncFrm, FrmTooLong, BadEOF, Enc_out, BadOrdSet, DiscC3 6.
Page 368 miniCycle Backend bypass and port loopback Backend bypass and SERDES loopback Backend bypass and internal loopback -spd_mode mode Specifies the speed mode for the test. This parameter controls the speed at which each port operates. For 1 Gbps-only products, this parameter is ignored.
Page 369 miniCycle Examples To run a functional test on slot 1 using external (SERDES) loopback: switch:admin> minicycle --slot 1 -lb_mode 2 Running minicycle ....One moment please ... Path 0 ... Spinning ... Path 1 ... Spinning ... Path 2 ... Spinning ... Path 3 ...
Page 370 miniCycle FTPRT_STATUS_ERR INIT LESSN_STATUS_ERR MBUF_STATE_ERR MBUF_STATUS_ERR NO_SEGMENT PORT_ABSENT PORT_DIED PORT_ENABLE PORT_M2M PORT_STOPPED PORT_WRONG RXQ_FRAME_ERR RXQ_RAM_PERR STATS STATS_C3FRX STATS_FRX STATS_FTX TIMEOUT XMIT Refer to the Fabric OS Message Reference for more information. See Also itemList, portLoopbackTest Fabric OS Command Reference 53-1000599-02...
Page 371: Mscapabilityshow
msCapabilityShow msCapabilityShow Displays the Management Server (MS) capabilities. Synopsis mscapabilityshow Description Use this command to display the supported capabilities of the Management Server for each switch in the fabric. An asterisk displays next to the name of the local switch. Notes Reliable commit service (RCS) is a fabric-wide capability and is supported only if all the switches in the fabric support the service.
Page 372: Msconfigure
msConfigure msConfigure Configures the Management Server (MS) access control list (ACL). Synopsis msconfigure Description 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.
Page 373 msConfigure Done Display the access list Add member based on its Port/Node WWN Delete member based on its Port/Node WWN select : (0..3) [1] 0 done ... See Also msCapabilityShow, msPlatShow, msPlClearDB, msPlMgmtActivate, msPlMgmtDeactivate, msTdDisable, msTdEnable, msTdReadConfig, secPolicyShow Fabric OS Command Reference 53-1000599-02...
Page 374: Msplatshow
msPlatShow msPlatShow Displays the Management Server (MS) platform database. Synopsis msplatshow Description Use this command to display information from the MS platform database. This command displays the name of each platform object with the platform type (GATEWAY, HOST_BUS_ADAPTER, and so forth), associated management addresses, and associated node names.
Page 375: Msplatshowdbcb
msPlatShowDBCB msPlatShowDBCB Displays the Management Server (MS) platform service database control block. Synopsis msplatshowdbcb Description Use this command to display the control block fields associated with the platform database. Operands none Examples To display the MS platform service database control block: switch:admin>...
Page 376: Msplcleardb
msPlClearDB msPlClearDB Clears the Management Server (MS) platform database on all switches in the fabric. Synopsis msplcleardb Description Use this command to clear the MS platform database 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.
Page 377: Msplmgmtactivate
msPlMgmtActivate msPlMgmtActivate Activates the Management Server (MS) platform service. Synopsis msplmgmtactivate Description 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.
Page 378: Msplmgmtdeactivate
msPlMgmtDeactivate msPlMgmtDeactivate Deactivates the Management Server (MS) platform service. Synopsis msplmgmtdeactivate Description 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.
Page 379: Mstddisable
msTdDisable msTdDisable Disables the Management Server (MS) topology discovery service. Synopsis mstddisable ["ALL"] Description Use this command to disable the management server topology discovery service on a local switch or an entire fabric. This change takes effect immediately and commits to the configuration database for all affected switches.
Page 380: Mstdenable
msTdEnable msTdEnable Enables the Management Server (MS) topology discovery service. Synopsis mstdenable ["ALL"] Description Use this command to enable the MS topology discovery service on the local switch or throughout the fabric. The change takes effect immediately and commits to the configuration database for all affected switches.
Page 381: Mstdreadconfig
msTdReadConfig msTdReadConfig Displays the status of The Management Server (MS) topology discovery service. Synopsis mstdreadconfig Description Use this command to check whether or not the management server topology discovery service is enabled. Operands none Examples To display the status of the topology discovery service: switch:admin>...
Page 382: Myid
myId myId Displays the current login session details. Synopsis myid Description 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: •...
Page 383: Nbrstateshow
nbrStateShow nbrStateShow Displays the state of FSPF neighbors. Synopsis nbrstateshow [slotnumber/][portnumber] Description 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.
Page 384: Nbrstatsclear
nbrStatsClear nbrStatsClear Resets FSPF interface counters. Synopsis nbrstatsclear [slotnumber/][portnumber] 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.
Page 385 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 = 0x1004ce68 ifNo masterPort = 0 (self) defaultCost = 500 cost = 500 (output truncated) See Also interfaceShow, portShow, switchShow Fabric OS Command Reference...
Page 386: Nodefind
nodeFind nodeFind Displays all device Name Server (NS) entries matching a given WWN, device PID, or alias. Synopsis nodefind WWN | PID | ALIAS Description Use this command to display the NS information for all devices in the fabric that have either a port World Wide Name (WWN) or a node WWN matching the given WWN;...
Page 387 nodeFind Permanent Port Name: 22:00:00:04:cf:9f:26:7e Device type: Physical Target Port Index: 20 Share Area: No Device Shared in Other AD: No Aliases: a320 To display all the device information matching the WWN "20:00:00:e0:8b:01:ce:d3": switch:user> nodefind 20:00:00:e0:8b:01:ce:d3 Remote: Type Pid PortName NodeName 020eef;...
Page 388: Nsaliasshow
nsAliasShow nsAliasShow Displays local Name Server (NS) information, with aliases. Synopsis nsaliasshow [-r -t] Description Use this command to display local name server information with the added feature of displaying the defined configuration aliases to which the device belongs. The following message is displayed if there is no information in this switch: There is no entry in the Local Name Server The command nsAllShow displays information from all switches.
Page 389 nsAliasShow Examples To display local NS information with aliases: switch:admin> nsaliasshow Type Pid PortName NodeName TTL(sec) 021200; 2,3;10:00:00:60:69:00:03:19;30:00:00:60:69:00:03:19; na FC4s: FCIP Fabric Port Name: 20:02:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:03:19 Aliases: 021300; 3;10:00:00:60:69:00:02:d6;20:00:00:60:69:00:02:d6; na Fabric Port Name: 20:03:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:02:d6 Aliases: DeviceAlias 0214e2;...
Page 390 nsAliasShow 0214e8; 3;21:00:00:fa:ce:04:83:c9;20:00:00:fa:ce:04:83:c9; 0 FC4s: FCP [STOREX RS2999FCPH3 NS09] Fabric Port Name: 20:04:00:60:69:01:44:22 Permanent Port Name: 21:00:00:fa:ce:04:83:c9 Aliases: 0214ef; 3;21:00:00:ad:bc:04:6f:70;20:00:00:ad:bc:04:6f:70; 0 FC4s: FCP [STOREX RS2999FCPH3 JB09] Fabric Port Name: 20:04:00:60:69:01:44:22 Permanent Port Name: 21:00:00:ad:bc:04:6f:70 Aliases: The Local Name Server has 6 entries } To display local NS information with aliases with the -r and -t options: switch:admin>...
Page 391: Nsallshow
nsAllShow nsAllShow Displays global name server information. Synopsis nsallshow [type] Description Use this command to display the 24-bit Fibre Channel addresses of all devices in all switches in the fabric. If the type operand is supplied, only devices of specified FC-PH type are displayed. If type is omitted, all devices are displayed.
Page 392: Nscamshow
nsCamShow nsCamShow Displays information about remote devices in the Name Server (NS) cache. Synopsis nscamshow [-t] Description Use this command to display the local NS cache information about the devices discovered in the fabric by the NS cache manager. If the NS cache manager does not discover new switches or new devices in the fabric, the command displays the message “No Entry is found!”...
Page 393 nsCamShow known v430 0xfffc01 Device list: count 1 Type Pid PortName NodeName 021200; 2,3;10:00:00:60:69:00:ab:ba;10:00:00:60:69:00:ab:ba; FC4s: FCIP PortSymb: [28] "SEAGATE ST318452FC 0001" Fabric Port Name: 20:02:00:60:69:00:68:19 Permanent Port Name: 10:00:00:60:69:00:ab:ba Switch entry for 4 state owner known v320 0xfffc01 Device list: count 0 No entry is found! To display the output with the -t option: switch:admin>...
Page 394: Nsshow
nsShow nsShow Displays local Name Server (NS) information. Synopsis nsshow [-r -t] Description Use this command to display local NS information about devices connected to this switch. If no information is available for the switch, the command displays the message: “There is no entry in the Local Name Server.”...
Page 395 nsShow SCR=2 Nx_Port detected registration. Register to receive all RSCN requests issued for events detected by the affected Nx_Port. SCR=3 Register to receive all RSCN request issued. The RSCN request returns all effected N_Port_ID pages. Displays the device type. Of the two device type parts, the first part indicates the origination of the device.
Page 396 nsShow To display local name server information with the -r option. switch:admin> nsshow -r Type Pid PortName NodeName 010100; 3;21:00:00:e0:8b:13:08:10;20:00:00:e0:8b:13:08:10; 1 FC4s: FCP NodeSymb: [41] "QLA2340 FW:v3.03.06 DVR:v9.0.0.2 (w32 IP)" Fabric Port Name: 20:01:00:05:1e:34:00:70 Permanent Port Name: 21:00:00:e0:8b:13:08:10 Port Index: 1 Share Area: No Device Shared in Other AD: No Redirect: No...
Page 397: Nszonemember
nsZoneMember nsZoneMember Displays the information of all the online devices zoned with the given device. Synopsis nszonemember -a | -u | pid | wwn Description Use this command to display information about all the online devices zoned with the given device. Issuing this command without operands displays all online devices zoned with the given device.
Page 398 nsZoneMember Examples To display information about all the online devices zoned with the given device: switch:admin> nszonemember 0x0416e2 3 local zoned members: Type Pid PortName NodeName 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:00:00:c9:26:0e:ae Device type: Physical Initiator 0416e2;...
Page 399 nsZoneMember Zoned Members: 2 devices Pid: 0xb00d00 Aliases: ix360_131_196p5 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 all the unzoned devices in the fabric: switch:admin>...
Page 400: Passwd
passwd passwd Changes the password for a specified user. Synopsis passwd [“user account”] Description Use this command to change a user account password. Operands When this command is invoked without operand, the password is changed for the current user account. The following operand is optional: "user account"...
Page 401 passwd • 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. •...
Page 402 passwd Insufficient number of upper case letters The password you entered contains less than the minimum required number of uppercase characters. Insufficient number of digits in password The password you entered contains less than the minimum required number of numeric characters.
Page 403: Passwdcfg
passwdCfg passwdCfg Manages the password policies. Synopsis passwdcfg --set options value passwdcfg --disableadminlockout passwdcfg --enableadminlockout passwdcfg --setdefault passwdcfg --showall passwdcfg --help Description Use this command to manage password policies. Use --set to configure the following password policies: • Password strength policy •...
Page 404 passwdCfg policy is enforced across all user accounts except the root, factory, and SecurityAdmin role accounts. A separate configuration option, available to the SecurityAdmin and Admin role accounts, may be used to enable and disable applications of the account lockout policy to Admin role accounts.
Page 405 passwdCfg -minpasswordage value Specifies the minimum number of days that must elapse before a password can be changed. -minpasswordage can be set at 0 to 999. The default value is 0. Setting this parameter to a nonzero value discourages a user from rapidly changing a password in order to defeat the password history setting to reuse a recently used password.
Page 406 passwdCfg -sequence value Specifies the length of sequential character sequences that will be disallowed. A sequential character sequence is defined as a character sequence in which the ASCII value of each contiguous character differs by one. The ASCII value for the characters in the sequence must all be increasing or all decreasing.
Page 407 passwdCfg lowercase value out of range The -lowercase value specified must be greater than or equal to 0 and less than or equal to -minlength value. uppercase value out of range The -uppercase value specified must be greater than or equal to 0 and less than or equal to -minlength value.
Page 408: Pathinfo
pathInfo pathInfo Display routing and statistics information along a path covering multiple switches. Synopsis pathinfo [domain [src_portnumber [dst_portnumber]] [-r]] Description Use this command to display detailed routing information from a source port or area on the local switch to a destination port or area on another switch. This routing information describes the exact path that a user data stream takes to go from the source port to the destination port, including all intermediate switches.
Page 409 pathInfo When requested, statistics are reported below the routing information for each hop. These statistics are presented for both the input and output ports, for both receive and transmit modes. These statistics are divided into basic and extended statistics, which can be individually requested in interactive mode.
Page 410 pathInfo The source route can specify a partial route from source to destination (in which case the remaining hops are chosen as the path from the input port or area on the first hop not listed in the source route to the destination), as a full route, or as an arbitrary route across the fabric.
Page 411 pathInfo strict source rte Specifies that the source route must be followed strictly as indicated, skipping possible intermediate switches. When using this option, the source route hops must be specified using domain rather than the output port. Timeout The maximum time allowed to wait for the response; default is 10 seconds. Examples To display basic path information to a specific domain, using the command line (non-interactive mode):...
Page 412 pathInfo Words 240434036 2294316 2119951 2121767 Frames 20025929 54999 162338 56710 Errors In Port Domain ID (Name) Out Port Cost --------------------------------------------------------- 8 (web228) (output truncated) See Also portStatsShow, switchShow Fabric OS Command Reference 53-1000599-02...
Page 413: Pdshow
pdShow pdShow Displays data from a panic dump file. Synopsis pdshow [panic_dump_file] Description Use this command to display data from a panic dump file. The panic dump file contains information that might be useful to determine the cause of the system panic. When executed without any arguments, this command displays output from the latest panic dump file available on the switch.
Page 414: Perfaddeemonitor
perfAddEEMonitor perfAddEEMonitor Adds an end-to-end monitor to a port. Synopsis perfaddeemonitor [slotnumber/]portnumber SourceID DestID Description Use this command to add an end-to-end performance monitor to a port. The performance monitor counts the number of words received, number of words transmitted, and number of CRC errors detected using either of the following two conditions: 1.
Page 415 perfAddEEMonitor Examples To add an end-to-end monitor to blade 1 port 2: switch:admin> perfaddeemonitor 1/2 "0x050200" "0x1182ef" End-to-End monitor number 0 added. See Also perfAddIPMonitor, perfAddReadMonitor, perfAddRWMonitor, perfAddSCSIMonitor, perfAddUserMonitor, perfAddWriteMonitor, perfDelEEMonitor, perfMonitorClear, perfMonitorShow Fabric OS Command Reference 53-1000599-02...
Page 416: Perfaddipmonitor
perfAddIPMonitor perfAddIPMonitor Adds a filter-based performance monitor for IP frame count. Synopsis perfaddipmonitor [slotnumber/]portnumber [alias] Description Use this command to create a filter-based monitor that will count the number of IP traffic frames. Only frames transmitted are counted. Execution of this command displays a numeric key that uniquely identifies the monitor. Use the perfMonitorShow command for a listing of valid keys and user-defined aliases.
Page 417: Perfaddreadmonitor
perfAddReadMonitor perfAddReadMonitor Adds a filter-based performance monitor for the SCSI Read command. Synopsis perfaddreadmonitor [slotnumber/]portnumber [alias] Description Use this command to create a filter-based monitor that counts the number of SCSI FCP Read commands in Fibre Channel frames. Only frames transmitted are counted. Execution of this command displays a numeric key that uniquely identifies the monitor.
Page 418: Perfaddrwmonitor
perfAddRWMonitor perfAddRWMonitor Adds a filter-based performance monitor for the SCSI read and write commands. Synopsis perfaddrwmonitor [slotnumber/]portnumber [alias] Description Use this command to create a filter-based monitor that counts the number of SCSI FCP Read and Write commands in Fibre Channel frames. Only frames transmitted are counted. Execution of this command displays a numeric key that uniquely identifies the monitor.
Page 419: Perfaddscsimonitor
perfAddSCSIMonitor perfAddSCSIMonitor Adds a filter-based performance monitor for SCSI frame count. Synopsis perfaddscsimonitor [slotnumber/]portnumber [alias] Description Use this command to create a filter-based monitor that counts the number of SCSI traffic frames. Only frames transmitted are counted. Execution of this command displays a numeric key that uniquely identifies the monitor. Use the perfMonitorShow command for a listing of valid keys and user-defined aliases.
Page 420: Perfaddusermonitor
perfAddUserMonitor perfAddUserMonitor Adds a user-defined filter-based performance monitor. Synopsis perfaddusermonitor [slotnumber/]portnumber "grouplist" [alias] Description Use this command to define a custom filter for frame offsets and values. For every offset, each group of comparison values is evaluated using the Boolean OR operator to determine a match.
Page 421 perfAddUserMonitor SOFi2 SOFn2 SOFi3 SOFn3 alias Specifies a name for the monitor. Strings exceeding 10 characters are truncated. To accommodate spaces, the string must be surrounded by quotation marks. Spaces count toward the character limit but are removed. This operand is optional. By default, the alias is an empty string. Examples To add a filter-based monitor for all Extended Link Service requests (R_CTL=0x22 and TYPE=0x01) to a port:...
Page 422: Perfaddwritemonitor
perfAddWriteMonitor perfAddWriteMonitor Adds a filter-based performance monitor for the SCSI write command. Synopsis perfaddwritemonitor [slotnumber/]portnumber [alias] Description Use this command to create a filter-based monitor that counts the number of SCSI FCP write commands in Fibre Channel frames. Only frames transmitted are counted. Execution of this command displays a numeric key that uniquely identifies the monitor.
Page 423: Perfcfgclear
perfCfgClear perfCfgClear Clears the previously saved performance monitoring configuration settings from nonvolatile memory. Synopsis perfcfgclear Description Use this command to clear the previously saved end-to-end and filter configuration settings of performance monitoring from nonvolatile memory. Notes This command requires an Advanced Performance Monitoring license. This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port, M (Mirror) ports and GbE ports.
Page 424: Perfcfgrestore
perfCfgRestore perfCfgRestore Restores performance monitoring configuration settings from nonvolatile memory. Synopsis perfcfgrestore Description Use this command to restore the performance monitoring configuration information from nonvolatile memory. This does not restore the information cleared by the perfCfgClear command; rather, it restores the configuration from nonvolatile memory. The perfCfgRestore command overwrites any configuration changes that were not saved.
Page 425: Perfcfgsave
perfCfgSave perfCfgSave Saves performance monitoring configuration settings to nonvolatile memory. Synopsis perfcfgsave Description Use this command to save the current Performance Monitor configuration for end-to-end (EE) and filter configuration settings of performance monitoring into nonvolatile memory. Configurations are saved persistently across power cycles. The number of monitors that can be saved to flash memory is limited as follows: •...
Page 426: Perfclearalpacrc
perfClearAlpaCrc perfClearAlpaCrc Clears the CRC error count associated with a port and arbitrated loop physical address (AL_PA). Synopsis perfclearalpacrc [slotnumber/]portnumber [ALPA] Description Use this command to clear a specific cyclic redundancy check (CRC) error counter associated with a specific port and AL_PA, or all such counters on a port. Notes This command requires an Advanced Performance Monitoring license.
Page 427: Perfdeleemonitor
perfDelEEMonitor perfDelEEMonitor Deletes one or all end-to-end performance monitors from a port. Synopsis perfdeleemonitor [slotnumber/]portnumber [monitorId] Description Use this command to delete an end-to-end performance monitor from a port, or all such monitors associated with a port. Notes This command requires an Advanced Performance Monitoring license. This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port, M (Mirror) ports and GbE ports.
Page 428: Perfdelfiltermonitor
perfDelFilterMonitor perfDelFilterMonitor Deletes one or all filter-based performance monitors from a port. Synopsis perfdelfiltermonitor [slotnumber/]portnumber [monitorid] Description Use this command to delete a filter-based performance monitor from a port, or all such monitors associated with a port. Notes This command requires an Advanced Performance Monitoring license. This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port, M (Mirror) ports and GbE ports.
Page 429: Perfhelp
perfHelp perfHelp Displays performance monitoring help information. Synopsis perfhelp Description Use this command to display the help commands available for performance monitoring. Operands none Examples To display commands related to performance monitoring: switch:admin> perfhelp perfAddEEMonitor Add end-to-end monitor perfAddIPMonitor Add monitor for IP traffic frame count perfAddReadMonitor Add filter-based monitor - SCSI Read perfAddRWMonitor...
Page 430: Perfmonitorclear
perfMonitorClear perfMonitorClear Clears counters of end-to-end, filter-based, and ISL performance monitors on a port. Synopsis perfmonitorclear --class monitor_class [slotnumber/]portnumber [monitorId] Description Use this command to clear counters for performance monitors on a port, specified by class. Monitor classes include end-to-end monitors (EE), filter-based monitors (FLT), and interswitch link monitors (ISL).
Page 431 perfMonitorClear This will clear ALL filter-based monitors' counters on port 2, continue? (yes, y, no, y): [no] y To clear statistics counters for an ISL monitor: switch:admin> perfmonitorclear --class ISL 1 This will clear ISL monitor on port 1, continue? (yes, y, no, n): [no] y See Also perfAddEEMonitor, perfAddIPMonitor, perfAddReadMonitor, perfAddRWMonitor, perfAddSCSIMonitor, perfAddUserMonitor, perfAddWriteMonitor, perfMonitorShow...
Page 432: Perfmonitorshow
perfMonitorShow perfMonitorShow Displays end-to-end, filter-based, and inter-switch Link monitors on a port. Synopsis perfmonitorshow class monitor_class [slotnumber/]portnumber [interval] Description Use this command to display performance monitors on a port. Monitor classes include end-to-end monitors (EE), filter-based monitors (FLT), and Inter-Switch Link monitors (ISL). ISL monitors are automatically activated on E_Ports (not including trunk slaves).
Page 433 perfMonitorShow This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port, M (Mirror) ports and GbE ports. The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions" and Appendix A, "Command Availability" for details.
Page 434 perfMonitorShow Tx Rx Tx Rx Tx Rx Tx Rx Tx Rx Tx Rx Tx Rx Tx Rx ===== ===== ===== ===== ===== ===== ===== ===== To display cumulative filter monitor information on a port: switch:admin> perfmonitorshow --class FLT 8 There are 2 filter-based monitors defined on port 8. ALIAS OWNER_APP FRAME_COUNT...
Page 435: Perfsetporteemask
perfSetPortEEMask perfSetPortEEMask Sets the overall mask for end-to-end (EE) performance monitors. Synopsis perfsetporteemask [slotnumber/]portnumber "TxSIDMsk " "TxDIDMsk " "RxSIDMsk" "RxDIDMsk" Description Use this command to set the mask for an end-to-end (EE) performance monitor. This command allows selecting the Fibre Channel frames for which to collect performance statistics. When setting the EE mask on a port, all existing EE monitors on that port are deleted.
Page 436 perfSetPortEEMask TxSIDMsk Specify the transmitting source ID mask in dd:aa:pp format, with quotation marks, where dd is the domain ID mask, aa is the area ID mask, and pp is AL_PA ID mask. For example, "00:ff:00" uses only the Area ID to trigger the EE monitor.
Page 437: Perfshowalpacrc
perfShowAlpaCrc perfShowAlpaCrc Displays the CRC error count by port or by arbitrated loop physical address (AL_PA). Synopsis perfshowalpacrc [slotnumber/]portnumber [ALPA] Description Use this command to display the cyclic redundancy check (CRC) error count of one or all devices attached to a port. If the AL_PA operand is specified, only the CRC count for that AL_PA device is displayed.
Page 438: Perfshowporteemask
perfShowPortEEMask perfShowPortEEMask Displays the current address mask for end-to-end performance monitors on a port. Synopsis perfshowporteemask [slotnumber/]portnumber Description Use this command to display the current mask shared across all end-to-end (EE) performance monitors of a port. There are only two commands that can modify the value of the EE mask: perfSetPortEEMask and perfCfgRestore.
Page 439 perfShowPortEEMask RxSID ALPA: RxDID Domain: RxDID Area: RxDID ALPA: See Also perfAddEEMonitor, perfDelEEMonitor, perfSetPortEEMask Fabric OS Command Reference 53-1000599-02...
Page 440: Perfttmon
perfTTmon perfTTmon Installs the Top Talker monitor in the specified mode. Synopsis perfttmon Port Mode (F_Port): perfttmon --add egress | ingress [slotnumber/]portnumber perfttmon --show [slotnumber/]portnumber [number of flows] [wwn| pid] perfttmon --delete [slotnumber/]portnumber Fabric Mode: perfttmon --add fabricmode perfttmon --show dom domain id [number of flows] [wwn| pid] perfttmon --delete fabricmode Description Use this command to install the Top Talker monitor.
Page 441 perfTTmon Operands This command has the following operands: slotnumber For bladed systems only, specifies the slot number of the port on which to install Top Talkers, followed by a slash (/). portnumber Specifies the number of the port on which the Top Talker is to be installed, relative to its slot for bladed systems.
Page 442 perfTTmon To display the F_Port Top Talker output: Switch:admin> perfttmon --show 1/2 pid ===================================== Src_PID Dst_PID MB/sec ===================================== 0xa90800 0xa05200 6.926 0xa90800 0xa905ef 6.872 0xa905ef 0xa05200 6.830 0xa909d5 0xa05200 6.772 To delete the Fabric Mode Top Talker: Switch:admin> perfttmon --del fabricmode To add the Fabric Mode Top Talker: Switch:admin>...
Page 443: Pkicreate
pkiCreate pkiCreate Creates public key infrastructure (PKI) objects. Synopsis pkicreate Description Use this command to create PKI objects such as a pass-phrase switch private key and CSR and to install a root certificate. This command does not create the switch certificate. Switch certificate should be obtained offline from the Certificate Authority.
Page 444: Pkiremove
pkiRemove pkiRemove Removes existing public key infrastructure (PKI) objects. Synopsis pkiremove Description Use this command to remove PKI objects including the switch private key, private key pass-phrase, CSR, root certificate, and switch certificate. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 445: Pkishow
pkiShow pkiShow Displays existing public key infrastructure (PKI) objects. Synopsis pkishow Description Use this command to display PKI objects, such as switch private key, private key pass-phrase, CSR, root certificate, and switch certificate. Operands none Examples To view PKI objects: switch:admin>...
Page 446: Policy
policy policy Displays or modifies the encryption and authentication algorithms for security policies. Synopsis policy option type number [-enc method] [-auth algorithm] [-pfs value] [-dh group] [-seclife seconds] Description Use this command to display or modify the encryption and authentication algorithms for security policies.
Page 447 policy -dh group Specifies the Diffie-Hellman group used in PFS negotiation. This operand is valid only with IKE policies. The default is 1. Values include: Fastest as it uses 768 bit values, but least secure. 14 Slowest as it uses 2048 bit values, but most secure. -seclife seconds Security association lifetime in seconds.
Page 448 policy To display all IPSec policy settings: switch:admin> policy --show ipsec all IPSec Policy 2 ----------------------------------------- Authentication Algorithm: SHA-1 Encryption: AES-128 SA Life (seconds): 28800 IPSec Policy 29 ----------------------------------------- Authentication Algorithm: SHA-1 Encryption: AES-128 SA Life (seconds): 28800 Operation Succeeded To change (delete and re-create) a policy: switch:admin>...
Page 449: Portalpashow
portAlpaShow portAlpaShow Displays the Arbitrated Loop Physical Addresses (AL_PAs) of devices attached to a port. Synopsis portalpashow [slotnumber/]portnumber Description Use this command to display the AL_PAs of devices connected to a port, and whether these devices are public or private. If the specified port is not an active FL_Port or if no AL_PAs are present, this command prints an error.
Page 450: Portbuffershow
portBufferShow portBufferShow Displays the buffer usage information for a port group or for all port groups in the switch. Synopsis portbuffershow [[slotnumber/]portnumber] Description Use this command to display the current long distance buffer information for the ports in a port group.
Page 451 portBufferShow Operands When invoked without operands, this command displays the long distance buffer information for all the port groups of the switch. The following operands are optional: slotnumber For bladed systems only, specifies the slot number of the port group to display, followed by a slash (/).
Page 452: Portcamshow
portCamShow portCamShow Displays port-based filter CAM utilization. Synopsis portcamshow [[slotnumber/]portnumber] Description Use this command to display the current filter CAM utilization of all ports or one port specified at input. The following information is displayed: SID used Total number of CAM entries used by this port. Note that each CAM entry (either SID or DID CAM) can be shared among a certain number of ports, depending on the ASIC.
Page 453 portCamShow switch:admin> portcamshow 7/31 -------------------------------------------------- Area SID used DID used SID entries DID entries 03b380 03cf80 034100 03cf00 03cf00 03cf80 -------------------------------------------------- SID free, DID free: (2044, 1020) The SID entry 03cf00 and DID entry 03cf80 on port 7/31 belong to port 7/39. To display the filter CAM utilization for all ports on a switch: switch:user>...
Page 454: Portcfg
portCfg portCfg Enables or disables a port's configuration. Synopsis portcfg action [slot/][ge]port [-range] arguments Description Use this command to manage configuration parameters for ports and gigabit Ethernet (GbE) ports. The following operations can be performed with this command: • Optionally add and delete Address resolution protocol (ARP) entries. Flush ARP table. •...
Page 455 portCfg Adds static ARP entry to the ARP table. Specify IP Address and MAC address for each entry. Use portShow arp with the -lmac option to get the MAC address. delete ipaddr Deletes static ARP entry from the ARP table. Only IP address must be specified to delete the entry.
Page 456 portCfg -n remote_wwn Specifies the remote-side FC entity WWN. -q control-dscp Specifies the DSCP (DiffServ Code Point) Marking used for control TCP connection of the FCIP tunnel. This operand is optional. Range is 0 to 63 (inclusive). Default value is 0. -Q data-dscp Specifies the DSCP (DiffServ Code Point) Markingused for data TCP connection of the FCIP tunnel.
Page 457 portCfg modify tunnel_id [arguments] Modifies the properties of the existing FCIP tunnel. This disrupts the traffic on the specified FCIP tunnel for a brief period of time. If IPsec is enabled on the FCIP tunnel, the tunnel cannot be modified. To change it, you must delete and re-create the tunnel.
Page 458 portCfg -p Control L2 CoS Specifies the PL2_Class_of_Service/Priority, as defined by IEEE 802.1p, for the FCIP control connection. Range is 0-7. Default is 0. -P L2 CoS Specifies the PL2 Class of Service/Priority, as defined by IEEE 802.1p, for the FCIP data connection. Range is 0-7. Default is 0. delete tunnel_id Deletes specified FCIP tunnel.
Page 459 portCfg Valid options and arguments for ipif are: create src_ipaddr mtu_size Creates IP interfaces. Specify the following: src_ipaddr Specifies source IP address in either IPv6 or IPv4 format: src_IPv6_addr/prefix_len Specifies the source IPv6 address of the virtual port if IPv6 is used. The address must be an IPv6 global, unicast address, followed by a prefix.
Page 460 portCfg delete ipaddr Deletes IP routes for specified IPv4 or IPv6 address. ipaddr Specifies IP address in either IPv6 or IPv4 format: IPv6_addr/prefix_len Specifies the IPv6 address of the virtual port, if IPv6 is used. The address must be an IPv6 global, unicast address, followed by a prefix. The prefix_len operand is required.
Page 461 portCfg blade first should be enabled for FC fastwrite using fastWriteCfg. This command can also be used to list all ports configured for FC fastwrite. This feature requires a Brocade license. The syntax for portcfg fastwrite is as follows: portcfg fastwrite [slot/]port mode Valid modes for fastwrite are: Enables FC fastwrite on the specified port.
Page 462 portCfg ficon Use this command to enable or disable FICON emulation in an FCIP tunnel and modify associated parameters onan FCIP tunnel on a 'virtual' E_Port. This command is supported only on a Brocade 7500/FR4-18 platform. A feature key is required to enable any of the FICON emulation processing. The tunnel must be down or disabled to issue and process the FICON commands.
Page 463 portCfg by hosts (channels) attached at the opposite side. Too small of a value results in poor performance. The value should be chosen based upon the typical tape channel program that requires optimum performance. The default value is 32. The range is 1-100. -b |--rdMaxPipe value Defines the maximum number of tape read channel commands (CCWs) that can enter the read pipeline for a single device whether all the CCWs...
Page 464 portCfg -f |--dbgFlags value Defines optional debug flags. The default is 0xF7C80000. This parameter is primarily for use by technical support personnel. ftrace FTRACE is a debug tool primarily for Tech Support personnel. It is implemented as a subcomponent of the VEnEmulation feature. It includes the ability to freeze ntraces on certain events and to retain the trace information for future examination.
Page 465 portCfg Examples To add an ARP entry: switch:admin> portcfg arp ge0 add 192.168.255.25 00:01:02:03:04:60 Operation Succeeded To create an FCIP tunnel using IPV4: switch:admin> portcfg fciptunnel ge0 create 2 192.168.255.2 192.168.255.20 100000 Operation Succeeded To create an FCIP tunnel using IPV6: switch:admin>...
Page 466 portCfg To create a mirror port: switch:admin> portcfg mirrorport 2/4 --enable Please confirm enable of Mirror Port (Y,y,N,n): [n] y To configure a range of ports as RSCN-suppressed: switch:admin> portcfg rscnsupr 2/4-7 --enable To add an entry to the VLAN tag table. switch:admin>...
Page 467: Portcfgalpa
portCfgAlpa portCfgAlpa Configures the AL_PA offset on a specified port or range of ports. Synopsis portcfgalpa [slot/]port, mode Description 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.
Page 468: Portcfgcreditrecovery
portCfgCreditRecovery portCfgCreditRecovery Enables or disables credit recovery on a port. Synopsis portcfgcreditrecovery --disable | --enable [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. Only ports configured as long distance ports can utilize the credit recovery feature.
Page 469: Portcfgdefault
portCfgDefault portCfgDefault Restores the port configuration to factory default values. Synopsis portcfgdefault [slot/][ge]port Description Use this command to reset any special port configuration values to their factory defaults. This command persistently disables ports capable of routing, which is the factory default value. You can view the current port configuration using the portCfgShow command.
Page 470: Portcfgeport
portCfgEPort portCfgEPort Enables or disables E_Port capability on a port. Synopsis portcfgeport [slot/]port,mode Description Use this command to enable or disable E_Port capability on a port. E_Port capability is enabled by default. When an inter-switch link (ISL) is connected to a port and the port's E_Port capability is disabled, the ISL is segmented.
Page 471: Portcfgexport
portCfgEXPort portCfgEXPort Sets a port to be an EX_Port, and sets and displays EX_Port configuration parameters. Synopsis portcfgexport [slotnumber/]portnumber portcfgexport [-a admin] portcfgexport [-f fabricid] portcfgexport [-r ratov] portcfgexport [-e edtov] portcfgexport [-d domainid] portcfgexport [-p pidformat] portcfgexport [-t fabric_parameter] portcfgexport [-m port mode] portcfgexport [-i mode] Description...
Page 472 portCfgEXPort A configuration change that would result in an invalid domain ID for McDATA Open Fabric mode or McDATA Fabric mode causes the preferred domain ID to be set to the minimum valid McDATA mode domain ID of 1. The exception to this is if the configuration change includes setting the preferred domain ID, in which case the configuration change does not take place and a corresponding error message is displayed.
Page 473 portCfgEXPort -i mode Enables or disables Insistent Domain Id (IDID) for the specified EX_Port. Specify 1 to enable IDID, specify 2 to disable IDID. This command must be issued from a McDATA edge switch attached to a single or dual FCR configuration.
Page 474: Portcfggport
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.
Page 475: Portcfgislmode
portCfgISLMode portCfgISLMode Enables or disables ISL R_RDY mode on a port. Synopsis portcfgislmode [slot/]port,mode Description Use this command to enable or disable inter-switch 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.
Page 476 portCfgISLMode To disable ISL R_RDY mode on a port: switch:admin> portcfgislmode 1/3, 0 See Also configure, portCfgLongDistance, portCfgShow Fabric OS Command Reference 53-1000599-02...
Page 477: Portcfglongdistance
portCfgLongDistance portCfgLongDistance Configures a port to support long distance links. Synopsis portcfglongdistance [slot/]port [distance_level] [vc_translation_link_init] [desired_distance] Description Use this command to allocate sufficient numbers of full size frame buffers on a particular port or to support a long distance link up to 500 km. The port can only be used as an E_Port. Changes made by this command are persistent across switch reboots and power cycles.
Page 478 portCfgLongDistance L0 (0) Specify L0 to configure the port as a regular port. A total of 20 full-size frame buffers are reserved for data traffic, regardless of the port’s operating speed; therefore, the maximum supported link distance is up to 10 km at 1 Gbps, up to 5 km at 2 Gbps, up to 2 km at 4 Gbps and up to 1 km at 8 Gbps.
Page 479 portCfgLongDistance Unknown: Loss_of_sync: 0 Fbsy: Lli: Loss_of_sig: Proc_rqrd: Protocol_err: 0 Timed_out: Invalid_word: 0 Rx_flushed: Invalid_crc: Tx_unavail: Delim_err: Free_buffer: Address_err: Overrun: Lr_in: Suspended: Lr_out: Parity_err: Ols_in: 2_parity_err: Ols_out: CMI_bus_err: See Also configure, portCfgISLMode, portCfgTrunkPort, portCfgShow, portShow, switchShow Fabric OS Command Reference 53-1000599-02...
Page 480: Portcfglport
portCfgLPort portCfgLPort Configures a port as an L_Port. Synopsis portcfglport [[slot/]port] locked_mode [private_mode] [duplex_mode]] Description 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.
Page 481 portCfgLPort VC Link Init ........ Locked L_Port ....ON..ON ON Locked G_Port ..
Page 482: Portcfgnpivport
portCfgNPIVPort portCfgNPIVPort Enables or disables N_Port ID virtualization (NPIV) functionality on a port. Synopsis [slot/]port,mode Description Use this command to enable or disable NPIV functionality on a port. NPIV is only applicable to F_Ports. The following conditions must be met for a switch port to respond to NPIV requests from an NPIV device: NPIV capable: NPIV capability is a switch blade or port attribute that is required for NPIV...
Page 483 portCfgNPIVPort To display NPIV functionality on a port: switch:admin> portcfgshow (output from other ports suppressed) Ports of Slot 1 9 10 11 12 13 14 15 -----------------+--+--+--+--+----+--+--+--+----+--+--+--+----+--+--+-- Speed AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AL_PA Offset 13 ..
Page 484: Portcfgnport
portCfgNPort portCfgNPort Enables or disables N_Port functionality for an Access Gateway port. Synopsis portcfgnport [port_number | port_range] [mode] Description Use this command to enable or disable N_Port functionality for an Access Gateway port. The enabled N_Port automatically comes online if it is connected to an enterprise fabric switch that supports NPIV.
Page 485: Portcfgpersistentdisable
portCfgPersistentDisable portCfgPersistentDisable Persistently disables a port. Synopsis portcfgpersistentdisable [[slot/]port] Description Use this command to persistently disable a port, or use this command without operands to display the persistently disabled status of all ports on the switch. Persistently disabled ports remain disabled across power cycles, switch reboots, and switch enables.
Page 486: Portcfgpersistentenable
portCfgPersistentEnable portCfgPersistentEnable Persistently enables a port. Synopsis portcfgpersistentenable [[slot/]port] Description Use this command to persistently enable a port or a range of ports, or use this command without operands to display the persistently disabled status of all ports on the switch. Persistently enabled ports remain enabled across power cycles, switch reboots, and switch enables.
Page 487 portCfgPersistentEnable See Also ficonCupSet, ficonCupShow, portDisable, portEnable, portCfgPersistentDisable, portCfgShow, portShow, switchShow Fabric OS Command Reference 53-1000599-02...
Page 488: Portcfgqos
PortCfgQos PortCfgQos Enables or disables QoS, sets the default configuration, and sets and resets the ingress rate limit. Synopsis portcfgqos --default | --disable | --enable [slot/]port portcfgqos --setratelimit [slot /]port ratelimit portcfgqos --resetratelimit [slot/]port portcfgqos --help Description Use this command to enable or disable Adaptive Networking/Quality of Service (AN/QoS) on a port, to set or reset the ingress rate limit for the specified port, and to set the default behavior.
Page 489 PortCfgQos Displays command usage. --help Examples To enable QoS on a port. switch:admin> portcfgqos --enable 3/15 To disable QoS on a port. switch:admin> portcfgqos --disable 3/15 To set the ingress rate limit on a port to 2 Gbps: switch:admin> portcfgqos --setratelimit 3/15 2000 To set the default QoS configuration on a port: switch:admin>...
Page 490: Portcfgshow
portCfgShow portCfgShow Displays port configuration settings. Synopsis portcfgshow portcfgshow [[slot/]port] portcfgshow option [slot/][ge]port [arguments] [optional arguments] Description Use this command to display the current configuration of a port. If no operand is specified, this command displays port configuration settings for all ports on a switch, except gigabit Ethernet (GbE) ports.
Page 491 portCfgShow VC Link Init Displays (..) or OFF when the long distance link initialization option is turned off. Displays ON when it is turned on for long distance mode. This value is set by the portCfgLongDistance command. Locked L_Port Displays ON when the port is locked to L_Port only. Displays (..) or OFF when L_Port lock mode is disabled and the port behaves as a U_Port).
Page 492 portCfgShow Notes The output of this command may vary depending on the hardware platform and port type. The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions" and Appendix A, "Command Availability" for details.
Page 493 portCfgShow Rate Limit ........ Credit Recovery ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON Ports of Slot 2 16 17 18 19 20 21 22 23 24 25 26 27...
Page 494 portCfgShow To display the configuration settings for a single port: switch:admin> portcfgshow 2/16 Area Number: Speed Level: AUTO AL_PA Offset 13: Trunk Port Long Distance VC Link Init Locked L_Port Locked G_Port Disabled E_Port ISL R_RDY Mode RSCN Suppressed Persistent Disable NPIV capability QOS E_Port Mirror Port...
Page 495 portCfgShow Local WWN 10:00:00:05:1e:39:80:65 Compression on Fastwrite off Tape Pipelining off Committed Rate 125000 Kbps (0.125000 Gbps) SACK on Min Retransmit Time 100 Keepalive Timeout 10 Max Retransmissions 8 VC QoS Mapping off DSCP (Control): 10, DSCP (Data): 40 VLAN Tagging Not Configured VC QoS Map: VC DSCP L2CoS VC DSCP L2CoS...
Page 496: Portcfgspeed
portCfgSpeed portCfgSpeed Configures the speed level for a specified port. Synopsis portcfgspeed [slotnumber/]portnumber, speed Description Use this command to set the speed on a specified speed. This command disables and then re-enables the port, so that it comes up with the new speed setting. The configuration is saved in nonvolatile memory and is persistent across switch reboots or power cycles.
Page 497: Portcfgtrunkport
portCfgTrunkPort portCfgTrunkPort Enables or disables trunking on a port. Synopsis portcfgtrunkport [slot/]port[,] mode Description 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.
Page 498: Portcfgvexport
portCfgVEXPort portCfgVEXPort Configures a port as a VEX_Port connected to an FC-IP and sets and displays VEX_Port configuration parameters. Synopsis portcfgvexport [slotnumber/]portnumber portcfgvexport [-a admin] portcfgvexport [-f fabricid] portcfgvexport [-r ratov] portcfgvexport [-e edtov] portcfgvexport [-d domainid] portcfgvexport [-p pidformat] portcfgvexport [-t fabric_parameter] portcfgvexport [-m portmode] Description...
Page 499 portCfgVEXPort The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions" and Appendix A, "Command Availability" for details. Operands This command has the following operands: -a admin Enables or disables the specified port as a VEX_Port.
Page 500 portCfgVEXPort principal WWN: 10:00:00:60:69:c0:05:8a Fabric Parameters: Auto Negotiate R_A_TOV: 9000(N) E_D_TOV: 2000(N) Edge fabric's primary wwn: N/A Edge fabric's version stamp: N/A To set the fabric ID of port 2/21 to 5 and the port ID format to core: switch:admin> portcfgvexport 2/21 -f 5 -p 1 To configure port 2/20 as a VEX_Port and set the fabric ID to 4: switch:admin>...
Page 501: Portcmd
portCmd portCmd Diagnoses intelligent ports. Synopsis portcmd action [slot/]geport arguments Description Use this command to invoke the end-to-end IP path performance (ipperf) characterization feature, or to ping or trace route to a destination IP host from an intelligent GbE port. Notes Virtual LAN (VLAN) tagging is supported on the Brocade FR4-18i and all 7500 platforms that run Fabric OS v6.0.0 or later.
Page 502 portCmd -r committed_rate Specifies a committed rate for the data stream, in Kbps. If specified, the traffic generator is limited by a traffic shaper. This characterizes the end-to-end IP path performance based on the data rate configured for a tunnel between the same end-points. If a rate is not specified, the traffic generator competes for uncommitted bandwidth.
Page 503 portCmd -d dst_ip Specifies the destination IP address to which to target the ping request. IPv6 addresses are supported. -n num_requests Specifies the number of ping requests. Valid values are 1 to 255. The default is 4. This operand is optional. -q service_type Specifies the type of service in the ping request.
Page 504 portCmd -z size Specifies the size, in bytes, of the trace route packet to use. The default is 64 bytes. In an IPv4 environment, the ICMP/IP header occupies 28 bytes. In an IPv6 environment, it occupies 48 bytes. The total size, including ICMP/IP headers (28 or 48 bytes without IP options), cannot be greater than the IP MTU configured on the interface.
Page 505: Portdebug
portDebug portDebug Sets debug level and verbose level of port modules. Synopsis portdebug dbg_lvl, vbs_lvl Description Use this command to set the debug level and verbose level of port modules. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 506: Portdisable
portDisable portDisable Disables a port. Synopsis portdisable [slot/]port Description Use this command to disable a port. If a port is connected to another switch when disabled, the fabric may reconfigure. Devices connected to this port can no longer communicate with the fabric. If the port was online before being disabled, a state transition will be indicated in one of the following ways: RSCN, SNMP trap, or Web pop-up window.
Page 507: Portenable
portEnable portEnable Enables a port. Synopsis portenable [slot/]port Description Use this command to enable a port. If a port is connected to another switch when enabled, the fabric may reconfigure. Devices connected to the port can now communicate with the fabric. For ports that come online after being enabled, the following indications might be sent to indicate a state transition: RSCN, SNMP trap, Web pop-up window.
Page 508: Porterrshow
portErrShow portErrShow Displays port error summary. Synopsis porterrshow Description Use this command to display an error summary for all ports. The display contains one output line per port and shows error counters in ones, thousands (k), or millions (m). frames tx Frames transmitted frames rx Frames received...
Page 509: Portflagsshow
portFlagsShow portFlagsShow Displays the port status bitmaps for all ports in a switch. Synopsis portflagsshow Description Use this command to display the following status for a port: SNMP Displays whether the port is online or offline. Physical Displays the port physical status. Valid values are In_Sync and No_Light. Flags Displays whether there is an SFP inserted in the port, whether the port is active, and the port type.
Page 510: Portledtest
portLedTest portLedTest Cycles user port LEDs. Synopsis portledtest [-npass count][-ports itemlist] Description Use this command to exercise the user port LEDs in the current switch on and off by setting the ATTN LEDs to green for the ON condition and unlighted for the OFF condition. The SPEED LEDs are initially set to black before the command execution.
Page 511: Portlogclear
portLogClear portLogClear Clears the port log. Synopsis portlogclear Description Use this command to clear the port log. You might want to clear the port log before triggering an activity so that the log displays only the log events related to that activity. If the port log is disabled, portLogClear enables it.
Page 512: Portlogconfigshow
portLogConfigShow portLogConfigShow Displays the current port log configuration. Synopsis portlogconfigshow Description Use this command to display the current port log configuration. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions" and Appendix A, "Command Availability" for details.
Page 513: Portlogdisable
portLogDisable portLogDisable Disables the port log facility. Synopsis portlogdisable Description Use this command to disable the port log facility. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions" and Appendix A, "Command Availability" for details.
Page 514: Portlogdump
portLogDump portLogDump Displays the port log without page breaks. Synopsis portlogdump [count[, saved[, portid]]] Description Use this command to display the port log, listing all entries in the log without page breaks. This command displays the same information as portLogShow, but portLogShow prompts you to press Enter between each page.
Page 515: Portlogdumpport
portLogDumpPort portLogDumpPort Displays the port log of a specified port without page breaks. Synopsis portlogdumpport portid Description Use this command to display the port log of a specified port. The command displays all entries in the log without any page breaks. It is identical to portLogShowPort, except that portLogShowPort prompts you to press Enter between each page.
Page 516: Portlogenable
portLogEnable portLogEnable Enables the port log facility. Synopsis portLogEnable Description Use this command to enable the port log facility. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions" and Appendix A, "Command Availability" for details.
Page 517: Portlogeventshow
portLogEventShow portLogEventShow Displays information about port log events. Synopsis portlogeventshow Description Use this command to display information about the ID associated with the various port log events. The Disabled field indicates whether the port log for that event ID is disabled (1) or enabled (0). Operands none Examples...
Page 518: Portloginshow
portLoginShow portLoginShow Displays port login status of devices attached to the specified port. Synopsis portloginshow [slotnumber/]portnumber Description Use this command to display port login 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: FDISC, Discover F_Port Service Parameters or Virtual N_Port login.
Page 519: Portlogpdisc
portLogPdisc portLogPdisc Sets or clears the debug_pdisc_flag. Synopsis portlogpdisc 0 | 1 Description Use this command to set or clear the debug_pdisc_flag. This command is part of the environmental monitor. A setting of 1 will enable logging of Port Discovery parameters. The PDISC log is disabled by default.
Page 520: Portlogreset
portLogReset portLogReset Enables the port log facility. Synopsis portlogreset Description Use this command to enable the port log facility. Notes Refer to portLogClear for events that might disable the port log facility. The execution of this command is subject to Admin Domain restrictions that may be in place.Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 521: Portlogresize
portLogResize portLogResize Resizes the port log to a specified number of entries. Synopsis portlogresize num_entries Description Use this command to resize the port log to a specified number of entries. If the specified number of entries is less than the already configured port log size, there is no change. Note The execution of this command is subject to Admin Domain restrictions that may be in place.
Page 522: Portlogshow
portLogShow portLogShow Displays the port log with page breaks. Synopsis portlogshow [count[, saved]] Description Use this command to display the port log, page by page. The portLogShow command displays the same information as portLogDump, but it enables you to press Enter after each page of output. Port logs are circular log files in the switch firmware, which can save up to 32,768 entries.
Page 523 portLogShow Speed negotiation states. fcin Incoming Fibre Channel information unit. fcout Outgoing Fibre Channel information unit. read Information unit header log from read operation. write Information unit header log from write operation. Information unit header log of an FC error frame. frame FC frame payload.
Page 524 portLogShow enable Mode: 0 normal; non-zero loopback. Tx & Rx Header words 0,1,4 (R_CTL,D_ID,S_ID,OX_ID,RX_ID) and the first payload word. reject FC-PH reject reason. busy FC-PH busy reason. ctin Argument 0 is divided into two 16-bit fields: [A] a bit map indicating whether subsequent arguments are valid (0001 means argument 1 is valid, 0003 means arguments 1 and 2 are valid).
Page 525 portLogShow Codes used in various fields are as follows: state Online Offline Testing Faulty E_Port F_Port Segmented pstate Active State Link Reset: LR Transmit State Link Reset: LR Receive State Link Reset: LRR Receive State Link Failure: NOS Transmit State Link Failure: NOS Receive State Offline: OLS Transmit State Offline: OLS Receive State...
Page 526 portLogShow Negotiation complete. Operands This command has the following operands: count Specify the maximum number of lines to display. Only the most recent count entries are displayed. This operand is optional. saved Specify a nonzero value to display the saved port log from the last switch fault.
Page 527: Portlogshowport
portLogShowPort portLogShowPort Displays the port log of a specified port with page breaks. Synopsis portlogshowport [portid] Description Use this command to display the port log of the specified port, showing all entries in the log with page breaks. It is identical to portLogDumpPort, except that portLogDumpPort does not prompt you to press Enter between each page of output.
Page 528: Portlogtypedisable
portLogTypeDisable portLogTypeDisable Disables the port log of a specified type. Synopsis portlogtypedisable id Description Use this command to disable the port log for a specified port log type. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 529: Portlogtypeenable
portLogTypeEnable portLogTypeEnable Enables the port log of a specified port log type. Synopsis portlogtypeenable id Description Use this command to enable the port log for a specified port log type. Note The execution of this command is subject to Admin Domain restrictions that may be in place.Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 530: Portloopbacktest
portLoopbackTest portLoopbackTest Performs a functional test of port N->N path. Synopsis portloopbacktest [--slot number][-nframes count][-lb_mode mode][-spd_mode mode] [-ports itemlist] Description Use this command to verify the functional operation of the switch by sending frames from the port N transmitter and looping them back into the same port N receiver. The loopback is done at the parallel loopback path.
Page 531 portLoopbackTest Operands This command has the following operands: --slot number Specifies the slot number on which to run the diagnostics. The ports specified will be relative to this slot number. The default is set to 0 and designed to operate on fixed-port-count products. -nframes count Specifies the number of frames to send.
Page 532 portLoopbackTest Diagnostics Following are possible error messages if failures are detected: DATA ERRSTAT INIT PORTDIED STATS TIMEOUT XMIT Refer to the Fabric OS Message Reference for more information. See Also itemList Fabric OS Command Reference 53-1000599-02...
Page 533: Portmirror
portMirror portMirror Adds, deletes, or shows mirror connections. Synopsis portmirror --show portmirror --add [slotnumber/]portnumber sourceID DestID portmirror --delete sourceID DestID] Description Use this command to add, delete, or show a mirror connection between two ports, a source and a destination port. The SourceID must be local to the switch.
Page 534 portMirror The portPerfShow command displays the total number of transmit and receive bytes for each port. In the case of a mirror port, the command shows double the amount of traffic because the mirror port transmits the frame and also receives the frame. Notes The port mirroring feature is only supported on the following platforms: Brocade 4100, Brocade 4900, Brocade 7600, and Brocade 48000 set to chassisConfig Option 5.
Page 535 portMirror To delete a port mirror connection between a local switch port and a remote switch port: switch:admin> portmirror --delete 0x011400 0x240400 To display port mirror connections: switch:admin> portmirror --show Number of mirror connection(s) configured: 2 Mirror_Port State ---------------------------------------- 10/12 0x791800 0x791900 Defined...
Page 536: Portname
portName portName Assigns a name to the specified port, or displays a port name. Synopsis portname [slotnumber/]portnumber [name] Description Use this command to assign or display a port name. This name is included in the portShow output; it should not be confused with the world wide port name. Like all other configurable port attributes, port name persists across reboots and power cycles.
Page 537: Portperfshow
portPerfShow portPerfShow Displays port throughput performance. Synopsis portperfshow [interval] Description Use this command to display throughput information for all ports on the switch. Output includes the number of bytes received plus the number of bytes transmitted per interval. Throughput values are displayed as either bytes, kilobytes (k), megabytes (m), or gigabytes (g).
Page 538: Portrouteshow
portRouteShow portRouteShow Displays routing tables for the specified port. Synopsis portrouteshow [slotnumber/]portnumber Description Use this command to display the port address ID and the contents of the following port routing tables: External unicast routing table Displays how the specified port forwards unicast frames to remote domains in the following format: domain_number: ports_bitmap domain_number...
Page 539 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...
Page 540: Portshow
portShow portShow Displays the status of the specified port. Synopsis portshow [slot/]port portshow [options] [slot/]geport arguments optional_arguments Description Use this command to display general port status and specific configuration parameters for the specified port If this command is executed for a specified port with no additional options, it displays general status and configuration for that port.
Page 541 portShow Testing Running diagnostics. Faulty Failed diagnostics. Persistently Disabled Persistently disabled. 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. No_Sync Receiving light but out of sync. In_Sync Receiving light and in sync.
Page 542 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.
Page 543 portShow Notes The output of this command may vary depending on the hardware platform and port type. The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions" and Appendix A, "Command Availability" for details.
Page 544 portShow The following arguments are supported with ficon: -globals Displays general FICON controls and statistics. -images Displays discovered Images (FCUB). -emul Displays emulated FDCBs. -active Displays active FDCBs. -epcb Displays Emulation Control Block (port specific). -fhpb Displays FICON Host Path Block. -fdpb adrs Displays FICON Device Path Block.
Page 545 portShow Timed_out: Invalid_word: 0 Rx_flushed: Invalid_crc: Tx_unavail: Delim_err: Free_buffer: Address_err: Overrun: Lr_in: Suspended: Lr_out: Parity_err: Ols_in: 2_parity_err: Ols_out: CMI_bus_err: Port part of other ADs: No To view xlate domains, you must be running a Brocade 7500 or 48000 with an FC4-18i blade. Note that the Front Domain ID is what is shown: switch:admin>...
Page 546 portShow Free_buffer: Address_err: Overrun: Lr_in: Suspended: Lr_out: Parity_err: Ols_in: 2_parity_err: Ols_out: CMI_bus_err: Port part of other ADs: No To display IPv4 interfaces on a GbE port: switch:admin> portshow ipif 10/ge0 Slot: 10 Port: ge0 Interface IP Address NetMask ---------------------------------------------- 192.168.60.100 255.255.255.0 1500 Interface IP Address...
Page 547 portShow To display the connection parameter information on an FCIP tunnel on a GbE port and to show the current DiffServ markings being used for data connection as well as control connection: switch:admin> portshow fciptunnel 9/ge0 0 -params Slot: 9 Port: ge0 ------------------------------------------- Tunnel ID 0 Remote IP Addr 10.62.0.100...
Page 548 portShow negotiated window scale (shift count) 9 congestion window 43252 Bytes slow start threshold 1072 Bytes operational mode: congestion avoidance 1 packets queued: TCP sequence# MIN(4108052700) MAX(4108052792) NXT(4108052792) 1 packets in-flight Send.Unacknowledged(TCP sequence# 4108052700) recovery: retransmit timeout 100 ms, duplicate ACKs 0 retransmits 0 (max retransmits 9) loss recovery: fast retransmits 0, retransmit timeouts 1...
Page 549 portShow 1655 Bps 30s avg, 4305 Bps lifetime avg 951 packets lost (retransmits) 12.25% loss rate 30s avg 38563 input packets 2 pkt/s 30s avg, 4 pkt/s lifetime avg 8208640 input Bytes 699 Bps 30s avg, 1035 Bps lifetime avg Data transfer TCP connection: Local 10.10.9.100:4100, Remote 10.62.0.100:3226 Performance stats:...
Page 550 portShow Encryption: AES-128 SA Life (seconds): 28800 Pre-Shared Key testingFIPSandIPSec To show the ARP entries with local MAC address for a GbE port: switch:admin> portshow arp 12/ge0 -lmac Port: ge0 Local MAC Address: 00:05:1e:35:1e:e5 IP Address Mac Address Flags ------------------------------------------------------ 192.168.15.20 00:05:1e:37:0f:a5 Permanent Resolved...
Page 551 portShow ip_api_data_credit_target = 32 ip_api_data_credit_ratio = 80 ip_api_credit_time = 15 ip_api_cwnd_overcommit = 29760 FC control traffic TCP connection: Local 10.10.9.100:4099, Remote 10.62.0.100:3225 Data transfer TCP connection: Local 10.10.9.100:4100, Remote 10.62.0.100:3226 IKE Policy 1 IPSec Policy 1 Pre-Shared Key testingFIPSandIPSec To display QoS Mappings: switch:admin>...
Page 552 portShow This command displays the same information as the previous but posts selected statistical areas: switch:admin> portshow ficon ge0 all -fdcb 10008000 -clear See Also authUtil, portCfg, portCfgLongDistance, portLoginShow, portName, switchShow Fabric OS Command Reference 53-1000599-02...
Page 553: Portstats64Show
portStats64Show portStats64Show Displays the 64-bit hardware statistics for a port. Synopsis portstats64show [slotnumber/]portnumber Description Use this command to display the following hardware statistics for a port. Two integers are reported for most values. In such cases, the top word is the most significant. stat64_wtx Number of 4-byte words transmitted.
Page 554 portStats64Show stat64_rateRxPeakByte Rx peak Byte rate (Bps). stat64_PRJTFrames Number of P_RJT frames transmitted. stat64_PBSYFrames Number of P_BSY transmitted. stat64_inputBuffersFull Occasions on which input buffers are full. stat64_rxClass1Frames Class 1 frames received. Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 555 portStats64Show er_bad_eof top_int : Frames with bad end-of-frame bottom_int : Frames with bad end-of-frame er64_enc_out top_int : Encoding error outside of frames 9131157 bottom_int : Encoding error outside of frames er64_disc_c3 top_int : Class 3 frames discarded bottom_int : Class 3 frames discarded stat64_rateTxFrame Tx frame rate (fr/sec) stat64_rateRxFrame...
Page 556: Portstatsclear
portStatsClear portStatsClear Clears the hardware statistics of a port. Synopsis portstatsclear [slot/]port Description Use this command to clear the hardware statistics for a specified port. This command also clears the hardware statistics for the associated three ports in the target port's quad, including ALPA-based CRC monitor, End-to-End monitor, and Filter-based performance monitor statistics.
Page 557: Portstatsshow
portStatsShow portStatsShow Displays port hardware statistics. Synopsis portstatsshow [slotnumber/]portnumber portstatsshow [ge | ip | fcip ] [slotnumber/]geportnumber [ipaddress | tunnelnumber] Description Use this command to display port hardware statistics counters. Some counters are platform- and port-specific and display only with those platforms and ports. All statistics have a maximum 32-bit value of 4,294,967,295.
Page 558 portStatsShow er_other_discard The number of other discards (platform- and port-specific). er_zone_discard The number of class 3 frames discarded due to zone mismatch. er_type1_miss The number of frames with FTB type 1 miss. er_type2_miss The number of frames with FTB type 2 miss. er_type6_miss The number of frames with FTB type 6 miss.
Page 559 portStatsShow stat_frx 8045 Frames received stat_c2_frx Class 2 frames received stat_c3_frx 3441 Class 3 frames received stat_lc_rx 2242 Link control frames received stat_mc_rx Multicast frames received stat_mc_to Multicast timeouts stat_mc_tx Multicast frames transmitted tim_rdy_pri Time R_RDY high priority tim_txcrd_z 318034725 Time TX Credit Zero (2.5Us ticks) time_txcrd_z_vc 0- 3:...
Page 560 portStatsShow ge_err_overrun GE overruns ge_err_fifo_ovf GE Fifo overflow To display statistics for FCIP tunnel 2, slot 8, and GbE port 1: switch:admin> portstatsshow fcip 8/ge1 2 tunnel_id Tunnel ID fcip_ip2fc_bytes uncompressed bytes fcip_ip2fc_pkts pkt rvd by fcip entity from ip fcip_ip2fc_wantov_drop pkt dropped due to wantov fcip_fc2ip_pkts...
Page 561: Portswap
portSwap portSwap Swaps area numbers of two ports. Synopsis portswap [slotnumber1/]portnumber1 [slotnumber2/]portnumber2 Description Use this command to swap area numbers for a pair of ports. Both ports must be disabled prior to executing this command and the port-swapping feature must be enabled using portSwapEnable. The result of this operation is persistent across reboots and power cycles.
Page 562: Portswapdisable
portSwapDisable portSwapDisable Disables the portswap feature. Synopsis portswapdisable Description Use this command to disable the portswap feature. The portSwap command cannot be used after this feature is disabled. The 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.
Page 563: Portswapenable
portSwapEnable portSwapEnable Enables the portswap feature. Synopsis portswapenable Description Use this command to enable the portswap feature. The portSwap command cannot be used unless the feature is first enabled with this command. The enabled state of the portswap feature is persistent across reboots and power cycles. Enabling or disabling the portswap feature does not affect previously performed portswap operations.
Page 564: Portswapshow
portSwapShow portSwapShow Displays the state of the portswap feature. Synopsis portswapshow Description Use this command to display the enabled state of the portswap feature, as well as port and area information for ports whose area number differs from the default area number. The default area number of a port is the same as its switch port number.
Page 565: Porttest
portTest portTest Performs a functional test of a switch in a live fabric. Synopsis porttest [-ports itemlist][-iteration count][-userdelay time][-timeout time][-pattern pattern] [-patsize size][-seed seed][-listtype porttype] Description Use this command to isolate problems to a single replaceable element and isolate problems to near-end terminal equipment, far-end terminal equipment, or transmission line.
Page 566 portTest -iteration count Specify the number of times (or number of frames per port) to execute this test. Default value is 20. Valid values include: Run the test on timeout mode. -1 Run indefinitely. -userdelay time Specify the delay between frames sent by portTest, in milliseconds. The default value is 10 milliseconds.
Page 567: Porttestshow
portTestShow portTestShow Displays information from portTest. Synopsis porttestshow [-ports itemlist] Description Use this command to display a snapshot of information from portTest. The following information displays: • Pass or fail information on a given port. • Port type tested. • Current state of portTest (NO TEST, TESTING, or TEST DONE).
Page 568: Porttrunkarea
portTrunkArea portTrunkArea Assigns or removes a trunk area (TA) from a port or port trunk group; displays masterless F_Port trunking configuration. Synopsis porttrunkarea --enable port[-Range] -area area_number porttrunkarea --enable slot/port[-Range] -index port_index porttrunkarea --disable [slot/]port[-Range] porttrunkarea --disable all porttrunkarea --show disabled | enabled | trunk | all porttrunkarea --show slot/port[-Range] Description Use this command to assign a static trunk area (TA) on a port or port trunk group, to remove a TA...
Page 569 portTrunkArea deskew The time difference for traffic to travel over each F_Port trunk as compared to the F_Port trunk with the shortest travel time in the group. The value is expressed in nanoseconds divided by 10. The firmware automatically sets the minimum deskew value of the shortest F_Port trunk travel time to 15.
Page 570 portTrunkArea port Specifies the port number, relative to its slot on bladed systems. -Range Optionally specifies a port range. For example, 9/8-15 on an enterprise-class platform indicates slot 9, ports 8 - 15. Range of ports should fall in the octet trunk range starting from port 0 on a switch or blade.
Page 571 portTrunkArea Examples To enable masterless F_Port trunking on a standalone switch: 1. Disable ports 36 - 39 by executing portdisable port for each port to be included in the TA. 2. Enable Trunk Area for ports 36 - 39 with area number 37: switch:admin>...
Page 572 portTrunkArea No_Light No_Light No_Light No_Light Online F-Port 20:14:00:05:1e:41:4b:4d Online F-Port 20:15:00:05:1e:41:4b:4d Online F-Port 20:16:00:05:1e:41:4b:4d Online F-Port 2 NPIV public 5. Display TA enabled port configuration: switch:admin> porttrunkarea --show enabled Port Type State Master ------------------------------------- To disable masterless F_Port trunking on ports 36-39: switch:admin>...
Page 573 portTrunkArea 4. Enable ports 13 and 14: switch:admin> portenable 10/13 switch:admin> portenable 10/14 5. Show the TA port configuration after enabling the ports: switch:admin> porttrunkarea --show enabled Slot Port Type State Master ------------------------------------------- F-port Master 10/13 125 125 F-port Slave 10/13 125 126 See Also...
Page 574: Portzoneshow
portZoneShow portZoneShow Displays the enforced zone type of the F_Ports and FL_Ports of a switch. Synopsis portzoneshow Description 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.
Page 575: Powerofflistset
powerOffListSet powerOffListSet Sets the order in which slots are powered off. Synopsis powerofflistset Description 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.
Page 576 powerOffListSet 2nd slot to be powered off: (2..10) [9] 2 3rd slot to be powered off: (3..10) [8] 3 4th slot to be powered off: (4..10) [7] 4 5th slot to be powered off: (7..10) [7] 10 6th slot to be powered off: (7..9) [8] 9 7th slot to be powered off: (7..8) [8] 8 8th slot to be powered off: (7..7) [7] 7 Old POL...
Page 577: Powerofflistshow
powerOffListShow powerOffListShow Displays the order in which slots are powered off. Synopsis powerofflistshow Description 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.
Page 578: Psshow
psShow psShow Displays power supply status. Synopsis psshow Description Use this command to display the current status of the switch power supplies. The status of each supply is displayed as: Power supply functioning correctly. absent Power supply not present. unknown Unknown power supply unit installed.
Page 579: Reboot
reboot reboot Reboots the control processor (CP) in a switch or a director. Synopsis reboot -f Description When this command is issued on a switch, if the switch is part of 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 online.
Page 580: Routehelp
routeHelp routeHelp Displays a list of FSPF-related commands. Synopsis routehelp Description Use this command to display a list of fabric-shortest-path-first (FSPF)-related commands. Operands none Examples To display a list of routing-related commands: switch:admin> routehelp aptpolicy Get and set Advanced Performance Tuning policy bcastshow Display broadcast routing information dlsreset...
Page 581: Secactivesize
secActiveSize secActiveSize Displays the size of the active security database. Synopsis secactivesize Description Use this command to display the size of the active security database. The command also displays the maximum database size. For switches running Fabric OS v6.0.0 and later, the maximum security database size is 1 Megabyte.
Page 582: Secauthsecret
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.
Page 583 secAuthSecret 1. WWN for which secret is being set up. 2. Peer secret: The secret of the peer that authenticates to peer. 3. Local secret: The local secret that authenticates peer. Press Enter to start setting up shared secrets > Enter WWN, Domain, or switch name (Leave blank when done): 10:00:00:60:69:80:05:14 Enter peer secret:...
Page 584: Seccertutil
secCertUtil secCertUtil Manages certificates on a switch. Synopsis seccertutil seccertutil genkey [-nowarn] [-keysize 1024 | 2048] seccertutil delkey [-nowarn] seccertutil gencsr [-country country code] [-state state] [-locality locality] [ -org organization] [-orgunit organization unit] [-cn common name] seccertutil delcsr [-nowarn] seccertutil showcsr seccertutil delete [-ldapcacert] file name [-nowarn] seccertutil export [-ldapcacert] [-certname certificate name]] [-protocol ftp | scp] [-ipaddr IP...
Page 585 secCertUtil Operands This command has the following operands: genkey Generates a public/private key pair. This is the first step in setting up a third-party certificate. When prompted for a key size, enter either 1024 or 2048 bits. The greater the value, the more secure is the connection; however, performance degrades with size.
Page 586 secCertUtil delcsr [-nowarn] Deletes CSR. This command prompts for confirmation before deleting the CSR unless -nowarn is specified. delete Deletes the specified certificate. The following operands are optional; -ldapcacert Deletes a LDAP CA certificate. You must specify a file name for the LDAP CA certificate.
Page 587 secCertUtil Specifies the protocol as either FTP or SCP. -ipaddr IP address Specifies the IP address of the remote host. -remotedir remote directory Specifies the remote directory. Provide a fully qualified path name. -certname certificate name Specifies the certificate name. -login login name Specifies the login name for the server.
Page 588 secCertUtil To generate a CSR in non-interactive mode: switch:admin> seccertutil gencsr -country US -state California -locality "San Jose" \ -org Brocade -orgunit software -cn 192.168.38.206 generating CSR, file name is: 192.168.38.206.csr Done To delete the CSR in interactive mode: switch:admin> seccertutil delcsr WARNING!!! About to delete CSR: 192.168.163.238.csr ARE YOU SURE (yes, y, no, n): [no] y...
Page 589 secCertUtil Enter remote directory: /users/home/remote/mycerts Enter Login Name: username Enter LDAP certificate name (must have ".pem" \ suffix):filename.cer Password:password Success: exported LDAP certificate To export an LDAP CA certificate from the local switch to a remote host in non-interactive mode: switch:admin>...
Page 590: Secdefinesize
secDefineSize secDefineSize Displays the size of the defined security database. Synopsis secdefinesize Description Use this command to display the size of the defined security database. The command also displays the maximum database size. Notes For switches running Fabric OS v6.0.0 and later, the maximum security database size is 1 MB. For switches running earlier versions of Fabric OS (up to v5.3.0), the maximum is 256 KB.
Page 591: Secglobalshow
secGlobalShow secGlobalShow Displays the current internal security state information. Synopsis secglobalshow Description Use this command to display security server (secd) specific information as a snapshot of its current state. The output may include information about the following: • General security parameters •...
Page 592 secGlobalShow 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----- 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...
Page 593: Sechelp
secHelp secHelp Displays information about security commands. Synopsis sechelp Description Use this command to display a list of security commands with a brief description of the commands. Operands none Examples To display a list of security commands: switch:admin> sechelp fipscfg Configure FIPS mode operation pkicreate Creates public key infrastructure (PKI) objects...
Page 594: Secpolicyabort
secPolicyAbort secPolicyAbort Aborts all changes to the defined database that have not been saved. Synopsis secpolicyabort Description Use this command to abort all changes to the defined security database that have not been saved to flash memory and to abort changes to policy creation and modification operations from all the switches if a fabric-wide consistency policy is not set for the particular policy.
Page 595: Secpolicyactivate
secPolicyActivate secPolicyActivate Saves and activates the Defined Security Policy Set. Synopsis secpolicyactivate Description Use this command to activate the current defined security policy to all switches in the fabric. This activates the policy set on the local switch or all switches in the fabric depending on the fabric-wide consistency policy.
Page 596: Secpolicyadd
secPolicyAdd secPolicyAdd Adds members to an existing security policy. Synopsis secpolicyadd “name”, “member[;member...]” Description Use this command to add one or more members to an existing access policy. The new members must not already be members within the policy or the command fails. Each policy corresponds to a management method.
Page 597 secPolicyAdd The following policy types require members be specified by WWN address: • FCS_POLICY • SCC_POLICY These policy types require members be specified as WWN strings, domain IDs, or switch names. If domain ID or switch names are used, the switches associated must be present in the fabric or the command fails.
Page 598: Secpolicycreate
secPolicyCreate secPolicyCreate Creates a new security policy. Synopsis secpolicycreate "name" [, "member[;member...]"] Description Use this command to create a new policy and to edit 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.
Page 599 secPolicyCreate "member" Specify one or more members to be included in the security policy. The member list must be enclosed in double quotation marks and members separated by semicolons. The member list must be separated from the name field by a comma and a space. Depending on the policy type, members are specified as follows: DCC_POLICY Members The DCC_Policy_nnn is a list of devices associated with a specific switch and...
Page 600 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...
Page 601: Secpolicydelete
secPolicyDelete secPolicyDelete Deletes an existing security policy. Synopsis secpolicydelete name Description 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.
Page 602 secPolicyDelete See Also secPolicyAbort, secPolicyActivate, secPolicyAdd, secPolicyCreate, secPolicyDump, secPolicyRemove, secPolicySave, secPolicyShow Fabric OS Command Reference 53-1000599-02...
Page 603: Secpolicydump
secPolicyDump secPolicyDump Displays all members of existing security policies. Synopsis secpolicydump [“listtype”][, “name”] Description Use this command to display, without page breaks, the members of an existing policy in the active and defined (saved) databases. Notes The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions"...
Page 604 secPolicyDump See Also secPolicyAbort, secPolicyActivate, secPolicyAdd, secPolicyCreate, secPolicyDelete, secPolicyRemove, secPolicySave, secPolicyShow Fabric OS Command Reference 53-1000599-02...
Page 605: Secpolicyfcsmove
secPolicyFCSMove secPolicyFCSMove Moves a member in the FCS policy. Synopsis secpolicyfcsmove [from, to] Description Use this command to move an FCS member from one position to another position in the FCS list. Only one FCS can be moved at a time. The first FCS switch in the list that is also present in the fabric is the Primary FCS.
Page 606 secPolicyFCSMove switch:admin> secpolicyfcsmove 3,1 ____________________________________________________ DEFINED POLICY SET FCS_POLICY Primary WWN DId swName -------------------------------------------------- 10:00:00:05:1e:35:cd:ef 200 switch3 10:00:00:05:1e:39:5f:67 2 switch1 10:00:00:05:1e:04:ef:0e 4 switch2 switch:admin> secpolicyactivate About to overwrite the current Active Policy Set. ARE YOU SURE (yes, y, no, n): [no] y secpolicyactivate command was completed successfully.
Page 607: Secpolicyremove
secPolicyRemove secPolicyRemove Removes members from an existing security policy. Synopsis secpolicyremove “name” , “member[;member...]” Description 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.
Page 608 secPolicyRemove parameter can be specified by port number separated by commas, and enclosed in either brackets or parentheses: for example, (2, 4, 6). Ports enclosed in brackets include the devices currently attached to those ports. The following examples illustrate several ways to specify the port values: (1-6) Selects ports 1 through 6.
Page 609: Secpolicysave
secPolicySave secPolicySave Saves a defined security policy to persistent memory. Synopsis secpolicysave Description 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. Notes This command is always a local switch operation.
Page 610: Secpolicyshow
secPolicyShow secPolicyShow Displays an existing security policy including the FCS policy. Synopsis secpolicyshow [“policy_set”[“, name”]] Description Use this command to display the members of an existing policy in the Active or Defined security policy set. The command can be issued from all FCS switches. This command displays the policy database one page at a time.
Page 611 secPolicyShow To display all security policies from defined databases: switch:admin> secpolicyshow "defined" ____________________________________________________ DEFINED POLICY SET FCS_POLICY Primary WWN DId swName _____________________________________________________ 10:00:00:60:69:30:15:5c 1 primaryfcs 10:00:00:60:69:30:1e:62 4 switch _________________________________________________________ See Also fddCfg, secPolicyAbort, secPolicyActivate, secPolicyAdd, secPolicyCreate, secPolicyDelete, secPolicyDump, secPolicyRemove, secPolicySave Fabric OS Command Reference 53-1000599-02...
Page 612: Secstatsreset
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 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.
Page 613 secStatsReset To access DCC policies, enter DCC_POLICY. Violations are not tracked for individual DCC policies. The statistics for all DCC_POLICY violations are grouped together. domain(s) Specify a list of domain IDs on which to reset the security statistics. Specify an asterisk (*) to represent all switches in the fabric or specify a list of domains, separated by semicolons and enclosed in quotation marks.
Page 614: Secstatsshow
secStatsShow secStatsShow Displays one or all security statistics. Synopsis secstatsshow [name[, “domain[;domain]”]] Description Use this command to display one or all security statistics. This command can be issued on any switch to display local security statistics. If 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.
Page 615 secStatsShow To access DCC policies, enter DCC_POLICY. Violations are not tracked for individual DCC policies. The statistics for all DCC_POLICY violations are grouped together. domain Specify one or more domains for which to display the security statistics. Specify an asterisk (*) in quotation marks to represent all switches in the fabric or specify a list of domains separated by semicolons.
Page 616: Sensorshow
sensorShow sensorShow Displays sensor readings. Synopsis sensorshow Description Use this command to display the current temperature, fan, and power supply status and readings from sensors located on the switch. The actual location of the sensors varies, depending on the switch type. Operands none Examples...
Page 617: Setdbg
setDbg setDbg Sets the debug level of the specified module. Synopsis setdbg [module_name][level] Description Use this command to set the debug level of a specified module. Debug levels filter the display of debug messages to the serial console. By default, no debug messages are displayed. High debug level values can generate a large volume of messages, degrading the system response time.
Page 618: Setmodem
setModem setModem Enables or disables modem dial-in to a control processor (CP). Synopsis setmodem [-e] | [-d] Description Use this command to enable or disable modem dial-in to a CP on those systems that support modem dial-in. When modem dial-in is enabled, you can log in to a CP through a modem, and a modem attached to the CP accepts the call.
Page 619 setModem In the recommended configuration, a separate modem is connected to each modem port of CP0 and CP1. These modems connect to the telephone outlet through an RJ-11 Y-adapter and standard telephone wire (see Figure ) is attached to the wall outlet, as shown in the figure. During an incoming call, both modems ring and the one connected to the active CP answers the call first.
Page 620: Setverbose
setVerbose setVerbose Specifies module verbose level. Synopsis setverbose [module_name][level] Description Use this command to set the verbose level of the specified module. These levels filter the display of the debug message to the serial console. By default, no debug messages are displayed. Note The execution of this command is subject to Admin Domain restrictions that may be in place.
Page 621: Sfpshow
sfpShow sfpShow Displays Small Form-factor Pluggable SFP information. Synopsis sfpshow [[slotnumber/]geportnumber | -all] Description Use this command to display information about Serial Identification SFPs (also known as module definition "4" SFPs). These SFPs provide extended information that describes the SFP’s capabilities, interfaces, manufacturer, and other information.
Page 622 sfpShow Area 12: -- Area 13: -- Area 14: -- Area 15: -- Area 16: id (sw) Vendor: AGILENT Serial No: 0105091301045274 (output truncated) To display detailed SFP information for a Finisar “smart” SFP: switch:user> sfpshow 1/3 Identifier: Connector: Transceiver: 050c402000000000 100,200_MB/s M5,M6 sw Inter_dist Encoding: 8B10B Baud Rate:...
Page 623 sfpShow To display detailed information for GbE port 0 on an FR4-18i router blade: CS48000:admin> sfpshow 10/ge0 Identifier: Connector: Transceiver: 050c402000000000 100,200_MB/s M5,M6 sw Inter_dist Encoding: 8B10B Baud Rate: (units 100 megabaud) Length 9u: (units km) Length 9u: (units 100 meters) Length 50u: (units 10 meters) Length 62.5u:15...
Page 624 sfpShow Length 9u: (units km) Length 9u: (units 100 meters) Length 50u: (units 10 meters) Length 62.5u:15 (units 10 meters) Length Cu: (units 1 meter) Vendor Name: IBM Vendor OUI: 08:00:5a Vendor PN: IBM42P21SNY Vendor Rev: AA10 Wavelength: (units nm) Options: 001a Loss_of_Sig,Tx_Fault,Tx_Disable BR Max:...
Page 625: Shellflowcontroldisable
shellFlowControlDisable shellFlowControlDisable Disables XON/XOFF flow control on the console serial port. Synopsis shellflowcontroldisable Description 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.
Page 626: Shellflowcontrolenable
shellFlowControlEnable shellFlowControlEnable Enables XON/XOFF flow control on the console serial port. Synopsis shellflowcontrolenable Description Use this command to enable XON/XOFF flow control to the shell task. Flow control is disabled by default. Because this command changes the flow control on the console serial port, it must be executed from a session that is logged in from the console serial port.
Page 627: Slotpoweroff
slotPowerOff slotPowerOff Removes power from a slot. Synopsis slotpoweroff slotnumber Description Use this command to turn off the power to a blade unit. The slot must have a valid blade unit present and the blade unit must be of a type that can be powered off. Notes The execution of this command is subject to Admin Domain restrictions that may be in place.
Page 628: Slotpoweron
slotPowerOn slotPowerOn Restores power to a slot. Synopsis slotpoweron slotnumber Description Use this command to turn on the power to a blade unit. The slot must have a valid blade unit present and the blade unit must be currently powered off. The slotShow command reports such slots as being in the state of INSERTED, NOT POWERED ON.
Page 629: Slotshow
slotShow slotShow Displays the status of all slots in the system. Synopsis slotshow [-m] [-p] Description 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.
Page 630 slotShow DIAG RUNNING POST1 The blade is present, powered on, and running the POST (power-on self-test). DIAG RUNNING POST2 The blade is present, powered on, and running the pre-boot power on self tests. INITIALIZING The blade is present, powered on, and initializing hardware components. ENABLED The blade is on and fully enabled.
Page 631 slotShow To display power consumption information: switch:user> slotshow -p Slot Blade Type DC Power Status Consumption ------------------------------------------------- SW BLADE ENABLED SW BLADE ENABLED SW BLADE ENABLED AP BLADE ENABLED CP BLADE ENABLED CP BLADE ENABLED AP BLADE ENABLED UNKNOWN VACANT UNKNOWN VACANT UNKNOWN...
Page 632: Snmpconfig
snmpConfig snmpConfig Manages the SNMP agent configuration. Synopsis snmpConfig --show | --set | --default [snmpv1 | snmpv3 | accessControl | mibCapability | systemGroup | seclevel] Description Use this command to manage the configuration of the SNMP agent in the switch. The configuration includes SNMPv1 and SNMPv3 configuration, access control list (ACL), MIB capability, system group, and security level settings.
Page 633 snmpConfig SNMPv1 Configuration Parameters The agent supports six communities and associated trap recipients and trap recipient severity level supported. The first three communities are for read-write (rw) access and the last three are for read-only (ro) access. The default value for the trap recipient of each community is 0.0.0.0. The length of the community string should be in range of 2 to 16 characters.
Page 634 snmpConfig The user name must be between 2 and 32 characters long. Note that the default user names are defined with the noAuth and noPriv protocol. The factory default SNMPv3 user names are: User 1: snmpadmin1 User 2: snmpadmin2 User 3: snmpadmin3 User 4: snmpuser1 User 5: snmpuser2 User 6: snmpuser3...
Page 635 snmpConfig SCSI-MIB Specifying yes means you can access FCIP-MIB variables with an SNMP manager. The default value is yes. SW-TRAP Specifying yes means the SNMP management application can receive SW-TRAPS from the switch. The default value is “yes”. You may also turn individual SW Traps on or off.
Page 636 snmpConfig Examples To display the SNMPv1 configuration: switch:admin> snmpConfig --show snmpv1 SNMPv1 community and trap recipient configuration: Community 1: Secret C0de (rw) Trap recipient: 10.32.147.113 Trap recipient Severity Level: 0 Community 2: OrigEquipMfr (rw) Trap recipient: 1080::8:800:200C:1234 Trap recipient Severity Level: 0 Community 3: private (rw) No trap recipient configured yet Community 4: public (ro)
Page 637 snmpConfig To display the mibCapability configuration: switch:admin> snmpconfig --show mibCapability FE-MIB:YES SW-MIB: YES FA-MIB: YES FICON-MIB: YES HA-MIB: YES FCIP-MIB: YES ISCSI-MIB: YES SW-TRAP: YES swFCPortScn: YES swEventTrap: YES swFabricWatchTrap: YES swTrackChangesTrap: YES FA-TRAP: YES connUnitStatusChange: YES connUnitEventTrap: YES connUnitSensorStatusChange: YES connUnitPortStatusChange: YES SW-EXTTRAP: YES FICON-TRAP: YES...
Page 638 snmpConfig See Also none Refer to the following publications for further information on SNMP: Fabric OS MIB Reference SW_v5_x.mib, “Switch Management Information & Switch Enterprise Specific Trap” RFC1157, “A Simple Network Management Protocol (SNMPv1)” RFC1213, “Management information Base for Network Management of TCP/IP-based internets: MIB-II”...
Page 639: Spinfab
spinFab spinFab Runs functional test of switch-to-switch ISL cabling and trunk group operation. Synopsis spinfab [-nmegs count][-ports itemlist][-setfail mode] Description Use this command to verify the intended functional operation of the ISL links between switches. At the maximum speed of 4 Gbps, set the routing hardware such that test frames received by each E_Port retransmit on the same E_Port.
Page 640 spinFab -setfail mode Instruct spinFab how to mark failed ports. Specify 1 to mark failing ports as FAILED. Specify 0 not to mark failed ports as FAILED. This test normally logs errors but does not set the port status to FAILED. This parameter is provided to force the failing ports to be marked as FAILED in the same manner as other diagnostics.
Page 641 spinFab Refer to the Fabric OS Message Reference for more information. See Also itemList, portLoopbackTest Fabric OS Command Reference 53-1000599-02...
Page 642: Sshutil
sshUtil sshUtil Manages public key authentication. Synopsis sshutil allowuser user name sshutil showuser sshutil importpubkey sshutil showpubkeys sshutil delpubkeys sshutil genkey sshutil exportpubkey sshutil delprivkey sshutil help 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.
Page 643 sshUtil Operands This command supports the following operands: allowuser user name Configures the specified user to perform public key authentication and all related management operations. This operation can only be performed by the default admin. The default admin is, by default, a configured user. Only one user can be configured at any given time.
Page 644 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. Good pass phrases are 10-30 characters long, are not simple sentences or otherwise easily guessable and contain a mix of upper and lowercase letters, numbers, and non-alphanumeric characters.
Page 645 sshUtil Password: public key is imported successfully. 3. Connect to switch using remote ssh client with the -i private_key option: username@remotehost> ssh username@switch IP address -i id_dsa To display the imported public keys on a switch: switch:username> sshutil showpubkeys user's public keys ssh-dss AAAAB3NzaC1kc3MAAACBANXuRsJoIA0PFJtGuZVLfqvfSrDYPplWuFouOmTcmuNvpTnd+yoZ u3C/lAu930HLTmhfxeke/NWRIdj2MJS8yTf30a0u4bf9MSNB8Pt453P/+7VHHxNBYsh+Z++Dv1hfcTeb 0s53bdf7jyYSUdj1k+w//sNTaz0DCs0+rimo4l2NAAAAFQDCuHKRctSHD8PRYu5Ee1yWCQKT/wAAAIAo...
Page 646: Statsclear
statsClear statsClear Clears port and diagnostic statistics. Synopsis statsclear [--slot slotnumber][-uports itemlist][-bports itemlist][-use_bports value] Description Use this command to clear the port and diagnostics statistics for the specified list of blade or user ports. You can issue this command on the FR4-18i blade in a Brocade chassis; however, the command is not supported by the Brocade platform and does not effect any other feature operations.
Page 647: Stopporttest
stopPortTest stopPortTest Terminates the running portTest. Synopsis stopporttest [-ports itemlist] Description Use this command to stop the currently running portTest. Refer to the portTest command for more information. If portTest is running in non-singlemode, use stopPortTest to stop the test. Note The execution of this command is subject to Admin Domain restrictions that may be in place.
Page 648: Supportffdc
supportFfdc supportFfdc Modifies or displays the first-fault data capture (FFDC) daemon. Synopsis supportffdc [--disable | --enable | --show] Description 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.
Page 649: Supportftp
supportFtp supportFtp Sets, clears, or displays support FTP parameters, or a time interval to check the FTP server. Synopsis supportftp [-S] supportftp -s [-h hostip][-u username][-p password][-d remotedirectory] supportftp -t hours supportftp -R supportftp -e Description Use this command to set, clear, or display support FTP parameters, or a time interval to check the FTP server.
Page 650 supportFtp Host IP Addr: 1080::8:800:200C:417A User name: njoe Remote Dir: support FTP Auto check: Off To set FTP parameters interactively: switch:admin> supportftp -s Host IP Addr[1080::8:800:200C:417A]:192.168.67.126 User Name[njoe]:admin Password[********]:password Remote Dir[support]:temp Auto file transfer parameters changed To display a time interval to check the FTP server: switch:admin>...
Page 651: Supportsave
supportSave supportSave Saves RASLOG, TRACE, supportShow, core file, FFDC data, and other support information Synopsis supportsave supportsave [-n] [-c] [-k] [-u user_name -p password] -h host_ip -d remote_dir [-l ftp| scp] supportsave [-R] supportsave [-U -d remote_dir] Description Use this command to collect RASLOG, TRACE, supportShow, core file, FFDC data and other support information to a remote FTP location.
Page 652 supportSave -d remote_dir Specifies the remote directory to which the file is to be transferred. When saving to a USB device, the predefined directory must be used. /support Removes all core files on the CP and BP. This option is exclusive with all other options.
Page 653 supportSave Saving support information for switch:Stealth200E, module:CHKRPM..tSave_files/Stealth200E-S0-200802171133-CHKRPM.gz: 969.00 B 24.08 kB/s Saving support information for switch:Stealth200E, module:SSLOG..ave_files/Stealth200E-S0-200802171134-SSLOG.ss.gz: 1.78 kB 47.60 kB/s Saving support information for switch:Stealth200E, module:SUPPORTSHOW..........................(output truncated) To save RASLOG, TRACE, supportShow, core file, FFDC data, and other information to an FTP server in interactive mode on a dual-CP system: switch:admin>...
Page 654 supportSave Saving support information for switch:art_saturn1, module:VARLOGTIME..e_files/art_saturn1-S6-200802171211-VARLOGTIME.gz: 281.00 B 8.00 kB/s Saving support information for switch:art_saturn1, module:BURNINSTAT..e_files/art_saturn1-S6-200802171211-BURNINSTAT.gz: 134.00 B 3.67 kB/s Saving support information for switch:art_saturn1, module:BURNINERR..files/art_saturn1-S6-200802171211-BURNINERR.ss.gz: 2.35 kB 67.80 kB/s Saving support information for switch:art_saturn1, module:RTE..tSave_files/art_saturn1-S6-200802171211-RTE.ss.gz: 1.78 kB 50.95 kB/s...
Page 655: Supportshow
supportShow supportShow Displays switch information for debugging purposes. Synopsis supportshow [[slotnumber/]portnumber1-portnumber2] [lines] Description Use this command to display support information from groups of preselected Fabric OS and Linux commands and other support and debugging information. You can specify the range of ports for which this information displays.
Page 656 supportShow Operands This command has the following operands: slotnumber/portnumber1-portnumber2 Specify the range of ports to display. If the slotnumber/portnumber parameter is omitted, all ports in the switch display in the per-port outputs. The slotnumber must be provided when specifying a range of ports on multi-bladed products.
Page 657: Supportshowcfgdisable
supportShowCfgDisable supportShowCfgDisable Disables a group of commands under the supportShow command. Synopsis supportshowcfgdisable os | exception | port | fabric | services | security | network | portlog | systemextend | filter | perfmon | ficon | iswitch | asic_db |iscsi Description Use this command to disable a group of commands under the supportShow command.
Page 658: Supportshowcfgenable
supportShowCfgEnable supportShowCfgEnable Enables a group of commands to be displayed under the supportShow command. Synopsis supportshowcfgenable os | exception | port | fabric | services | security | network | portlog | system | extend | filter | perfmon | ficon | iswitch | asic_db Description Use this command to enable a group of commands to be displayed under the supportShow command.
Page 659: Supportshowcfgshow
supportShowCfgShow supportShowCfgShow Displays the groups of commands enabled for display by the supportShow command. Synopsis supportshowcfgshow Description Use this command to display the groups of commands enabled for display by the supportShow command. Use the supportShowCfgEnable and the supportShowCfgDisable commands to modify which groups are displayed.
Page 660: Switchbeacon
switchBeacon switchBeacon Sets switch beaconing mode on or off. Synopsis switchbeacon [mode] Description 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.
Page 661: Switchcfgpersistentdisable
switchCfgPersistentDisable switchCfgPersistentDisable Disables a switch persistently. Synopsis switchcfgpersistentdisable Description Use this command to persistently disable the switch. All Fibre Channel ports are taken offline. If the switch was part of a fabric, the remaining switches reconfigure. The switch remains disabled even after a reboot.
Page 662: Switchcfgpersistentenable
switchCfgPersistentEnable switchCfgPersistentEnable Enables a switch persistently. Synopsis switchcfgpersistentenable Description Use this command to persistently enable the 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.
Page 663: Switchcfgspeed
switchCfgSpeed switchCfgSpeed Configures all ports of a switch to a particular speed. Synopsis switchcfgspeed speed_level Description Use this command to configure the speed of all the ports on a switch to a particular level. The configuration is saved in flash memory and persists across switch reboots or power cycles. If any port on the switch is not capable of the specified speed setting, an error message displays for that port.
Page 664: Switchcfgtrunk
switchCfgTrunk switchCfgTrunk Enables or disables trunking on all the ports of a switch. Synopsis switchcfgtrunk mode Description Use this command to enable or disable trunking on all the ports of a switch. 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.
Page 665: Switchdisable
switchDisable switchDisable Disables the switch. Synopsis switchdisable Description Use this command to disable the switch. All Fibre Channel ports are taken offline; if the switch was part of a fabric, the remaining switches reconfigure. The switch must be disabled before making configuration changes (using configure or configDefault) or before running many of the diagnostic tests.
Page 666: Switchenable
switchEnable switchEnable Enables the switch. Synopsis switchenable Description Use this command to enable the switch. All Fibre Channel ports that passed POST are enabled. They can come online if connected to a device, or remain offline if disconnected. Use switchEnable if you disable the switch to make configuration changes or to run diagnostics.
Page 667: Switchname
switchName switchName Displays or sets the switch name. Synopsis switchname [name] Description Use this command to display or set the switch name. All switches have a symbolic name that is primarily used for switch management. This name is shown in the Fabric OS CLI prompt, under each switch icon on the Fabric Web page, and in the output of various Fabric OS commands, such as fabricShow.
Page 668: Switchshow
switchShow switchShow Displays switch and port status. Synopsis switchshow [-portcount] [-iscsi] Description Use this command to display switch and port status information. Output may vary depending on the switch model. Switch summary information includes the following: switchName Switch name. switchType Switch model and revision numbers.
Page 669 switchShow copper serial ID Speed The speed of the port: 1/8G 125 Mbps 1/4G 250 Mbps 1/2G 500 Mbps 1 Gbps fixed transfer speed 1 Gbps negotiated transfer speed 2 Gbps fixed transfer speed 2 Gbps negotiated transfer speed 4 Gbps fixed transfer speed 4 Gbps negotiated transfer speed 8 Gbps fixed transfer speed 8 Gbps negotiated transfer speed...
Page 670 switchShow FCIP Ports support FCIP. comment Optionally displays: Disabled Port is disabled. Bypassed Port is bypassed (loop only). Loopback Port is in loopback mode. E_Port Fabric port; displays WWN and name of attached switch. If the port is configured as EX_Port, the WWN of the attached switch is the same as the router.
Page 671 switchShow The execution of this command is subject to Admin Domain restrictions that may be in place. Refer to chapter 1, "Understanding Admin Domain Restrictions" and Appendix A, "Command Availability" for details. In an AD context, if one of the L_Ports or NPIV Ports is a part of the current AD, the complete device information attached to the port is displayed.
Page 672 switchShow 035900 Online E-Port 10:00:00:60:69:90:52:a8 "Term_7" 035a00 No_Module Disabled (Persistent) 035b00 No_Light Disabled (Persistent) 035c00 No_Module Disabled (Persistent) 035d00 No_Module Disabled (Persistent) 035e00 Online F-Port 10:00:00:00:00:04:00:00 035f00 Online F-Port 10:00:00:00:00:02:00:00 03d000 Offline [output truncated] 03d800 Online VE-Port 10:00:00:60:69:e2:0c:00 "bot_4a3_a10" (upstream) 03d900 Online VE-Port...
Page 673: Switchstatuspolicyset
switchStatusPolicySet switchStatusPolicySet Sets the policy parameters that determine overall switch status. Synopsis switchstatuspolicyset Description Use this command to set policy parameters for calculating the overall status of the switch enclosure. The policy parameter values determine how many failed or faulty units of each contributor are allowed before triggering a status change in the switch from HEALTHY to MARGINAL or DOWN.
Page 674 switchStatusPolicySet PowerSupplies Temperatures Fans Blade CoreBlade Flash MarginalPorts FaultyPorts MissingSFPs Note that the value, 0, for a parameter, means that it is NOT used in the calculation. ** In addition, if the range of settable values in the prompt is (0..0), ** the policy parameter is NOT applicable to the switch.
Page 675: Switchstatuspolicyshow
switchStatusPolicyShow switchStatusPolicyShow Displays the policy parameters that determine overall switch status. Synopsis switchstatuspolicyshow Description Use this command to view the current policy parameters set for the switch. These policy parameters determine the number of failed or non-operational units allowed for each contributor before triggering a status change in the switch.
Page 676 switchStatusPolicyShow Flash MarginalPorts FaultyPorts MissingSFPs See Also switchStatusPolicySet, switchStatusShow Fabric OS Command Reference 53-1000599-02...
Page 677: Switchstatusshow
switchStatusShow switchStatusShow Displays overall switch status. Synopsis switchstatusshow Description Use this command to display the overall status for a switch that is configured with IPv4 and IPv6 addresses. In addition, users with a Fabric Watch license are able to view the list of unhealthy ports.
Page 678 switchStatusShow To retrieve a switch health report for a switch that is configured with an IPv4 address: switch:user> switchstatusshow Switch Health Report Report time: 09/11/2006 05:39:28 PM Switch Name: switch IP address: 10.32.89.26 SwitchState: MARGINAL Duration: 80:12 Power supplies monitor HEALTHY Temperatures monitor HEALTHY...
Page 679: Switchuptime
switchUptime switchUptime Displays the amount of time the switch has been operating. Synopsis switchuptime Description Use this command to display the current time and the amount of time that the switch has been operational. Operands none Examples To view the uptime for the switch: switch:user>...
Page 680: Switchviolation
switchViolation switchViolation Dumps the DCC violations for a switch. Synopsis switchViolation --dump -dcc Description 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.
Page 681: Syslogdfacility
syslogdFacility syslogdFacility Changes the syslog facility. Synopsis syslogdFacility [-l level] Description Use this command to change the syslog facility to LOG_LOCAL0, LOG_LOCAL1, LOG_LOCAL2, LOG_LOCAL3, LOG_LOCAL4, LOG_LOCAL5, LOG_LOCAL6, or LOG_LOCAL7. Syslog daemon (syslogd) is a process available on most UNIX systems that reads and forwards system messages to the appropriate log files or users, depending on the system configuration.
Page 682: Syslogdipadd
syslogdIpAdd syslogdIpAdd Configures a switch to forward system messages to specified servers. Synopsis syslogdipadd ip_address | host_name Description Use this command to configure a switch to forward all error log entries to the syslog demon (syslogd) of one or more specified servers. The syslog daemon is a process available on most UNIX systems that reads and forwards system messages to the appropriate log files or users, depending on the system configuration.Up to six servers are supported.
Page 683 syslogdIpAdd Address: 10.2.2.36 2. Add the DNS name server to the switch: switch:admin> dnsconfig Enter option 1 Display Domain Name Service (DNS) configuration 2 Set DNS configuration 3 Remove DNS configuration 4 Quit Select an item: (1..4) [4] 2 Enter Domain Name: [] brocade.com Enter Name Server IP address in dot/colon notation: [] 192.168.126.120 Enter Name Server IP address in dot/colon notation: [] 192.168.126.120 DNS parameters saved successfully...
Page 684: Syslogdipremove
syslogdIpRemove syslogdIpRemove Removes the IP address of a syslog daemon. Synopsis syslogdipremove ip_address Description Use this command to remove the IP address of the server that is running the syslogd process and to which system messages are sent. IPv6 and IPv4 syslogd address configurations are supported. Note The execution of this command is subject to Admin Domain restrictions that may be in place.
Page 685: Syslogdipshow
syslogdIpShow syslogdIpShow Displays all syslog daemon IP addresses. Synopsis syslogdipshow Description Use this command to display all syslog daemon IP addresses in the configuration database. IPv4 and IPv6 addresses are supported. Operands none Examples To display all syslog daemon IP addresses configured on a switch: switch:admin>...
Page 686: Sysshutdown
sysShutDown sysShutDown Provides a graceful shutdown to protect the switch file systems. Synopsis sysshutdown Description 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.
Page 687 sysShutDown flushing ide devices: hda Power down. ppc440gx System Halted To perform a system shutdown of the FR4-18i AP blade from the active CP: switch:admin> sysshutdown This command will shutdown the operating systems on your switch. You are required to power-cycle the switch in order to restore operation. Are you sure you want to shutdown the switch [y/n]? y This is the active Cp 2005/11/16-05:47:20, [FSSM-1003], 5641,, WARNING, Brocade12000, HA State out...
Page 688: Systemverification
systemVerification systemVerification Runs a suite of diagnostic tests on all switches in a fabric. Synopsis systemverification [-parameters | -short][[-fru type] -unit id] [-parameters | -short | -factory | -fparamaters] [-fru type -unit number] Description Use this command to run a comprehensive, system-wide test of all switches in a system. The command initiates a burn-in run on all switches within the current system.
Page 689 systemVerification Diagnostics Each diagnostic test in this suit reports its own set of error messages when detecting a failure. Refer to the Diagnostics section of individual diagnostic test help pages. These messages are available only in the log file. Refer to the Fabric OS Message Reference for more information. Examples To initiate a system verification test on all switches in the fabric: switch:admin>...
Page 690: Tempshow
tempShow tempShow Displays temperature readings. Synopsis tempshow Description Use this command to display the current temperature readings of all temperature sensors in a switch. For each sensor, this command displays the slot number (if applicable), the sensor state, and the temperature. The temperature readings are given in both Centigrade and Fahrenheit. Note Refer to the hardware reference manual for your switch to determine the normal temperature range.
Page 691: Timeout
timeOut timeOut Sets or displays the idle timeout value for a login session. Synopsis timeout [timeval] Description Use this command without 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.
Page 692: Topologyshow
topologyShow topologyShow Displays the unicast fabric topology. Synopsis topologyshow [domain] Description Use this command to display the fabric topology as it appears to the local switch. The display varies depending on the hardware configuration. The following rules apply: 1. On all switches, the command displays the number of domains in the fabric and the local Domain IDs.
Page 693 topologyShow 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.512 Gbps Included) to 1 Gbps (not included) is adjusted to the 0.512 Gbps value.
Page 694 topologyShow Hops: Out Port: In Ports: 0 1 2 3 4 5 6 7 8 9 15 Total Bandwidth: 8.000 Gbps Bandwidth Demand: 1275 % Flags: Domain: Metric: Name: peng3900101 Path Count: Hops: Out Port: In Ports: 0 1 2 3 4 5 6 7 8 9 11 Total Bandwidth: 2.000 Gbps Bandwidth Demand:...
Page 695 topologyShow In Ports: 23 24 33 38 39 Total Bandwidth: 8.000 Gbps Bandwidth Demand: 350 % Flags: See Also fcrXlateConfig, portRouteShow, uRouteShow Fabric OS Command Reference 53-1000599-02...
Page 696: Tracedump
traceDump traceDump Displays, initiates, or removes a trace dump. Synopsis tracedump [-S][-s slot] tracedump -n [-s slot] tracedump -r [-s slot] tracedump -R Description Use this command to initiate a background trace dump, to remove the content of a trace dump, or to display the dump status on the switch.
Page 697: Trackchangeshelp
trackChangesHelp trackChangesHelp Displays information on the track-changes commands. Synopsis trackchangeshelp Description Use this command to display information about the track-changes commands. Examples To display information on the track-changes commands: switch:admin> trackchangeshelp trackChangesSet Configure alert for login/logout/config update trackChangesShow Displays status of track changes See Also trackChangesSet, trackChangesShow Fabric OS Command Reference...
Page 698: Trackchangesset
trackChangesSet trackChangesSet Enables or disables the track-changes feature. Synopsis trackchangesset [mode][, snmptrapmode] Description This command enables or disables the track-changes feature. An SNMP-TRAP mode can also be enabled. Trackable changes are: • Successful login • Unsuccessful login • Logout • Config file change from task •...
Page 699: Trackchangesshow
trackChangesShow trackChangesShow Displays status of the track-changes feature. Synopsis trackchangesshow Description Use this command to display status of the track-changes feature. It shows whether the feature is enabled or disabled and if SNMP traps are generated. The output from the track-changes feature is dumped to the error log for the switch. Use the errDump command or errShow command to view the error log.
Page 700: Trunkdebug
trunkDebug trunkDebug Debugs a trunk link failure. Synopsis trunkdebug port1 port2 Description Use this command to debug a trunk link failure. This command reports one of the following messages, based on the trunking properties of the two specified ports: • Switch does not support trunking •...
Page 701: Trunkshow
trunkShow trunkShow Displays trunking information. Synopsis trunkshow Description Use this command to display trunking information of both E_Ports and EX_Ports. The following fields display: Trunking Group Number Displays each trunking group on a switch. All the ports that are part of this trunking group are displayed.
Page 702 trunkShow To display trunking information for a switch that is part of an FC Router backbone fabric interlinking several edge fabrics (see the EX_Port with WWN "10:00:00:05:1e:35:b3:03" and the E_Port with WWN "10:00:00:05:1e:37:12:13" in the output below): switch:admin> trunkshow 4: 49-> 0 10:00:00:05:1e:35:b3:03 4 deskew 16 MASTER 54->...
Page 703: Tsclockserver
tsClockServer tsClockServer Displays or sets the Network Time Protocol (NTP) Server addresses. Synopsis tsclockserver [ipaddr [; ipaddr ...]] Description 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.
Page 704 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. See Also date Fabric OS Command Reference 53-1000599-02...
Page 705: Tstimezone
tsTimeZone tsTimeZone Displays or sets the system time zone. Synopsis tstimezone --interactive tstimezone timezonename tstimezone --old hourOffset [, minuteOffset] Description Use this command to display or set the system time zone. All switches maintain the current time zone setup in nonvolatile memory. Changing the time zone on a switch updates the local time zone setup and is reflected in local time calculations.
Page 706 tsTimeZone timezonename Specifies the name of a time zone from the time zone database. Use tstimezone --interactive for a listing of valid time zone name. Interactively sets the timezone in name format. --interactive Examples To display the current time zone setup and then change it to GMT-3:30: switch:admin>...
Page 707 tsTimeZone 4) Eastern Time - Kentucky - Wayne County 5) Eastern Time - Indiana - most locations 6) Eastern Time - Indiana - Crawford County 7) Eastern Time - Indiana - Starke County 8) Eastern Time - Indiana - Switzerland County 9) Central Time 10) Central Time - Indiana - Daviess, Dubois, Knox, Martin, Perry, Pulaski 11) Central Time - Indiana - Pike County...
Page 708: Turboramtest
turboRamTest turboRamTest Performs a turbo SRAM logic test. Synopsis turboramtest [--slot slotnumber][-passcnt count][-ports itemlist] Description This command verifies the on chip SRAM located using the turbo-RAM BIST circuitry. It also tests one SRAM in each quadrant of every chip, in parallel. The test flow for each SRAM is as follows: 1.
Page 709: Uptime
upTime upTime Displays length of time the system has been operational. Synopsis uptime Description 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.
Page 710: Urouteconfig
uRouteConfig uRouteConfig Configures a static route. Synopsis urouteconfig in_area domain out_area Description Use this command to configure static routes. A static route is assigned to a specific path (defined by port number out_area) and does not change when a topology change occurs unless the path used by the route becomes unavailable.
Page 711: Urouteremove
uRouteRemove uRouteRemove Removes a static route. Synopsis urouteremove in_area domain Description Use this command to remove a previously configured static route. After this command is issued, the route to domain for in_area might change to use a different output port, but only if dynamic load sharing (DLS) is set. If DLS is not set, the route remains as is, with its route attribute changed from static to dynamic.
Page 712: Urouteshow
uRouteShow uRouteShow Displays unicast routing information. Synopsis urouteshow [slotnumber/][portnumber] [domain] Description Use this command to display the unicast routing information for a port, as it is known by the FSPF path selection and routing task. The routing information describes how a frame that is received from a port on the local switch is to be routed to reach a destination switch.
Page 713 uRouteShow Examples To display the routing information of all the active ports: switch:admin> urouteshow Local Domain ID: 3 In Port Domain Out Port Metric Hops Flags Next (Dom, Port) --------------------------------------------------------------------------- 1000 1500 1000 1500 4,16 To display the routing information of port 11 to domain 4 only: switch:admin>...
Page 714: Usbstorage
usbStorage usbStorage Manages data files on an attached USB storage device. Synopsis usbstorage [-e | --enable] usbstorage [-d | --disable] usbstorage [-l | --list] usbstorage [-r | --remove application area usbstorage [-h | --help] Description Use this command to control a USB device attached to the Active CP. When the USB device is enabled, other applications, such as supportSave, firmwareDownload, firmwareKeyupdate, or configDownload/cfgUpload can conveniently store and retrieve data from the attached storage device.
Page 715 usbStorage firmware\ 380MB 2007 Aug 15 15:13 FW_v6.0.0\ 380MB 2007 Aug 15 15:13 Available space on usbstorage 74% To remove an application area: switch:admin> usbstorage -r firmware FW_v6.0.0 To disable an attached USB device: switch:admin> usbstorage -d USB storage disabled See also supportSave, firmwareDownload, configUpload, configDownload, firmwareKeyupdate Fabric OS Command Reference...
Page 716: Userconfig
userConfig userConfig Manages user accounts. Synopsis userconfig userconfig --show [username | -a] userconfig --showad -a AD_ID userconfig --add username -r I role [[-h I AD_ID][-a AD_ID list]] [-d description] [-x] userconfig --change username -r I role [[-h I AD_ID][-a I AD_ID list]] [-d I description] [-x] [-e yes | no] [-u] userconfig --delete username userconfig --addad |--deletead username [-h AD_ID][-a AD_ID list]...
Page 717 userConfig The backup account database is no longer supported on switches running Fabric OS v6.0 or later. As a consequence, account recovery from backup as well as backup display option (former --show -b option) are no longer supported in Fabric OS v6.0 or later. The execution of this command is subject to Admin Domain restrictions that may be in place.
Page 718 userConfig -h AD_ID Specifies the home Administrative Domain. This operand is optional. If no AD is specified with the --add option, the system assigns the lowest numbered Administrative Domain the user is authorized to access. -a AD_ID_list Specifies the Administrative Domains the user is authorized to access.AD_ID_list and the existing AD permissions for username must be a subset of the AD permissions of the account that executes this command.
Page 719 userConfig -h AD_ID This operand is optional. • If home AD is specified with the --addad option, it must be one of the ADs in AD_ID_list. If a home AD is not specified and username did not previously have a home AD, the home AD is set to the lowest numbered AD in the user's AD permissions.
Page 720 userConfig To add AD 0 & 255 to bob’s AD member list. Home AD is unchanged: switch:admin> userConfig --addad bob -a 0,AD255 To delete AD 128 from bob’s AD member list. New home AD is set to 0: switch:admin> userConfig --deletead bob -a 128 -h 0 See Also none Fabric OS Command Reference...
Page 721: Userrename
userRename userRename Renames the user login name. Synopsis userrename old_username new_username Description Use this command to change an existing account login name to a new login name. The following rules apply: 1. new_username must begin with a letter and contain only alphanumeric characters or underscores.
Page 722: Version
version version Displays firmware version information. Synopsis version Description 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.
Page 723: Wwn
Displays or sets the World Wide Name (WWN) of the switch. Synopsis wwn [-sn | name] Description Use this command to display or change the WWN associated with a switch and to display the switch serial number. All switches have a numeric address that is the unique Fibre Channel address used for communicating with the switch.
Page 724 To display the switch WWN and serial number: switch:admin:admin> wwn -sn WWN: 10:00:00:05:1e:01:23:e0 RC030000089 See Also switchShow Fabric OS Command Reference 53-1000599-02...
Page 725: Zone
zone zone Performs specific zone operations, manages Traffic Isolation (TI) Zones, and Frame Redirect (RD) Zones. Synopsis zone --help To perform specific zone operations: zone --copy [source_AD.] source_zone_object [dest_zone_object][-f] zone --expunge “zone_object” zone --validate [[-f | [-m mode] [“zone_object”]]] To create and manage traffic Isolation zones: zone --create -t objecttype [-o optlist] name -p portlist zone --add [-o optlist] name -p portlist zone --remove name -p portlist...
Page 726 zone 3. Use the --rdcreate and --rddelete options to manage Frame Redirect (RD) Zones. RD zones allow frames to be redirected to devices that can perform additional processing on these frames (for example, encryption). The feature uses a combination of RD zones and Name Server changes to map real device WWNs to Virtual PIDs.
Page 727 zone --expunge Removes all references to the specified zone object and then deletes the zone object. The command displays the list of zone objects to be deleted and prompts you before deleting. The removal of the zone object could result in other zone object removal, triggering a recursive deletion.
Page 728 zone The following operands are supported: 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 failover mode. If this option is not specified the zone is created, by default, with failover enabled, and the zone will be activated.
Page 729 zone policy restartable | nonrestartable Specifies the policy as either restartable or nonrestartable. A restartable policy causes traffic flow to revert to the physical host/target configuration in the event the virtual device should fail. When policy is specified as nonrestricted and one of the virtual devices goes offline, the physical devices are considered as offline and no traffic is allowed between the original host and target.
Page 730 zone To copy backup_zn zone from the root zone database (AD0) to the current Admin Domain, with Admin Domain member list filtering: switch:admin> zone --copy -f AD0.backup_zn To delete all references associated with zone member 100,5: switch:admin> zone --expunge “100,5” You are about to expunge one configuration or member.
Page 731 zone To add option to disable/enable failover for a TI zone: switch:admin>zone --add -o n red_zone switch:admin>zone --add -o f green_zone" -p "3,4" To remove portlist members from an existing TI zone. switch:admin> zone --remove blue_zone -p "3,4; 3,6" To activate the TI zone "blue_zone": switch:admin>...
Page 732 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: 4. RD zone "red_0917_10_10_10_10_10_10_10_10_20_20_20_20_20_20_20_20", with a restrictedly policy and no FCR support.
Page 733: Zoneadd
zoneAdd zoneAdd Adds a member to the zone. Synopsis zoneadd "zoneName", "member;member" Description Use this command to add one or more members to an existing zone. This command changes the defined configuration. For the change to be preserved across switch reboots, save the configuration to nonvolatile memory with the cfgSave command.
Page 734: Zonecreate
zoneCreate zoneCreate Creates a zone. Synopsis zonecreate "zonename", "member[; member...]" Description Use this command to create a new 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".
Page 735 zoneCreate Examples To create three zones using a combination of port numbers and zone aliases: sw5:admin> zonecreate "Purple_zone", "1,0; loop1" sw5:admin> zonecreate "Blue_zone", "1,1; array1; 1,2; array2" sw5:admin> zonecreate "Green_zone", "1,0; loop1; 1,2; array2" See Also zoneAdd, zoneDelete, zoneRemove, zoneShow Fabric OS Command Reference 53-1000599-02...
Page 736: Zonedelete
zoneDelete zoneDelete Deletes a zone. Synopsis zonedelete "zonename" Description Use this command to delete a zone. This command changes the defined configuration. For the change to be preserved across switch reboots, save the configuration to non-volatile memory using the cfgSave command. For the change to become effective, enable the configuration with the cfgEnable command.
Page 737: Zonehelp
zoneHelp zoneHelp Displays a description of zoning commands. Synopsis zonehelp Description Use this command to display short descriptions of zoning commands. Operands none Examples To display zone command help information: switch:admin> zonehelp aliadd Add a member to a zone alias alicreate Create a zone alias alidelete...
Page 738: Zoneobjectcopy
zoneObjectCopy zoneObjectCopy Copies a zone object. Synopsis zoneObjectCopy "objectName", "newName" Description 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.
Page 739: Zoneobjectexpunge
zoneObjectExpunge zoneObjectExpunge Expunges a zone object. Synopsis zoneObjectExpunge "objectName" Description 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.
Page 740: Zoneobjectrename
zoneObjectRename zoneObjectRename Renames a zone object. Synopsis zoneObjectRename "objectName", "newName" Description Use this command to rename a zone object. You can use this command for all zone object types, including cfg, zone, and alias. 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.
Page 741: Zoneremove
zoneRemove zoneRemove Removes a member from a zone. Synopsis zoneremove "zonename", "zoneMemberList" Description Use this command to remove one or more members from an existing zone. If all members are removed, the zone is deleted. This command changes the defined configuration. For the change to be preserved across switch reboots, save the configuration to nonvolatile memory with the cfgSave command.
Page 742: Zoneshow
zoneShow zoneShow Displays zone information. Synopsis zoneshow ["pattern"][, mode] Description Use this command to display zone configuration information. If no parameters are specified, all zone configuration information (both defined and enabled) is displayed. Refer to cfgShow for a description of this display. If a parameter is specified, it is used as a pattern to match zone configuration names, and those that match in the defined configuration are displayed.
Page 743: Chapter 3 Primary Fcs Commands
Chapter Primary FCS commands This chapter summarizes the commands that are available only on the primary Fabric Configuration Server (FCS) when FCS policy is enabled. Primary FCS commands TABLE 22 Primary FCS commands Command Description aliAdd Must be run from the primary FCS switch. aliCreate Must be run from the primary FCS switch.
Page 744 Primary FCS commands Command Description msTdDisable msTdDisable “ALL” must be run from the primary FCS switch. msTdEnable msTdEnable “ALL” must be run from the primary FCS switch. secPolicyAbort Must be run from the primary FCS switch. secPolicyActivate Must be run from the primary FCS switch. secPolicyAdd Must be run from the primary FCS switch.
Page 745: Chapter 4 Control Processor Commands
Chapter Control Processor Commands This chapter lists the commands available when logged in to the standby CP on a Brocade 48000 or DCX Backbone. The full set of commands for your user role is available on the active CP. Commands supported on the standby CP The following commands are supported when logged into the standby CP.
Page 746 Commands supported on the standby CP TABLE 23 Commands supported on the standby CP (Continued) Command Description logout Logs out from a Telnet, rlogin, or serial port session. memShow Displays memory usage in the system. myId Displays the current login session details. more Displays command output with page breaks netStat...
Page 747: Command Availability
Appendix Command availability This appendix explains how a command is validated when it is typed at the command prompt. Command validation checks Before a command is executed, it is validated against the following checks: 1. Active or Standby availability: on enterprise-class platformssystems, checks that the command is available on the Control Processor (CP).
Page 748: Command Rbac Permissions And Ad Types
Command RBAC permissions and AD types Command RBAC permissions and AD types Refer to Table 1 for the RBAC and Admin Domain availability of all Fabric OS commands. TABLE 1 RBAC availability and admin domain type Command Name User Admin Operator Switch Zone...
Page 749 Command RBAC permissions and AD types TABLE 1 RBAC availability and admin domain type Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Domain Admin Admin Admin Switch Admin Admin cfgDisable Allowed cfgEnable Allowed cfgMcdtMode Allowed cfgRemove Allowed cfgSave Allowed cfgSaveActiveToDefined...
Page 750 Command RBAC permissions and AD types TABLE 1 RBAC availability and admin domain type Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Domain Admin Admin Admin Switch Admin Admin diagShow SwitchMember diagSkipTest SwitchMember diagStopBurnin SwitchMember distribute AD0Disallowed dlsReset SwitchMember dlsSet...
Page 751 Command RBAC permissions and AD types TABLE 1 RBAC availability and admin domain type Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Domain Admin Admin Admin Switch Admin Admin fcpLogEnable SwitchMember fcpLogShow SwitchMember fcpProbeShow Allowed fcpRlsShow Allowed fcrBcastConfig SwitchMember fcrChipTest...
Page 752 Command RBAC permissions and AD types TABLE 1 RBAC availability and admin domain type Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Domain Admin Admin Admin Switch Admin Admin foscConfig Allowed/SwitchMm br/Disallowed fruReplace SwitchMember fspfShow Allowed fwAlarmsFilterSet SwitchMember fwAlarmsFilterShow SwitchMember...
Page 753 Command RBAC permissions and AD types TABLE 1 RBAC availability and admin domain type Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Domain Admin Admin Admin Switch Admin Admin interfaceShow Allowed interOpMode Allowed/ SwitchMember iodDelayReset SwitchMember iodDelaySet SwitchMember iodDelayShow SwitchMember...
Page 754 Command RBAC permissions and AD types TABLE 1 RBAC availability and admin domain type Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Domain Admin Admin Admin Switch Admin Admin miniCycle SwitchMember msCapabilityShow SwitchMember msConfigure SwitchMember msPlatShow Allowed msPlatShowDBCB Allowed msPlClearDB...
Page 755 Command RBAC permissions and AD types TABLE 1 RBAC availability and admin domain type Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Domain Admin Admin Admin Switch Admin Admin perfCfgClear SwitchMember perfCfgRestore SwitchMember perfCfgSave SwitchMember perfDelEEMonitor SwitchMember perfDelFilterMonitor SwitchMember perfHelp...
Page 756 Command RBAC permissions and AD types TABLE 1 RBAC availability and admin domain type Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Domain Admin Admin Admin Switch Admin Admin portCfgPersistentEnable Allowed/ PortMmember portCfgQos PortMmember portCfgShow PortMmember portCfgSpeed PortMmember portCfgTrunkPort SwitchMember...
Page 757 Command RBAC permissions and AD types TABLE 1 RBAC availability and admin domain type Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Domain Admin Admin Admin Switch Admin Admin portStats64Show PortMember portStatsClear SwitchMember portStatsShow PortMember portSwap SwitchMember portSwapDisable SwitchMember portSwapEnable...
Page 758 Command RBAC permissions and AD types TABLE 1 RBAC availability and admin domain type Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Domain Admin Admin Admin Switch Admin Admin sensorShow Allowed setDbg SwitchMember setModem SwitchMember setVerbose SwitchMember sfpShow PortMember shellFlowControlDisable...
Page 759 Command RBAC permissions and AD types TABLE 1 RBAC availability and admin domain type Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Domain Admin Admin Admin Switch Admin Admin switchStatusPolicyShow Allowed switchStatusShow Allowed switchUptime Allowed switchViolation Allowed syslogdFacility SwitchMember syslogdIpAdd...
Page 760 Command RBAC permissions and AD types TABLE 1 RBAC availability and admin domain type Command Name User Admin Operator Switch Zone Fabric Basic Security Admin Domain Admin Admin Admin Switch Admin Admin Allowed/ SwitchMember zone Allowed zoneAdd Allowed zoneCreate Allowed zoneDelete Allowed zoneHelp...
Page 761: Index
Index bladeDisable Bloom-based platform Brocade 200E switch AAA services Brocade 4100 switch access levels account lockout policy Brocade 48000 director active CP Brocade 4900 switch in firmwaredownload Admin Brocade 7500 switch Admin Domain restrictions bscastShow Advanced Zoning buffer usage Advanced Zoning commands xxiv agtCfgShow burn-in...
Page 762 certificates and active ISLs deleting certificates and bcastShow and fabStatShow and fwConfigure and interfaceShow and portCfgGPort and portFlagsShow default zone and portLogShow activating and switchShow defZone and trunkDebug deskew and uRouteConfig DH-CHAP EE mask and authUtil end-to-end monitor diagDisablePost errDelimiterSet diagnostics error log and burninLevel...
Page 763 FCAP FCIP fcipPathTest HA, see high availability haDump haFailover FCP, see Fibre Channel Protocol active CP FC-PH HA-MIB fcPing hardware statistics display zoning haShow FDISC HA-TRAP FDMI Fibre Channel Extended Link Service help Fibre Channel Protocol help commands FICON high availability FICON-MIB FICON-TRAP field replaceable unit, see FRU...
Page 764 L_Port Name Server license nbrStateShow license commands non-secure mode license key NPIV License keys NR_Port licenses NTP Server address Advanced Zoning Extended Fabrics Fabric Watch passwdCfg password ISL Trunking and login Management Server and SNMPv3 and supportFTP Performance Monitor and supportSave expiration policy password info perfAddEEMonitor...
Page 765 primary FCS and secGlobalShow and secPolicyAdd public key infrastructure and secPolicyCreate and secStatShow and secStatsReset and zoneObjectExpunge and zoneObjectRename QuickLoop and zoneShow security policy SERDES serial port setModem R_A_TOV active CP RADIUS RASLOG shellFlowControlEnable read link status active CP reboot shutdown from the active CP SID used...
Page 766 zoneRemove zoneShow zoning tape pipelining Advanced Zoning commands xxiv temperature readings and configDefault This and configDownload time zone and lsanZoneShow timeout value clearing zoning configurations topology disabling trace display in fabStatShow track-changes feature displayed in fcPing trackChangesSet zoning transaction trunkDebug aborting Trunking turbo SRAM logic test...

This manual is also suitable for:

Ae370a - brocade 4gb san switch 4/12 Am866a - storageworks 8/8 base san switch 8/24 8/40 8/8 8/80 ... Show all

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

Chapter 1 Using Fabric os Commands

Chapter 2 Fabric os Commands

Quick Links

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

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