-
Cisco MDS 9000 Family Command Reference, Release 1.3 (from Release 1.3(1) through Release 1.3(6))
-
New and Changed Information
-
Preface
-
CLI Overview
-
A Commands
-
C Commands
-
D Commands
-
Debug Commands
-
E Commands
-
F Commands
-
G Commands
-
H Commands
-
I Commands
-
K Commands
-
L Commands
-
M Commands
-
N Commands
-
O Commands
-
P Commands
-
Q Commands
-
R Commands
-
S Commands
-
Show Commands
-
T Commands
-
U Commands
-
V Commands
-
W Commands
-
Z Commands
-
Advanced Services Module Commands
-
Caching Services Module (CSM) Commands
-
FeedbackTable Of Contents
ficon vsan (configuration mode)
F Commands
The commands in this chapter apply to the Cisco MDS 9000 Family of multilayer directors and fabric switches. All commands are shown here in alphabetical order regardless of command mode. See the "Command Modes" section to determine the appropriate mode for each command. For more information, refer to the Cisco MDS 9000 Family Configuration Guide.
•
ficon vsan (configuration mode)
•
fabric-binding activate
To activate fabric binding in a FICON enabled VSAN, use the fabric-binding activate command in configuration mode. To disable this feature, use the no form of this command.
fabric-binding activate vsan vsan-id [force]
no fabric-binding activate vsan vsan-id
Syntax Description
vsan vsan-id
Specifies the FICON-enabled VSAN. The ID of the VSAN is from 1 to 4093.
force
Forces fabric binding activation.
Defaults
Disabled
Command Modes
Configuration mode
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
Fabric binding is configured on a per-VSAN basis and can only be implemented in FICON VSANs.
Examples
The following example activates the fabric binding database for the specified VSAN.
switch# config tswitch(config)# fabric-binding activate vsan 1The following example deactivates the fabric binding database for the specified VSAN.
switch(config)# no fabric-binding activate vsan 10The following example activates the fabric binding database for the specified VSAN forcefully—even if the configuration is not acceptable.
switch(config)# fabric-binding activate vsan 3 forceThe following example reverts to the previously-configured state or to the factory default (if no state is configured)
switch(config)# no fabric-binding activate vsan 1 forceRelated Commands
fabric-binding database
Configures a fabric-binding database.
fabric-binding enable
Enables fabric-binding.
fabric-binding database copy
To copy from the active fabric binding database to the configuration fabric binding database, use the fabric-binding database copy command in EXEC mode.
fabric-binding database copy vsan vsan-id
Syntax Description
Defaults
None
Command Modes
EXEC mode
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
Fabric binding is configured on a per-VSAN basis and can only be implemented in FICON VSANs.
If the configured database is empty, this command is not accepted
Examples
The following example copies from the active database to the config database in VSAN 1.
switch# fabric-binding database copy vsan 1Related Commands
fabric-binding diff
Provides the differences between the fabric-binding databases.
fabric-binding database diff
To view the differences between the active database and the configuration database in a FICON enabled VSAN, use the fabric-binding database diff command in EXEC mode.
fabric-binding database diff {active | config} vsan vsan-id
Syntax Description
Defaults
None
Command Modes
EXEC mode
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
Fabric binding is configured on a per-VSAN basis and can only be implemented in FICON VSANs.
Examples
The following example displays the differences between the active database and the configuration database in VSAN 1.
switch# fabric-binding database diff active vsan 1The following example displays information on the differences between the configuration database and the active database.
switch# fabric-binding database diff config vsan 1Related Commands
fabric-binding copy
Copies from the active to the config fabric binding database.
fabric-binding database vsan
To configure a user-specified fabric binding list in a FICON enabled VSAN, use the fabric-binding database vsan command in configuration mode. To disable an FC alias, use the no form of this command.
fabric-binding database vsan vsan-id
swwn switch-wwn domain domain-idfabric-binding database vsan vsan-id
no swwn switch-wwn domain domain-idno fabric-binding database vsan vsan-id
Syntax Description
Defaults
None
Command Modes
Configuration mode
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
Fabric binding is configured on a per-VSAN basis and can only be implemented in FICON VSANs.
The persistent domain ID must be specified along with the sWWN. Domain ID authorization is required in FICON VSANs where the domains are statically configured and the end devices reject a domain ID change in all switches in the fabric.
Examples
The following example enters the fabric binding database submode and adds the sWWN and domain ID of a switch to the configured database list.
switch# config tswitch(config)# fabric-binding database vsan 5switch(config-fabric-binding)# swwn 21:00:05:30:23:11:11:11 domain 102The following example deletes a fabric binding database for the specified VSAN.
switch# config tswitch(config)# no fabric-binding database vsan 10The following example deletes the sWWN and domain ID of a switch from the configured database list.
switch# config tswitch(config)# fabric-binding database vsan 5switch(config-fabric-binding)# no swwn 21:00:15:30:23:1a:11:03 domain 101Related Commands
fabric-binding activate
Activates fabric-binding.
fabric-binding enable
Enables fabric-binding.
fabric-binding enable
To enable fabric binding in a FICON-enabled VSAN, use the fabric-binding enable command. To disable fabric binding, use the no form of this command.
fabric-binding enable
no fabric-binding enable
Syntax Description
This command has no other arguments or keywords.
Defaults
Disabled
Command Modes
Configuration mode
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
Fabric binding is configured on a per-VSAN basis and can only be implemented in FICON VSANs.
The fabric binding feature must be enabled in each switch in the fabric that participate in the fabric binding.
Examples
The following examples enables fabric binding on that switch.
switch# config tswitch(config)# fabric-binding enableThe following example disables fabric binding on that switch.
switch# config tswitch(config)# no fabric-binding enableRelated Commands
fabric-binding activate
Activates fabric-binding.
fabric-binding database
Configures a fabric-binding database.
fcalias name
To configure an FC alias, use the fcalias name command. To disable an FC alias, use the no form of this command.
fcalias name alias name vsan vsan-id
no fcalias name alias name vsan vsan-id
Syntax Description
alias-name
The name of the fcalias. Maximum length is 64 characters.
vsan
The fcalias is for a VSAN.
vsan-id
The ID of the VSAN is from 1 to 4093.
Defaults
None.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
To include multiple members in any alias, use the FC ID, fWWN, or pWWN values.
Examples
The following examples show how to configure an fcalias called AliasSample on VSAN 3.
switch# config tswitch(config)# fcalias name AliasSample vsan 3switch(config-fcalias)#Related Commands
show fcalias
Displays the member name information in a Fibre Channel alias (fcalias).
fcanalyzer
To configure the Cisco Fabric Analyzer use the fcanalyzer command in configuration mode.
fcanalyzer {local [brief] [display-filter expression] [limit-captured-frames number] [limit-frame-size bytes] [write {slot: | volatile:}] | remote ip-address [active [port-number]]}
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
You can capture Fibre Channel control traffic from a switch and decode it without having to disrupt connectivity and without having to be local to the point of analysis.
Examples
The following examples shows how to configure the Cisco Fabric Analyzer.
switch# config tswitch(config)# fcanalyzer localCapturing on eth2switch(config)# fcanalyzer local briefCapturing on eth2switch(config)# fcanalyzer local display-filter SampleFCapturing on eth2switch(config)# fcanalyzer local limit-frame-size 64Capturing on eth2switch(config)# fcanalyzer local limit-captured-frames 10Capturing on eth2sswitch(config)# fcanalyzer local write SampleFileCapturing on eth2switch(config)# fcanalyzer remote 10.21.0.3Capturing on eth2switch(config)# fcanalyzer remote 10.21.0.3 activeCapturing on eth2Related Commands
clear fcanalyzer
Clears the entire list of configured hosts.
show fcanalyzer
Displays the list of hosts configured for a remote capture.
fcc enable
To enable Fibre Channel Congestion Control (FCC), use the fcc enable command in configuration mode. To disable this feature, use the no form of the command.
fcc enable
no fcc enable
Syntax Description
This command has no other arguments or keywords.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
FCC reduces the congestion in the traffic without interfering with standard Fibre Channel protocol.
Examples
The following example shows how to enable FCC.
switch# config tswitch(config)# fcc enableRelated Commands
fcc priority
To assign the FCC priority to the entire switch, use the fcc priority command in configuration mode. To revert to the default, use the no form of the command.
fcc priority number
no fcc priority number
Syntax Description
number
The FCC priority threshold. The range is 0 to 7, where 0 is the lowest priority and 7 the highest priority.
Defaults
The default priority is 4.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
FCC reduces the congestion in the traffic without interfering with standard Fibre Channel protocol.
Examples
The following example shows how to configure the FCC priority threshold as 2.
switch# config tswitch(config)# fcc priority 2Related Commands
fcdomain
To configure the Fibre Channel domain feature, use the fcdomain command. The no form of this command, disables the FC domain.
fcdomain {allowed domain vsan vsan-id |
auto-reconfigure vsan vsan-id |
contiguous-allocation vsan vsan-id |
domain id {preferred | static} vsan vsan-id |
fabric-name name vsan vsan-id |
fcid {database | persistent vsan vsan-id} |
priority value vsan vsan-id |
restart [disruptive] vsan vsan-id |
vsan vsan-id}no fcdomain {allowed domain vsan vsan-id |
auto-reconfigure vsan vsan-id |
contiguous-allocation vsan vsan-id |
domain id {preferred | static} vsan vsan-id |
fabric-name name vsan vsan-id |
fcid {database | persistent vsan vsan-id} |
priority value vsan vsan-id |
restart [disruptive] vsan vsan-id |
vsan vsan-id}Syntax Description
Defaults
Enabled.
Command Modes
Configuration mode.
Command History
1.1(1)
This command was introduced.
2.0(1)
The global-enable keyword option was deprecated.
Usage Guidelines
You can use this command to select the principle switch, domain ID distribution, reconfigure fabric, and allocate FC IDs.
Examples
The following examples show how to configure the Fibre Channel domain feature.
switch# config tswitch(config)# fcdomain domain 3 preferred vsan 87switch(config)# no fcdomain domain 3 preferred vsan 87switch(config)# fcdomain domain 2 static vsan 237switch(config)# no fcdomain domain 2 static vsan 237switch(config)# fcdomain restart vsan 1switch(config)# fcdomain restart disruptive vsan 1switch(config)# fcdomain priority 25 VSAN 99switch(config)# no fcdomain priority 25 VSAN 99switch(config)# fcdomain auto-reconfigure vsan 10switch(config)# fcdomain contiguous-allocation vsan 81-83switch(config)# no fcdomain contiguous-allocation vsan 1030switch(config)# fcdomain fabric-name 20:1:ac:16:5e:0:21:01 vsan 3switch(config)# no fcdomain fabric-name 20:1:ac:16:5e:0:21:01 vsan 3010switch(config)# fcdomain allowed 50-110 vsan 4switch(config)# no fcdomain allowed 50-110 vsan 5Related Commands
fcdomain rcf-reject
To enable the RCF reject flag for a Fibre Channel or FCIP interface, use the fcdomain option. To disable this feature, use the no form of the command.
fcdomain rcf-reject vsan number
no fcdomain rcf-reject vsan number
Syntax Description
Defaults
Enabled
Command Modes
Interface configuration submode
Usage Guidelines
Access this command from the switch(config-if)# submode.
Use this option to configure the RCF reject option for the selected Fibre Channel or FCIP interface.
Examples
The following examples show how to configure the FCIP RCF reject fcdomain feature.
switch# config tswitch(config)# interface fcip 1switch(config-if)# fcdomain rcf-reject vsan 1Related Commands
show fcdomain
Displays global information about the FC domain configurations.
show interface fcip
Displays an interface configuration for a specified FCIP interface.
fcdroplatency
To configure the network and switch FC drop latency time, use the fcdroplatency command in configuration mode. To disable the FC latency time, use the no form of this command.
fcdroplatency {network milliseconds [vsan vsan-id] | switch milliseconds}
no fcdroplatency {network milliseconds [vsan vsan-id] | switch milliseconds
Syntax Description
Defaults
2000 millisecond network latency
500 millisecond switch latency
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
None.
Examples
The following example shows how to configure the network latency to 5000 milliseconds.
switch# config tswitch(config)#switch(config)# fcdroplatency network 5000switch(config)#The following example shows how to revert to the default network latency.
switch(config)# no fcdroplatency network 5000switch(config)#The following example shows how to configure the switch latency to 4000 milliseconds.
switch(config)# fcdroplatency switch 4000switch(config)#The following example shows how to revert to the default switch latency.
switch(config)# no fcdroplatency switch 4000switch(config)#Related Commands
fcflow stats
To configure fcflow statistics, use the fcflow stats command in configuration mode. To disable the counter, use the no form of this command.
fcflow stats {aggregated module module-number index flow-number vsan vsan-id | module module-number index flow-number destination-fcid source-fcid netmask vsan vsan-id}
no fcflow stats {aggregated module module-number index flow-number | module module-number index flow-number}
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
If you enable flow counters, you can enable a maximum of 1K entries for aggregate flow and flow statistics. Be sure to assign an unused flow index to a module for each new flow. Flow indexes can be repeated across modules. The number space for flow index is shared between the aggregate flow statistics and the flow statistics.
Examples
The following example shows how to configure aggregated fcflow statistics for module 1.
switch-config# fcflow stats aggregated module 1 switch-config#The following example enables the aggregated flow counter.
switch(config)# fcflow stats aggregated module 1 index 1005 vsan 1The following example disables the aggregated flow counter.
switch(config)# no fcflow stats aggregated module 1 index 1005The following example enables the flow counter for module 1.
switch(config)# fcflow stats module 1 index 1 0x145601 0x5601 0xffffff vsan 1The following example disables the flow counter for module 1.
switch(config)# no fcflow stats module 2 index 1001Related Commands
fcid-last-byte
Use the fcid-last-byte command to allocate the last byte FC ID for the fabric address. To disable the configuration or to revert to factory defaults, use the no form of the command.
fcid-last-byte last-byte-id
no fcid-last-byte last-byte-id
Syntax Description
Defaults
0
Command Modes
FICON configuration submode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
This is an optional configuration. If you are not sure of the EBCDIC format to be used, we recommend retaining the us-canada (default) option.
Examples
The following example assigns the last byte FC ID for the fabric address.
switch# config tswitch(config)# ficon vsan 2switch(config-ficon)# fcid-last-byte 12The following example removes the configured last byte FC ID for the fabric address and reverts to the default.
switch# config tswitch(config)# ficon vsan 2switch(config-ficon)# no fcid-last-byte 3Related Commands
show ficon
Displays configured FICON details.
ficon vsan vsan-id
Enables FICON on the specified VSAN.
fcinterop fcid-allocation
To allocate FC IDs on the switch, use the fcinterop fcid-allocation command in configuration mode. To disable FC IDs on the switch, use the no form of the command.
fcinterop fcid-allocation {auto | flat | none}
no fcinterop fcid-allocation {auto | flat | none}
Syntax Description
Defaults
The default is fcinterop fcid-allocation auto.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
This command defines how the switch assigns FC IDs.
Examples
switch# config tswitch(config)# fcinterop fcid-allocation noneswitch(config)# fcinterop fcid-allocation flatswitch(config)# fcinterop fcid-allocation autoRelated Commands
fcinterop loop-monitor
To monitor removal of discs from a loop port, use the fcinterop loop-monitor command in configuration mode. To disable loop monitoring, use the no form of this command.
fcinterop loop-monitor
no fcinterop loop-monitor
Syntax Description
This command has no other arguments or keywords.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
This command detects devices that are removed from a looped port.
Examples
The following example shows how to enables monitoring of NL ports in a loop.
switch# config tswitch(config)# fcinterop loop-monitorThe following example shows how to disable monitoring of NL ports in a loop.
switch# config tswitch(config)# no fcinterop loop-monitorRelated Commands
show flogi database
Verify if a storage device is displayed in the Fabric login (FLOGI) table.
fcip enable
To enable the FCIP feature in any switch in the Cisco MDS Family, issue the fcip enable command.
fcip enable
no fcip enable
Syntax Description
This command has no other arguments or keywords.
Defaults
Disabled
Command Modes
Configuration mode
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
The configuration and verification commands for the iSCSI feature are only available when FCIP is enabled on a switch. When you disable this feature, all related configurations are automatically discarded.
Examples
The following command enables the FCIP feature.
switch(config)# fcip enableThe following command disables the FCIP feature (default).
switch(config)# no fcip enableRelated Commands
fcip profile
To create and configure an FCIP profile, use the fcip profile command. To remove an FCIP profile, use the no form of the command.
fcip profile profile-id
no fcip profile profile-id
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.1(1).
Usage Guidelines
When you perform this command, the CLI enters FCIP profile configuration mode.
Examples
switch## config tswitch(config)# fcip profile 5switch(config-profile)#Related Commands
fcns proxy-port
To register a name server proxy, use the fcns proxy-port command in configuration mode.
fcns proxy-port wwn-id vsan vsan-id
no fcns proxy-port wwn-id vsan vsan-id
Syntax Description
wwn-id
Specifies the port WWN, with the format hh:hh:hh:hh:hh:hh:hh:hh.
vsan vsan-id
Specifies a VSAN ID. The range is 1 to 4093.
Defaults
None.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
One name server can be configured to proxy another name server and name server information can be displayed using the CLI. The name server can be viewed using the CLI or the Cisco Fabric Manager.
All name server registration requests come from the same port whose parameter is registered or changed. If it does not, then the request is rejected.
Examples
The following example shows registering a name server proxy.
switch# config tswitch(config)#switch(config)# fcns proxy-port 21:00:00:e0:8b:00:26:dThe following example shows configuring a proxy port for VSAN 2.
switch(config)# fcns proxy-port 21:00:00:e0:8b:00:26:d vsan 2Related Commands
show fcns
Displays the name server database and statistical information for a specified VSAN or for all VSANs.
fcping
To ping an N port with a specified FC ID, use the fcping command in EXEC mode.
fcping {fcid {fc-port | domain-controller-id} | pwwn wwn-id} vsan vsan-id [count number] [timeout seconds] [usr-priority]
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was modified in Cisco MDS SAN-OS Release 1.2(1).
Usage Guidelines
To obtain the domain controller address, concatenate the domain ID with FFFC. For example, if the domain ID is 0xda(218), the concatenated ID is 0xfffcda.
Examples
The following example shows a fcping operation for the specified pWWN or the FCID of the destination. By default, five frames are sent.
switch# fcping fcid 0xd70000 vsan 128 bytes from 0xd70000 time = 730 usec28 bytes from 0xd70000 time = 165 usec28 bytes from 0xd70000 time = 262 usec28 bytes from 0xd70000 time = 219 usec28 bytes from 0xd70000 time = 228 usec5 frames sent, 5 frames received, 0 timeoutsRound-trip min/avg/max = 165/270/730 usecThe following example shows the setting of the number of frames to be sent using the count option. The range is from 0 through 2147483647. A value of 0 will ping forever.
switch# fcping fcid 0xd70000 vsan 1 count 1028 bytes from 0xd70000 time = 730 usec28 bytes from 0xd70000 time = 165 usec28 bytes from 0xd70000 time = 262 usec28 bytes from 0xd70000 time = 219 usec28 bytes from 0xd70000 time = 228 usec28 bytes from 0xd70000 time = 230 usec28 bytes from 0xd70000 time = 230 usec28 bytes from 0xd70000 time = 225 usec28 bytes from 0xd70000 time = 229 usec28 bytes from 0xd70000 time = 183 usec10 frames sent, 10 frames received, 0 timeoutsRound-trip min/avg/max = 165/270/730 usecThe following example shows the setting of the timeout value. The default period to wait is 5 seconds. The range is from 1 through 10 seconds.
switch# fcping fcid 0xd500b4 vsan 1 timeout 1028 bytes from 0xd500b4 time = 1345 usec28 bytes from 0xd500b4 time = 417 usec28 bytes from 0xd500b4 time = 340 usec28 bytes from 0xd500b4 time = 451 usec28 bytes from 0xd500b4 time = 356 usec5 frames sent, 5 frames received, 0 timeoutsRound-trip min/avg/max = 340/581/1345 usecThis command shows the No response from the N port message even when the N port or NL port is active. This is due to resource exhaustion at the N port or NL port. Retry the command a few seconds later.
switch# fcping fcid 0x010203 vsan 1No response from the N port.switch# fcping pwwn 21:00:00:20:37:6f:db:dd vsan 128 bytes from 21:00:00:20:37:6f:db:dd time = 1454 usec28 bytes from 21:00:00:20:37:6f:db:dd time = 471 usec28 bytes from 21:00:00:20:37:6f:db:dd time = 372 usec28 bytes from 21:00:00:20:37:6f:db:dd time = 364 usec28 bytes from 21:00:00:20:37:6f:db:dd time = 1261 usec5 frames sent, 5 frames received, 0 timeoutsRound-trip min/avg/max = 364/784/1454 usecfcroute
To configure Fibre Channel routes, use the fcroute command.
fcroute fcid [network_mask] interface {fc slot/port | portchannel port} domain domain-id [[metric number] remote] vsan vsan-id
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
Use this command to assign forwarding information to the switch.
Examples
switch# config tswitch(config)#switch(config)# fcroute 0x111211 interface fc1/1 domain 3 vsan 2switch(config)#switch(config)# fcroute 0x111211 interface port-channel 1 domain 3 vsan 4switch(config)#switch(config)# fcroute 0x031211 interface fc1/1 domain 3 metric 1 vsan 1switch(config-if)#switch(config)# fcroute 0x111112 interface fc1/1 domain 3 metric 3 remote vsan 3Related Commands
fcs plat-check-global vsan
To enable FCS platform and node name checking fabric wide, use the fcs plat-check-global vsan command in configuration mode. To disable this feature, use the no form of the command.
fcs plat-check-global vsan vsan-id
no fcs plat-check-global vsan vsan-id
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
None.
Examples
switch# config tswitch(config)# fcs plat-check-global vsan 2Related Commands
fcs register
To register FCS attributes, use the fcs register command in configuration mode. To disable this feature, use the no form of the command.
fcs register
platform name name vsan vsan-idfcs register
no platform name name vsan vsan-idSyntax Description
platform name name
Specifies name of the platform to register. Maximum size is 255 characters.
vsan vsan-id
Specifies the VSAN ID. The range is 1 to 4096.
Defaults
None.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
None.
Examples
switch# config tswitch(config)# fcs registerswitch(config-fcs-register)# platform Platform1 vsan 10Related Commands
fcsp dhchap
To configure DHCHAP options in a switch, use the fcsp dhchap command in configuration mode. This command is only available when the FC-SP feature is enabled. Use the no form of the command to revert to factory defaults.
fcsp dhchap {devicename switch-wwn password [0 | 7] password |
dhgroup [0 | 1| 2 | 3 | 4] |
hash [md5 | sha1] |
password [0 | 7] password [wwn wwn-id]no fcsp dhchap {devicename switch-wwn password [0 | 7] password |
dhgroup [0 | 1| 2 | 3 | 4] |
hash [md5 | sha1] |
password [0 | 7] password [wwn-id]Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
You can only see the fcsp dhchap command if you issue the fcsp enable command.
Using SHA-1 as the hash algorithm may prevent RADIUS or TACACS+ usage.
If you change the DH group configuration, ensure to change it globally for all switches in the fabric.
Examples
The following example enables FC-SP.
switch## config tswitch(config)# # fcsp enableswitch (config)#The following example configures the use of only the SHA-1 hash algorithm.
switch(config)# fcsp dhchap hash sha1The following example configures the use of only the MD-5 hash algorithm.
switch(config)# fcsp dhchap hash md5The following example defines the use of the default hash algorithm priority list of MD-5 followed by SHA-1 for DHCHAP authentication.
switch(config)# fcsp dhchap hash md5 sha1The following example reverts to the factory default priority list of the MD-5 hash algorithm followed by the SHA-1 hash algorithm.
switch(config)# no fcsp dhchap hash sha1The following example prioritizes the use of DH group 2, 3, and 4 in the configured order.
switch(config)# fcsp dhchap group 2 3 4The following example reverts to the DHCHAP factory default order of 0, 4, 1, 2, and 3 respectively.
switch(config)# no fcsp dhchap group 0The following example configures a clear text password for the local switch.
switch(config)# fcsp dhchap password 0 mypasswordThe following example configures a clear text password for the local switch to be used for the device with the specified WWN.
switch(config)# fcsp dhchap password 0 mypassword 30:11:bb:cc:dd:33:11:22The following example removes the clear text password for the local switch to be used for the device with the specified WWN.
switch(config)# no fcsp dhchap password 0 mypassword 30:11:bb:cc:dd:33:11:22The following example configures a password entered in an encrypted format for the local switch.
switch(config)# fcsp dhchap password 7 sfsfdfThe following example configures a password entered in an encrypted format for the local switch to be used for the device with the specified WWN.
switch(config)# fcsp dhchap password 7 sfsfdf 29:11:bb:cc:dd:33:11:22The following example removes the password entered in an encrypted format for the local switch to be used for the device with the specified WWN.
switch(config)# no fcsp dhchap password 7 sfsfdf 29:11:bb:cc:dd:33:11:22The following example configures a clear text password for the local switch to be used with any connecting device.
switch(config)# fcsp dhchap password mypassword1The following example configures a password for another switch in the fabric which is identified by the Switch WWN device name.
switch(config)# fcsp dhchap devicename 00:11:22:33:44:aa:bb:cc password NewPasswordThe following example removes the password entry for this switch from the local authentication database.
switch(config)# no fcsp dhchap devicename 00:11:22:33:44:aa:bb:cc password NewPasswordThe following example configures a clear text password for another switch in the fabric which is identified by the Switch WWN device name.
switch(config)# fcsp dhchap devicename 00:11:55:66:00:aa:bb:cc password 0 NewPasswordThe following example configures a password entered in an encrypted format for another switch in the fabric which is identified by the Switch WWN device name.
switch(config)# fcsp dhchap devicename 00:11:22:33:55:aa:bb:cc password 7 asdflkjhRelated Commands
fcsp enable
To enable the Fibre Channel Security Protocol (FC-SP) in a switch, use the fcsp enable command in configuration mode. Further FC-SP commands are available when the FC-SP feature is enabled. To disable FC-SP, use the no form of this command.
fcsp enable
no fcsp enable
Syntax Descriptionf
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
None.
Examples
The following example enables FC-SP.
switch# config tswitch(config)# fcsp enableswitch(config)#Related Commands
fcsp timeout
To configure the timeout value for FC-SP message, use the fcsp timeout command in configuration mode. Use the no form of the command to revert to factory defaults.
fcsp timeout timeout-period
no fcsp timeout timeout-period
Syntax Description
timeout-period
Specifies the time out period. The time ranges from 20 to 100 seconds. The default is 30 seconds.
Defaults
30 seconds
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
You can only see the fcsp timeout command if you issue the fcsp enable command.
Examples
The following example configures the FCSP timeout value.
switch# config tswitch(config)# fcsp enableswitch(config)# fcsp timeout 60Related Commands
fctimer
To change the default Fibre Channel timers, use the fctimer command in configuration mode. To revert to the default values, use the no form of the command.
fctimer {d_s_tov milliseconds [vsan vsan-id] | e_d_tov milliseconds [vsan vsan-id] | r_a_tov milliseconds [vsan vsan-id]}
no fctimer {d_s_tov milliseconds [vsan vsan-id] | e_d_tov milliseconds [vsan vsan-id] | r_a_tov milliseconds [vsan vsan-id]}
Syntax Description
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
The Cisco MDS 9000, Brocade, and McData FC Error Detect (ED_TOV) and Resource Allocation (RA_TOV) timers default to the same values. They can be changed if needed. In accordance with the FC-SW2 standard, these values must be the same on each switch within in the fabric.
Use the vsan option to configure different TOV values for VSANs with special types of links like FC or IP tunnels.
Examples
The following examples show how to change the default Fibre Channel timers.
switch# config tswitch(config)# fctimer e_d_tov 5000switch(config)# fctimer r_a_tov 7000Related Commands
fctrace
To trace the route to an N port, use the fctrace command in EXEC mode.
fctrace {fcid fcid vsan vsan-id [timeout value] | pwwn pwwn-id [timeout seconds]}
Syntax Description
Defaults
By default, the period to wait before timing out is 5 seconds.
Command Modes
EXEC mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
None.
Examples
The following example traces a route to the specified fcid in VSAN 1.
switch# fctrace fcid 0x660000 vsan 1Route present for : 0x66000020:00:00:05:30:00:5f:1e(0xfffc65)Latency: 0 msec20:00:00:05:30:00:61:5e(0xfffc66)Latency: 0 msec20:00:00:05:30:00:61:5e(0xfffc66)fc-tunnel
To terminate a Fibre Channel tunnel in a destination switch, use the fc-tunnel command. To remove a configuration or revert it to factory defaults, use the no form of the command.
fc-tunnel {enable | explicit-path name [next-address ip-address {loose | strict}] | tunnel-id-map tunnel-id interface fc slot-number}
no fc-tunnel {enable | explicit-path name | tunnel-id-map tunnel-id}
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.2(1).
Usage Guidelines
All VSANs with RSPAN traffic must be enabled. If a VSAN containing RSPAN traffic is not enabled, it will be dropped.
The FC tunnel can only be configured in the same subnet as the VSAN interface.
The Fibre Channel tunnel feature must be enabled (the interface fc-tunnel command) on each switch in the end-to-end path of the Fibre Channel fabric in which RSPAN is to be implemented
Examples
The following example enables the FC tunnel feature.
switch# config tswitchS(config)# fc-tunnel enableThe following example places you at the explicit path prompt for the path named Path 1and specifies that the next hop VSAN interface IP addresses.
switch# config tswitchS(config)# fc-tunnel explicit-path Path1switchS(config-explicit-path)# next-address 10.10.10.2 strictswitchS(config-explicit-path)# next-address 10.10.10.3 strictswitchS(config-explicit-path)# next-address 10.10.10.4 strictThe following example places you at the explicit path prompt for the path named Path 3 and configures a minimum cost path in which this IP address exists.
switchS(config)# fc-tunnel explicit-path Path3switchS(config-explicit-path)# next-address 10.10.10.3 looseThe following example configures the FC tunnel (100) in the destination switch (switch D).
switchD(config)# fc-tunnel tunnel-id-map 100 interface fc2/1The following example creates two explicit paths and configures the next hop addresses for each path in the source switch (switch S).
switchS# config tswitchS(config)# fc-tunnel explicit-path Path1switchS(config-explicit-path)# next-address 10.10.10.2 strictswitchS(config-explicit-path)# next-address 10.10.10.3 strictswitchS(config-explicit-path)# next-address 10.10.10.4 strictswitchS(config-explicit-path)# exitswitchS(config)# fc-tunnel explicit-path Path3switchS(config-explicit-path)# next-address 10.10.10.3 looseThe following example references the configured path in the source switch (switch S).
switchS# config tswitchS(config)# interface fc-tunnel 100switchS(config)# explicit-path Path1Related Commands
show span session
Displays all SPAN session information.
show fc-tunnel tunnel-id-map
Displays FC tunnel egress mapping information
ficon swap
To enable the FICON feature in a specified VSAN, use the ficon swap command in configuration mode.
ficon swap portnumber port-number port-number [after swap noshut]
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
The ficon swap portnumber old-port-number new port-number command causes all configuration associated with old-port-number and new port-number to be swapped, including VSAN configurations. This command is only associated with the two ports in concerned. You must issue this VSAN-independent command from the EXEC mode.
If you specify the ficon swap portnumber after swap noshut command, the ports will automatically be initialize.
Refer to the Cisco MDS 9000 Family Configuration Guide for further information.
Examples
The following example swaps the contents of ports 3 with port 15, shuts them down, and automatically initializes both ports.
switch# ficon swap portnumber 3 15 after swap noshutThe following example swaps the contents of ports 3 with port 15 and shuts them down.
switch# ficon swap portnumber 3 15Related Commands
ficon vsan (EXEC mode)
To configure FICON related parameters in EXEC mode, use the ficon vsan command. To remove the configuration or revert to the default values, use the no form of the command.
ficon vsan vsan-id | apply file file-name | copy file old-file-name new-file-name | offline | online}
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
When an MDS switch is booting up with saved configuration, if FICON is enabled on a VSAN, the IPL configuration file is applied automatically by the SAN-OS software after the switch initialization is completed.
Use the ficon vsan vsan-id copy file exiting-file-name save-as-file-name command to copy an existing FICON configuration file. You can see the list of existing configuration files by issuing the show ficon vsan vsan-id command
Examples
The following example applies the configuration from the saved files to the running configuration.
switch# ficon vsan 2 apply file SampleFileThe following example copies an existing FICON configuration file called IPL and renames it to IPL3.
switch# ficon vsan 20 copy file IPL IPL3Related Commands
ficon vsan (configuration mode)
To enable the FICON feature in a specified VSAN, use the ficon vsan command in configuration mode. To disable the feature or to revert to factory defaults, use the no form of the command.
ficon vsan vsan-id
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
An IPL configuration file is automatically created
Once you enable FICON, you cannot disable in-order delivery, fabric binding, or static domain ID configurations.
When you disable FICON, the FICON configuration file is also deleted.
Examples
The following example is enables FICON on VSAN 2.
switch(config)# ficon vsan 2The following example is disables FICON on VSAN 6.
switch(config)# no ficon vsan 6Related Commands
file
To access FICON configuration files in a specified VSAN, use the file command. To disable the feature or to revert to factory defaults, use the no form of the command.
file file-name
no file file-name
Syntax Description
Defaults
None.
Command Modes
FICON configuration submode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.3(1).
Usage Guidelines
The configuration file submode allows you to create and edit FICON configuration files. If a specified file does not exist, it is created. Up to 16 files can be saved. Each file name is restricted to 8 alphanumeric characters.
Examples
The following example accesses the FICON configuration file called IplFile1 for VSAN 2. If this file does not exist, it is created.
switch# config tswitch(config)# ficon vsan 2switch(config-ficon)# file IplFile1switch(config-ficon-file)#The following example deletes a previously-created FICON configuration file.
switch(config-ficon)# no file IplFileARelated Commands
ficon vsan
Enable FICON for a VSAN.
show ficon
Displays configured FICON details.
find
To display a list of files on a file system, use the find command in EXEC mode.
find filename
Syntax Description
filename
Specifies a search string to match to the files in the default directory. Maximum length is 64 characters.
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
Use the find (Flash file system) command to display more detail about the files in a particular file system.
Examples
The following example is sample output of all files that begin with the letter a:
switch# find a./accountingd./acl./ascii_cfg_server./arpingRelated Commands
cd
Changes the default directory or file system.
dir
Displays all files in a given file system.
format
To erase all the information on a module, use the format command in EXEC mode.
format {bootflash: | slot0:}
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
The SAN-OS software only supports Cisco-certified CompactFlash devices that are formatted using Cisco MDS switches. Using uncertified CompactFlash devices may result in unpredictable consequences; formatting CompactFlash devices using other platforms may result in errors.
Examples
The following example erases all information on the bootflash memory.
switch# format bootflash:fspf config vsan
To configure an FSPF feature for the entire VSAN, use the fspf config vsan command in configuration mode. To delete FSPF configuration for the entire VSAN, use the no form of the command.
fspf config vsan vsan-id
min-ls-arrival ls-arrival-time
min-ls-interval ls-interval-time
region region-id
spf {hold-time spf-holdtime | static}fspf config vsan vsan-id
no min-ls-arrival
no min-ls-interval
no region
no spf {hold-time | static}no fspf config vsan vsan-id
Syntax Description
Defaults
In the FSPF configuration mode, the default is dynamic.
If configuring spf hold-time, the default value for FSPF is 0.
If configuring min-ls-arrival, the default value for FSPF is 1000 msecs.
If configuring min-ls-interval, the default value for FSPF is 5000 msecs.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
This command configures FSPF on VSANs globally.
For the commands issued in FSPF configuration mode, you do not have to specify the VSAN number every time. This prevents configuration errors that might result from specifying the wrong VSAN number for these commands.
Examples
The following example configures FSPF globally in VSAN 1, deletes the FSPF configured in VSAN 3, disables FSPF in VSAN 5, and enables FSPF in VSAN 7.
switch## config tswitch(config)##switch(config)# fspf config vsan 1switch-config-(fspf-config)# spf staticswitch-config-(fspf-config)# exitswitch(config)#switch(config)# no fspf config vsan 3switch(config)#Related Commands
fspf cost
To configure FSPF link cost for an FCIP interface, use the fspf cost command. Torevert to the default value, use the no form of the command.
fspf cost link-cost vsan vsan-id
no fspf cost link-cost vsan vsan-id
Syntax Description
link-cost
Enters FSPF link cost in seconds. The range is 1 to 65535.
vsan vsan-id
Specifies a VSAN ID. The range is 1 to 4093.
Defaults
1000 seconds for 1 Gbps
500 seconds for 2 Gbps
Command Modes
Interface configuration submode
Command History
This command was modified in Cisco MDS SAN-OS Release 1.1(1).
Usage Guidelines
Access this command from the switch(config-if)# submode.
FSPF tracks the state of links on all switches in the fabric, associates a cost with each link in its database, and then chooses the path with a minimal cost. The cost associated with an interface can be changed using the fspf cost command to implement the FSPF route selection.
Examplesseconds.
switch# config tswitch(config)# interface fcip 1switch(config-if)# fspf cost 5000 vsan 1Related Commands
show fspf interface
Displays information for each selected interface.
show interface fcip
Displays an interface configuration for a specified FCIP interface.
fspf dead-interval
To set the maximum interval for which a hello message must be received before the neighbor is considered lost, use the fspf dead-interval command. To revert to the default value, use the no form of the command.
fspf dead-interval seconds vsan vsan-id
no fspf dead-interval seconds vsan vsan-id
Syntax Description
seconds
Specifies the FSPF dead interval in seconds. The rage is 2 to 65535.
vsan vsan-id
Specifies a VSAN ID. The range is 1 to 4093.
Defaults
80 seconds
Command Modes
Interface configuration submode
Command History
This command was modified in Cisco MDS SAN-OS Release 1.1(1).
Usage Guidelines
Access this command from the switch(config-if)# submode.
Note
Caution
Examples
switch# config tswitch(config)# interface fcip 1switch(config-if)# fspf dead-interval 4000 vsan 1Related Commands
show fspf interface
Displays information for each selected interface.
show interface fcip
Displays an interface configuration for a specified FCIP interface.
fspf enable vsan
To enable FSPF for a VSAN, use the fspf enable command in configuration mode. To disable FSPF routing protocols, use the no form of the command.
fspf enable vsan vsan-id
no fspf enable vsan vsan-id
Syntax Description
Defaults
Enabled
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Usage Guidelines
This command configures FSPF on VSANs globally.
Examples
The following example enables FSPF in VSAN 5 and disables FSPF in VSAN 7.
switch## config tswitch(config)# fspf enable vsan 5switch(config)# no fspf enable vsan 7Related Commands
fspf config vsan
Configures FSPF features for a VSAN.
show fspf interface
Displays information for each selected interface.
fspf hello-interval
To verify the health of the link, use the fspf hello-interval command. To revert to the default value, use the no form of the command.
fspf hello-interval seconds vsan vsan-id
no fspf hello-interval seconds vsan vsan-id
Syntax Description
hello-interval seconds
Specifies the FSPF hello-interval in seconds. The rage is 2 to 65535.
vsan vsan-id
Specifies a VSAN ID. The range is 1 to 4093.
Defaults
20 seconds
Command Modes
Interface configuration submode
Command History
This command was modified in Cisco MDS SAN-OS Release 1.1(1).
Usage Guidelines
Access this command from the switch(config-if)# submode.
This command configures FSPF for the specified FCIP interface.
Note
Examples
switch# config tswitch(config)# interface fcip 1switch(config-if)# fspf hello-interval 3 vsan 1Related Commands
show fspf interface
Displays information for each selected interface.
show interface fcip
Displays an interface configuration for a specified FCIP interface.
fspf passive
To disable the FSPF protocol for selected interfaces, use the fspf passive command. To revert to the default state, use the no form of the command.
fspf passive vsan vsan-id
no fspf passive vsan vsan-id
Syntax Description
Defaults
FSPF is enabled.
Command Modes
Interface configuration submode
Command History
This command was modified in Cisco MDS SAN-OS Release 1.1(1).
Usage Guidelines
Access this command from the switch(config-if)# submode.
By default, FSPF is enabled on all E ports andTE ports. FSPF can be disabled by setting the interface as passive using the fspf passive command.
Note
Examples
switch# config tswitch(config)# interface fcip 1switch(config-if)# fspf passive vsan 1Related Commands
show fspf interface
Displays information for each selected interface.
show interface fcip
Displays an interface configuration for a specified FCIP interface.
fspf retransmit-interval
To specify the time after which an unacknowledged link state update should be transmitted on the interface, use the fspf retransmit-interval command. To revert to the default value, use the no form of the command.
fspf retransmit-interval seconds vsan vsan-id
no spf retransmit-interval seconds vsan vsan-id
Syntax Description
seconds
Specifies FSPF retransmit interval in seconds. The range is
1 to 65535.vsan vsan-id
Specifies a VSAN ID. The range is 1 to 4093.
Defaults
5 seconds
Command Modes
Interface configuration submode
Command History
This command was modified in Cisco MDS SAN-OS Release 1.1(1).
Usage Guidelines
Access this command from the switch(config-if)# submode.
Note
Examples
switch# config tswitch(config)# interface fcip 1switch(config-if)# fspf retransmit-interval 6 vsan 1Related Commands
show fspf interface
Displays information for each selected interface.
show interface fcip
Displays an interface configuration for a specified FCIP interface.
