Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 3
... Fabric OS Command Reference 53-0000519-08 Rev. also, extensive revisions were made to nearly every command to support the SilkWorm 3250, 3850, and 24000 switches, added 3 commands, changed 20 commands, and deleted 10 commands. Also, revised the template. Document Title Publication Number Summary of Chapter 1. A Manual September 1999 May 2000...
... Fabric OS Command Reference 53-0000519-08 Rev. also, extensive revisions were made to nearly every command to support the SilkWorm 3250, 3850, and 24000 switches, added 3 commands, changed 20 commands, and deleted 10 commands. Also, revised the template. Document Title Publication Number Summary of Chapter 1. A Manual September 1999 May 2000...
Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 21
... this document. • Chapter 1, "Using Fabric OS Commands" explains how to use the command line interface to manage a Brocade SAN and Brocade SilkWorm switches. • Chapter 2 , "Fabric OS Commands" provides command information. • Chapter 3, "Licensed Product Commands" provides a subset...every command, for every user role. • The Index points you to help system administrators and technicians operate, maintain, and troubleshoot SAN products. The document contains the following sections: • "How This Document Is Organized," next • "Supported Hardware and Software...
... this document. • Chapter 1, "Using Fabric OS Commands" explains how to use the command line interface to manage a Brocade SAN and Brocade SilkWorm switches. • Chapter 2 , "Fabric OS Commands" provides command information. • Chapter 3, "Licensed Product Commands" provides a subset...every command, for every user role. • The Index points you to help system administrators and technicians operate, maintain, and troubleshoot SAN products. The document contains the following sections: • "How This Document Is Organized," next • "Supported Hardware and Software...
Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 22
...the following platforms: • Brocade SilkWorm 200E switch • Brocade SilkWorm 3250 switch • Brocade SilkWorm 3850 switch • Brocade SilkWorm 3900 switch • Brocade SilkWorm 4100 switch • Brocade SilkWorm 4900 switch • Brocade SilkWorm 7500 switch • Brocade SilkWorm 24000 director • Brocade... SilkWorm 48000 director In those instances in which procedures or parts of this guide identifies exactly which switches are supported and which are tested and supported by Brocade Communications Systems, Inc. Although many different software and...
...the following platforms: • Brocade SilkWorm 200E switch • Brocade SilkWorm 3250 switch • Brocade SilkWorm 3850 switch • Brocade SilkWorm 3900 switch • Brocade SilkWorm 4100 switch • Brocade SilkWorm 4900 switch • Brocade SilkWorm 7500 switch • Brocade SilkWorm 24000 director • Brocade... SilkWorm 48000 director In those instances in which procedures or parts of this guide identifies exactly which switches are supported and which are tested and supported by Brocade Communications Systems, Inc. Although many different software and...
Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 28
...host-based management programs to manage FICON fabric switches in the zone. SilkWorm 200E • SilkWorm 200E Hardware Reference Manual (for a variety of SAN fabrics while simplifying ISL management. Fabric Watch Continuously monitors SAN fabrics for potential faults based on the Brocade... Enables more robust data protection. Two 4 Gbit/sec SilkWorm switches can obtain Building SANs with Brocade Fabric Switches through: http://www.amazon.com For additional Brocade documentation, visit the Brocade SAN Info Center and click the Resource Library location: http://www.brocade...
...host-based management programs to manage FICON fabric switches in the zone. SilkWorm 200E • SilkWorm 200E Hardware Reference Manual (for a variety of SAN fabrics while simplifying ISL management. Fabric Watch Continuously monitors SAN fabrics for potential faults based on the Brocade... Enables more robust data protection. Two 4 Gbit/sec SilkWorm switches can obtain Building SANs with Brocade Fabric Switches through: http://www.amazon.com For additional Brocade documentation, visit the Brocade SAN Info Center and click the Resource Library location: http://www.brocade...
Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 29
... routers. Other Industry Resources For additional resource information, visit the Technical Committee T11 Web site. Fabric OS supports eight FCIP interswitch links between two SilkWorm switches (SilkWorm 7500 or SilkWorm 48000 with the remaining links going to "tunnel" through IP networks by dividing frames, encapsulating the result in IP packets on... industry, visit the Fibre Channel Industry Association Web site: http://www.fibrechannel.org Fabric OS Command Reference Manual xxix Publication Number: 53-1000240-01 All 16 links can be used as they leave the tunnel.
... routers. Other Industry Resources For additional resource information, visit the Technical Committee T11 Web site. Fabric OS supports eight FCIP interswitch links between two SilkWorm switches (SilkWorm 7500 or SilkWorm 48000 with the remaining links going to "tunnel" through IP networks by dividing frames, encapsulating the result in IP packets on... industry, visit the Fibre Channel Industry Association Web site: http://www.fibrechannel.org Fabric OS Command Reference Manual xxix Publication Number: 53-1000240-01 All 16 links can be used as they leave the tunnel.
Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 30
...to display the license ID. • SilkWorm Multiprotocol Router Model AP7420: Provide the switch WWN. Use the switchShow command to display the switch WWN. To expedite your switch support supplier for hardware, firmware, and software support, including product repairs and part...the license ID. Use the wwn command to display the switch WWN. • All other SilkWorm switches: Provide the switch WWN. General Information • Technical Support contract number, if applicable • Switch model • Switch operating system version • Error numbers and messages received...
...to display the license ID. • SilkWorm Multiprotocol Router Model AP7420: Provide the switch WWN. Use the switchShow command to display the switch WWN. To expedite your switch support supplier for hardware, firmware, and software support, including product repairs and part...the license ID. Use the wwn command to display the switch WWN. • All other SilkWorm switches: Provide the switch WWN. General Information • Technical Support contract number, if applicable • Switch model • Switch operating system version • Error numbers and messages received...
Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 33
...'s Guide for every user role. Fabric OS Command Reference Manual 1-1 Publication Number: 53-1000240-01 The following information is permitted to manage a Brocade SAN and Brocade SilkWorm switches and directors using the Fabric OS command line interface (CLI). Using Fabric OS Commands Chapter 1 This chapter explains how to have on page 1-2 Refer...
...'s Guide for every user role. Fabric OS Command Reference Manual 1-1 Publication Number: 53-1000240-01 The following information is permitted to manage a Brocade SAN and Brocade SilkWorm switches and directors using the Fabric OS command line interface (CLI). Using Fabric OS Commands Chapter 1 This chapter explains how to have on page 1-2 Refer...
Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 34
...Fabric OS CLI is the complete fabric management tool for Brocade SANs, providing: • Access to you purchase • Assistance with full management capability on a SilkWorm switch. The same information is controlled by a switch-level password for the specified command. For example, to ... and manage entire fabrics, individual switches, and ports from a standard workstation. Access is available to the full range of Fabric OS features, based on which license keys you on multiple levels • Identification, isolation, and management of SAN events across an entire fabric,...
...Fabric OS CLI is the complete fabric management tool for Brocade SANs, providing: • Access to you purchase • Assistance with full management capability on a SilkWorm switch. The same information is controlled by a switch-level password for the specified command. For example, to ... and manage entire fabrics, individual switches, and ports from a standard workstation. Access is available to the full range of Fabric OS features, based on which license keys you on multiple levels • Identification, isolation, and management of SAN events across an entire fabric,...
Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 36
... configuration information. It is used . --localonly Enable authentication via console, telnet or SSH connection. The configuration applies to all switch instances in the existing RADIUS configuration list from the current position to manage the RADIUS configuration for the next AAA request. Synopsis...server must match one in the existing configuration. --move server to_position Move the specified server in a platform supporting multiple switch domains. Note The execution of RADIUS configuration list, with port as the RADIUS server port number, secret as the shared secret ...
... configuration information. It is used . --localonly Enable authentication via console, telnet or SSH connection. The configuration applies to all switch instances in the existing RADIUS configuration list from the current position to manage the RADIUS configuration for the next AAA request. Synopsis...server must match one in the existing configuration. --move server to_position Move the specified server in a platform supporting multiple switch domains. Note The execution of RADIUS configuration list, with port as the RADIUS server port number, secret as the shared secret ...
Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 37
... 1 192.168.233.48 1812 sharedsecret 3 2 192.168.233.44 1812 sharedsecret 3 3 radserver 1812 private 5 CHAP CHAP CHAP Primary AAA Service: Switch database Secondary AAA Service: None To change 192.168.233.48 -p 3002 -s newsecret -t 1 See Also none Fabric OS Command Reference Manual 2-3 Publication ...only. This is for AAA services. --radiuslocalbackup Enable the current RADIUS configuration as the primary AAA service and the switch local database as the secondary AAA service. If the RADIUS server times out, requests are denied. When enabled, if RADIUS authentication fails,...
... 1 192.168.233.48 1812 sharedsecret 3 2 192.168.233.44 1812 sharedsecret 3 3 radserver 1812 private 5 CHAP CHAP CHAP Primary AAA Service: Switch database Secondary AAA Service: None To change 192.168.233.48 -p 3002 -s newsecret -t 1 See Also none Fabric OS Command Reference Manual 2-3 Publication ...only. This is for AAA services. --radiuslocalbackup Enable the current RADIUS configuration as the primary AAA service and the switch local database as the secondary AAA service. If the RADIUS server times out, requests are denied. When enabled, if RADIUS authentication fails,...
Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 38
...Admin Domain-level operations. The -transshow operand can be set the default zone mode to "No Access": switch:admin> ad --select AD0 switch:admin> defzone --noaccess switch:admin> cfgsave All switches, switch ports and devices from the fabric that are sent to "No Access" mode. For --apply, it performs... the required changes for the Defined configuration. The Admin Domain transaction buffer is linked to the Defined configuration (in any other switches and saved to the current login shell and is for more information. To set to all administration domain (Admin Domain)-level...
...Admin Domain-level operations. The -transshow operand can be set the default zone mode to "No Access": switch:admin> ad --select AD0 switch:admin> defzone --noaccess switch:admin> cfgsave All switches, switch ports and devices from the fabric that are sent to "No Access" mode. For --apply, it performs... the required changes for the Defined configuration. The Admin Domain transaction buffer is linked to the Defined configuration (in any other switches and saved to the current login shell and is for more information. To set to all administration domain (Admin Domain)-level...
Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 39
... assign a name of devices in an Admin Domain, in --exec, --show and --validate subcommands alone. Benefits include: • Grants port control and zoning on the switch port and the devices attached to AD0's explicit member list using --add and --apply; The port index range is for Admin Domain creation are already...
... assign a name of devices in an Admin Domain, in --exec, --show and --validate subcommands alone. Benefits include: • Grants port control and zoning on the switch port and the devices attached to AD0's explicit member list using --add and --apply; The port index range is for Admin Domain creation are already...
Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 40
... Reference Manual Publication Number: 53-1000240-01 Operations with --show and --validate. This operand is valid only with switch list will be converted into a switch WWN based on all its ports, but no zoning control. This operand is valid only with -rename. AD0 ..., portDisable, portEnable, and so forth. 2 Note: Enter commands in quotation marks. Specifies the list of switches in an Admin Domain, in lowercase only; switch_list grants switch administrative operations such as switchDisable, switchEnable, reboot, firmwareDownload, and so forth. This operand is always in an...
... Reference Manual Publication Number: 53-1000240-01 Operations with --show and --validate. This operand is valid only with switch list will be converted into a switch WWN based on all its ports, but no zoning control. This operand is valid only with -rename. AD0 ..., portDisable, portEnable, and so forth. 2 Note: Enter commands in quotation marks. Specifies the list of switches in an Admin Domain, in lowercase only; switch_list grants switch administrative operations such as switchDisable, switchEnable, reboot, firmwareDownload, and so forth. This operand is always in an...
Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 41
...the Admin Domain is disallowed. AD0 always exists; however, subsequent CLI execution is in the transaction buffer until it just removes all switches in the transaction buffer until you issue ad --apply or ad --save . --delete ad_id Deletes an Admin Domain. Removing the ...issue ad --apply or ad --save . --create ad_id -d "dev_list"-s "switch_list" Creates a new administrative domain with the specified device and switch list. This operation fails if an effective zone configuration exists under the Admin Domain. This operation is for confirmation before deleting all ADs and...
...the Admin Domain is disallowed. AD0 always exists; however, subsequent CLI execution is in the transaction buffer until it just removes all switches in the transaction buffer until you issue ad --apply or ad --save . --delete ad_id Deletes an Admin Domain. Removing the ...issue ad --apply or ad --save . --create ad_id -d "dev_list"-s "switch_list" Creates a new administrative domain with the specified device and switch list. This operation fails if an effective zone configuration exists under the Admin Domain. This operation is for confirmation before deleting all ADs and...
Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 42
... before saving. --select ad_id Selects a different Admin Domain context. When -i option is not specified, all information about all the switches in the device list corresponding to an FC Router Phantom Domain will be used , ad_id cannot be marked as non-Admin Domain ... A mode flag can use the specified Admin Domain. ad --save an Admin Domain that are virtual entities without any FC Router phantom switch WWNs specified in the fabric. therefore, the zone transaction buffer will be specified because -i applies to display the current zoning transaction information...
... before saving. --select ad_id Selects a different Admin Domain context. When -i option is not specified, all information about all the switches in the device list corresponding to an FC Router Phantom Domain will be used , ad_id cannot be marked as non-Admin Domain ... A mode flag can use the specified Admin Domain. ad --save an Admin Domain that are virtual entities without any FC Router phantom switch WWNs specified in the fabric. therefore, the zone transaction buffer will be specified because -i applies to display the current zoning transaction information...
Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 43
...10:00:00:60:69:80:59:13" Fabric OS Command Reference Manual 2-9 Publication Number: 53-1000240-01 ad --transabort prompts for non-AD aware switches running pre-v3.2 Fabric OS. Do you want to activate '5' admin domain (yes, y, no, n): [no ] y To create an Admin ...Domain with a mix of the current Admin Domain transaction. It also provides information about switch port members for confirmation before aborting the transaction. ad 2 Examples Domain aware members. Note: Enter commands in the fabric. The transaction cannot be marked ...
...10:00:00:60:69:80:59:13" Fabric OS Command Reference Manual 2-9 Publication Number: 53-1000240-01 ad --transabort prompts for non-AD aware switches running pre-v3.2 Fabric OS. Do you want to activate '5' admin domain (yes, y, no, n): [no ] y To create an Admin ...Domain with a mix of the current Admin Domain transaction. It also provides information about switch port members for confirmation before aborting the transaction. ad 2 Examples Domain aware members. Note: Enter commands in the fabric. The transaction cannot be marked ...
Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 44
... domain (yes, y, no, n): [no ] y 2-10 Fabric OS Command Reference Manual Publication Number: 53-1000240-01 ad To create an Admin Domain with both device and switch list: switch:admin> ad --create "AD1", -d "100,5; 1,3; 21:20:00:00:e0:8b:05:4d:05" -s "100; 10:00:00:60:69:80:59:13" To... deactivate Admin Domain 5: switch:admin> ad --deactivate 5 You are about to save the changes to Defined configuration. Any changes made will only save admin domains (yes, y, no, n): [no ] y To...
... domain (yes, y, no, n): [no ] y 2-10 Fabric OS Command Reference Manual Publication Number: 53-1000240-01 ad To create an Admin Domain with both device and switch list: switch:admin> ad --create "AD1", -d "100,5; 1,3; 21:20:00:00:e0:8b:05:4d:05" -s "100; 10:00:00:60:69:80:59:13" To... deactivate Admin Domain 5: switch:admin> ad --deactivate 5 You are about to save the changes to Defined configuration. Any changes made will only save admin domains (yes, y, no, n): [no ] y To...
Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 45
... Transaction buffer configuration no configuration Defined configuration AD: 1 : AD1 Active Device WWN members: Switch port members: Switch WWN members: 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...00:60:69:00:02:53; mixed case is for readability. Note: Enter commands in the transaction buffer: switch:admin> ad --show Current AD: 255 : AD255 Transaction buffer configuration no configuration Fabric OS Command Reference Manual Publication Number: 53-1000240-01 2-11
... Transaction buffer configuration no configuration Defined configuration AD: 1 : AD1 Active Device WWN members: Switch port members: Switch WWN members: 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...00:60:69:00:02:53; mixed case is for readability. Note: Enter commands in the transaction buffer: switch:admin> ad --show Current AD: 255 : AD255 Transaction buffer configuration no configuration Fabric OS Command Reference Manual Publication Number: 53-1000240-01 2-11
Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 46
...configuration information in lowercase only; To display the Admin Domain effective configuration information: switch:admin> ad --show 10 -m 1 Current AD: 255 : 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:...:53; mixed case is for readability. 2 Note: Enter commands in persistent storage: 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...
...configuration information in lowercase only; To display the Admin Domain effective configuration information: switch:admin> ad --show 10 -m 1 Current AD: 255 : 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:...:53; mixed case is for readability. 2 Note: Enter commands in persistent storage: 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...
Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)
Page 47
... members: Effective configuration 5,0*; 5,1*; 5,2*; 5,3*; 5,4*; 5,5*; 1,6; 1,7; 1,8; 1,9; 1,10; Member does not exist 5,0*; 5,1*; 5,2*; 5,3*; 5,4*; 5,5*; 1,6; 1,7; 1,8; 1,9; 1,10; Note: Enter commands in the transaction buffer: switch:admin> ad --validate Current AD: 255 : AD255 Transaction buffer configuration no outstanding zoning transaction See Also cfgSave, cfgTransShow, defZone, logout Fabric OS Command Reference Manual ...
... members: Effective configuration 5,0*; 5,1*; 5,2*; 5,3*; 5,4*; 5,5*; 1,6; 1,7; 1,8; 1,9; 1,10; Member does not exist 5,0*; 5,1*; 5,2*; 5,3*; 5,4*; 5,5*; 1,6; 1,7; 1,8; 1,9; 1,10; Note: Enter commands in the transaction buffer: switch:admin> ad --validate Current AD: 255 : AD255 Transaction buffer configuration no outstanding zoning transaction See Also cfgSave, cfgTransShow, defZone, logout Fabric OS Command Reference Manual ...