Brocade SAN switch CLI command List

Index

1. 2. 3. 4. 5. 6. 7. 8. 9.

Show Commands Port Setting commands Setting Commands Time and Date commands License Commands Password Commands User configuration commands Zoning commands Firmware commands

10. Banner commands 11. Node commands 12. Other Useful commands 13. Log collection

14. How to get the list of device node WWN's?

15.

How to check whether my host is logged in or not thru CLI?

16. How to validate a zoning in between Initiator and Target? 17. Brocade health check commands 18. ISL and Trunking 19. Zoning

Prep: Sandeep Reddy

Introduction:
Brocade Communications Systems, Inc. is an American multinational corporation and a technology company specializing in data and storage networking products. The company's product portfolio spans across Enterprise Ethernet (LAN, WLAN) Switches, WAN (Internet) Routers, SAN Switches. Brocade hardware products include Fibre Channel switches and directors; Ethernet switches and routers; application delivery controllers (load balancers, etc.); fabric extension switches; embedded switch blades; Fibre Channel host bus adapters (HBAs); and Converged Network Adapters (CNAs). Other hardware solutions from Brocade support common protocols that include iSCSI, FCIP, GigE, FICON, FCoE, CEE, and Layer 4-7 networking protocols. Brocade also sells software-based networking devices including technology for virtual routers, virtual firewalls and VPNs through its wholly owned subsidiary, Vyatta.

Summary of Current Brocade SAN Products: Brocade Name Max. port speed (GBPS) DCX 8510-8 DCX 8510-4 6505 6510 DCX DCX-4S 16 16 16 16 8 8 Max ports 384 192 24 48 512 256 BDCX 6510 Dell version DCX 8510-8 DCX 8510-4 EMC version IBM version

ED-DCX8510- SAN768B-2 8B ED-DCX8510- SAN384B-2 4B DS-6505B DS-6510B ED-DCX-B SAN24B-5 SAN48B-5 SAN768B

ED-DCX-4S-B SAN384B

Note:

There are some more models which are not mentioned here.

Show Commands:
Command
psshow fansshow tempshow sensorshow nsshow nsshow -t nsshow -r nscamshow nsallshow licenseshow date httpcfgshow switchname fabricshow userconfig show -a switchstatusshow switchstatuspolicyshow portshow portcfgshow configshow fabric.ops switchuptime OR uptime firmwareshow version hashow

Description
Displays the status of the power supply Displays the status of the fans Displays the status of the temperature readings Displays the status of the sensor readings Displays information in the name server Displays information in the name server Displays the information in the name server along with the state change registration details Displays detailed information of all the devices connected to all the switches in the fabric (Remote Name Servers) Displays the 24 bit address of all devices that are in the fabric Displays all the licenses that have been added in the switch Displays the current date set on the switch Displays the JAVA version the switch expects at the management console Displays the switch name Displays information of all the switches in the fabric Displays the account information like role , description , password exp date , locked status Displays the overall status of the switch Displays policy set for the switch regarding Marginal(Yellow) or Down(Red ) error status To show the port status Displays the speed set for all ports on all slots and other detailed port information Displays the parameters of the switch. Ensure all switches in a fabric have the same parameters in order to communicate Displays the uptime for the switch Displays the firmware on the switch Displays the current firmware version on the switch Displays the status of local and remote CPs. High availability , heartbeat and synchronization

nsshow | grep 'N ' To find node WWN's

switchshow Portshow <port> porterrshow portstatsshow <port>

Indicators like no light or In_sync will be displayed Provides report on errors on a port provides list of port errors, look for delta of counters Provides details of port errors Extension of portstatsshow when 32 bit counters do not suffice, look for tim_txcrd_z to observe BB_credit deltas Helps isolate flapping ports, look out for offline and online sequences Provides information on SFP and their state, check for power flags any parameter mismatch during merging

portstats64show fabriclog -s sfpshow Fabstats show

