brocade command list
DESCRIPTION
it's realy goodTRANSCRIPT
Brocade SAN switch CLI command List
Index
1. Show Commands
2. Port Setting commands
3. Setting Commands
4. Time and Date commands
5. License Commands
6. Password Commands
7. User configuration commands
8. Zoning commands
9. 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)
Max ports Dell version EMC version IBM version
DCX 8510-8 16 384 DCX 8510-8 ED-DCX8510-8B
SAN768B-2
DCX 8510-4 16 192 DCX 8510-4 ED-DCX8510-4B
SAN384B-2
6505 16 24 DS-6505B SAN24B-5
6510 16 48 6510 DS-6510B SAN48B-5
DCX 8 512 ED-DCX-B SAN768B
DCX-4S 8 256 BDCX ED-DCX-4S-B SAN384B Note: There are some more models which are not mentioned here.
Show Commands:
Command Description
psshow Displays the status of the power supply
fansshow Displays the status of the fans
tempshow Displays the status of the temperature readings
sensorshow Displays the status of the sensor readings
nsshow Displays information in the name server
nsshow -t Displays information in the name server
nsshow -rDisplays the information in the name server along with the state change registration details
nscamshowDisplays detailed information of all the devices connected to all the switches in the fabric (Remote Name Servers)
nsallshow Displays the 24 bit address of all devices that are in the fabric
licenseshow Displays all the licenses that have been added in the switch
date Displays the current date set on the switch
httpcfgshow Displays the JAVA version the switch expects at the management console
switchname Displays the switch name
fabricshow Displays information of all the switches in the fabric
userconfig –show -aDisplays the account information like role , description , password exp date , locked status
switchstatusshow Displays the overall status of the switch
switchstatuspolicyshowDisplays policy set for the switch regarding Marginal(Yellow) or Down(Red) error status
portshow To show the port status
portcfgshowDisplays the speed set for all ports on all slots and other detailed port information
configshow fabric.opsDisplays the parameters of the switch. Ensure all switches in a fabric have the same parameters in order to communicate
switchuptime OR uptime Displays the uptime for the switch
firmwareshow Displays the firmware on the switch
version Displays the current firmware version on the switch
hashowDisplays the status of local and remote CP’s. High availability , heartbeat and synchronization
nsshow | grep 'N 'To find node WWN's
switchshow Indicators like no light or In_sync will be displayed
Portshow <port> Provides report on errors on a port
porterrshow provides list of port errors, look for delta of counters
portstatsshow <port> Provides details of port errors
portstats64showExtension of portstatsshow when 32 bit counters do not suffice, look for tim_txcrd_z to observe BB_credit deltas
fabriclog -s Helps isolate flapping ports, look out for offline and online sequences
sfpshow Provides information on SFP and their state, check for power
Fabstats show flags any parameter mismatch during merging
Port settings :
Command Description
portcfgshow Displays the port settings
portcfg rscnsupr [slot/port] –enable
A registered state change registration is suppressed when a state change occurs on the port
portcfg rscnsupr [slot/port] –disable
A registered state change registration is sent when a state change occurs on the port
portname To assign a name for a port
portdisable To disable a port or slot
portenable To enable a port or slot
portcfgpersistentdisable To disable a port , status would not change even after rebooting the switch
portcfgpersistentenable To enable a port , status would not change even after rebooting the switch
portshow To show the port status
portcfgspeed 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
switchcfgspeedTo 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
portcfgshowDisplays the speed set for all ports on all slots and other detailed port information
portcfgdefault To set the port settings to default
portcfglongdistance
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
portcfgeport Used to disable a port from being a E port
Setting commands :
Command Description
ipaddrset To set the ip address for the switch
bannersetTo set the banner which will appear when logging in using the CLI or webtools
Time and Date Settings :
Command Description
date Displays the current date set on the switch
tsclockserver 10.10.1.1
Instruction for the principal switch to synchronize time with the NTP server (specify ipaddress of the NTP server)
tsclockserver LOCL Instruction to stop NTP server synchronization (Local time of the switch)
date mmddhhmmyy To set the time of the switch when the NTP server synchronization is cancelled
tstimezone -5 To set the time zone for individual switches
License Commands :
Command Description
licenseshowDisplays all the licenses that are added in the switch
licenseadd To add a new license to the switch
licenseremove To remove a license from the switch
licenseidshow Based on Switch WWN
Password commands :
Command Description
passwd To change the password for that particular login
passwdcfg –set -lowercase 3 uppercase 1 -digits 2 -punctuation 2 -minlength 10 -history 3 To set the password rules
passwdcfg –set -minpasswordage 1 To set the minimum password age in Days
passwdcfg –set -maxpasswordage 30 To set the maximum password age in Days
passwdcfg –set -warning 23 To set a warning for the expiration Days remaining
passwdcfg –set -lockoutthreshold 5 To set the account lockout thresh hold
passwdcfg –set -lockoutduration 30 To set the account lockout duration in Minutes
passwdcfg –setdefaultTo restore the password policy to Factory settings (min length – 8, history -1 , lockoutduration – 30)
User Configuration (commands to administer Accounts) :
Command Description
userconfig –show -a / userconfig –show
Displays all the account information like role , description , password exp date , locked status
userconfig –add jdoe -r admin -d “Jane Doe” To add a new account -r = role , -d = description
userconfig –show jdoe Displays all the information for the account jdoe
userconfig –change -e no
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
userconfig –change -e yes To Enable an account
Zoning Commands :
Command Description
alicreate “Name”, “domain,port no” Used to create alias
alicreate “Name”,”portname1; portname2″ To create more than one ports under one alias
alidelete “Name”
aliadd “Name”, “domain,port no” To add additional ports to an alias
aliremove “Name”, “domain,port no” To remove a port from the alias
alishow “AliName” To show the alias configuration on the switch
zonecreate “Zone Name”, “alias1; alias2″ To create zones based on alias
zonedelete “ZoneName” To delete a zone
zoneadd “ZoneName”, “alias name” To add additional alias into the zone
zoneremove “ZoneName”, “alias name” To remove an alias from the zone
zoneshow “zoneName” To show the zone configuration information
cfgcreate “Configname”, “Zone1; Zone2″ To create configurations by adding in zones
cfgdelete “ConfigName” To delete a configuration
cfgadd “ConfigName”, “Zone3″ To add additional zones in the configuration
cfgremove “ConfigName”, “Zone3″ To remove a zone from the configuration
cfgshow “ConfigName” To show the details of that configuration
cfgenable “ConfigName” To enable a configuration on the switch
cfgsaveTo have the effective configuration to be written into the flash memory
fcping <initiator> <target>helps isolate end to end device connectivity and also an easy method to validate zoning
Firmware commands :
Command Description
configupload Saves the switch config as an ASCII text file to an FTP server
configdownloadTo restore a switch configuration from ASCII text file Note – Need to disable the switch before downloading the config file
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
firmwaredownload To download the firmware to be installed on the switch
firmwareshow To be run after installing the firmware on the switch
version Displays the current firmware version on the switch
fastbootNeeds to be run after installing the firmware . This doesnot include the post
rebootNeeds to be run after installing the firmware. This includes the post
firmwaredownloadstatus
Licenseshow
Banner Commands :Command Description
bannershowDisplays the banner that will appear when logging in unsing the CLI or webtools
bannersetTo set the banner which will appear when logging in using the CLI or webtools
bannerset “” To remove the bannerset
Node commands:
Command Descriptionnodefind <alias> To find specific device in fabric using Alias
nodefind<WWPN> To find specific device in fabric using WWN
Other commands :Command Description
killtelnet To kill a particular session which is using telnet
configure To configure a switch
quitemode To switch off the quietmode
quietmode 1 To suppress messages to the console
switchname Displays the switchname
switchname “EXAMPLE” To assign a switch name
configure To disable/enable TELNETD
timeout Displays the timeout time set for Telnet session on the switch
timeout 10 To set a specific timeout time for the Telnet session
switchuptime OR uptime Displays the uptime for the switch
switchcfgspeedTo 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
fastboot To reboot the switch without post
reboot To reboot the switch with the post
switchstatusshow Displays the overall status of the switch
switchstatuspolicyshow
Displays policy set for the switch regarding Marginal(Yellow) or Down(Red) error status
switchstatuspolicysetTo change the policy set for the switch regarding Marginal(Yellow) or Down(Red) error status
Log collection
Command Descriptionsupportshow
supportsave
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 simultaneously. So no Impact as such as multipathing is enabled.
Steps:
1.Install the license for trunking.
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 disables—portcfgislmode.
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> alicreate”HBA0” , ”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