Cisco Nexus 5000 Series Command Reference

Fibre Channel Commands

This chapter describes the Cisco NX-OS Fibre Channel, virtual Fibre Channel, and Fibre Channel over Ethernet (FCoE) commands available on Cisco Nexus 5000 Series switches.

cfs distribute

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

Syntax Description

This command has no arguments or keywords.

Command Default

CFS distribution is enabled.

Command Modes

Global configuration mode

Command History

Usage Guidelines

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.

Examples

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 

Related Commands

cfs ipv4 distribute

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

Syntax Description

This command has no arguments or keywords.

Command Default

CFS distribution is enabled. CFS over IP is disabled.

Command Modes

Global configuration mode

Command History

Usage Guidelines

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.

Examples

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 

Related Commands

cfs ipv4 mcast-address

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

Syntax Description

Command Default

Multicast address: 239.255.70.83.

Command Modes

Global configuration mode

Command History

Usage Guidelines

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.

Examples

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  

Related Commands

cfs ipv6 distribute

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

Syntax Description

This command has no arguments or keywords.

Command Default

CFS distribution is enabled. CFS over IPv4 is disabled.

Command Modes

Global configuration mode

Command History

Usage Guidelines

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.

Examples

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  

Related Commands

cfs ipv6 mcast-address

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

Syntax Description

Command Default

Multicast address: ff15::efff:4653

Command Modes

Global configuration mode

Command History

Usage Guidelines

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.

Examples

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  

Related Commands

cfs region

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

Syntax Description

Command Default

The default region identifier is 0.

Command Modes

Global configuration mode

Command History

Usage Guidelines

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.

Examples

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 

Related Commands

cfs staggered-merge

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

Syntax Description

Command Default

Staggered merge is disabled.

Command Modes

Global configuration mode

Command History

Examples

This example shows how to enable CFS staggered merge:

switch(config)# cfs staggered-merge enable  

Related Commands

clear device-alias

To clear device alias information, use the clear device-alias command.

clear device-alias {database | session | statistics}

Syntax Description

Command Default

None

Command Modes

EXEC mode

Command History

Examples

This example shows how to clear the device alias session:

switch# clear device-alias session  

Related Commands

clear fcdomain

To clear the entire list of configured hosts, use the clear fcdomain command.

clear fcdomain session vsan vsan-id

Syntax Description

Command Default

None

Command Modes

EXEC mode

Command History

Usage Guidelines

This command clears only the list of configured hosts. Existing connections are not terminated.

Examples

This example shows how to clear the entire list of configured hosts for remote capture:

switch# clear fcdomain  

Related Commands

clear fcflow stats

To clear Fibre Channel flow statistics, use the clear fcflow stats command.

clear fcflow stats [aggregated] index flow-index

Syntax Description

Command Default

None

Command Modes

EXEC mode

Command History

Examples

This example shows how to clear aggregated Fibre Channel flow statistics for flow index 1:

switch(config)# clear fcflow stats aggregated index 1  

Related Commands

clear fcns statistics

To clear the name server statistics, use the clear fcns statistics command.

clear fcns statistics vsan vsan-id

Syntax Description

Command Default

None

Command Modes

EXEC mode

Command History

Examples

This example shows how to clear the name server statistics:

switch# clear fcns statistics vsan 1  

Related Commands

clear fcsm log

To clear the Fibre Channel Signal Modeling (FCSM) log, use the clear fcsm log command.

clear fcsm log

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Examples

This example shows how to clear the FSCM log:

switch# clear fcsm log  

Related Commands

clear fcs statistics

To clear the fabric configuration server statistics, use the clear fcs statistics command.

clear fcs statistics vsan vsan-id

Syntax Description

Command Default

None

Command Modes

EXEC mode

Command History

Examples

This example shows how to clear the fabric configuration server statistics for VSAN 10:

switch# clear fcs statistics vsan 10  

Related Commands

clear fctimer session

To clear fctimer Cisco Fabric Services (CFS) session configuration and locks, use the clear fctimer session command.

clear fctimer session

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC mode

Command History

Examples

This example shows how to clear an fctimer session:

switch# clear fctimer session  

Related Commands

clear fspf counters

To clear the Fabric Shortest Path First (FSPF) statistics, use the clear fspf counters command.

