You are on page 1of 28

Configuring Brocade Switches and Directors

Configure Brocade Switches and Directors V0.90


Noel Milton Vega Rensselaer Technology Group, LTD.

January 2008

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 1 of

Configuring Brocade Switches and Directors

Diagrams of the switches or directors that will be configured


These diagrams are intended to orient you to the hardware before you arrive at the site. Change these diagrams as necessary. Note that the syntax of some Fabric O/S commands in the pages that follow can change depending on the version of Fabric O/S installed *and* also depending on whether you are configuring a switch or director (i.e. Directors will usually have more command options/switches to specify which blade number, controller number, etc. to operate on). For this reason, it is recommended to have the Fabric OS Command Reference (PDF) Manual handy so that you can look up syntax variations or substitutes for the commands presented in the pages that follow.

Brocade 4900 Switch

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 2 of

Configuring Brocade Switches and Directors

PART I: SETTING UP THE SWITCH/DIRECTOR


Step 0: Using the appropriate serial cable (RJ-45 / RS-232 / USB-to-Serial, and end converter adapters if necessary); connect a laptop to the switch via their respective serial interfaces. Next, using a vt100 ASCII capable terminal program (like SecureCRT or the Unix tip(1) command), connect to the switch and configure initial parameters as follows: Bits per second: 9600 Databits: 8 Parity: None Stop bits: 1 Flow control: None In a UNIX environment, enter the following command at the prompt: Root# tip -9600 /dev/term/b (tip -9600 /dev/ttyb)

Step 1: Log into the switch. login: admin password: ****** (The default password is password) Step 2: Set the management IP network parameters of the switch (and, optionally, the FCIP/iFCP network parameters too). mySwitch01:admin> ipaddrset Ethernet IP Address [192.168.74.102]: 192.168.0.100 Ethernet Subnetmask [255.255.255.0]: 255.255.255.0 Fibre Channel IP Address [0.0.0.0]: <CR> or IP if using FCIP Fibre Channel Subnetmask [0.0.0.0]: <CR> of netmask if using FCIP Gateway IP Address [0.0.0.0]: 192.168.0.1 DHCP [Off]: off mySwitch01:admin> ipAddrShow [ ... output omitted ... ] To continue the configuration process over an IP connection, at this point you can connect a laptop to the switch management Ethernet port using a back-to-back crossover Ethernet cable, as shown in the diagram below. Laptop-to-switch IP connectivity will be needed to update the switch firmware(s) over either of FTP/SSH/NFS protocols. In keeping with the example IP address used in Step 2 (above) we will assume that the laptop IP address is temporarily set to: 192.168.0.101/24. Well also assume that the FTP/SSH user profile setup for firmware upgrade (firmwareDownload(1M)) and configuration backup/restore (configDownload/configUpload(1M)) purposes is as follows: FTP/SSH user.............: brocade User Password............: brocade User Home directory......: C:\temp\brocade\

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 3 of

Configuring Brocade Switches and Directors


Laptop (192.168.0.101/24) FC Switch or Director (192.168.0.100/24) FTP/SSH Server ; Web Browser

Crossover Ethernet cable

Step 3: Check the version of the switchs kernel, Fabric O/S, BootPROM, etc. If necessary, update these components using the following procedure. Note: Since it uses a Linux kernel, the kernel version is actually a Linux kernel version. mySwitch01:admin> version Kernel: 2.4.19 Fabric OS: v5.2.0v5.2.0_pit_060911_0600 Made on: Mon Sep 11 18:55:09 2006 Flash: Mon Sep 11 19:26:15 2006 BootProm: 4.5.3

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 4 of

Configuring Brocade Switches and Directors