Port settings :
Command portcfgshow portcfg rscnsupr [slot/port] enable portcfg rscnsupr [slot/port] disable portname portdisable portenable portcfgpersistentdisable portcfgpersistentenable portshow portcfgspeed switchcfgspeed portcfgshow portcfgdefault Displays the port settings Description

A registered state change registration is suppressed when a state change occurs on the port A registered state change registration is sent when a state change occurs on the port To assign a name for a port To disable a port or slot To enable a port or slot To disable a port , status would not change even after rebooting the switch To enable a port , status would not change even after rebooting the switch To show the port status To set speed for a port Note 0:auto negotiated 1,2,4 Gbit/sec , 1 : 1Gbit/sec , 2 : 2 Gbit/sec , 4 : 4Gbit/sec To set speed for all the ports on the switch Note 0:auto negotiated 1,2,4 Gbit/sec , 1 : 1Gbit/sec , 2 : 2 Gbit/sec , 4 : 4Gbit/sec Displays the speed set for all ports on all slots and other detailed port information To set the port settings to default

portcfglongdistance portcfgeport

To set the long distance mode . Default is L0(Normal), as per distance will display LE <=10 kms , L0.5 <=25kms , L1 <=50 kms, L2<=100kms , LD=auto , LS = Static Used to disable a port from being a E port

Setting commands :

Command ipaddrset bannerset

Description To set the ip address for the switch To set the banner which will appear when logging in using the CLI or webtools

Time and Date Settings :

Command date tsclockserver 10.10.1.1 tsclockserver LOCL date mmddhhmmyy tstimezone -5 To set the time of the switch when the NTP server synchronization is cancelled To set the time zone for individual switches Instruction to stop NTP server synchronization (Local time of the switch) Description Displays the current date set on the switch

Instruction for the principal switch to synchronize time with the NTP server (specify ipaddress of the NTP server)

License Commands :
Command Description Displays all the licenses that are licenseshow licenseadd licenseremove licenseidshow added in the switch To add a new license to the switch To remove a license from the switch Based on Switch WWN

Password commands :
Command passwd passwdcfg set -lowercase 3 uppercase 1 -digits 2 -punctuation 2 -minlength 10 -history 3 passwdcfg set -minpasswordage 1 passwdcfg set -maxpasswordage 30 passwdcfg set -warning 23 passwdcfg set -lockoutthreshold 5 passwdcfg set -lockoutduration 30 passwdcfg setdefault To set the password rules To set the minimum password age in Days To set the maximum password age in Days To set a warning for the expiration Days remaining To set the account lockout thresh hold To set the account lockout duration in Minutes To restore the password policy to Factory settings (min length 8, history -1 , lockoutduration 30) Description To change the password for that particular login

User Configuration (commands to administer Accounts) :

Command userconfig show -a / userconfig show userconfig add jdoe -r admin -d Jane Doe userconfig show jdoe

Description Displays all the account information like role , description , password exp date , locked status

To add a new account -r = role , -d = description Displays all the information for the account jdoe To Disable an account , usually default a/cs like admin and user . But ensure before disabling the admin a/c there is another a/c with admin rights To Enable an account

userconfig change -e no userconfig change -e yes

Zoning Commands :
Command alicreate Name, domain,port no alicreate Name,portname1; portname2 alidelete Name aliadd Name, domain,port no aliremove Name, domain,port no alishow AliName To add additional ports to an alias To remove a port from the alias To show the alias configuration on the switch To create more than one ports under one alias Used to create alias Description

zonecreate Zone Name, alias1; alias2 zonedelete ZoneName zoneadd ZoneName, alias name zoneremove ZoneName, alias name zoneshow zoneName To remove an alias from the zone To show the zone configuration information To create zones based on alias To delete a zone To add additional alias into the zone