clear fspf counters vsan vsan-id [interface type]

Syntax Description

Command Default

None

Command Modes

EXEC mode

Command History

Usage Guidelines

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.

Examples

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  

Related Commands

clear fc-port-security

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

Syntax Description

Command Default

None

Command Modes

EXEC mode

Command History

Usage Guidelines

The active database is read-only and the clear fc-port-security database command can be used when resolving conflicts.

Examples

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  

Related Commands

clear rlir

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}

Syntax Description

Command Default

None

Command Modes

EXEC mode

Command History

Examples

This example shows how to clear the RLIR statistics for VSAN 1:

switch# clear rlir statistics vsan 1  

Related Commands

clear rscn session

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

Syntax Description

Command Default

None

Command Modes

EXEC mode

Command History

Examples

This example shows how to clear an RSCN session on VSAN 1:

switch# clear rscn session vsan 1  

Related Commands

clear rscn statistics

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

Syntax Description

Command Default

None

Command Modes

EXEC mode

Command History

Examples

This example shows how to clear the RSCN statistics for VSAN 1:

switch# clear rscn statistics vsan 1  

Related Commands

clear zone

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

Syntax Description

Command Default

None

Command Modes

EXEC mode

Command History

Usage Guidelines

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.

Examples

This example shows how to clear all configured information in the zone server for VSAN 1:

switch# clear zone database vsan 1  

Related Commands

device-alias abort

To discard a Distributed Device Alias Services (device alias) Cisco Fabric Services (CFS) distribution session in progress, use the device-alias abort command.

device-alias abort

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Global configuration mode

Command History

Examples

This example shows how to discard a device alias CFS distribution session in progress:

switch(config)# device-alias abort  

Related Commands

device-alias commit

To apply the pending configuration pertaining to the Distributed Device Alias Services (device alias) Cisco Fabric Services (CFS) distribution session in progress in the fabric, use the device-alias commit command.

device-alias commit

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Global configuration mode

Command History

Examples

This example shows how to commit pending changes to the active Dynamic Port VSAN Membership (DPVM) database:

switch(config)# device-alias commit  

Related Commands

device-alias database

To initiate a Distributed Device Alias Services (device alias) session and configure the device alias database, use the device-alias database command. To deactivate the device alias database, use the no form of this command.

device-alias database

no device-alias database

Syntax Description

This command has no arguments or keywords.

Command Default

Deactivated

Command Modes

Global configuration mode

Command History

Usage Guidelines

The device-alias database command starts a device alias session that locks all the databases on all the switches in this fabrics. When you exit device alias database configuration mode, the device alias session ends and the locks are released.

You can only perform all modifications in the temporary device alias database. To make the changes permanent, use the device-alias commit command.

Examples

This example shows how to activate a device alias session and enter device alias database configuration mode:

switch(config)# device-alias database  
switch(config-device-alias-db)#  

Related Commands

device-alias distribute

To enable Cisco Fabric Services (CFS) distribution for Distributed Device Alias Services (device alias), use the device-alias distribute command. To disable this feature, use the no form of this command.

device-alias distribute

no device-alias distribute

Syntax Description

This command has no arguments or keywords.

Command Default

Enabled

Command Modes

Global configuration mode

Command History

Usage Guidelines

Use the device-alias commit command to apply pending changes to the CFS distribution session.

Examples

This example shows how to enable distribution for device alias information:

switch(config)# device-alias distribute  

Related Commands

device-alias import fcalias

To import device alias database information from another Virtual SAN (VSAN), use the device-alias import fcalias command. To revert to the default configuration or factory defaults, use the no form of this command.

device-alias import fcalias vsan vsan-id

no device-alias import fcalias vsan vsan-id

Syntax Description

Command Default

None

Command Modes

Global configuration mode

Command History

Usage Guidelines

You can import legacy device name configurations using this feature without losing data, if they satisfy the following restrictions:

•Each fcalias has only one member.

•The member type is supported by the device name implementation.

If any name conflict exists, the fcaliases are not imported. The device name database is completely independent from the VSAN dependent fcalias database.

When the import operation is complete, the modified global fcalias table can distribute to all other switches in the physical fabric using the device-alias distribute command so that new definitions are available everywhere.

Examples

This example shows how to import device alias information:

