The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter describes the Cisco NX-OS Fibre Channel, virtual Fibre Channel, and Fibre Channel over Ethernet (FCoE) commands that begin with C.
To enable or disable Cisco Fabric Services (CFS) distribution on the switch, use the cfs distribute command. To disable this feature, use the no form of this command.
cfs distribute
no cfs distribute
This command has no arguments or keywords.
CFS distribution is enabled.
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
By default, CFS is in the distribute mode. In the distribute mode, fabric-wide distribution is enabled. Applications can distribute configuration data to all CFS-capable switches in the fabric where the application exists. This is the normal mode of operation.
If you disable CFS distribution by entering the no cfs distribute command, the following events occur:
•The CFS commands continue to operate. However, CFS and the applications using CFS on the switch are isolated from the rest of the fabric even though there is physical connectivity.
•All CFS operations are restricted to the isolated switch.
•CFS operations (for example, lock, commit, and abort) initiated at other switches do not have any effect at the isolated switch.
•CFS distribution is disabled over both Fibre Channel and IP.
This example shows how to disable CFS distribution:
switch(config)# no cfs distribute
This example shows how to reenable CFS distribution:
switch(config)# cfs distribute
|
|
---|---|
show cfs status |
Displays whether CFS distribution is enabled or disabled. |
To enable Cisco Fabric Services (CFS) distribution over IPv4 for applications that want to use this feature, use the cfs ipv4 command. To disable this feature, use the no form of this command.
cfs ipv4 distribute
no cfs ipv4 distribute
This command has no arguments or keywords.
CFS distribution is enabled. CFS over IP is disabled.
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
All CFS over IP enabled switches with similar multicast addresses form one CFS over IP fabric. CFS protocol-specific distributions, such as the keepalive mechanism for detecting network topology changes, use the IP multicast address to send and receive information.
Observe the following guidelines when using this command:
•If a switch is reachable over both IP and Fibre Channel, application data will be distributed over Fibre Channel.
•You can select either an IPv4 or IPv6 distribution when CFS is enabled over IP.
•Both IPv4 and IPv6 distribution cannot be enabled on the same switch.
•A switch that has IPv4 distribution enabled cannot detect a switch that IPv6 distribution enabled. The switches operate as if they are in two different fabrics even though they are connected to each other.
This example shows how to disable CFS IPv4 distribution:
switch(config)# no cfs ipv4 distribute
This will prevent CFS from distributing over IPv4 network.
Are you sure? (y/n) [n]
This example shows how to reenable CFS IPv4 distribution:
switch(config)# cfs ipv4 distribute
To configure an IPv4 multicast address for Cisco Fabric Services (CFS) distribution over IPv4, use the cfs ipv4 mcast-address command. To disable this feature, use the no form of this command.
cfs ipv4 mcast-address ipv4-address
no cfs ipv4 mcast-address ipv4-address
ipv4-address |
IPv4 multicast address for CFS distribution over IPv4. The range of valid IPv4 addresses is 239.255.0.0 through 239.255.255.255 and 239.192.0.0 through 239.251.251.251. |
Multicast address: 239.255.70.83.
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
Before using this command, enable CFS distribution over IPv4 by using the cfs ipv4 distribute command.
All CFS over IP-enabled switches with similar multicast addresses form one CFS over IP fabric. CFS protocol-specific distributions, such as the keepalive mechanism for detecting network topology changes, use the IP multicast address to send and receive information.
CFS distributions for application data use directed unicast.
You can configure a value for a CFS over IP multicast address. The default IPv4 multicast address is 239.255.70.83.
This example shows how to configure an IP multicast address for CFS over IPv4:
switch(config)#
cfs ipv4 mcast-address 239.255.1.1
Distribution over this IP type will be affected
Change multicast address for CFS-IP ?
Are you sure? (y/n) [n]
y
This example shows how to revert to the default IPv4 multicast address for CFS distribution over IPv4:
switch(config)# no cfs ipv4 mcast-address 10.1.10.100
Distribution over this IP type will be affected
Change multicast address for CFS-IP ?
Are you sure? (y/n) [n] y
|
|
---|---|
cfs ipv4 distribute |
Enables or disables Cisco Fabric Services (CFS) distribution over IPv4. |
show cfs status |
Displays whether CFS distribution is enabled or disabled. |
To enable Cisco Fabric Services (CFS) distribution over IPv6 for applications using CFS, use the cfs ipv6 distribute command. To disable this feature, use the no form of this command.
cfs ipv6 distribute
no cfs ipv6 distribute
This command has no arguments or keywords.
CFS distribution is enabled. CFS over IPv4 is disabled.
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
All CFS over IP-enabled switches with similar multicast addresses form one CFS over IP fabric. CFS protocol-specific distributions, such as the keepalive mechanism for detecting network topology changes, use the IP multicast address to send and receive information.
Observe the following guidelines when using this command:
•If a switch is reachable over both IP and Fibre Channel, application data will be distributed over Fibre Channel.
•You can select either an IPv4 or IPv6 distribution when CFS is enabled over IP.
•Both IPv4 and IPv6 distribution cannot be enabled on the same switch.
•A switch that has IPv4 distribution enabled cannot detect a switch that IPv6 distribution enabled. The switches operate as if they are in two different fabrics even though they are connected to each other.
This example shows how to disable CFS IPv6 distribution:
switch(config)# no cfs ipv6 distribute
This will prevent CFS from distributing over IPv6 network.
Are you sure? (y/n) [n]
This example shows how to reenable CFS IPv6 distribution:
switch(config)# cfs ipv6 distribute
To configure an IPv6 multicast address for Cisco Fabric Services (CFS) distribution over IPv6, use the cfs ipv6 mcast-address command. To disable this feature, use the no form of this command.
cfs ipv6 mcast-address ipv6-address
no cfs ipv6 mcast-address ipv6-address
ipv6-address |
IPv6 multicast address or CFS distribution over IPv6. The IPv6 Admin scope range is [ff15::/16, ff18::/16]. |
Multicast address: ff15::efff:4653
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
Before using this command, enable CFS distribution over IPv6 by using the cfs ipv6 distribute command.
All CFS over IP-enabled switches with similar multicast addresses form one CFS over IP fabric. CFS protocol-specific distributions, such as the keepalive mechanism for detecting network topology changes, use the IP multicast address to send and receive information. CFS distributions for application data use directed unicast.
You can configure a CFS over IP multicast address value for IPv6. The default IPv6 multicast address is ff15::efff:4653. Examples of the IPv6 Admin scope range are ff15::0000:0000 to ff15::ffff:ffff and ff18::0000:0000 to ff18::ffff:ffff.
This example shows how to configure an IP multicast address for CFS over IPv6:
switch(config)#
cfs ipv6 mcast-address ff13::e244:4754
Distribution over this IP type will be affected
Change multicast address for CFS-IP ?
Are you sure? (y/n) [n]
y
This example shows how to revert to the default IPv6 multicast address for CFS distribution over IPv6:
switch(config)# no cfs ipv6 mcast-address
ff13::e244:4754
Distribution over this IP type will be affected
Change multicast address for CFS-IP ?
Are you sure? (y/n) [n] y
|
|
---|---|
cfs ipv6 distribute |
Enables or disables Cisco Fabric Services (CFS) distribution over IPv6. |
show cfs status |
Displays whether CFS distribution is enabled or disabled. |
To create a region that restricts the scope of application distribution to the selected switches, use the cfs region command. To disable this feature, use the no form of this command.
cfs region region-id
no cfs region region-id
region-id |
Region identifier. The range is from 1 to 255. A total of 200 regions are supported. |
The default region identifier is 0.
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
An application can only be a part of one region on a given switch. By creating the region ID and assigning it to an application, the application distribution is restricted to switches with a similar region ID.
Cisco Fabric Services (CFS) regions provide the ability to create distribution islands within the application scope. Currently, the regions are supported only for physical scope applications. In the absence of any region configuration, the application will be a part of the default region. The default region is region ID 0.
This example shows how to create a region ID:
switch(config)# cfs region 1
This example shows how to assign an application to a region:
switch(config)# cfs region 1
switch(config-cfs-region)# ntp
This example shows how to remove an application assigned to a region:
switch(config)# cfs region 1
switch(config-cfs-region)# no ntp
|
|
---|---|
show cfs regions |
Displays all configured applications with peers. |
To enable Cisco Fabric Series (CFS) to merge the data from multiple Virtual SANs (VSANs), use the cfs staggered-merge command. To disable this feature, use the no form of this command.
cfs staggered-merge enable
no cfs staggered-merge enable
enable |
Enables the CFS staggered-merge option. |
Staggered merge is disabled.
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to enable CFS staggered merge:
switch(config)# cfs staggered-merge enable
|
|
---|---|
show cfs status |
Displays whether staggered merge is enabled. |
To configure a SAN port channel interface as an active channel port, use the channel mode active command. To revert to the default settings, use the no form of this command.
channel mode active
no channel mode [active]
This command has no arguments or keywords.
None
SAN port channel configuration mode
|
|
5.1(3)N1(1) |
This command was introduced. |
This command does not require a license.
This example shows how to configure a SAN port channel interface 3 as an active channel:
switch# configure terminal
switch(config)# interface san-port-channel 3
switch(config-if)# channel mode active
switch(config-if)#
This example shows how to revert a SAN port channel interface to the default setting:
switch# configure terminal
switch(config)# interface san-port-channel 3
switch(config-if)# no channel mode
switch(config-if)#
To clear device alias information, use the clear device-alias command.
clear device-alias {database | session | statistics}
database |
Clears the device alias database. |
session |
Clears session information. |
statistics |
Clears device alias statistics. |
None
EXEC mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to clear the device alias session:
switch# clear device-alias session
|
|
---|---|
show device-alias |
Displays device alias database information. |
To clear the entire list of configured hosts, use the clear fcdomain command.
clear fcdomain session vsan vsan-id
session |
Clears session information. |
vsan vsan-id |
Clears Fibre Channel domains for a specified VSAN ranging from 1 to 4093. |
None
EXEC mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
This command clears only the list of configured hosts. Existing connections are not terminated.
This example shows how to clear the entire list of configured hosts for remote capture:
switch# clear fcdomain
|
|
---|---|
show fcdomain |
Displays the list of hosts configured for a remote capture. |
To clear Fibre Channel flow statistics, use the clear fcflow stats command.
clear fcflow stats [aggregated] index flow-index
aggregated |
(Optional) Clears the Fibre Channel flow aggregated statistics. |
index |
Clears the Fibre Channel flow counters for a specified flow index. |
flow-index |
Flow index number. |
None
EXEC mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to clear aggregated Fibre Channel flow statistics for flow index 1:
switch(config)# clear fcflow stats aggregated index 1
|
|
---|---|
show fcflow |
Displays the fcflow statistics. |
To clear the name server statistics, use the clear fcns statistics command.
clear fcns statistics vsan vsan-id
vsan vsan-id |
Clears the FCS statistics for a specified VSAN ranging from 1 to 4093. |
None
EXEC mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to clear the name server statistics:
switch# clear fcns statistics vsan 1
|
|
---|---|
show fcns statistics |
Displays the name server statistics. |
To clear the Fibre Channel Signal Modeling (FCSM) log, use the clear fcsm log command.
clear fcsm log
This command has no arguments or keywords.
None
EXEC mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to clear the FSCM log:
switch# clear fcsm log
|
|
---|---|
show fcs |
Displays the fabric configuration server information. |
To clear the fabric configuration server statistics, use the clear fcs statistics command.
clear fcs statistics vsan vsan-id
vsan vsan-id |
Clears the FCS statistics for a specified VSAN ranging from 1 to 4093. |
None
EXEC mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to clear the fabric configuration server statistics for VSAN 10:
switch# clear fcs statistics vsan 10
|
|
---|---|
show fcs statistics |
Displays the fabric configuration server statistics information. |
To clear fctimer Cisco Fabric Services (CFS) session configuration and locks, use the clear fctimer session command.
clear fctimer session
This command has no arguments or keywords.
None
EXEC mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to clear an fctimer session:
switch# clear fctimer session
|
|
---|---|
show fctimer |
Displays fctimer information. |
To clear the Fabric Shortest Path First (FSPF) statistics, use the clear fspf counters command.
clear fspf counters vsan vsan-id [interface type]
None
EXEC mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
If the interface is not specified, then all of the counters of a VSAN are cleared. If the interface is specified, then the counters of the specific interface are cleared.
This example shows how to clear the FSPF statistics on VSAN 1:
switch# clear fspf counters vsan 1
This example shows how to clear the FSPF statistics in VSAN 1 for the specified Fibre Channel interface:
switch# clear fspf counters vsan 1 interface fc 3/2
|
|
---|---|
show fspf |
Displays global FSPF information for a specific VSAN. |
To clear the port security information on the switch, use the clear fc-port-security command.
clear fc-port-security {database auto-learn {interface fc slot/port | san-port-channel port} | session | statistics} vsan vsan-id
None
EXEC mode
The active database is read-only and the clear fc-port-security database command can be used when resolving conflicts.
This example shows how to clear all existing statistics from the port security database for a specified VSAN:
switch# clear fc-port-security statistics vsan 1
This example shows how to clear the learned entries in the active database for a specified interface within a VSAN:
switch# clear fc-port-security database auto-learn interface fc2/1 vsan 1
This example shows how to clear the learned entries in the active database up to for the entire VSAN:
switch# clear fc-port-security database auto-learn vsan 1
|
|
---|---|
show fc-port-security |
Displays the configured port security information. |
To clear Registered Link Incident Report (RLIR) information, use the clear rlir command.
clear rlir {history | recent {interface fc slot/port | portnumber port} | statistics vsan vsan-id}
None
EXEC mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to clear the RLIR statistics for VSAN 1:
switch# clear rlir statistics vsan 1
|
|
---|---|
show rlir |
Displays RLIR information. |
To clear a Registered State Change Notification (RSCN) session for a specified Virtual SAN (VSAN), use the clear rscn session command.
clear rscn session vsan vsan-id
vsan vsan-id |
Specifies a VSAN where the RSCN session should be cleared. The ID of the VSAN is from 1 to 4093. |
None
EXEC mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to clear an RSCN session on VSAN 1:
switch# clear rscn session vsan 1
|
|
---|---|
rscn |
Configures an RSCN. |
show rscn |
Displays RSCN information. |
To clear the registered state change notification statistics for a specified Virtual SAN (VSAN), use the clear rscn statistics command.
clear rscn statistics vsan vsan-id
vsan |
Clears the RSCN statistics for a VSAN. |
vsan-id |
ID of the VSAN is from 1 to 4093. |
None
EXEC mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to clear the RSCN statistics for VSAN 1:
switch# clear rscn statistics vsan 1
|
|
---|---|
show rscn |
Displays RSCN information. |
To clear all configured information in the zone server for a specified Virtual SAN (VSAN), use the clear zone command.
clear zone {database | lock | statistics} vsan vsan-id
None
EXEC mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
After entering a clear zone database command, you must explicitly enter the copy running-config startup-config command to ensure that the running configuration is used when you next start the switch.
When you enter the clear zone lock command from a remote switch, only the lock on that remote switch is cleared. When you enter the clear zone lock command from the switch where the lock originated, all locks in the VSAN are cleared. The recommended method to clear a session lock on a switch where the lock originated is by entering the no zone commit vsan command.
This example shows how to clear all configured information in the zone server for VSAN 1:
switch# clear zone database vsan 1
|
|
---|---|
show zone |
Displays zone information for any configured interface. |