cfgcreate Configname, Zone1; Zone2 cfgdelete ConfigName cfgadd ConfigName, Zone3 cfgremove ConfigName, Zone3 cfgshow ConfigName cfgenable ConfigName cfgsave fcping <initiator> <target> To create configurations by adding in zones To delete a configuration To add additional zones in the configuration To remove a zone from the configuration To show the details of that configuration To enable a configuration on the switch To have the effective configuration to be written into the flash memory helps isolate end to end device connectivity and also an easy method to validate zoning

Firmware commands :
Command configupload configdownload configure => cfgload attributes : [y] => Ensure secure config upload / download : [y] Fabric OS v 4.4 & above provides Secure File Copy Protocol (SCP) during upload or download of configurations Description Saves the switch config as an ASCII text file to an FTP server To restore a switch configuration from ASCII text file Note Need to disable the switch before downloading the config file

firmwaredownload firmwareshow version fastboot reboot firmwaredownloadstatus Licenseshow

To download the firmware to be installed on the switch To be run after installing the firmware on the switch Displays the current firmware version on the switch Needs to be run after installing the firmware . This doesnot include the post Needs to be run after installing the firmware. This includes the post

Banner Commands :
Command Description Displays the banner that will appear when logging in unsing bannershow bannerset bannerset the CLI or webtools To set the banner which will appear when logging in using the CLI or webtools To remove the bannerset

Node commands:
Command nodefind <alias> Description To find specific device in fabric using Alias

nodefind<WWPN> To find specific device in fabric using WWN

Other commands :
Command killtelnet configure quitemode quietmode 1 switchname switchname EXAMPLE configure timeout timeout 10 switchuptime OR uptime switchcfgspeed fastboot reboot switchstatusshow switchstatuspolicysho w switchstatuspolicyset Displays the uptime for the switch To set speed for all the ports on the switch Note 0:auto negotiated 1,2,4 Gbit/sec , 1 : 1Gbit/sec , 2 : 2 Gbit/sec , 4 : 4Gbit/sec To reboot the switch without post To reboot the switch with the post Displays the overall status of the switch Displays policy set for the switch regarding Marginal(Yellow) or Down(Red) error status To change the policy set for the switch regarding Marginal(Yellow) or Down(Red) error status To assign a switch name To disable/enable TELNETD Displays the timeout time set for Telnet session on the switch To set a specific timeout time for the Telnet session Description To kill a particular session which is using telnet To configure a switch To switch off the quietmode To suppress messages to the console Displays the switchname

Log collection
Command supportshow supportsave Description

Scenarios : 1.How to get the list of device node WWN's ? A) Issue Nsshow | grep 'N '.see below for similar output.

Note: Maintain blank space after 'N ' in grep command. The Red output is the connected Node WWN.

2.

How to check whether my host is logged in or not thru CLI?

A) Issue Node find. It displays all device Name Server (NS) entries matching a given WWN, device PID, or alias. a. Using WWN. see below for similar output

b . using Aliases. see below for similar output

c . When there is no match. see below for similar output

3.

How to validate a zoning in between Initiator and Target?

A) Issue fcping <initiator> <Target>.

Note: In the above screen we can see one device that accepts the request and another device that rejects the request .

4. Basic brocade health check commands.

5. ISL and Trunking:

A connection between two switches using the E_Port.

A fabric feature that enables distribution of traffic over the combined up to eight ISL's between adjacent switches,while preserving in-order delivery.

Need to check below before performing trunking: 1.check trunking license (using licenseshow) on all the switches. 2.Trunk ports must be E-ports. 3.port speed must be same. 4.port must be enable as Trunk ports(using portcfgtrunkport). 5.Zoning configuration must be the same or one of the switches must be new without configuration. Check with cfgshow and ensure both switches have the same entries. If there is a mismatch or missing zones, create them manually. 6.Ensure that the switches have a unique domain id. Best practice is to set an insistent domain id. 7. Ensure all switch configuration parameters are the same on both. Some of the important parameters are
BB Credit R_A_TOV E_D_TOV Data Field Size Op Mode Non-SCSI Tachyon Mode Disable Device Probing VC Encoded Address Mode Disable Translative Mode Per-frame Route Priority