switch(config)# device-alias import fcalias vsan 10  

Related Commands

device-alias mode

To configure device alias enhanced mode, use the device-alias mode command. To remove device alias enhanced mode, use the no form of this command.

device-alias mode enhanced

no device-alias mode enhanced

Syntax Description

Command Default

None

Command Modes

Global configuration mode

Command History

Examples

This example shows how to configure the device alias enhanced mode:

switch(config)# device-alias mode enhanced  

Related Commands

device-alias name

To configure device names in the device alias database, use the device-alias name command. To remove device names from the device alias database, use the no form of this command.

device-alias name device-name pwwn pwwn-id

no device-alias name device-name

Syntax Description

Command Default

None

Command Modes

Device alias database configuration mode

Command History

Examples

This example shows how to configure a device name alias entry in the device name database:

switch(config)# device-alias database  
switch(config-device-alias-db)# device-alias name Device1 pwwn 21:00:00:20:37:6f:db:bb  

Related Commands

device-alias rename

To configure device names in the device alias database, use the device-alias rename command. To remove device names from the device alias database, use the no form of this command.

device-alias rename device-name1 device-name2

no device-alias rename device-name

Syntax Description

Command Default

None

Command Modes

Device alias database configuration mode

Command History

Examples

This example shows how to configure a device name alias entry in the device name database:

switch(config)# device-alias database  
switch(config-device-alias-db)# device-alias rename Device1 Device2  

Related Commands

discover custom-list

To selectively initiate discovery for specified domain IDs in a Virtual SAN (VSAN), use the discover custom-list command.

discover custom-list {add | delete} vsan vsan-id domain domain-id

Syntax Description

Command Default

None

Command Modes

EXEC mode

Command History

Examples

This example shows how to selectively initiate the discovery for the specified VSAN and domain ID:

switch# discover custom-list add vsan 1 domain 2 

This example shows how to delete the specified VSAN and domain ID from the customized list:

switch# discover custom-list delete vsan 1 domain 2 

discover scsi-target

To discover SCSI targets on local storage to the switch or remote storage across the fabric, use the discover scsi-target command.

discover scsi-target {custom-list | local | remote | vsan vsan-id fcid fc-id} os {aix | all | hpux | linux | solaris | windows} [lun | target]

Syntax Description

Command Default

None

Command Modes

EXEC mode

Command History

Examples

This example shows how to discover local targets assigned to all OSs:

switch# discover scsi-target local os all 

discovery started

This example shows how to discover remote targets assigned to the Windows OS:

switch# discover scsi-target remote os windows

discovery started

This example shows how to discover SCSI targets for the specified VSAN (1) and FCID (0x9c03d6):

switch# discover scsi-target vsan 1 fcid 0x9c03d6 os aix

discover scsi-target vsan 1 fcid 0x9c03d6

VSAN:    1 FCID: 0x9c03d6 PWWN: 00:00:00:00:00:00:00:00

  PRLI RSP: 0x01 SPARM: 0x0012...

This example begins discovering targets from a customized list assigned to the Linux operating system:

switch# discover scsi-target custom-list os linux

discovery started

fabric profile

To utilize a preset quality of service (QoS) setting, use the fabric profile command. To restore the default, use the no form of this command.

fabric profile {reliable-multicast | unicast-optimized}

no fabric profile

Syntax Description

Command Default

Unicast-optimized

Command Modes

Global configuration mode

Command History

Examples

This example shows how to set the fabric to ensure reliable delivery of multicast traffic:

switch(config)# fabric profile reliable-multicast 

This example shows how to set the fabric profile to the default value:

switch(config)# no fabric profile 

Related Commands

fabric-binding activate

To activate fabric binding in a Virtual SAN (VSAN), use the fabric-binding activate command. To disable this feature, use the no form of this command.

fabric-binding activate vsan vsan-id [force]

no fabric-binding activate vsan vsan-id

Syntax Description

Command Default

Disabled

Command Modes

Global configuration mode

Command History

Examples

This example shows how to activate the fabric binding database for the specified VSAN:

switch(config)# fabric-binding activate vsan 1 

This example shows how to deactivate the fabric binding database for the specified VSAN:

switch(config)# no fabric-binding activate vsan 10 

