-
Cisco MDS 9000 Family Command Reference, Release 3.x
-
New and Changed Information
-
Preface
-
CLI Overview
-
A Commands
-
Advanced Services Modules Commands
-
B Commands
-
C Commands
-
Caching Services Module Commands
-
D Commands
-
Debug Commands
-
E Commands
-
F Commands
-
G Commands
-
H Commands
-
I Commands
-
J 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
-
Feedback
Table Of Contents
fcns reject-duplicate-pwwn vsan
ficon logical-port assign port-numbers
ficon port default-state prohibit-all
ficon slot assign port-numbers
ficon vsan (configuration mode)
flex-attach virtual-pwwn interface
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 "About the CLI Command Modes" section on page 1-3 to determine the appropriate mode for each command. For more information, refer to the Cisco MDS 9000 Family CLI Configuration Guide.
fabric
To add a fabric to the cluster, use the fabric command in the Cisco SME cluster configuration submode.
fabric fabric name
Syntax Description
Defaults
None.
Command Modes
Cisco SME cluster configuration submode.
Command History
Usage Guidelines
None.
Examples
The following example adds a fabric named sw-xyz to a cluster:
switch# config terminalswitch(config)# sme cluster c1switch(config-sme-cl)# fabric sw-xyzRelated Commands
fabric-binding activate
To activate fabric binding in a VSAN, use the fabric-binding activate command in configuration mode. To disable this feature, use the no form of the command.
fabric-binding activate vsan vsan-id [force]
no fabric-binding activate vsan vsan-id
Syntax Description
vsan vsan-id
Specifies the VSAN. The ID of the VSAN is from 1 to 4093.
force
Forces fabric binding activation.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
1.3(1)
This command was introduced.
3.0(1)
Extended support for fabric binding to Fibre Channel VSANs.
Usage Guidelines
Fabric binding is configured on a per-VSAN basis and can be implemented in both FICON VSANs and Fibre Channel VSANs.
Examples
The following example activates the fabric binding database for the specified VSAN:
switch# config terminalswitch(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
1.3(1)
This command was introduced.
3.0(1)
Extended support for fabric binding to Fibre Channel VSANs.
Usage Guidelines
Fabric binding is configured on a per-VSAN basis and can be implemented in both FICON VSANs and Fibre Channel 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 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
1.3(1)
This command was introduced.
3.0(1)
Extended support of fabric binding to Fibre Channel VSANs.
Usage Guidelines
Fabric binding is configured on a per-VSAN basis and can be implemented in both FICON VSANs and Fibre Channel 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 VSAN, use the fabric-binding database vsan command in configuration mode. To disable an FC alias, use the no form of the 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
1.3(1)
This command was introduced.
3.0(1)
Extended support of fabric binding to Fibre Channel VSANs.
Usage Guidelines
Fabric binding is configured on a per-VSAN basis and can be implemented in both both FICON VSANs and Fibre Channel VSANs.
In a FICON VSAN, the fabric binding feature requires all sWWNs connected to a switch and their persistent domain IDs to be part of the fabric binding active database. In a Fibre Channel VSAN, only the sWWN is required; the domain ID is optional.
A user-specified fabric binding list contains a list of switch WWNs (sWWNs) within a fabric. If an sWWN attempts to join the fabric, and that sWWN is not on the list or the sWWN is using a domain ID that differs from the one specified in the allowed list, the ISL between the switch and the fabric is automatically isolated in that VSAN and the switch is denied entry into the fabric.
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.
Note
All switches in a non-FICON VSAN must be running Cisco MDS SAN-OS Release 3.x or later.
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 terminalswitch(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 terminalswitch(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 terminalswitch(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 VSAN, use the fabric-binding enable command. To disable fabric binding, use the no form of the 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
1.3(1)
This command was introduced.
3.0(1)
Extended support of fabric binding to Fibre Channel VSANs.
Usage Guidelines
Fabric binding is configured on a per-VSAN basis and can be implemented in both both FICON VSANs and Fibre Channel 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.
fabric-membership
To configure a node to a fabric, use the fabric-membership command. To remove the node from the fabric, use the no form of the command,
fabric-membership fabric name
no fabric-membership fabric name
Syntax Description
Defaults
None.
Command Modes
Cisco SME cluster node configuration submode.
Command History
Usage Guidelines
Use the fabric-membership command to put a node in a fabric.
This command has to be configured before the interface sme slot/port [force] can be accepted. It also cannot be removed if the interface sme slot/port [force] command is enabled.Examples
The following example specifies a fabric to which the node belongs :
switch# config tswitch(config)# sme cluster clustername1switch(config-sme-cl)# node localswitch(config-sme-cl-node)# fabric-membership f1Related Commands
interface sme slot/port [force]
Configures the Cisco SME interface to a cluster.
shutdown
Enables or disables an interface.
show interface sme
Displays interface information.
fcalias clone
To clone a Fibre Channel alias, use the fcalias clone command.
fcalias clone origFcalias-Name cloneFcalias-Name vsan vsan-id
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
To disable an FC alias, use the no form of the fcalias name command.
Examples
The following examples show how to clone a fcalias named origAlias to cloneAlias on VSAN 45.
switch# config terminalEnter configuration commands, one per line. End with CNTL/Z.switch(config)# fcalias clone origAlias cloneAlias vsan 45Related Commands
show fcalias
Displays the member name information in a Fibre Channel alias (fcalias).
fcalias name
To configure an FC alias, use the fcalias name command. To disable an FC alias, use the no form of the 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
Usage Guidelines
To include multiple members in any alias, use the FCID, fWWN, or pWWN values.
Examples
The following examples show how to configure an fcalias called AliasSample on VSAN 3.
switch# config terminalswitch(config)# fcalias name AliasSample vsan 3switch(config-fcalias)#Related Commands
member (fcalias configuration mode)
Configures alias member for a specified zone.
fcalias rename
To rename a Fibre Channel alias (fcalias), use the fcalias rename command.
fcalias rename current-name new-name vsan vsan-id
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example shows how to rename an fcalias.
switch# config terminalswitch(config)# fcalias rename oldalias newalias vsan 10Related Commands
fcalias name
Configures fcalias names.
show fcalias
Displays fcalias information.
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
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 terminalswitch(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 eth2switch(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
Usage Guidelines
This command is not supported on the Cisco MDS 9124 switch, the Cisco Fabric Switch for HP c-Class BladeSystem, and the Cisco Fabric Switch for IBM BladeCenter.
Examples
The following example shows how to enable FCC.
switch# config terminalswitch(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
Usage Guidelines
FCC reduces the congestion in the traffic without interfering with standard Fibre Channel protocol.
Note
Examples
The following example shows how to configure the FCC priority threshold as 2.
switch# config terminalswitch(config)# fcc priority 2Related Commands
fcdomain
To configure the Fibre Channel domain feature, use the fcdomain command. To disable the FC domain, use the no form of the command.
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} |
optimize fast-restart 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 persistent vsan vsan-id |
optimize fast-restart vsan vsan-id |
priority value 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 was deprecated.
3.0(2)
Added the optimize fast-restart option.
Usage Guidelines
You can use this command to select the principal switch, configure domain ID distribution, reconfigure the fabric, and allocate FC IDs.
We recommend using the optimize fast-restart option on most fabrics, especially those with a large number of logical ports (3200 or more), where a logical port is an instance of a physical port in a VSAN.
Examples
The following examples show how to configure the Fibre Channel domain feature.
switch# config terminalswitch(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 optimize fast-restart vsan 3switch(config)# fcdomain optimize fast-restart vsan 7 - 10switch(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 abort vsan
To flush cached data without committing and release the lock, use the fcdomain abort vsan command.
fcdomain abort vsan vsan-id |
Syntax Description
Defaults
Enabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following examples show how to flush cached data.
switch# config terminalswitch(config)# fcdomain abort vsan 10Related Commands
fcdomain commit vsan
To commit cached data and release the lock, use the fcdomain commit vsan command.
fcdomain commit vsan vsan-id |
Syntax Description
Defaults
Enabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following examples show how to commit cached data.
switch# config terminalswitch(config)# fcdomain commit vsan 10Related Commands
fcdomain distribute
To enable fabric distribution using Cisco Fabric Services (CFS), use the fcdomain distribute command. To disable fabric distribution using CFS, us the no form of the command.
fcdomain distribute
no fcdomain distribute
Syntax Description
This command has no arguments or keywords
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example enables fabric distribution using CFS.
switch# config terminalswitch(config)# fcdomain distributeThe following example disables fabric distribution using CFS.
switch(config)# no fcdomain distributeRelated Commands
fcdomain
Configures Fibre Channel domain features.
show fcdomain
Displays global information about the FC domain configurations.
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.
Command History
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 terminalswitch(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 the 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
Usage Guidelines
None.
Examples
The following example shows how to configure the network latency to 5000 milliseconds.
switch# config terminalswitch(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 the 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
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-allocation
Use the fcid-allocation command to manually add a FCID to the default area company ID list. Use the no form of the command to remove a FCID from the default area company ID list.
fcid-allocation area company-id company-id
no fcid-allocation area company-id company-id
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
Fibre Channel standards require a unique FCID to be allocated to an N port attached to a Fx port in any switch. To conserve the number of FCIDs used, Cisco MDS 9000 Family switches use a special allocation scheme.
Some HBAs do not discover targets that have FCIDs with the same domain and area. Prior to Cisco MDS SAN-OS Release 2.0, the Cisco MDS SAN-OS software maintained a list of tested company ID (also know as Organizational Unit Identifier, or OUI) which do not exhibit this behavior. These Host Bus Adapters (HBAs) were allocated with single FCIDs, and for others a full area was allocated.
The FCID allocation scheme available in Release 1.3 and earlier, allocates a full area to these HBAs. This allocation isolates them to that area and are listed with their pWWN during a fabric login. The allocated FCIDs are cached persistently and are still available in Cisco MDS SAN-OS Release 2.0 (see the "FCID Allocation for HBAs" section on page 38-22).
As of Cisco MDS SAN-OS Release 2.0, to allow further scalability for switches with numerous ports, the Cisco MDS SAN-OS software is maintaining a list of HBAs exhibiting this behavior. Each HBA is identified by its company ID used in the pWWN during a fabric log in. Hence a full area is allocated to the N ports with company IDs that are listed and for the others, a single FCID is allocated. Irrespective of the kind (whole area or single) of FCID allocated, the FCID entries remain persistent.
Examples
The following example adds a new company ID to the default area company ID list.
switch# config terminalswitch(config)# fcid-allocation area company-id 0x003223Related Commands
fcid-last-byte
Use the fcid-last-byte command to allocate the last byte FCID 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
None.
Command Modes
FICON configuration submode.
Command History
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 FCID for the fabric address.
switch# config terminalswitch(config)# ficon vsan 2switch(config-ficon)# fcid-last-byte 12The following example removes the configured last byte FCID for the fabric address and reverts to the default.
switch# config terminalswitch(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 FCIDs on the switch, use the fcinterop fcid-allocation command in configuration mode. To disable FCIDs 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
Usage Guidelines
This command defines how the switch assigns FCIDs.
Examples
switch# config terminalswitch(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 the 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
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 terminalswitch(config)# fcinterop loop-monitorThe following example shows how to disable monitoring of NL ports in a loop.
switch# config terminalswitch(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
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.
Note
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
Usage Guidelines
When you perform this command, the CLI enters FCIP profile configuration mode.
Note
Examples
The following example shows how to configure an FCIP profile.
switch## config terminalswitch(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
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 configuring a proxy port for VSAN 2.
switch# config terminalswitch(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.
fcns reject-duplicate-pwwn vsan
To reject duplicate Fibre Channel name server (FCNS) proxies on a VSAN, use the fcns reject-duplicate-pwwn vsan command in configuration mode.
fcns reject-duplicate-pwwn vsan vsan-id
no fcns reject-duplicate-pwwn vsan vsan-id
Syntax Description
Defaults
Enabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example rejects duplicate FCNS pWWNs for VSAN 2.
switch# config terminalswitch(config)# fcns reject-duplicate-pwwn 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 FCID, use the fcping fcid command in EXEC mode.
fcping {device-alias aliasname | fcid {fc-port | domain-controller-id} | pwwn pwwn-id} vsan vsan-id [count number [timeout value [usr-priority priority]]]
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
1.0(2)
This command was introduced.
1.2(1)
Allowed the domain controller ID as an FCID.
2.0(x)
Added the device-alias aliasname option.
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 usecThe following example displays fcping operation for the device alias of the specified destination.
switch# fcping device-alias x vsan 128 bytes from 21:01:00:e0:8b:2e:80:93 time = 358 usec28 bytes from 21:01:00:e0:8b:2e:80:93 time = 226 usec28 bytes from 21:01:00:e0:8b:2e:80:93 time = 372 usecfc-redirect version2 enable
To enable the version2 mode in FC-Redirect, use the fc-redirect version2 enable command in configuration mode.
fc-redirect version2 enable
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
This command is used to increase scalability of FC-Redirect.
Disabling version2 mode after it is enabled in the fabric is not recommended. However, if you want to disable version2 mode, you cannot disable it until all FC-Redirect configurations are deleted. FC-Redirect configurations can be deleted only by deleting all corresponding application configurations.
The SAN-OS 3.2.x switches cannot be added to the fabric after the version2 mode is enabled. If the switches are added, all further FC-Redirect configuration changes will fail across the fabric. This could lead to traffic disruption for applications such as SME and DMM.
Use the show fc-redirect configs command to see the list of applications that create FC-Redirect configurations.
If version2 mode is enabled in the fabric and you want to move a switch to a different fabric, use the clear fc-redirect decommission-switch command before moving the switch to a different fabric. If not, all switches in the new fabric will be converted to version2 mode automatically.
Note
Examples
The following example shows how to enable version2 mode in FC-Redirect.
switch# fc-redirect version2 enablePlease make sure to read and understand the following implicationsbefore proceeding further:1) This is a Fabric wide configuration. All the switches in thefabric will be configured in Version2 mode.Any new switchesadded to the fabric will automatically be configured in version2mode.2) SanOS 3.2.x switches CANNOT be added to the Fabric after Version2mode is enabled. If any 3.2.x switch is added when Version2 modeis enabled, all further FC-Redirect Configuration changes will Failacross the fabric. This could lead to traffic disruption forapplications like SME.3) If enabled, Version2 mode CANNOT be disabled till all FC-Redirectconfigurations are deleted. FC-Redirect configurations can bedeleted ONLY after all the relevant application configurationsare deleted. Please use the command 'show fc-redirect configs'to see the list of applications that created FC-Redirectconfigurations.4) 'write erase' will NOT disable this command. After 'write erase'on ANY switch in the fabric, the user needs to do:'clear fc-redirect decommission-switch'on that that switch. Without that, if the user moves the switchto a different fabric it will try to convert all the switchesin the fabric to Version2 mode automatically. This might leadto Error conditions and hence Traffic disruption.Do you want to continue? (Yes/No) [No]YesBefore proceeding further, please check the following:1) All the switches in the fabric are seen in the output of'show fc-redirect peer-switches' command and are in 'UP' state.2) All switches in the fabric are running SanOS version 3.3.x orhigher.3) Please make sure the Fabric is stable ie.,No fabric changes/upgrades in progressDo you want to continue? (Yes/No) [No] YesRelated Commands=
fcroute
To configure Fibre Channel routes and to activate policy routing, use the fcroute command. To remove a configuration or revert to factory defaults, use the no form of the command.
fcroute {fcid network-mask interface {fc slot/port | port-channel port} domain domain-id {metric number | remote | vsan vsan-id} | policy fcroute-map vsan vsan-id [route-map-identifier]}
no fcroute {fcid network-mask interface {fc slot/port | port-channel port} domain domain-id {metric number | remote | vsan vsan-id} | policy fcroute-map vsan vsan-id [route-map-identifier]}
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
Use this command to assign forwarding information to the switch and to activate a preferred path route map.
Examples
The following example specifies the Fibre Channel interface and the route for the domain of the next hop switch for VSAN 2.
switch# config terminalswitch(config)# fcroute 0x111211 interface fc1/1 domain 3 vsan 2The following example removes this configuration.
switch(config)# no fcroute 0x111211 interface fc1/1 domain 3 vsan 2The following example specifies the PortChannel interface and the route for the domain of the next hop switch for VSAN 4.
switch# config terminalswitch(config)# fcroute 0x111211 interface port-channel 1 domain 3 vsan 4The following example removes this configuration.
switch(config)# no fcroute 0x111211 interface port-channel 1 domain 3 vsan 4The following example specifies the Fibre Channel interface, the route for the domain of the next hop switch, and the cost of the route for VSAN 1.
switch# config terminalswitch(config)# fcroute 0x031211 interface fc1/1 domain 3 metric 1 vsan 1The following example removes this configuration.
switch(config)# no fcroute 0x031211 interface fc1/1 domain 3 metric 1 vsan 1The following example specifies the Fibre Channel interface, the route for the domain of the next hop switch, the cost of the route, and configures the static route for a destination switch remotely connected for VSAN 3.
switch# config terminalswitch(config)# fcroute 0x111112 interface fc1/1 domain 3 metric 3 remote vsan 3The following example removes this configuration.
switch(config)# no fcroute 0x111112 interface fc1/1 domain 3 metric 3 remote vsan 3Related Commands
fcrxbbcredit extended enable
To enable Fibre Channel extended buffer-to-buffer credits (BB_credits), use the fcrxbbcredit extended enable command in configuration mode. To disable the feature, use the no form of the command.
fcrxbbcredit extended enable
no fcrxbbcredit extended enable
Syntax Description
This command has no other arguments or keywords.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
Performing the fcrxbbcredit extended enable command enables the switchport fcrxbbcredit extended command.
Note
Examples
The following example shows how to enable Fibre Channel extended BB_credits.
switch# config terminalswitch(config)# fcrxbbcredit extended enableThe following example shows how to disable Fibre Channel extended BB_credits.
switch# config terminalswitch(config)# no fcrxbbcredit extended enableRelated Commands
switchport fcrxbbcredit extended
Configures Fibre Channel extended BB_credits on an interface.
show interface
Displays interface information and status.
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
Usage Guidelines
None.
Examples
switch# config terminalswitch(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
Usage Guidelines
None.
Examples
The following example shows how to register FCS attributes.
switch# config terminalswitch(config)# fcs registerswitch(config-fcs-register)# platform Platform1 vsan 10Related Commands
fcs virtual-device-add
To include a virtual device in a query about zone information from an FCS, use the fcs virtual-device-add command in configuration mode. To remove a virtual device, use the no form of the command.
fcs virtual-device-add [vsan-ranges vsan-ids]
no fcs virtual-device-add [vsan-ranges vsan-ids]
Syntax Description
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
VSAN ranges are entered as vsan-ids-vsan-ids. When you specify more than one range, separate each range with a comma. If no range is specified, the command applies to all VSANs.
Examples
The following example shows how to add to one range of VSANs.
switch# config tEnter configuration commands, one per line. End with CNTL/Z.switch(config)# fcs virtual-device-add vsan-ranges 2-4The following example shows how to add to more than one range of VSANs.
switch# config tEnter configuration commands, one per line. End with CNTL/Z.switch(config)# fcs virtual-device-add vsan-ranges 2-4,5-8Related Commands
fcsp
To configure an Fibre Channel Security Protocol (FC-SP) authentication mode for a specific interface in a FC-SP-enabled switch, use the fcsp command. To disable an FC-SP on the interface, use the no form of the command.
fcsp {auto-active | auto-passive | on | off} [timeout-period]
no fcsp
Syntax Description
Defaults
Auto-passive.
Command Modes
Configuration mode.
Command History
Usage Guidelines
To use this command, FC-SP must be enabled using the fcsp enable command.
Examples
The following example turns on the authentication mode for ports 1 to 3 in Fibre Channel interface 2.
switch# config terminalEnter configuration commands, one per line. End with CNTL/Z.switch(config)# interface fc 2/1 - 3switch(config-if)# fcsp onswitch(config-if)#The following example reverts to the factory default of auto-passive for these three interfaces.
switch(config-if)# no fcspThe following example changes these three interfaces to initiate FC-SP authentication, but does not permit reaunthentication.
switch(config-if)# fcsp auto-active 0The following example changes these three interfaces to initiate FC-SP authentication and permits reaunthentication within two hours (120 minutes) of the initial authentication attempt.
switch(config-if)# fcsp auto-active 120Related Commands
fcsp enable
Enable FC-SP.
show interface
Displays an interface configuration for a specified interface.
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
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 terminalswitch(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 the command.
fcsp enable
no fcsp enable
Syntax Descriptionf
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example enables FC-SP.
switch# config terminalswitch(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
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 terminalswitch(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
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 terminalswitch(config)# fctimer e_d_tov 5000switch(config)# fctimer r_a_tov 7000Related Commands
fctimer abort
To discard a Fibre Channel timer (fctimer) Cisco Fabric Services (CFS) distribution session in progress, use the fctimer abort command in configuration mode.
fctimer abort
Syntax Description
This command has no other arguments or keywords.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example shows how to discard a CFS distribution session in progress.
switch# config terminalswitch(config)# fctimer abortRelated Commands
fctimer distribute
Enables CFS distribution for fctimer.
show fctimer
Displays fctimer information.
fctimer commit
To apply the pending configuration pertaining to the Fibre Channel timer (fctimer) Cisco Fabric Services (CFS) distribution session in progress in the fabric, use the fctimer commit command in configuration mode.
fctimer commit
Syntax Description
This command has no other arguments or keywords.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
None.
Examples
The following example shows how to commit changes to the active Fibre Channel timer configuration.
switch# config terminalswitch(config)# fctimer commitRelated Commands
fctimer distribute
Enables CFS distribution for fctimer.
show fctimer
Displays fctimer information.
fctimer distribute
To enable Cisco Fabric Services (CFS) distribution for Fibre Channel timer (fctimer), use the fctimer distribute command. To disable this feature, use the no form of the command.
fctimer distribute
no fctimer distribute
Syntax Description
This command has no other arguments or keywords.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
Before distributing the Fibre Channel timer changes to the fabric, the temporary changes to the configuration must be committed to the active configuration using the fctimer commit command.
Examples
The following example shows how to change the default Fibre Channel timers.
switch# config terminalswitch(config)# fctimer distributeRelated Commands
fctimer commit
Commits the Fibre Channel timer configuration changes to the active configuration.
show fctimer
Displays fctimer information.
fctrace
To trace the route to an N port, use the fctrace command in EXEC mode.
fctrace {device-alias aliasname | 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
1.0(2)
This command was introduced.
2.0(x)
Added the device-alias aliasname option.
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)The following example traces a route to the specified device alias in VSAN 1.
switch# fctrace device-alias x vsan 1Route present for : 21:01:00:e0:8b:2e:80:9320:00:00:05:30:00:4a:e2(0xfffc67)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
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.
Note
Examples
The following example enables the FC tunnel feature.
switch# config terminalswitchS(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 terminalswitchS(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 enable
To enable the FICON feature on a switch, use the ficon enable command in configuration mode. To disable the feature or to revert to factory defaults, use the no form of the command.
ficon enable
no ficon enable
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
The effects of enabling the FICON feature in a Cisco MDS switch are as follows:
•
•
•
•
When FICON is enabled on a VSAN, it is implicitly enabled everywhere. However, when FICON is disabled on a VSAN, it remains globally enabled. You must explicitly disable FICON to disable it throughout the fabric.
Note
Examples
The following example enables FICON on the switch.
switch(config)# ficon enableThe following example disables FICON on the switch.
switch(config)# no ficon enableRelated Commands
ficon logical-port assign port-numbers
To reserve FICON port numbers for logical interfaces on the switch, use the ficon logical-port assign port-numbers command in configuration mode. To release the port numbers, use the no form of the command.
ficon logical-port assign port-numbers [port-numbers]
no ficon logical-port assign port-numbers [port-numbers]
Syntax Description
port-numbers
Specifies the range of port numbers to assign. The range can be 0 through 153 or 0x0 through 0x99.
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
You must reserve port numbers for logical interfaces, such as FCIP and PortChannels, if you plan to use them.
You cannot change or release port numbers for interfaces that are active. You must disable the interfaces using the shutdown command.
Note
Examples
The following example reserves port numbers 230 through 249 for FCIP and PortChannel interfaces.
switch(config)# ficon logical-port assign port-numbers 230-249The following example reserves port numbers 0xe6 through 0xf9 for FCIP and PortChannel interfaces.
switch(config)# ficon logical-port assign port-numbers 0xe6-0xf9The following example releases the port numbers.
switch(config)# no ficon logical-port assign port-numbers 230-249Related Commands
ficon port default-state prohibit-all
To set the FICON port default state to prohibit all, use the ficon port default-state prohibit-all command in configuration mode. To disable the feature or to revert to factory defaults, use the no form of the command.
ficon port default-state prohibit-all
no ficon port default-state prohibit-all
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
Usage Guidelines
You can change the default port prohibiting state to enabled in VSANs that you create and then selectively disable port prohibiting on implmeneted ports, if desired. Only the FICON configuration files created after you change the default have the new default setting.
Note
Examples
The following example enables port prohibiting as the default for all implemented interfaces on the switch.
switch(config)# ficon port default-state prohibit-allThe following example disables port prohibiting as the default for all implemented interfaces on the switch.
switch(config)# no port default-state prohibit-allRelated Commands
ficon slot assign port-numbers
To reserve FICON port numbers for a slot on the switch, use the ficon slot assign port-numbers command in configuration mode. To release the port numbers, use the no form of the command.
ficon slot slot assign port-numbers [port-numbers]
no ficon slot slot assign port-numbers [port-numbers]
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
Usage Guidelines
A range of 255 port numbers are available for you to assign to all the ports on a switch. You can have more than 255 physical ports on a switch and the excess ports do not have ports numbers in the default numbering scheme. When you have more than 255 physical ports on your switch, you can assign unimplemented port numbers to the ports, or assign duplicate port numbers if they are not used in the same FICON VSAN. For example, you can configure port number 1 on interface fc1/1 in FICON VSAN 10 and fc10/1 in FICON VSAN 20.
FICON port numbers are not changed for ports that are active. You must first disable the interfaces using
the shutdown command.
You can configure port numbers even when no module is installed in the slot, and before FICON is enabled on any VSAN.
For more information on assigning port numbers, refer to "FICON Port Numbering" in the Cisco MDS 9000 Family CLI Configuration Guide or the Cisco MDS 9000 Family Fabric Manager Configuration Guide.
Note
Examples
The following example reserves FICON port numbers 0 through 15 and 48 through 63 for up to 32 interfaces in slot 3.
swich# config terminalEnter configuration commands, one per line. End with CNTL/Z.switch(config)# ficon slot 3 assign port-numbers 0-15, 48-63The following example reserves FICON port numbers 0 through 15 for the first 16 interfaces and 0 through 15 for the second 32 interfaces in slot 3.
switch(config)# ficon slot 3 assign port-numbers 0-15, 0-15The following example changes the reserved FICON port numbers for up to 24 interfaces in slot 3.
switch(config)# ficon slot 3 assign port-numbers 0-15, 56-63The following example releases the port numbers.
switch(config)# no ficon slot 3 assign port-numbers 0-15, 56-63The following example shows the switch output when there are duplicate port numbers.
switch(config)switch(config)# no ficon slot 1 assign port-numbersswitch(config)# ficon slot 1 assign port-numbers 0-14, 0WARNING: fc1/16 and fc1/1 have duplicated port-number 0 in port VSAN 99Related Commands
ficon swap
To enable the FICON feature in a specified VSAN, use the ficon swap command in configuration mode.
ficon swap {interface fc slot fc slot | portnumber port-number port-number} [after swap noshut]
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
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 are automatically initialized.
The ficon swap interface old-interface new-interface command allows you to swap physical Fibre Channel ports, including port numbers, when there are duplicate port numbers on the switch.
If you specify the ficon swap interface old-interface new-interface after swap noshut command, the ports are automatically initialized.
Refer to the Cisco MDS 9000 Family CLI Configuration Guide for additional information.
Note
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 15The following example swaps port 1 with port 6.
switch# ficon swap interface fc1/1 fc1/6Related Commands
ficon-tape-accelerator vsan
To enable FICON tape acceleration for the FCIP interface, use the ficon-tape-accelerator vsan command in interface configuration submode. To disable FICON tape acceleration for the FCIP interface, use the no form of the command.
ficon-tape-accelerator vsan vsan-id
no ficon-tape-accelerator vsan vsan-id
Syntax Description
Defaults
Disabled.
Command Modes
Interface configuration submode.
Command History
Usage Guidelines
Cisco MDS SAN-OS software provides acceleration for FICON tape write operations over FCIP for the IBM VTS and tape libraries that support the 3490 command set. FICON tape read acceleration over FCIP is not supported.
FICON tape acceleration will not work if multiple inter-switch links (ISLs) are present in the VSAN.
FICON write acceleration and tape acceleration can be enabled at the same time on the FCIP interface.
Note
Examples
The following example enables FICON tape acceleration on the FCIP interface.
switch# config terminalswitch(config)# interface fcip 2switch(config-if)# ficon-tape-accelerator vsan 100This configuration change will disrupt all traffic on the FCIP interface in allVSANs. Do you wish to continue? [no] yThe following example disables FICON tape acceleration on the FCIP interface.
switch(config-if)# no ficon-tape-accelerator vsan 100This configuration change will disrupt all traffic on the FCIP interface in allVSANs. Do you wish to continue? [no] yRelated Commands
write-accelerator
Enables write acceleration and tape acceleration for the FCIP interface.
show fcip
Displays FCIP profile information.
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
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.
Note
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
no ficon vsan vsan-id
Syntax Description
Defaults
None.
Command Modes
Configuration mode.
Command History
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.
Note
Examples
The following example enables FICON on VSAN 2.
switch(config)# ficon vsan 2The following example 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
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 terminalswitch(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
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.
flex-attach virtual-pwwn
To map the real port WWN (pWWN) and a user-specific virtual pWWN, use the flex-attach virtual-pwwn command. To disable the mapping, use the no form of the command.
flex-attach virtual-pwwn vpwwn pwwn pwwn
no flex-attach virtual-pwwn vpwwn pwwn pwwn
Syntax Description
vpwwn
Specifies the virtual pWWN chosen by the user.
pwwn pwwn
Specifies the pWWN to be mapped to the user-specific virtual pWWN.
Note
Defaults
None.
Command Modes
Configuration mode
Command History
Usage Guidelines
None.
Examples
The following example shows how to map the real pWWN and a user-specific virtual pWWN on an interface.
switch# configEnter configuration commands, one per line. End with CNTL/Z.switch# (config) flex-attach virtual-pwwn 20:04:00:a0:b8:16:92:18 pwwn 21:03:00:a0:b9:16:92:16Related Commands
flex-attach virtual-pwwn auto
Enables the FlexAttach virtual pWWN on a specific interface.
flex-attach virtual-pwwn interface
Sets the user-specific FlexAttach virtual pWWN.
flex-attach virtual-pwwn auto
To enable the FlexAttach virtual port WWN (pWWN) on a specific interface, use the flex-attach virtual-pwwn auto command. To disable the virtual pWWN, use the no form of the command.
flex-attach virtual-pwwn auto [interface auto interface-list]
no flex-attach virtual-pwwn auto [interface auto interface-list]
Syntax Description
Defaults
None.
Command Modes
Configuration mode
Command History
Usage Guidelines
The NPV switch assigns the virtual pWWNs to the interface on which FlexAttach is enabled.
Examples
The following example shows how to enable FlexAttach virtual pWWN on a interface.
switch# configEnter configuration commands, one per line. End with CNTL/Z.switch#(config)# flex-attach virtual-pwwn auto interface fc 1/1Related Commands
flex-attach virtual-pwwn interface
Sets the user-specific FlexAttach virtual pWWN.
flex-attach virtual-pwwn interface
To set the user-specific FlexAttach virtual port WWN (pWWN) on an interface, use the flex-attach virtual-pwwn interface command. To disable the virtual pWWN, use the no form of the command.
flex-attach virtual-pwwn vpwwn interface interface [vsan vsan]
no flex-attach virtual-pwwn vpwwn interface interface [vsan vsan]
Syntax Description
Defaults
None.
Command Modes
Configuration mode
Command History
Usage Guidelines
None.
Examples
The following example shows how to set the user-specific virtual pWWN on an interface.
switch# configEnter configuration commands, one per line. End with CNTL/Z.switch# (config) flex-attach virtual-pwwn 20:04:00:a0:b8:16:92:18 interface fc 1/1Related Commands
flex-attach virtual-pwwn auto
Enables the FlexAttach virtual pWWN on a specific interface.
format
To erase all the information on a module, use the format command in EXEC mode.
format {bootflash: | logflash: | slot0: | usb1: | usb2:}
Syntax Description
Defaults
None.
Command Modes
EXEC mode.
Command History
1.0(2)
This command was introduced.
3.3(1a)
Added the USB1 and USB 2 parameters.
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:This command is going to erase the contents of your bootflash:.Do you want to continue? (y/n) [n]The following example erases all information on the logflash memory.
switch# format logflash:This command is going to erase the contents of your logflash:.Do you want to continue? (y/n) [n]The following example erases all information on slot0. switch# format slot0:This command is going to erase the contents of your slot0:.Do you want to continue? (y/n) [n]
The following example erases all information on usb1:.switch# format usb1:This command is going to erase the contents of your usb1:.Do you want to continue? (y/n) [n]The following example erases all information on usb2:.
switch# format usb2:This command is going to erase the contents of your usb2:.Do you want to continue? (y/n) [n]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
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 terminalswitch(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. To revert 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
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.
Examples
The following example configures the FSPF link cost on an FCIP interface.
switch# config terminalswitch(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
Usage Guidelines
Access this command from the switch(config-if)# submode.
Note
Caution
Examples
The following example configures the maximum interval of 400 seconds for a hello message before the neighbor is considered lost.
switch# config terminalswitch(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
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 terminalswitch(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
Usage Guidelines
Access this command from the switch(config-if)# submode.
This command configures FSPF for the specified FCIP interface.
Note
Examples
The following example configures a hello interval of 3 seconds on VSAN 1.
switch# config terminalswitch(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
Usage Guidelines
Access this command from the switch(config-if)# submode.
By default, FSPF is enabled on all E ports and TE ports. FSPF can be disabled by setting the interface as passive using the fspf passive command.
Note
Examples
The following example disables the FSPF protocol for the selected interface on VSAN 1.
switch# config terminalswitch(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
Usage Guidelines
Access this command from the switch(config-if)# submode.
Note
Examples
The following example specifies a retransmit interval of 6 seconds after which an unacknowledged link state update should be transmitted on the interface for VSAN 1.
switch# config terminalswitch(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.
