- New and Changed Information
- Preface
- A Commands
- Advanced Services Modules Commands
- B Commands
- C Commands
- Caching Services Module Commands
- CLI Overview
- 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
- fabric
- fabric-binding activate
- fabric-binding database copy
- fabric-binding database diff
- fabric-binding database vsan
- fabric-binding enable
- fabric-membership
- fcalias clone
- fcalias name
- fcalias rename
- fcanalyzer local
- fcanalyzer remote
- filter
- fcc enable
- fc-management database
- fc-management enable
- fcc priority
- fcdomain
- fcdomain abort vsan
- fcdomain commit vsan
- fcdomain distribute
- fcdomain rcf-reject
- fcdroplatency
- fcflow stats
- fcid-allocation
- fcid-last-byte
- fcinterop fcid-allocation
- fcinterop loop-monitor
- fcip enable
- fcip profile
- fcns bulk-notify
- fcns no-bulk-notify
- fcns proxy-port
- fcns reject-duplicate-pwwn vsan
- fcping
- fc-redirect version2 enable
- fc-redirect ivr-support enable
- fcroute
- fcrxbbcredit extended enable
- fcs plat-check-global vsan
- fcs register
- fcs virtual-device-add
- fcsp
- fcsp dhchap devicename
- fcsp dhchap dhgroup
- fcsp dhchap hash
- fcsp dhchap password
- fcsp enable
- fcsp esp sa
- fcsp timeout
- fctimer
- fctimer abort
- fctimer commit
- fctimer distribute
- fctrace
- fc-tunnel
- feature
- ficon enable
- ficon logical-port assign port-numbers
- ficon port default-state prohibit-all
- ficon slot assign port-numbers
- ficon swap
- ficon-tape-read-accelerator
- ficon-tape-accelerator vsan
- ficon vsan (EXEC mode)
- ficon vsan (configuration mode)
- file
- find
- flex-attach virtual-pwwn
- flex-attach virtual-pwwn auto
- flex-attach virtual-pwwn interface
- flowgroup
- format
- fspf config vsan
- fspf cost
- fspf dead-interval
- fspf enable vsan
- 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 “About the CLI Command Modes” section to determine the appropriate mode for each command.
fabric
To add a fabric to the cluster, use the fabric command in the Cisco SME cluster configuration submode.
Syntax Description
Specifies the fabric name. The maximum length is 32 characters. |
Defaults
Command Modes
Cisco SME cluster configuration submode.
Command History
|
|
|
Usage Guidelines
Examples
The following example adds a fabric named sw-xyz to a cluster:
Related 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
Defaults
Command Modes
Command History
|
|
|
|---|---|
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:
The following example deactivates the fabric binding database for the specified VSAN:
The following example activates the fabric binding database for the specified VSAN forcefully, even if the configuration is not acceptable:
The following example reverts to the previously, configured state or to the factory default (if no state is configured):
Related Commands
|
|
|
|---|---|
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
Command Modes
Command History
|
|
|
|---|---|
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 configuration database in VSAN 1:
Related Commands
|
|
|
|---|---|
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
Command Modes
Command History
|
|
|
|---|---|
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:
The following example displays information on the differences between the configuration database and the active database:
Related Commands
|
|
|
|---|---|
Copies from the active to the configuration 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-id
no fabric-binding database vsan vsan-id swwn switch-wwn domain domain-id
Syntax Description
Specifies the specified domain ID. The domain ID is a number from 1 to 239. |
Defaults
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
Fabric binding is configured on a per-VSAN basis and can be implemented in 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:
The following example deletes a fabric binding database for the specified VSAN:
The following example deletes the sWWN and domain ID of a switch from the configured database list:
Related Commands
|
|
|
|---|---|
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.
Syntax Description
Defaults
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
Fabric binding is configured on a per-VSAN basis and can be implemented in both FICON VSANs and Fibre Channel VSANs.
The fabric binding feature must be enabled in each switch in the fabric that participates in the fabric binding.
Examples
The following example enables fabric binding on that switch:
The following example disables fabric binding on that switch:
Related Commands
|
|
|
|---|---|
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,
no fabric-membership fabric name
Syntax Description
Specifies the fabric name. The maximum length is 32 characters. |
Defaults
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:
Related Commands
|
|
|
|---|---|
fcalias clone
To clone a Fibre Channel alias, use the fcalias clone command.
fcalias clone origFcalias-Name cloneFcalias-Name vsan vsan-id
Syntax Description
Clones a Fibre Channel alias from the current name to a new name. Maximum length of names is 64 characters. |
|
Defaults
Command Modes
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:
Related Commands
|
|
|
|---|---|
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
Defaults
Command Modes
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:
Related Commands
|
|
|
|---|---|
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
Specifies the current fcalias name. The maximum length is 64. |
|
Defaults
Command Modes
Command History
|
|
|
Usage Guidelines
Examples
The following example shows how to rename an fcalias:
Related Commands
|
|
|
|---|---|
fcanalyzer local
To configure local Cisco Fabric Analyzer, use the fcanalyzer local command in EXEC mode.
fcanalyzer | ethanalyzer local [interface {inband | mgmt} [capture-filter expression] {[ brief ] [[display-filter expression] [[limit-captured- frames number] [[limit-frame-size bytes] [write uri2 ]]]]}|{[interface {inband | mgmt} [dump-pkt]]}]
Syntax Description
Defaults
Number of packets captured by default is changed from 100 to 10.
Command Modes
Command History
Usage Guidelines
You can capture Fibre Channel control traffic from a switch and decode it without disrupting connectivity and without having to be local to the point of analysis.
Note When you capture on inband interface packets from the supervisor to the line card module are captured and vice versa.
Note Multiword capture and display filter expressions need to be either single-quoted or double-quoted depending on what the expression itself contains.
Note To stop capture at any time press Ctrl+C.
Examples
The following example shows how to display only protocol summary on VSAN1:
The following example shows how to display a hex dump of packets:
The following example shows how to use a display filter on inband interface and display its summary:
The following example shows how to write captured packets in PCAP format and display captures on the screen:
The following example shows how to use capture filter on the mgmt interface and redirect the console output to a file:
Related Commands
|
|
|
|---|---|
fcanalyzer remote
To configure remote Cisco Fabric Analyzer, use the fcanalyzer remote command in configuration mode. To disable this command, use the no form of the command.
no fcanalyzer remote ip address [active [port-number]]
Syntax Description
(Optional) Enables active mode (passive is the default) with the remote host. |
|
Defaults
Command Modes
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 example shows how to configure remote Cisco Fabric analyzer:
Related Commands
|
|
|
|---|---|
filter
To specify the fields of the certificate map, use the filter command in configuration mode. The CA certificate or certificate chain is assumed to already be available in Privacy Enhanced Mail (PEM) (base-64) encoded format.
filter {altname-email email-id | altname-upn username | subject-name subject-name}
Syntax Description
Defaults
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
%username% substitutes the user’s login name.
%hostname% substitute the peer hostname.
Note Two maps currently can be configured for a given issuer name. The certificate will be filtered based on these two configured maps. If a default configuration is provided then the certificates are filtered against the default map in case if there is no map for that particular issuer name.
Examples
The following example shows how to configure an Email ID as an alternate name:
The following example shows how to configure the user principal as an alternate name:
The following example shows how to configure the subject name as an certificate:
Related Commands
|
|
|
|---|---|
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.
Syntax Description
Defaults
Command Modes
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:
The following example shows how to disable FCC:
Related Commands
|
|
|
|---|---|
fc-management database
To configure the Fibre Channel Common Transport (FC-CT) Management Security database, use the fc-management database command.
fc-management database vsan vsan-id
Syntax Description
Defaults
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
Examples
The following example shows how to configure the management security database:
Related Commands
|
|
|
|---|---|
fc-management enable
To enable the Fibre Channel Common Transport (FC-CT) Management Security, use the fc-management enable command. To disable this feature command, use the no form of the command.
Syntax Description
Defaults
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
Examples
The following example shows how to enable the FC-CT management security:
Related 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.
Syntax Description
The FCC priority threshold. The range is 0 to 7, where 0 is the lowest priority and 7 the highest priority. |
Defaults
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
FCC reduces the congestion in the traffic without interfering with the standard Fibre Channel protocol.
Note 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 configure the FCC priority threshold as 2:
Related 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 all vsan vsan-id | optimize fast-restart vsan vsan-id | optimize scale-restart vsan van-id | optimize selective-restart vsan vasn-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 all vsan vsan-id | optimize fast-restart vsan vsan-id | optimize scale-restart vsan van-id | optimize selective-restart vsan vasn-id | priority value vsan vsan-id | vsan vsan-id}
Syntax Description
Defaults
Command Modes
Command History
|
|
|
|---|---|
Added the optimize all and scale-restart keywords to the syntax description. |
|
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.
It is not recommended to use disruptive restart followed by VSAN suspend / no-suspend, since it is used only for recovery purpose when normal restart does not solve the problem.
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 optimize all vsan 3
switch(config)# fcdomain optimize all vsan 7 - 10
switch(config)# fcdomain optimize fast-restart vsan 3
switch(config)# fcdomain optimize fast-restart vsan 7 - 10
switch(config)# fcdomain optimize scale-restart vsan 3
switch(config)# fcdomain optimize scale-restart vsan 7 - 10
switch(config)# fcdomain optimize selective-restart vsan 3
switch(config)# fcdomain optimize selective-restart vsan 7 - 10
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
switch(config)# fcdomain allowed 50-110 vsan 4
switch(config)# no fcdomain allowed 50-110 vsan 5
Related Commands
|
|
|
|---|---|
Displays global information about the FC domain configurations. |
fcdomain abort vsan
To flush cached data without committing and to release the lock, use the fcdomain abort vsan command.
Syntax Description
Defaults
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
Examples
The following examples show how to flush cached data:
Related Commands
|
|
|
|---|---|
Displays global information about the FC domain configurations. |
fcdomain commit vsan
To commit cached data and release the lock, use the fcdomain commit vsan command.
Syntax Description
Defaults
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
Note After the FC domain commit is completed the running configuration has been modified on all switches participating in the FCd omain distribution. You can then use the copy running-config startup-config fabric command to save the running configuration to the startup configuration on all the switches in the fabric.
Examples
The following example shows how to commit cached data:
Related Commands
|
|
|
|---|---|
Flushes cached data without committing and releases the lock. |
|
Displays global information about the FC domain configurations. |
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.
Syntax Description
Defaults
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
Examples
The following example enables fabric distribution using CFS:
The following example disables fabric distribution using CFS:
Related Commands
|
|
|
|---|---|
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
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 example shows how to configure the FCIP RCF reject fcdomain feature:
Related Commands
|
|
|
|---|---|
Displays global information about the FC domain configurations. |
|
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
Specifies switch latency. The range is 0 to 60000 milliseconds. |
Defaults
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
Examples
The following example shows how to configure the network latency to 5000 milliseconds:
The following example shows how to revert to the default network latency:
The following example shows how to configure the switch latency to 4000 milliseconds:
The following example shows how to revert to the default switch latency:
Related Commands
|
|
|
|---|---|
fcflow stats
To configure FC flow 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
The mask for the source and destination FCID (restricted to 6 hexadecimal characters ranging from 0xff0000 to 0xffffff). |
Defaults
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
If you enable flow counters, you can enable a maximum of I K 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#
The following example enables the aggregated flow counter.
The following example disables the aggregated flow counter.
The following example enables the flow counter for module 1:
The following example disables the flow counter for module 1.
Related 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
Command Modes
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. 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:
Related 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.
no fcid-last-byte last-byte-id
Syntax Description
Defaults
Command Modes
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:
The following example removes the configured last byte FCID for the fabric address and reverts to the default:
Related Commands
|
|
|
|---|---|
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
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
Examples
The following example shows how to allocate FCIDs on the switch:
Related 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.
Syntax Description
Defaults
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
This command detects devices that are removed from a looped port:
Examples
The following example shows how to enable monitoring of NL ports in a loop:
The following example shows how to disable monitoring of NL ports in a loop:
Related Commands
|
|
|
|---|---|
Verifies 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 9000 Family, use the fcip enable command.
Syntax Description
Defaults
Command Modes
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 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 command enables the FCIP feature:
The following command disables the FCIP feature (default):
Related 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.
Syntax Description
Defaults
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
When you perform this command, the CLI enters FCIP profile configuration mode.
Note 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 configure an FCIP profile:
Related Commands
|
|
|
|---|---|
Configures the interface using an existing profile ID from 1 to 255. |
|
Displays an interface configuration for a specified FCIP interface. |
fcns bulk-notify
To enable transmission of multiple name server entry change notifications in one Messaging and Transaction Services (MTS) payload, use the fcns bulk-notify command. To disable bulk notify, use the no form of this command.
Syntax Description
Defaults
Bulk notification from the name server is disabled by default. For 6.2(9) and later releases, bulk notification from the name server is enabled by default.
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
Enabling the fcns bulk-notify command would improve the performance of the components like Zone, IVR, QOS, IPS.
Note Run the show fcns internal info global command to determine if the bulk notification is enabled.
Examples
The following example shows how to enable transmission of multiple name server entry change notifications in one MTS payload:
Related Commands
|
|
|
|---|---|
fcns no-bulk-notify
To disable transmission of multiple name server entry change notifications in one MTS payload, use the fcns no-bulk-notify command. To re-enable bulk notification once it is disabled, use the no form of this command.
Syntax Description
Defaults
Bulk notification from the name server is disabled by default. For 6.2(9) and later releases, bulk notification from the name server is enabled by default.
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
Examples
The following example shows how to disable transmission of multiple name server entry change notifications in one MTS payload:
The following example shows how to re-enable bulk notification once it has been disabled:
Related Commands
|
|
|
|---|---|
Available until Release 6.2(7) only. Enables transmission of multiple name server entry change notifications in one MTS payload. |
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
Specifies the port WWN, with the format hh : hh : hh : hh : hh : hh : hh : hh. |
|
Defaults
Command Modes
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 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:
Related Commands
|
|
|
|---|---|
Displays the name server database and statistical information for a specified VSAN or for all VSANs. |
fcns reject-duplicate-pwwn vsan
To reject the same pwwn from logging in the different switch, 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
Command Modes
Command History
|
|
|
Usage Guidelines
Examples
The following example rejects duplicate FCNS pWWNs for VSAN 2:
Related Commands
|
|
|
|---|---|
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
Command Modes
Command History
|
|
|
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.
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.
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.
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.
The following example displays fcping operation for the device alias of the specified destination:
fc-redirect version2 enable
To enable FC redirect version2 mode, use the fc-redirect version2 enable command in configuration mode. To disable this feature, use the no form of the command.
no fc-redirect version2 enable
Syntax Description
Defaults
Command Modes
Command History
|
|
|
Usage Guidelines
Examples
The following example shows how to enable FC redirect version2 mode:
The following example shows how to disable FC redirect version2 mode:
Related Commands
|
|
|
|---|---|
fc-redirect ivr-support enable
To enable FC redirect IVR support, use the fc-redirect ivr-support enable command in configuration mode. To disable this feature, use the no form of the command.
fc-redirect ivr-support enable
no fc-redirect ivr-support enable
Syntax Description
Defaults
Command Modes
Command History
|
|
|
Usage Guidelines
Examples
The following example shows how to enable FC redirect IVR support:
The following example shows how to disable FC redirect IVR support:
Related 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
Command Modes
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:
The following example removes this configuration:
The following example specifies the PortChannel interface and the route for the domain of the next hop switch for VSAN 4:
The following example removes this configuration:
The 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:
The following example removes this configuration:
The 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:
The following example removes this configuration:
Related Commands
|
|
|
|---|---|
Displays the preferred path route map configuration and status. |
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.
no fcrxbbcredit extended enable
Syntax Description
Defaults
Command Modes
Command History
|
|
|
Usage Guidelines
Use the fcrxbbcredit extended enable command to enable the switchport fcrxbbcredit extended command.
The fcrxbbcredit extended enable command is not supported on the following switches:
- Cisco MDS 9124 Multilayer Fabric Switch
- Cisco Fabric Switch for HP c-Class BladeSystem
- Cisco Fabric Switch for IBM BladeCenter
- Cisco MDS 9134 Multilayer Fabric Switch
- Cisco MDS 9148 Multilayer Fabric Switch
- Cisco MDS 9148S 16G Multilayer Fabric Switch
- Cisco MDS 9250i Multiservice Fabric Switch
The following example shows how to enable Fibre Channel extended BB_credits:
The following example shows how to disable Fibre Channel extended BB_credits:
Related Commands
|
|
|
|---|---|
Configures Fibre Channel extended BB_credits on an interface. |
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
Specifies the VSAN ID for platform checking, which is from 1 to 4096. |
Defaults
Command Modes
Command History
|
|
|
Usage Guidelines
Examples
Related 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-id
no fcs register platform name name vsan vsan-id
Syntax Description
Specifies the name of the platform to register. Maximum size is 255 characters. |
|
Defaults
Command Modes
Command History
|
|
|
Usage Guidelines
Examples
The following example shows how to register FCS attributes:
Related 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
(Optional) Specifies one or multiple ranges of VSANs. The range is 1 to 4093. |
Defaults
Command Modes
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:
The following example shows how to add to more than one range of VSANs:
Related Commands
|
|
|
|---|---|
fcsp
To configure a Fibre Channel Security Protocol (FC-SP) authentication mode for a specific interface in an 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 | esp manual | off | on} [ timeout-period ]
no fcsp { auto-active | auto-passive | esp manual | off | on} [ timeout-period ]
Syntax Description
Defaults
Command Modes
Command History
|
|
|
Fibre Channel Security Protocol (FC-SP) is currently not supported on MDS 9710, but targeted for a future release. |
|
Usage Guidelines
To use this command, FC-SP must be enabled using the feature fcsp command.
Examples
The following example shows how to configure the ESP in manual mode:
The following example turns on the authentication mode for ports 1 to 3 in Fibre Channel interface 2:
The following example reverts to the factory default of auto-passive for these Fibre Channel interfaces:
The following example changes these Fibre Channel interfaces to initiate FC-SP authentication, but does not permit reaunthentication:
The following example changes these Fibre Channel interfaces to initiate FC-SP authentication and permits reaunthentication within two hours (120 minutes) of the initial authentication attempt:
Related Commands
|
|
|
|---|---|
Displays FC-SP-related information for a specific interface. |
fcsp dhchap devicename
Asymmetric DHCHAP secrets may be used on FC-SP links. To populate the FC-SP DHCHAP secret database on the local switch with the secrets used by remote switches use the fcsp dhchap devicename command. To remove these entries use the no form of the command.
fcsp dhchap devicename remote-switch-wwn password [ 0 | 7 ] remote-secret
fcsp dhchap devicename remote-switch-wwn password [ 0 | 7 ] remote-secret
Syntax Description
Switch World Wide Name (WWN) of the remote device. The WWN format is hh:hh:hh:hh:hh:hh:hh:hh. |
|
(Optional) Specifies that the secret is in encrypted text. This is the default value. |
|
Defaults
Command Modes
Global configuration (config).
Command History
|
|
|
Usage Guidelines
The fcsp dhchap devicename command is available only when the FC-SP feature is enabled.
Examples
The following example shows how to configure an encrypted secret of a remote switch:
The following example shows how to remove the remote switch secret of the previous example from the local switch DHCHAP secret
The following example shows an asymmetric secret configuration for a link between the local switch and a remote switch with switch WWN of 01:01:01:01:01:01:01:01. The secret on the local switch is 'local_secret' and the remote switch has a secret of 'far_secret'. The configuration is for the local switch and the secrets:
Related Commands
|
|
|
|---|---|
fcsp dhchap dhgroup
To change the FC-SP DHCHAP group priority list, use the fcsp dhchap dhgroup command in global configuration mode. To revert to the default group priority list, use the no form of this command.
fcsp dhchap dhgroup group-id [group-id [group-id [group-id [group-id]]]]
no fcsp dhchap dhgroup group-id [group-id [group-id [group-id [group-id]]]]
Syntax Description
0|1|2|3|4 Specifies an FC-SP DHCHAP group priority list entry. |
Defaults
The default DH group priority list, from highest to lowest is 0 4 1 2 3.
Command Modes
Global configuration (config).
Command History
|
|
|
Usage Guidelines
The fcsp dhchap dhgroup command is available only when the FC-SP feature is enabled.
There must be at least one member in the DH group priority list. Each group may only be specified once.
If you change the default FC-SP DH group priority list, ensure that you change it globally for all the switches in the fabric.
The maps the Cisco Group Number with the corresponding RFC Group Number and Modular Exponentiation (MODP) Group:
|
|
|
|
|---|---|---|
Examples
The following example shows how to configure the used DH group list to only groups 2, 3, and 4, in the same order of priority:
The following example shows how to revert a previously configured DH group priority list of the 'null' group only back to the default priority list:
Related Commands
|
|
|
|---|---|
fcsp dhchap hash
To configure the hash algorithm priority list for FC-SP DHCHAP authentication use the fcsp dhchap hash command. To return to the default hash algorithm priority list use the no form of the command.
fcsp dhchap hash{md5 [sha1] | sha1 [md5]}
no fcsp dhchap hash{md5 [sha1] | sha1 [md5]}
Syntax Description
Defaults
The default FC-SP DHCHAP hash algorithm priority list has the following order:
Command Modes
Global configuration (config).
Command History
|
|
|
Usage Guidelines
The fcsp dhchap hash command is available only when the FC-SP feature is enabled.
If you change the default hash algorithm list order, then change it in all switches in the fabric.
Warning If FC-SP DHCHAP authentication via AAA is enabled, the MD5 hash algorithm must be set if the AAA authentication uses RADIUS or TACACS+. This is because RADIUS and TACACS+ applications do not support other hash algorithms.
Examples
The following example shows how to configure the DHCHAP authentication hash priority list to be SHA-1 followed by MD5:
The following example shows how to configure the use of the SHA-1 hash algorithm only:
The following example shows how to revert the previous example to the default priority list:
Related Commands
|
|
|
|---|---|
fcsp dhchap password
To configure the FC-SP DHCHAP secret database used for FC-SP peer switch link authentication via DHCHAP use the fcsp dhchap password command. To remove secrets from the FC-SP DHCHAP database use the no form of the command.
fcsp dhchap password [0 | 7] secret [remote-switch-wwn]
no fcsp dhchap password [0 | 7] secret [remote-switch-wwn]
Syntax Description
(Optional) Switch World Wide Name of the remote switch to use this secret with. The WWN format is hh:hh:hh:hh:hh:hh:hh:hh. |
Defaults
Command Modes
Global configuration (config).
Command History
|
|
|
Usage Guidelines
The fcsp dhchap password command is available only when the FC-SP feature is enabled.
Be sure to configure an FC-SP DHCHAP database on each switch in the fabric when this facility is being used.
To configure a fabric-wide global FC-SP DHCHAP secret use the command without any switch WWN specifier. There can be only a single global FC-SP DHCHAP secret in a fabric. Additionally, switch specific secrets may be configured. To configure these specify the switch WWN.
Examples
The following example show how to configure the global FC-SP DHCHAP secret in cleartext:
The following example show how to configure a secret to be used with the specified peer switch in cleartext:
The following example show how to remove a secret to be used with the specified peer switch by entering the secret in cleartext, even though the configuration is stored in the configuration in encrypted form:
The following example shows how to configure symmetric secrets on a link between switch1 with sWWN of 01:01:01:01:01:01:01:01 and switch2 with sWWN of 02:02:02:02:02:02:02:02. The FC-SP DHCHAP secret is in cleartext format:
Related Commands
|
|
|
|---|---|
fcsp enable
To enable the Fibre Channel Security Protocol (FC-SP) in a switch, use the fcsp enable command in configuration mode. Additional FC-SP commands are available when the FC-SP feature is enabled. To disable FC-SP, use the no form of the command.
Syntax Descriptionf
Defaults
Command Modes
Command History
|
|
|
Usage Guidelines
Examples
The following example enables FC-SP:
Related Commands
|
|
|
|---|---|
fcsp esp sa
To configure the parameters for the Security Association (SA), use the fcsp esp sa command. To delete the SA between the switches, use the no form of the command.
Syntax Description
Configures the Security Protocol Interface (SPI) of the Security Association. The range is from 256 to 4294967295. |
Defaults
Command Modes
Command History
|
|
|
|---|---|
The spi-number range has been reduced from 256 4294967295 to 256 65536. |
|
Usage Guidelines
Examples
The following example shows how to configure the command for ESP:
Related Commands
|
|
|
|---|---|
Displays FC-SP related information for a specific interface. |
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.
no fcsp timeout timeout-period
Syntax Description
Specifies the timeout period. The time ranges from 20 to 100 seconds. The default is 30 seconds. |
Defaults
Command Modes
Command History
|
|
|
Usage Guidelines
You can only see the fcsp timeout command if you enter the fcsp enable command.
Examples
The following example configures the FCSP timeout value:
Related 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
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 the fabric.
Use the vsan option to configure different TOV values for VSANs with special types of links such as FC or IP tunnels.
Examples
The following example shows how to change the default Fibre Channel timers:
Related 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.
Syntax Description
Defaults
Command Modes
Command History
|
|
|
Usage Guidelines
Examples
The following example shows how to discard a CFS distribution session in progress:
Related Commands
|
|
|
|---|---|
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.
Syntax Description
Defaults
Command Modes
Command History
|
|
|
Usage Guidelines
Note After the FC timer commit is completed the running configuration has been modified on all switches participating in fctimer distribution. You can then use the copy running-config startup-config fabric command to save the running configuration to the startup configuration on all the switches in the fabric.
Examples
The following example shows how to commit changes to the active Fibre Channel timer configuration:
Related Commands
|
|
|
|---|---|
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.
Syntax Description
Defaults
Command Modes
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:
Related Commands
|
|
|
|---|---|
Commits the Fibre Channel timer configuration changes to the active configuration. |
|
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
Command History
|
|
|
Usage Guidelines
Examples
The following example traces a route to the specified fcid in VSAN 1:
The following example traces a route to the specified device alias in VSAN 1:
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
Command Modes
Command History
|
|
|
All the fc-tunnel commands are not supported in Cisco MDS 9250i Multiservice Fabric Switch. |
|
Added the output for remote span configuration on local and remote switches. |
|
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 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 enables the FC tunnel feature:
The following example displays remote SPAN configuration on a local switch:
The following example displays remote SPAN Configuration on a remote switch:
The following example places you at the explicit path prompt for the path named Path and specifies that the next hop VSAN interface IP addresses:
The following example places you at the explicit path prompt for the path named Path and configures a minimum cost path in which this IP address exists:
The following example configures the FC tunnel (100) in the destination switch (switch D):
The following example creates two explicit paths and configures the next hop addresses for each path in the source switch (switch S):
The following example references the configured path in the source switch (switch S):
feature
To enable a feature or service on the switch, use the feature command. To disable a feature or service on the switch, use the no form of the command.
feature {cimserver | cluster | crypto {ike | ipsec} dpvm | fport-channel-trunk | fabric-binding | fcip | fcrxbbcredit {extended} fcsp | ficon |fport-channel-trunk | http-server | ioa | iscsi | ivr | npiv| npv | port-security | privilege | port-track | san-ext-turner | scheduler | sdv | sme | ssh | tacacs+ | telnet}
no feature {cimserver | cluster | crypto {ike | ipsec} dpvm | fport-channel-trunk| fabric-binding | fcip | fcrxbbcredit {extended} fcsp | ficon | fport-channel-trunk | http-server | ioa | iscsi | ivr | npiv | npv | port-security | privilege | port-track | san-ext-turner | scheduler | sdv | sme | ssh | tacacs+ | telnet}
Syntax Description
Enables or disables the extended rx b2b credit configuration. |
|
Defaults
Command Modes
Command History
|
|
|
|---|---|
Added features fport-channel-trunk, npiv and npv to the syntax description. |
|
Usage Guidelines
Examples
The following example shows how to enable a feature on the switch :
Related Commands
|
|
|
|---|---|
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.
Syntax Description
Defaults
Command Modes
Command History
|
|
|
Usage Guidelines
The effects of enabling the FICON feature in a Cisco MDS switch are as follows:
- You cannot disable in-order delivery for the FICON-enabled VSAN.
- You cannot disable fabric binding or static domain ID configurations for the FICON-enabled VSAN.
- The load balancing scheme is changed to Source ID (SID)—Destination ID (DID). You cannot change it back to SID—DID—OXID.
- The IPL configuration file is automatically created.
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 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 enables FICON on the switch:
The following example disables FICON on the switch:
Related 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
(Optional) Specifies the range of port numbers to assign. The range can be 0 through 153 or 0x0 through 0x99. |
Defaults
Command Modes
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 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 reserves port numbers 230 through 249 for FCIP and PortChannel interfaces:
The following example reserves port numbers 0xe6 through 0xf9 for FCIP and PortChannel interfaces:
The following example releases the port numbers:
Related 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
Defaults
Command Modes
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 implemented ports, if desired. Only the FICON configuration files created after you change the default have the new default setting.
Note 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 enables port prohibiting as the default for all implemented interfaces on the switch:
The following example disables port prohibiting as the default for all implemented interfaces on the switch:
Related 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
Specifies the range of port numbers to assign. The range can be 0 through 153, or 0x0 through 0x99. For 9513, the port numbers can be between 0 through 249, or 0x0 through 0xf9. |
Defaults
Command Modes
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
You can configure port numbers even when no module is installed in the slot, and before FICON is enabled on any VSAN.
Note 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 reserves FICON port numbers 0 through 15 and 48 through 63 for up to 32 interfaces in slot 3:
The 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:
The following example changes the reserved FICON port numbers for up to 24 interfaces in slot 3:
The following example releases the port numbers:
The following example shows the switch output when there are duplicate port numbers:
Related 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
(Optional) Initializes the port shut down after the ports are swapped. |
Defaults
Command Modes
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 enter 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.
Note 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 swaps the contents of ports 3 with port 15, shuts them down, and automatically initializes both ports:
The following example swaps the contents of ports 3 with port 15 and shuts them down:
The following example swaps port 1 with port 6:
Related Commands
|
|
|
|---|---|
ficon-tape-read-accelerator
To enable FICON tape read acceleration for the FCIP interface, use the ficon-tape-read-accelerator command in interface configuration submode. To disable FICON tape read acceleration for the FCIP interface, use the no form of the command.
no ficon-tape-read-accelerator
Syntax Description
Defaults
Command Modes
Interface configuration submode.
Command History
|
|
|
Usage Guidelines
Examples
The following example shows how to enable FICON tape read acceleration on the FCIP interface:
The following example shows how to disable FICON tape read acceleration on the FCIP interface:
Related 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
Command Modes
Interface configuration submode.
Command History
|
|
|
Usage Guidelines
Cisco MDS NX-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 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 enables FICON tape acceleration on the FCIP interface:
The following example disables FICON tape acceleration on the FCIP interface:
Related Commands
|
|
|
|---|---|
Enables write acceleration and tape acceleration for the FCIP interface. |
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 }
Command Modes
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 NX-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 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 applies the configuration from the saved files to the running configuration:
The following example copies an existing FICON configuration file called IPL and renames it to IPL3.
Related 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.
Syntax Description
Enters the FICON configuration mode for the specified VSAN (from 1 to 4096). |
Defaults
Command Modes
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 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 enables FICON on VSAN 2:
The following example disables FICON on VSAN 6:
Related 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.
Syntax Description
Defaults
Command Modes
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:
The following example deletes a previously created FICON configuration file:
Related Commands
|
|
|
|---|---|
find
To display a list of files on a file system, use the find command in EXEC mode.
Syntax Description
Specifies a search string to match to the files in the default directory. Maximum length is 64 characters. |
Defaults
Command Modes
Command History
|
|
|
Usage Guidelines
Use the find (Flash file system) command to display more details about the files in a particular file system.
Examples
The following example is sample output of all files that begin with the letter a :
Related Commands
|
|
|
|---|---|
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
Specifies the pWWN to be mapped to the user-specific virtual pWWN. |
Defaults
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
Examples
The following example shows how to map the real pWWN and a user-specific virtual pWWN on an interface:
Related Commands
|
|
|
|---|---|
Enables the FlexAttach virtual pWWN on a specific interface. |
|
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
Command Modes
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:
Related Commands
|
|
|
|---|---|
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
Specifies the interface on which the FlexAttach virtual port has to be enabled. |
|
(Optional) Specifies the VSAN on which FlexAttach should be enabled. |
Defaults
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
Examples
The following example shows how to set the user-specific virtual pWWN on an interface:
Related Commandsswitch# (config) flex-attach virtual-pwwn 20:04:00:a0:b8:16:92:18 interface fc 1/1
Related Commands
|
|
|
|---|---|
Enables the FlexAttach virtual pWWN on a specific interface. |
flowgroup
To configure an IOA flow group, use the flowgroup command.
Syntax Description
Specifies an IOA flow group name. The maximum size is 31 characters. |
Defaults
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
Examples
Related Commands
|
|
|
|---|---|
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
Command Modes
Command History
|
|
|
Usage Guidelines
The SAN-OS and NX-OS software supports Cisco-certified CompactFlash devices that are formatted using Cisco MDS 9000 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.
The following example erases all information on the logflash memory.
switch# format slot0:
The following example erases all information on usb1:
The following example erases all information on usb2:.
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 }
no fspf config vsan vsan-id min-ls-arrival min-ls-interval region spf { hold-time | static }
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
Command History
|
|
|
Usage Guidelines
This command configures FSPF on VSANs globally.
For the commands entered 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:
Related Commands
fspf cost
To configure FSPF link cost for a Fibre Channel 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
Defaults
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 a Fibre Channel interface:
Related Commands
|
|
|
|---|---|
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
Specifies the FSPF dead interval in seconds. The rage is 2 to 65535. |
|
Defaults
Command Modes
Interface configuration submode.
Command History
|
|
|
Usage Guidelines
Access this command from the switch(config-if)# submode.
Note ● This value must be the same in the ports at both ends of the ISL.
- An error is reported at the command prompt if the configured dead time interval is less than the hello time interval
- During a software upgrade, ensure that the fspf dead-interval is greater than the ISSU downtime (80 seconds). If the fspf dead-interval is lesser than the ISSU downtime, the software upgrade fails and the following error is displayed:
Examples
The following example configures the maximum interval of 400 seconds for a hello message before the neighbor is considered lost:
Related Commands
|
|
|
|---|---|
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.
Syntax Description
Defaults
Command Modes
Command History
|
|
|
Usage Guidelines
Examples
The following example enables FSPF in VSAN 5 and disables FSPF in VSAN 7:
Related Commands
|
|
|
|---|---|
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
Specifies the FSPF hello-interval in seconds. The rage is 1 to 65534. |
|
Defaults
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 This value must be the same in the ports at both ends of the ISL.
Examples
The following example configures a hello interval of 3 seconds on VSAN 1:
Related Commands
|
|
|
|---|---|
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.
Syntax Description
Defaults
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 FSPF must be enabled on the ports at both ends of the ISL for the protocol to operate correctly.
Examples
The following example disables the FSPF protocol for the selected interface on VSAN 1:
Related Commands
|
|
|
|---|---|
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
Specifies FSPF retransmit interval in seconds. The range is |
|
Defaults
Command Modes
Interface configuration submode.
Command History
|
|
|
Usage Guidelines
Access this command from the switch(config-if)# submode.
Note This value must be the same in the ports at both ends of the ISL.
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:
Related Commands
|
|
|
|---|---|
Displays an interface configuration for a specified FCIP interface. |
Feedback