This example shows how to forcefully activate the fabric binding database for the specified VSAN:

switch(config)# fabric-binding activate vsan 3 force 

This example shows how to revert to the previously configured state or to the factory default (if no state is configured):

switch(config)# no fabric-binding activate vsan 1 force 

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.

fabric-binding database copy vsan vsan-id

Syntax Description

Command Default

None

Command Modes

EXEC mode

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

This example shows how to copy from the active database to the configuration database in VSAN 1:

switch# fabric-binding database copy vsan 1

Related Commands

fabric-binding database diff

To view the differences between the active database and the configuration database in a Virtual SAN (VSAN), use the fabric-binding database diff command.

fabric-binding database diff {active | config} vsan vsan-id

Syntax Description

Command Default

None

Command Modes

EXEC mode

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

This example shows how to display the differences between the active database and the configuration database in VSAN 1:

switch# fabric-binding database diff active vsan 1

This example shows how to display information about the differences between the configuration database and the active database:

switch# fabric-binding database diff config vsan 1

Related Commands

fabric-binding database vsan

To configure a user-specified fabric binding list in a Virtual SAN (VSAN), use the fabric-binding database vsan command. To disable the fabric binding, use the no form of this command.

fabric-binding database vsan vsan-id
swwn switch-wwn domain domain-id

fabric-binding database vsan vsan-id
no swwn switch-wwn domain domain-id

no fabric-binding database vsan vsan-id

Syntax Description

Command Default

None

Command Modes

Global configuration mode

Command History

Usage Guidelines