Step 3.1: Upgrade the various firmware versions on the switch. IMPORTANT: RUN THE FOLLOWING COMMANDS FROM THE SERIAL TERMINAL PROMPT (NOT FROM AN IP BASED CONNECTION). Syntax: firmwareDownload [ -s [ -b | -n ] ] [ -p ftp | scp ] [ -c ] host, user, pfile, passwd (See Fabric O/S Command Reference for option description). mySwitch01:admin> firmwareDownload -s -n -p ftp 192.168.0.101,brocade,release.plist,brocade mySwitch01:admin> reboot or- fastboot Note: Instead or reboot, you can use fastboot which is similar to reboot except that POST bypassed. However fastboot is not recommended after a firmware upgrade, since youll want to look for console errors while the switch is booting. Use fastboot only if devices connected to the switch being rebooted do not have alternate paths to the resources provided through that switch. Also note that if the diagDisablePost was run sometime previously, then fastboot and reboot are equivalent. (Next, after reboot is complete) mySwitch01:admin> firmwareCommit Validating primary partition... Doing firmwarecommit now. Please wait ... Replicating kernel image ............... FirmwareCommit completes successfully. Note: See firmwareRestore is something goes wrong and it is necessary to revert to the previous firmware levels. It is possible to run the firmwareDownload command with options to automatically initiate the reboot and firmwareCommit commands on the switch or director controller on which it is run. However, since we do not know the High Availability characteristics/configuration of the switch/director being upgraded, we choose firmwareDownload options that allow us to manually control the reboot and firmwareCommit phases. Finally, note that running the firmwareDownload command with no options, starts a dialogue with interactive prompt for parameters.

Except for commands that may require a reboot of the switch, or which may initiate a reboot automatically, the remaining steps can be performed from an IP based login. Step 4: Set the switch new password. switch:admin> switch:admin> passwd admin Changing password for admin Enter new password: ******* Re-type new password: ******* Password changed. Saving password to stable storage. Password saved to stable storage successfully.

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 5 of

Configuring Brocade Switches and Directors


Step 5: Set the switch name (Note: This causes an address format RSCN just FYI). switch:admin> switchName mySwitch01 mySwitch01:admin> switchName mySwitch01

Step 6: Set Modify the powered on already in reset to a

the Unique domain ID of the switch. domain ID if required. The default domain ID is 1. If the switch is not until AFTER it is connected to the fabric AND the default domain ID is use within the fabric, the domain ID for the new switch is automatically unique value.

If the switch is connected to the fabric after is has been powered on, and the default domain ID is already in use, the fabric segments. A domain ID can be any number from 1 to 239 inclusive. To find the domain IDs that are currently in use, run the fabricShow command on another switch already participating in the fabric (column 1 of the output indicates the domain ID). Example: mySwitch01:admin> fabricShow SwitchID WorldwideName Enet_IPAddr FC_IP Addr Name ------------------------------------------------------------------------64: fffc40 10:00:00:60:69:00:06:56 192.168.64.59 192.168.65.59 "sw5" 65: fffc41 10:00:00:60:69:00:02:0b 192.168.64.180 192.168.65.180 "sw180" 66: fffc42 10:00:00:60:69:00:05:91 192.168.64.60 192.168.65.60 "sw60" 67: fffc43 10:00:00:60:69:10:60:1f 192.168.64.187 0.0.0.0 "sw187" The Fabric has 4 switches mySwitch01:admin> switchDisable mySwitch01:admin> configure The command prompts display sequentially. Enter a new value or press Enter <CR> to accept each default value.

(a) Enter y after the Fabric parameters prompt:


Fabric parameters (yes, y, no, n): [no] y (c) Enter a unique domain ID: Domain: (1..239) [1] 3

(d) Complete the remaining prompts, or press Ctrl-D to accept the remaining
settings without completing all the prompts. mySwitch01:admin> configShow mySwitch01:admin> switchEnable For a complete set of configurable options available via the configure command, see appendix A.

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 6 of

Configuring Brocade Switches and Directors


