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 over Ethernet (FCoE) commands for the Cisco Nexus 7000 Series and MDS 9500 Series switches.
To allocate Fibre Channel over Ethernet (FCoE) VLANs to a virtual device context (VDC), use the allocate fcoe-vlan-range command. To remove the shared FCoE VLAN configuration for the VDC, use the no form of this command.
allocate fcoe-vlan-range vlan-range from vdcs vdc-name... [, vdcs vdc-name]
no allocate fcoe-vlan-range vlan-range from vdc vdc-name...[, vdcs vdc-name]
Specifies which VDCs are going to share ports with the FCoE VDC. |
|
|
|
This command was introduced on the Cisco Nexus 7000 Series Switches. |
Before allocating fcoe-vlan-range one has to create a storage vdc first.
This command does not require a license.
Note Before allocating fcoe-vlan-range one has to create a storage vdc first.
This example shows how to allocate FCoE VLANs to a VDC:
This example shows how to remove the shared FCoE VLAN configuration for a VDC:
|
|
---|---|
To allocate interfaces to a virtual device context (VDC) for sharing ports, use the allocate shared interface ethernet command. To disallow the VDC to share interfaces, use the no form of this command.
allocate shared interface ethernet slot/chassis number
no allocate shared interface ethernet slot/chassis number
|
|
This command was introduced on the Cisco Nexus 7000 Series Switches. |
This example shows how to allocate interfaces to a VDC for sharing ports:
This example shows how to disallow a VDC to share interfaces:
|
|
---|---|
To bind the virtual Fibre Channel (VFC) interface to the physical or logical interface, use the bind interface command. To unbind the VFC interface, use the no form of this command.
bind interface {ethernet slot/port number | ethernet-port-channel port-channel port-channel number}
no bind interface {ethernet slot/port number | ethernet-port-channel port-channel port-channel number}
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 and MDS 9500 Switches. |
This example shows how to bind a VFC interface to an Ethernet interface:
This example shows how to bind a VFC interface to a port channel interface:
|
|
---|---|
To disable the verification of Fibre Channel over Ethernet (FCoE) Initialization Protocol (FIP) keepalive (FKA) messages, use the diable-fka command. To enable FKA messages, use the no form of this command.
Virtual Fibre Channel interface configuration mode
|
|
---|---|
Before you use this command, you must enable Fibre Channel over Ethernet (FCoE).
This example shows how to disable the verification of FKA messages:
This example shows how to enable the verification of FKA messages:
To enable the Fibre Channel over Ethernet (FCoE) feature set, use the feature-set fcoe command. To disable this feature, use the no form of this command.
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 and MDS 9500 Series Switches. |
Use the feature-set fcoe command to enable all the features for FCoE. You must first use the install feature-set fcoe command to install FCoE support.
Note The feature-set fcoe command is automatically installed and enabled when a FCoE line card is inserted.
The no feature-set fcoe command might take some time to complete if the size of the configuration is very large because the command must clean up all of the configuration associated with the FCoE feature set.
This example shows how to disable the FCoE feature set on the Cisco Nexus 7000 and MDS 9000 Series switches:
|
|
---|---|
To configure the Fibre Channel over Ethernet (FCoE) MAC address prefix (FC-Map) used to associate the FCoE node (ENode), use the fcoe fcmap command. To restore the default global FC-Map value of 0xefc00, use the no form of this command.
FC-Map value. The range is from 0EFC00 to 0EFCFF, and the default is 0xefc00. |
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 and MDS 9500 Series Switches. |
Before you use this command, you must enable FCoE on the switch by using the feature fcoe or the feature-set fcoe command.
You can prevent data corruption due to cross-fabric talk by configuring an FC-Map, which identifies the Fibre Channel fabric for this switch. When the FC-Map is configured, the switch discards the MAC addresses that are not part of the current fabric.
This example shows how to configure the FC-Map value on the switch:
To configure the Fibre Channel over Ethernet (FCoE) Initialization Protocol (FIP) priority value advertised by the Fibre Channel Forwarder (FCF) to FCoE nodes (ENodes), use the fcoe fcf-priority command. To revert to the default FCF priority value, use the no form of this command.
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 MDS 9500 Series Switches. |
Before you use this command, you must enable FCoE on the switch by using the feature fcoe command.
The switch advertises its priority. The priority is used by the converged network adapters (CNAs) in the fabric to determine the best switch to connect to.
This example shows how to configure the FCF priority on the switch:
To configure the time interval at which Fabric Initialization Protocol (FIP) keepalive (FKA) messages are transmitted to the MAC address of the Fibre Channel over Ethernet (FCoE) node (ENode), use the fcoe fka-adv-period command. To return to the default settings, use the no form of this command.
FKA advertisement period (in seconds). The range is from 4 to 60 seconds. |
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 MDS 9500 Series Switches. |
Before you use this command, you must enable FCoE on the switch by using the feature fcoe command.
This example shows how to configure the FKA advertisement period for the switch to 5 seconds:
To map a virtual SAN (VSAN) to a VLAN that carries Fibre Channel over Ethernet (FCoE) traffic, use the fcoe vsan command. To remove the mapping, use the no form of this command.
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 MDS 9500 Series Switches. |
Before you map an FCoE VLAN to the VSAN, make sure that you create a VSAN using the vsan command in the VLAN database configuration mode.
You should use an FCoE VLAN only for FCoE. Do not use the default VLAN, VLAN1, as an FCoE VLAN. FCoE is not supported on private VLANs.
When you map an FCoE VLAN to a VSAN, ensure that the VSAN is not mapped to any other FCoE VLAN. If you map a FCoE VLAN to a VSAN that is already mapped to another FCoE VLAN, the following error appears:
If you do not specify a VSAN number, a mapping is created from the FCoE VLAN in use to the VSAN with the same number.
This example shows how to map an FCoE VLAN to a VSAN:
|
|
---|---|
To disable the VFID check for all VE ports, use the fcoe veloopback command. To return to the default settings, use the no form of this command.
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 and MDS 9500 Series Switches. |
Before you map the FCoE VLAN to the VSAN, make sure that you create a VSAN using the vsan command in the VLAN database configuration mode.
You should use an FCoE VLAN only for FCoE. Do not use the default VLAN, VLAN1, as an FCoE VLAN. FCoE is not supported on private VLANs.
When you map an FCoE VLAN to a VSAN, ensure that the VSAN is not mapped to any other FCoE VLAN. If you map an FCoE VLAN to a VSAN that is already mapped to another FCoE VLAN, the following error appears:
If you do not specify a VSAN number, a mapping is created from the FCoE VLAN in use to the VSAN with the same number.
This example shows how to enable VE loopback for a Cisco Nexus 7000 Series switch:
This example shows how to enable VE loopback for a Cisco MDS 9500 switch:
|
|
---|---|
To install the Fibre Channel over Ethernet (FCoE) feature set, use the install feature-set fcoe
command. To disable this feature, use the no form of this command.
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 and MDS 9500 Series Switches. |
Note The feature-set fcoe command is automatically installed and enabled when a FCoE line card is inserted.
This example shows how to set the install FCoE feature set to its default value:
|
|
---|---|
To configure a virtual Fibre Channel (VFC) interface, use the interface vfc command. To return to the default settings, use the no form of this command.
interface vfc vfc-id {bind interface ethernet slot/port | shutdown | switchport mode E/F}
no interface vfc vfc-id {bind interface ethernet slot/port | shutdown | switchport mode E/F}
interface vfc slot/port {shutdown | switchport mode E/F}
no interface vfc slot/port {shutdown | switchport mode E/F}
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 and MDS 9500 Series Switches. |
You can specify a range of interfaces by entering a command with the following example format:
Use the no shutdown command to enable the interface.
The interface vfc slot/port command is used to create a VFC implicitly bound for a particular Ethernet interface x/y.
This example shows how to enter interface configuration mode for VFC interface 3:
This example shows how to create a VFC (VFC 1/3) which will be implicitly bound to the Ethernet interface 1/3:
This example shows how to create a VFC (vfc-po 3) bound to the Ethernet port channel 3:
|
|
---|---|
Displays an interface configuration for a specified interface. |
|
To create a virtual Fibre Channel (VFC) implicity bound to a port channel interface, use the interface vfc-port-channel command. To return to the default settings, use the no form of this command.
interface vfc-port-channel interface-id
no interface vfc-port-channel interface-id
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 and MDS 9500 Series Switches. |
This example shows how to create a virtual FC interface:
|
|
---|---|
To modify the license feature for the Fibre Channel over Ethernet (FCoE) module, use the license fcoe module command. To return to the default setting, use the no form of this command.
license fcoe module module-number
no license fcoe module module-number
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 Series Switches. |
This example shows how to modify the license for the FCoE module:
|
|
---|---|
To allow a virtual SAN list for a virtual Fibre Channel (VFC) interface, use the switchport trunk allowed vsan command. To return to the default setting, use the no form of this command.
switchport trunk allowed vsan vsan-id
no switchport trunk allowed vsan vsan-id
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 and MDS 9500 Series Switches. |
This example shows how to allow a VSAN list for a VFC interface:
|
|
---|---|
To display the status of Fibre Channel over Ethernet (FCoE) parameters on the switch, use the show fcoe command.
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 and MDS 9500 Series Switches. |
This example shows how to display the FCoE status:
To display the content of the Fibre Channel over Ethernet (FCoE) database, use the show fcoe database command.
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 and MDS 9500 Series Switches. |
This example shows how to display the FCoE database:
|
|
---|---|
To display information about the Fibre Channel over Ethernet (FCoE) feature set, use the show
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 and MDS 9500 Series Switches. |
This example shows how to display information about the FCoE feature set:
|
|
---|---|
To displays information about the virtual Fibre Channel (VFC) interfaces bound to port channel interfaces, use the show interface vfc-port-channel command.
show interface vfc-port-channel int-number
Interface number. The range is from 1 to 4096. The range is from 1 to 4095. |
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 and MDS 9500 Series Switches. |
This example shows how to display information about the VFC interfaces bound to port channel interfaces:
|
|
---|---|
To display the Fibre Channel over Ethernet (FCoE) VLAN range on a virtual device context (VDC), use the show vdc fcoe-vlan-range command.
network-admin
network-operator
vdc-admin
vdc-operator
|
|
This example shows how to display the FCoE VLAN range on the current VDC:
|
|
---|---|
To display the shared interfaces on a virtual device context (VDC), use the show vdc shared membership command.
network-admin
network-operator
vdc-admin
vdc-operator
|
|
This command was introduced on the Cisco Nexus 7000 Series Switches. |
This command does not require a license.
Note FCoE operates ONLY on F Series cards, so allocate interfaces only on that card to shared (You can also reference the VDC Config Guide for them to see which ports have to go to a VDC together, so can allocated to FCoE VLAN and shared.
This example shows how to display the shared interfaces on the VDC:
|
|
---|---|
To display information about a configured virtual SAN (VSAN), use the show vsan command.
show vsan [ vsan-id ] [ membership ]
(Optional) Information for the specified VSAN ID. The range is from 1 to 4094. |
|
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 Series Switches. |
|
This command was introduced on the Cisco MDS 9000 MDS 9000 Series Switches. |
When you enter the show vsan membership interface command, interface information appears for interfaces that are configured in this VSAN.
The interface range must be in ascending order and nonoverlapping. You can specify a range using a hyphen and several interfaces using commas.
The interface range format for a Fibre Channel interface range is:
fcslot/port - port, fcslot/port, fcslot/port:
This example shows how to display the configured VSAN information:
This example shows how to display the membership information for the VSAN:
|
|
---|---|
To display information about the Fibre Channel over Ethernet (FCoE) VLAN to virtual SAN (VSAN) mappings, use the show vlan fcoe command.
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 and MDS 9500 Series Switches. |
This example shows how to display the FCoE VLAN-to-VSAN mappings on the switch:
|
|
---|---|
To display the configuration information of virtual Fibre Channel (VFC) interfaces, use the show interface vfc command.
Virtual Fibre Channel interface ID. The range is from 1 to 8192. |
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 and MDS 9500 Series Switches. |
This example shows how to display the configuration information for a specified VFC interface:
|
|
---|---|
To enable the Spanning Tree Protocol (STP) for FCoE VLAN, use the spanning-tree fcoe command. To disable the STP for FCoE VLAN, use the no form of the command.
network-admin
network-operator
vdc-admin
vdc-operator
|
|
This command was introduced on the Cisco Nexus 7000 Series Switches. |
The STP Lite feature, which is automatically enabled, runs on both FCoE shared and dedicated links in the FCoE VLANs and ensures rapid convergence across the network by sending an agreement BPDU whenever it receives a proposal BPDU. If you want to disable this feature for troubleshooting purposes, enter the no spanning-tree fcoe command.
This command is only available on F-Series Modules when FCoE is enabled.
We recommend that you configure the interface on the peer side of the FCoE link as an STP-type edge port. Ensure that the peer interface is not configured as an STP-type network port.
Note This feature runs only in FCoE VLANs.
This example shows how to enable the STP for FCoE VLANs:
This example shows how to disable the STP lite in the FCoE VLANs if you need to do troubleshooting:
|
|
---|---|
To enter virtual SAN (VSAN) database mode to configure the VSAN information and membership, use the vsan database command.
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 Series Switches. |
|
This command was introduced on the Cisco MDS 9000 Series Switches. |
To exit from the VSAN database configuration mode, use the exit command.
This example shows how to enter the VSAN database configuration mode:
|
|
---|---|