Fabric binding is configured on a per-VSAN basis. In a Fibre Channel VSAN, only the switch world wide name (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.

Examples

This example shows how to enter the fabric binding database mode and adds the sWWN and domain ID of a switch to the configured database list:

switch(config)# fabric-binding database vsan 5

switch(config-fabric-binding)# swwn 21:00:05:30:23:11:11:11 domain 102 

This example shows how to delete a fabric binding database for the specified VSAN:

switch(config)# no fabric-binding database vsan 10 

This example shows how to delete the sWWN and domain ID of a switch from the configured database list:

switch(config)# fabric-binding database vsan 5

switch(config-fabric-binding)# no swwn 21:00:15:30:23:1a:11:03 domain 101

Related Commands

fabric-binding enable

To enable fabric binding in a Virtual SAN (VSAN), use the fabric-binding enable command. To disable fabric binding, use the no form of this command.

fabric-binding enable

no fabric-binding enable

Syntax Description

This command has no arguments or keywords.

Command Default

Disabled

Command Modes

Global configuration mode

Command History

Usage Guidelines

Fabric binding is configured on a per-VSAN basis.

The fabric binding feature must be enabled in each switch in the fabric that participates in the fabric binding.

Examples

This example shows how to enable fabric binding on that switch:

switch(config)# fabric-binding enable 

This example shows how to disable fabric binding on that switch:

switch(config)# no fabric-binding enable

Related Commands

fc-port-security

To configure port security features and reject intrusion attempts, use the fc-port-security command. To negate the command or revert to the factory defaults, use the no form of this command.

fc-port-security {activate vsan vsan-id [force | no-auto-learn] | auto-learn vsan vsan-id | database vsan vsan-id}

no fc-port-security {activate vsan vsan-id [force | no-auto-learn] | auto-learn vsan vsan-id | database vsan vsan-id}

Syntax Description

Command Default

Disabled

Command Modes

Global configuration mode

Command History

Usage Guidelines

When you activate the port security feature, the auto-learn option is also automatically enabled. You can choose to activate the fc-port-security feature and disable auto-learning by using the fc-port-security activate vsan number no-auto-learn command. In this case, you need to manually populate the port security database by individually securing each port.

If the auto-learn option is enabled on a VSAN, you cannot activate the database for that VSAN without the force option.

Examples

This example shows how to activate the port security database for the specified VSAN and automatically enable auto-learning:

switch(config)# fc-port-security activate vsan 1  

This example shows how to deactivate the port security database for the specified VSAN and automatically disable auto-learning:

switch(config)# no fc-port-security activate vsan 1 

This example shows how to disable the auto-learning feature for the port security database in VSAN 1:

switch(config)# fc-port-security activate vsan 1 no-auto-learn 

This example shows how to enable auto-learning so the switch can learn about any device that is allowed to access VSAN 1. These devices are logged in the port security active database.

switch(config)# fc-port-security auto-learn vsan 1 

This example shows how to disable auto-learning and stops the switch from learning about new devices accessing the switch:

switch(config)# no fc-port-security auto-learn vsan 1 

This example shows how to enter the port security database mode for the specified VSAN:

switch(config)# fc-port-security database vsan 1 
switch(config-fc-port-security)# 

This example shows how to force the VSAN 1 port security database to activate even if there are conflicts:

switch(config)# fc-port-security activate vsan 1 force 

Related Commands

fc-port-security abort

To discard the port security Cisco Fabric Services (CFS) distribution session in progress, use the fc-port-security abort command.

fc-port-security abort vsan vsan-id

Syntax Description

Command Default

None

Command Modes

Global configuration mode

Command History

Examples

This example shows how to discard a port security CFS distribution session in progress:

switch(config)# fc-port-security abort vsan 33 

Related Commands

fc-port-security commit

To apply the pending configuration pertaining to the port security Cisco Fabric Services (CFS) distribution session in progress in the fabric, use the fc-port-security commit command.

fc-port-security commit vsan vsan-id

Syntax Description

Command Default

None

Command Modes

Global configuration mode

Command History

Examples

This example shows how to commit changes to the active port security configuration:

switch(config)# fc-port-security commit vsan 13 

Related Commands

fc-port-security database

To copy the port security database or to view the difference within the port security database, use the fc-port-security database command.

fc-port-security database {copy | diff {active | config}} vsan vsan-id

Syntax Description

Command Default

None

Command Modes

EXEC mode

Command History

Usage Guidelines

If the active database is empty, the fc-port-security database is empty. Use the fc-port-security database diff active command to resolve conflicts.

Examples

This example shows how to copy the active database to the configured database:

switch# fc-port-security database copy vsan 1 

This example shows how to provide the differences between the active database and the configuration database:

switch# fc-port-security database diff active vsan 1 

This example shows how to provide information on the differences between the configuration database and the active database:

switch# fc-port-security database diff config vsan 1 

Related Commands

fc-port-security distribute

To enable Cisco Fabric Services (CFS) distribution for port security, use the fc-port-security distribute command. To disable this feature, use the no form of this command.

fc-port-security distribute

no fc-port-security distribute

Syntax Description

This command has no arguments or keywords.

Command Default

Disabled

Command Modes

Global configuration mode

Command History

Usage Guidelines

Before distributing the Fibre Channel timer changes to the fabric, the temporary changes to the configuration must be committed to the active configuration by using the fc-port-security commit command.

Examples

This example shows how to distribute the port security configuration to the fabric:

switch(config)# fc-port-security distribute 

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

Command Default

None

Command Modes

Global configuration mode

Command History

Usage Guidelines

To disable a Fibre Channel alias, use the no form of the fcalias name command.

Examples

This example shows how to clone a fcalias called origAlias to cloneAlias on VSAN 45:

switch(config)# fcalias clone origAlias cloneAlias vsan 45

Related Commands

fcalias name

To configure a Fibre Channel alias, use the fcalias name command. To disable a Fibre Channel alias, use the no form of this command.

fcalias name alias-name vsan vsan-id

no fcalias name alias-name vsan vsan-id

Syntax Description

Command Default

None

Command Modes

Global configuration mode

Command History

Usage Guidelines

To include multiple members in any alias, use the FCID, fWWN, or pWWN values.

Examples

This example shows how to configure an fcalias called AliasSample on VSAN 3:

switch(config)# fcalias name AliasSample vsan 3

switch(config-fcalias)# 

Related Commands

fcalias rename

To rename a Fibre Channel alias (fcalias), use the fcalias rename command. To revert to the defaults, use the no form of this command.

fcalias rename current-name new-name vsan vsan-id

no fcalias rename current-name new-name vsan vsan-id

Syntax Description

Command Default

None

Command Modes

Global configuration mode

Command History

Examples

This example shows how to rename an fcalias:

switch(config)# fcalias rename oldalias newalias vsan 10

Related Commands

fcdomain

To configure the Fibre Channel domain feature, use the fcdomain command. To disable the Fibre Channel domain, use the no form of this command.

fcdomain {allowed domain vsan vsan-id | auto-reconfigure vsan vsan-id | contiguous-allocation vsan vsan-id | domain id {preferred | static} vsan vsan-id | fabric-name name vsan vsan-id | fcid {database | persistent vsan vsan-id} | optimize fast-restart vsan vsan-id | priority value vsan vsan-id | restart [disruptive] vsan vsan-id | vsan vsan-id}

no fcdomain {allowed domain vsan vsan-id | auto-reconfigure vsan vsan-id | contiguous-allocation vsan vsan-id | domain id {preferred | static} vsan vsan-id | fabric-name name vsan vsan-id | fcid {database | persistent vsan vsan-id} | optimize fast-restart vsan vsan-id | priority value vsan vsan-id | restart [disruptive] vsan vsan-id | vsan vsan-id}

Syntax Description

Command Default

Enabled

Command Modes

Global configuration mode

Command History

Usage Guidelines

You can use this command to select the principal switch, configure domain ID distribution, reconfigure the fabric, and allocate FC IDs.

We recommend using the optimize fast-restart option on most fabrics, especially those with a large number of logical ports (3200 or more), where a logical port is an instance of a physical port in a VSAN.

Examples

This example shows how to configure a preferred domain ID for VSAN 87:

switch(config)# fcdomain domain 3 preferred vsan 87

This example shows how to specify the disruptive fabric reconfiguration for VSAN 1:

switch(config)# fcdomain restart disruptive vsan 1

This example shows how to enable the domain manager fast restart for VSANs 7 through 10:

switch(config)# fcdomain optimize fast-restart vsan 7 - 10

This example shows how to configure the fabric world wide name (fWWN) for VSAN 3:

switch(config)# fcdomain fabric-name 20:1:ac:16:5e:0:21:01 vsan 3

Related Commands

fcdomain abort vsan

To flush cached data without committing the cached data and release the lock, use the fcdomain abort vsan command. To disable the flushing of cached data, use the no form of this command.

fcdomain abort vsan vsan-id

no fcdomain abort vsan vsan-id

Syntax Description

Command Default

Enabled

Command Modes

Global configuration mode

Command History

Examples

This example shows how to flush cached data:

switch(config)# fcdomain abort vsan 10 

Related Commands

fcdomain commit vsan

To commit cached data and release the lock, use the fcdomain commit vsan command. To release the lock without committing the cached data, use the no form of this command.

fcdomain commit vsan vsan-id

no fcdomain commit vsan vsan-id

Syntax Description

Command Default

Enabled

Command Modes

Global configuration mode

Command History

Examples

This example shows how to commit cached data:

switch(config)# fcdomain commit vsan 10

Related Commands

fcdomain distribute

To enable fabric distribution using Cisco Fabric Services (CFS), use the fcdomain distribute command. To disable fabric distribution using CFS, use the no form of this command.

fcdomain distribute

no fcdomain distribute

Syntax Description

This command has no arguments or keywords.

Command Default

Disabled

Command Modes

Global configuration mode

Command History

Examples

This example shows how to enable the fabric distribution using CFS:

switch(config)# fcdomain distribute 

This example shows how to disable the fabric distribution using CFS:

switch(config)# no fcdomain distribute 

Related Commands

fcdomain rcf-reject

To enable the reconfigure fabric (RCF) rejection flag for a Fibre Channel interface, use the fcdomain rcf-reject command. To disable this feature, use the no form of this command.

fcdomain rcf-reject vsan vsan-id

no fcdomain rcf-reject vsan vsan-id

Syntax Description

Command Default

Enabled

Command Modes

Interface configuration mode

Command History

Usage Guidelines

Use this option to configure the RCF reject option for the selected Fibre Channel or virtual Fibre Channel interface.

Examples

This example shows how to configure the FCIP RCF reject fcdomain feature on a virtual Fibre Channel interface:

switch(config)# interface vfc 3

switch(config-if)# fcdomain rcf-reject vsan 1 

Related Commands

fcdroplatency

To configure the network and switch Fibre Channel drop latency time, use the fcdroplatency command. To disable the Fibre Channel latency time, use the no form of this command.

fcdroplatency {network milliseconds [vsan vsan-id] | switch milliseconds}

no fcdroplatency {network milliseconds [vsan vsan-id] | switch milliseconds}

Syntax Description

Command Default

2000 millisecond network latency

500 millisecond switch latency

Command Modes

Global configuration mode

Command History

Examples

This example shows how to configure the network latency to 5000 milliseconds:

switch(config)# fcdroplatency network 5000

This example shows how to revert to the default switch latency:

switch(config)# no fcdroplatency switch 4000 

Related Commands

fcflow stats

To configure fcflow statistics, use the fcflow stats command. To disable the counter, use the no form of this command.

fcflow stats {aggregated index flow-number vsan vsan-id | index flow-number destination-fcid source-fcid netmask vsan vsan-id}

no fcflow stats {aggregated index flow-number | index flow-number}

Syntax Description

Command Default

None

Command Modes

Global configuration mode

Command History

Usage Guidelines

If you enable flow counters, you can enable a maximum of 1024 entries for aggregate flow and flow statistics. Be sure to assign an unused flow index for each new flow. The number space for the flow index is shared between the aggregate flow statistics and the flow statistics.

Examples

This example shows how to enable the aggregated flow counter:

switch(config)# fcflow stats aggregated index 1005 vsan 1 

This example shows how to disable the aggregated flow counter:

switch(config)# no fcflow stats aggregated index 1005 

This example shows how to enable the flow counter for a specific flow:

switch(config)# fcflow stats index 1 0x145601 0x5601 0xffffff vsan 1 

This example shows how to disable the flow counter for index 1001:

switch(config)# no fcflow stats index 1001 

Related Commands

fcid-allocation

To manually add a FCID to the default area company ID list, use the fcid-allocation command. To remove a FCID from the default area company ID list, use the no form of this command.

fcid-allocation area company-id company-id

no fcid-allocation area company-id company-id

Syntax Description

Command Default

None

Command Modes

Global configuration mode

Command History

Usage Guidelines

Fibre Channel standards require a unique FCID to be allocated to an N port attached to a Fx port in any switch. To conserve the number of FCIDs used, Cisco Nexus 5000 Series switches use a special allocation scheme.

Some Host Bust Adaptors (HBAs) do not discover targets that have FC IDs with the same domain and area. The switch software maintains a list of tested company IDs that do not exhibit this behavior. These HBAs were allocated with single FC IDs, and for others a full area was allocated.

To allow further scalability for switches with numerous ports, the switch software maintains a list of HBAs that exhibit this behavior. Each HBA is identified by its company ID (also known as an Organizational Unique Identifier, or OUI) used in the pWWN during a fabric login. A full area is allocated to the N ports with company IDs that are listed and for the others, a single FC ID is allocated. Regardless of the type (whole area or single) of FC ID allocated, the FC ID entries remain persistent.

Examples

This example shows how to add a new company ID to the default area company ID list:

switch(config)# fcid allocation area company-id 0x003223

fcinterop fcid-allocation

To allocate FCIDs on the switch, use the fcinterop fcid-allocation command. To disable FCIDs on the switch, use the no form of this command.

fcinterop fcid-allocation {auto | flat | none}

no fcinterop fcid-allocation {auto | flat | none}

Syntax Description

Command Default

The default is automatic allocation of FCIDs.

Command Modes

Global configuration mode

Command History

Usage Guidelines

This command defines how the switch assigns FCIDs.

Examples

This example shows how to set the FCID allocation to flat:

switch(config)# fcinterop fcid-allocation flat 

Related Commands

fcns no-auto-poll

To enable or disable automatic polling in the name server database, use the fcns no-auto-poll command.

fcns no-auto-poll [vsan vsan-id] | [wwn wwn-id]

no fcns no-auto-poll [vsan vsan-id] | [wwn wwn-id]

Syntax Description

Command Default

None

Command Modes

Global configuration mode

Command History

Examples

This example shows how to disable automatic polling for VSAN 2:

switch(config)# fcns no-auto-poll vsan 2

Related Commands

fcns proxy-port

To register a name server proxy, use the fcns proxy-port command.

fcns proxy-port wwn-id vsan vsan-id

no fcns proxy-port wwn-id vsan vsan-id

Syntax Description

Command Default

None

Command Modes

Global configuration mode

Command History

Usage Guidelines

One name server can be configured to proxy another name server, and the name server information can be displayed using the CLI. The name server can be viewed using the CLI or the Cisco Fabric Manager.

All name server registration requests come from the same port whose parameter is registered or changed. If it does not, then the request is rejected.

Examples

This example shows how to configure a proxy port for VSAN 2:

switch(config)# fcns proxy-port 21:00:00:e0:8b:00:26:d vsan 2

Related Commands

fcns reject-duplicate-pwwn vsan

To reject duplicate Fibre Channel name server (FCNS) proxies on a Virtual SAN (VSAN), use the fcns reject-duplicate-pwwn vsan command.

fcns reject-duplicate-pwwn vsan vsan-id

no fcns reject-duplicate-pwwn vsan vsan-id

Syntax Description

Command Default

Disabled

Command Modes

Global configuration mode

Command History

Examples

This example shows how to reject duplicate FCNS pWWNs for VSAN 2:

switch(config)# fcns reject-duplicate-pwwn vsan 2 

Related Commands

fcoe fcf-priority

To configure the 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.

fcoe fcf-priority value

no fcoe fcf-priority value

Syntax Description

Command Default

128

Command Modes

Global configuration mode

Interface vFC mode

Command History

Usage Guidelines

Before you use this command, you must enable FCoE on the switch by using the feature fcoe command.

The Cisco Nexus 5000 Series 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.

Examples

This example shows how to configure the FCF priority on the switch:

switch(config)# fcoe fcf-priority 50 

switch(config)# 

Related Commands

fcoe fcmap

To configure the 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.

fcoe fcmap value

no fcoe fcmap value

Syntax Description

Command Default

0xefc00

Command Modes

Global configuration mode

Command History

Usage Guidelines

Before you use this command, you must enable FCoE on the switch by using the feature 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 Cisco Nexus 5000 Series switch. When the FC-Map is configured, the switch discards the MAC addresses that are not part of the current fabric.

This command requires a license.

Examples

This example shows how to configure the FC-Map value on the switch:

switch(config)# fcoe fcmap 0xefc10 

switch(config)# 

Related Commands

fcoe fka-adv-period

To configure the time interval at which FIP keep alive (FKA) messages are transmitted to the MAC address of the FCoE node (ENode), use the fcoe fka-adv-period command. To revert to the default value of 128 seconds, use the no form of this command.

fcoe fka-adv-period value

no fcoe fka-adv-period value

Syntax Description

Command Default

8 seconds

Command Modes

Global configuration mode

Command History

Usage Guidelines

Before you use this command, FCoE must be enabled on the switch, using the feature fcoe command.

Examples

This example shows how to configure the FKA advertisement period for the switch to 5 seconds:

switch(config)# fcoe fka-adv-period 5 

switch(config)# 

Related Commands

fcoe vsan

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.

fcoe [vsan vsan_ID]

no fcoe [vsan vsan_ID]

Syntax Description

Command Default

None

Command Modes

Vlan configuration mode.

Command History

Usage Guidelines

Before you map the FCoE VLAN to the VSAN, make sure that you create a VSAN using the vsan command in the Vsan 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 a 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:

vlan 30:another FCOE VLAN mapping exists using the requested VSAN

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.

Examples

This example shows how to map a FCoE VLAN to a VSAN:

switch(config)# vlan 30 

switch(config-vlan)# fcoe vsan 337 

switch(config-vlan)# 

Related Commands

fcping

To ping an N port, use the fcping command.

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

Command Default

None

Command Modes

EXEC mode

Command History

Usage Guidelines

To obtain the domain controller ID, concatenate the domain ID with FFFC. For example, if the domain ID is 0xda(218), the concatenated ID is 0xfffcda.

Examples

This example shows how to configure an fcping operation for the FCID of the destination. By default, five frames are sent.

switch# fcping fcid 0xd70000 vsan 1 

This example shows how to configure the number of frames to be sent using the count option. The range is from 0 through 2147483647. A value of 0 will ping forever.

switch# fcping fcid 0xd70000 vsan 1 count 10

This example shows how to configure the timeout value:

switch# fcping fcid 0xd500b4 vsan 1 timeout 10

This example shows how to display the fcping operation using the device alias of the specified destination:

switch# fcping device-alias x vsan 1 

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 this command.