Step 7: Turn off the In-Order-Delivery (IOD) option (on is highly discouraged). Use the iodReset command to turn off the IOD option. The IOD option is turned off by default. However, if the IOD option was turned on using iodSet, this command can be used to turn it off again. Disabling IOD allows fast re-routing after a fabric topology change. This command may cause out-of-order delivery of frames during fabric topology changes. mySwitch01:admin> iodReset mySwitch01:admin> iodShow IOD is not set Use this command to enforce in-order delivery of frames during a fabric topology change. In a stable fabric, frames are always delivered in order, even when the traffic between switches is shared among multiple paths. However, when topology changes occur in the fabric (for instance, a link goes down), traffic is rerouted around the failure and some frames might be delivered out of order. This command ensures that frames are not delivered out-of-order, even during fabric topology changes. The default behavior is for the IOD option to be off. This command should be used with caution, because it can cause a delay in the establishment of a new path when a topology change occurs. Only if there are devices connected to the fabric that do not tolerate occasional out-of-order delivery of frames, should this command be used. switch:admin> iodSet switch:admin> iodShow IOD is set (Highly discouraged).

Step 8: Set date/time of the switch manually or by NTP server, and its timezone. mySwitch01:admin> date mmddHHMMyy mySwitch01:admin> date "0227123007" Thu Feb 27 12:30:00 UTC 2007 mySwitch01:admin> date Thu Feb 27 12:30:02 UTC 2007 mySwitch01:admin> tstimezone hourOffsetFromUTC mySwitch01:admin> tstimezone -5 (#Sets the timezone to EST) -ormySwitch01:admin> tsclockserver <ipAddress-of-reachable-NTPserver> Step 9: Set the IDLE login session timeout. mySwitch01:admin> timeout IDLE Timeout is set to 10 minutes. mySwitch01:admin> timeout 15 IDLE Timeout Changed to 15 minutes The modified IDLE Timeout will be in effect after NEXT login (Note: Specifying a value of 0 disables timeouts).

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 7 of

Configuring Brocade Switches and Directors


Step 10: Add and/or display feature enabling license keys. After you enter a license, the licensed product is available immediately and the system does not need to be rebooted. An exception to this general handling is that the switch must be rebooted if a fabric license is added to a switch that lacks a fabric license. In this case, the switch must be rebooted to allow the software to recognize the license and initialize itself correctly. Also, there is special handling required when a trunking license is added to the switch. For a trunking license to become effective, the trunk ports need to be refreshed using the commands portDisable and portEnable or the switch must be refreshed using the commands switchDisable and switchEnable. mySwitch01:admin> licenseAdd "aBcDeFGh12345" adding license key "aBcDeFGh12345" mySwitch01:admin> licenseShow bQebzbRdScRfc0iK: Web license Zoning license aBcDeFGh12345678: Fabric license Step 11: Set and/or show the policies for handling switch status changes. mySwitch01:admin> switchStatusPolicySet Follow the prompts. See Appendix A for details on this command. mySwitch01:admin> switchStatusPolicyShow Step 12: Plug in SFPs, end devices, and inspect output of the following commands. mySwitch01:admin> nsAllShow mySwitch01:admin> fabricShow mySwitch01:admin> configShow mySwitch01:admin> portShow mySwitch01:admin> switchShow

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 8 of

Configuring Brocade Switches and Directors PART II: CONFIGURING ALIAS/MEMBERS, ZONES, ZONESETS (by example)
In this section we provide an example for configuring aliases/members, zones, and zoneSets (in that order) on a Brocade switch. Pay attention to the shell prompt (mySwitch01 or mySwitch02) as it will tell you which switch the command to its right were executed on. For your site, simply make the appropriate substitutions for Alias names, WWPNs, Zone names, ZoneSet (i.e. configuration container) names. ####################################################### # Create Brocade Fabric O/S Zone Member Aliases. # ####################################################### Create member aliases for mySwitch01 ############################## # Server HBA's (brocade-sw1) # ############################## mySwitch01:admin> aliCreate "PROD_DB3_PCIslot2", mySwitch01:admin> aliCreate "PROD_DB4_PCIslot2", mySwitch01:admin> aliCreate "PROD_ERP3_PCIslot2", mySwitch01:admin> aliCreate "PROD_ERP4_PCIslot2",

"21:00:00:e0:8b:06:22:ed" "21:00:00:e0:8b:03:3c:6c" "21:00:00:e0:8b:01:77:86" "TBD"

############################## # Storage Ports (brocade-sw1 # ############################## mySwitch01:admin> aliCreate "FC4700_SPA_Port0", "50:06:01:60:fb:00:00:00" mySwitch01:admin> aliCreate "FC4700_SPB_Port0", "50:06:01:68:fb:00:00:00" Create member aliases for mySwitch02 ############################## # Server HBA's (brocade-sw2) # ############################## mySwitch02:admin> aliCreate "PROD_DB3_PCIslot4", "21:00:00:e0:8b:03:28:e1" mySwitch02:admin> aliCreate "PROD_DB4_PCIslot4", "21:00:00:e0:8b:01:72:86" mySwitch02:admin> aliCreate "PROD_ERP3_PCIslot4", "TBD" mySwitch02:admin> aliCreate "PROD_ERP4_PCIslot4", "TBD" ############################## # Storage Ports (brocade-sw2 # ############################## mySwitch02:admin> aliCreate "FC4700_SPA_Port1", "50:06:01:61:fb:00:00:00" mySwitch02:admin> aliCreate "FC4700_SPB_Port1", "50:06:01:69:fb:00:00:00"

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 9 of

Configuring Brocade Switches and Directors


####################################################### # Create Brocade Fabric O/S Zones. # ####################################################### ############################## # Zones for brocade-sw1 # ##############################
mySwitch01:admin> mySwitch01:admin> mySwitch01:admin> mySwitch01:admin> zoneCreate zoneCreate zoneCreate zoneCreate "PROD_DB3_PCIslot2_FC4700_SPA_Port0", "PROD_DB3_PCIslot2_FC4700_SPB_Port0", "PROD_DB4_PCIslot2_FC4700_SPA_Port0", "PROD_DB4_PCIslot2_FC4700_SPB_Port0", "PROD_DB3_PCIslot2; "PROD_DB3_PCIslot2; "PROD_DB4_PCIslot2; "PROD_DB4_PCIslot2; FC4700_SPA_Port0" FC4700_SPB_Port0" FC4700_SPA_Port0" FC4700_SPB_Port0"

mySwitch01:admin> zoneCreate "PROD_ERP3_PCIslot2_FC4700_SPA_Port0", "PROD_ERP3_PCIslot2; FC4700_SPA_Port0" mySwitch01:admin> zoneCreate "PROD_ERP3_PCIslot2_FC4700_SPB_Port0", "PROD_ERP3_PCIslot2; FC4700_SPB_Port0"

############################## # Zones for brocade-sw2 # ##############################


mySwitch02:admin> mySwitch02:admin> mySwitch02:admin> mySwitch02:admin> zoneCreate zoneCreate zoneCreate zoneCreate "PROD_DB3_PCIslot4_FC4700_SPA_Port1", "PROD_DB3_PCIslot4_FC4700_SPB_Port1", "PROD_DB4_PCIslot4_FC4700_SPA_Port1", "PROD_DB4_PCIslot4_FC4700_SPB_Port1", "PROD_DB3_PCIslot4; "PROD_DB3_PCIslot4; "PROD_DB4_PCIslot4; "PROD_DB4_PCIslot4; FC4700_SPA_Port1" FC4700_SPB_Port1" FC4700_SPA_Port1" FC4700_SPB_Port1"

############################################################################### # Create Brocade Fabric O/S Zones Sets (a.k.a Zone Configurations Container). # ############################################################################### ---------------------------------------------------------------------Note: It is possible to include more semicolon (;) seperated Zones within the cfgCreate / cfgAdd commands below, but eventually the lines become too long for the Brocade Fabric O/S shell to handle. So we play it safe and create the ZoneSet with one Zone (via cfgCreate), and then add one Zone at a time (via cfgAdd). ---------------------------------------------------------------------############################# # Zone Sets for brocade-sw1 # #############################
mySwitch01:admin> mySwitch01:admin> mySwitch01:admin> mySwitch01:admin> mySwitch01:admin> mySwitch01:admin> cfgCreate cfgAdd cfgAdd cfgAdd cfgAdd cfgAdd "PROD_ZONE1_SW1", "PROD_ZONE1_SW1", "PROD_ZONE1_SW1", "PROD_ZONE1_SW1", "PROD_ZONE1_SW1", "PROD_ZONE1_SW1", "PROD_DB3_PCIslot2_FC4700_SPA_Port0" "PROD_DB3_PCIslot2_FC4700_SPB_Port0" "PROD_DB4_PCIslot2_FC4700_SPA_Port0" "PROD_DB4_PCIslot2_FC4700_SPB_Port0" "PROD_ERP3_PCIslot2_FC4700_SPA_Port0" "PROD_ERP3_PCIslot2_FC4700_SPB_Port0"

mySwitch01:admin> cfgSave mySwitch01:admin> cfgShow mySwitch01:admin> cfgEnable "PROD_ZONE1_SW1"

############################# # Zone Sets for brocade-sw2 # #############################


mySwitch02:admin> mySwitch02:admin> mySwitch02:admin> mySwitch02:admin> cfgCreate cfgAdd cfgAdd cfgAdd "PROD_ZONE1_SW2", "PROD_ZONE1_SW2", "PROD_ZONE1_SW2", "PROD_ZONE1_SW2", "PROD_DB3_PCIslot4_FC4700_SPA_Port1" "PROD_DB3_PCIslot4_FC4700_SPB_Port1" "PROD_DB4_PCIslot4_FC4700_SPA_Port1" "PROD_DB4_PCIslot4_FC4700_SPB_Port1"

mySwitch02:admin> cfgSave mySwitch02:admin> cfgShow mySwitch02:admin> cfgEnable "PROD_ZONE1_SW2"

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 10 of

Configuring Brocade Switches and Directors

APPENDIX A: SELECT COMMAND MANUAL PAGES.


CheatSheetofBrocadeCLIcommands: help-printsavailablecommands switchdisabled-disabletheswitch switchenable-enabletheswitch licensehelp-licensecommands diaghelp-diagnosticcommands configure-changeswitchparameters(BBcredits,etc) diagshow-POSTresultssincelastboot routehelp-routingcommands switchshow-displayswitchshow(normallyfirstcommandtoruntoobtainswitch configuration) supportshow-fulldetailedswitchinfo portshow#-displayportinfo nsshow-namesevercontents nsallshow-NSforfullfabric fabricshow-Fabricinformation version-firmwarecoderevision reboot-fullrebootwithPOST fastboot-rebootwithoutPOST zonecreate(zone)-createazone zoneshow-showsdefinedandeffectivezonesandconfigurations zoneadd-addsamembertoazone zoneremove-removesamemberfromazone zonedelete-deleteazone cfgcreate(zoneset)-createazonesetconfiguration cfgadd-addsazonetoazoneconfiguration cfgshow-displaythezoninginformation cfgenable-enableazoneset cfgsave-savesdefinedconfigtoallswitchesinfabricacrossreboots cfgremove-removesazonefromazoneconfiguration cfgdelete-deletesazonefromazoneconfiguration

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 11 of

Configuring Brocade Switches and Directors

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 12 of

Configuring Brocade Switches and Directors

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 13 of

Configuring Brocade Switches and Directors

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 14 of

Configuring Brocade Switches and Directors

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 15 of

Configuring Brocade Switches and Directors

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 16 of

Configuring Brocade Switches and Directors

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 17 of

Configuring Brocade Switches and Directors

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 18 of

Configuring Brocade Switches and Directors

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 19 of

Configuring Brocade Switches and Directors

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 20 of

Configuring Brocade Switches and Directors

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 21 of

Configuring Brocade Switches and Directors

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 22 of

Configuring Brocade Switches and Directors

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 23 of

Configuring Brocade Switches and Directors

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 24 of

Configuring Brocade Switches and Directors

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 25 of

Configuring Brocade Switches and Directors

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 26 of

Configuring Brocade Switches and Directors

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 27 of

Configuring Brocade Switches and Directors

Noel Milton Vega Rensselaer Technology Group, LTD.

Page 28 of

You might also like