Basic ISL Trunking Scenario :

Objective

: Need to perform ISL Trunking between three brocade DS300 switches.

Connections : Each subordinate switch will be connected to master switch via two cables.

Switch A is master and B and C are subordinate.

Connection Diagram:

NOTE

: There is an internal chassis switch connected to C which we will term as D. This switch is already ISL

with C and will be removed during the activity.

Cabling:

Cable from switch A@port8 will connect to switch B@port9. Cable from switch A@port9 will connect to switch B@port10. Cable from switch A@port10 will connect to switch C@port18. Cable from switch A@port12 will connect to switch C@port19.

Note :All the switches are in production and each switch has a active mirror running as such as multipathing is enabled. Steps: 1.Install the license for trunking.

simultaneously. So no Impact

2.After installation of license one need to enable and disable trunking/ISL ports. 3.Check for ISL R_RDY mode on ports should be disablesportcfgislmode. 4.On identified ports enable the trunk mode option. 5.Take configuration backup of all switches involved in activity. 6. Remove cable from switch D before proceeding with activity. 7. Change the Domain ID using the configure command. 8. Save the settings. 9. Disable the switches. 10. Clear configuration from switch B and C. 11. Make the switch A as master and rest of the switches as subordinate. 12. First Switch A to be connected to C. 13. Enable the switch. 14. Issue the fabricShow command to verify that the new switch is in the fabric. 15. Then connect A to B. 16. Enable the switch. 17. Issue the fabricShow command to verify that the new switch is in the fabric. 18. After successful ISL connection b/w three switches connect C to D. 19. Check the configuration in both the switches with cfgshow and effective configuration should be Config_Switch1 in case of FABRIC1 Switches. 20. Verify the devices with switchshow, nsshow outputs. 21. Create new alias & zones in Principal switch i.e. A (which were already there in other switches B and C). 22.Enable effective configuration and effective configuration should be Config_Switch1 in case of FABRIC1 Switches.

Commands that enable you to view trunk information trunkshow switchshow islshow portcfgshow

commands that allow you to configure trunk parameters portcfgtrunkport switchcfgtrunk

command that allows you to test trunking trunkdebug <start port>,<end port>

a) Trunk show : switch:admin> trunkshow

b) Islshow

C ) Portcfgshow switch:admin>portcfgtrunkport 8 ,0 switch:admin>portcfgshow

portcfgtrunkport is used to turn on or off trunking on one port,specified by port number.

The last parameter indicates on or off (1 for on and 0 for off). Usage : portcfgtrunkport [slotnumber/] portnumber Mode Mode : 1- configure port to be trunking capable 0 configure port to be trunking incapable
switchcfgtrunk is used to turn on or off trunking capability for the whole switch.

Usage : switchcfgtrunk Mode Mode : 0 configure ports to be trunking incapable 1- configure ports to be trunking capable

d) trunkdebug: switch : admin> trunkdebug <start port #>, <end port #>

Zoning can be done by two ways. They are a) using CLI. b) web tools,DCFM. a)Steps for creating zoning using CLI (soft zoning recommended) a1) alicreate alicreate "aliName","member[; member...]" switch : admin> alicreateHBA0 , 20:00:00:18:32:0b:66:22 switch : admin> alicreate HBA1 ,21:00:00:20:37:0c:66:23 a2) Zonecreate zonecreate "zonename", "member[;member...]" switch :admin> zonecreate Zone1 , array1;HBA0 switch :admin> zonecreate zone2 , array2;HBA1 a3) cfgcreate cfgcreate "cfgName", "member[;member...]" switch : admin> cfgcreate cfg_1 , zone1,zone2 a4) cfgenable cfgenable "cfgName" switch : admin> cfgenable cfg_1 a5) cfgsave switch :admin> cfgsave a6) cfgshow switch :admin> cfgshow