HP StorageWorks 8/80 Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01
HP StorageWorks 8/80 - SAN Switch Manual
View all HP StorageWorks 8/80 manuals
Add to My Manuals
Save this manual to your list of manuals |
HP StorageWorks 8/80 manual content summary:
- HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 1
53-1001337-01 ® 28 July 2009 Fabric OS Command Reference Manual Supporting Fabric OS v6.3.0 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 2
B-wing symbol, BigIron, DCX, Fabric OS, FastIron, IronPoint, IronShield, and DCFM, Extraordinary Networks, and SAN Health are trademarks of Brocade Communications Systems implied, concerning any equipment, equipment feature, or service offered or to be offered by Brocade. Brocade support/oscd. - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 3
San Jose, CA 95110 Tel: 1-408-333-8000 Fax Fabric OS Command Reference. Document Title Publication Number Summary of Changes Fabric OS Reference v2.0 53-0001487-03 Fabric OS Reference v2.2 53-0001558-02 Fabric OS Reference v2.3 53-0000067-02 Fabric OS Reference v3.0 53-0000127-03 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 4
and RBAC/AD table. August 2008 Added 14 new commands to support Logical Fabrics. Modified 34 commands with new command operands to support new Fabric OS v6.2.0 features. Removed 8 deprecated commands. Miscellaneous edits to ~40 commands to correct edits, update examples etc. Removed standby CP - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 5
Document Title Publication Number Fabric OS Command Reference 53-1001337-01 Summary of Changes Publication Date Added 18 new commands. Modified 27 commands with new command operands to support new Fabric OS v6.3.0 features. Removed 6 deprecated command options. Removed 6 diagnostic commands - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 6
vi Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 7
xxi Supported hardware and software xxi What is new in this document xxiii Document conventions xxv Notice to the reader xxvii Additional information xxviii Getting technical help xxviii Document feedback xxix Chapter 1 Using Fabric OS Commands In this chapter 1 Understanding role-based - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 8
cfgActvShow 75 cfgAdd 76 cfgClear 77 cfgCreate 78 cfgDelete 79 cfgDisable 80 cfgEnable 81 cfgMcdtmode 82 cfgRemove 83 cfgSave 84 cfgSaveActiveToDefined 85 cfgShow chassisName 98 chassisShow 99 cliHistory 101 cmsh 102 configDefault 104 viii Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 9
Fabric OS Command Reference 53-1001337-01 configDownload 106 configList 111 configRemove 112 configShow 113 configUpload 117 configure 121 configureChassis 129 cryptoCfg 131 dataTypeShow 179 date 180 dbgShow 182 defZone 183 diagClearError 185 diagDisablePost 186 diagEnablePost 187 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 10
256 fcrEdgeshow 257 fcrFabricShow 259 fcrlSan 261 fcrLsanCount 263 fcrLsanMatrix 264 fcrPathTest 269 fcrPhyDevShow 272 fcrProxyConfig 274 fcrProxyDevShow 276 fcrResourceShow 278 fcrRouterPortCost 280 fcrRouteShow 282 x Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 11
Fabric OS Command Reference 53-1001337-01 fcrXlateConfig 283 fddCfg 286 fdmiCacheShow 288 fdmiShow 289 ficonClear 290 ficonCupSet 291 ficonCupShow 293 ficonHelp 295 ficonShow 296 fipsCfg - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 12
iscsiCfg 421 iscsiChipTest 429 iscsiHelp 430 iscsiPathTest 431 iscsiPortCfg 432 iscsiSessionCfg 435 iscsiSwCfg 437 islShow 438 isnscCfg 439 itemList 441 killTelnet 443 ldapCfg 444 xii Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 13
Fabric OS Command Reference 53-1001337-01 lfCfg 446 licenseAdd 449 licenseHelp 450 licenseIdShow 451 licensePort 452 licenseRemove 454 licenseShow 456 licenseSlotCfg 458 linkCost 462 login - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 14
pkiShow 564 policy 565 portAddress 568 portAlpaShow 571 portBeacon 572 portBufferShow 573 portCamShow 575 portCfg 577 portCfgAlpa 598 portCfgAutoDisable 599 portCfgCreditRecovery 601 portCfgDefault 602 xiv Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 15
Fabric OS Command Reference 53-1001337-01 portCfgEport 603 portCfgEXPort 604 portCfgFillword 607 portCfgFportBuffers 608 portCfgGport 609 portCfgISLMode 610 portCfgLongDistance 612 portCfgLport 615 portcfgGeMediaType 617 portCfgNPIVPort - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 16
reboot 760 routeHelp 761 secActiveSize 762 secAuthSecret 763 secCertUtil 765 secDefineSize 771 secGlobalShow 772 secHelp 774 secPolicyAbort 775 secPolicyActivate 776 secPolicyAdd 777 secPolicyCreate 779 xvi Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 17
Fabric OS Command Reference 53-1001337-01 secPolicyDelete 782 secPolicyDump 784 secPolicyFCSMove 787 secPolicyRemove 789 secPolicySave 791 secPolicyShow 792 secStatsReset 794 secStatsShow 796 sensorShow 798 setContext - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 18
tsTimeZone 896 turboRamTest 899 upTime 900 uRouteConfig 901 uRouteRemove 902 uRouteShow 903 usbStorage 905 userConfig 907 userRename 915 version 916 wwn 917 wwnAddress 918 xviii Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 19
938 Primary FCS commands Primary FCS commands 939 Appendix A: Command availability In this appendix 941 Command validation checks 941 Encryption commands and permissions 942 General Fabric OS commands and permissions 944 Fabric OS Command Reference xix 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 20
xx Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 21
xxi •Supported hardware SAN and Brocade switches. • Chapter 2, "Fabric OS Commands" provides command information. • Chapter 3, "Primary FCS commands" summarizes the subset of commands available when an FCS policy is enabled. • Appendix A, "Appendix A: Command availability," explains the Role-Based - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 22
• FA4-18 Fibre Channel application blade • FC4-16 port blade • FC4-16IP • FC4-32 port blade • FC4-48 port blade • FC10-6 port blade • FR4-18i router blade Although many different software and hardware configurations are tested and supported by Brocade Communications Systems, Inc. for Fabric OS v6 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 23
- Port configuration • portCfgGeMediaType - Brocade 7800/FX8-24 platform support • portFencing - Fabric Watch • portThConfig - Fabric Watch • sleep - Linux command, no Brocade help page • sysMonitor - Fabric Watch • top - Linux command, no Brocade help page • wwnAddress - WWN-based switch - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 24
vf option to upload Virtual Fabric configuration parameters. (RAS) • configure - XISL use enabled by default (Logical Fabrics) • cryptoCfg - New operands to support system cards, quorum size, and the Thales nCipher key vault. • --set -systemcard enable | disable • --reg -KAClogin primary | secondary - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 25
• slotShow - Support for new hardware. end users. manual entry for command" message. Document conventions This section describes text formatting conventions and important notices formats. Text formatting The narrative-text formatting conventions that are used in this document are as follows: Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 26
readability, command names in the narrative portions of this guide are presented in mixed letter case, for example, letter case is all lowercase. If there are exceptions, this manual specifically notes those cases in which a command is case-sensitive Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 27
cause damage to hardware, firmware, software, or data. Fibre Channel, see the technical glossaries on the Brocade website. See "Brocade resources" on page xxviii for instructions on accessing the information. For definitions of SAN NCKA EMC HP IBM Fabric OS Command Reference xxvii 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 28
For information about the Fibre Channel industry, visit the Fibre Channel Industry Association Web site: http://www.fibrechannel.org Getting technical help Contact your switch support supplier for hardware, firmware, and software support, including product repairs and part ordering. To expedite your - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 29
label is located as follows: The serial number label is located as follows: • Brocade 300, 4100, 4900, 5100, 5300, 7500, and Brocade Encryption Switch-On the switch ID pull-out tab located inside the chassis on the port side on the left • Brocade 7500E, 7800, and 8000--On the pull-out tab on the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 30
xxx Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 31
Non-administrative use, such as monitoring system activity. In Fabric OS v6.2.0 and later, the user account gains access to Fabric ID 128. This is the default Logical Fabric after a firmware upgrade. Operator A subset of administrative tasks typically required for routine maintenance operations - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 32
be executed in any switch context. Base Switch Only Command can be executed only on the base switch. Default Switch Only Command can be executed only on the default switch. N/A Command is a chassis command or not supported in Virtual Fabric mode. In a Virtual Fabric environment where contexts - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 33
in this manual. Using the command line interface The Fabric OS command line interface (accessed via Telnet, SSH, or serial console) provides full management capability on a Brocade switch. The Fabric OS CLI enables an administrator to monitor and manage individual switches, ports, and entire - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 34
1 Using the command line interface • Access to the full range of Fabric OS features, given the license keys installed. • Assistance with configuration, monitoring, dynamic provisioning, and daily management of every aspect of storage area networks (SAN). • A deeper view of the tasks involved in - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 35
(AAA) services. Use this command to display, add, remove, change, enable or disable the RADIUS or LDAP configuration. Switches running Fabric OS v5.2.0 or later use a local as well as a remote authentication mechanism for validating a login. Supported authentication protocols include Password - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 36
use centralized RADIUS servers to manage AAA services for a switch, as defined in the RFC 2865 RADIUS specification. Fabric OS v6.1.0 and later is required to configure LDAP while in FIPS mode. Refer to the Fabric OS Administrator's Guide for configuration procedures. This command can be executed - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 37
enclosed in double quotation marks. The following AAA services and service pairs are valid: "local" Default setting. Authenticates the user against the local database only. If the password does not match or the user is not defined, the login fails. Fabric OS Command Reference 7 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 38
credentials are correct, the user authentication succeeds. If the user provides credentials from the switch database, the RADIUS authentication fails but login succeeds through the switch database. Enables the current LDAP configuration as the primary AAA service and the switch-local database as the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 39
See Also To replace the AAA service with backup option: switch:admin> aaaconfig --authspec "ldap;local" -backup none aaaConfig 2 Fabric OS Command Reference 9 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 40
this command changes only the Defined Configuration in the transaction buffer. The -- default zone mode to "No Access" execute the following command sequence: switch:admin> ad --select AD0 switch:admin> defzone --noaccess switch:admin> cfgsave Refer to defZone help for more information. 10 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 41
supported: --activate arg Activates an Admin Domain. An Admin Domain is enforced only if it is in an activated state. AD0 is always in an activated state. By default, after the Admin Domain is enabled the defined configuration and enforces the defined configuration on all switches in the fabric. ad - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 42
operation to succeed. Not all existing user sessions to a deleted Admin Domain are number. The rename operation remains in the transaction buffer until you issue ad --apply or ad --save. --save Saves the outstanding Admin Domain transaction to the defined configuration on all switches in the fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 43
, all Admin Domain information from the transaction buffer, defined configuration and effective configuration is displayed. --validate arguments Checks whether Admin Domain members are from a non-Admin Domain aware switch or the members do not exist in the fabric. The output is similar to ad --show - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 44
a number. For ad --create, both name and number can include: • Supports node or port WWNs. • End-device members, switch. Any switch member specified in Domain ID format is converted into a switch WWN-based on the current fabric information. Operations with switch list fail if the domain ID to switch - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 45
,5; 4,1" To apply all changes made to the Admin Domain configurations since --apply was last executed: switch:admin> ad --apply You are about to enforce the saved AD configuration. This action will trigger ad --apply to all switches in the fabric. Do you want to apply all admin domains (yes, y, no - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 46
only save the changes to Defined configuration. Any changes made will be enforced only on ad --apply. Do you want to save admin domains (yes, y, no, n): [no] y To select a new Admin Domain context by specifying the AD number: switch:admin> ad --select 12 16 Fabric OS Command Reference 53-1001337 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 47
: AD255 Defined configuration AD: 1 : AD1 Active Device WWN members: Switch port members: Switch WWN members: 21:00:00:80:e5:12:8b:37; 21:00:00:80:e5:12:8b:55; 1,0; 1,1; 1,2; 1,3; 1,4; 1,5; 1,6; 1,7; 1,8; 1,9; 1,10; 1,11; 1,12; 1,13; 1,14; 1,15; 10:00:00:60:69:00:02:53; Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 48
2 ad 18 To display the Admin Domain effective configuration information: switch:admin> ad --show -m 2 Current AD: 255 : AD255 Effective configuration AD: 1 : AD1 Active Device WWN members: Switch port members: Switch WWN members: 21:00:00:80:e5:12:8b:37; 21:00:00:80:e5:12:8b:55; 1,0; 1,1; - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 49
:17:00:00; 10:00:00:00:00:15:00:00; 10:00:00:00:00:07:00:00; Effective configuration AD Number: 50 AD Name: AD50 State: Active Device WWN members: Switch port members: 10:00:00:00:00:17:00:00; 10:00:00:00:00:15:00:00; 2,52; 2,53; 2,54 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 50
See Also To display the current Admin Domain transaction: switch:admin> ad --transshow Current transaction token is 26816 It is abortable switch:admin> ad --transshow There is no outstanding zoning transaction cfgSave, cfgTransShow, defZone, logout. 20 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 51
the following Access Gateway management functions: • Enable or disable Access Gateway mode. • Display current configuration and state of AG. • Configure and display F_Port to N_Port mapping. • Configure and display N_Port failover and failback policies. Fabric OS Command Reference 21 53-1001337 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 52
auto port configuration (APC) modes for a Port group. • Get or set timeout value for fabric name monitoring. • Display Port Groups and Member N_Ports. • Add or delete N_Ports in Port group. • Display all policies and their status. • Enable or disable auto port configuration (APC) policy. • Enable or - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 53
policy. A default port group "pg0" is created, which includes all configured N_Ports assigned to the policy. Enabling port grouping policy disables the Get Fabric Name policy. auto Enables the automatic port configuration policy. When enabled, this policy applies to all ports on the switch. All - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 54
N_Port mapping. --pgshow [pgid] Displays the Port Group configuration. The port grouping feature supports specifying a set of N_Ports to be included in the Port Group (PG) Policy. The factory default PG is "pg0", which includes all N_Ports. The default PG cannot be removed or renamed. --pgcreate - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 55
. Login balancing mode is by default disabled in all port groups. mfnm Enables the managed fabric name monitoring mode (MFNM) in the specified port group. This command changes the fabric name monitoring mode from "default" to "managed". In both default and managed mode, the system queries - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 56
before a secondary N_Port can be configured. The list of F_Ports to be mapped must be enclosed in double quotation marks. Port numbers must be separated by semicolons. list ("") indicates no access. ADS policy must be enabled for this command to succeed. Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 57
Configures the persistent ALPA feature. Once enabled, the ALPA parts by default disabled. 1 | 0 mode Specify 1 to enable enabled on N_Ports 9 and 12: switch:admin> ag --show Name : switch_ST1 NodeName : 10:00:00:05:1e:35:9b:e7 Number of Ports : 16 IP Address(es) : 10.115.74.53 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 58
Gateway mode is NOT enabled. AG group policy commands 1. To show current policies: switch:admin> ag --policyshow AG Policy Policy_Name State Port Grouping pg Enabled Auto Port Configuration auto Disabled Advanced Device Security ads Disabled 28 Fabric OS Command Reference 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 59
no, n): [no] y Access Gateway configuration has been restored to factory default 6. To enable ADS policy: switch:admin> ag --policyenable ads The policy ADS is enabled 7. To disable ADS policy: switch:admin> ag --policydisable ads The policy ADS is disabled AG port mapping commands 1. To display - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 60
- Failover and Failback indicate whether or not N_Port policy is enabled (1) or disabled (0). - PG_ID is the Port Group ID and PG_Name is the Port Group Name. 2. To clear all F_Ports mapped to the configured primary N_Port 0: switch:admin> ag --mapset 0 "" F_Port to N_Port mapping has been updated - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 61
failover policy is disabled for port 0 switch:admin> ag --failbackenable 2 Failback policy is enabled for port 2 switch:admin> ag --failbackenable 3 Failback on N_Port 3 is not supported switch:admin> ag --failbackenable 2 Failback on N_Port 2 is supported ag 2 Fabric OS Command Reference 31 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 62
0 pg0 lb,mfnm 0;2 4;5;6 3 FirstFabric lb 1;3 10;11 5. To enable managed fabric name monitoring in port group 3: switch:admin> ag --pgsetmodes 3 "mfnm" Managed Fabric Name Monitoring mode has been enabled for Port Group 3 switch:admin> ag --pgshow PG_ID PG_Name PG_Mode N_Ports F_Ports - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 63
Name Monitoring TOV: 120 seconds 8. To set the fabric name monitoring timeout value to 30 seconds: switch:admin> ag --pgfnmtov 30 AG Preferred port information commands 1. To display preferred port settings for F_Ports: switch:admin> ag --prefshow F_Ports Preferred N_Port 10;11 0 12 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 64
ACCESS 13 ALL ACCESS Persistent ALPA configuration commands To enable persistent ALPA in flexible mode: switch:admin> ag --persistentalpaenable 1 -f Persistent ALPA mode is enabled To enable persistent ALPA in stringent mode: switch:admin> ag --persistentalpaenable 1 -s Persistent ALPA mode - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 65
database and to verify the removal: switch:admin> ag --clearalpamap 5 ALPA Table for port 5 is cleared switch:admin> ag --clearalpamap 5 Hash table for Port 5 data PWWN ALPA Hash Table is empty portCfgNPort, portCfgNPIVPort, agAutoMapBalance Fabric OS Command Reference 35 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 66
, the command displays the following information for each configured port group: PG_ID Port Group number LB mode Login Balancing mode: enabled or disabled nport Enabled or disabled fport Enabled or disabled • If Auto Policy is enabled on the switch, the command displays the status of the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 67
login distribution configuration. --help Displays the command usage. Examples To display the automatic login redistribution settings for port groups 0 and 1: switch:admin> agautomapbalance --show AG Policy: pg PG_ID LB mode nport fport 0 Enabled Enabled Disabled 1 Disabled - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 68
F_Ports and N_Ports on port group 1 in the Access Gateway: switch:admin> agautomapbalance --enable -fport pg 1 To disable automatic login redistribution on F_Ports and N_Ports on all port groups in the Access Gateway: switch:admin> agautomapbalance --all ag, agshow 38 Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 69
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. Ports The number of ports in the Access Gateway. Enet IP Addr The IP address of the Access Gateway. Firmware Current firmware running on the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 70
/Remote Name 10:00:00:05:1e:04:06:ae 24 10.32.173.64 v6.0.0 local L5D2_B14_4024_1 See Also To display all Access Gateways attached to the fabric: switch:admin> agshow Worldwide Name Ports Enet IP Addr Firmware Local/Remote Name 10:00:00:05:1e:02:b7:2c 16 10.32.173.62 v6 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 71
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 cfgSave. Notes The execution of this command is subject to Virtual Fabric or Admin Domain restrictions - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 72
change to become effective, enable the zone configuration with the cfgEnable command. For the change to be preserved across switch reboots, save the zone configuration to nonvolatile memory with the cfgSave command. Notes The execution of this command is subject to Virtual Fabric or Admin Domain - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 73
change to become effective, enable the zone configuration with the cfgEnable command. For the change to be preserved across switch reboots, save the zone configuration to nonvolatile memory with the cfgSave command. Notes The execution of this command is subject to Virtual Fabric or Admin Domain - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 74
change to become effective, enable the zone configuration with the cfgEnable command. For the change to be preserved across switch reboots, save the zone configuration to nonvolatile memory with the cfgSave command. Notes The execution of this command is subject to Virtual Fabric or Admin Domain - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 75
to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. When an FCS policy is enabled, this command can be issued only from the primary FCS switch. Operands When invoked without an operand, this command displays all zone configuration information (defined and - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 76
default policy. Distributed path selection (DPS) is supported in logical fabrics. APT policy settings affecting the DPS behavior can be configured per logical switch, and settings apply to the partition for which they are set. Note that policy settings for the base switch or any switch in the base - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 77
Refer to dlsSet for the definition of a fabric event. 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 option supported under both port-based and exchange-based policies. The following policies are - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 78
2-SECURITY, 3-CONFIGURATION, 4-FIRMWARE and 5-FABRIC filters. This operand is required. --severity severity_level Sets audit severity level. When severity is set, only log messages of type severity_level and higher are displayed. Valid values are INFO, WARNING, ERROR, and CRITICAL. By default, all - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 79
See Also switch:admin> auditcfg --show Audit filter is disabled. 1-ZONE 2-SECURITY 3-CONFIGURATION 4-FIRMWARE 5-FABRIC Severity level: INFO auditDump auditCfg 2 Fabric OS Command Reference 49 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 80
started. 2 AUDIT, 2008/08/11-13:17:30 (UTC), [SULB-1003], INFO, FIRMWARE, NONE/NONE/NONE/None/CLI, None/sw48000_100/FID CHASSIS, , Firmwarecommit has started. [output truncated] To clear the audit log: switch:admin> auditdump -C See Also auditCfg 50 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 81
, if applicable, used on the port. Authentication parameters are set on a per-switch basis. If Virtual Fabrics are enabled, all authentication parameters apply to the current logical switch context only, and must be configured separately for each logical switch. Use setContext to change the current - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 82
system for FIPS. Refer to the Fabric OS Administrator's Guide for details on FIPS configuration. --policy Sets the switch authentication policy or device authentication policy. The following options are supported: -sw on|off|active|passive Sets the switch authentication policy. Specify one of the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 83
specifying the port number. allE Specify all E_Ports in the switch. Examples To display authentication configuration on the switch: switch:admin> be segmented during next E-port bring-up. ARE YOU SURE (yes, y, no, n): [no] y Auth Policy is set to ACTIVE Fabric OS Command Reference 53 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 84
to ON 2008/03/24-23:13:06, [AUTH-1003], 112,, INFO, Stealth_3, Device authentication type has been successfully set to ON To start authentication on E/F_Ports 2, 3, and 4: switch:admin> authutil --authinit 2,3,4 To disable md5 hash type for FIPS configuration: switch:admin> authutil --show AUTH - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 85
banner for a switch: switch:admin> bannerset "My banner" switch:admin> bannerSet Please input context of security banner (press "." RETURN at the beginning of a newline to finish input): Do not log into this switch if you are not an authorized administrator. See Also bannerShow Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 86
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the banner for a switch: switch:admin> bannershow Banner: Do not log into this switch if you are not an authorized administrator. See Also - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 87
In this example, from a switch with 128 ports, the member ports consist of ports 7, 13, 42, 84, 85, and 86. The final Member Ports bit set represents the embedded port (frames sent to be handled by firmware) and is typically set. See Also portRouteShow Fabric OS Command Reference 57 53-1001337 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 88
> To display the GbE port mode for the Brocade FX8-24 blade in slot 4: switch:admin> bladecfggemode --show -slot 4 bladeCfgGeMode: Blade in slot 4 is configured in 10GigE Mode 10GigE mode: only xge0 and xge1 are enabled (ge0-9 ports are disabled) switch:admin> 58 Fabric OS Command Reference 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 89
: Blade in slot 1 is configured in 1GigE Mode 1GigE mode: only the ge0-9 ports are enabled (xge0 and xge1 are disabled) bladeCfgGeMode: Blade in slot 4 is configured in 10GigE Mode 10GigE mode: only xge0 and xge1 are enabled (ge0-9 ports are disabled) none Fabric OS Command Reference 59 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 90
this command to disable all user ports on a blade. All Fibre Channel ports on the blade are taken offline. If the switch was connected to a fabric through this blade, the remaining switches reconfigure, and the switch reconfigures based on the other blade ports. As each port is disabled, the front - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 91
1 SW BLADE 2 ENABLED 2 SW BLADE 2 ENABLED (User Ports Disabled) 3 SW BLADE 2 ENABLED 4 SW BLADE 2 ENABLED 5 CP BLADE 1 ENABLED 6 CP BLADE 1 ENABLED 7 SW BLADE 2 ENABLED 8 SW BLADE 2 ENABLED 9 SW BLADE 2 ENABLED 10 SW BLADE 2 ENABLED bladeEnable, chassisDisable - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 92
Use bladeEnable to re-enable the blade after making configuration changes or running offline diagnostics. If the switch is connected to a fabric through previously disabled ports, it rejoins the fabric. If this switch remains the principal switch at the end of the fabric countdown, it assigns itself - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 93
VACANT 4 SW BLADE 2 ENABLED 5 CP BLADE 1 ENABLED 6 CP BLADE 1 ENABLED 7 SW BLADE 2 ENABLED 8 UNKNOWN VACANT 9 UNKNOWN VACANT 10 UNKNOWN VACANT bladeDisable, chassisDisable, chassisEnable, portEnable, portDisable, switchDisable, switchShow Fabric OS Command Reference 63 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 94
To swap area numbers between matching port pairs of two slots: switch:admin> bladeswap -src 1 -dest 3 bladeswap done See Also portSwapEnable, portSwapDisable, portSwapShow, portShow, portEnable, portDisable, bladeEnable, bladeDisable, switchShow, switchEnable 64 Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 95
--help Description Use this command to configure the boot LUN for an HBA. Existing fabric-based boot LUN discovery allows the host's boot LUN information to be stored in the fabric zone database by using a zone name that contains the PWWN of an HBA port. The zone members consist of storage - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 96
end of the link. This is not a permanent condition. The load does not exceed the physical capacity of the channel as such, but can occur because of an underperforming device connected to the fabric port. Bottleneck monitoring can help identify these devices. When bottleneck monitoring is enabled - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 97
1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is supported only on Fibre Channel F_Ports and FL_Ports. When you attempt to enable bottleneck monitoring on multiple ports, only the intersection of specified ports and currently eligible ports will have - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 98
-qtime quiet_time Specifies the minimum number of seconds between consecutive alerts. The default is 300 seconds. The maximum is 86400 seconds (24 hours). --disable Disables bottleneck detection on one or more specified ports. If Virtual Fabrics are enabled on the switch, the ports do not need to - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 99
:54:10 80.00% To display the ports which are monitored for devices affected by latency bottlenecks: switch:admin> bottleneckmon --status Slot Port Alerts? Threshold Time (s) Quiet Time (s) 2 0 N -- -- -- 2 1 Y 0.200 250 500 2 24 N -- -- -- none Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 100
in enabled state) By default, eight frames are transmitted and received on each port. The test method is as follows: 1. Set all ports present , 0x47, ... 7) RANDOM: 0x25, 0x7f, 0x6e, 0x9a, ... Notes This command does not support High Availability (HA). 70 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 101
(loopback plugs) 2 External (SERDES) loopback 7 Back-end bypass & port loopback -spd_mode mode 8 Back-end bypass & SERDES loopback Specifies the speed mode for the test. On the Brocade Encryption platforms only a speed of 4 Gbps is supported and spd_mode defaults to 4 when the parameter is not - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 102
on ports 80-90 PASSED Test Complete: bpportloopbacktest Pass 1 of 1 Duration 0 hr, 0 min & 24 sec (0:0:24:599). Cleaning up after test....... passed. Diagnostics When it detects failures, the test may report one or more of the following error messages. If errors persist, contact Technical Support - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 103
list of blade ports to test. By default all blade ports in the specified blade are tested. Note that on the Encryption platform, ports 80-103 are the blade ports connected to the BP ASICs. Refer to the itemlist help page for further information on the itemlist parameter. Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 104
2 bpTurboRamTest Example SEE ALSO To run the test in default mode: switch:admin> bpturboramtest Running bpturboramtest Board Init Running Vader bist test Vader 0 hr, 1 min & 55 sec (0:1:55:884). Cleaning up after test....... passed. turboramtest 74 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 105
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. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 106
the change to take effect, enable the configuration with the cfgEnable command. For the change to be preserved across switch reboots, save the configuration to nonvolatile memory with the cfgSave command. Notes The execution of this command is subject to Virtual Fabric or Admin Domain restrictions - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 107
a zone configuration is enabled, you are warned to first disable the enabled zone configuration or to provide a valid configuration with the same configuration in nonvolatile memory for all the switches in the fabric. If no current zoning configuration exists, use the cfgSave command. If the default - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 108
to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. When an FCS policy is enabled, this command can be issued only from the primary FCS switch. Operands The following operands are required: "cfgName" Specify a name for the zone configuration in double - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 109
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. Notes The execution of this command is subject to Virtual Fabric or Admin Domain restrictions - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 110
current zone configuration: switch:admin> cfgdisable You are about to disable zoning configuration. This action will disable any previous zoning configuration enabled. Do you want to disable zoning configuration? (yes, y, no, n): [no] y See Also cfgClear, cfgEnable, cfgSave 80 Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 111
1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. When an FCS policy is enabled, this command can be issued only from the primary FCS switch. Operands The following operand is required: cfgName Specifies the name of the zone configuration. Examples To enable the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 112
part of the Zone DB will be able to see each other. Displays command help. Examples To enable fabric-wide McDATA safe zoning: switch:admin> cfgmcdtmode --enable safezoning To disable fabric-wide McDATA safe zoning: switch:admin> cfgmcdtmode --disable safezoning To enable fabric-wide McDATA default - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 113
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. Notes The execution of this command is subject to Virtual Fabric or Admin Domain restrictions - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 114
in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. When an FCS policy is enabled, this command can be issued only from the primary FCS switch. Operands none Examples To save a zone configuration: switch:admin> cfgsave You are about to save - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 115
is only effective when the Brocade switch/director is in McDATA fabric mode. Operands The cfgSaveActiveToDefined command has no operands. Examples Execute the cfgShow command to view defined and effective zoning configurations. switch:admin> cfgShow Default Zone: OFF Safe Zone: OFF Defined - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 116
sees in the fabric are based on this configuration. The effective configuration is built when a specific zone configuration is enabled and all error checking has been completed successfully. When this command is executed after a zoning transaction was aborted on the local switch, it displays - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 117
20:37:0c:71:df See Also To display only configuration names: switch:admin> cfgshow "*" cfg: USA1 Blue_zone cfg: USA_cfg Red_zone; Blue_zone cfgAdd, cfgClear, cfgCreate, cfgDelete, cfgDisable, cfgEnable, cfgRemove, cfgSave, cfgTransAbort, cfgTransShow Fabric OS Command Reference 87 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 118
the zone configuration to all switches in the fabric. Committed size Displays the size of the defined configuration currently stored enabled, this command can be issued only from the primary FCS switch. In order to support non-disruptive Hot Code Load on a Brocade 5100 with Virtual Fabrics enabled - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 119
size - 0 bytes See Also AD Database Size: committed - 3124 bytes transaction - 0 bytes Number of ADs in Effective Configuration - 4 Each AD's Zone Database Size: cfgsize Info for AD Number:0 committed - 242 bytes transaction - 0 bytes (AD Name: AD0, State=Active): cfgsize Info - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 120
without committing it. All changes made since the transaction was started are removed and the zone configuration database is restored to the state before the transaction was started. If a transaction is open on a different switch in the fabric when this command is run, the transaction on the other - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 121
Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. When an FCS policy is enabled, this command can be issued only from the primary FCS switch. Operands none Examples To display the current transaction - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 122
port is suppressed, and only the beaconing pattern is shown. Other commands are still executable and functional. However, if diagnostic frame-based Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operand: mode Specify 1 to enable - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 123
be implemented with caution. User account data and passwords might not be saved with configUpload. User accounts created with the userConfig command are deleted and user accounts are reset to factory defaults. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 124
Description Use this command to manually distribute IP Filter policies. The behavior of this command depends on whether Virtual Fabrics are enabled or disabled. • In Virtual Fabric mode, this command distributes the IP filter policy databases from a specified logical switch to all chassis that are - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 125
y ChassisDistribute operation succeeded for above topology To distribute the IP Filter policies to all switches in the fabric that support the distribute feature (Virtual Fabrics are disabled on the evoking switch): switch:admin> chassisDistribute -db "IPFILTER" -domain "*" FID DOMAIN CHASSISWWN - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 126
command to enable a Virtual Fabric-aware chassis. All Fibre Channel ports that passed the power-on self test (POST) are enabled. They may come online if connected to a device, or remain offline if disconnected. Use chassisEnable to re-enable the chassis after making configuration changes or running - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 127
Virtual Fabric-aware chassis. All Fibre Channel ports are taken offline. This command prompts for confirmation unless the -force option is used. If the chassis is partitioned into logical switches that are part of logical fabrics, the remaining switches in these fabrics reconfigure. As each port is - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 128
, numbers, underscore or hyphen characters. Spaces are not permitted. This operand is optional; if omitted, the current chassis name displays. Examples To change the chassis name to "dilbert": switch:admin> chassisname dilbert switch:admin> chassisname dilbert See Also switchName 98 Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 129
Power Consume Factor: -xxx 5 Part number (up to 14 characters): Factory Part Num: xx-xxxxxx-xx 6 Serial number (up to 12 characters): Factory Serial Num: xxxxxxxxxx 7 FRU of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 130
switch: switch:user> chassisshow Chassis Backplane Revision: 1C SW BLADE Slot: 3 Header Version: Power Consume Factor: Factory Part Num: Factory Serial Num: Manufacture: Update: Time Alive: Time Awake: ID: Part 7 Year: 2001 88 days 16 days slotShow 100 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 131
the switch: • Timestamp • Username • IP address of the Telnet session • Options • Arguments This command displays the local CLI command history. The information is saved as part of supportSave as the CH file. It is also saved persistently to compact flash if the switch panics. The maximum number of - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 132
. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands None Examples To run FCoE using the minimum switch configuration: switch:admin> cmsh admin>en admin>#conf t Enter configuration commands, one per line. End with CNTL/Z. admin>(config)#int - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 133
te-0/0)# vlan classifier activate group 1 vlan 5 switch:admin>(config-if-te-0/0)# cee test switch:admin>(config-if-te-0/0)#no shutdown switch:admin>(config-if-te-0/0)#exit switch:admin>(config)#exit switch:admin>#exit fcoe, fcoeLoginGroup, fcoeLoginGroup Fabric OS Command Reference 103 53-1001337 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 134
fid FID | -all] Use this command to reset the non-persistent configuration settings to their factory defaults. Beginning with Fabric OS v6.2.0, configuration data is grouped into chassis information and switch information. Each configuration type is managed separately. The behavior of configDefault - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 135
ID of the logical switch for which to reset the configuration. This operand is valid only in Virtual Fabric mode, and the executing account must have chassis permissions. -all Restores all non-persistent configuration parameters to factory defaults (switch and chassis parameters). Examples - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 136
USB device. Use the -vf option to download the Virtual Fabric configuration parameters. The Virtual Fabric configuration file includes logical switch definitions for a specific platform, the platform ID, Virtual Fabric status (enabled or disabled), and F_Port trunking ports. The file should be named - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 137
parameters. - Downloading a configuration file from a system that is not Virtual Fabric-capable to a system in Virtual Fabric mode is not recommended. The configuration is applied to the default switch only, and only to the ports that are part of the default switch. If an FCS policy is enabled, the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 138
). If no protocol is specified, the protocol defaults to FTP. -vf Downloads the Virtual Fabric configuration (switch-conf_xx.txt) instead of the regular system configuration. The switch-con_xx.txt file contains a listing of logical switches configured on the platform specified by the platform ID - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 139
. This parameter allows you to effectively swap logical switch configurations. Note that all ports in the FID are reset to the default state when downloading data from the source FID. Downloads the chassis configuration only. Specifies the name or the IP address of the external host, from which to - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 140
:admin> configdownload -fid 8 -sfid 4 -USB config_fid8.txt To download the Virtual Fabric configuration file using FTP: switch:admin> configdownload -vf -p ftp 10.32.248.119,jdoe,/temp/switch-conf_66.txt,mypassword Diagnostics The configuration download may fail for one or more of the following - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 141
a list of configuration files stored on the local chassis: switch:admin> configlist -local config.txt config2.txt next_cfg.txt 25679 25679 20977 2007 Jan 02 15:16 2007 Jan 06 15:16 2007 Jan 18 15:16 See Also configDownload, configUpload, configShow, configRemove Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 142
-local first_config.txt To remove a configuration file from an attached USB device without specifying a filename: switch:admin> configremove -USB File Name [config.txt]: second_config.txt See Also configDownload, configUpload, configList, configShow 112 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 143
not supported. Some configuration settings do not display when filtered. When in doubt, use the command without the -pattern operand. -all -fid FID Displays all configuration data including chassis and switch configuration. Displays configuration data for a logical switch specified by its fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 144
. Examples To display all configuration data on a Virtual Fabric-enabled system: switch :admin> configshow -all [Configuration upload Information] Configuration Format = 2.0 date = Tue Oct 7 14:54:20 2008 FOS version = v6.2.0.0 Number of LS = 3 [Chassis Configuration Begin] [fcRouting] fcRoute - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 145
111 ipfilter.1.rule.6:0,0x23,0,0,6,80 ipfilter.1.rule.7:0,0x23,0,0,6,443 ipfilter.1.rule.8:0,0x23,0,0,17,161 ipfilter.1.rule.9:0,0x23,0,0,17,111 ipfilter.1.state:3 ipfilter.1.type:1 [output truncated] To filter the content to display only the password configuration: switch :admin> configshow -all - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 146
Number of LS = 3 [Switch Configuration Begin : 0] SwitchName = Spirit_66 Fabric ID = 20 [Boot Parameters] boot.name:Spirit_66 boot.ipa:10.32.228.66 boot.licid:10:00:00:05:1e:41:5c:c1 boot.mac:10:00:00:05:1e:41:5c:c1 boot.device:eth0 boot.gateway.ipa:10.32.224.1 [Configuration] acl.clear:0 ag.port - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 147
the user is allowed to execute. • In a non-Virtual Fabric environment, this command by default uploads the switch configuration only. Additional options support uploading the chassis configuration (-chassis) or all of the system's configuration data, including chassis and switch configurations (-all - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 148
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Do not manually edit a configuration or a switch-conf.xx file after uploading the file and before downloading the file to a switch. Manual editing bypasses sanity checks for some - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 149
To upload the switch configuration interactively from a switch that is not enabled for Virtual Fabrics: switch:admin> configupload Protocol (scp, ftp, local) [ftp]: Server Name or IP Address [host]: 192.168.38.245 User Name [user]: jdoe File Name [/config.txt]: Password: configUpload - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 150
known to the switch. • The host IP address cannot be contacted. • The user does not have permission on the host. • The FTP server is not running on the host. See Also configDefault, configDownload, configShow, configList, configRemove, configure, configureChassis 120 Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 151
with the configure command: • Switch fabric parameters • Virtual channel parameters • F_Port login parameters • Zoning operation parameters • Remote State Change Notifications (RSCN) transmission mode • Arbitrated Loop parameters • System Services settings • Portlog Events enable or disable settings - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 152
be in agreement among all switches to allow formation of the fabric. Table 2 lists the switch fabric settings that can be modified. TABLE 2 Configure command fabric parameters (* = multiplication symbol) Field Type Default Range Domain Allow XISL Use Enable a 256 Area Limit R_A_TOV E_D_TOV - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 153
supported only on Virtual Fabric-aware platforms under the following conditions: Virtual Fabrics must be enabled on the switch, and the switch cannot be a base switch. In addition, on the Brocade DCX or DCX-4S the switch cannot be a default switch, include interchassis link (ICL) ports or GbE ports - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 154
the Fibre Channel islands. MAX_HOPS Maximum hops is an integer that denotes the upper limit on the number of hops a frame might have to traverse to reach any destination port from any source port across the fabric. Note that the R_A_TOV, E_D_TOV, WAN_TOV, and MAX_HOPS configuration parameters - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 155
attempts to acquire from the fabric the domain number programmed in its "Switch Fabric Settings." If the operation fails, the switch will segment from the fabric. Virtual Channel Settings The switch enables fine-tuning for a specific application by configuring the parameters for eight virtual - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 156
-device for switch IP address or name change Type number number Default 1 0 Range 0 to 2 0 to 1 End-device RSCN Transmission Mode values are as follows: 0 RSCN only contains single PID 1 RSCN contains multiple PIDs 2 Fabric addresses RSCN Domain RSCN to End-device for switch IP address or - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 157
attributes are enabled. TABLE 9 Configurable application attributes Application File Type Default Range ssl rpcd Webtools Certificate File CA Certificate File Length of crypto key Secure RPCd Callback secret Basic User Enabled Perform License Checking and Warning Allow Fabric Event - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 158
Examples :See Also To enable XISL use on a logical switch with FID 20: switch:admin> setcontext 20 switch:admin>switchdisable switch:admin>configure Configure... Change fabric parameters? Y Change domain[30]: Allow XISL Use [no]: yes Enable a 256 Area Limit[0]: R_A_TOV: (4000..120000) [10000 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 159
that may be modified. TABLE 10 Configurable application attributes Application Attribute Type Default Range cfgload Enforce secure Config Upload/Download boolean no Enforce signature validation for firmware boolean no no/yes no/yes Fabric OS Command Reference 129 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 160
error causes the problem blade to be powered off. Examples To enable signature validation for downloading firmware: switch:admin> configurechassis Not all options will be available on an enabled switch. To disable the switch, use the "switchDisable" command. Configure... cfgload attributes (yes - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 161
corruption. If you are configuring multi-path LUNs as part of an HA cluster or DEK cluster or as a standalone LUN accessed by multiple hosts, follow the instructions described in the section "Configuring a multi-path Crypto LUN" in the Fabric OS Encryption Administrator's Guide. Note The execution - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 162
by the switch IP address or switch WWN, which is subsequently referred to as the "node WWN." The node configuration commands include the following functions: • Node initialization and certificate generation. • Certificate export and import to and from a specified host or USB device. • Enabling or - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 163
EE Reachability: If the EE is part of an encryption group, the following information is displayed for the peer. Node WWN/Slot, EE IP Address, EE State, and IO refer to the Fabric OS Encryption Administrator's Guide. Operands The cryptoCfg node initialization and configuration function has the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 164
copy (SCP) protocol. When -scp is specified, the following operands are required: host IP | host_name Specifies the IP address of the host to which the file is to be exported. To specify the host by name, it must first be configured with dnsconfig. 134 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 165
Specifies the IP address or name of the host from which to import the file. To specify the host by name, it must first be configured with dnsconfig. host_username Specifies the user name for the host. Depending on your host configuration, this command may prompt for a password. Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 166
. This is a user-generated file name. Specifies the switch world wide member_node_IP_addr Specifies the IP address of the enabled and the quorum size is greater than zero, this operation requires authentication of a quorum of authentication cards. This command is valid on all nodes. 136 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 167
based on the switch WWN. The username and group under which the username should be created on the key vault are displayed when the command is executed. Configure the password on the switch , refer to the Fabric OS Encryption Administrator's Guide. Fabric OS Command Reference 137 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 168
key vault and are managed as a group. All EEs in a node are part of the same encryption group. Fabric OS v6.2.0 and later support up to four nodes per encryption group, and up to two encryption engines per node. The maximum number of EEs per encryption group is sixteen (four per member node). 138 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 169
Refer to the Appendix of the Fabric OS Encryption Administrator's Guide for a more comprehensive explanation of system states. Use --show -groupcfg to display encryption group and member configuration parameters, including the following: • Encryption group name: user-defined label • Encryption group - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 170
the command displays the following: - EE slot number: the encryption engine slot number - SP state: refer to the appendix in the Fabric OS Encryption Administrator's Guide - Current master key ID (if RKM is configured) or primary link key ID (if LKM is configured). - Alternate master key ID (if RKM - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 171
configurations, CryptoTarget container/LUN configurations, or tape pool configurations user the case of the HP SKM, this operand IP address. If you are registering a key vault that is part of an RKM cluster, the value for ip_address is the virtual IP Fabric OS Command Reference 141 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 172
by default. manual Enables manual failback. In this mode, failback must be initiated manually after an encryption switch or blade that failed earlier has been restored or replaced. --set -hbmisses value Sets the number of heartbeat misses allowed in a node that is part of an encryption group - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 173
| disable Enables or disables the system card requirement. The policy is by default disabled. --add -membernode Adds the specified member node to the existing encryption group. The member node is specified by its node WWN. This command is valid only on the group leader. Initial setup on the node - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 174
CryptoTarget container and Crypto LUN configurations from this node prior to default this command backs up the key to the attached key vaults, or optionally to a predetermined file on the switch to the alternate position to enable decryption of older data Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 175
-cfg Displays encryption group configuration information. -stat Displays encryption group status information. --sync -encgroup Manually synchronizes the encryption group database [slot_number] cryptocfg --show -hacluster -all | HA_cluster_name Fabric OS Command Reference 145 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 176
fails if the member nodes' IP addresses for the GbE ports (I/O sync ports) are not configured. The encryption engines must belong to different switches or chassis. This rule is enforced by the CLI to ensure redundancy. The following operands are supported: HA_cluster_name Specifies the name for - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 177
, the alternate encryption engine automatically becomes part of the configured HA cluster and disrupted peer relationships are repaired. This command is only valid on the group leader. The following operands are supported with the --replace command: Fabric OS Command Reference 147 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 178
the encryption engine to be replaced is not part of an HA cluster. current_node_WWN [slot_number] include the encryption engine slot number. new_node_WWN [slot_number] Specifies the configuration is displayed. When invoked on the group leader, both defined and committed configuration 148 Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 179
the target ports. Virtual devices redirect the traffic between host and target/LUN to encryption engines so they can perform cryptographic operations. To enable frame redirection, you must create a target-initiator zone prior to performing any CryptoTarget container configuration. Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 180
your configuration. Refer to the Appendix of the Fabric OS Encryption Administrator's Guide for user-defined label - Type: disk or tape - EE node: The node WWN - EE slot: the slot number for the encryption engine - Target: The target port WWN - Target PID: The target PID - VT: The virtual target port - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 181
value • For each container - Container name: a user-defined label - Type: tape or disk - EE node: the node WWN - EE slot: numeric value - Target: target port WWN, node WWN - VT: virtual target port WWN, node WWN - Number of hosts: numeric value - Configuration status: committed or defined - For each - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 182
Rekey: enabled or disabled • LUN state: refer to the appendix in the Fabric OS Encryption Administrator's Guide • Encryption algorithm: AES256 -XTS (disk), AES256-CCM (tape), or none • Key ID state: Re-key • Key ID: numeric identifier • Key creation time: date and time of key creation • Key life (in - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 183
or DF-compatible - Encrypt existing data: enabled or disabled - Rekey: enabled or disabled - Tape policy type: pool-based or LUN-based - Key life: key lifespan in days - Volume/pool label - LUN state: Refer to the Fabric OS Encryption Administrator's Guide. - Encryption algorithm: AES256 -XTS (disk - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 184
Container name: user-define label - EE node: node WWN - EE slot: Slot number - Target: target port WWN and node WWN - Target PID: target PID - VT: virtual target port WWN and node WWN - VT PID: virtual target PID - Host (initiator) PWWN - Host (initiator): node WWN 154 Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 185
: • Re-Key Setup • LUN Prep • Key Update - Operation in progress. Displays one of the following: • Read Phase • Write Phase • HA Sync Phase • LUN Cleanup - VI: virtual initiator port WWN and node WWN - VI PID: virtual initiator PID - Number of blocks: numeric value Fabric OS Command Reference 155 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 186
or for a specific container. The display includes the following information: • Number of tape sessions in progress: numeric value • Container name: user-defined label • EE node name: node WWN • EE Slot Number: slot number • Target: target port WWN and node WWN • Target PID: Target PID • VT: virtual - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 187
is created. Upon commit of a CTC configuration, one virtual target (VT) is created, and for each initiator that has the access to the target port, one virtual initiator (VI) is created. These virtual devices are created by logging into the fabric and registering with the Name Server. Initiator - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 188
number of the new encryption engine. --move -container Moves the specified CTC from its currently configured part of the same encryption group for this operation to succeed, but they do not need to be part to enable access for port WWN. initiator_NWWN Specifies the initiator node WWN. 158 Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 189
multi-path LUNs exposed through multiple target ports and thus configured on multiple CTCs on different EEs in an HA cluster or DEK cluster, the same LUN policies must be configured. Refer to the Fabric OS Encryption Administrator's Guide for more information. The following LUN policy parameters - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 190
present on the encryption switch or the chassis that houses the encryption blade. -encrypt | -cleartext Enables or disables the LUN for encryption. By default, cleartext is enabled (no encryption). When the name of the CTC to which the LUNs belong. 160 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 191
restored to default (disabled): refer to the Fabric OS Encryption Administrator's Guide. --remove - number of the LUN to be removed. Use --show -container for a list of LUN numbers associated with the specified CTC. initiator_PWWN Specifies the initiator port WWN for the LUN to be removed. Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 192
in a loss of data and should be exercised with caution. Refer to the Fabric OS Encryption Administrator's Guide for a description of conditions under which a LUN may be disabled and recommendations for re-enabling the LUN while minimizing the risk of data loss. The following operands are required - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 193
tape pool policy parameters while tape sessions are in progress. Refer to the Fabric OS Administrator's Guide for more information. [-encryption_format native | DF_compatible] [-encrypt | -cleartext] --manual_rekey Performs a manual re-keying of a specified LUN associated with a specified CTC - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 194
. The following operands are supported: -all -cfg Displays the configuration for all containers in the number. These operands must be used with either the -stat or the -cfg option. -cfg | -stat Displays either configuration information or runtime status for the specified tape pools. 164 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 195
The following operands are required: crypto_target_container_name Specifies the CryptoTarget tape container for the LUN. LUN_Num Specifies the number of the LUN to be cleared. initiator_PWWN Specifies the initiator port WWN for the specified LUN. Fabric OS Command Reference 165 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 196
Availability (HA) cluster configuration" on page 171 "E. Storage device configuration" on page 173 "F. Device configuration display commands" on page 175 For additional examples and configuration procedures, refer to the Fabric OS Encryption Administrator's Guide. 166 Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 197
:switch>cryptocfg -regEE Operation succeeded. To enable an encryption engine: SecurityAdmin:switch> Password: To register a member node with the group leader: SecurityAdmin:switch>cryptocfg --reg -membernode 10:00:00:05:1e:39:14:00 enc_switch1_cert.pem 10.32.244.60 Operation succeeded. Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 198
IP Addr EE State IO Link State 10:00:00:05:1e:50:4f:00/2 10.32.50.156 EE_STATE_ONLINE Reachable B. Encryption group configuration To create an encryption group "brocade": SecurityAdmin:switch> cryptocfg --create -encgroup brocade Encryption group create status: Operation Succeeded. 168 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 199
192.168.38.245 mylogin GL_MK.mk Password: Operation succeeded. To recover the master key from the key vault to the current location: SecurityAdmin:switch>cryptocfg --recovermasterkey currentMK -keyID bd:ae:2d:0b:b9:1a:ad:18:0d:eb:fe:c9:67:ed:29:b0 Fabric OS Command Reference 169 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 200
display the encryption group configuration: SecurityAdmin:switch>cryptocfg --show -groupcfg IP address: Certificate ID: Certificate label: State: Type: 10.32.49.59 3D2-LKM2-B10-59 LKM2 Connected LKM Authentication Quorum Size: 0 Authentication Cards not configured NODE LIST Total Number - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 201
configuration To set the failback mode to manual failback: SecurityAdmin:switch> cryptocfg --set -failbackmode manual switch> cryptocfg --create -hacluster HAC2 10:00:00:05:1e:53:4c:91 EE Node WWN: 10:00:00:05:1e:53:4c:91 Slot number: 0 Detected Create HA cluster status: Operation succeeded. Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 202
Status: Defined WWN Slot Number 10:00:00:05:1e:39:53:67 0 Status Online To initiate a manual failback of an encryption engine: SecurityAdmin:switch> cryptocfg --failback -EE 10:00:00:05:1e:39:53:67 0 22:00:00:04:cf:6e:57:62 Operation Succeeded 172 Fabric OS Command Reference 53-1001337 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 203
includes initiator and target. a. Determine the device configuration. FabricAdmin:switch>nsshow { Type Pid COS PortName NodeName TTL(sec) N 010600; 2,3;10:00:00:00:c9:2b:c9:3a;20:00:00:00:c9:2b:c9:3a; na NodeSymb: [35] "Emulex LP9002 FV3.82A1 DV5-4.81A4 " Fabric Port Name: 20:06:00:05:1e:41 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 204
LUN to the CTC with encryption enabled. FabricAdmin:switch>cryptocfg --add -LUN my_disk_tgt 0 10:00:00:00:c9:2b:c9:3a 20:00:00:00:c9:2b:c9:3a -lunstate cleartext -encrypt Operation Succeeded 7. Commit the device configuration. FabricAdmin:switch>cryptocfg --commit Operation Succeeded 8. Display - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 205
enabled AES256-XTS Read write 3a:21:6a:bd:f2:37:d7:ea:6b:73:f6:19:72:89:c6:4f Sun Jun 1 20:21:32 2008 9. Display Crypto LUN configuration. FabricAdmin:switch> 00:05:1e:41:4e:1d 20:01:00:05:1e:41:4e:1d Number of host(s): 1 Configuration status: committed Host: 10:00:00:00:c9:2b:c9:3a 20:00 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 206
24 20:0b:00:05:1e:53:8a:24 1 To display all configured tape pools: FabricAdmin:switch> cryptocfg --show -tapepool -all Tape pool label: Key life: Encryption mode: Encryption format: Configuration 05:1e:53:74:fd VT PID: 012805 Number of host(s): 1 Number of rekey session(s):1 Host: 10:00:00: - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 207
-key eb:d0:48:ce:e9:f2:40:89:da:d4:7e:10:18:72:fa:15 Fri May 16 02:03:48 2008 3000 (minute) 0 Sun May 18 04:03:48 2008 To display CryptoTarget container configuration information For a disk LUN with re-keying enabled: FabricAdmin:switch>cryptocfg --show -LUN my_disk_tgt 0x0 10 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 208
bytes: Number of compressed bytes: LUN number: 0x1 Tape session number: 1 Number of uncompressed blocks: Number of compressed blocks: Number of uncompressed bytes: Number of compressed bytes: Operation succeeded. 37466 36587 2455059456 1138031028 0 0 0 0 None 178 Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 209
command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, display sample data streams you can use with diagnostics: switch:admin> datatypeshow Pattern type example BYTE_FILL WORD_FILL QUAD_FILL BYTE_NOT - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 210
into account daylight saving time and the time zone setup of the switch. Each switch takes care of converting the GMT time distributed fabric-wide to its local time. Refer to tsTimeZone for more information on time zone support. If the switch is operating in FICON Management Server mode (fmsmode - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 211
To display the current date and time and then modify it: switch:admin> date Fri Jan 29 17:01:48 UTC 2007 switch:admin> date "0227123007" Thu Feb 27 12:30:00 UTC 2007 errShow, ficonCupSet, ficonCupShow, portLogShow, tsClockServer, tsTimeZone, upTime Fabric OS Command Reference 181 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 212
the debug and verbosity levels. Module names are case-sensitive. This operand is optional. Examples To display information about a specific module named NS: switch:admin> dbgshow NS Module NS, debug level = 1, verbose level = 1 See Also setDbg 182 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 213
effect, allowing access to all devices. When a user-specified zone configuration is enabled, it overrides the Default Zone access mode. Notes This command must be run from the primary FCS switch. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 214
--noaccess primaryfcs:admin> cfgsave primaryfcs:admin> defzone --show Default Zone Access Mode committed - No Access transaction - No Transaction primaryfcs:admin> cfgactvshow Effective configuration: No Effective configuration: (No Access) none 184 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 215
clear. If no operand is specified, the default is to clear all bad port flags. Examples To clear the diag software flag: switch:admin> diagclearerror 8 ERROR: DIAG CLEARERR Diagnostics Errors Cleared, port: 8/31 Err# 0120041 081F See Also none Fabric OS Command Reference 185 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 216
Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To disable the POST: switch:admin> diagdisablepost Config update Succeeded Diagnostic POST is now disabled. See Also diagEnablePost - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 217
place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To enable the POST: switch:admin> diagenablepost Config update Succeeded Diagnostic POST is now enabled. See Also diagDisablePost Fabric OS Command Reference 187 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 218
information: switch:admin> diaghelp bpportloopbacktest bpturboramtest ceeportloopbacktest ceeturboramtest (output truncated) Functional test of port via blade processor path. MBIST test for AP blade BP ASICs Functional test of port N->N path. MBIST test for ASICs See Also none 188 Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 219
value is displayed. Examples To enable and then disable the POST test: switch:admin> diagpost Diagnostic POST is currently disabled. switch:admin> diagpost 1 Config update Succeeded Diagnostic POST is now enabled. See Also diagDisablePost, diagEnablePost Fabric OS Command Reference 189 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 220
diagretry -show Diagnostic Retry Mode is currently enabled. switch:admin> diagretry 0 Config update Succeeded Diagnostic Retry Mode is now disabled. switch:admin> diagretry 1 Config update Succeeded Diagnostic Retry Mode is now enabled. See Also none 190 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 221
in -use_bports displays; otherwise, the user ports specified in -uports displays. The default value is 0. Examples To display diagnostic status on a switch blade: switch:admin> diagshow Diagnostics Status: Fri Feb 08 15:25:24 2002 Slot: 1 UPORTS Port BPort Diag Active Speed ...... 0 15 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 222
the debug and verbosity levels. Module names are case-sensitive. This operand is optional. Examples To display information about a specific module named NS: switch:admin> dbgshow NS Module NS, debug level = 1, verbose level = 1 See Also setDbg 192 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 223
Device Connection Control Policy PWD Password Database and Password Configuration Policy AUTH E_Port and F_Port Authentication Policy FCS Fabric Configuration Server Policy IPFILTER IP Filter Policy Each supported database has a switch-local configuration parameter that controls whether the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 224
Policy to domains 3 and 5 in the fabric: switch:admin> distribute -p "SCC;DCC" -d "3;5" To distribute the Switch Connection Control Policy, 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 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 225
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 option: switch:admin> dlsreset Committing configuration...done. switch:admin> dlsshow DLS is not set See Also aptPolicy, dlsSet, dlsShow Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 226
2 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 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 227
. Refer to dlsSet for a description of load sharing. Notes DLS is not supported in certain routing policies. Refer to aptPolicy for more information on routing policies. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 228
1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To set the DNS parameters for the system: switch:admin> dnsconfig Enter option 1 Display Domain Name Service (DNS) configuration 2 Set DNS configuration 3 Remove DNS configuration 4 Quit - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 229
supported on this platform" message. Note The execution of this command is subject to Virtual Fabric switch (indicates the physical position of the switch in the enclosure). connid The serial number of the switch used by the enclosure manager (not to be confused with the Factory Serial Number - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 230
Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To clear the error log messages: switch:admin> errclear See Also errDump, errShow 200 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 231
and the end delimiters (including the colon) so that they are not displayed. If no arguments are supplied to the command, it instead displays the existing errDelimiterSet configuration. These delimiters are stored persistently. Note The execution of this command is subject to Virtual Fabric or - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 232
identifier. External sequence number Sequence number for the message. Switch name Switch name for the generator of this message, or "chassis". Message Message body. End delimiter Delimiter string for the end of a message. Note The execution of this command is subject to Virtual Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 233
2 See Also 2008/08/25-10:13:41, [ZONE-1022], 9037, CHASSIS, INFO, Spir_67, The effective configuration has changed to meh. 2008/08/25-11:35:04, [FABR-1001], 9041, CHASSIS, WARNING, Spir_67, port 0, incompatible Long distance mode. 2008/08/25-11:39:35, [LOG-1000], 9043, CHASSIS, INFO, Spir_67 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 234
sensitive. Examples To display the current filter settings: switch:admin> errfilterset console: filter severity = WARNING See Also To set the filter severity level for the console: switch:admin> errfilterset -d console -v warning errDump, errShow 204 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 235
modules: switch:user> errmoduleshow Module IDs: 1 KT 2 UT 5 LOG 6 CDR 9 PIXE 10 EGR 13 PS 14 RTE 17 BLDE 18 BLM 21 CFLD 22 CFMN (output truncated) 3 TRCE 7 BLPU 11 BL 15 AS 19 BPRT 23 CHPS 4 KTRC 8 PISP 12 PIC 16 AUTH 20 CER 24 CONF See Also errDump, errShow Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 236
identifier. External sequence number Sequence number for the message Switch name Switch name for the generator of this message, or "chassis". Message Message body. End delimiter Delimiter string for the end of a message. Note The execution of this command is subject to Virtual Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 237
08/25-10:13:41, [ZONE-1022], 9037, CHASSIS, INFO, Spir_67, The effective configuration has changed to meh. [Type to continue, Q to stop: 2008/08/25-11:35:04, [FABR-1001], 9041, CHASSIS, WARNING, Spir_67, port 0, incompatible Long distance mode. [Type to continue, Q to stop: 2008/08 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 238
; the serial port returns to the login: prompt. The exit command is an accepted synonym for logout, as is typing Ctrl-D at the beginning of a line. Operands none Examples To exit from a shell session: switch:admin> exit Connection to host lost. See Also logout 208 Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 239
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: P0 Port Offline P1 Port Online P2 ELP ACC Received P3 Link Reset Done I0 Trunk Initiator: EMT Sent - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 240
E_Port isolation nbrWWN Neighboring switch's WWN nbrPort Neighboring switch's port lr_tid Link reset timer identifier and current state. red_ports All E_Ports that are connected to the same neighboring switch Note The execution of this command is subject to Virtual Fabric or Admin Domain - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 241
Examples See Also To display fabric port information: switch:admin> fabportshow 4/14 Fabric Port Information Port: State: List: List Count: Flags: nbrWWN: nbrPort: lr_tid: red_ports: 10 11 62 63 62 P3 0x10068418 0 0x280120 10:00:00:60:69:80:06:cf 5 0x1005dbd8, IDLE STATE Open commands pending - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 242
Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the retry count of Fabric OS commands: switch:user> fabretryshow SW_ILS E_Port ELP EFP HA_EFP DIA RDI BF FWD EMT ETP - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 243
following operands: -s | --show Displays the fabric log. -c | --clear Clears the fabric log. -d | --disable Disables the fabric log. By default, the fabric log is enabled. -e | --enable Enables the fabric log. -r size | --resize size Changes the maximum number of log entries. The specified - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 244
.068 *Removing all nodes from port 01:08:53.068 *Snd slv port (1) (-1) (2) 01:08:53.068 SCN Port Offline;g=0x42 01:08:53.072 *Removing all nodes from port 01:08:53.072 *Snd slv port (8) (-1) (2) Number of entries: 23 Max number of entries: 8192 To change the size of the fabric log: F2,P0 F2,P0 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 245
to set priorities for principal switch selection. The implementation of the fabricPrincipal command is based solely on mechanisms specified in the Fibre Channel standards. These mechanisms provide a preference for a switch requesting to be the principal switch in a fabric, but they do not provide - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 246
0 Principal Selection Mode disabled To enable the mode setting: switch:admin> fabricprincipal 1 Principal Selection Mode enabled To enable the mode setting and force fabric rebuild: switch:admin> fabricprincipal -f 1 Principal Selection Mode enabled (Forcing fabric rebuild) See Also fabricShow 216 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 247
and chassis name. Examples The following example illustrates a fabric of four switches. "sw180" is the Principal switch. Three of the switches are configured to run IP over Fibre Channel. switch:admin> fabricshow Switch ID Worldwide Name Enet IP Addr FC IP Addr Name 64: fffc40 10:00:00:60 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 248
67: fffc43 10:00:00:60:69:10:60:1f 192.168.64.187 0.0.0.0 "sw187" The Fabric has 4 switches To show a mixed fabric with IPv4 and IPv6-configured switches: sw5:admin> fabricShow Switch ID Worldwide Name Enet IP Addr FC IP Addr Name 1: fffc41 10:00:00:60:69:00:02:0b 192.168.64.180 192.168 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 249
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 • Number of fabric reconfigurations • Number of fabric segmentations as a result of any of the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 250
2 fabStatsShow Sec Incompatibility: 0 Sec Violation: 0 ECP Error: 0 Duplicate WWN: 0 Eport Isolated: 0 See Also fabRetryShow 220 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 251
fabric switch state structure information. This command is strictly for debugging; it is not intended as a user command. Note The execution of this command is subject to Virtual Fabric STATE Principal Domain: 2 Upstream Port: 64 Principal Wwn: 10:00:00:60:69:80:06:ce Principal Priority: 0x2 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 252
be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operand: unit Specifies the number of the fan unit to disable. Examples To disable a fan unit: switch:admin> fandisable 1 Fan unit 1 has been - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 253
"Command Availability" for details. Operands This command has the following operand: unit Specify the fan unit number to enable. Examples To enable a fan unit: switch:admin> fanenable 1 Fan unit 1 has been enabled See Also fanDisable, fanShow Fabric OS Command Reference 223 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 254
. The output from this command varies depending on switch type and number of fans present. Note This command is not available on non-bladed systems except for the Brocade 4100, 4900, and 5300. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 255
OS commands" and Appendix A, "Command Availability" for details. Operands Examples none To reboot the Control Processor without executing power-on self test (POST) on startup: switch:admin> fastboot See Also diagDisablePost, diagEnablePost, reboot Fabric OS Command Reference 225 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 256
be enabled on the blade. The blade comes up with GbE ports internally disabled. A maximum of four user ports per port group (0-7 or 8-15) may be configured as FC Fastwrite. This amounts to a maximum of eight FC Fastwrite ports per blade. The execution of this command is subject to Virtual Fabric or - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 257
-cycling of the affected blade to take effect and may take up to 5 minutes to complete. Non-bladed switches will be rebooted. In all cases, data traffic on all the ports (FC and GbE) of the blade will be disrupted. Continue (Y,y,N,n): [ n] portCfg Fabric OS Command Reference 227 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 258
MBIST and LBIST Specifies the GbE port to test. By default, all GbE ports in the specified slotnumber are used. Valid number values include: 0 GbE port 0 1 GbE port 1 2 All GbE ports Examples To run all tests on slot 7 and GbE port 1: switch:admin> fcipchiptest --slot 7 -unit 1 -testtype - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 259
When a failure is detected, the test might report one or more of the following error messages: CHIP_TEST_ERR CHIP_TEST_CHIP_INIT_ERR CHIP_TEST_IMAGE_VER_ERR CHIP_TEST_TIMEOUT_ERR CHIP_TEST_HEARBEAT_ERR CHIP_TEST_INVALID_RESULT See Also fcipPathTest Fabric OS Command Reference 229 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 260
fciphelp Description Use this command to display a listing of Fibre Channel over IP (FCIP) commands with short descriptions for each command. FCIP commands require an FCIP license. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 261
count FCIP FPGA GMAC and central ASIC FC loopback Specifies the number of frames to send. The test progresses until the specified number of frames are transmitted on each port. The default value is 100 (Brocade 7500/FR4-18i and Brocade 7800/FX8-24). Fabric OS Command Reference 231 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 262
data compression for the test (Brocade 7500/FR4-18i only). By default, data compression is used. This setting is applicable only to path To run the test on slot 2 with PHY loopback sending 10 frames: switch:admin> fcippathtest --slot 2 -path 2 -nframes 10 Running fcippathtest Test Complete Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 263
which is used for any LUN query from this switch. Examples To display the LUN information: switch:user> fclunquery Target Index: 1 Target Node WWN: 50:05:07:65:05:03:f9:39 Target Port WWN: 50:05:07:65:05:83:f9:39 Target Pid: 144e8 Number of LUNs returned by query: 1 LUN ID: 0x00 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 264
systems, followed by a slash (/). port Specifies the port number. There are 24 configurable embedded FCoE ports on the Brocade 8000 switch, and the valid range for port is 8 to 31. On the Brocade FCoE10-24 blade, there are 24 configurable FCoE ports numbered 0-23. Use switchShow for a list - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 265
FIP configurations. --resetlogin Clears the logins that occurred through a front end port or from a device specified by the Enode's VN_Port WWN. -teport slot/port Specifies the slot or port number. -device wwn Specifies the device WWN. Examples To Display the FCoE ports on the Brocade 8000 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 266
To display embedded FCoE port configurations on the Brocade 8000: switch:admin> fcoe --cfgshow UserPort Status Port WWN DeviceCount Port Type MAC VF_ID 8 ENABLED 20:08:00:05:1e:76:60:80 0 FCoE VF-Port 00:05:1e:76:60:80 128 9 ENABLED 20:09:00:05:1e:76:60:80 0 FCoE VF-Port 00:05:1e:76 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 267
:1e:7b:34:e0 Te 2/0 To display the configuration for FCoE port 2/0 on the Brocade FCoE10-24: switch:admin> fcoe --logincfg 2/0 Slot: 2, Port: 0, Status: Enabled, Port WWN: 20:40:00:05:1e:92:de:00, DeviceCount: 1, Type: VF-Port, MAC: 00:05:1e:7b:34:e0 VF_ID: 128, Fabric Name: 10:00:00:05:1e:35:bb:32 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 268
conflicting login groups and login groups for non-existing switches. --save Saves and applies FCoE login configuration changes as the effective configuration fabric-wide. --transshow Displays the current configuration transaction in progress fabric-wide.. --transabort Aborts the FCoE login - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 269
To disable the FCoE login configuration management on the switch: switch:admin> fcoelogincfg --disable switch:admin> fcoelogincfg --show Login management is disabled. Effective Configuration Login management is disabled. See Also fcoe, fcoeLoginGroup Fabric OS Command Reference 239 53-1001337 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 270
port port] fcoelogingroup --remove lgname wwn fcoelogingroup --rename lgname newlgname fcoelogingroup --help Description Use this command to create or modify the FCoE login management configuration fabric specified members are allowed to log into the switch. --delete lgname Deletes a login group. - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 271
of the login group are allowed to log into all FCoE ports. Removes VN_Port devices from the login group. Specifies the name switch:admin> fcoelogingroup --remove mylg "12:00:00:00:00:00:1e:34" To delete a login group: switch:admin>fcoelogingroup --delete mylg See Also fcoe, fcoeLoginCfg Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 272
. The ELS Echo request elicits an ELS Echo response from a port identifier in the fabric and is useful for validating link connectivity. The source and destination port identifiers can be specified as a 24-bit Fibre Channel port identifier, a port world wide name, or a node world wide name. The two - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 273
for diagnosing data-dependent problems in the fabric link. The pattern bytes are specified as hexadecimal characters. For example, --pattern ff fills the request frame with instances of the number does not respond to the request: switch:admin> fcping 0x020800 22:00:00: - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 274
this example, the destination is a switch WWN): switch:admin> fabricshow Switch ID Worldwide Name Enet IP Addr FC IP Addr Name 6: fffc06 10:00:00 switch:admin> nsshow { Type Pid COS PortName NodeName TTL(sec) N 370500; 3;20:07:00:05:1e:35:10:7f;10:00:00:05:1e:35:10:7f; na Fabric Port - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 275
fcPing 2 See Also switch:admin> fcping 20:00:00:00:c9:3f:7c:b8 Destination: 20:00:00:00:c9:3f:7c:b8 Pinging 20: bytes time:880 usec 5 frames sent, 5 frames received, 0 frames rejected, 0 frames timeout Round-trip min/avg/max = 713/774/880 usec ping Fabric OS Command Reference 245 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 276
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 Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 277
command). Synopsis fcplogdisable Description Use this command to disable the logging of debug information by the Fibre Channel Protocol daemon (FCPD). Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 278
(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 Virtual Fabric or Admin Domain restrictions that may be in place. Refer - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 279
Description Use this command to display the debug information logged at various stages during the Fibre Channel Protocol daemon (FCPD) device probing. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 280
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 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 281
enable the following two configuration parameters: • Disable Device Probing = Enabled 1 • Disable RLS Probing = Enabled 1 Device probing and RLS probing are disabled by default. Use the configure command to enable these parameters. Note The execution of this command is subject to Virtual Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 282
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. If no operands are specified, this command displays the usage. By default, frame - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 283
See Also To display the new configuration: switch:admin> fcrbcastconfig --show Broadcast configuration is enabled for FID: 2 128 bcastshow, portRouteShow fcrBcastConfig 2 Fabric OS Command Reference 253 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 284
Fabric OS commands" and Appendix A, "Command Availability" for details. This command is supported only on Brocade FR4-18i blades and Brocade 7500 platforms. Operands This command has the following operands: --slot slotnumber Specifies the slot number on which the diagnostic operates. The default - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 285
fcrChipTest 2 Examples To run all tests on slot 7 and FC Router FPGA 1: switch:admin> fcrchiptest --slot 7 -unit 1 -testtype 0 Running fcrchiptest Test Complete: fcrchiptest Pass BIST_TIMEOUT BIST_FAIL fcrPathTest, portLoopbackTest Fabric OS Command Reference 255 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 286
interactively prompts for the following parameter: Backbone Fabric ID A fabric ID uniquely identifies a fabric in FC Router configurations. The backbone fabric is the fabric attached to the U_Ports-for example, E/F_Ports-of this switch. The backbone fabric ID must be unique across all FC Router - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 287
output includes the following: FID Fabric ID of the EX_Port. EX-port EX_Port number of the switch. E_Port Port number for the remote E_Port. PWWN Neighbor switch port WWN. SWWN Neighbor switch WWN. The command output depends on the EX_Port configuration: • If the EX_Port is Online - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 288
2 fcrEdgeshow See Also To display a FID for which no EX_Ports are configured: switch:admin> fcredgeshow -fid 29 No EX-ports with FID 29 fcrPhyDevShow, fcrProxyDevShow, fcrRouteShow, lsanZoneShow, switchShow, fcrfabricshow 258 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 289
includes: EX_Port The port number for the EX_Port. An asterisk (*) at the end of the line indicates that the EX_Port is a Remote Router Port. FID The fabric ID of the EX_Port. Neighbor Switch Info (WWN, enet IP, name) The WWN, Ethernet IP address, and switch name of the switch attached to the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 290
FID Neighbor Switch Info (enet IP, WWN, name) 16 80 10.32.66.180 10:00:00:05:1e:34:e8:46 "b4100_7x_1" 180::10:32:66:180 27 80 10.32.69.180 10:00:00:05:1e:37:12:e0 "Sprint_180" See Also fcrPhyDevShow, fcrProxyDevShow, fcrRouteShow, lsanZoneShow, switchShow 260 Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 291
be disabled when you configure enforce tags. Speed tags can be configured while the switch is online. • You must change the LSAN name in the edge fabric or the backbone fabric and propagate the LSAN to the FCR. Note that enforce tags are not supported in the backbone fabric. • The speed tags must - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 292
the specified tag from the LSAN tag configuration. Displays the command usage. Accepts only the LSANs from the edge fabric that matches the specified tag string switch:admin> switchdisable switch:admin> fcrlsan --add -enforce brocade LSAN tag set successfully To add a speed tag named "mcdt": switch - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 293
maximum LSAN count for all the FCR switches in the same backbone that support this feature. Verify the configured maximum limit against the LSANs configured using the fcrResourceShow command. Notes The default LSAN count maximum of 3000 is the Fabric OS v5.2 default. It allows v5.2 to run on the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 294
practice is, therefore, to enter the same information for all the FCR switches in the backbone that support this command. This command is also used to specify FC Router pairs that can talk to each other. All edge fabrics connected to a defined pair of FCRs are allowed to import devices each other - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 295
fcr wwn wwn Removes the entry of the pair of FIDS. If no longer specified, the edge fabric assumes the default behavior. --apply -lsan | -fcr | -all Applies the information from the cache to the LSAN Zone matrix from the import/export setup. Fabric OS Command Reference 265 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 296
19 To view the LSAN Zone static and default/dynamic binding in the backbone where online fabrics are: 1, 2, 4, 5, 7, 8, 10: switch:admin > fcrlsanmatrix --fabricview -lsan LSAN MATRIX is activated Fabric ID 1 Fabric ID 2 4 5 4 7 10 19 Default LSAN Matrix: 1 2 8 To display all proxy - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 297
:29:31 78 10:32:16:90:29:dd:d0:07 78 10:32:16:91:24:dd:d0:05 78 10:32:16:91:25:dd:d0:03 82 10:00:00 and the default/dynamic fabric binding in the backbone: switch:admin > fcrlsanmatrix --fabricview -lsan LSAN MATRIX is activated Fabric ID 1 Fabric ID 2 52 78 52 82 78 82 Default LSAN - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 298
on all the FCR switches in the backbone. • In a dual backbone configuration, use fcrlsanmatrix --fabricview on the FCR switches to confirm that the shared edge fabric FIDs have the same access in both backbones. Refer to the Fabric OS Message Reference manual for further diagnostic information - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 299
number of frames transmitted is not equal to the number of frames received. 8. Repeat steps 2 through 7 for all ports present until one of the following conditions is met: a. The number 0xbc, 0xbc, 0x23, 0x47, ... RANDOM0x25, 0x7f, 0x6e, 0x9a, ... Fabric OS Command Reference 269 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 300
is supported only on Brocade FR4-18i blades and Brocade 7500 platforms. The switch must be offline for this test to run. Operands This command has the following operands: --slot slotnumber Specifies the slot number on which the diagnostic operates. The default is 0 and operates on fixed-port - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 301
SFP or indicate deeper problems in the main board or ASIC. Check for a faulty SFP. Replace the SFP if necessary. The specified port failed to transmit frames. This usually indicates an ASIC failure. Replace the blade or the switch. See Also fcrChipTest, portLoopbackTest Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 302
physical devices include physical devices that are configured to be exported from fabrics attached to this FC Router's EX_Ports. The physical devices are listed by fabric. The -f and -w operands allow searching for physical devices based on fabric ID or port world wide name. "No device found" is - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 303
fcrPhyDevShow 2 Examples See Also To display the physical devices relevant to this FC Router: fcr:admin> fcrphydevshow Device WWN Physical Exists PID in Fabric 2 10:00:00:00:c9:2b:6a:68 c70000 3 50:05:07:65:05:84:09:0e 0100ef 3 50:05:07:65:05:84:0b: - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 304
. If the configuration is altered, then care must be taken to ensure consistency across all FC Routers attached to the same edge fabric. If no operand is specified, the command displays the following information: importedFID The imported fabric ID of the proxy device. devWWN The port world wide - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 305
not exist in any proxy device slot." is displayed if the WWN does not exist in any slot for the specified edge fabric. Examples To display the persistent proxy device configuration: switch:admin> fcrproxyconfig Imported FID 002 002 002 002 003 Device WWN 50:05:07:65:05:84:08:d7 50:05 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 306
device appears to the fabric as a real Fibre Channel device. It has a name server entry and is assigned a valid port ID. Proxy device information is available only for proxy devices that are presented by FC Routers on the same backbone fabric as this FC Router. The default output displays only - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 307
that are relevant to this FC Router. Displays proxy devices with the specified port WWN. Examples To display the physical devices relevant to this FC Router: switch:admin> fcrphydevshow Device WWN Physical Exists PID in Fabric 2 10:00:00:00:c9:2b:6a:68 c70000 3 50:05:07:65:05:84 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 308
a translate domain slot. A slot is the port number and AL_PA combination. The slot-to-device WWN association is persistently stored. Phantom Node WWNs The maximum versus the currently allocated phantom switch node WWNs. The phantom switch requires node WWNs for fabric-shortest-path-first (FSPF) and - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 309
fcrResourceShow 2 Notes Only configured EX/VEX_Ports are displayed The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 310
link costs for all ports on the switch. Notes Before setting the cost, ensure that admin is enabled for the EX_Port/VEX_Port with portCfgEXPort or portCfgVEXPort. The cost can be set only on a disabled port. The bandwidth of an inter-fabric link (IFL) is unrelated to its default cost. In other - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 311
fcrrouterportcost 7/10 Port Cost 7/10 10000 To set the default cost on the EX_Port: See Also switch:admin> fcrrouterportcost 7/10 0 switch:admin> fcrrouterportcost 7/10 Port Cost 7/10 1000 switchShow, fcrRouteShow, portCfgEXPort fcrRouterPortCost 2 Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 312
EX_Port. NR_Port technology enables EX_Ports to exchange traffic across an intermediate fabric. NR_Ports are addressable entities on the backbone fabric and have port IDs relevant to the backbone fabric. Because cascaded backbone/intermediate fabrics are currently not supported, an NR_Port provides - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 313
translate domain ID is configured if no devices are imported or exported across the edge fabrics. Disabling the persistxd parameter prevents the translate domain from being created. Enabling the persistxd parameter from a disabled state re-enables the FCR default behavior. When executed without - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 314
display the translate domain configuration and the state of the persistxd parameter: switch:admin> fcrxlateconfig ImportedFid ExportedFid Domain 001 002 004 001 005 003 OwnerDid 000001 N/A XlateWWN N/A 50:00:51:e1:30:30:0f:05 Persist XD state: Enabled 284 Fabric OS Command Reference 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 315
:admin> fcrxlateconfig 2 3 8 xlate domain already configured, overwrite?(n) y To clear the preferred domain ID of the translate domain created in fabric 2, which represents remote fabric 3: switch:admin> fcrxlateconfig -r 2 3 xlate domain deleted To enable translate domain persistence: fcr:admin - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 316
the fabric-wide consistency policy. Switches can be locally configured to allow or reject a security policy. Supported policies are Switch Connection Control (SCC), Device Connection Control (DCC), Password (PWD), Fabric Configuration Server (FCS), Fabric Element Authentication (AUTH), and IP Filter - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 317
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). All members specified in a given policy - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 318
FDMI cache: switch:admin> fdmicacheshow Switch entry for domain 3 state: known version: v310 wwn: 10:00:00:60:69:90:03:c7 HBAs: 10:00:00:00:c9:25:9b:96 Ports: 1 10:00:00:00:c9:25:9b:96 Total count of devices on the switch is 1 See Also fdmiShow 288 Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 319
Supported Speed: 0x00000001 Port Speed: 0x00000001 Frame Size: 0x00000800 HBA attributes: Node Name: 20:00:00:00:c9:25:9b:96 Manufacturer: Emulex Network Systems Serial Number: 0000c9259b96 Model: LP9000 Model Description: Emulex LightPulse LP9000 1 Gigabit PCI Fibre Channel - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 320
To clear the RLIR database: switch:user> ficonclear RLIR successfully clear local RLIR Database. See Also To clear the RNID database: switch:user> ficonclear RNID successfully clear not current entries from local RNID Database. ficonHelp, ficonShow 290 Fabric OS Command Reference 53-1001337 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 321
timeout value is rounded down to the closest value divisible by 10. For example, an MIHPTO timeout value of 86 defaults to 80. Examples To enable FMS mode for the switch: switch:admin> ficoncupset fmsmode enable fmsmode for the switch is now Enabled Fabric OS Command Reference 291 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 322
bit in the mode register for the switch: switch:admin> ficoncupset modereg ASM 1 Active=Saved Mode bit is set to 1 See Also To set the MIHPTO value to 60 seconds: switch:admin> ficoncupset MIHPTO 60 MIHPTO has been changed to 60 seconds ficonCupShow 292 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 323
seconds. Examples To display the FMS mode for the switch: switch:user> ficoncupshow fmsmode fmsmode for the switch: Enabled To display the mode register for the switch: switch:user> ficoncupshow modereg POSC UAM ASM DCAM ACP HCP 1 0 1 1 1 0 Fabric OS Command Reference 293 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 324
2 ficonCupShow To display the ASM bit in the mode register for the switch: switch:user> ficoncupshow modereg ASM ASM --1 See Also To display the MIHPTO value for the CUP: switch:user> ficoncupshow MIHPTO MIHPTO for the CUP: 60 seconds ficoncupset 294 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 325
Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display a list of FICON commands: switch:admin> ficonhelp ficonclear Clears contents of the specified FICON management database - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 326
domain ID. Fabric WWN Displays the fabric WWN. Flag Indicates if the node is valid, not valid, or not current. Flag values are as follows: 0x00 Indicates the node ID of the storage port for RNID switch for SwitchRNID is valid. 0x10 Indicates the node ID of the channel port is valid. 0x20 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 327
port state Listener PID Same as PID. Listener Port Type Same as Port Type. Listener Port WWN Displays the channel HBA port . Byte BB 0x0a Switch. Byte CC 0x00 Port number. It is dynamically support not specified. 0xa0 Reserved. 0xc0 Reserved. Fabric OS Command Reference 297 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 328
registered with the switch. 0xID CHIPID if channel port has registered with the switch. 0xPN If switch has registered with the channel, PN represents the FL port number. Part Number Displays the switch chassis part number. PID Displays the 24-bit Fibre Channel port address in 0xDDAAPP format - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 329
channel or storage CU port world wide name associated with the device HBA. Sequence Number Displays the sequence number of the self-describing node. Serial Number Displays the switch serial number. Switch node WWN Displays the switch node world wide name. Switch Port fabric ILIR Specify fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 330
Number: 0000000169CA tag: 052e } } To display the local and remote LIRR database: switch:admin> ficonshow LIRR fabric {Fmt Type PID Listener Port WWN Switch Port WWN Listener Type 0x18 N 502b00 50:05:07:64:01:00:15:8d 20:2b:00:60:69:80:1e:4e Conditional 0x18 N 502e00 50:05:07:64:01:40 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 331
: switch:user> ficonshow ILIR { {FRU Failure [2]: Power Supply[2] failure occurred on Mon Jan 13 12:11:38 2003 Fmt Protocol Domain Fabric WWN Switch WWN 0x18 FICON 80 10:00:00:60:69:33:33:33 10:00:00:60:69:80:1e:4e FRU part number: FRU serial number: 23000000602 FL2L0001071 {Listener Port - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 332
modified through configDownload. FIPS is not supported on all platforms. For FIPS-compliant hardware, refer to the Fabric OS Administrator's Guide. In a Virtual Fabric environment, FIPS is treated as chassis-wide configuration and applies to all logical switches in the chassis. Chassis permissions - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 333
in permit state. HTTP port number for the policy is in permit state. RPC port number for the policy is in permit state. SNMP is not in read only mode. Bootprom access is enabled. FIPS mode cannot be configured at this time Fabric OS Command Reference 303 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 334
2 fipsCfg See Also To enable FIPS after prerequisites have been met: switch:admin> fipscfg --enable fips FIPS mode has been set to : Enabled Please reboot the system switch:admin> fipscfg --show FIPS mode is : Enabled none 304 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 335
switches the primary partition (with the old firmware) to the secondary, and the secondary partition (with the new firmware) to the primary. The default Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To commit a new version of the firmware: switch: - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 336
BP firmware is downloaded to the BP processors if there is a mismatch between the BP and CP firmware. By default, firmwareDownload performs a full install, auto reboot, and auto commit. These modes are selectable only in single CP (-s) mode, in which case auto reboot is OFF by default. 306 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 337
single-CP mode. This mode supports selectively enabling or disabling a full install, auto reboot, and auto commit on bladed and non-bladed systems. On enterprise-class platforms, this mode supports upgrading a single CP. When downloading the main Fabric OS firmware, this option disables auto - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 338
this option may cause traffic disruption for some switches in the fabric. Examples To download the firmware to an HA switch over a network: switch:admin> firmwaredownload 192.168.166.30,johndoe,/pub/dist/release.plist,12345 The following BP blades are installed in the system. Slot Name Versions - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 339
) [FOS]:SAS Target Slots (all, or slot numbers) [all]: Server Name or IP Address: 192.168.32.10 Network Protocol (1-auto-select, 2-FTP, 3-SCP) [1]: User Name: userfoo File Name: /home/userfoo/dist/release.plist Password: To download SAS firmware without version compatibility checking: Note that in - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 340
reachable from the switch. • The user does not have permission on host. • The password is not specified correctly. • Indicated firmware does not exist on the host, or is not in the right format, or is corrupted. • The FTP or SSH service is not running on host. • The platform is not supported by the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 341
is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and the blades in slot 2 and 7. switch:admin> firmwaredownloadstatus [1]: Thu Jul 28 00:30:49 2007 Slot 2 (SAS): Firmware is being downloaded to the blade. It may take - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 342
command has completed successfully. Use firmwareshow to verify the firmware versions. To display the status of a firmware download on a chassis: switch:admin> firmwaredownloadstatus [1]: Mon Dec 19 18:40:19 2007 Slot 6 (CP1, active): Firmware is being downloaded to standby CP. This step may take up - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 343
. [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 firmwareshow to verify the firmware versions. firmwareCommit, firmwareDownload, firmwareRestore, firmwareShow Fabric OS Command Reference 313 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 344
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. Signed Firmware Download must be enabled before the public key can be used for signature validation. Use the configure command to - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 345
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. Signed Firmware Download must be enabled before the public key can be used for signature Use the configure command to enable Signed Firmware - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 346
updated. To update the public key using the interactive method: switch:admin> firmwarekeyupdate Server Name or IP Address: 192.168.21.34 User Name: johndoe File Name: /pub/dist/pubkey.pem Network Protocol(1-auto-select, 2-FTP, 3-SCP) [1]: Password: Updating the public key, please wait... Public key - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 347
), the downloaded firmware becomes active. If you then do not want to commit the firmware and want to restore the former firmware, run Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To restore the former active firmware image: switch:admin> - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 348
in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the firmware versions in a Brocade director with FA4-18 blades installed in slot 2 and 7: switch:admin> firmwareshow Slot Name Appl Primary/Secondary - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 349
again. "FC Routing service is already enabled." This means that the FC Routing service is already enabled. iSCSI Enables the iSCSI service on the switch. By default, iSCSI is disabled. iSNSC Enables the iSNSC service on the switch. By default, iSNSC is disabled. Fabric OS Command Reference 319 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 350
be disabled before enabling Virtual Fabrics. This command prompts for confirmation, because the chassis reboots after this command is executed. Enables the Ethernet switch service on the switch. The Ethernet switch service is disabled by default. Enabling the Ethernet switch service does not disrupt - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 351
--enable iscsi iSCSI service is enabled To disable the iSCSI service: switch:admin> fosconfig --disable iscsi iSCSI service is disabled To enable Virtual Fabrics: switch:admin> fosconfig --enable vf WARNING: This is a disruptive operation that requires a reboot to take effect. All EX ports will - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 352
, or CP failover, please follow the recovery procedure in Core Switch WWN Card Removal and Replacement document. Do you wish to continue [y/n]? y Backing up WWN card data, please wait about 25 seconds for further instruction. Please install the new FRU now. If this session lost for any reason - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 353
FSPF protocol. Domain number of local switch. State of the local switch. TRUE if the domain of the local switch is currently confirmed. Bit map of all the ISL. Bit positions correspond to the default areas of the ports. Bit 0 refers to default area of the switch, bit 1 refers to default area 1, and - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 354
2 fspfShow Examples See Also To display FSPF protocol information: switch:admin> fspfshow version = 2 domainID = 131 switchOnline = TRUE 5000 lsrDelayCount = 1 ddb_sem = 0x1003e6e8 fabP: event_sch = 0x0 bcastShow, topologyShow, uRouteShow 324 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 355
has the following operand: mode Specify 1 to enable the alarms, 0 to disable the alarms. If no operand is specified, the default value is 0 (alarms deactivated). This operand is optional. Examples To enable alarms in Fabric Watch: switch:admin> fwalarmsfilterset FW: Alarms are already disabled - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 356
Availability" for details. Operands none Examples To display the status of alarm filtering in Fabric Watch: switch:user> fwalarmsfiltershow FW: Alarms are enabled switch:user> fwalarmsfiltershow FW: Alarms are disabled See Also fwAlarmsFilterSet 326 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 357
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. Notes This command requires a Fabric Watch license. The execution of this command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 358
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 reload the saved Fabric Watch configuration: switch:admin> fwconfigreload fwConfigReload: Fabric Watch configuration reloaded See - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 359
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 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 360
QL Fabric logins SFP state changes Link loss (E_Port) Sync loss (E_Port) Signal loss (E_Port) Protocol error (E_Port) Invalid words (E_Port) Invalid CRCS E_Port) RX Performance (E_Port) TX Performance (E_Port) State Changes (E/VE_Port) Utilization (VE_Port) Packet Loss (VE_Port) Same as Port class - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 361
Fabric reconfigure Domain ID changes Segmentation changes Zone changes FabricQL Fabric logins SFP state changes Same as Port class Same as Port Fabric OS commands" and Appendix A, "Command Availability" for details. Not all platforms support fans or power supplies. If you attempt to configure - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 362
the following optional operands: --enable --port portNumber Enables all thresholds associated with a certain port. --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 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 363
C In_Range 2 envTemp002 enabled 24 C inBetween Sat Oct 7 10:01:53 2006 21 C In_Range 1 : refresh 2 : disable a threshold 3 : enable a threshold 4 : advanced configuration 5 : return to previous page Select choice => : (1..5) [5] 5 fwClassInit, fwConfigReload, fwShow Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 364
2 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 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 365
Fabric Watch Configure FRU state and notification Print Fabric Watch help info Configure Fabric Watch Email Alert Create a report with detailed port information Show availability monitor information Set port persistence time Set boundary & alarm level to custom Set boundary & alarm level to default - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 366
Alert 3 : Enable Email Alert 4 : Send Test Mail 5 : Set Recipient Mail Address for Email Alert 6 : Relay Host IP Configuration 7 : Quit Select an item => : (1..7) [7]1 Config Show Menu 1 : Environment class 2 : SFP class 3 : Port class 4 : Fabric class 5 : E-Port class 6 : F/FL Port (Optical - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 367
Email Alert 3 : Enable Email Alert 4 : Send Test Mail 5 : Set Recipient Mail Address for Email Alert 6 : Relay Host IP Configuration 7 : Quit Select an item => : (1..7) [7]5 See Also Mail Config Menu 1 : Environment class 2 : SFP class 3 : Port class 4 : Fabric class 5 : E-Port class 6 : F/FL - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 368
factors also are listed. Notes This command requires a Fabric Watch license. Port errors are not supported for virtual ports and SFP errors are not applicable for virtual ports. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 369
002:53 005 U OFFLINE 080:24 006 U OFFLINE 080:24 007 U OFFLINE 080:24 To retrieve a port detailed report for a switch configured with an IPv4 address: switch:user> fwportdetailshow Port Detail Report Switch Name: switch IP address: 10.202.78.24 Port Exception report [by All] Report - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 370
See Also To retrieve a port detailed report: switch:user> fwportdetailshow --s h Port Detail Report Switch Name: switch IP address: 192.168.163.237 Port Exception report [by Healthy] Report time: 05/21/2007 11:22:58 PM --------Port-Errors SFP-Errors---- Port# Type State Dur(H:M) LFA - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 371
" and Appendix A, "Command Availability" for details. This command requires a Fabric Watch license. Operands none Examples To generate a SAM report on an eighty-port switch: switch:user> fwsamshow Total Total Down Total Port Type Up Time Down Time Occurrence Offline Time (Percent) (Percent - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 372
0 0 0 100 37 U 0 0 0 100 38 U 0 0 0 100 39 U 0 0 0 100 40 T 99 0 0 0 41 T 99 0 0 0 42 T 100 0 0 0 43 T 99 0 0 100 77 U 0 0 0 100 78 U 0 0 0 100 79 U 0 0 0 100 See Also portShow, switchShow 342 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 373
Specifies the time, in seconds, during which a port must be persistently in a marginal state before being recognized as such. Examples To set the port persistence time to 18 seconds: switch:user> fwset --port --persistence 18 See Also fwShow Fabric OS Command Reference 343 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 374
. Fabric Watch uses two types of settings: factory default settings and user-defined custom settings. • Factory default settings are automatically enabled. These settings vary depending on hardware platform, and cannot be modified. • For some settings, you can create custom threshold configurations - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 375
a threshold 3 : enable a threshold 4 : advanced configuration 5 : return to Custom Unit Time base Low High BufSize Default C 0 60 base 15 : change inBetween alarm 6 : change custom low 16 : apply threshold alarm changes 7 : change custom high 17 : cancel threshold alarm changes Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 376
2 fwSetToCustom See Also 8 : change custom buffer 18 : return to previous page 9 : apply threshold boundary changes 10 : cancel threshold boundary changes Select choice => : (1..18) [18] fwSetToDefault, fwConfigure, fwHelp, fwShow 346 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 377
. Fabric Watch uses two types of settings: factory default settings and user-defined custom settings. • Factory default settings are automatically enabled. These settings vary depending on hardware platform and cannot be modified. • For some settings, you can create custom threshold configurations - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 378
4 : advanced configuration 5 : return to previous page Select choice => : (1..5) [5] 4 Index ThresholdName 1 envTemp001 4 envTemp004 5 envTemp005 6 envTemp006 BehaviorType Triggered Triggered Triggered Triggered BehaviorInt 1 1 1 1 Threshold boundary level is set at : Default Unit Time base Low - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 379
fwSetToDefault 2 See Also 8 : change custom buffer 18 : return to previous page 9 : apply threshold boundary changes 10 : cancel threshold boundary changes Select choice => : (1..18) [18] fwSetToCustom, fwConfigure, fwHelp, fwShow Fabric OS Command Reference 349 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 380
, refer to the help page for fwConfigure or consult the Fabric Watch Administrator's Guide. In Access Gateway mode, only the following class thresholds are supported. F/FL Port (Copper) class threshold is supported only on Embedded platforms. TABLE 16 Access Gateway mode classes Class Environmental - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 381
Fan 1 2576 RPM envFan002 Env Fan 2 2518 RPM envFan003 Env Fan 3 2481 RPM switch:user> fwshow 1 : Show class thresholds 2 : Detail threshold information 3 : Show port persistence time 4 : Quit Select an item => : (1..4) [3] 2 Enter Threshold Name : [] envFan001 Env Temperature 1: Monitored - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 382
port persistence time: switch:admin> fwshow --port --persistence FW: current port persistence time = 18s To display ports that have all thresholds disabled: switch:user> fwShow --disable --port Port Threshold Status 1 disabled fwClassInit, fwConfigReload, fwConfigure, fwSet 352 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 383
commands typed into the shell; the oldest commands are replaced as new ones are entered. Operands none Examples To display previous shell commands: switch:admin> h 1 version 2 switchshow 3 portdisable 2 4 portenable 2 5 switchshow See Also none Fabric OS Command Reference 353 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 384
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 Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 385
this time, active CP reboots and the failover is disruptive. • IP and Fibre Channel addresses configured for the switch. • Additional internal HA state information, subject to change. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 386
2 haDump See Also SWITCH Ethernet IP Address: 10.32.227.64 Ethernet Subnetmask: 255.255.240.0 Fibre Channel IP Address: 220.220.220.64 Fibre Channel Subnetmask: 255.255.240.0 CP0 Ethernet IP Address: 10.32.227.66 Ethernet Subnetmask: 255.255.240.0 Host Name: cp0 Gateway IP Address: 10.32.224.1 CP1 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 387
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To enable the High Availability feature: switch:admin> haenable Warning: This command will enable the HA. It will reboot the standby CP and require all - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 388
(HA) synchronization is enabled and the CPs are in sync, the port traffic light does not flash during the failover, even while traffic is continuing to flow. This command is supported only on dual-CP systems. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 389
number and CP ID), warm or cold, recovering or recovered. • Remote CP state (slot number and CP ID). • High Availability (enabled problem a configuration file error be supported on non-bladed systems. Slot numbers for Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, " - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 390
on a Brocade DCX with a healthy standby CP: switch:admin> hashow Local CP (Slot 7, CP1) : Active, Cold Recovered Remote CP (Slot 6, CP0) : Standby, Healthy HA Enabled, Heartbeat Up, HA State Synchronized See Also haDisable, haEnable, haFailover 360 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 391
restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Examples To enable the HA state synchronization: switch:admin> hasyncstart See Also haFailover, haShow, haSyncStop Fabric OS Command Reference 361 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 392
be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To disable the HA state synchronizing process: switch:admin> hasyncstop See Also haFailover, haShow, haSyncStart 362 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 393
aliremove alishow aptpolicy auditcfg Configure RADIUS for AAA services Specifies all administration domain (AD)-level operations Configure the Access Gateway feature Displays the Access Gateway information registered with the fabric Reset SNMP agent to factory default Add a member to a zone - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 394
backport bannerset bannershow bcastshow Configure RADIUS for AAA services Specifies all administration domain (AD)-level operations Configure the Access Gateway feature Displays the Access Gateway information registered with the fabric Reset SNMP agent to factory default Add a member to a zone - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 395
name (WWN) cards. The type of FRU supported depends on the hardware platform. Each history record switch:admin> historylastshow POWER SUPPLY Unit 2 Inserted at Tue Aug 14 15:52:10 2001 Factory Part Number: 60-0001536-02 Factory Serial Number: 1013456800 Records: 11 See Also historyShow Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 396
buffer, which records the insertion and removal of FRUs on a switch or chassis. This command supports two modes of handling new log entries once the history buffer is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 397
of FRU supported depends on Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the history log of FRUs and removal events on a standalone switch: switch:admin> historyshow FAN Unit 3 Removed at Tue Aug 14 10:05:37 1970 Factory Part Number - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 398
Aug 14 13:59:50 2001 Factory Part Number: 60-0001604-02 Factory Serial Number: FP00X600128 POWER SUPPLY Unit 2 Inserted at Tue Aug 14 15:52:10 2001 Factory Part Number: 60-0001536-02 Factory Serial Number: 1013456800 Records: 11 historyLastShow 368 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 399
may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the Java plug-in version: switch:admin> httpcfgshow Current HTTP configuration javaplugin.version = 1,5,0,6 javaplugin.homeURL = http://java.sun - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 400
process or about all processes running on the local switch. One line is displayed per process. Fields displayed or stopped Z a defunct ("zombie") process The effective user ID number of the process The process ID of the process The to Virtual Fabric or Admin Domain restrictions that may be in place. - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 401
the following operand: processID Specifies the process name or process ID for the process to display. Examples To display information about process ID 433: switch:admin> i 433 F S UID PID PPID C PRI NI ADDR SZ WCHAN TTY TIME CMD 000 S 0 433 1 0 69 0 - 1283 5c64 ? 00:00:02 fabricd See Also - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 402
usage. Examples To disable the ICL for ports 16-31: switch:user> iclcfg --disable 8/1 To enable the ICL for ports 16-31: switch:user> iclcfg --enable 8/1 To disable the ICL for ports 16-31 persistently: switch:user> iclcfg --persistentdisable 8/1 372 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 403
See also To enable the ICL for ports 16-31 persistently: switch:user> iclcfg --persistentdnable 8/1 none iclCfg 2 Fabric OS Command Reference 373 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 404
subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" supported. Examples To advertise all modes of operation, when not entering this command through the serial console port, follow this scenario for the ifModeSet command: switch - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 405
[yes] y Committing configuration...done. To force the link for the eth0 interface from auto-negotiation to 10 Mbps half-duplex operation, when entering this command through the serial console port: switch:admin> ifmodeset eth0 Auto-negotiate (yes, y, no, n): [yes] n Force 100 Mbps / Full Duplex (yes - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 406
-HD, link ok MAC Address: 00:60:69:D0:24:40 To display the link operating mode for the eth3 Ethernet interface (in this example, the management port is disconnected): switch:admin> ifmodeshow eth3 Link mode: no link MAC Address: 00:05:1E:40:62:30 376 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 407
See Also To display the active interface: ras010:root> ifmodeshow bond0 Currently Active Slave: eth0 ifModeSet ifModeShow 2 Fabric OS Command Reference 377 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 408
idbP Pointer to IDB. nghbP Pointer to neighbor data structure. ifNo Interface number. masterPort Port number of the trunk master port, if present, of the trunk group of which this port is a part. defaultCost Default cost of sending a frame over the interswitch link (ISL) connection to this - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 409
of LSUs received from the neighbor switch. nLsaIn Number of LSAs received from the neighbor switch. attHloOut Number of attempted transmissions of Hello frames to the neighbor switch. nHloOut Number of Hello frames transmitted to the neighbor switch. Fabric OS Command Reference 379 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 410
of LSUs to the neighbor switch. Number of LSUs transmitted to the neighbor switch. Number of attempted transmissions of LSAs to the neighbor switch. Number of LSAs transmitted to the neighbor switch. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 411
= 2000 rXmitTo = 5000 nCmdAcc = 7 nInvCmd = 0 nHloIn = 2 nInvHlo = 0 nLsuIn = 2 nLsaIn = 3 attHloOut = 2 nHloOut = 2 attLsuOut = 3 nLsuOut = 3 attLsaOut = 2 nLsaOut = 2 nbrStateShow, portShow, switchShow interfaceShow 2 Fabric OS Command Reference 381 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 412
full range of domain IDs, 1-239, is available. This mode is supported only in IM3. The Mi10K is the only M-Series switch that supports the 239 Domain ID mode. To enable 239 domain ID mode, specify a domain ID offset of 0xFF. Refer to the Fabric OS Administrator's Guide for domain ID configuration - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 413
interop mode. This command effectively returns the switch to Brocade Native mode (IM0). --enable Enables and configures the specified interop mode settings. The following operands are supported with this option: -mcdata | -IM2 | -im2 Enables McDATA Fabric mode (IM2). All three operands are - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 414
want to continue? (yes, y, no, n): [no] y InteropMode: Off To enable McDATA Open Fabric mode (IM3) and to set the domain offset to 0x80. switch:admin> interopmode --enable -im3 -domainoffset 0x80 The switch effective and defined configuration will be lost if interop Mode is changed. Interop Mode or - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 415
ID mode in IM3 to IM 2 (this command fails unless you change the domain offset as well to a value supported in IM2): switch:admin> interopmode --enable -mcdata The switch effective and defined configuration will be lost if interop Mode is changed. Interop Mode or Domain Offset Will Be Changed and - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 416
the user-defined IOD delay settings to default values (-1). This command resets IOD delay values for a specified domain ID that was previously configured with the iodDelaySet command. The switch must be disabled before IOD delay can be reset. Notes The iodDelaySet command is deprecated in Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 417
values. Note The iodDelaySet command is deprecated in Fabric OS v6.2.0. The iodDelayReset command is retained for legacy reasons only. If you have configured IOD delay settings previously, you must reset the IOD settings to defaults before upgrading to v6.2.0. Use iodDelayShow to determine - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 418
in-order delivery enforcement on the local switch. IOD is disabled by default, and can only be disabled after it has been enabled with the iodSet command. This command disables the legacy IOD enforcement only. Disabling IOD allows faster re-routing after a fabric topology change, but it may cause - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 419
legacy IOD implementation. Lossless DLS is supported only in FICON environments, and the switch must be configured with a port-based policy. Refer to aptPolicy help for more information. Lossless DLS is not supported on extended interswitch links (ISLs). Fabric OS Command Reference 389 53-1001337 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 420
Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operands: --enable -lossLessDls Enables To enable IOD with lossless DLS on a switch, on which IOD is not set: switch:admin> iodset --show IOD is not set switch:admin> iodset --enable - - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 421
the in-order delivery (IOD) setting. Synopsis iodshow Description Use this command to display the IOD setting on the switch. By default, IOD is disabled. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 422
processor (AP). On platforms that support Logical Fabrics, this command configures the IPv4 Fibre Channel addresses for the logical fabric IPFC network interface. The IPFC (IP over Fibre Channel) protocol allows switches to send IP traffic over Fibre Channel rather than through Ethernet connections - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 423
and -noauto options to enable or disable stateless IPv6 auto configuration. • Use the -ls option with appropriate arguments to set or delete the IPv4 Fibre Channel address and prefix for the IPFC interface of a logical switch. In a Virtual Fabric environment, each logical fabric is represented by - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 424
is enabled, the host automatically performs configuration of IPv6 addresses and periodic non-disruptive re-configuration. By default, auto configuration is disabled. -ls FID Specifies the logical fabric ID for which to configure an IPFC network interface. The FID is a decimal number. A switch that - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 425
address on an AP7600 with a hidden BP: switch:admin>ipaddrset -eth0 --add 10.12.34.123/24 To configure an IPv4 FC address for the IPFC interface associated with a logical switch with fabric ID 123: switch:admin>ipaddrset -ls 123 --add 11.1.2.4/24 IP address is being changed...Done. To verify the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 426
[255.255.255.0]: Committing configuration...Done. To enable DHCP on a standalone, non-AP platform: switch:admin> ipaddrset Ethernet IP Address [192.168.74.102]: Ethernet Subnetmask [255.255.255.0]: Gateway IP Address [192.168.74.1]: DHCP [Off]: on ipAddrShow 396 Fabric OS Command Reference 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 427
• Ethernet Subnet mask • Host Name • Gateway IP Address If the IPFC network interface is configured for logical switches: • IPFC address for Virtual Fabric ID For each CP: - Backplane IP address - IPv6 Auto configuration Enabled: Yes or No If enabled, the command displays: • All local IPv6 Addresses - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 428
the -slot option. Examples To display the IP addresses on a standalone switch: switch:admin> ipaddrshow SWITCH Ethernet IP Address: 192.168.163.238 Ethernet Subnetmask: 255.255.255.0 Gateway IP Address: 192.168.163.1 DHCP: Off IPv6 Autoconfiguration Enabled: No Local IPv6 Addresses: static 1080 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 429
:69bc:63:205:1eff:fe39:e45a/64 preferred IPv6 Gateways: To display only the IP addresses for CP 1: switch:admin> ipaddrshow CP1 Ethernet IP Address: 10.33.60.87 Ethernet Subnetmask: 255.255.240.0 Host Name: cp1 Gateway IP Address: 10.33.48.1 ipAddrSet Fabric OS Command Reference 399 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 430
and Appendix A, "Command Availability" for details. In a Virtual Fabric environment, IP Filter policies are treated as chassis-wide configurations and apply to all logical switches in the chassis. Chassis permissions are required to manage IP Filter policies. This command has the following operands - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 431
policy, the policy existing in the defined configuration becomes active. The policy to be activated replaces the existing active policy of the same type. Activating the default IP filter policies returns the IP management interface to its default state. An IP filter policy without any rule cannot be - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 432
policies: switch:admin> ipfilter --show Name: default_ipv4, Type: ipv4, State: active Rule Source IP Protocol Dest Port Action 1 any tcp 22 permit 2 any tcp 23 permit 3 any tcp 897 permit 4 any tcp 898 permit 5 any tcp 111 permit 6 any tcp 80 permit 7 any tcp - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 433
activated policy: switch:admin> ipfilter --show Name: default_ipv4, Type: ipv4, State: active Rule Source IP Protocol Dest Port Action 1 any tcp 22 permit 2 any tcp 23 permit 3 any tcp 897 permit 4 any tcp 898 permit 5 any tcp 111 permit 6 any tcp 80 permit 7 any - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 434
the new policy: switch:admin> ipfilter --show Name: default_ipv4, Type: ipv4, State: active Rule Source IP Protocol Dest Port Action 1 any tcp 22 permit 2 any tcp 23 permit 3 any tcp 897 permit 4 any tcp 898 permit 5 any tcp 111 permit 6 any tcp 80 permit 7 any - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 435
the algorithm selected. Refer to the Fabric OS Administrator's Guide for more information. The following IPsec configuration tasks can be performed with this command: • Enable or disable the IPSec policies. • Configure IP address for both IPv4 and IPv6 format. • Configure three types of policies and - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 436
must be enabled before you can configure the policies and parameters. The following operand is optional: default Clears the existing policies (automatic key management and manual keyed entries) and resets the configuration databases to default values. --disable Disables IPsec on the switch. All - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 437
. The main components of an IPsec policy are: IP packet filter/selector (IP address, protocol, and port information) and transform set. A subtype is required when configuring an IPsec policy. The subtype specifies the components to be configured. The following are required subtypes for the IPsec - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 438
, a local source IP address must also be defined. sa-proposal Defines the security associations (SA) proposal, including name, SAs to be included and lifetime of the proposal. The following operands are supported: -tag name Specifies a name for the SA proposal. This is a user-generated name. The - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 439
, data integrity and data source authentication of IP packets, and protection against replay attacks. Authentication number Specifies the security parameter index (SPI) for the SA. This is a user-defined index. Valid SPI numbers consist of numeric characters (0-9). This operand is optional. Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 440
using digital signature standard. -dh number rsasig Authenticate using an RSA signature. Specifies the DH group number as one of the following: 1 Specifies DH group modp768. 2 Specifies DH group modp1024. 14 Specifies DH group modp2048. 410 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 441
keys expire after the specified number of bytes have been transmitted. -pfs on|off Enables or disables Perfect Forward Secrecy (PFS). PFS is disabled by default. When PFS is disabled, IKE specified all existing protocols are selected for protection. Fabric OS Command Reference 411 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 442
integrity and data source authentication of IP packets, and protection against replay attacks user-generated key based on the length of the key. Use the LINUX random key generator or any other comparable third party utility to generate the manual SA keys. Refer to the Fabric OS Administrator's Guide - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 443
the configuration database. Flushing any other policy parameters is not supported. --show type policy ips Displays current IPsec or IKE configuration. The configuration. A policy subtype must be specified when displaying the IPsec policy configuration. Valid subtypes include the following: Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 444
between two systems using protection with MD5 and Manually keyed SAs. 5. "IPsec display commands" - Verify your IPsec configurations. 6. "Using the help command" - Use the help command with arguments to get syntax information on specific parameters. 414 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 445
traffic flow using ipsecConfig --show manual-sa -a. Refer to the "IPsec display commands" section for an example. 10. Perform the equivalent steps on the remote peer to complete the IPsec configuration. Refer to your server administration guide for instructions. Example 2 Secure traffic between two - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 446
peer to complete the IPsec configuration. Refer to your server administration guide for instructions. Example 3 Secure traffic between two systems using AH with SHA1 and ESP protection with 3DES and configure IKE with pre-shared keys. The two systems are a switch, BROCADE300 (IP address 10.33.74.13 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 447
ESP01 bundle. switch:admin> ipsecconfig --add policy ips sa-proposal manual-sa -a. Refer to the "IPsec display commands" section for an example. 5. Perform the equivalent steps on the remote peer to complete the IPsec configuration. Refer to your server administration guide for instructions. Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 448
switch:admin> ipsecconfig --show manual- switch:admin> ipsecconfig --show policy ips sa-proposal -a ipsec-esp-a-b SA(s) used:sa-esp-1 sa-ah-1 lifetime in seconds:infinite lifetime in bytes:infinite ipsec-esp-def SA(s) used:sa-esp-1 lifetime in seconds:infinite lifetime in bytes:infinite 418 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 449
selectors: switch:admin> ipsecconfig --show policy ips selector -a number ENCRYPTION ALGORITHM 3des_cbc, aes128_cbc, aes256_cbc, null_enc HASH ALGORITHM hmac_md5, hmac_sha1, aes_xcbc PRF ALGORITHM hmac_md5, hmac_sha1, aes_xcbc DH-GROUP modp768(1), modp1024(2), modp2048(14), modp8192(18) Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 450
Dec 2005). [4302] Kent, S., "IP Authentication Header", RFC4302 (Dec 2005). [4303] Kent, S., "IP Encapsulating Security Payload (ESP)", RFC4303 (Dec 2005). [4306] Kaufman, C., Ed., "The Internet Key Exchange (IKEv2) Protocol", RFC 4306 (Dec 2005). See Also none 420 Fabric OS Command Reference 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 451
iscsiCfg Synopsis Configures or displays iSCSI entities. iscsicfg create auth -u username -s CHAP_secret [-h] iscsicfg --modify auth -u username --enable ddset -n ddset_name [-h] iscsicfg --disable ddset [-n ddset_name] [-h] iscsicfg --show ddset [-n ddset_name] [-v] [-h] iscsicfg --show fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 452
-enabled switches and blades in the fabric. Changes do not take effect until a --commit all command is issued. Make all necessary configuration changes by the port WWN. --easycreate tgt -s [-h] Shows the Node and Port WWNs which is used for any easycreate operation from this switch. --create tgt - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 453
based on the login frame from the host. --addusername tgt -t target_name -u user_list [-h] Binds user user names defined in AUTH database from the specific target --clear tgt [-h] Clears the iSCSI target database from the fabric are not a part of the IQN format is supported. Multiple entities - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 454
. ddset_name is optional. fabric iSCSI-enabled switches and their operational states. The action is --show. --show fabric[-h] Displays the database iSNS client status of all iSCSI switches in the fabric. An asterisk (*) next to the switch ID denotes the local switch. initiator iSCSI Initiator - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 455
iscsiCfg 2 --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 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 456
. To unbind user CHAP from a target: switch:admin> iscsicfg 80:00:43:80:a2 Number of LUN Maps: 5 FC WWN Virtual LUN(s) Physical LUN(s) 50:06:0e:80:00:43:80:a2 0 0x0000000000000000 50:06:0e:80:00:43:80:a2 1 0x0001000000000000 50:06:0e:80:00:43:80:a2 2 0x0002000000000000 50:06:0e:80:00:43:80 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 457
myddset -d mynewdd The operation completed successfully. To display the iSCSI-aware switches and their operational states (Displays switches that are capable of propagating iSCSI data base): switch:admin> iscsicfg --show fabric Switch ID Switch WWN Switch State iSNSC * 1 10:00:00:60:69:e4:20:1e - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 458
See Also To display the iSCSI initiators that attempted to log in: switch:admin> iscsicfg --show initiator Number of records found: 1 Name iqn.1991-05.com.brocade:initiator1 IP Address 172.16.14.101 switch:admin> iscsicfg --show initiator -i iqn.1991-05.com.brocade:initiator1 Initiator details - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 459
to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operands: --slot slotnumber Specifies the slot number for which to run the diagnostics. The default is set to 0 and designed to operate on fixed-port-count products - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 460
. Manage/display iscsi switch configuration parameters. Create/Delete a new ip interface/route/arp entry on the GigE port Show configured ip interfaces/routes/arp entries on the GigE Port Display the number of sessions on each iSCSI port See Also switchShow 430 Fabric OS Command Reference 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 461
This command is supported only on the Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operands: --slot slotnumber Specifies the slot number on which to run the diagnostics. The default is set to 0 and designed to operate on fixed-port - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 462
1 to enable. Enables or disables immediate data support; specify 0 to disable or 1 to enable. Specifies the first burst length value; values include 512, 1024, 2048, 4096, 8192, 16384, and 32768. --clearstats Clears port-level iSCSI statistics on the specified port. --default Resets the port to - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 463
, which displays the initiator IP, TSID, and the number of connections in addition to the other port-level information. Specifies the slot number. This parameter only supports FC4-16IP blades in Brocade 48000 directors. Specifies the port number of a GbE port to be configured in the specified slot - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 464
Session details: Session Number: iSCSI Session Type: Initiator Name: Target Name: ISID: fosConfig, iscsiCfg, iscsiSessionCfg 0 0 0 0 0 0 17 2576 17 1352 1 Normal iqn.1991-05.com.microsoft:win-iscsi.lab iqn.2002-12.com.tgt:21:00:00:04:cf:5d:cf:0e 0x400001370000 434 Fabric OS Command Reference 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 465
Port Leading Connection Switch Port 1 2743 Yes 8/ge4 Security Details CHAP Username: none FC Details Number of FC targets: 1 FC Target Information Index FC WWN 1 2f:df:00:06:2b:0d:10:b9 iSCSI Operating Login Parameters: Session Level Parameter Name Self Value Peer Value Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 466
outstanding R2T Default time to retain Default time to Reset: 0 iSCSI Target Reset: 0 iSCSI Task Reassign: 0 Non FCP in PDU: 0 Non FCP in Octet: 0 Non FCP out PDU: 0 Non FCP out Octet: 0 fosConfig, iscsiCfg, iscsiPortCfg 256KB 64KB 16 60s 0s 2 Off Peer Value 64KB On On On 436 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 467
-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. Note The execution of this command is subject to Virtual Fabric or - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 468
• Bandwidth • Trunking enabled, if applicable • QoS enabled, if applicable When issued on a switch that is part of a logical fabric configuration, the islShow command displays logical interswitch links (LISLs) along with regular ISLs. However, speed (sp) displays N/A for logical ports. The bandwidth - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 469
parameter only supports Brocade FC4-16IP blades in Brocade 48000 directors. Specifies the IP address in dotted-decimal form. Examples To set the IP address of an external iSNS server with an attached GbE port: switch:admin> isnsccfg --set 7/ge0 -s 192.168.131.124 iSNS client configuration updated - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 470
isnscCfg See Also To register the iSNS objects: switch:admin> isnsccfg --reregister Initiated re-register of iSNS objects with iSNS server To clear the IP address of iSNS server: switch:admin> isnsccfg --clear Cleared iSNS server configuration. none 440 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 471
it is legal syntax, the ports do not exist. • If no slot number is specified, all lists except user port lists use the default slot 0. • No list type except for user port lists may specify multiple conflicting slot numbers. For instance, "1/0, 2/0, 3/0" is a valid user port list but is not valid - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 472
which user-accessible external ports within the current switch (selected during Telnet login) are tested. When specified in an item list, user ports might be specified by either the area portion of the ports Fibre Channel address or with slot/port notation. For non-blade systems, the port number on - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 473
serial port login sessions and information such as session number, login name, idle time, IP address of USER TTY IDLE FROM LOGIN@ ~ 0 root0 ttyS0 1:17m - 5:13pm 1 admin0 pts/1 3.00s 192.168.130.29 6:31pm Enter Session Number to terminate (q to quit) q See Also none Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 474
server role to one of the default roles available on a switch. This command also provides an option user belonging to that group to login to the switch with the permissions associated with the mapped switch role. This command supports one-to-one role mapping only. For example, you might map the "SAN - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 475
role to the switch role of "operator": switch:admin> ldapcfg --maprole SANoperator operator LDAP role SANoperator has been successfully mapped. switch:admin> ldapcfg --unmaprole SANoperator LDAP role SANoperator has been successfully unmapped. aaaConfig, userConfig Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 476
chassis context. Each logical switch displays only the user ports that are configured to be part of that switch instance. The switch context is defined by the fabric ID. The default context is the base logical switch that you are placed in upon login. The default logical switch context is defined by - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 477
OS v6.2.0 or later. Refer to the Fabric OS Administrator's Guide for specific hardware support. You cannot use the portEnable command on logical ports. Use lfcfg with the --lislenable option to re-enable disabled LISL ports on a logical switch. Operands This command has the following operands - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 478
Base switch: YES Fabric Id: 2 Switch WWN: 10:00:00:05:1e:0b:a4:41 Logical Switch: 1 State: Online(1) Base switch: NO Fabric Id: 1 Switch WWN: 10:00:00:05:1e:0b:a4:40 To display the LISLs in the logical switch: switch:admin> lfcfg --show -lisl FID Port# remote-domainName State 2 384 24 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 479
Some features of the switch and the fabric to which it is connected are optional, licensed products. Without a valid license installed for such products, their services are not available. A license key is a string of any length consisting of upper- and lowercase letters and numbers. License keys are - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 480
license keys to switch Prints license help info Displays the system license ID Removes a license key from this system Displays current license keys Configures licenses on a slot basis See Also licenseAdd, licenseIdShow, licensePort, licenseRemove, licenseSlotCfg, licenseShow 450 Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 481
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 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 482
1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is valid only on embedded platforms. On unsupported platforms, this command returns a "not supported" message. Operands This command has the following operands: port Specifies the number of the port to - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 483
the second POD license is installed 24 ports are assigned to installed licenses: 12 ports are assigned to the base switch license 12 ports are assigned to the first POD license Ports assigned to the base switch license: 1, 2, 3, 5, 6, 7, 8, 10, 11, 14, 15, 19 Ports assigned to the first POD license - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 484
product have been uninstalled. You must reboot the switch after removing a license. For a switch that has no licenses installed, licenseShow displays "No licenses." Upgradable licenses, such as slot-based licenses or Universal Time-based licenses cannot be permanently removed; they remain in - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 485
licenseRemove 2 See Also 8 Gig FC license Expiry Date 03/06/2009 License is expired Hf7MBEEGCFNmTAWXXF99RtHXQN4RRtM3mLGtrWZLAMaTaAY9EB: Storage Application Services license Expiry Date 03/07/2009 licenseAdd, licenseHelp, licenseIdShow, licenseShow Fabric OS Command Reference 455 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 486
enabled by number of slots configured to use the license) - Configured Blade Slot Positions (slot numbers of the configured blade slots) When no licenses are installed, the message "No license installed on this switch" is displayed. Note The execution of this command is subject to Virtual Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 487
switch with universal time-based and slot-based licenses installed (the first two examples show time-based, the third one shows a slot-based license): switch Capacity 4 Consumed 2 Configured Blade Slots 1,3. licenseAdd, licenseHelp, licenseIdShow, licenseRemove Fabric OS Command Reference 457 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 488
--show licenseslotcfg --help Description Use this command to configure and manage licenses for the Brocade FX8-24 extension blade on the slot where the blade is installed. Slot-based licenses allow you to select the slots the license will enable up to the purchased capacity and thereby increase - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 489
add FTR_AE 12 Blade slot-12 added to FTR_AE slot-based license configuration Remaining capacity for FTR_AE slot-based license = 4 To display the enabled licenses: switch:admin> licenseshow SSezcSec9RXTf0dj: Performance Monitor license KgrfCBHgRtfBrGKH4D7f9S3FBX7K3MtTtBHKrYHA4CMB: 10 Gigabit Ethernet - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 490
based license configuration switch:admin> licenseslotcfg --show FTR_10G license - blade slots configured = 1,3,5,12 FTR_AE license - blade slots configured = 12 FTR_AFA license - blade slots configured = 3,4 switch Storage Application Services license Expiry Date 03/07/2009 460 Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 491
switch:admin> licenseshow SSezcSec9RXTf0dj: Performance Monitor license KgrfCBHgRtfBrGKH4D7f9S3FBX7K3MtTtBHKrYHA4CMB: 10 Gigabit Ethernet (FTR_10G) license Capacity 8 Consumed 4 Configured Services license Expiry Date 03/07/2009 licenseAdd, licenseHelp, licenseIdShow, licenseRemove Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 492
positive number. The FSPF protocol compares the cost of various paths between a source switch and a destination switch by adding default, "static" cost for any port except EX/VEX ports. Use fcrRouterPortCost to configure EX/VEX ports. The execution of this command is subject to Virtual Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 493
Cost 500 (STATIC) To delete the cost value and reset to default: switch:admin> linkcost 2/4 0 To display the change: switch:admin> linkcost 2/4 Interface2/4 Cost 1000 See Also interfaceShow, lsDbShow, topologyShow, uRouteShow, fcrRouterPortCost Fabric OS Command Reference 463 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 494
that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To log in as admin from the login user: switch:user> login login: admin Password:xxxxxx See Also logout 464 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 495
command is accepted as a synonym for logout, as is Ctrl-D at the beginning of a line. Operands none Examples To log out from an rlogin session: switch:admin> logout See Also login Fabric OS Command Reference 465 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 496
information (information about the devices in the zone) is provided for each LSAN zone. The default output displays only WWNs of the zone members. Search parameters -f, -w, and -z allow searching for LSAN zones based on fabric ID, WWN of an LSAN zone member, or LSAN zone name. "No LSAN zone found - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 497
Also 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 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 498
be deleted. All switch ports not explicitly assigned to a logical switch are part of the default logical switch. The logical switch feature allows you to configure multiple logical fabrics on top of a base (physical) fabric. Each logical fabric is made up of logical switches that share the physical - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 499
configured. This command prompts for confirmation, indicating that the specified ports will be disabled. The following operands are supported: FID Specifies the fabric ID of the logical switch. This operand is required. -slot slot | slot_range Specifies the slot number or a range of slot numbers - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 500
a chassis. Without any operands, the command displays all logical switches and the ports assigned to them. For each switch, the FID and switch role are displayed: base switch (BS) or default switch (DS). -provision Displays the partition configuration for all slots, regardless of the slot's status - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 501
when you are ready to continue. To assign ports to a logical switch without confirmation: switch:admin> lscfg --config 2 -port 0-4 -force Configuration change successful. Making this configuration change. Please wait... Please enable your ports/switch when you are ready to continue. To display - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 502
--change 1 -base Creation of a base switch requires that the proposed new base switch on this system be disabled. Would you like to continue [y/n]?: y Disabling the proposed new base switch... Disabling switch fid 1 Please enable your switches when ready. lfCfg, setContext 472 Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 503
state database record for switches in the fabric or for a switch. Pointer to LSR. Number of LSRs accepted, even though they were not sufficiently spaced apart. Number of LSRs not accepted because they were not sufficiently spaced apart. Last time an LSR was ignored. Time this LSR was installed - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 504
other side of the link. Port number on the local switch. Port number of the port on the other side of the link. Cost of this link. The default cost for a 1 Gbps link is 1,000. Always 0. Always 1. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 505
length = 60 chksum = 0x168a linkCnt = 2, flags = 0x0 LinkId = 91, out port = 28, rem port = LinkId = 91, out port = 29, rem port = 28, cost = 500, costCnt = 0, type = 1 29, cost = 500, costCnt = 0, type = 1 interfaceShow, nbrStateShow Fabric OS Command Reference 475 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 506
switchWwn: 10:00:00:05:1e:41:5f:c2 zoning: ON (lsan_cfg) switchBeacon: OFF FC Router: OFF Allow XISL Use: ON LS Attributes: [FID: 10, Base Switch: No, Default Switch: No, Address Mode 0] 476 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 507
" on FID 128: "portenable" on FID 10: A port or ports is/are not part of this switch. "portenable" on FID 20: A port or ports is/are not part of this switch. switch:admin> To display the firmware version for all logical switches: switch:user> fosexec --fid all -cmd "firmwareshow -v" LF - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 508
fosExec See Also To display the switch name for all logical switches without confirmation: switch:user> fosexec --fid all -force -cmd "switchname" switchname" on FID 10: switch_10 switchname" on FID 20: switch_20 switch:user> setContext, userConfig 478 Fabric OS Command Reference 53-1001337 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 509
switch, as well as the shared memory and buffers used by the kernel. Note The execution of this command is subject to Virtual Fabric default, memory usage is displayed in bytes. Examples To view the memory usage: switch:admin> memshow total used Mem: 129740800 112562176 Swap: 0 0 switch - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 510
switch in the fabric: switch:admin> mscapabilityshow Switch WWN Capability Switch Name 10:00:00:60:69:20:15:71 0x0000008f "switch1"* 10:00:00:60:69:00:30:05 0x0000008f "switch2" Capability Bit Definitions: Bit 0: Basic Config Service Supported. Bit 1: Platform Management Service Supported - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 511
Use this command to configure the MS Access Control List (ACL). The MS allows a Storage Area Network (SAN) management application to retrieve and administer the fabric and Interconnect Elements, such as switches. This application is located at the Fibre Channel well-known address, 0xFFFFFA - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 512
list 2 Add member based on its Port/Node WWN 3 Delete member based on its Port/Node WWN select : (0..3) [1] 0 done ... msCapabilityShow, msPlatShow, msPlClearDB, msPlMgmtActivate, msPlMgmtDeactivate, msTdDisable, msTdEnable, msTdReadConfig, secPolicyShow 482 Fabric OS Command Reference 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 513
"Command Availability" for details. Operands none Examples To display the MS platform database for a fabric: switch:admin> msplatshow Platform Name: [9] "first obj" Platform Type: 5 : GATEWAY Number of Associated M.A.: 1 Associated Management Addresses: [35] "http://java.sun.com/products/plugin - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 514
Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the MS platform service database control block: switch .enabled == 1. See Also msCapabilityShow, msConfigure, msPlatShow, msPlClearDB, msPlMgmtActivate, msPlMgmtDeactivate 484 Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 515
" for details. This command is supported only in AD0 and AD255 contexts. Operands none Examples To clear the MS platform database: switch:admin> msplcleardb MS Platform Service is currently enabled. This will erase MS Platform Service Database in the entire fabric. Would you like to continue - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 516
reboots. Notes By default, the MS platform service is disabled. Before issuing this command, run msCapabilityShow to verify that all switches in the fabric support the MS platform service; if one switch does not support the service, the command fails. When an FCS policy is enabled, this command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 517
This command is supported only in AD0 and AD255 contexts. Operands none Examples To deactivate the MS platform service on all switches in the fabric: switch:admin> msplmgmtdeactivate MS Platform Service is currently enabled. This will erase MS Platform Service configuration information as well - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 518
attached switches) to support request node identification data (RNID) extended link service (ELS). When an FCS policy is enabled, and this command is issued with the "ALL" operand, it can be issued only from the primary FCS. The execution of this command is subject to Virtual Fabric or Admin - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 519
mstdenable ["ALL"] Description Use this command to enable the MS topology discovery service on the local switch or throughout the fabric. The change takes effect immediately and commits to the configuration database for all affected switches. The change is persistent across power cycles and - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 520
Operands none Examples To display the status of the topology discovery service: switch:admin> mstdreadconfig *MS Topology Discovery is enabled. See Also msCapabilityShow, msConfigure, msPlMgmtActivate, msPlMgmtDeactivate, msTdDisable, msTdEnable 490 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 521
login session. The login session gives details of the following: • CP/switch (or console/serial port) used to log in. • The IP address of the current login session for Telnet or the name of the current console port or the serial port (if modem login used). • The current CP mode (Active, Standby, or - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 522
about fabric shortest path first (FSPF) neighbors to the local switch or information about a neighbor to a specified port. FSPF can route frames only if the neighbor is in full state. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 523
nbrStateShow 2 Examples See Also To display information about a neighbor directly connected to the local switch: switch:user> nbrstateshow 2/0 Local Domain ID: 1 Local Port Domain Remote Port State 16 2 48 NB_ST_FULL interfaceShow Fabric OS Command Reference 493 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 524
number of the port to display, followed by a slash (/). portnumber Specify the port number to display, relative to its slot for bladed systems. Use switchShow to list valid ports. This operand is optional; if omitted, FSPF statistics are reset. Examples To display the counters on a port: switch - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 525
To reset the counters on a port: switch:admin> nbrstatsclear 1/0 See Also To verify the changes: switch:admin> interfaceshow 1/0 idbP = 0x10050a38 Interface 0 data structure: nghbP ifNo masterPort defaultCost cost = 0x1004ce68 = 0 = 0 (self) = 500 = 500 (output truncated) interfaceShow, - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 526
of one or two hexadecimal numbers between 0 and ff, with switch:user> nodefind a320 Local: Type Pid COS PortName NodeName SCR NL 0314d9; 3;22:00:00:04:cf:5d:dc:2d;20:00:00:04:cf:5d:dc:2d; 0 FC4s: FCP [SEAGATE ST318452FC 0001] Fabric Port Name: 20:14:00:60:69:80:04:79 Permanent Port - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 527
ST336605FC 0003] Fabric Port Name: 20:14:00:60:69:80:04:79 Permanent Port Name: 22:00:00:04:cf:9f:26:7e Device type: Physical Target Port Index: switch:user> nodefind 0x020eef Remote: Type Pid COS PortName NodeName NL 020eef; 3;20:00:00:e0:8b:01:ce:d3;20:00:00:e0:8b:01:ce:d3; Fabric Port - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 528
• Physical - Device connected to the NX_Port, using FLOGI to log in to the switch. • Virtual - Contrived device by the switch. • NPV - Device connected to the NX_Port, using FDISC to log in to the switch. • iSCSI - Device connected to the iSCSI port. 498 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 529
nsAliasShow 2 The second part indicates the role of the device. Currently, four roles are defined: • the -r option: switch:admin> nsaliasshow -r { Type Pid COS PortName NodeName SCR N 021200; 2,3;10:00:00:60:69:00:03:19;30:00:00:60:69:00:03:19; 3 FC4s: FCIP Fabric Port Name: 20:02: - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 530
has 6 entries } To display local NS information with aliases with the -r and -t options: switch:admin> nsaliasshow -r -t { Type Pid COS PortName NodeName SCR N 021200; 2,3;10:00:00:60:69:00:03:19;30:00:00:60:69:00:03:19; 3 FC4s: FCIP Fabric Port Name: 20:02:00:60:69:01:44:22 Permanent - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 531
See Also Fabric Port Name: 20:04:00:60:69:01:44:22 Permanent Port Name: 21:00:00:ad:bc:04:6f:70 Device type: Physical Target Aliases: The Local Name Server has 6 entries } nsAllShow, nsShow, switchShow nsAliasShow 2 Fabric OS Command Reference 501 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 532
-IP type device Other FC-PH types are displayed in the format "x ports supporting FC4 code," where x is the number of ports of a type and code is the FC-PH type code. Examples To display all devices in the fabric, followed by all type 8 (SCSI-FCP) devices and all type 5 (SCSI-FCIP) devices: switch - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 533
for that domain number. For each device found in the devices list, the following information is displayed: Type U for unknown, N for N_Port, NL for NL_Port. Pid The 24-bit Fibre Channel address. COS A list of classes of service supported by the device. PortName The device's port world wide - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 534
;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 rev owner known v320 0xfffc01 Device list: count 0 No entry is found! See - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 535
to display NS information for all switches in the fabric. Each line of output displays the following information: Type U for unknown, N for N_Port, NL for NL_Port. PID 24-bit Fibre Channel address. COS List of classes of service supported by device. PortName Device port world wide name (WWN - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 536
Of the two device type parts, the first part indicates the origination of the switch:admin> nsshow { Type Pid COS PortName NodeName TTL(sec) N 010100; 3;21:00:00:e0:8b:13:08:10;20:00:00:e0:8b:13:08:10; na FC4s: FCP NodeSymb: [41] "QLA2340 FW:v3.03.06 DVR:v9.0.0.2 (w32 IP)" Fabric Port - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 537
name server information with "-r" and "-t" options. switch:admin> nsshow -r -t { Type Pid COS PortName NodeName SCR N 010100; 3;21:00:00:e0:8b:13:08:10;20:00:00:e0:8b:13:08:10; 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 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 538
in the entire fabric. Use the -a option to display online zoned device data for each local device. The command output displays the following information: Type U - known, N - N_Port, NL - NL_Port. Pid The 24-bit Fibre Channel address. COS A list of classes of service supported by the device - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 539
about all the online devices zoned with the given device: switch:admin> nszonemember 0x0416e2 3 local zoned members: Type Pid COS PortName NodeName SCR NL 041901; 2,3;10:00:00:00:c9:26:0e:ae;20:00:00:00:c9:26:0e:ae; 3 Fabric Port Name: 20:09:00:60:69:50:06:78 Permanent - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 540
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 See Also To display all the unzoned devices in the fabric: switch:admin> nszonemember - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 541
to other switches in the fabric, the switches must be configured to accept the password database with the fddCfg command. The password database is distributed manually with the distribute command. If RADIUS authentication is enabled, password change is blocked for users changing their own - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 542
error messages. Refer to the Fabric OS Message Reference for more diagnostic information. RADIUS enabled error Password change disallowed, RADIUS authentication is enabled. Password error Password length, strength, or history policy not met. "user" is not a valid user name You have not specified - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 543
. You must wait longer to change your password. You cannot change the password before the minimum aging period expires. Password contains invalid characters. The password you entered contains invalid characters. See Also login, logout, passwdCfg Fabric OS Command Reference 513 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 544
password expiration policy is enforced across all user accounts except the root and factory accounts. Account Lockout Policy The account lockout policy disables a user account when the user exceeds a configurable number state. The account lockout 514 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 545
--showall Displays all the password configuration parameters. --set Configures a specified password policy. The following arguments are supported: -lowercase value Specifies the minimum number of lowercase alphabetic characters that must occur in the password. The default value is 0. The maximum - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 546
is displayed. The valid range for -warning is 0 to 999. The default value to 0. -lockoutthreshold value Specifies the number of times a user can specify an incorrect password during login before the account is locked. The number of failed login attempts is counted from the last successful login - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 547
enabled and sets the config parameter "passwdcfg.adminlockout" to 0. By default, admin lockout policy is disabled. --setdefault Resets all password policies to their default values. --help Displays the command usage. Examples To display the current password configuration parameters: switch - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 548
The -history value must be between 1 and 24. minpasswordage value out of range The -minpasswordage be between 0 and 999. invalid password expiration specification The -minpasswordage value or 40. sequence value out of range The -sequence value must be between 1 and 40. passwd, userConfig 518 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 549
calculated continuously in real-time. Each switch represents one hop of the total path. In a Virtual Fabric environment, pathInfo displays port numbers beyond physical port numbers while displaying information for a hop that corresponds to a path in the base fabric. The cost for this hop is - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 550
of general interest. They include the following: F/s The number of frames received or transmitted per second. This value is reported for multiple time periods, displayed in parentheses. Words The total number of 4-byte Fibre Channel words. 520 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 551
domain is traced, specified as the port index. The embedded port (-1) is the default. The embedded port can be selected manually by entering the value of MAX_PORT. MAX_PORT stands for the maximum number of ports supported by the local switch. Fabric OS Command Reference 521 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 552
prompts for the following parameters: max hops The maximum number of hops that the pathInfo frame is allowed to traverse; the default is 25. Fabric Id Specifies the Fabric ID. If unspecified, the value defaults to -1 (Default switch FID 128) basic stats Whether basic statistics are generated - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 553
environment (the cost for this hop is the cost of the corresponding path in the base fabric): switch:admin> pathinfo 13 4 Target port is Embedded Hop In Port Domain ID (Name) Out Port BW Cost 0 4 9 2009* - 1500 1 2015* 10 8 1G 1000 2 6 13 E - - To display basic and extended - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 554
(64s) 0 0 0 0 Words 240434036 2294316 2119951 2121767 Frames 20025929 54999 162338 56710 Errors - 4 - 0 Hop In Port Domain ID (Name) Out Port BW Cost 2 14 8 (web228) E - - (output truncated) portStatsShow, switchShow 524 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 555
displays output from the latest panic dump file available on the switch. If a panic dump file is specified as an argument, the contents of that specific file are displayed. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 556
number, which can be used to manipulate performance monitors. Notes This command requires an Advanced Performance Monitoring license. This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port, M (Mirror) ports and GbE ports. The execution of this command is subject to Virtual Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 557
and DestID both cannot be 0x000000. Examples To add an end-to-end monitor to blade 1 port 2: switch:admin> perfaddeemonitor 1/2 "0x050200" "0x1182ef" End-to-End monitor number 0 added. To add an end-to-end monitor to an Encryption switch: In this scenario, one target disk storage device connects - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 558
VT VI ---> Target 0x01a000 0x0a2001 0x0a2002 0x0a0100 3. Add an EE monitor on port 1 between the Initiator SID and the virtual initiator DID: EncryptionSwitch:SecurityAdmin> perfaddeemonitor 1 0x0a0100 0x0a2002 End-to-End monitor number 0 added. 528 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 559
End-to-End monitor number 1 added. See Also 5. Display the EE monitors on the Encryption Switch: EncryptionSwitch:SecurityAdmin> perfmonitorshow --class EE 1 There are 2 end-to-end monitor(s) defined on port perfDelEEMonitor, perfMonitorClear, perfMonitorShow Fabric OS Command Reference 529 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 560
the physical resources available to support the installation of performance monitors on a logical switch port. In a Virtual Fabric environment, performance monitors installed on a logical switch share the physical resources of the switches that make up the base fabric. To make efficient usage of - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 561
2 Examples To display the number of F_Port monitors that can be installed on the current logical switch: switch:admin> perfresourceshow --fportRes Max Installed Available Slot/PortRange 4 0 3 2/13 4 2 2 3/5,3/7,3/12 Port list information Slot 1 2 3 4 5 6 7 8 9 10 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 562
To display the number of F_Port monitors that can be installed on port 2/37: switch:admin> perfresourceshow --fportRes 2/37 Slot/Port Max Installed Available 2/37 4 0 4 To display the number of EE monitors that can be installed on the current logical switch: switch:admin> perfresourceshow - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 563
2 See Also 36 37 38 39 40 41 42 43 44 45 46 47 To display the number of EE monitors that can be installed on port 10: switch:admin> perfresourceshow --eeRes 2/10 slot/Port Available Installed 2/0 30 3 To display the status of TT fabric mode on the current logical - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 564
. The default alias is "IP Frame". Examples To add an IP monitor to a port: switch:admin> perfaddipmonitor 1/4 IP_MONITOR IP traffic frame monitor #0 added See Also perfAddEEMonitor, perfAddReadMonitor, perfAddRWMonitor, perfAddSCSIMonitor, perfAddUserMonitor, perfAddWriteMonitor 534 Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 565
SCSI Read command. 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 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 566
write commands. 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 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 567
of valid keys and user-defined aliases. Notes This command requires an Advanced Performance Monitoring license. This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port, M (Mirror) ports and GbE ports. The execution of this command is subject to Virtual Fabric or Admin Domain - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 568
of valid keys and user-defined aliases. Notes This command requires an Advanced Performance Monitoring license. This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port, M (Mirror) ports and GbE ports. The execution of this command is subject to Virtual Fabric or Admin Domain - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 569
. 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: switch:admin> perfaddusermonitor 1/4 "4, 0xff, 0x22; 12, 0xff, 0x01" User monitor #0 added As a special case - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 570
write command. 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 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 571
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. The - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 572
overwrites any configuration changes that were not saved. Notes This command requires an Advanced Performance Monitoring license. This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port, M (Mirror) ports and GbE ports. The execution of this command is subject to Virtual Fabric or - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 573
may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To save the current performance monitoring configuration to firmware: switch:admin> perfcfgsave This will overwrite previously saved Performance Monitoring - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 574
" for details. This command is not supported on all platforms. Refer to the Fabric OS Administrator's Guide for specific hardware support. Operands This command has the following operands: slotnumber For bladed systems only, specifies the slot number of the port on which the monitor is to be - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 575
an end-to-end monitor on a port, or all such monitors: switch:admin> perfdeleemonitor 7/2 5 End-to-End monitor number 5 deleted switch:admin> perfdeleemonitor 7/2 This will remove ALL EE monitors on port 2, continue? (yes, y, no, n): [no] y See Also perfAddEEMonitor, perfMonitorShow Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 576
monitors from the port: switch:admin> perfdelfiltermonitor 2/3 4 The specified filter-based monitor is deleted. switch:admin> perfdelfiltermonitor 2/3 This will remove ALL monitors on port 19, continue? (yes, y, no, n): [no] y See Also perfAddUserMonitor, perfMonitorShow 546 Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 577
an end-to-end monitor Delete filter-based monitor Clear end-to-end/filter-based/ISL monitors Show end-to-end/filter-based/ISL monitors Set overall mask for end-to-end monitors Get ALPA CRC count by port and ALPA Show the current end-to-end mask Install Top Talker monitor See Also none Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 578
EE 1/2 This will clear ALL EE monitors' counters on port 2, continue? (yes, y, no, n): [no] y To clear statistics counters for a filter-based monitor: switch:admin> perfmonitorclear --class FLT 1/2 4 Filter-based monitor number 4 counters are cleared 548 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 579
ISL monitor: switch:admin> perfmonitorclear --class ISL 1 This will clear ISL monitor on port 1, continue? (yes, y, no, n): [no] y perfAddEEMonitor, perfAddIPMonitor, perfAddReadMonitor, perfAddRWMonitor, perfAddSCSIMonitor, perfAddUserMonitor, perfAddWriteMonitor, perfMonitorShow Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 580
port. Monitor classes include end-to-end monitors (EE), filter-based number of ports in this ISL (one for a standalone ISL, more for trunks). Num_domains The total number of domains being monitored. Domain_count The 64-bit cumulative transmit counter for each individual domain. 550 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 581
supported on virtual FC ports (VE/VEX_Port), EX_Port, M (Mirror) ports and GbE ports. The execution of this command is subject to Virtual Fabric end-to-end), FLT (filter-based), or ISL (interswitch link). These values are case-sensitive. For bladed systems only, specifies the slot number of the port - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 582
2 perfMonitorShow To display end-to-end monitors on a port at an interval of every 5 seconds: switch:admin> perfmonitorshow --class EE 8 5 Showing EE port: switch:admin> perfmonitorshow --class FLT 8 There are 2 filter-based monitors defined on port Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 583
perfMonitorShow 2 See Also To display ISL monitor information on a port: switch:admin> perfmonitorshow --class ISL 1/1 Total transmit count for this ISL: 1462326 Number of destination domains monitored: 3 Number of ports in this ISL: 2 Domain 97: 110379 Domain 98: 13965 Domain 99: - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 584
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. This command controls all three address - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 585
mask for end-to-end monitors on a port: switch:admin> perfsetporteemask 1/6 "00: port will cause ALL EE monitors on this port to be deleted. continue? (yes, y, no, n): [no] y The EE mask on port 6 is set and EE Monitors on this port are deleted See Also perfAddEEMonitor, perfShowPortEEMask Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 586
" for details. This command is not supported on all platforms. Refer to the Fabric OS Administrator's Guide for specific hardware support. Operands This command has the following operands: slotnumber For bladed systems only, specifies the slot number of the port to be displayed, followed by - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 587
default value of the EE mask is all fields set to "on." Notes This command requires an Advanced Performance Monitoring license. This command is not supported on virtual FC ports (VE/VEX_Port), EX_Port, M (Mirror) ports and GbE ports. The execution of this command is subject to Virtual Fabric or - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 588
2 perfShowPortEEMask See Also RxSID ALPA: on RxDID Domain: on RxDID Area: on RxDID ALPA: on perfAddEEMonitor, perfDelEEMonitor, perfSetPortEEMask 558 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 589
the Brocade 7500. Top Talker supports two modes, Port Mode and Fabric Mode: • In Port Mode, Top Talker is installed on an F_Port to measure the traffic originating from the F_Port and flowing to different destinations. The output displays the data in a sorted order based on the data rate of each - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 590
Talker monitor on a specified F_Port. Fabric Mode Top Talker commands: --add fabricmode Installs the Top Talker monitor on all switches in the fabric. When a new switch joins the fabric, this command must be run again on the switch. The TT configuration information is not propagated automatically - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 591
--add fabricmode To delete the Fabric Mode Top Talker: Switch:admin> perfttmon --del fabricmode To display the Fabric Mode Top Talker output: Switch:admin> perfttmon --show dom 1 pid perfttmon --show dom 1 pid Src_PID Dst_PID MB/sec Potential E-Ports 0x03f600 0x011300 121.748 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 592
place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To create PKI objects: switch:admin> pkicreate Installing Private Key and Csr... Switch key pair and CSR generated... Installing Root Certificate... See Also If PKI - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 593
the security functionality of this fibre channel switch. If you want secure mode enabled, you will need to get the switch certificate again. About to remove Pki objects. ARE YOU SURE (yes, y, no, n): [no] y All PKI objects removed. See Also pkiCreate, pkiShow Fabric OS Command Reference 563 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 594
pkishow Description Use this command to display PKI objects, such as switch private key, private key pass-phrase, CSR, root certificate, and switch certificate. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 595
algorithm. The default is SHA-1. Algorithms include: Secure hash algorithm. Message digest 5. Advanced encryption standard. Valid only with IPSec. Specifies the perfect forward secrecy. This operand is valid only with IKE policies. Values are on (default) or off. Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 596
250000000 or 0. The default is 28800. Examples To create a new policy: switch:admin> policy --create Life (seconds): 28800 IKE Policy 29 Authentication Algorithm: SHA-1 Encryption: AES-128 Perfect Forward Secrecy: on Diffie-Hellman Group: 1 SA Life (seconds): 28800 Operation Succeeded 566 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 597
-1 Encryption: AES-128 Perfect Forward Secrecy: 0 Diffie-Hellman Group: 1 SA Life (seconds): 28800 See Also To delete a policy: switch:admin> policy ike --delete 10 The policy has been successfully deleted. portCfg, portCfgShow, portShow policy 2 Fabric OS Command Reference 567 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 598
(on the base switch and logical switches). On other platforms, the command returns a "not supported" message. Operands This command has the following operands: --bind Assigns the lower two bytes of the Fibre Channel address to the specified port. slot_number Specifies the slot number on bladed - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 599
low two bytes of a port 24-bit Fibre Channel address: switch:admin>portaddress --bind 5/18 0x1a00 To unbind a given address from a port: switch:admin>portaddress --unbind 5/18 0x1a00 To display all port address bindings on the current partition: switch:admin>portaddress --show Partition Address - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 600
address binding for port 28: See Also switch:admin>portaddress --show 5/18 Index Slot Port Area Mode 412 5 28 0x1400 8 bit To display the port bound to a specified address. switch:admin>portaddress --findPID 0x2400 Index Port Port ID 36 36 0x 2400 none 570 Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 601
Specify the port number to display, relative to its slot for bladed systems. Use switchShow to list valid ports. Examples To display the AL_PAs of a port: switch:user> portalpashow 4/14 AL_PA type AL_PA 0xe2 public 0xe4 type public AL_PA type See Also switchShow Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 602
to display, followed by a slash (/). port Specifies the number of the port to be configured, relative to its slot for bladed systems. Use switchShow for a listing of valid ports. mode Specifies the port beaconing mode as one of the following: --enable Enables beaconing mode on the specified - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 603
the port at full bandwidth (depending on the port configuration). If the number of Buffer Usage is less than the number of Needed Buffers, the port is operating in the buffer limited mode. Link Distance For L0 (not in long distance mode), the command displays the fixed distance based on port speed - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 604
by a slash (/). portnumber Specifies the number of a port associated with the port group, relative to its slot for bladed systems. Use switchShow for a list of valid ports. Examples To display the port buffer information for a port: switch:admin> portbuffershow 17 User Port Lx Max/Resv Buffer - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 605
bladed systems only, specifies the slot number of the port to display, followed by a slash (/). portnumber Specifies the port number to display, relative to its slot for bladed systems. Use switchShow to list valid ports. This operand is required. Fabric OS Command Reference 575 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 606
3 1 350400 2b2200 2b1200 220400 SID Free, DID Free: (61, 511) To display port CAM entries on shared ports: In the following example, port 7/31 and 7/39 are shared ports and 7/31 is the primary port. switch:user> portcamshow 7/39 Area SID used DID used SID entries DID entries 207 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 607
" for details. Some of the features supported by this command may require a license. The Fabric OS port configuration commands are not supported on FCoE ports. Use fcoe --cfg to configure FCoE ports. Function Synopsis Commands supported on the Brocade 7800/FX8-24 and the Brocade 7500/7500E/FR4-18i - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 608
FX8-24 platforms IPv6 addresses are not supported in the Fabric OS v6.3.0 release. IPv6 addresses are supported on the Brocade 7500/7500E and FR4-18i. Operands This command has the following operands: slot For bladed systems only, specifies the slot number of the port to be configured, followed - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 609
format. Examples To create an IP interface using IPv4: switch:admin> portcfg ipif 4/ge0 create 11.81.0.110. 255.0.0.0 1500 Operation Succeeded switch:admin> portshow ipif 4/ge0 Port: ge0 Interface IP Address NetMask MTU 0 11.81.0.110 255.0.0.0 1500 Fabric OS Command Reference 579 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 610
GbE ports act as Virtual E_Ports (VE_Ports) connecting the local and remote fabrics. The following operations can be performed with this command: • portcfg fciptunnel - Create, modify, and delete Fibre Channel over IP (FCIP) tunnels. - Configure a tunnel with the FastWrite feature. - Enable or - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 611
Specifies the IP address for the local end of the FCIP tunnel. IPv6 addresses are currently not supported. The following operands are exclusive: comm_rate Specifies the committed traffic rate on the FCIP tunnel in Kbps. The valid range is 1544 Kbps - 1000000 Kbps. There is no default. Both sides - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 612
as part of a channel recovery operation during tape emulation. --ficon-dvcack 0|1 Enables (1) or disables (0) FICON Device Level Acknowledgement emulation. This feature is applicable to both FICON Disk and Tape configurations. The feature removes one network round trip for exchanges that end with - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 613
from the channel. This limits processing to what the network and device can support. Too small a value limits pipelining performance. Too large a value results in too much data being accepted for one device on a path. The default value is 300 milliseconds (ms). The range is 100-1500. Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 614
is enabled, the default value is calculated based on the minimum retransmit time to ensure that the tunnel does not time out before the host times out (at least 80 seconds). If you choose to modify this value, the specified value must be greater than the calculated value. Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 615
integer value between 0-9 both on the Brocade FX8-24 and on the Brocade 7800. remote_ip_addr Specifies the IP address for the remote end of the FCIP circuit. IPv6 addresses are currently not supported. local_ip_addr Specifies the IP address for the local end of the FCIP circuit. IPv6 addresses are - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 616
value is 100ms. -r |--max-retransmits retransmissions Specifies the maximum number of retransmissions. The valid range is 1 16. The default value is 8. If tape pipelining is enabled, the default value is calculated based on the minimum retransmit time to ensure that the tunnel does not time out - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 617
- Create, modify, and delete Fibre Channel over IP (FCIP) tunnels. - Delete, reset, and modify QoS mappings on an existing tunnel. - Create or modify a tunnel with VLAN tagging and Class of Service (CoS). - Create or modify a tunnel with Tape read/write Pipelining enabled or disabled. - Create or - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 618
Fibre Channel over IP (FCIP) tunnel. You can configure up to a maximum of eight FCIP tunnels per GbE port. The syntax for portCfg fciptunnel is as follows: portcfg fciptunnel [slot/][ge]port options arguments [optional_arguments] The following options and arguments are supported is enabled on - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 619
Tape Piplelining is enabled, the minimum supported value is 80. -M 0|1 Enables (0) or disables (1) default VC QoS mapping on the specified tunnel. By default VC QoS mapping is disabled. There are two ways of prioritizing network traffic over FCIP tunnels: Differentiated Services (DSCP) and Layer - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 620
not support QoS mapping. This command removes the file from the configuration flash memory only. The file is automatically reset to defaults if later used or modified. When modifying the VC QoS map, specifies the virtual channel ID for which the QoS map is modified. Valid values are 0 - 15. Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 621
to the mirror port. Port mirroring can aid in troubleshooting common FC end-to-end communication problems. The command prompts for confirmation that the specified port be enabled as a mirror port. Once a port is configured as a mirror port, the port can only be used as part of a mirror connection - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 622
FR4-18i blades connected by Fibre Channel ISLs. FastWrite mitigateslatency effects on SCSI writes, and improves throughputover a high-latency link. The blade first should be enabled for FC Fastwrite using fastWriteCfg. You can also use this command to list all ports configured for FC Fastwrite. The - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 623
recovery when a TIN/TIR exchange occurs as part of a channel recovery operation during tape emulation. -l 1|0 Enables (1) or disables (0) Device Level Acknowledgement emulation. This feature is applicable to both FICON Disk and Tape configurations. The feature removes one network round trip for - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 624
the range used by FICO channels and devices to avoid conflicts. The default value is 0x1000. The range is 0x0000 to 0xF000. -f |--dbgFlags value Defines optional debug flags. The default is 0xF7C80000. This parameter is primarily for use by technical support personnel. Fabric OS Command Reference 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 625
default values: switch:admin> portcfg fciptunnel ge1 qosmap 1 -default To create an FCIP tunnel with VLAN tagging: switch enabled: switch:admin> portcfg fciptunnel ge0 create 0 90000 -f -bstr To enable Byte Streaming on an existing tunnel: switch:admin> portcfg fciptunnel ge0 modify 0 -bstr 1 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 626
emulation features enabled using all default parameter arguments: switch:admin> portcfg ficon ge0 1 -x 1 -w 1 Function Synopsis Commands supported only on the Brocade 7500/7500E switches portcfg inbandmgmt ge_port option arguments Description Use this command to configure IP addresses and - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 627
the same subnet as one of the IP interface addresses. If the destination is not part of the same subnet, you must specify a gateway IP address. Examples To configure the internal addresses for the CP and GbE port inband management interfaces: switch:admin> portcfg inbandmgmt ge0 ipaddrset cp 192 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 628
A value of 0 sets the default AL_PA to 0x0. This operand is required. Examples To configure a port with AL_PA 0x0 (default): switch:admin> portcfgalpa 1/3 0 See Also To configure a port with AL_PA 0x13: switch:admin> portcfgalpa 1/3 1 portCfgShow 598 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 629
" and Appendix A, "Command Availability" for details. The Fabric OS port configuration commands are not supported on FCoE ports. Use fcoe --cfg to configure FCoE ports. Operands This command has the following operands: --enable --disable slot port[-port] Enables the auto disable feature on the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 630
example enables port 4. switch:admin> portcfgautodisable --enable 2-4 Same configuration for port 2 Same configuration for port 3 See Also To disable the auto disable feature on a port range. switch:admin> portcfgautodisable --disable 0-8 portCfgShow, portEnable : 600 Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 631
. The Fabric OS port configuration commands are not supported on FCoE ports. Use fcoe --cfg to configure FCoE ports. Operands This command has the following operands: --disable Disables credit recovery configuration on the specified port. --enable Enables credit recovery configuration on the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 632
The Fabric OS port configuration commands are not supported on FCoE ports. Use fcoe --cfg to configure FCoE ports. Operands This command has the following operands: slot For bladed systems only, specify the slot number of the port to be reset to default, followed by a slash (/). port Specify - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 633
switches, the maximum routing paths are limited to 16 E_Ports. The Fabric OS port configuration commands are not supported on FCoE ports. Use fcoe --cfg to configure FCoE ports. Operands This command has the following operands: slot For bladed systems only, specifies the slot number of the port - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 634
can be related to the same edge fabric or to different edge fabrics. When the port is not active, the preferred domain ID is configurable. The preferred domain ID is used by the EX_Port's front phantom domain to request a domain ID from the principal switch. The domain ID received becomes the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 635
values are what the edge switch specifies in the ELP request. If the state is "Not OK", the R_A_TOV and E_D_TOV display "Not Applicable". By default, all EX_Ports are auto-ELP enabled. If the Fabric Parameter attribute value is "User configured", the port ID format R_A_TOV and E_D_TOV values - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 636
switch:admin> portcfgexport 2/1 -f 5 -p 1 To configure port 2/0 to be an EX_Port and set the fabric ID to 4: switch:admin> portcfgexport 2/0 -a 1 -f 4 See Also To disable fabric parameter negotiation on port 2/0 of an EX_Port: switch:admin> portcfgexport 2/0 -t 2 To enable IDID on port 2: switch - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 637
and re-enables the port and the port comes online with the new fill word setting. The configuration is stored in nonvolatile memory and is persistent across switch reboots or power cycles. Notes This configuration cannot be set on VE_Ports or VEX_Ports. Use the portCfgShow command to display user - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 638
To allocate 12 buffers to an F_Port: switch:admin> portcfgfportbuffers --enable 2/44 12 To disable the port buffer configuration and return to the default buffer allocation: switch:admin> portcfgfportbuffers --enable 2/44 12 See Also portBufferShow 608 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 639
designation from the port. A value of 0 is the default port state. Mode must be preceded by a comma. This operand is required. Examples To configure port as a locked G_Port: switch:admin> portcfggport 1/3, 1 See Also configure, portCfgLport, portShow, switchShow Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 640
enabling ISL R_RDY mode, ensure that all fabric-wide parameters are consistent for every switch in the fabric. Use configShow fabric.ops to view a complete listing of fabric operating mode parameters on the switch. The following E_Port configurations are not applicable to a port configured for - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 641
See Also To disable ISL R_RDY mode on a port: switch:admin> portcfgislmode 1/3, 0 configure, portCfgLongDistance, portCfgShow portCfgISLMode 2 Fabric OS Command Reference 611 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 642
if the trunking is enabled. This feature is not backward compatible with firmware versions that do not support it. Ctrl-D cancels the configuration update. The Fabric OS port configuration commands are not supported on FCoE ports. Use fcoe --cfg to configure FCoE ports. Operands This command has - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 643
fill word option is not compatible with QoS configured links and Credit Recovery enabled links. You must disable these features before configuring long distance IDLE fill words. desired_distance On switches running firmware versions earlier than Fabric OS v6.2.0, this parameter controls the long - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 644
configure a switch port 63 to support a 100 km link and be initialized using the long distance link initialization protocol: switch:admin> portcfglongdistance 4/15 LS 1 100 switch Fbsy: 0 configure, portCfgISLMode, portCfgTrunkPort, portCfgShow, portShow, switchShow 614 Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 645
on the port. By default the L_Port will be a public L_Port. It can be configured as a private L_Port, in which case it will reject fabric login (FLOGI). Notes This configuration can be cleared but not set on VE/VEX_Ports. VE_Ports on the Brocade 7800 and FX8-24 platforms do not support Arbitrated - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 646
the L_Port conditions: switch:admin> portcfglport [output from other slots suppressed] Ports of Slot 4 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 Locked L_Port ON ON Private L_Port ON Locked Loop HD Loop Fairness configure, portShow, switchShow 616 Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 647
Displays the command usage. Examples To configure ge1 in optical mode: switch:admin> portcfggemediatype ge1 optical To display the current configuration: switch:admin> portcfggemediatype ge1 Port ge1 is configured in optical mode See Also portCfgShow Fabric OS Command Reference 617 53-1001337 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 648
IDs are allocated per NPIV port. The maximum number of virtual IDs can be configured from 0 to 255 per port. The default value is 126 per port. The number of virtual port IDs per switch can be configured with the configure command. Refer to the Fabric OS Administrator's Guide for details on NPIV - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 649
Persistent Disable NPIV capability QOS E_Port Port Auto Disable: Rate Limit EX Port Mirror Port Credit Recovery F_Port Buffers 7 AUTO(HW) 0(Idle-Idle) OFF ON OFF OFF OFF OFF OFF OFF OFF OFF OFF AE OFF OFF OFF OFF ON OFF configure, portCfgDefault, portCfgShow Fabric OS Command Reference 619 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 650
if it is connected to an enterprise fabric switch that supports NPIV. Notes NPIV capability should be enabled on the ports connected to the Access Gateway. Use portcfgnpivport to enable NPIV capability on the specific port. By default, NPIV is enabled by default on all 4 G and 8 G platforms. The - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 651
across power cycles, switch reboots, and switch enables. By default, a port is enabled persistently, unless the port is capable of routing. The change in configuration is effective immediately. You can identify the ports to be persistently disabled by port number or by port index. Use switchShow - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 652
number or a range of index numbers (index1-index2) for the ports to be persistently disabled. Port index ranges are supported only if PortSwap is disabled. Examples To disable a single port persistently: switch:admin> portcfgpersistentdisable 2/4 To disable a range of ports persistently: switch - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 653
communicate with the fabric. You can identify the ports to be persistently enabled by port number or by port index. Use switchShow for a listing of valid ports and port index numbers. When used without operands, this command displays all persistently enabled ports on the switch. For ports that come - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 654
2/4-8 To enable multiple port ranges persistently: switch:admin> portcfgpersistentenable 2/24-26 3/10-12 4/3-4 To enable a port persistently by specifying its index number: switch:admin> portcfgpersistentenable 176 To enable a range of ports persistently by specifying the corresponding port index - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 655
for all ports. --default Applies the default QoS configuration to the specified ports. QoS is enabled by best effort based on availability of buffers. --disable Disables QoS configuration on the specified ports. --enable Enables QoS configuration on the specified ports. --resetratelimit Turns - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 656
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> portcfgqos --default 3/15 See Also portCfg, portCmd, portShow, switchShow, configure : 626 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 657
-24 and on the Brocade 7500/7500E/FR4-18i platforms. • IP interfaces on the GbE port • Static routes on the IP interfaces • Address resolution protocol (ARP) entries "Displays supported only on the Brocade 7500/7500E/FR4-18i platforms" on page 630 • Fibre Channel over IP (FCIP) tunnel configuration - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 658
Service (QoS) is enabled on the E_Port (or EX_Port) when QoS is enabled in an FCR deployment scenario. Displays (..) or OFF when QoS is disabled. By default, QoS is enabled if sufficient buffers are available. Displays AE when QOS is configured as Auto Enabled. In the AE state, QoS is enabled based - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 659
" for details. The Fabric OS port configuration commands are not supported on FcoE ports. Use fcoe --cfg to configure FCoE ports. Operands This command supports the following operands: slot For bladed systems only, specifies the slot number of the port to be configured, followed by a slash - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 660
To display the port configuration settings for all ports on a Brocade DCX enterprise class platform: switch:admin> portcfgshow Ports of Slot 1 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 Speed 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10 Fill Word AL_PA Offset 13 630 Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 661
G_Port ---- -- Disabled E_Port ISL R_RDY Mode RSCN Suppressed Persistent Disable NPIV capability ON ON ON ON ON ON QOS E_Port Fport Buffers Port Auto Disable (output truncated) where AN:AutoNegotiate, ..:OFF, ??:INVALID, Fabric OS Command Reference 631 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 662
2 portCfgShow To display the configuration settings for a single port on a switch with Access Gateway enabled: switch:admin> portcfgshow 8 Area Number: Speed Level: Fill Word: Trunk Port Locked N_Port Persistent Disable NPIV capability QOS Port Port Auto Disable: Rate Limit F_Port Buffers 8 AUTO( - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 663
portCfgShow 2 To display the QoS configuration for an EX_Port (QoS over FCR deployment): switch:admin> switchshow | grep EX-Port 16 16 id N4 Online FC EX-Port 10:00:00:05:1e:41:4a:45 "Tom_100" (fabric id = 25 )(Trunk master) switch:admin> portcfgshow 16 Area Number: 11 Speed Level: AUTO( - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 664
0 VLAN Tagging Not Configured VC QoS Map: (default) VC DSCP L2CoS VC DSCP L2CoS VC DSCP L2CoS 0 46 7 1 07 0 2 11 3 4 19 3 5 23 3 6 27 0 8 35 0 9 39 0 10 43 4 12 51 4 13 55 4 14 59 4 (output truncated) VC DSCP L2CoS 3 15 3 7 31 0 11 47 4 15 63 0 634 Fabric OS Command Reference 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 665
10.1 100 7 192.168.10.1 App 192.168.10.1 100 3 0.0.0.0 Perm To display inband management interfaces configured on the Brocade 7500: switch:admin> portcfgshow inbandmgmt ge1 Inband management: Enabled Port: ge1 CP Interface IP Address NetMask MTU 0 192.168.255.1 255.255.255.252 1500 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 666
re-enables the port, and the port comes online with the new speed setting. The configuration is saved in nonvolatile memory and is persistent across switch reboots or power cycles. Use the portShow command to display actual port speed levels. Use the portCfgShow command to display user-specified - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 667
" for details. The Fabric OS port configuration commands are not supported on FcoE ports. Use fcoe --cfg to configure FCoE ports. Virtual FC Ports do not support frame-based trunking . If trunking is enabled for one of these ports in a slot, and a Brocade FX-24 Extension blade is inserted - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 668
negotiated values are what the edge switch specifies in the ELP request. If the state is "Not OK", R_A_TOV and E_D_TOV display "Not Applicable". By default, all VEX_Ports are auto-ELP enabled. If the Fabric Parameter attribute value is "User configured", port ID format, R_A_TOV, and E_D_TOV display - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 669
interoperability modes with the interopMode command. Examples To display the VEX_Port configuration of port 2/16: switch:admin> portcfgvexport 2/16 Port 2/16 Admin: State: Pid format: Edge Fabric ID: Front Domain ID: info enabled OK core(N) 16 160 Fabric OS Command Reference 639 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 670
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> portcfgvexport 2/20 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 671
the default number 24 and 7800 only. VLAN tagging Brocade FR4-18i and 7500 only. ipperf Brocade FR4-18i and 7500 only. IPv6 Brocade FR4-18i and 7500 only. End-to-end path characterization is not supported if there exists an IPSec-enabled tunnel using the same source/local IP address. Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 672
63. The default value is 0. This operand is optional. -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 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 673
2 -c L2 Class-of-Service Specifies Class of Service/Priority, as defined by IEEE 802.1p. Valid values are 0 to 7. The default is 0. This operand is optional with the -v option --ping Pings a destination IP address from one of the source IP interfaces on the GbE port. Valid arguments include - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 674
application. See the portCfg help page for details on creating a VLAN tag table. This option is currently not supported on the Brocade 7800 and FX-24. -c L2 Class-of-Service Specifies Class of Service/Priority, as defined by the IEEE 802.1p specification. Values must be in the range of 0 to 7. The - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 675
Number of protocol data units transmitted. PDUs rx Number of protocol data units received. bad CRC headers rx Number of bad CRC headers received. bad CRC payloads rx Number of bad CRC payloads received. out of seq PDUs rx Number default is This is the default value. 1 The default is equivalent - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 676
the checksum is checked by the sink: switch:admin> portcmd --tperf 16 -source -size 400 -crc -pattern 5 TPerf has been configured successfully for 16 TPerf is generating traffic on 16 priority: high TPerf is generating traffic on 16 priority: medium 646 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 677
settings saved in memory: switch: admin> portcmd --tperf 16 -source -high -low -random TPerf has been configured successfully for 16 TPerf is of seq PDUs rx 0 0 0 flow control count 0 0 0 last rtt N/A N/A N/A portCfg, portShow Fabric OS Command Reference 647 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 678
level to be set for port modules; valid values are 1 to 5. vbs_lvl Specify the verbose level to be set for port modules; valid values are 1 to 5. Examples To set debug level and verbose level of port modules: switch:admin> portdebug 3 4 See Also dbgShow 648 Fabric OS Command Reference 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 679
ports to be disabled. Port index ranges are supported only if PortSwap is disabled. Examples To disable a single port: switch:admin> portdisable 2/4 To disable a range of ports: switch:admin> portdisable 2/4-8 To disable multiple port ranges: switch:admin> portdisable 2/24-26 3/10-12 4/3-4 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 680
of ports by specifying the corresponding port index range: switch:admin> portdisable 170-176 To disable multiple ports by specifying multiple port index ranges: switch:admin> portdisable 30-36 170-176 portCfgPersistentDisable, portCfgPersistentEnable, portEnable, portShow, switchShow 650 Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 681
index number or a range of index numbers (index1-index2) for the ports to be enabled. Examples To enable a single port: switch:admin> portenable 2/4 To enable a range of ports: switch:admin> portenable 2/4-8 To enable multiple port ranges: switch:admin> portenable 2/24-26 3/10-12 4/3-4 Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 682
portenable: portSwap feature enabled. To enable multiple ports by specifying multiple port index ranges: switch:admin> portenable 30-36 170-176 portenable: portSwap feature enabled. portCfgPersistentDisable, portCfgPersistentEnable, portDisable, portShow, switchShow 652 Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 683
end Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To display error counters for ports on a switch: switch 0 0 0 0 0 0 0 0 4 0 0 5: 0 0 0 0 0 0 0 0 0 0 0 0 4 0 0 6: 0 0 0 0 0 0 0 0 0 0 0 0 4 0 0 7: 1.6k 24 0 0 0 0 0 0 11 0 0 4 8 0 0 Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 684
0 0 0 0 0 0 0 0 0 0 0 0 4 0 0 15: 0 0 0 0 0 0 0 0 0 0 0 0 4 0 0 16: 0 0 0 0 0 0 0 0 0 0 0 0 4 0 0 17: 0 0 0 0 0 0 0 0 0 0 0 0 4 0 0 18: 0 0 0 0 0 0 0 0 0 0 0 0 4 0 0 19: 0 0 0 0 0 0 0 0 0 0 0 0 4 0 0 (output truncated) See Also portShow, portStatsShow 654 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 685
Use this command to enable error reporting for the Fabric Watch port fencing feature on all ports of a specified type and to configure the ports to report errors for a certain Fabric Watch area. Supported port types include E_Ports, F_Ports, and physical ports. A specified port type can be - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 686
: switch:admin> portFencing --enable e-port -area_type CRC To display the current port fencing configuration: switch:admin> portFencing --show Port type Error PF Status e-port CRC Enabled ITW Disabled Link reset Disabled C3_TO Disabled See Also fwConfigure, fwHelp 656 Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 687
may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the port status for all ports in the switch: switch:user> portflagsshow Slot Port SNMP Physical Flags 1 0 Online In_Sync PRESENT ACTIVE - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 688
has the following operands: -npass count Specify the number of times to perform this test. The default value is 10. -ports itemlist Specify a list of user ports on which to run the test. If omitted, all the active ports in the switch are assumed. For more information, refer to the itemList - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 689
the port log is disabled, portLogClear enables it. The port log Fabric OS commands" and Appendix A, "Command Availability" for details. Operands None Examples To clear the port log: switch:admin> portlogclear switch:admin> portlogshow port log is empty See Also portLogDump, portLogShow Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 690
restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the current port log configuration: switch:admin> portlogconfigshow max portlog entries = 16384 See Also portLogResize 660 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 691
restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the port log facility: switch:admin> portlogdisable See Also portLogEnable Fabric OS Command Reference 661 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 692
is optional. portid Specifies the port for which to display the log. If a port is not specified, the command displays the port logs for all ports. This operand is optional. Examples To display the port log for a port: switch:user> portlogdump 20 time task event port cmd args 08:35:27 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 693
1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operand: portid Specifies the port index number for which to display the port log. Examples To display the port log dump for a port: switch:user> portlogdumpport 14 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 694
restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To enable the port log facility: switch:admin> portlogenable See Also portLogDisable 664 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 695
to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To display information about port log events: switch:admin> portlogeventshow ID Event-Name Disabled 1 start 0 2 disable 0 3 enable 0 4 ioctl 0 5 Tx 0 6 Tx1 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 696
24-bit Port ID of the attached device. WorldWideName The port's world wide name. credit The credit for this login as appropriate. This is BB (buffer-to-buffer) credit for Flogs and EE (end-to-end) credit for PLOGIs. df_sz The default frame size for this login. cos Class of Services supported - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 697
set or clear the debug_pdisc_flag. This command is part of the environmental monitor. A setting of 1 enables logging of Port Discovery parameters. The PDISC log is disabled by default. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 698
of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To enable the port log: switch:admin> portlogreset See Also none 668 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 699
Use this command to resize the port log to include a specified number of entries. If the specified number of entries is less than the already configured port log size, there is no change. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 700
Event Displays the task event that generated the log entry. Possible events include: start A switch start or re-start event. disable A port is disabled. enable A port is enabled. ioctl A port I/O control is executed. Tx A frame is transmitted (class is indicated). Rx A frame is received - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 701
nsRemQ rscn xalloc xfree xerr xstate payload Port Cmd ioctl Tx & Rx scn pstate ctin fc f8 ctout errlog loopscn OLP LIP LIM BMP OLD TMO Args start disable enable Indicates an incoming Fibre Channel information unit. Indicates an outgoing Fibre Channel information unit. Indicates an information unit - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 702
is valid, 0003 means arguments 1 and 2 are valid). [B] the CT-based service command code. Argument 1 is the first word of the CT payload, if 94 F0F0ARB(F0) timeout. 40 CLS timeout. Codes used in various fields are as follows: state 1 Online 672 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 703
reason 8001 Retry loop init. 8002 Start loop after gaining sync. 8003 Restart loop after port reset. 8004 LIP when a loop hangs. 8005 Restart loop if LIP received when sending out signal. NF Negotiation follows. NC Negotiation complete. Fabric OS Command Reference 673 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 704
the saved log is displayed. This operand is optional. Examples To view the port log for a port: switch:user> portlogshow 24 time task event port cmd args 17:05:30.384 PORT Rx 0 40 02fffffd,00fffffd,08fbffff,14000000 17:05:30.384 PORT Tx 0 0 c0fffffd,00fffffd,08fb0e02 17:05:30.384 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 705
chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operands: portid Specifies the number of the port for which to display the log. Examples To display the port log for port 14: switch:user> portlogshowport 14 time - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 706
be disabled. Use portLogEventShow for a listing of values corresponding to supported log types. Examples To disable logging of type 2 port log events: switch:admin> portlogtyedisable 2 See Also portLogDisable, portLogEventShow, portLogTypeEnable 676 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 707
corresponds to the port log type to be enabled. Use portLogEventShow for a listing of values corresponding to supported log types. Examples To enable logging of type 2 port log events: switch:admin> portlogtypeenable 2 See Also portLogEventShow, portLogTypeDisable Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 708
ports itemlist] ceeportloopbacktest [--slot number][-nframes count][-lb_mode mode][-spd_mode mode] [-ports itemlist] Description Use this command to verify the functional operation of the switch This command does not support High Availability (HA). 678 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 709
to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. 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 0 and - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 710
were found in the ASIC statistics. Port failed to initialize. A previously initialized port went to an uninitialized state. Errors were found in the ASIC statistics. Did not receive a frame in the given timeout period. Frame transmission failure. 680 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 711
connections, depending on the switch configuration and switch model associated with the SourceID. GoldenEye2-based platforms (including the Brocade 300, 5300, and most embedded switches) can participate only in one mirror connection if Virtual Fabrics are enabled on the switch. If Virtual platforms - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 712
on all platforms. Refer to the Fabric OS Administrator's Guide for more information. In Fabric OS v6.3.0 and later, the port mirroring feature is supported in Virtual Fabric mode so long as the FC Routing service is not enabled on the logical switch. Use the fosConfig command to disable the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 713
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 SID DID State 10/12 0x791800 0x791900 Defined 10/15 0x791a00 0x799300 Enabled portCfgShow Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 714
chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operands: slotnumber For bladed systems only, specify the slot number of the port to be configured, followed by a slash (/). portnumber Specify a port number to be - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 715
seconds, between each sample. Default is one second. -tx Displays the transmitter bandwidth. -rx Displays the receiver bandwidth. -tx -rx Displays the transmitter and receiver bandwidth. Examples To display port throughput for a switch: switch:user> portperfshow 20 0 1 2 3 4 5 6 7 8 9 10 11 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 716
00 00 24 25 26 27 28 29 30 31 00 00 00 00 4.00 4.00 00 00 00 00 2.00 2.00 00 00 2.00 2.00 switch:user> portperfshow 23 24 25 26 27 28 29 30 31 00 00 00 00 00 00 00 00 00 00 4.00 00 00 2.00 00 2.00 switch:user> portperfshow 00 00 00 00 00 00 00 00 00 24 25 26 27 28 29 30 31 00 00 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 717
, this table typically has only Bit 16 set (value 0x10000), indicating this port always routes broadcast frames to the embedded port, for handling by the firmware. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 718
: 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 bcastShow, fabricShow, switchShow, topologyShow, uRouteShow 688 Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 719
FCIP-related port configuration parameters specific to the Brocade 7800/FX8-24 and the Brocade 7500/7500E/FR-18i platforms. This command has been modified to support the display of FCIP tunnels on the Brocade 7800 and FX8-24 platforms. As a result, the behavior of this command in Fabric OS v6 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 720
port without additional arguments: portName Name assigned to the port by the portName command. portHealth Current health of the port (requires a Fabric whether logins have been accepted. portType The port's type and revision numbers. portState The port's SNMP state: Online Up and running. - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 721
. portId The port's 24-bit port ID. portIfId The user port's interface ID. portWwn The port's world wide name. portWwn of devices(s) connected The World Wide Port Names of connected devices. Distance The port's long-distance level. In the case of LD mode, the user configured distance and - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 722
2 portShow Edge fabric's version stamp If the EX_PORT is connected to an edge switch with FCS policy enforcement, the version of the security database is displayed. Otherwise displays N/A. The portShow command displays FCoE ports with "Protocol: FCoE" and "portSpeed: 10Gbps". Only a subset of - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 723
Ols_in: 0 2_parity_err: 0 Ols_out: 4 CMI_bus_err: 0 Port part of other ADs: No switch:admin> To display the state of a VE_Port on a chassis with an FX8-24 Extension blade: switch:admin> portshow 16 portName: portHealth: No Fabric Watch License Authentication: None portDisableReason: None - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 724
Port Speed: 1G To view xlate domains, you must issue the command on a Brocade 7500/7500E or a chassis with an FR4-18i blade. Note that the Front Domain ID is what is shown: switch:admin> portshow 8/4 portName: portHealth: No Fabric Watch License Authentication: None EX_Port Mode: Enabled Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 725
: 6 In_Sync portScn: 32 F_Port port generation number: 0 portId: 036100 portIfId: 43b20029 portWwn: 20:61:00:05:1e:40:34:00 portWwn of device(s) connected: Distance: normal portSpeed: 10Gbps Function Syntax Port display commands supported on the Brocade 7800/FX8-24 and on the Brocade 7500 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 726
the Brocade 7500/7500E and FR4-18i. Examples To display the IP Interface and static route configured on a chassis with a Brocade FX8-24 Extension blade: switch:admin> portshow ipif 11/ge1 Slot: 11 Port: ge1 Interface IP Address NetMask Effective MTU Flags 0 10.10.11.200 255.0.0.0 1500 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 727
the IP Interfaces and static routes configured on a chassis with an FR4-18i FC Router blade: switch:admin> portshow ipif 10/ge0 Interface IP Address Interface IP Address NetMask MTU Flags 7 192.168.60.107 255.255.255.0 2200 32833 switch:admin> portshow iproute ge0 Port: ge0 IP Address - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 728
ports act as Virtual E_Ports (VE_Ports) connecting the local and remote fabrics. The following display options are supported on these platforms: • portShow fciptunnel - Displays Fibre Channel over IP (FCIP) tunnels including the following: - Additional performance information - FICON configuration - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 729
on one of the GbE ports. VE_Ports are numbered 16-23 on the Brocade 7800 and 12 - 31 on theBrocade FX8-24 blade. Displays information for all configured FCIP tunnels. fciptunnel Displays configuration and status per FCIP tunnel. The following operands are supported with fciptunnel and fcipcircuit - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 730
default display. Displays general FCP emulation information. Displays the FCP emulation configuration commands are supported with - ports or a specific FICON Device Path Block. -fchb adrs Displays FICON logical partitions (LPARs) or a specific FICON Channel Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 731
option is supported. -clear Resets the specified statistics configuration parameters on the Brocade 7800: switch:admin> portshow fciptunnel 16 Tunnel ID: 16 Tunnel Description: Admin Status: Enabled Base: 0x8000 FICON Debug Flags: 0xf7c80000 Fabric OS Command Reference 701 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 732
: Disabled Remote WWN: Not Configured Local WWN: 10:00:00:05:1e:55:59:e9 Peer WWN: 10:00:00:05:1e:55:68:05 Circuit Count: 4 Flags: 0x00000000 FICON: Off Circuit ID: 17.0 Circuit Num: 0 Admin Status: Enabled Oper Status: Up Remote IP: 100.83.0.100 Local IP: 100.80.0.100 Metric: 0 Min Comm - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 733
Path MTU Disc: 0 VLAN ID: 0 L2CoS: F: 0 H: 0 M: 0 L: 0 DSCP: F: 0 H: 0 M: 0 L: 0 Flags: 0x00000000 Circuit ID: 17.2 Circuit Num: 2 Admin Status: Enabled Oper Status: Up Remote IP: 100.83.0.102 Local IP: 100.80.0.102 Metric: 0 Min Comm Rt: 150000 Max Comm Rt: 150000 SACK: On Min Retrans Time: 100 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 734
for the circuits on the tunnel: switch:admin>portshow fciptunnel 17 -c --tcp Tunnel ID: 17 Tunnel Description: Admin Status: Enabled Oper Status: Up Compression: On (Moderate) Fastwrite: Off Tape Acceleration: Off TPerf Option: Off IPSec: Disabled Remote WWN: Not Configured Local WWN: 10:00:00:05 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 735
Admin Status: Enabled Oper Status: Up Remote IP: 101.83.0.110 Local IP: 101.80.0.110 Metric: Flags: 0x00000000 Duration: 7 hours, 9 minutes, 50 seconds Local Port: 3225 Remote Port: 49366 Max Seg Size: 1460 Adaptive Rate Limiting Statistics: Min Rate ) Fabric OS Command Reference 705 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 736
TCP Conn 17.0:68740705 To display all FCIP circuits on the Brocade 7800: switch:admin> portshow fcipcircuit all Tunnel Circuit OpStatus Flags Uptime TxMBps RxMBps ConnCnt CommRt 3 150/150 0 20 1 ge4 Up ----s 7h35m7s 0.00 0.00 3 150/150 0 706 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 737
switch:admin> portshow fcipcircuit 20 1 Circuit ID: 20.1 Circuit Num: 1 Admin Status: Enabled Oper Status: Up Remote IP: 104.83.0.141 Local IP: 104.80 Circuit Duration: 7 hours, 40 minutes, 51 seconds Performance Statistics: Overall Throughput 82900 Output Bytes Fabric OS Command Reference 707 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 738
a circuit: switch:admin> portshow fcipcircuit 20 1 --perf --qos Circuit ID: 20.1 Circuit Num: 1 Admin Status: Enabled Oper Status: Up Remote IP: 104.83.0.141 Local IP: 104.80.0.141 Metric: 0 pkt/s Lifetime Avg Performance Statistics - Priority: Low 708 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 739
stats To display FCP emulation statistics, information, and configuration information using the command with a single levels and three commands: switch:admin> portshow xtun 1/13 fcp -itl - in write pipe = 0 Largest write chain processed = 4128769 Fabric OS Command Reference 709 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 740
Blocks (all blocks and a specified block): switch:admin> portshow xtun 16 -ficon -fchb FCHB (FICON CHannel Block - one per LPAR) Count = 2 (0x) Side Path: CU Count Emul ChTIN CuTIN 041055D680 D 0x106301640100**** 0x0001 0x0000 0x0000 710 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 741
on the Brocade 7500/7500E FC Router switch and on the FR4-18i FC Router blade. The following display options are supported only on these platforms: • portShow fciptunnel - Displays Fibre Channel over IP (FCIP) tunnel configuration settings including the following: - Additional performance parameters - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 742
since the system was last reset. The TCIP statistics include the following information: Tunnel Num The tunnel number associated with this TCP connection Connection The type of TCP connection (CONTROL or DATA) LPort Local port RPort Remote port 712 Fabric OS Command Reference 53-1001337 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 743
allows the Brocade switch to communicate with number of times the pending frames queue was full. FCIP Smoothed RTT The WAN RTT perceived in FCIP smoothed over the last 8 samples. FCIP RTT Variance Variance in RTT perceived in FCIP. Operands This command supports the following operands: Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 744
ends when the -snapshow option is executed. -snapshow Displays the TCP statistics that were collected since startup or since the statistics were reset with the -snapshow command. iscsi Displays GbE port WWN and ISCSI Sessions. mode Displays mode of GbE port as either "FCIP" or "not configured - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 745
. Displays the status of the inband management configuration and IP addresses configured to enable inband management on the Brocade 7500 through GbE port interfaces. This command requires a port to be specified and displays the IP addresses for that port. In addition the output shows whether inband - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 746
Configured TCP Byte Streaming on Status : Inactive Connected Count: 0 Port: ge1 Tunnel ID 0 Tunnel Description "This is a test Description of this tunnel" Remote IP Addr 192.168.10.10 Local IP Addr 192.168.10.2 Remote WWN Not Configured 1460 Bytes 716 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 747
switch:admin> portshow fciptunnel 9/ge0 0 -perf Slot: 9 Port: ge0 Tunnel ID 0 Tunnel Description "This is a test Description of this tunnel" Remote IP Addr 10.62.0.100 Local IP Addr 10.10.9.100 Remote WWN Not Configured 30s avg, 5 pkt/s lifetime avg Fabric OS Command Reference 717 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 748
port: switch:admin> portshow fciptunnel 9/ge0 0 -ipsec Slot: 9 Port: ge0 Tunnel ID 0 Tunnel Description "This is a test Description of this tunnel" Remote IP Addr 10.62.0.100 Local IP Addr 10.10.9.100 Remote WWN Not Configured SA Life (seconds): 28800 718 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 749
(Control): 0, DSCP Marking (Data): 0 VLAN Tagging Not Configured TCP Byte Streaming on Status : Active Connected Count: 2 Switch:admin> portshow fciptunnel ge1 0 -snapshow Port: ge1 Tunnel ID 0 Tunnel Description "This is a test Description of this tunnel" Remote IP Addr 192.168.114.2 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 750
0 0 1 0 0 0| To reset the TCIP statistics: Switch:admin> portshow fciptunnel ge1 0 -snapstart Port: ge1 Tunnel ID 0 Tunnel Description "This is a test Description of this tunnel" Remote IP Addr 192.168.114.2 Local IP Addr 192.168.114.1 Remote WWN Not Configured Local WWN 10:00:00:05:1e - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 751
been reset for tunnel 0 To display the FC data path credit data: switch:admin> portshow fciptunnel 9/ge0 0 -credits Slot: 9 Port: ge0 Tunnel ID 0 Tunnel Description "This is a test Description of this tunnel" Remote IP Addr 10.62.0.100 Local IP Addr 10.10.9.100 Remote WWN Not Configured - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 752
47 4 12 51 4 13 55 4 14 59 4 15 63 0 To display Byte Streaming parameters: switch:admin> portshow fciptunnel ge1 0 -bstr Port: ge1 Tunnel ID 0 Remote IP Addr 192.168.32.2 Local IP Addr 192.168.32.1 Remote WWN Not Configured Local WWN 10:00:00:05:1e:41:2f:2e Compression off Fastwrite on Tape - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 753
interfaces configured on the Brocade 7500: switch:admin> portshow inbandmgmt ge1 Port: ge1 Inband Management: Enabled CP Interface IP Address NetMask MTU 0 192.168.255.1 255.255.255.252 1500 GE Interface IP Address NetMask MTU 0 192.168.255.2 255.255.255.252 1500 Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 754
See Also To display the routes that use internal management interfaces. switch:admin> portshow iproute ge1 Port: ge1 IP Address Mask Gateway Metric 192.168.112.0 255.255.255.0 portCfg, portCfgLongDistance, portLoginShow, portName, switchShow 724 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 755
Number of frames with CRC errors. er64_trunc Number of frames shorter than minimum. er64_toolong Number of frames longer than maximum. er_bad_eof Number of frames with bad end-of-frame. er64_enc_out Number Tx peak Byte rate (Bps). Fabric OS Command Reference 725 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 756
. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. This command is not supported on FCoE ports. Operands This command has the following operands: slotnumber For bladed systems only, specify the slot number of the port to be displayed, followed by - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 757
than maximum er_bad_eof 0 top_int : Frames with bad end-of-frame 0 bottom_int : Frames with bad end-of-frame er64_enc_out 0 top_int : Encoding error outside transmitted 0 bottom_int : 4-byte words transmitted portStatsClear, portStatsShow Fabric OS Command Reference 727 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 758
a slash (/). port Specify a port number to be cleared, relative to its slot for bladed systems. Use switchShow to display a list of valid ports. Examples To clear hardware statistics for a port: switch:admin> portstatsclear 4/15 See Also portStats64Show, portStatsShow 728 Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 759
degraded performance (platform- and port-specific). er_enc_in The number of encoding errors inside frames. er_crc The number of frames with cyclic redundancy check (CRC) errors. er_trunc The number of frames shorter than the minimum frame length. Fabric OS Command Reference 729 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 760
on the GbE port. ge_stat_tx_mcast_frms The number of multicast frames transmitted on the GbE port. ge_stat_tx_bcast_frms The number of broadcast frames transmitted on the GbE port. ge_stat_tx_vlan_frms The number of VLAN frames transmitted on the GbE port. 730 Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 761
. Use switchShow to display a list of valid ports. ge Displays the GbE port statistics. ip Displays all GbE port statistics related to IP addresses that are on (not zero). This operand is not supported on the Brocade 7800 and FX8-24 platforms. Fabric OS Command Reference 731 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 762
. This operand is not supported on the Brocade 7800 and FX8-24 platforms. Optionally specifies a tunnel ID to display statistics only for the specified FCIP tunnel. Examples To display the basic set of statistics for port 13 on a DCX backbone: switch:admin> portstatsshow 13 stat_wtx 1979747673 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 763
8, and GbE port 1: switch:admin> portstatsshow ip 8/ge1 ip_err_crc ip_err_hdr_cksum ip_err_tcp_data_chksum 0 IP CRC Errors 0 IP Checksum Errors 0 IP TCP Data Checksum Errors To display port statistics for IP address 192.168.255.10, slot 8, and GbE port 1: switch:admin> portstatsshow ip 8/ge1 192 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 764
display port statistics for a VE_Port with an active FCIP tunnel on a Brocade 7800 Extension switch: switch:admin> end-of-frame Class 3 frames discarded due to timeout Class 3 frames discarded due to destination unreachable Other discards Crc error with good eof portErrShow, portShow 734 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 765
, relative to its slot for bladed systems. Examples To swap area numbers between a pair of ports: switch:admin> portswap 1/3 2/5 portswap done See Also portDisable, portEnable, portShow, portSwapDisable, portSwapEnable, portSwapShow, switchShow Fabric OS Command Reference 735 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 766
of the portswap feature is persistent across reboots and power cycles. Enabling or disabling the portswap feature does not affect previously performed portswap operations. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 767
Domain restrictions that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To enable the portswap feature: switch:admin> portswapenable See Also portSwap, portDisable, portEnable, portShow, portSwapDisable - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 768
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. Note The execution of this command is subject to Virtual Fabric or Admin - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 769
that are enabled for Virtual Fabrics, this test can only be executed from the default switch. Ports that are not on the default switch cannot be tested. Valid port connections for this test are: • From the default switch to legacy switches that do not support Virtual Fabrics. Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 770
the default switch to a switch that supports Virtual Fabrics but has the VF feature disabled. To ensure coverage of all ports, it is recommended that you run portTest before enabling Virtual Fabrics on the switch. It is recommended that you run portTest before you configure the logical switches or - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 771
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operand: -ports itemlist Specify a list of user ports to test. By default, all user ports in the current slot is assumed. Refer to the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 772
port_type -area area [-thresh_level default | custom] [-alarm_level default| custom] portthconfig --apply ve-port -area ve_port area [-thresh_level default | custom] [-alarm_level default| custom] portthconfig --help Use this command to configure thresholds for Fabric Watch event monitoring for all - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 773
2 For more information on port threshold configuration procedures, including default values for specific area high/low thresholds, refer to the Fabric Watch Administrator's Guide. Operands This command has the following operands: --set Configures the Fabric Watch thresholds for monitoring - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 774
Fabric Watch, or for all port types and areas. The output includes PortType, Area, Port number, Circuit ID (for the Brocade 7800 and FS8-24 only), Value, and State. The State field reports whether the current value is above, in range, or below (info) the configured threshold. -thresh_level default - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 775
port type and area. -thresh_level default | custom Instructs Fabric Watch to use the default or custom threshold configuration for the specified port type and area. --help Displays the command usage. Examples To set custom thresholds for the port class and CRC area with E-mail alerts: switch - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 776
To display the port threshold configuration for all port types and areas: switch:admin> portthconfig --show PortType: E-port Area : CRC ThLevel : Def ActLevel: Def High : Custom: TimeBase: Minute Value : 1000 Trigger : Above Action: None Trigger : Below Action: None Default: TimeBase: Minute Value - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 777
: Below Action: None Default: TimeBase: Minute Value : 0 Trigger : Above Action: None Trigger : Below Action: None (output truncated) To display threshold configuration and current status for E_Port CRC errors: Switch:admin> portthconfig --show e-port -area crc PortType: E-port Area : CRC ThLevel - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 778
Buffer: Custom: Value : 100 Default: Value : 100 To display current values for all port types and areas: Switch:admin> portthConfig --show -current PortType|Area |PortNo|C# |Value |State E-port |CRC |000005|n/a |0 |Info E-port |CRC |000007|n/a |0 |Info E-port |CRC |000032|n/a |0 |Info - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 779
|CRC |000022|n/a |0 |Info To display current values for CRC errors on all Fop-ports: switch:admin> portthconfig --show fop-port -area CRC -current PortType|Area |PortNo|C# |Value |State FOP-port|CRC |000019|n/a |0 |Info fwHelp, fwConfigure Fabric OS Command Reference 749 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 780
Trunk Master, Slave, or --. Master Displays the master port of the trunk group. TA On standalone switches, displays the user assigned TA number. DA On standalone switches, displays the default port area. The default area can be a port swapped area. TI On enterprise-class platforms, displays - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 781
I zones referring to these indices are no longer part of the switch. For details and workarounds, refer to the Fabric OS Administrator's Guide. 13. Device Connection Control (DCC) Policy must be removed from ports prior to creating a TA. You can re-enable DCC policy after creating the TA. 14. You - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 782
which masterless F_Port trunking is enabled). disabled Displays configuration details for all ports not included in a user assigned TA (all portson which masterless F_Port trunking is notenabled). all Displays configuration details for all ports on a switch. 752 Fabric OS Command Reference 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 783
Proto [...] 11 10 030b00 id N4 No_Light FC 11 11 030b00 id N4 No_Light FC [...] 5. Display TA-enabled port configuration: switch:admin> porttrunkarea --show enabled Port Type State Master TA DA 10 -- -- -- 11 10 11 -- -- -- 11 11 To disable masterless F_Port trunking on - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 784
the TA port configuration after enabling the ports: switch:admin> porttrunkarea --show enabled Slot Port Type State Master TI DI 10 13 F-port Master 10/13 125 125 10 14 F-port Slave 10/13 125 126 portCfgTrunkPort, portCfgShow, portShow, switchCfgTrunk, switchShow 754 Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 785
a switch. Output shows virtual port number (decimal), physical port number (decimal), online status, and if online, port type. If the current zone configuration has been disabled by cfgDisable, the fabric is in non-zoning mode, in which all devices see each other. When default zoning is enabled with - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 786
Whenever a power supply goes out of service or a field-replaceable unit (FRU) board processors to cease executing the firmware. For example, if only one power Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To modify the power-off list order: switch - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 787
10 1 1st 9 2 2nd 8 3 3rd 7 4 4th 4 10 5th 3 9 6th 2 8 7th 1 7 8th Proceed to change the POL order? (yes, y, no, n): [no] y chassisShow, powerOffListShow, psShow, slotPowerOff, slotPowerOn, slotShow Fabric OS Command Reference 757 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 788
a power supply goes out of service or a field-replaceable unit (FRU CP board processors to cease executing the firmware. For example, if only one power Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the slot power off list order: switch - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 789
installed. predicting failure Power supply is present but predicting failure. faulty Power supply present but faulty (no power cable, power switch Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To view the status of the power supplies: switch: - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 790
. Synopsis reboot [-f] Description When this command is issued on a switch connected to a fabric, all traffic to and from that switch stops. All Fibre Channel ports on that switch including E_Ports become inactive until the switch comes online. This command prompts for confirmation with a warning - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 791
Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To display a list of routing-related commands: switch FSPF (TM) neighbors' states Reset the FSPF (TM) interface counters Display the unicast fabric topology Configure a static route Remove a static - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 792
-capable, the security database is limited to 1 megabyte. For switches running earlier versions of Fabric OS (up to v5.3.0), the maximum size is 256 Kilobytes. Notes The effective security DB size is the lowest supported by the fabric. The presence of a Standby CP that runs an earlier version - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 793
. If switch is configured to do DH-CHAP, it is performed whenever a port or a switch is enabled. Warning: Please use a secure channel for setting secrets. Using an insecure channel is not safe and may compromise secrets. Following inputs should be specified for each entry. Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 794
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: Re-enter peer secret: -CHAP secret keys. If a fabric requires authentication, deleting this database may cause switch to segment from the fabric. Do want to remove secret - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 795
] [-enable https]] [-protocol ftp | scp] [-ipaddr IP address] [-remotedir remote directory ] [-certname certificate name] [-login login name] [-password password] seccertutil show [-ldapcacert] | [file name] Description Use this command to manage third-party certificates on a switch, including - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 796
a file named ip_address.csr, where ip_address is the IP address of the switch. -country country code Specifies the country. Provide a -locality locality Specifies the city. Provide the full name, for example, "San Jose". If the locality consists of multiple Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 797
IP address Specifies the IP address of the remote host. -remotedir remote directory Specifies the remote directory. Provide a fully qualified path name. -login login name Specifies the login name for the server. -password password Specifies the password for the user switch enable https Enables - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 798
name for the server. -password password Specifies the password for the user account. When using SCP, for security reasons, do not enter a password on the command line. Use the interactive version instead. show Lists all existing PKI-based certificates on the switch. The following operands are - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 799
. To import a PKI-based certificate with configure and enable option in non-interactive mode: switch:admin> seccertutil import -config swcert -enable https -protocol ftp \ -ipaddr 195.168.38.206 -remotedir /users/home/remote_certs -certname file.crt \ -login abcd -password passwd Success: imported - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 800
show -ldapcacert List of ldap ca certificate files: Sample.cer To display the content of the CSR one page at a time: switch:admin> seccertutil showcsr | more To display the content of a certificate: switch:admin> seccertutil show certificate_name none 770 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 801
, the security database is limited to 1 Megabyte. For switches running earlier versions of Fabric OS (up to v5.3.0), the maximum size is 256 Kilobytes. The effective security DB size is the lowest supported by the fabric. The presence of a Standby CP that runs an earlier version of the operating - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 802
The latest RCS STATUS---RCS was enabled sec_aca: free RCS latest Phase: Completion RCS Message ==> RCS transaction completes. ----DataBase STATUS---Retry Role 0 Retry Qeury0 Security Active DataSize 35 bytes -----Domain State----- Active Sum 215b 772 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 803
Security Defined DataSize 35 bytes Define Sum 215b Zone Size (include enabled configuration) 312 bytes Zone sum e04b215b sec_db: free primaryDLPhase 0 ----wwnDL secProcessIPChange acks completion [Output truncated] secActiveSize, secDefineSize Fabric OS Command Reference 773 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 804
secpolicysave secpolicyshow secstatsreset secstatsshow Configure FIPS mode operation Creates public policy set and sends to all switches Shows members of one or more policies Resets security statistics Displays security statistics See Also none 774 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 805
policy creation and modification operations from all the switches if a fabric-wide consistency policy is not set for the particular policy. Notes When an FCS policy is enabled, this command can be issued only from the Primary FCS switch. Only the user who made the changes to the defined database - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 806
Policy Sets. Notes The behavior of this command is the same for tolerant and strict fabric-wide consistency. When an FCS policy is enabled, this command can be issued only from the Primary FCS switch. Any modifications to the SCC, DCC, and FCC DB are saved and activated. When secPolicyActivate - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 807
DCC, SCC and FCS remains unchanged in Fabric OS v6.2.0 and can be configured on a per logical switch basis. Notes When an FCS policy is enabled, this command can be issued only from the Primary FCS switch. The secpolicyadd command can be issued on all switches for SCC and DCC policies as long as - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 808
all devices attached to those ports. [*] Selects all ports on the switch and devices currently attached to those ports. Examples To add a member to the SCC_POLICY using the device WWN: primaryfcs:admin> secpolicyadd "SCC_POLICY", "12:24:45:10:0a:67:00:40" Member(s) have been added to SCC_POLICY - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 809
. Automatic policy distribution behavior for DCC, SCC and FCS remains unchanged in Fabric OS v6.2.0 and can be configured on a logical switch basis. Notes When an FCS policy is enabled, this command can be issued only from the Primary FCS switch. The execution of this command is subject to Virtual - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 810
DCC_POLICY does not stop access to the switch. The device is specified by its port WWN. The switch and port combination must be in the switch port format switch can be specified using a WWN, domain, or switch name. port can be specified by port numbers separated by commas and enclosed in either - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 811
. To create a SCC policy in a Fabric with three switches: 1. Check if a policy exists. switch:admin> secpolicyshow ACTIVE POLICY SET DEFINED POLICY SET 2. Identify switches in the fabric. switch:admin> fabricshow Switch ID Worldwide Name Enet IP Addr FC IP Addr Name 2: fffc02 10:00:00 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 812
enabled, this command can be issued only from the Primary FCS switch. The execution of this command is subject to Virtual Fabric ports are removed from a logical switch. SCC_POLICY Deletes the Switch Connection Control policy from the defined policy list. FCS_POLICY Deletes the Fabric Configuration - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 813
See Also To delete all stale DCC policies in the fabric: primaryfcs:admin> secpolicydelete ALL_STALE_DCC_POLICY About to clear all STALE , secPolicyActivate, secPolicyAdd, secPolicyCreate, secPolicyDump, secPolicyRemove, secPolicySave, secPolicyShow Fabric OS Command Reference 783 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 814
" for details. This command can be issued from all FCS switches in the fabric. Operands This command has the following optional operands: "listtype" name has the common prefix DCC_POLICY_ followed by a string of user-defined characters. These characters do not have to be capitalize. If - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 815
: switch:admin 4a - Unknown DCC_POLICY_h1 Type WWN DId swName Switch 10:00:00:05:1e:39:5f:67 all security policies in the defined database: switch:admin> secpolicydump "Defined" DEFINED POLICY SET 4a - Unknown DCC_POLICY_h1 Type WWN DId swName Switch 10:00:00:05:1e:39:5f:67 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 816
:1e:90:09:4a - Unknown To display the SCC policies in the defined database: switch:admin> secpolicydump "Defined","SCC_POLICY" DEFINED POLICY SET SCC_POLICY WWN DId swName 10:00:00: , secPolicyRemove, secPolicySave, secPolicyShow 786 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 817
position, it becomes the primary FCS after activation. An FCS policy most be enabled to execute this command, and the command must be issued from the primary FCS switch. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 818
, y, no, n): [no] y secpolicyactivate command was completed successfully. switch:admin> secpolicyshow ACTIVE POLICY SET FCS_POLICY Pos Primary WWN DId swName 1 Yes , secPolicyDump, secPolicyRemove, secPolicySave, secPolicyShow 788 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 819
devices associated with a specific switch and port combination. The device is specified with a WWN string. The switch and port combination must be specified in the switch port format where switch can be specified by switch WWN, domain, or switch name. The port Fabric OS Command Reference 789 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 820
all devices attached to those ports. [*] Selects all ports on the switch and devices currently attached to those ports. Examples To remove a member that has a WWN of 12:24:45:10:0a:67:00:40 from SCC policy: switch:admin> secpolicyremove "SCC_POLICY", "12:24:45:10:0a:67:00:40" Member(s) have been - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 821
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. A fabric-wide consistency configuration does not affect the behavior of this command. The execution of this command is subject to Virtual - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 822
switches. This command displays the policy database one page at a time. Use secPolicyDump to display the policy database without page breaks. Note The execution of this command is subject to Virtual Fabric prefix DCC_POLICY_ followed by a string of user-defined characters. These characters do not - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 823
WWN DId swName 1 Yes 10:00:00:60:69:30:15:5c 1 primaryfcs 2 No 10:00:00:60:69:30:1e:62 4 switch fddCfg, secPolicyAbort, secPolicyActivate, secPolicyAdd, secPolicyCreate, secPolicyDelete, secPolicyDump, secPolicyRemove, secPolicySave Fabric OS Command Reference 793 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 824
This command can be issued on any switch to reset the security statistics on the local switch or chassis. If an FCS policy is enabled and secStatsReset is issued on the primary FCS switch, this command can reset security statistics for any or all switches in the fabric. Note The execution of this - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 825
domain IDs on which to reset the security statistics. Specify an asterisk (*) to represent all switches in the fabric or specify a list of domains, separated by semicolons and enclosed in quotation marks. This option can only be executed when an FCS policy is enabled and when the command is issued - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 826
. This command can be issued on any switch to display local security statistics. If an FCS policy is enabled and secStatsShow is issued on the primary FCS switch, this command can retrieve and display the security statistics for any or all switches in the fabric. Note The execution of this command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 827
Specify an asterisk (*) in quotation marks to represent all switches in the fabric or specify a list of domains separated by semicolons. This option can only be executed when an FCS policy is enabled and the command is issued from the primary FCS switch. When domain is specified, the name operand is - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 828
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. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 829
display currently configured partitions and their FIDs. A logical switch context defines the boundaries within which a user can execute commands in a Virtual Fabric-aware environment. In a Virtual Fabric-aware environment, all commands are context-specific. When a user executes a switch-wide command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 830
. By default, no supported modules and their current debug levels are displayed by the command dbgShow. Note The execution of this command is subject to Virtual Fabric switch:admin> setdbg NS 3 switch:admin> dbgshow NS Module NS, debug level = 3, verbose level = 0 See Also dbgShow 800 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 831
CP modem serial port. When the CP is active and dial-in is enabled, the modem is configured to answer an Fabric OS commands" and Appendix A, "Command Availability" for details. This command is not supported on the Brocade DCX backbone. Operands The optional operands are as follows: -e Enables - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 832
serial console. By default, no debug messages are displayed. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions 3: switch:admin> setverbose NS 3 switch:admin> dbgshow NS Module NS, debug level = 0, verbose level = 3 See Also dbgShow, setDbg 802 Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 833
SFPs are replaced or removed while a port or a switch is disabled. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be specifies the slot number of the port to display, followed by a slash (/) portnumber Specifies the number of the port for which to - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 834
Port 0: -- GE: Port 1: cu (sw) Vendor: BROCADE Serial No: WAA107374000098 GE: Port 2: -- GE: Port 3: -- GE: Port 4: -- GE: Port 5: id To display detailed SFP information for a Finisar "smart" SFP: switch:user ) 67.0 uW 631.0 uW 79.0 uW 631.0 uW 804 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 835
sfpShow 2 To display detailed information for GbE port 0 on a Brocade 7500: switch:admin> sfpshow ge0 Identifier: 3 SFP Connector: 7 LC Transceiver: 050c402000000000 100,200_MB No: A00143427 Date Code: 020511 DD Type: 0x0 Enh Options: 0x0 Fabric OS Command Reference 805 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 836
2 sfpShow To display all SFP information: switch:user> sfpshow -all Port 0: Identifier: 3 SFP Connector: 7 LC Transceiver: 050c402000000000 100,200_MB/s M5,M6 sw 01062301 DD Type: 0x0 Enh Options: 0x0 (output truncated) switchShow 806 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 837
is disabled by default. Because this command changes the flow control on the console serial port, it must be executed from a session that is logged in from the console serial port. This command cannot run from a Telnet session. This setting is saved in the configuration database; therefore, it - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 838
to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands none Examples To enable flow control: switch:admin> shellflowcontrolenable Enabling flowcontrol flow control is now enabled See Also shellFlowControlDisable 808 Fabric OS Command Reference 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 839
: slotnumber Specify the slot number of the blade to be powered down. This operand is required. Examples To power off blade unit 3: switch:admin> slotpoweroff 3 Slot 3 is being powered off See Also powerOffListSet, powerOffListShow, slotPowerOn, slotShow Fabric OS Command Reference 809 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 840
This command has the following operand: slotnumber Specify the slot number of the blade to be powered on. This operand is required. Examples To power on blade unit 3: switch:admin> slotpoweron 3 Powering on slot 3. See Also slotPowerOff, slotShow 810 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 841
CP8 control processor blade 52 Core8 switch blade 37 FC8-16 port blade 55 FC8-32 port blade 51 FC8-48 port blade 55 FC8-32 port blade 74 FCoE10-24 port blade 75 FX8-24 port blade Status Displays the status of the blade as one of the following: Fabric OS Command Reference 811 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 842
the initial configuration. DIAG RUNNING Power efficiency in Watts/port and Watts/Gb. switch:user> slotshow Slot Blade Type ID Status 1 SW BLADE 51 FAULTY 2 SW BLADE 51 DISABLED 3 SW BLADE 55 ENABLED 4 SW BLADE 51 DIAG RUNNING POST2 5 CORE BLADE 52 ENABLED 812 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 843
: 9.91 watts per port, 2.48 watts per Gb To display Brocade model names for each blade in a Brocade DCX: switch:user> slotshow -m Slot Blade Type ID Model Name Status 1 AP BLADE 33 FA4-18 ENABLED 2 SW BLADE 55 FC8-32 ENABLED 3 SW BLADE 37 FC8-16 ENABLED 4 SW BLADE 39 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 844
in a Brocade DCX-4S: switch:user> slotshow -m Slot Blade Type ID Model Name Status 1 SW BLADE 36 FC4-48 ENABLED 2 SW BLADE 36 FC4-48 ENABLED 3 SW BLADE 18 FC4-32 ENABLED 4 UNKNOWN VACANT 5 CP BLADE 16 CP256 ENABLED 6 CP BLADE 16 CP256 ENABLED 7 SW BLADE 18 FC4 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 845
include the user name, authentication protocol and password, the privacy protocol and password, the SNMPv3 trap recipient's IP address, its associated user index and trap severity level. When "0" is configured as a trap port, traps can be received at the default port 162. Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 846
s enabled, community strings can be changed on the primary FCS switch only, and only the primary FCS switch propagates changes across the fabric. For an SNMP management station to receive a trap generated by the agent, the administrator must configure a trap recipient to correspond to the IP address - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 847
sets the user name and password to default. If an FCS policy is enabled, the configuration has to be updated on the primary switch and the non-primary switches; unlike community strings, user names and passwords are not distributed for other switches in the fabric. When new passwords are entered - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 848
Specifying yes means the SNMP management application can receive HA traps from the switch. The default value is "yes". You may also turn individual HA Traps on or off. The individual HA Traps are fruStatusChanged, cpStatusChanged, and fruHistoryTrap. 818 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 849
SnmpConfig 2 System Group Configuration Parameters sysDescr The system description. The default value is Fibre Channel switch. sysLocation The location of the system (switch). The default value is End User Premise. The string must be at least 4 characters in length; the maximum length is 255 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 850
IP address: [0.0.0.0] Community (ro): [common] Trap Recipient's IP address: [0.0.0.0] Community (ro): [FibreChannel] Trap Recipient's IP address: [0.0.0.0] To set the access control configuration: switch : YES linkRLIRFailureIncident: YES HA-TRAP: YES 820 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 851
the systemGroup configuration to default values: switch:admin> snmpconfig --default systemGroup ***** This command will reset the agent's system group configuration back to factory default ***** sysDescr = Fibre Channel Switch sysLocation = End User Premise sysContact = Field Support authTraps - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 852
be sent instead of trap requests: switch:admin>snmpconfig --set snmpv3 SNMP Informs Enabled (true, t, false, f): [false] t SNMPv3 user configuration(snmp user not configured in FOS user database will have physical AD and admin role as the default): User (rw): [snmpadmin1] Auth Protocol [MD5(1)/SHA - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 853
on SNMP: Fabric OS MIB Reference SW_v5_x.mib, "Switch Management Information & Switch Enterprise Specific Trap" RFC1157, "A Simple Network Management Protocol (SNMPv1)" RFC1213, "Management information Base for Network Management of TCP/IP-based internets: MIB-II" RFC2574, "User-based Security Model - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 854
its IP address. The IP address must be specified in IPv4 format. IPv6 addresses are currently not supported. --show Displays all configured SNMP traps and MIBs supported in Fabric OS. --help Displays the command usage. Examples To display all the traps and MIBs supported in Fabric OS: switch - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 855
|conn-unit-port-status-change-end |cold-restart-trap |warm-restart-trap |if-link-up-trap |if-link-down-trap |snmp-authetication-trap |fru-status-change-trap |fru-history-trap |cp-status-change-trap To send a link-rnid-device-registration message to recipient 172.16.0.12 switch:admin> snmptraps - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 856
1024, 12, and 1024. The spinFab test is not supported on the following port configurations: ports in extended link slave ports in Trunk groups, ports connected to HBA (F_Ports), ICL ports, and ports configured for long distance. On switches running Fabric OS v6.3.0 and later, you can now use spinFab - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 857
actual number of frames sent will be slightly larger, particularly at link speeds of 4 Gbps or higher. -ports itemlist Specifies a list of user ports to test. By default, all of the ISL ports in the current switch are tested. Refer to itemList for further details. -setfail mode Instructs spinFab - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 858
2 spinFab See Also MBUF_STATE_ERR NO_SEGMENT PORT_ABSENT PORT_DIED PORT_ENABLE PORT_M2M PORT_STOPPED PORT_WRONG RXQ_RAM_PERR STATS STATS_C3FRX STATS_FRX STATS_FTX TIMEOUT XMIT itemList, portLoopbackTest 828 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 859
to enable and manage SSH public key authentication on a switch. SSH public key authentication provides a mechanism for authenticating an authorized user without a password. SSH public key authentication is more secure than password authentication and can be used to securely access services that - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 860
Enter the IP address for the remote host. IPv4 and IPv6 addresses are supported. remote directory login name password Enter the path to store the public key. The default directory where SSH stores public keys is ~username/.ssh. Enter the user name for the configured user. Enter the password for - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 861
letters, numbers, and IP Address, remote directory, login name and password. Refer to importpubkey for a description of these parameters. delprivkey Deletes the private key for outgoing connection from the switch. This option can only be performed by a configured user. Deletion of a configured user - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 862
2 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 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 863
for the blade ports specified in -bports clears. A value of zero (0) clears the user ports specified in -uports. The default value is 0. Examples To clear port and diagnostic statistics: switch:admin> statsclear -bports 1/10-1/62 -use_bports 1 See Also itemList Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 864
be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operand: -ports itemlist Specify a list of user ports to test. By default, all the user ports in the switch are tested. Refer to itemList help - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 865
. Examples To display the FFDC configuration: switch:admin> supportffdc --show First Failure Data Capture (FFDC) is disabled. See Also To enable the FFDC events: switch:admin> supportffdc --enable First Failure Data Capture (FFDC) is enabled. none Fabric OS Command Reference 835 53-1001337 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 866
FTP host. Provide an IP address or a server name. IPv4 and IPv6 addresses are supported. To specify the host by name, a DNS entry must exist for the server. -u username Specifies the FTP account user name. The user name must be less than 48 characters long. -p password Specifies the FTP account - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 867
.168.67.126 User Name[njoe]:admin Password[********]:password Remote Dir[support]:temp Auto file transfer parameters changed To set the time interval at which the FTP server connectivity is checked: switch:admin> supportftp -t 24 supportftp: ftp check period changed. To enable auto file transfer - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 868
blades installed on the switch, a support file (a.tar.gz file) is generated from each slot. This command accepts IPv4 and IPv6 addresses. If the configured IP address is in IPv6 format, the RAS auto file transfer and event notification to syslog will not work in the case where the Fabric OS version - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 869
. OK to proceed? (yes, y, no, n): [no] y Host IP or Host Name: 192.168.126.115 User Name: admin Password: Protocol (ftp or scp): ftp Remote Directory: /temp/support Saving support information for chassis:HL_5100_66, module:RAS... Saving support information for chassis:HL_5100_66, module:TRACE_OLD - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 870
switch:admin> supportsave -U -d mysupportsave This command will collect RASLOG, TRACE, supportShow, core file, FFDC data and other support support information for chassis:ras095_chassis, module:TRACE_NEW... Saving support information for chassis:ras095_chassis, module:FABRIC... Saving support - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 871
exception Exception group commands, enabled by default. port Port group commands, enabled by default. fabric Fabric group commands, enabled by default. services Service group commands, enabled by default. security Security group commands, enabled by default. network Network group commands - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 872
:30 2008 Mon Oct 20 16:04:18 2008 1.0.6 supportshow groups enabled: os enabled exception enabled port enabled fabric enabled services enabled security enabled network enabled portlog enabled system enabled extend disabled filter disabled perfmon disabled ficon disabled iswitch - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 873
:30.131 PORT Tx 0 40 07:32:30.131 PORT Rx 0 0 07:32:41.887 PORT Rx 0 40 07:32:41.887 PORT Tx 0 0 07:32:41.887 FCPH read 0 40 02fffffd,00fffffd, supportSave, supportShowCfgDisable, supportShowCfgEnable, supportShowCfgShow, traceDump Fabric OS Command Reference 843 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 874
Use the supportShowCfgEnable command to enable groups of commands. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that commands. port Disables the port group commands. fabric Disables the fabric group commands. services Disables the service group - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 875
the exception group commands. port Enables the port group commands. fabric Enables the fabric group commands. services Enables the service group commands. security Enables the security group commands. network Enables the network group commands. portlog Enables the portlog group commands - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 876
the command groups that are enabled in the supportShow command: switch:admin> supportshowcfgshow os enabled exception enabled port enabled fabric enabled services enabled security enabled network enabled portlog enabled system enabled extend disabled filter disabled perfmon - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 877
Use this command to enable or disable switch beaconing mode. Switch beaconing can be used to locate a failing unit. When beaconing mode is turned on, the port LEDs flash amber, left to right and right to left, from port 0 to the highest port number and back to port 0. The beaconing mode continues - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 878
switch. All Fibre Channel ports are taken offline. If the switch was part of a fabric, the remaining switches reconfigure. The switch as each port is disabled. A persistently disabled switch can be temporarily enabled using the switchEnable command. A temporarily enabled switch remains disabled - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 879
persistently enable a persistently disabled switch. All Fibre Channel ports that passed the power-on self-test (POST) are enabled and come online if connected to a device, or remain offline if disconnected. The switch may need to be enabled if it was previously disabled to make configuration changes - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 880
settings. Use the portCfgShow command to display user-configured speed settings. Notes This configuration cannot be set on VE_Ports or VEX_Ports. Speed configuration is not applicable to FCoE ports. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 881
trunking on all ports. Examples To enable trunking on all ports of a switch: switch:admin> switchcfgtrunk 1 Configuration applied to all ports except the following \ VE/VEX_Ports (ports 176 - 191). See Also To disable trunking on all ports of a switch: switch:admin> switchcfgtrunk 0 Committing - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 882
disable all user ports on a switch. All Fibre Channel ports are taken offline. If the switch was part of a fabric, the remaining switches reconfigure. As each port is disabled, the front panel LED changes to a slow flashing yellow. The switch must be disabled before making configuration changes or - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 883
this command to enable all user ports on a switch. All Fibre Channel ports that passed the power-on self test (POST) are enabled. They can come online if connected to a device, or remain offline if disconnected. Use switchEnable to re-enable the switch after making configuration changes or running - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 884
running earlier firmware versions, the switch name can be up to 31 characters long. On all other pre-Fabric OS v6 numbers, hyphens, and underscore characters. Spaces are not allowed. This operand is optional; if omitted, this command displays the current switch name. Examples To change a switch - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 885
. Values are ON or OFF. LS Attributes Displays logical switch attributes, including the fabric ID associated with the logical switch and the switch role (default switch or base switch) and the fabric Address Mode (0, 2 or 3). The fabric Address Mode field indicates the McDATA interop mode for the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 886
Port Index is a number between 0 and the maximum number of supported ports on the platform. The port index identifies the port number relative to the switch. Slot number; 1-12 Port number; 0-15, 0-31, or 0-47. The 24 is receiving light and in sync. 856 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 887
up and running. Proto Protocol support by GbE port. ISCSI The ports supports ISCSI. FCIP The port supports FCIP. FCoE The port supports Fibre Channel over Ethernet. comment Optionally displays one of the following: Copper or Optical GbE port media configuration can be copper and optical - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 888
chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. On the Brocade 8000, the Proto column identifies the FCoE ports of the switch. For all FcoE ports, the speed is 10 Gbps. The default configuration of an FCoE port is an F_Port configuration. After a successful - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 889
id N4 Online FC F-Port 1 N Port + 1 NPIV public 8 8 020800 id N4 Online FC F-Port 10:00:00:05:1e:65:95:81 9 9 020900 id N4 Online FC E-Port 10:00:00:05:1e:40:ff:95 "sw0" (upstream)(Trunk master) 10 10 020a00 id N4 Online FC E-Port (Trunk port, master is Port 9 ) Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 890
021600 -23 23 021700 -24 24 021800 -25 25 021900 -26 switch information on a Virtual Fabrics-enabled switch: switch 80:04:92 zoning: ON (testcfg1) switchBeacon: OFF FC Router: OFF Allow XISL use: ON LS Attributes: [FID: 10, Base Switch: No, Default Switch: No, Address Mode 0] Index Slot Port - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 891
FC Router: OFF Allow XISL Use: OFF LS Attributes:[FID: 128, Base Switch: No, Default Switch: Yes, Address Mode 0] Slot Blade Type ID Status 5 COREBLADE 52 ENABLED Index Slot Port Name 384 5 0 MyName_portname0 385 5 1 ------ 386 5 2 ------ To display the domain ID offset - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 892
: Principal DomainIDOffset: 0x20 switchDomain: 2 switchId: fffc25 switchWwn: 10:00:00:05:1e:35:71:8b zoning: OFF switchBeacon: OFF FC Router: OFF FC Router BB Fabric ID: 1 [output truncated] portCfgLongDistance, switchDisable, switchEnable, switchName 862 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 893
the default values, if there is one faulty port in a switch, then this contributor would set the overall switch status to MARGINAL. If two ports were faulty, then this contributor would set the overall switch status to DOWN. Note The execution of this command is subject to Virtual Fabric or Admin - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 894
** the policy parameter is NOT applicable to the switch. ** Simply hit the Return key. The minimum number of Bad PowerSupplies contributing to DOWN status: (0..4) ) [0] Policy parameter set has been changed switchStatusPolicyShow, switchStatusShow 864 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 895
that trigger a status change in the switch. For example, if the FaultyPorts DOWN parameter is set to 3, and three ports fail in the switch, then the status of the switch changes to DOWN. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 896
2 switchStatusPolicyShow Flash 0 1 MarginalPorts 2 1 FaultyPorts 2 1 MissingSFPs 0 0 See Also switchStatusPolicySet, switchStatusShow 866 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 897
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. This command displays the overall switch status, and the status of the following contributors - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 898
Missing SFPs monitor HEALTHY All ports are healthy To retrieve a switch health report for a switch that is configured with an IPv4 address: switch:user> switchstatusshow Switch Health Report Switch Name: switch IP address: 10.32.89.26 SwitchState: MARGINAL Duration: 80:12 Report time: 09 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 899
that may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To view the uptime for the switch: switch:user> switchuptime 9:50pm up for 20 mins See Also none Fabric OS Command Reference 869 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 900
Fabric OS Commands" and Appendix A, "Command Availability" for details. This command can be executed on both active and standby CPs. This command does not support a switch: switch:admin> switchviolation --dump -dcc Device WWN Port 22:00:00:04:cf:75:59:87 10 See Also none 870 Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 901
appropriate log files or users, depending on the system configuration. The specified facility is used when forwarding messages to the servers added through the command syslogdIpAdd. The default facility is LOG_LOCAL7. Note The execution of this command is subject to Virtual Fabric or Admin Domain - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 902
files or users, depending on the system configuration. Up to six servers are supported. Only one syslogd server can be specified at any given time. To configure more than one server, the command must be executed for each server. Note The execution of this command is subject to Virtual Fabric or - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 903
system messages are sent from the syslog server configuration on the switch. IPv6 and IPv4 syslogd addresses are supported. Use syslogdIPShow to view the current syslog server configuration. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 904
daemon and to which system messages are sent. Servers are specified in the configuration database by IP address. IPv4 and IPv6 addresses are supported. Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in place. Refer to chapter 1, "Using - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 905
values are snmp, raslog, or both. The default is none. --help Displays the command usage. Examples To configure the threshold for memory usage monitoring: switch:admin>sysMonitor --config mem -poll 10 -retry 1 -limit 20 -action snmp,raslog Fabric OS Command Reference 53-1001337-01 875 Juror - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 906
Actions : snmp,raslog To configure the threshold for monitoring system CPU usage: switch:admin>sysMonitor --config cpu switch:admin>sysMonitor --show cpu CPU Usage: CPU Usage : 21.9 CPU Usage limit : 70 Number of Retries : 4 Polling Interval : 20 seconds Actions : snmp fwHelp 876 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 907
LEDs will turn black. After executing this command, manually power off the system. To reboot the system, manually turn the power switch on. Notes This command is not supported on the standby CP. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 908
See Also To attempt a system shutdown from the standby CP (not supported): switch:admin> sysshutdown Shut down the whole system is not support from the standby CP For shut down the whole system please run the sysshutdown from the active CP haDisable 878 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 909
To display temperature and status sensors: switch:user> tempshow Index Slot State Centigrade Fahrenheit 1 1 Ok 41 105 2 2 Ok 39 102 3 3 Absent 4 4 Absent 5 5 Ok 26 78 6 6 Ok 27 80 See Also fanShow, psShow, sensorShow, slotShow Fabric OS Command Reference 879 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 910
Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operand: timeval Specify the number switch:admin> timeout 10 IDLE Timeout Changed to 10 minutes The modified IDLE Timeout will be in effect after NEXT login See Also none 880 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 911
. The following rules apply: 1. On all switches, the command displays the number of domains in the fabric and the local Domain IDs. If translate domains are configured, existing translate domains and associated ports are displayed. 2. On an edge fabric, the command displays the following additional - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 912
all domains, including local domains and local translate domains: switch:user> topologyshow 6 domains in the fabric; Local Domain ID: 7 Domain: Metric: Name: Path Count: 1 10500 fcr_xd_1_1 1 Hops: Out Port: In Ports: Total Bandwidth: Bandwidth Demand: Flags: 2 11 0 1 2 3 4 5 6 7 8 9 15 8.000 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 913
for the three remote domains, not for the two local translate domains. switch:user> topologyshow 5 domains in the fabric; Local Domain ID: 2 Local Translate Domain 4 owned by port: 24 Local Translate Domain 5 owned by port: 23 33 Domain: Metric: Name: Path Count: 1 500 pengsaturn104 1 Hops: Out - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 914
2 topologyShow See Also Path Count: 1 Hops: Out Port: In Ports: Total Bandwidth: Bandwidth Demand: Flags: 2 0 23 24 33 38 39 8.000 Gbps 350 % D fcrXlateConfig, portRouteShow, uRouteShow 884 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 915
is used, the default remote file name format number from which a trace dump is generated. If a slot is not supplied, the trace dump is generated from the local slot. This operand is optional. Examples To initiate a background trace dump from slot 5: switch:admin> tracedump -n -s 5 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 916
2 traceDump See Also To clear the status of a trace dump: switch:admin> tracedump -R trace dump removed To clear the content of the trace dump buffer: switch:admin> tracedump -c Cleared Trace Buffer contents supportFtp, supportSave, supportShow 886 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 917
may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Examples To display information on the track-changes commands: switch:admin> trackchangeshelp trackChangesSet Configure alert for login/logout/config update trackChangesShow Displays - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 918
optional. Examples To enable the track-changes feature: switch:admin> trackchangesset 1, 1 Committing configuration...done. switch:admin> trackchangesshow Track changes status: ON Track changes generate SNMP-TRAP: YES See Also snmpConfig, trackChangesHelp, trackChangesShow 888 Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 919
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. Note The execution of this command is subject to Virtual Fabric or Admin - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 920
the index numbers for a port. This operand is required. Examples To debug a trunk connection: switch:admin> trunkdebug 43 44 Switch does not support trunking switch:admin> trunkdebug 62 63 port 62 and 63 are trunked together See Also portCfgTrunkPort, switchCfgTrunk, trunkShow 890 Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 921
and EX_Ports. The command displays the following fields: Trunking Group Number Displays each trunking group on a switch. All ports that are part of this trunking group are displayed. Port to port connections Displays the port-to-port trunking connections. WWN Displays the world wide name of the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 922
:51:43:04 deskew 16 deskew 15 deskew 17 deskew 16 MASTER 3:24 -> 14 10:00:00:60:69:51:42:dd deskew 15 MASTER 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 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 923
Port 10:00:00:05:1e:37:12:13 "SW4900_43" (downstream)(Trunk master) To display trunking information along with the bandwidth and throughput for all trunk groups in a switch: switch .0 GB (37.5%) Rx: Bandwidth 32.0GB, Throughput 16.0 GB (50%) 3: 24-> 14 10:00:00:60:69:51:42:dd 2 deskew 15 MASTER Tx: - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 924
enable fabric-wide clock synchronization with the specified clock server. A value of LOCL may be specified as operand to set the clock server back to default. Each ipaddr specified should be the IP address of an NTP server and should be accessible from the switch. The NTP server must support a full - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 925
.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. date tsClockServer 2 Fabric OS Command Reference 895 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 926
, GMT. If all switches in a fabric are located in the same time zone, you may leave the default time zone setup. Time zone is used in computing local time for error reporting and logging. An incorrect time zone setup does not affect the switch operation in any way. System services started during the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 927
the number of the value defaults to 0. setup and then change it to GMT-3:30: switch:admin> tstimezone Time Zone Hour Offset: 0 Time Zone Minute Offset: 0 switch:admin> tstimezone -3, -30 Updating Time Zone configuration 40) St Pierre 7) Belize 24 Fabric OS Command Reference 897 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 928
Enter number or control-D to quit ?1 System Time Zone change will take effect at next reboot See Also To revert back to the offset format and verify the configuration: switch admin> tstimezone --old 2 switch admin> tsttimezone Time Zone Hour Offset: 2 Time Zone Minute Offset: 0 date 898 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 929
Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following optional operands: --slot slotnumber Specifies the slot number on which the diagnostic operates. All blade ports in the specified slot are tested. This operand is optional. The default - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 930
may be in place. Refer to chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for details. Operands none Examples To display the length of time the system has been operational: switch:admin> uptime 12:03am up 4:56, 3 users, load average: 1.17, 1.08, 1.08 See Also date - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 931
if this port becomes part of a valid path in the future. If a static route requires hardware resources that are already used, a platform conflict warning message is displayed and the configuration does not take effect. When using static routes, load sharing may be affected. The switch attempts to - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 932
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 from port 1 and addressed to domain 2: switch:admin> urouteremove 1 2 done. See Also configShow, dlsShow, uRouteConfig, uRouteShow 902 Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 933
received. Except for the cases in which you perform a port swap or enable extended-edge PID (PID Format 2) on a switch, the value is equal to the port index field displayed by the switchShow command. Refer to Fabric OS Administrator's Guide for more information regarding the extended edge PID format - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 934
number of the input port whose routes are to be displayed, relative to its slot for bladed systems. Use switchShow to display a list of valid ports. This operand is optional; if omitted, the command displays routing information for all input ports in the switch. Specify a remote domain in the fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 935
:admin> usbstorage -e USB storage enabled To list the contents of the attached USB device: switch:admin> usbstorage -l firmwarekey\ 0B support\ 106MB support1034\ 105MB config\ 0B 2007 Aug 15 15:13 2007 Aug 24 05:36 2007 Aug 23 06:11 2007 Aug 15 15:13 Fabric OS Command Reference 905 53 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 936
To remove a firmware target from the firmware application area: switch:admin> usbstorage -r firmware FW_v6.0.0 To disable an attached USB device: switch:admin> usbstorage -d USB storage disabled supportSave, firmwareDownload, configUpload, configDownload, firmwareKeyupdate 906 Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 937
. On platforms supporting multiple switch domains, account information is saved only to the switch domain, in which the command was executed. Use the distribute command to distribute the account database manually to other switches in the fabric. Target switches must be configured to accept the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 938
operates on the switch-local user database only, regardless of whether the switch is configured to use RADIUS authentication or not. The account database supports a maximum of 256 customer created accounts. The backup account database is no longer supported on switches running Fabric OS v6.0 or - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 939
, or the home AD or home Logical Fabric of your own account. • No account can disable itself. • AD or LF permissions must be a subset of the respective AD or LF permissions of the account that creates or modifies a user account. • In an LF-enabled environment, you can change the role associated - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 940
in with an invalid password. Refer to the passwdCfg help page for more information. --addad | --deletead Adds one or more ADs to a user account or deletes ADs from a user account. The following operands are supported: username Specifies the account login name. 910 Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 941
not previously have a home AD, the home AD is set to the lowest numbered AD in the user's AD permissions. • If a home AD is specified with the --deletead Fabric or chassis permissions to a user account or deletes LF or chassis permission from a user account. The following operands are supported: - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 942
following examples illustrate how to create and manage user accounts in an AD-enabled environment. To add a new account: switch:admin> userconfig --add joe -r admin -d "Joe Smith" Setting initial password for joe Enter new password: Re-type new password: Account joe has been successfully added. To - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 943
: switch:admin> userconfig --show test Account name: test Role: zoneadmin Description: Enabled: Yes Password Last Change Date: Sat Jun 14 2008 Password Expiration Date: Not Applicable Locked: No RoleLFMaps: zoneadmin: 1-5 admin: 6-10 user: 11-15 chassis Chassis Role: user Home Context: 4 Fabric OS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 944
the LFs 1-3. switch:admin> userconfig --deletelf test -l 1-3 -c Broadcast message from root (ttyS0) Sat Jun 14 01:10:02 2008... Security Policy, Password or Account Attribute Change: test will be logged out LFs/chassis role for account test has been successfully deleted. none 914 Fabric OS Command - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 945
name, new_username cannot be another default login name. 5. If new_username is a default login name, it must indicate the same role as old_username. Notes This command is not supported on all platforms. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 946
in the time period between firmwareDownload and the next reboot, the dates can differ. Operands none Examples To display the firmware version information in a switch: switch:admin> version Kernel: 2.6.14.2 Fabric OS: v6.1.0 Made on: Wed Feb 13 06:59:17 2008 Flash: Thu Feb 14 18:38:31 2008 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 947
by the end user. The WWN is used as the license ID in many cases, but the only official string to be used for requesting licenses is the licenseidShow output. Alternately, use switchShow to display the switch WWN. In addition to the WWN, all switches have a unique 24-bit Fibre Channel address that - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 948
that may be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "Command Availability" for details. Operands This command has the following operands: --bind WWN PID Assigns the lower two bytes of the Fibre Channel address to the specified WWN. Specifies the WWN for the - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 949
:cc 0x100 40 0x22 23) 10:00:00:06:2b:0f:6d:ee 0x305 50 0x12 24) 10:00 :00:06:2b:0f:6d:ef 0x103 49 0x12 To display the WWW address binding for device 20:22:00:05:1e:0b:61:cc: switch:admin> wwnaddress --findPid 20:22:00:05:1e:0b:61:cc WWN PID 20:22:00:05:1e:0b:61:cc 0x300 . Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 950
noFCR] zone --rddelete name The zone command supports three types of operations: specific zone operations, ports. The provision (a.k.a TI Zone) is part of the defined zone configuration and does not appear in the effective zone configuration. A Maximum of 255 TI Zones can be created in one fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 951
Use zone --rddelete to remove the base RD zone, "red_______base". When the base zone is removed, the RD zone configuration "r_e_d_i_r_c__fg" is removed as well Notes TI zones are not supported in fabrics involving switches running firmware versions preceding Fabric OS v6.0. However, the existence - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 952
Specifies the zone database location. Supported mode flag values are: 0 port list members from existing zones. Removal of the last member from an active TI zone generates a warning. If the last member of a TI zone is removed, the TI zone name is removed from the defined TI zone list. 922 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 953
again, the route is set up again and the switch generates another SCN or RSCN. TI zones with no-failover option are not supported in logical fabrics. TI zones defined in the Base Fabric for logical fabric traffic need to allow failover. f Enables failover mode. In failover mode, when the last - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 954
across a Fibre Channel router (FCR). Specify FCR to support FCR. Specify noFCR if you do not wish to support FCR. Deletes the RD Zone specified by name. RD Zones are unique in that the zone name is not user-defined. It is derived based on members and the specified configuration. Use cdfgShow - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 955
zone database in the current transaction buffer: switch:admin> zone --validate -m 0 Defined configuration: cfg: t_r_a_f_f_i_c_i_s_o_c__fg bluezone; greenzone cfg: 1,3*; 2,3 Invalid configuration * - Member does not exist # - Invalid usage of broadcast zone Fabric OS Command Reference - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 956
about to prune the zone configurations, based on zone --validate output. Do you want to prune the zone configurations (yes, y, no, n): [no] y 2. Traffic isolation zone commands: To create an activated traffic isolation zone with failover enabled (default). switch:admin>zone --create -t ti purplezone - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 957
: TI Zone Name: ti_bluezone Port List: 2,2; 3,2 Configured Status: Activated / Failover-Disabled Enabled Status: Deactivated To create an FCR TI Zone within an Edge fabric where a host should to talk to target1 and target4 through port number 2 on an Edge fabric switch with a domain ID of - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 958
configuration: cfg: myHTcfg zone: myHostTarget 00:3f:3f:3f:23:24:25:26 3f:3f:3f:30:32:00:00:00 To delete an RD Zone named "red_0917_10_10_10_10_10_10_10_10_20_20_20_20_20_20_20_20": switch:admin>zone --rddelete red_0917_10_10_10_10_10_10_10_10_20_20_20_20_20_20_20_20 ad, zoneHelp 928 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 959
to be preserved across switch reboots, save the configuration to nonvolatile memory with the cfgSave command. For the change to become effective, enable the configuration with the cfgEnable command. Notes The execution of this command is subject to Virtual Fabric or Admin Domain restrictions - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 960
". Only one "broadcast" zone can exist within a fabric. This type of zone is enforced by the hardware; the switch controls the data transfer to a port. This command changes the defined configuration. For the change to be preserved across switch reboots, save it to nonvolatile memory with the cfgSave - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 961
all devices connected to switch 2, ports 12 and 14, and to the device with the world wide name "10:00:00:60:69:00:00:8a" (either node name or port name), at the port in the fabric to which it is connected. Examples To create three zones using a combination of port numbers and zone aliases: sw5 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 962
to be preserved across switch reboots, save the configuration to nonvolatile memory using the cfgSave command. For the change to become effective, enable the configuration with the cfgEnable command. Notes The execution of this command is subject to Virtual Fabric or Admin Domain restrictions - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 963
zone alias information Display Effective zone configuration information Add a member to a configuration Clear all zone configurations Create a zone configuration Delete a zone configuration Disable a zone configuration Enable a zone configuration Configure legacy MCDT zoning behavior Remove a member - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 964
enable the configuration with the cfgEnable command. Notes When FCS policy is enabled, this command can be issued only from the primary FCS switch. The execution of this command is subject to Virtual Fabric zone configuration name must begin with a letter followed by any number of letters, numbers, - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 965
command. For the change to become effective, enable the configuration with the cfgEnable command. Notes When FCS policy is enabled, this command can be issued only from the primary FCS switch. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 966
the change to become effective, enable the configuration must be enabled with the cfgEnable command. Notes When an FCS policy is enabled, this command can be issued only from the primary FCS switch. The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 967
to be preserved across switch reboots, save the configuration to nonvolatile memory with the cfgSave command. For the change to become effective, enable the configuration with the cfgEnable command. Notes The execution of this command is subject to Virtual Fabric or Admin Domain restrictions - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 968
Availability" for details. When FCS policy is enabled, this command can be issued on any FCS switch in the fabric. Operands This command has the following operands: "pattern" A POSIX-style regular expression used to match zone configuration names. The pattern must be enclosed in quotation - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 969
Primary FCS commands Chapter 3 Primary FCS commands Table 24 summarizes the commands that are available only on the primary Fabric Configuration Server (FCS) when FCS policy is enabled. TABLE 24 Primary FCS commands Command Description aliAdd aliCreate aliDelete aliRemove aliShow cfgAdd - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 970
. Must be run from the primary FCS switch. Must be run from the primary FCS switch. Must be run from the primary FCS switch. Must be run from the primary FCS switch. Must be run from the primary FCS switch. Must be run from the primary FCS switch. 940 Fabric OS Command Reference 53-1001337-01 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 971
port or the local switch is part of the current AD. View access allowed if the device attached to the port is part of the current AD. • AD0Disallowed = Allowed to execute only in AD255 and AD0 (if no ADs are configured). • AD0Only = Allowed to execute only in AD0 when ADs are not configured. Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 972
roles may perform routine encryption switch management functions including the following: • Configure virtual devices & crypto LUN. • Configure LUN/tape associations. • Perform re-keying operations. • Perform firmware download. • Perform regular Fabric OS management functions. Refer to - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 973
type Command Name User Admin Oper SW Zone Fabric BS Sec Admin discoverLUN eject enable enableEE export OM N N N O N OM Disallowed N OM N N N O N OM Disallowed Fabric OS Command Reference 53-1001337-01 Context Switch Type VF DS VF DS VF DS VF DS VF DS VF DS VF DS VF DS - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 974
DS VF DS General Fabric OS commands and permissions Refer to Table 2 for Fabric OS commands. TABLE 2 Fabric OS command RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin Admin Admin Admin Context Switch Type aaaConfig ad ag - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 975
and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin VF VF VF VF Switch Type All All All All All All All All N/A N/A All N/A N/A All All N/A N/A N/A All N/A All All N/A N/A N/A N/A N/A All All All All All All Fabric OS Command Reference 945 - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 976
and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin N configUpload N configure N configureChassis N Switch Type N/A All All All All All All All All N/A N/A N/A N/A N/A N/A N/A All N/A N/A N/A N/A N/A N/A All N/A N/A N/A N/A All N/A N/A 946 Fabric - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 977
admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain OM O N SwitchMember O OM O O O OM O N Disallowed O OM O O O OM O O Allowed Context Switch Type CH N/A Disallowed N/A CH N/A CH N/A VF All VF All VF All VF All VF All CH N/A CH - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 978
RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin Admin Admin Admin Context Switch Type fcoeLoginCfg fcoeLoginGroup fcPing fcpLogClear fcpLogDisable fcpLogEnable fcpLogShow fcpProbeShow fcpRlsShow fcrBcastConfig fcrChipTest - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 979
OS commands and permissions A TABLE 2 Fabric OS command RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin Admin Admin Admin Context Switch Type firmwareCommit O OM OM OM O OM O OM SwitchMember CH N/A firmwareDownload - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 980
admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin O Allowed O O O O O O O O Allowed O OM OM OM O OM O O Allowed Context CH CH Switch Type N/A N/A CH N/A VF All CH N/A CH N/A CH N/A CH N/A VF All VF All CH N/A CH N/A VF - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 981
OS command RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin Admin Admin Admin Context Switch Type licensePort licenseRemove licenseShow licenseSlotCfg linkCost login logOut lsanZoneShow lsCfg LSDbShow memShow msCapabilityShow - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 982
OS commands and permissions TABLE 2 Fabric OS command RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin Admin Admin Admin Context Switch Type pathInfo pdShow perfAddEEMonitor perfAddIPMonitor perfAddReadMonitor perfAddRWMonitor - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 983
availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin Admin Admin Admin portcfgAutoDisable O VF VF VF VF VF VF VF VF CH VF VF VF VF VF CH VF VF VF VF Switch Type All All All All All All All All All All All All All All All All All All - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 984
OS command RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin Admin Admin Admin Context Switch Type portLogDumpPort portLogEnable portLogEventShow portLoginShow portLogPdisc portLogReset portLogResize portLogShow portLogShowPort - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 985
RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin Admin Admin Admin Context Switch Type secAuthSecret secCertUtil secDefineSize secGlobalShow secHelp secPolicyAbort secPolicyActivate secPolicyAdd secPolicyCreate secPolicyDelete - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 986
and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin CH CH VF CH Switch Type DS N/A N/A N/A All N/A N/A N/A All All All All All All All All All All All All N/A All N/A N/A N/A N/A N/A N/A N/A N/A N/A All N/A 956 Fabric OS Command Reference 53-1001337- - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 987
RBAC availability and admin domain type Command Name User Admin Oper Sw Zone Fabric BS Sec Admin Domain Admin Admin Admin Admin Admin Context Switch Type trackChangesHelp O trackChangesSet O trackChangesShow O trunkDebug O trunkShow O tsClockServer O tsTimeZone O turboRamTest - HP StorageWorks 8/80 | Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 988
A General Fabric OS commands and permissions 958 Fabric OS Command Reference 53-1001337-01
53-1001337-01
28 July 2009
®
Fabric OS
Command Reference Manual
Supporting Fabric OS v6.3.0