Fabric OS Documentation Addendum Supporting Fabric OS v5.2.
Copyright © 2007, Brocade Communications Systems, Incorporated. ALL RIGHTS RESERVED. Brocade, the Brocade B weave logo, Fabric OS, File Lifecycle Manager, MyView, Secure Fabric OS, SilkWorm, and StorageX are registered trademarks and Tapestry is a trademark of Brocade Communications Systems, Inc., in the United States and/or in other countries. All other brands, products, or service names are or may be trademarks or service marks of, and are used to identify, products or services of their respective owners.
Contents About This Document Chapter 1 Fabric OS Command Reference New Commands in v5.2.1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 ag. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 licensePort. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6 portcfgnport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 3 iv AG-1002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 AG-1003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 AG-1004 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 AG-1005 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 AG-1006 . . . . . . . . . . . . . . . . .
Chapter 4 Chapter 5 connUnitLinkTable 1.3.6.1.3.94.1.12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7 connUnitSnsTable 1.3.6.1.3.94.5.2.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8 Web Tools Administrator’s Guide Global Changes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1 Updates for the Brocade 5000 Switch . . . . . . . . . . . . . . . . . . . . . . . . . . .
vi Fabric OS v5.2.
About This Document This document is a procedural guide to help SAN administrators configure and manage a storage area network (SAN) using the Brocade Fabric OS Command Line Interface (CLI).
When procedures or parts of procedures documented here apply to some switches but not to others, this guide identifies which switches are supported and which are not. This document sometimes mentions other Fabric OS releases to highlight the changes in the latest release or to point out interoperability issues with other SilkWorm models. It also specifies when procedures or steps of procedures apply only to specific SilkWorm models.
Key Terms For definitions specific to Brocade and Fibre Channel, see the Brocade Glossary. For definitions of SAN-specific terms, visit the Storage Networking Industry Association online dictionary at: http://www.snia.org/education/dictionary. Additional Information This section lists additional Brocade and industry-specific documentation that you might find helpful.
• • • • • SilkWorm 48000 QuickStart Guide FR4-18i Hardware Reference Manual FR4-18i QuickStart Guide FC4-16IP Hardware Reference Manual FC4-16IP QuickStart Guide SilkWorm 24000 • • SilkWorm 24000 Hardware Reference Manual SilkWorm 24000 QuickStart Guide SilkWorm 24000/48000 • • • • • • • • • Port Blade and Filler Panel Replacement Procedure Control Processor Blade Replacement Procedure Blower Assembly Replacement Procedure Cable Management Tray and Guide Replacement Procedure Chassis Door Replacement
• SilkWorm 3900 Power Supply Replacement Procedure SilkWorm 3250/3850 • • SilkWorm 3250/3850 Hardware Reference Manual (for v4.x software) SilkWorm 3250/3850 QuickStart Guide (for v4.x software) SilkWorm 200E • SilkWorm 200E Hardware Reference Manual (for v5.x software) For practical discussions about SAN design, implementation, and maintenance, you can obtain Building SANs with Brocade Fabric Switches through: http://www.amazon.
Secure Fabric OS Provides a comprehensive security solutions to help protect mission-critical data. Key features include centralized policy-based security management, encryption of management data, and authentication to create a fabric-wide trusted environment with control over all levels of fabric access and communication. FICON CUP Enables IBM host-based management programs to manage FICON fabric switches in-band by sending commands to the Fabric OS emulated control device.
Getting Technical Help Contact your switch support supplier for hardware, firmware, and software support, including product repairs and part ordering. To expedite your call, have the following information available: 1. General Information • • • • • • • • • 2.
3. World Wide Name (WWN) • Brocade 5000, SilkWorm 200E, 3014, 3016, 3250, 3800, 3850, 3900, 4012, 4016, 4018, 4020, 4024, 4100, 4900, 7500 switches and SilkWorm 24000, and 48000 directors: Provide the license ID. Use the licenseIdShow command to display the license ID. • SilkWorm Multiprotocol Router Model AP7420: Provide the switch WWN. Use the switchShow command to display the switch WWN. • All other SilkWorm switches: Provide the switch WWN. Use the wwn command to display the switch WWN.
Chapter Fabric OS Command Reference 1 The following updates in this chapter are for the Fabric OS Command Reference, part number: 53-1000240-01: • • • • “New Commands in v5.2.1” on page 1-2 “Commands Updated in v5.2.1” on page 1-9 “Commands Deprecated” on page 1-59 “Updates for 5.2.
1 New Commands in v5.2.1 Note: Enter commands in lowercase only; mixed case is for New Commands in v5.2.1 Add the following commands that are new in Fabric OS v5.2.1 to the Fabric OS Command Reference as indicated below: • • • 1-2 Add the “ag” command after ad on page 2-14. Add the “licensePort” after licenseIDRemove on page 2-334. Add “portcfgnport” after portcfgLPort on page 2-465.
ag 1 ag Enables and manages the Access Gateway mode to perform AG specific operations.
1 ag Note: Enter commands in lowercase only; mixed case is for readability be mapped. This command overwrites the existing mapping for the N_Port. Specify the list of F_Port numbers to add to the existing specified F_Port to N_Port mapping. The F_Port numbers must be separated my semicolons. Examples --mapdel Removes the specified F_Ports from the N_Port mapping. Specify the N_Port number to which the F_Ports are currently mapped.
ag 1 To display all the F_Ports that are mapped to a given N_Port: ST2:admin> ag --mapshow N_Port Configured_F_Ports Current_F_Ports Failover Failback --------------------------------------------------------------------2 0;1; 0;1; 1 1 3 5;6; 5;6; 1 1 15 9;10;11;12; 9;10;11;12; 1 1 --------------------------------------------------------------------- ST2: admin> ag --mapshow 15 --------------------------------------------------------------------N_Port2 : 15 Failover (1=enabled/0=disabled : 1 Failback (1=e
1 licensePort Note: Enter commands in lowercase only; mixed case is for readability licensePort Manages the Dynamic Ports on Demand (POD) license assignment. Synopsis licensePort --release portnum licensePort --reserve portnum licensePort --show lcensePort --method selection Description Operands Use this command to manage the Dynamic Ports on Demand license assignments.
licensePort 1 To display the Ports on Demand license assignments: sw5:admin> licensePort -show 20 ports are available in this switch 1 POD license is installed Dynamic POD method is in use 15 port assignments are provisioned for use in this switch: 10 port assignments are provisioned by the base switch license 5 port assignments are provisioned by the first POD license * 5 more assignments are added if the second POD license is installed 15 ports are assigned to installed licenses: 10 ports are assigned t
1 portcfgnport Note: Enter commands in lowercase only; mixed case is for readability portcfgnport Enables and disables N_Port functionality for an Access Gateway port. Synopsis Description portcfgnport [port_number] | [mode] Use this command to configure the Access Gateway port as an N_Port in the case where the AG port is connected to the enterprise fabric. The enabled N_Port automatically comes online if it is connected to the enterprise fabric switch that supports NPIV.
Commands Updated in v5.2.1 1 Commands Updated in v5.2.1 The commands in this section were changed to support the new Access Gateway mode and DPOD features. • • • • • • • • • • Replace the “agshow” command. Replace the “configure” command. Replace the “fwConfigure” command. Replace the “fwShow” command. Replace the “ipAddrSet”command. Replace the “ipaddrshow” command. Replace the “portCfgShow” command. Replace the “portshow” command. Replace the “supportSave” command. Replace the “switchshow” command.
1 agshow Note: Enter commands in lowercase only; mixed case is for readability agshow Displays the Access Gateway information registered with the fabric. Synopsis Description agshow [ag_name] | [--local] This command displays the details of the F_Ports and the configured N_Ports in the Access Gateway connected. The lines of display show: 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.
agshow Examples 1 To display the Access Gateway information registered with the fabric. switch:admin> agshow WT_Stealth Name : WT_Stealth NodeName : 10:00:00:05:1e:34:e4:bd N-Port ID(s) : 0x010200 Number of Ports : 16 IP Address(es) : 10.202.90.231 Firmware Version : v1.0.
1 configure Note: Enter commands in lowercase only; mixed case is for readability configure Changes system configuration settings.
configure 1 The Switch Fabric Settings are as follows: Table 2-1 Configure Command Fabric Parameters Field Type Default Range number 1 varies R_A_TOV number 10000 E_D_TOV * 2 to 120000 E_D_TOV number 2000 1000 to R_A_TOV / 2 WAN_TOV number 0 0 to R_A_TOV / 4 MAX_HOPS number 7 7 to 19 Data Field Size number 2112 256 to 2112 Sequence Level Switching boolean 0 0 or 1 Disable Device Probing boolean 0 0 or 1 Suppress Class F Traffic boolean 0 0 or 1 Switch PID Format n
1 configure Note: Enter commands in lowercase only; mixed case is for readability The R_A_TOV, E_D_TOV, WAN_TOV, and MAX_HOPS configuration parameters are inter-related. Assigning a specific value to one or more of these parameters can change the range of allowed values that can be assigned to the other parameters. As a result, the user might not be able to set all the values within the range displayed against each parameter.
configure 1 A Brocade Extended Fabrics license is required to set this mode. BB Credit The buffer-to-buffer (BB) credit represents the number of buffers available to attached devices for frame receipt. The range of allowed values varies depending on other system settings (see Unicast-only Operation).
1 configure Note: Enter commands in lowercase only; mixed case is for readability Zoning Operation Parameters The Zoning Operation Parameter field is as follows: Disable NodeName Zone Checking Specify 1 to disable using node WWN when specifying nodes in the zone database, or specify 0 to enable using node WWN when specifying nodes in the zone data. The default value is 0. This value must be set to 1 for interoperability. RSCN Transmission Mode The RSCN Transmission Mode fields are described in table.
configure 1 Enable CLOSE on OPEN received? If this is set, a CLS is returned immediately to an OPN if no buffers are available. This is required for TachLite. Always send RSCN? Following the completion of loop initialization, a remote state change notification (RSCN) is issued when FL_Ports detect the presence of new devices or the absence of preexisting devices. When set to 1, an RSCN is issued upon completion of loop initialization, regardless of the presence or absence of new or pre-existing devices.
1 configure Note: Enter commands in lowercase only; mixed case is for readability Use the following special input: Return When entered at a prompt with no preceding input, accepts the default value (if applicable) and moves to the next prompt. Interrupt (Ctrl-C) Aborts the command immediately and ignores all changes made. End-of-file (Ctrl-D) When entered at a prompt with no preceding input, terminates the command and saves changes made.
configure 1 Application Attributes Application HTTP, SNMP, and RPCd attributes are configurable; by default, all three attributes are enabled. Refer to the table for the application attributes that can be changed.
1 configure Note: Examples Enter commands in lowercase only; mixed case is for readability To modify configuration settings on a switch: switch:admin> configure Configure... Fabric parameters(yes, y, no, n): [no] yes Domain:(1..239) [1] R_A_TOV: (4000..120000) [10000] E_D_TOV: (1000..5000) [2000] 5000 WAN_TOV: (0..30000) [0] 0 MAX_HOPS: (7..19) [7] Data field size: (256..2112) [2112] Sequence Level Switching: (0..1) [0] 1 Disable Device Probing: (0..1) [0] Switch PID Format: (1..
configure scn(a state change notification pstate(a port changes physical state reject(a received frame is rejected busy(a received frame is busied ctin(a CT based request is received ctout(a CT based response is transmitted errlog(a message is added to the error log loopscn(a loop state change notification create(a task is created 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) ) ) ) ) ) ) ) ) ) ) ) ) ) (on, (on, (on, (on, (
1 configure Note: Enter commands in lowercase only; mixed case is for readability errlog(a message is added to the error log ) debug(generic debug info ) nbrfsm(neighbor state transition ) timer(timer ) sn(speed negotiation state ) (on, (on, (on, (on, (on, off): off): off): off): off): [on] [on] [on] [on] [on] fcin(fc input fcout(fc output read(fc read write(fc write err(fc error frame(fc frame payload nsRemQ(inter-sw NS query nsRemR(inter-sw NS response rscn(RSCN state(fc state xalloc(alloc an excha
fwConfigure 1 fwConfigure Displays and modifies the Fabric Watch configuration. Synopsis Description fwconfigure [--enable --port portNumber] | [--disable --port portNumber] Use this command to display and modify threshold information for the Fabric Watch configuration. Switch elements monitored by Fabric Watch are divided into classes, which are further divided into areas. Each area can include multiple thresholds.
1 fwConfigure Note: Enter commands in lowercase only; mixed case is for readability Table 2-7 fwConfigure Fabric Watch Classes and Areas Class Area AL_PA Performance Monitor Invalid CRCS EE Performance Monitor Invalid CRCS RX Performance TX Performance Filter Performance Monitor Customer Defined Security Telnet Violations HTTP Violations API Violations RSNMP Violations WSNMP Violations SES Violations MS Violations Serial Violations Front Panel Violations SCC Violations DCC Violations Login Vio
fwConfigure 1 .
1 fwConfigure Note: Enter commands in lowercase only; mixed case is for readability Enables all thresholds associated with a certain port. --disable --port portNumber Disables all thresholds associated with a certain port. Note This command requires a Fabric Watch license.
fwConfigure Examples 1 To configure thresholds in Access Gateway mode: ST3:admin> fwconfigure 1 : Environment class 2 : SFP class 3 : Port class 4 : F/FL Port (Optical) class 5 : Resource class 6 : quit Select a class => : (1..6) [6] 1 1 : Temperature 2 : Fan 3 : Power Supply 4 : return to previous page Select an area => : (1..
1 fwShow Note: Enter commands in lowercase only; mixed case is for readability fwShow Displays the thresholds monitored by Fabric Watch. Synopsis Description fwshow [--port --persistence] | [--disable --port] Use this command to display the thresholds monitored by Fabric Watch. This command also displays the port persistence time and ports with all thresholds disabled. In Access Gateway mode, only the following class thresholds are supported.
fwShow Examples 1 To display thresholds and port persistence time: switch:user> fwshow 1 : Show class thresholds 2 : Detail threshold information 3 : Show console message level 4 : Show port persistence time 5 : Quit Select an item => : (1..
1 fwShow Note: Enter commands in lowercase only; mixed case is for readability Env Temperature 1: Monitored for: Last checked: 1283 (21 mins) 10:50:21 on 02/01/2000 Lower bound: Upper bound: Buffer Size: 0 C 75 C 10 Value history: 33 C Disabled? No Locked? No Raw history: Flags: 0x 38 38 38 40 C C C TRIGGERED Counter: Access via: Function call Address: 0x100155a8 Argument: 0x00000001 Previous: 0x00000026 (38) Current: 0x00000026 (38) Events: Style: Triggered Event 0 occurred 1 time, last at 16:
ipAddrSet 1 ipAddrSet Sets the IP address details for a switch or control processor (CP). Synopsis Description ipaddrset [-cp number][-sw number] Use this command to set the IP addresses on the switch or CP. The command’s usage varies depending on whether it is being used on a chassis-based system or non chassis-based switch On a chassis-based system, if no option is provided, the command prints the usage. To set the CP IP address use -cp, to set the switch IP address use -sw.
1 ipAddrSet Note: Examples Enter commands in lowercase only; mixed case is for readability To set the IP address details for switch number 1 on a chassis-based system: switch:admin> ipaddrset -sw 1 Ethernet IP Address [192.168.166.148]: Ethernet Subnetmask [255.255.255.0]: Fibre Channel IP Address [none]: Fibre Channel Subnetmask [none]: Committing configuration...Done. OK. To enable DHCP on a non-chassis-based system: switch:admin>> ipaddrset Ethernet IP Address [192.168.74.
ipaddrshow 1 ipaddrshow Displays the IP address information for a switch or control processor (CP). Synopsis Description ipaddrshow [-cp cp_number] | [-sw sw_number] Use this command to display the IP addresses configured in the system. The -cp option displays the CP IP address and the -sw option displays the switch IP addresses. For switches, the command displays the Ethernet IP address, Ethernet subnetmask, Fibre Channel IP address, and Fibre Channel subnetmask.
1 ipaddrshow Note: Examples Enter commands in lowercase only; mixed case is for readability To set the IP address details for switch number 1 on a chassis-based system.: switch:admin> ipaddrset -sw 1 Ethernet IP Address [192.168.166.148]: Ethernet Subnetmask [255.255.255.0]: Fibre Channel IP Address [none]: Fibre Channel Subnetmask [none]: Committing configuration...Done. OK. To enable DHCP on a non-chassis-based system: switch:admin>> ipaddrset Ethernet IP Address [192.168.74.
portCfgShow 1 portCfgShow Displays port configuration settings. Synopsis portcfgshow [slot/][port] OR portcfgshow [arp | fciptunnel [-ipsec] | ipif | iproute | iscsi | mode ] [slot/][ge]port Description Use this command to display the current configuration of a port. If no operand is specified, this command displays port configuration settings for all ports on a switch, except gigabit Ethernet (GbE) ports.
1 portCfgShow Note: Enter commands in lowercase only; mixed case is for readability RSCN Suppression Displays as ON when the port has RSCN suppression enabled or blank (..) when the port has RSCN suppression disabled. This value is set by the portCfg rscnsupr command. Persistent Disable Displays as ON when the port is persistently disabled. This value is set by the portCfgPersistentDisable command. Mirror Port Mode Displays as ON when the port has Mirror Port Mode enabled or blank (..
portCfgShow Examples 1 To display the configuration settings for a switch: switch:user> portcfgshow Ports of Slot 2 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 -----------------+--+--+--+--+---+--+--+--+----+--+--+--+----+--+--+-Speed AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN Trunk Port ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON Long Distance .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. VC Link Init .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. Locked L_Port .. .. .. .. .. .. .. .. .. .. .. ..
1 portCfgShow Note: Enter commands in lowercase only; mixed case is for readability To display the configuration settings for a port: switch:user> portcfgshow 2/16 Area Number: 144 Speed Level: AUTO Trunk Port ON Long Distance OFF VC Link Init OFF Locked L_Port OFF Locked G_Port OFF Disabled E_Port OFF ISL R_RDY Mode OFF RSCN Suppressed OFF Persistent Disable OFF NPIV capability ON Mirror Port OFF To display the configuration settings for a port with agmode enabled: SW4016_5311:admin> portcfgshow Ports
portshow 1 portshow Displays the status of the specified port. Synopsis portshow [slot] fport OR portshow [ arp | fciptunnel [-perf | -params| -ipsec] | ipif | iproute | iscsi| mode ] [slot] [ge port] Description Use this command to display general or switch and port-specific status information for the specified port. portshow with operands other than slot or ge port will display information specific to the operand given. This will vary with the switch model and port type.
1 portshow Note: Enter commands in lowercase only; mixed case is for readability No_Light Module is not receiving light. No_Sync Receiving light but out of sync. In_Sync Receiving light and in sync. Laser_Flt Module is signaling a laser fault. Port_Flt Port marked faulty. Diag_Flt Port failed diagnostics. Lock_Ref Locking to the reference signal. portScn Last State Change Notification for port. port generation number Port generation number for the last offline state change. portId 24-bit port ID.
portshow 1 assuming the DH-CHAP passwords are configured both on the router and the edge switch, the security type is displayed as “DH_CHAP”. DH-CHAP is the only supported authentication type. DH Group If the EX_Port is connected to an edge switch with no security, then the value is “N/A”. If the edge switch is in secure mode, then the value, 0 through 4, is displayed and is the negotiated value with the edge fabric. This value is not user configurable.
1 portshow Note: Enter commands in lowercase only; mixed case is for readability Note The execution of this command is subject to Admin Domain restrictions that may be in place. Operands This command has the following operands: arp Displays ARP table. Use this operand to display IP addresses, corresponding MAC addresses, and flags.
portshow Examples 1 To display the state of a port: switch:user> portshow 0 portName: portHealth: OFFLINE Authentication: None portDisableReason: None portCFlags: 0x1 portFlags: 0x4001 PRESENT U_PORT LED portType: 4.
1 portshow Note: Enter commands in lowercase only; mixed case is for readability To display the connection parameter information on an FCIP tunnel on a GbE port: switch:admin> portshow fciptunnel ge1 0 -params Port: ge1 ------------------------------------------Tunnel ID 0 Remote IP Addr 192.168.255.200 Local IP Addr 192.168.255.100 Remote WWN Not Configured Local WWN 10:00:00:05:1e:35:16:b9 Compression on Fastwrite off Tape Pipelining off Uncommitted bandwidth, minimum of 1000 Kbps (0.
portshow 1 To display the connection IPSec information on an FCIP tunnel on a GbE port: switch:admin> portshow fciptunnel 8/ge0 -ipsec Port: ge0 ------------------------------------------Tunnel ID 3 Remote IP Addr 192.175.5.200 Local IP Addr 192.175.5.100 Remote WWN Not Configured Local WWN 10:00:00:05:1e:37:00:20 Compression off Fastwrite on Tape Pipelining on Uncommitted bandwidth, minimum of 1000 Kbps (0.
1 portshow Note: Enter commands in lowercase only; mixed case is for readability To display iSCSI Port WWN and Sessions: switch:admin> portshow isci 2/ge0 GE Port 2/ge0 Port WWN Sessions ----------------------------------50:06:06:9e:40:09:a2:00 0 See Also 1-46 authUtil, portCfg, portCfgLongDistance, portLoginShow, portName, switchShow Fabric OS Documentation Addendum Publication Number: 53-1000429-01-HP
supportSave 1 supportSave Saves RASLOG, TRACE, supportShow, core file, FFDC data, and other support information. Synopsis Description supportsave [-n][-c][-u user_name -p password] -h host_ip -d remote_dir [-R] Use this command to collect RASLOG, TRACE, supportShow, core file, FFDC data and other support information to a remote FTP location. On a dual CP system, the local and remote CP's information will be saved. SupportShow information is available on Active and Standby CPs.
1 supportSave Note: Examples Enter commands in lowercase only; mixed case is for readability To save RASLOG, TRACE, supportShow, and other support information to an FTP server in noninteractive mode: switch:admin> supportsave This command collects RASLOG, TRACE, supportShow, core file, FFDC data and other support information and then transfers them to an FTP server. Only the local CP's and BP's information is saved and supportShow information is only available on the Active CP.
1 supportSave Saving support information for switch:routing1, module:RCS_Log... ...supportSave_files/routing1-S6-200508280207-RCS_Log.ss: 4.65 kB Saving support information for switch:swd76, module:RCS_Log... ...supportSave_files/swd76-S6-200508280208-RCS_Log.ss: 9.05 kB 1.55 kB/s 3.02 kB/s Saving support information for switch:routing1, module:NS_evlog... .../supportSave_files/routing1-S6-200508280208-NS_evlog.ss: 1.62 kB 551.19 B/s Saving support information for switch:swd76, module:NS_evlog...
1 supportSave Note: Enter commands in lowercase only; mixed case is for readability switch:admin> supportsave This command will collect RASLOG, TRACE, supportShow, core file, FFDC data and other support information and then transfer them to a FTP server. Only the local CP's and BP's information will be saved and supportShow information is only available on the Active CP. This operation can take several minutes.
supportSave 1 Saving support information for switch:routing1, module:FSPF_Log... ...e_files/routing1-S6-200508280208-FSPF_Log.ss: 2.04 kB 694.31 B/s Saving support information for switch:routing1, module:CORE_FFDC... No core or FFDC data files found! Saving support information for switch:routing1, module:CHKCONFIG... ...e_files/routing1-S6-200508280208-CHKCONFIG.ss: 1.04 kB 694.31 B/s Saving support information for switch:routing1, module:CONSOLE... ...e_files/routing1-S6-200508280208-CONSOLE: 64 kB 694.
1 switchBeacon Note: Enter commands in lowercase only; mixed case is for readability switchBeacon Sets switch beaconing mode on or off. Synopsis Description switchbeacon [mode] Use this command to enable or disable switch beaconing mode. 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 then back to port 0. The beaconing mode continues until you turn it off. Beaconing mode can be used to locate a failing unit.
switchshow 1 switchshow Displays switch and port status. Synopsis Description switchshow [-portcount] [-iscsi] Use this command to display switch and port status information. Information might vary by switch model: for instance, number of ports and domain ID values. Note For all Bloom and Bloom 2-based platforms, private device targets are displayed in switchShow. For Condor or Goldeneye-based platforms, private device targets are not displayed in switchShow.
1 switchshow Note: Enter commands in lowercase only; mixed case is for readability Speed Port State -- no module present sw shortwave laser lw longwave laser cu copper id serial ID The speed of the port: 1/8G 125 Mbit/sec 1/4G 250 Mbit/sec 1/2G 500 Mbit/sec 1G 1 Gbit/sec fixed transfer speed N1 1 Gbit/sec negotiated transfer speed 2G 2 Gbit/sec fixed transfer speed N2 2 Gbit/sec negotiated transfer speed 4G 4 Gbit/sec fixed transfer speed N4 4 Gbit/sec negotiated transfer spe
switchshow 1 Lock_Ref Locking to the reference signal. Testing Running diagnostics. Offline Connection not established (for virtual ports only). Online Port is up and running. Proto comment Protocol support by GE port. ISCSI Ports support ISCSI. FCIP Ports support FCIP. The comment field is blank, or displays: Disabled Port is disabled. Bypassed Port is bypassed (loop only). Loopback Port is in loopback mode. E_Port Fabric port; displays WWN and name of attached switch.
1 switchshow Note: Enter commands in lowercase only; mixed case is for readability only). Fabric ID oversubscribed One fabric has been assigned two different fabric IDs (EX_Ports only). If a port is configured as a long distance port, the long distance level is displayed in the format of Lx, where x represents the long distance level number. See portCfgLongDistance for the level description.
switchshow 1 To display switch information: top_4a3_a10:admin> switchshow switchName: top_4a3_a10 switchType: 42.
1 switchshow Note: Enter commands in lowercase only; mixed case is for readability To display switchShow with agmode enabled: switch:admin> switchName: switchType: switchState: switchMode: switchWwn: switchBeacon: switchshow switch 34.
Commands Deprecated 1 Commands Deprecated No commands were deprecated for v5.2.1. The following commands were deprecated for v5.2.0: • The auditShow command is deprecated in this release. Remove the command and any references to it. Note that equivalent functionality is available using the auditcfg -show command. Updates for 5.2.
1 1-60 Updates for 5.2.
Chapter Fabric OS Message Reference 2 The following updates in this chapter are for the Fabric OS Message Reference, part number 53-1000242-01.
2 Updates to the Introduction Chapter Updates to the Introduction Chapter Add the following row to the System Modules Descriptions tabe on page 1-15. AG Access Gateway mode messages of the Fabric OS. New Chapter, AG System Messages Add a new chapter titled AG System Messages after the Introduction and before the AUTH System Messages; it contains all the new messages for the feature, Brocade Access Gateway mode.
AG-1003 2 AG-1003 Message , [AG-1003], ,, WARNING, , Not able to fail over N_Port . Fail over across different fabric is not supported. Probable Cause Recommended Action Severity Indicates that an F_Port could not be failed over to another N_Port because no other N_Ports were connected to the same fabric as N_Port that went offline. Connect two or more N_Ports to the same fabric and then enable failover on these N_Ports using the ag --failoverenable command.
2 AG-1006 AG-1006 Message , [AG-1006], ,, WARNING, , FLOGI request was not received from F_Port . Port is being disabled Probable Cause Recommended Action Indicates that the F_Port that connects to the host did not send FLOGI request for 10 times E_D_TOV. F_Port is disabled. Verify the HBA driver configuration of the host connected to the specified F_Port. Access Gateway supports Fabric mode connectivity only.
AG-1009 2 AG-1009 Message , [AG-1009], ,, WARNING, , FLOGI sent from N-Port failed Probable Cause Recommended Action Severity Indicates that the fabric login (FLOGI) request sent to the fabric switch from the Access Gateway failed. Verify the configuration of the fabric switch. If the message persists, run supportFtp (as needed) to set up automatic FTP transfers; then run the supportSave command and contact your switch service provider.
2 AG-1012 AG-1012 Message , [AG-1012], ,, WARNING, , FDISC sent from N-Port failed Probable Cause Recommended Action Severity Indicates that the N_Port logout request sent to the fabric switch from the Access Gateway failed. Verify the configuration of the fabric switch. If the message persists, run supportFtp (as needed) to set up automatic FTP transfers; then run the supportSave command and contact your switch service provider.
Chapter Fabric OS MIB Reference 3 The following updates in this chapter are for the Fabric OS MIB Reference, part number 53-1000241-01.
3 Updates to the Introduction Updates to the Introduction Add the “Using Access Gateway with Brocade MIBs” on page 3-2 of this document to the Introduction chapter on page 1-8 after the SilkWorm 7500 / FR4-18i and Brocade MIBs section. Using Access Gateway with Brocade MIBs Brocade Access Gateway supports the following MIBs: Table 3-1 3-2 Access Gateway MIB Support MIB Name Supported Description MIB-2 Yes Updated to support Access Gateway in v5.2.1.
Updates to the MIB-II (RFC1213-MIB) 3 Updates to the MIB-II (RFC1213-MIB) Update the default section of both sysDescr and sysObjectID in the System Groups section on page 2-9, with the following information. sysDescr 1.3.6.1.2.1.1.1 Default The switch type. The default value is either Fibre Channel Switch or Access Gateway. sysObjectID 1.3.6.1.2.1.1.2 Default The device type. The default value is either: • Fibre Channel Switches: iso.org.dod.internet.private.enterprises.bcsi.commDev.fibrechannel.
3 Updates to the FibreAlliance MIB Objects Updates to the FibreAlliance MIB Objects Update the sections below as follows: • • • • • • • • • • • • • Update the “connUnitType 1.3.6.1.3.94.1.6.1.3” section on page 8-10. Update the “connUnitProduct 1.3.6.1.3.94.1.6.1.7” section on page 8-11. Update the “connUnitDomainId 1.3.6.1.3.94.1.6.1.11” section on page 8-12. Update the “connUnitPrincipal 1.3.6.1.3.94.1.6.1.13” section on page 8-12. Update the “connUnitInfo 1.3.6.1.3.94.1.6.1.21” section on page 8-14.
connUnitInfo 1.3.6.1.3.94.1.6.1.21 3 If the switch is principal, this is set to 3 (yes); otherwise, for a fabric switch it is set to 2 (no). For a Brocade Access Gateway device, since the switch is behaving as a device management tool and not a Fibre Channel switch, the value is set to 1 (unknown). Values Possible values are: • • • unknown (1) no (2) yes (3) connUnitInfo 1.3.6.1.3.94.1.6.1.21 A display string containing information about this connectivity unit.
3 connUnitPortFCClassCap 1.3.6.1.3.94.1.10.1.4 Values Possible values are: • • • • • • • • • • • • • • • • • • • unknown (1) other (2) not-present (3) hub-port (4) n-port (5) End port for fabric. l-port (6) End port for loop. fl-port (7) Public loop. f-port (8) Fabric port. e-port (9) Fabric expansion port. g-port (10) Generic fabric port. domain-ctl (11) Domain controller. hub-controller (12) scsi (13) Parallel SCSI port. escon (14) lan (15) wan (16) ac (17) AC power line.
connUnitPortFCClassOp 1.3.6.1.3.94.1.10.1.5 3 connUnitPortFCClassOp 1.3.6.1.3.94.1.10.1.5 Bit mask that specifies the classes of service that are currently operational. If this is not applicable, return all bits set to 0. This object has the same definition as connUnitPortFCClassCap. For an F_Port or FL_Port, this value is 0x000C. For a G_Port or E_Port, this value is 0x000D. For a Brocade Access Gateway both the F_Port and N_Port this value is 0x0008.
3 connUnitSnsTable 1.3.6.1.3.94.5.2.1 The link table is intended to organize and communicate any information the agent has that might assist a management application to discover the connectivity units in the framework and the topology of their interconnect: the goal is to assist the management application by mapping the elements of the framework in addition to listing them.
Chapter Web Tools Administrator’s Guide 4 The following updates in this chapter are for the Web Tools Administrators Guide, part number 53-0000194-01: • • • “Global Changes” on page 4-1 “Add Using WebTools on a Brocade Access Gateway” on page 4-2 “Replace the Activating Ports Section” on page 4-3 Global Changes This section explains the global changes required to support hardware specific instructions: • • “Updates for the Brocade 5000 Switch” on page 4-1 “Updates for SilkWorm 4012, 4016, 4018, 4020
4 Add Using WebTools on a Brocade Access Gateway Add Using WebTools on a Brocade Access Gateway Add the following new section titled “Using Web Tools on a Brocade Access Gateway” after Working with Web Tools: Recommendations on page 2-16. Using Web Tools on a Brocade Access Gateway When Access Gateway mode is enabled on switches managed through Web Tools, only a limited subset of menus and options related to device management are available.
Replace the Activating Ports Section 4 Replace the Activating Ports Section Replace the “Activating Ports” section beginning on page 5-12. Activating Ports Brocade switches come with a preset number of ports enabled. Additional ports can be enabled using the Ports on Demand licenses and the Dynamic Ports on Demand feature (for supported switches only). Ports on Demand is ready to be unlocked in the switch firmware.
4 Replace the Activating Ports Section To unlock a Ports on Demand license, you can use the supplied license key or generate a license key. If you need to generate a key, launch an Internet browser and go to the Brocade Web site at www.brocade.com. Click Products > Software License Keys and follow the instructions to generate the key. To enable Ports on Demand 1. Install the Brocade Ports on Demand licensed product. For instructions, see “Activating a License on a Switch” on page 3-15. 2.
Replace the Activating Ports Section 4 Two fields are displayed (see callout 2 in Figure 4-1) : • Available Licenses indicate the number of free licenses. These can be allocated for any port. • Total Licenses indicate the total number of licenses. Figure 4-1 Enabling and disabling Dynamic Ports on Demand To disable Dynamic Ports on Demand Note Disabling DPODs causes traffic disruption. Any prior port associations and assignments are lost the next time the switch is rebooted.
4 Replace the Activating Ports Section Reserving and Releasing Licenses On a Port Basis You must be logged in as Admin to reserve and release licenses. Note If the Admin Domains feature is enabled, the Dynamic POD configuration is only applied to the ports if the switch is a member of the current Admin Domain. The Dynamic PODs feature is supported on the SilkWorm 4018, 4020, and 4024 switches only. You must disable the port or switch before reserving or releasing a license. 1.
Chapter iSCSI Administrator’s Guide 5 The following updates in this chapter are for the iSCSI Administrators Guide, part number 53-1000412-01. Replace iSCSI Target Gateway Scalability Guidelines Table On page A-1, replace the iSCSI Target Gateway Scalability Guidelines table with the following table.
5 5-2 Replace iSCSI Target Gateway Scalability Guidelines Table Fabric OS Documentation Addendum Publication Number: 53-1000429-01-HP
