Brocade Command Line Interface
how to telnet to and use the command line on a brocade switch:

Basic Configuration


*** Initial Switch Commands and Setup ***


network IP interface settings

  • ipAddrShow
  • ipAddrSet

switch and chassis name

  • switchName <switchname>
  • chassisName <new chassisname>

time, timezone and NTP

  • date "mmddHHMMyy"
  • tsTimeZone
  • tsClockServer

*** Domain, FCID Stuff ***


  • fabricShow (to display domain IDs)

set domain id

  • switchDisable
  • configure (fabric parameters: = y)
  • domain: (1..239) [1] <enter domainid here>
  • answer remaining prompts (or ctrl-d)
  • switchEnable

*** Licensing ***


before upgrading/downgrading Fabric OS, to preserve licenses on switch:

  • configUpload
  • configDownload

view installed licenses:

  • licenseIdShow

add a licensed feature:

  • licenseadd "key"
  • licenseShow (to verify license was added)

remove a licensed feature

  • licenseRemove "key"
  • feature is disabled after reboot or switchDisable

*** Port Commands ***

activating ports on demand (see also dynamic PoD)

  • portShow (to see current state)
  • install ports-on-demand license
  • portEnable (or switchDisable/switchEnable)
  • portShow (to see new ports)

dynamic ports on demand

  • 4016, 4018, 4020, 4024 sw mods for blade servers
  • pod licenses from a pool of available licenses
  • ports will show No Sync or In Sync if no more licenses available
  • switchShow to display port states

display port license assignments

  • licensePort --show

enable dynamic ports on demand

  • will erase any prior port license assignements if currently in static POD mode
  • licensePort --method dynamic
  • reboot (to restart and apply new mode)
  • licensePort --show

disable dynamic Ports on Demand

  • licensePort --method static
  • reboot
  • licensePort -- show

*** POD license management ***

reserve a port license

  • licensePort --show
  • licensePort --reserve 0

disable a port

  • if all reservations are assigned
  • portDisable

remove the port from POD license

  • licensePort --relase 0

releasing a port from a POD set

  • switchDisable
  • switchShow
  • licensePort --release 0
  • licensePort --show
  • switchEnable
  • switchShow

Switch activation and deactivation

  • switchDisable
  • switchEnable

port activation and deactivation

  • portDisable (or portEnable slot#/port#)
  • portEnable (or portEnable slot#/port#)

*** Basic Connections ***


before connecting a swtich to a fabric that contains switches running diff fw versions, make sure PID format is the same on all switches

  • configShow (to check PID format)

std or default ISL mode is L0

  • maximum ISL distances:
  • 10km @ 1Gbps
  • 5km @ 2Gbps
  • 2.5km @ 4Gbps
  • ISL mode L0 avail on all fabric os releases

*** ISL Configuration, etc ***

Gateway links

a gateway merges SANs into a single fabric by establishing point-to-point E_Port connectivity between two fibre channel switches that are sparated by a network with a protocol such as IP or SONET except for link initialization, gatewas are transparent to switches; the gateway simply provides e_port connectivity from on switch to another. by default, switchports initialize links using the exchange link parms (ELP) mode 1. however, gaeways expect initialization with ELP mode 2, also referred to as ISL R_RDY mode. Therefore, to enable two swithes to link thru a gateway, the ports on both switches must be set for ELP mode 2

Any number of e_ports can be configured for gateway links, provided the follwoing guidelines are followed:

  • all switches in fabric must be upgraded to fabos v5.2.0 or later
  • all switches in fab are using cor PID format
  • swithes connected to both sides of gateway are included when determining switch count maximums
  • extended links (thos created using the extended fabrics licensed feature) are not supported thru gateway links.

configuring a link through a gateway

  1. enter configShow on all switches to make sure PID format is consistent across entire fabric. If necessary,k change pid format on any nonconforming switches
  2. connect to switch at one end of gw
  3. portCfgIslMode ( or <slot/port, mode> )
  4. repeat 1 thru 3 for any add'l ports
  5. repeat procedure for switch at other end of gw

Equipment status

  • switchShow
  • switchStatusShow

HA features

  • chassisShow
  • haShow
  • slotShow -m (inventory and current status of each slot)

verify fabric connectivity

  • fabricShow

verify device connectivity

  • switchShow
  • nsShow
  • nsAllShow

tracking changes on switch

enabling track changes feature

  • trackChangesSet 1

view the log using the commands

  • errDump | more
  • errShow (one line at a time)

display status of the track changes feature

  • trackChangesShow

viewing the switch status policy threshold values

  • switchStatusPolicyShow
  • switch change results in logged error message and
  • SNMP connUnitStatusChange trap sent

setting switch status policy threshold values

  • switchStatusPolicySet
  • setting value to 0,0 disables parm from being used to set overall status for switch

Audit Log Configuration

verify host syslog prior to config'ing audit log

  • syslogIpAdd (add ipaddr of host to rcv audit events)

config'ing audit log for specific event classes

  • auditCfg --class 2,4 (which classes to filter)
  • auditCfg --enable (audidCfg --disable to disable)
  • auditCfg --show


  • sysShutdown