Table Of Contents
F Commands
fcalias name
fcanalyzer
fcc
fcdomain
fcdomain rcf-reject
fcdroplatency
fcflow stats
fcinterop fcid-allocation
fcinterop loop-monitor
fcip profile
fcns proxy-port
fcping
fcroute
fcs
fctimer
fctrace
find
format
fspf config
fspf cost
fspf dead-interval
fspf hello-interval
fspf passive
fspf retransmit-interval
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.
•fcalias name
•fcanalyzer
•fcc
•fcdomain
•fcdroplatency
•fcflow stats
•fcinterop fcid-allocation
•fcinterop loop-monitor
•fcip profile
•fcns proxy-port
•fcping
•fcroute
•fcs
•fctimer
•fctrace
•find
•format
•fspf config
•fspf cost
•fspf dead-interval
•fspf hello-interval
•fspf passive
•fspf retransmit-interval
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
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)# fcalias name AliasSample vsan 3
switch(config-fcalias)# member fcid 0x222222
switch(config-fcalias)# member pwwn 10:00:00:23:45:67:89:ab
switch(config-fcalias)# member fwwn 10:01:10:01:10:ab:cd:ef
Related Commands
Command
|
Description
|
member fcid
|
Configures alias member for a specified zone.
|
member pwwn
|
Configures alias members based on the specified port WWN type and value.
|
member fwwn
|
Configures alias members based on the specified fWWN type and value.
|
fcanalyzer
To configure the Cisco Fabric Analyzer use the fcanalyzer command in configuration mode.
fcanalyzer [local | local brief | display-filter | limit-frame-size | limit-captured-frames write]
[remote ip-address active port-number]
Syntax Description
local
|
Begins capturing the frames locally (supervisor module).
|
local brief
|
Displays the protocol summary in a brief format.
|
display-filter
|
Displays the filtered frames.
|
limit-frame-size
|
Limits the size of the frame capture to the first 64 bytes. The allowed range is 64 to 65536 bytes.
|
limit-captured-frames
|
Limits the number of frames captured to 10. The allowed range is 0 to 2147483647 frames and the default is 100 frames. Use 0 if you do not want to limit the captures frames.
|
write
|
Saves the captured frames to a specified file.
|
remote
|
Configures the remote IP address to which the captured frames will be sent.
|
ip-address
|
Specifies IP address or histamine. Maximum length is 1024 characters.
|
active
|
Enables active mode (passive is the default) with the remote host.
|
port-number
|
Specifies port number
|
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)# fcanalyzer local
switch(config)# fcanalyzer local brief
switch(config)# fcanalyzer local display-filter SampleF
switch(config)# fcanalyzer local limit-frame-size 64
switch(config)# fcanalyzer local limit-captured-frames 10
switch(config)# fcanalyzer local write SampleFile
switch(config)# fcanalyzer remote 10.21.0.3
switch(config)# fcanalyzer remote 10.21.0.3 active
Related Commands
Command
|
Description
|
clear fcanalyzer
|
Clears the entire list of configured hosts.
|
show fcanalyzer
|
Displays the list of hosts configured for a remote capture.
|
fcc
To assign Fibre Channel Congestion Control priority, use the fcc priority command in configuration mode.
fcc [ priority number ]
Syntax Description
fcc
|
Enables FCC for the entire switch.
|
priority
|
Assigns FCC priority for the entire switch.
|
number
|
The FCC priority threshold. with 0 being the lowest and 7 being the highest.
|
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 the FCC priority threshold configured as 2.
switch(config)# fcc priority 2
Related Commands
Command
|
Description
|
show fcc
|
Displays FCC settings.
|
fcdomain
To configure the Fibre Channel domain feature, use the fcdomain command. The no form of this command, disables the FC domain.
fcdomain [auto-reconfigure vsan vsan-id] [contiguous-allocation vsan vsan-id] [domain id
preferred | static vsan vsan-id | static c] [fabric-name name] [fcid database vsan vsan-id |
persistent vsan vsan-id] [priority value vsan vsan-id] [restart disruptive vsan vsan-id] [vsan
vsan-id] [restart vsan vsan-id] [vsan vsan-id]
Syntax Description
auto-reconfigure
|
Configures autoreconfigure.
|
vsan
|
Specifies a VSAN.
|
vsan-id
|
The ID of the VSAN is from 1 to 4093.
|
contiguous-allocation
|
Configures contiguous allocation.
|
domain
|
Configures the domain ID and its type.
|
id
|
Specifies the domain ID, which is from 0 to 239.
|
preferred
|
Configures the domain ID as preferred (default—the local switch accepts the domain ID assigned by the principal switch and the assigned domain ID becomes the runtime domain ID).
|
static
|
Configures the domain ID as static (the assigned domain ID is discarded, all local interfaces are isolated, and the local switch assigns itself the configured domain ID, which becomes the runtime domain ID.).
|
fabric-name
|
Configures the fabric name.
|
name
|
Specifies the fabric name.
|
fcid
|
Configures FC domain persistent FCIDs.
|
database
|
Enters persistent FCIDs submode.
|
persistent
|
Enables or disables FC domain persistent FCIDs.
|
priority
|
Configures the FC domain priority.
|
value
|
Specifies the FC domain priority, which is from 1 to 254.
|
restart disruptive
|
Forces the disruptive fabric reconfiguration.
|
restart
|
Starts a disruptive or nondisruptive reconfiguration.
|
Defaults
Enabled.
Command Modes
Configuration mode.
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)# fcdomain domain 3 preferred vsan 87
switch(config)# no fcdomain domain 3 preferred vsan 87
switch(config)# fcdomain domain 2 static vsan 237
switch(config)# no fcdomain domain 2 static vsan 237
switch(config)# fcdomain restart vsan 1
switch(config)# fcdomain restart disruptive vsan 1
switch(config)# fcdomain priority 25 VSAN 99
switch(config)# no fcdomain priority 25 VSAN 99
switch(config)# fcdomain auto-reconfigure vsan 10
switch(config)# fcdomain contiguous-allocation vsan 81-83
switch(config)# no fcdomain contiguous-allocation vsan 1030
switch(config)# fcdomain fabric-name 20:1:ac:16:5e:0:21:01 vsan 3
switch(config)# no fcdomain fabric-name 20:1:ac:16:5e:0:21:01 vsan 3010
Related Commands
Command
|
Description
|
show fcdomain
|
Displays global information about the FC domain configurations.
|
fcdomain rcf-reject
To configure the domain features for a Fibre Channel or FCIP interface, use the fcdomain option. The no form of this option, disables the FC domain.
fcdomain rcf-reject vsan number
no fcdomain rcf-reject vsan number
Syntax Description
fcdomain
|
Enters the fcdomain mode for this FCIP interface
|
rcf-reject
|
Configures the RCF reject option.
|
vsan
|
Specifies a VSAN.
|
vsan-id
|
Specifies the VSAN ID, which is from 1 to 4093.
|
Defaults
Enabled
Command Modes
Configuration mode
Usage Guidelines
Access this command from the switch(config-if)# submode.
Use this option to configure the RCF reject option for the selected FCIP interface.
Examples
The following examples show how to configure the FCIP rcf-reject fcdomain feature.
switch(config)# interface fcip 1
switch(config-if)# fcdomain rcf-reject vsan 1
Related Commands
Command
|
Description
|
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| switch milliseconds]
Syntax Description
network milliseconds
|
Configures network latency.
|
switch
|
Configures switch latency.
|
milliseconds
|
Specifies latency from 0 to 2147483647 milliseconds.
|
Defaults
Disabled.
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)# fcdroplatency network 5000
The following example shows how to disable network latency.
switch(config)# no fcdroplatency network
The following example shows how to configure the switch latency to 4000 milliseconds.
switch(config)# fcdroplatency switch 4000
The following example shows how to disable switch latency.
switch(config)# no fcdroplatency switch
Related Commands
Command
|
Description
|
show fcdroplatency
|
Displays the configured FC drop latency parameters.
|
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}
no fcflow stats {aggregated module module-number index flow-number vsan vsan-id | module
module-number index flow-number destination-fcid source-fcid netmask}
Syntax Description
aggregated
|
Configures aggregated fcflow statistics.
|
index
|
Specifies the flow index.
|
flow-number
|
Specifies a flow number from 0-2147483647.
|
vsan
|
Specifies a VSAN.
|
vsan-id
|
The ID of the VSAN is from 1 to 4093.
|
module
|
Clear fcflow statistics on a module.
|
module-number
|
Specifies a module number from 1 to 9.
|
destination-fcid
|
Enters the destination FC ID in hex format.
|
source-fcid
|
Enters the source FC ID in hex format.
|
netmask
|
Enters the mask for the source and destination FC ID (restricted to 6 characters ranging from 000000 to ffffff).
|
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 1
The following example disables the aggregated flow counter.
switch(config)# no fcflow stats aggregated module 1 index 1005 vsan 1
The following example enables the flow counter for module 1.
switch(config)# fcflow stats module 1 index 1 0x145601 0x5601 fffff vsan 1
The following example disables the flow counter for module 1.
switch(config)# no fcflow stats aggregated module 2 index 1001 vsan 2
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
fcid-allocation
|
Sets single FCID interop mode.
|
auto
|
Assigns single FCID to compatible HBAs.
|
flat
|
Assign single FCID.
|
none
|
Assigns FCID range.
|
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)# fcinterop fcid-allocation none
switch(config)# fcinterop fcid-allocation flat
switch(config)# fcinterop fcid-allocation auto
Related Commands
Command
|
Description
|
show flogi database
|
Displays the fabric login (FLOGI) table.
|
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
loop-monitor
|
Configures monitoring of NL ports in a loop.
|
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 configures monitoring of NL ports in a loop.
switch(config)# fcinterop loop-monitor
switch(config)# no fcinterop loop-monitor
Related Commands
Command
|
Description
|
show flogi database
|
Verify if a storage device is displayed in the Fabric login (FLOGI) table.
|
fcip profile
To configure the FCIP profile, provide the local IP address to determine the Gigabit Ethernet port where the FCIP links terminates.
fcip profile profile-id exit | ip address address | port number | tcp [minimum-retransmit-time
milliseconds | keepalive-timeout seconds| max-retransmissions number | pmtu-enable
[reset-timeout seconds] | sack-enable | window-size size]
no fcip profile
Syntax Description
fcip profile
|
Configures the FCIP profile.
|
profile-id
|
Specifies a ID range from 1 to 255.
|
exit
|
Exits from this submode
|
ipaddress
|
Configures the peer IP address.
|
address
|
Enters the IP address.
|
port
|
Configures a peer port.
|
number
|
Enters the peer port number from 1 to 65535.
|
tcp
|
Configures TCP parameters for the FCIP profile.
|
minimum-retransmit-time milliseconds
|
Configures the minimum retransmit time in milliseconds from 100 to 5000.
|
keepalive-timeout seconds
|
Configures the keep alive timeout value in seconds from 1 to 7200.
|
max-retransmissions number
|
Configures the maximum number of retransmissions from 1 to 8.
|
pmtu-enable
|
Enables PMTU discovery.
|
reset-timeout seconds
|
Configures the PMTU reset timeout in seconds from 60 to 3600.
|
sack-enable
|
Enables the SACK option for the TCP connection.
|
window-size size
|
Configures the window size in kilobytes from 1 to 32768.
|
Defaults
Disabled
Command Modes
Configuration mode,
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.1(1).
Usage Guidelines
You can specify a range of interfaces by issuing a command with the following example format:
interface spacefcipspace1space-space5space,spacefc2/5space-space7
Examples
profile Configure fcip profile
switch(config)# fcip profile 5
switch(config-profile)# ?
exit Exit from this submode
no Negate a command or set its defaults
port Config local port to profile
tcp Config TCP Parameters for the Profile
switch(config-profile)# ip address 10.5.1.1
switch(config-profile)# port 5000
switch(config-profile)# tcp ?
minimum-retransmit-time Set minimum retransmit time in millisec
keepalive-timeout Set keep alive timeout in sec
max-retransmissions Maximum number of retransmissions
pmtu-enable Enable PMTU Discovery
sack-enable Enable SACK option for TCP
window-size Sets window size advertised in KBytes
switch(config-profile)# tcp minimum-retransmit-time 3000
switch(config-profile)# tcp keepalive-timeout 450
switch(config-profile)# tcp max-retransmissions 5
switch(config-profile)# tcp pmtu-enable
switch(config-profile)# tcp pmtu-enable reset-timeout 3100
switch(config-profile)# tcp sack-enable
switch(config-profile)# tcp window-size 4000
Related Commands
Command
|
Description
|
show fcip profile
|
Displays information about the FCIP profile.
|
interface fcip interface_number use-profile profile-id
|
Configures the interface using an existing profile ID from 1 to 255.
|
show interface fcip
|
Displays an interface configuration for a specified FCIP interface.
|
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]
Syntax Description
wwn-id
|
The port WWN, with the format hh:hh:hh:hh:hh:hh:hh:hh.
|
vsan
|
Configures a proxy port for the specified 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
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 doesn't, then the request is rejected.
Examples
The following example shows registering a name server proxy.
switch(config)# fcns proxy-port 21:00:00:e0:8b:00:26:d
The following example shows configuring a proxy port for VSAN 2.
switch(config)# fcns proxy-port 21:00:00:e0:8b:00:26:d vsan 2
Related Commands
Command
|
Description
|
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 fcid command in EXEC mode.
fcping {fcid fc-port vsan vsan-id [count number | timeout value | usr-priority] | pwwn wwn-id}
Syntax Description
fc id
|
The FC ID of the destination N port.
|
fc-port
|
The port FC ID, with the format 0xhhhhhh.
|
pwwn
|
The port WWN of the destination N port.
|
wwn-id
|
The port WWN, with the format hh:hh:hh:hh:hh:hh:hh:hh.
|
vsan
|
Configures the VSAN ID of the destination N port.
|
vsan-id
|
The ID of the VSAN is from 1 to 4093.
|
count
|
Configure the frames to send.
|
number
|
Specifies the number of frames to send. A value of 0 sends forever.
|
timeout
|
The timeout value.
|
usr-priority
|
The priority the frame receives in the switch fabric.
|
Defaults
None.
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 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 1
28 bytes from 0xd70000 time = 730 usec
28 bytes from 0xd70000 time = 165 usec
28 bytes from 0xd70000 time = 262 usec
28 bytes from 0xd70000 time = 219 usec
28 bytes from 0xd70000 time = 228 usec
5 frames sent, 5 frames received, 0 timeouts
Round-trip min/avg/max = 165/270/730 usec
The 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 10
28 bytes from 0xd70000 time = 730 usec
28 bytes from 0xd70000 time = 165 usec
28 bytes from 0xd70000 time = 262 usec
28 bytes from 0xd70000 time = 219 usec
28 bytes from 0xd70000 time = 228 usec
28 bytes from 0xd70000 time = 230 usec
28 bytes from 0xd70000 time = 230 usec
28 bytes from 0xd70000 time = 225 usec
28 bytes from 0xd70000 time = 229 usec
28 bytes from 0xd70000 time = 183 usec
10 frames sent, 10 frames received, 0 timeouts
Round-trip min/avg/max = 165/270/730 usec
The 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 10
28 bytes from 0xd500b4 time = 1345 usec
28 bytes from 0xd500b4 time = 417 usec
28 bytes from 0xd500b4 time = 340 usec
28 bytes from 0xd500b4 time = 451 usec
28 bytes from 0xd500b4 time = 356 usec
5 frames sent, 5 frames received, 0 timeouts
Round-trip min/avg/max = 340/581/1345 usec
This 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 1
No response from the N port.
switch# fcping pwwn 21:00:00:20:37:6f:db:dd vsan 1
28 bytes from 21:00:00:20:37:6f:db:dd time = 1454 usec
28 bytes from 21:00:00:20:37:6f:db:dd time = 471 usec
28 bytes from 21:00:00:20:37:6f:db:dd time = 372 usec
28 bytes from 21:00:00:20:37:6f:db:dd time = 364 usec
28 bytes from 21:00:00:20:37:6f:db:dd time = 1261 usec
5 frames sent, 5 frames received, 0 timeouts
Round-trip min/avg/max = 364/784/1454 usec
fcroute
To configure Fibre Channel routes, use the fcroute command.
fcroute FCID [network_mask] interface type [domain domain-id| metric number | remote | vsan
vsan-id]
Syntax Description
network_mask
|
Configures the FCID network mask.
|
interface
|
Configures the route for the specified Fibre Channel interface.
|
type
|
Specifies the Fibre Channel number or the PortChannel number.
|
domain
|
Configures the route for the domain of the next hop switch.
|
domain-id
|
Specifies the domain ID.
|
metric
|
Assigns the cost of the route.
|
number
|
Specifies the cost of the route. Default cost is 10.
|
vsan
|
Configures the static route for a specific VSAN.
|
vsan-id
|
The ID of the VSAN is from 1 to 4093.
|
remote
|
Configures the static route for a destination switch remotely connected.
|
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)# fcroute 0x111211 interface fc1/1 domain 3 vsan 2
switch(config)# fcroute 0x111211 interface port-channel 1 domain 3 vsan 4
switch(config)# fcroute 0x031211 interface fc1/1 domain 3 metric 1 vsan 1
switch(config)# fcroute 0x111112 interface fc1/1 domain 3 metric 3 remote vsan 3
Related Commands
Command
|
Description
|
show fcroute
|
Displays Fibre Channel routes.
|
fcs
To perform platform and node name checking fabric wide, and register FCS attributes, use the fcs command in configuration mode.
fcs {plat-check-global vsan vsan-id | register [exit | no | platform] name}
Syntax Description
plat-check-global vsan
|
Configures platform name or node name checking.
|
vsan-id
|
Specifies the VSAN ID for platform checking, which is from 1 to 4096.
|
register
|
Registers FCS attributes.
|
exit
|
Exits submode.
|
no
|
Negates a command or sets its defaults.
|
platform
|
Configures platform object registration.
|
name
|
Specifies name of the platform.
|
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)# # fcs plat-check-global vsan 2
switch (config)# fcs register
switch (config-fcs-register)# platform Platform1
Related Commands
Command
|
Description
|
show fcs
|
Displays fabric configuration server information.
|
fctimer
To change the default Fibre Channel timers, use the fctimer command in configuration mode.
fctimer {D_S_TOV milliseconds | E_D_TOV milliseconds | R_A_TOV milliseconds}
Syntax Description
D_S_TOV
|
The distributed services time out value ranges from 5000 to 100000 ms.
|
E_D_TOV
|
The error detect time out value ranges from 1000 to 100000, with a default of 2000.
|
R_A_TOV
|
The resolution allocation time out value ranges from 5000 to 100000, with a default of 10000.
|
milliseconds
|
Number of milliseconds
|
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.
Examples
The following examples show how to change the default Fibre Channel timers.
switch(config)# fctimer e_d_tov ?
<1000-100000> E_D_TOV in milliseconds(1000-100000)
switch(config)# fctimer r_a_tov ?
<5000-100000> R_A_TOV in milliseconds(5000-100000)
Related Commands
Command
|
Description
|
show fctimer
|
Displays the configured Fibre Channel timer values.
|
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 value]}
Syntax Description
fcid
|
The FCID of the destination N port.
|
fcid
|
The port FCID, with the format 0xhhhhhh.
|
pwwn
|
The PWWN of the destination N port.
|
pwwn-id
|
The port WWN, with the format hh:hh:hh:hh:hh:hh:hh:hh.
|
vsan
|
Configures the VSAN ID of the destination N-port.
|
vsan-id
|
Specifies the VSAN ID of the destination N-port, which is from 1 to 4096.
|
timeout
|
Configures the timeout value.
|
value
|
Specifies the timeout value, which is from 1 to 10 seconds.
|
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 1
Route present for : 0x660000
20:00:00:05:30:00:5f:1e(0xfffc65)
20:00:00:05:30:00:61:5e(0xfffc66)
20:00:00:05:30:00:61:5e(0xfffc66)
find
To display a list of files on a file system, use the find command in EXEC mode.
find filename
Syntax Description
filename
|
Filenames with the specified characteristics.
|
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
Related Commands
Command
|
Description
|
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
This command has no arguments or keywords.
Defaults
None.
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 erases all information on a module's bootflash.
switch# format bootflash:
fspf config
To configure an FSPF feature for the entire VSAN, and to enable or disable FSPF, use the fspf config command in configuration mode. To delete FSPF configuration for the entire VSAN, and to enable or disable FSPF routing protocols, use the no form of the command.
fspf config vsan vsan-id | enable vsan vsan-id
no fspf config vsan vsan-id | enable vsan vsan-id
Syntax Descriptionfcdomainfcdomainfcdomainfcdomain
vsan vsan-id
|
Enters FSPF global configuration mode for the specified VSAN or range of VSANs. If no VSAN ID is specified, the default VSAN is selected.
|
fspfenable vsan
|
Enables FSPF on the entire VSAN.
|
vsan-id
|
The ID of the VSAN is from 1 to 4093.
|
region
|
Defines the autonomous region to which the switch belongs.
|
region-id
|
Specifies the autonomous region to which the switch belongs. The backbone region has region-id=0. The parameter region-id is an unsigned integer value ranging from 0 to 255.
|
spf hold-time
|
Configures the time between two consecutive SPF computations. If the time is small then routing will react faster to changes but CPU usage will be more.
|
spf-holdtime
|
Specifies the time between two consecutive SPF computations. The parameter spf-holdtime is an integer (0-65535) specifying time in milliseconds.
|
min-ls-arrival
|
Configures the minimum time before a new link state update for a domain will be accepted by switch.
|
ls-arrival-time
|
Specifies the minimum time before a new link state update for a domain will be accepted by switch. The parameter ls-arrival-time is an integer (0-65535) specifying time in milliseconds.
|
min-ls-interval
|
Configures the minimum time before a new link state update for a domain will be generated by the switch.
|
ls-interval-time
|
Specifies the minimum time before a new link state update for a domain will be generated by the switch. The parameter ls-interval-time is an integer (0-65535) specifying time in milliseconds.
|
Defaults
In Configuration mode, the default is enabled.
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)# fspf config vsan 1
switch-config-(fspf-config)#
switch-config-(fspf-config)# exit
switch(config)# no fspf config vsan 3
switch(config)# no fspf enable vsan 5
switch(config)# fspf enable vsan 7
Related Commands
Command
|
Description
|
show fspf interface
|
Displays information for each selected interface.
|
fspf enable
|
Enables FSPF routing protocol in the specified VSAN (from the switch(config-if)# prompt).
|
fspf cost
|
Configures the cost for the selected interface in the specified VSAN (from the switch(config-if)# prompt).
|
fspf hello-interval
|
Specifies the hello message interval to verify the health of a link in the VSAN (from the switch(config-if)# prompt).
|
fspf passive
|
Disables the FSPF protocol for the specified interface in the specified VSAN (from the switch(config-if)# prompt).
|
fspf retrasmit
|
Specifies the retransmit time interval for unacknowledged link state updates in specified VSAN (from the switch(config-if)# prompt).
|
fspf cost
To configure FSPF link cost for the entire VSAN, use the fspf cost command. To delete this configuration, or negate this feature, use the no form of the command.
fspf cost link_cost vsan vsan-id
no fspf cost link_cost vsan vsan-id
Syntax Description
fspf
|
Configures FSPF parameters.
|
cost
|
Configures FSPF link cost.
|
link-cost
|
Enters FSPF link cost from 1 to 65535.
|
vsan vsan-id
|
Enters FSPF global configuration mode for the specified VSAN or range of VSANs from 1 to 4096. If no VSAN ID is specified, the default VSAN is selected.
|
Defaults
Enabled.
Command Modes
Configuration mode
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.
Examples
switch(config)# interface fcip 1
switch(config-if)# fspf cost 5000 vsan 1
Related Commands
Command
|
Description
|
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 delete this configuration, or negate this feature, use the no form of the command.
fspf dead-interval seconds vsan vsan-id
no fspf dead-interval seconds vsan vsan-id
Syntax Description
fspf
|
Configures FSPF parameters.
|
dead-interval
|
Configures FSPF dead interval.
|
seconds
|
Specifies interval in seconds from 2 to 65535.
|
vsan vsan-id
|
Enters FSPF global configuration mode for the specified VSAN or range of VSANs from 1 to 4096. If no VSAN ID is specified, the default VSAN is selected.
|
Defaults
Enabled.
Command Modes
Configuration mode
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.
Examples
switch(config)# interface fcip 1
switch(config-if)# fspf dead-interval 4000 vsan 1
Related Commands
Command
|
Description
|
show fspf interface
|
Displays information for each selected interface.
|
show interface fcip
|
Displays an interface configuration for a specified FCIP interface.
|
fspf hello-interval
To verify the health of the link, use the fspf hello-interval command. To delete this configuration, or negate this feature, use the no form of the command.
fspf hello-interval seconds vsan vsan-id
no fspf hello-interval seconds vsan vsan-id
Syntax Description
fspf
|
Configures FSPF parameters.
|
hello-interval
|
Configures FSPF hello-interval.
|
seconds
|
Specifies interval in seconds from 2 to 65535.
|
vsan vsan-id
|
Enters FSPF global configuration mode for the specified VSAN or range of VSANs from 1 to 4096. If no VSAN ID is specified, the default VSAN is selected.
|
Defaults
Enabled.
Command Modes
Configuration mode
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.
Examples
switch(config)# interface fcip 1
switch(config-if)# fspf hello-interval 3 vsan 1
Related Commands
Command
|
Description
|
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 delete this configuration, or negate this feature, use the no form of the command.
fspf passive vsan vsan-id
no fspf passive vsan vsan-id
Syntax Description
fspf
|
Configures FSPF parameters.
|
passive
|
Enables or disables FSPF on the interface.
|
vsan vsan-id
|
Enters FSPF global configuration mode for the specified VSAN or range of VSANs from 1 to 4096. If no VSAN ID is specified, the default VSAN is selected.
|
Defaults
Enabled.
Command Modes
Configuration mode
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.
Examples
switch(config)# interface fcip 1
switch(config-if)# fspf passive vsan 1
Related Commands
Command
|
Description
|
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 delete this configuration, or negate this feature, use the no form of the command.
fspf retransmit-interval seconds vsan vsan-id
no spf retransmit-interval seconds vsan vsan-id
Syntax Description
fspf
|
Configures FSPF parameters.
|
retransmit-interval
|
Configures FSPF retransmit interface from 1 to 65535.
|
seconds
|
Specifies interval in seconds from 2 to 65535.
|
vsan vsan-id
|
Enters FSPF global configuration mode for the specified VSAN or range of VSANs from 1 to 4096. If no VSAN ID is specified, the default VSAN is selected.
|
Defaults
Enabled.
Command Modes
Configuration mode
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.
Examples
switch(config)# interface fcip 1
switch(config-if)# fspf retransmit-interval 6 vsan 1
Related Commands
Command
|
Description
|
show fspf interface
|
Displays information for each selected interface.
|
show interface fcip
|
Displays an interface configuration for a specified FCIP interface.
|