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 available on Cisco Nexus 5000 Series switches.
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:4754Distribution 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 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. |
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
This command has no arguments or keywords.
None
Global configuration mode
|
|
Release 4.0 |
This command was introduced. |
This example shows how to discard a device alias CFS distribution session in progress:
switch(config)# device-alias abort
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
This command has no arguments or keywords.
None
Global configuration mode
|
|
Release 4.0 |
This command was introduced. |
This example shows how to commit pending changes to the active Dynamic Port VSAN Membership (DPVM) database:
switch(config)# device-alias commit
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
This command has no arguments or keywords.
Deactivated
Global configuration mode
|
|
Release 4.0 |
This command was introduced. |
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.
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)#
|
|
---|---|
device-alias commit |
Commits changes from the temporary device alias database to the active device alias database. |
show device-alias |
Displays device alias database information. |
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
This command has no arguments or keywords.
Enabled
Global configuration mode
|
|
Release 4.0 |
This command was introduced. |
Use the device-alias commit command to apply pending changes to the CFS distribution session.
This example shows how to enable distribution for device alias information:
switch(config)# device-alias distribute
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
vsan vsan-id |
Specifies the VSAN ID. The range is from 1 to 4093. |
None
Global configuration mode
|
|
Release 4.0 |
This command was introduced. |
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.
This example shows how to import device alias information:
switch(config)# device-alias import fcalias vsan 10
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
enhanced |
Specifies enhanced mode. |
None
Global configuration mode
|
|
Release 4.0 |
This command was introduced. |
This example shows how to configure the device alias enhanced mode:
switch(config)# device-alias mode enhanced
|
|
---|---|
device-alias database |
Enters device alias database configuration mode. |
show device-alias |
Displays device alias database information. |
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
device-name |
Device name. The name can be a maximum of 64 characters. |
pwwn pwwn-id |
Specifies the pWWN ID. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal number. |
None
Device alias database configuration mode
|
|
Release 4.0 |
This command was introduced. |
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
|
|
---|---|
device-alias database |
Enters device alias database configuration mode. |
show device-alias |
Displays device alias database information. |
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
device-name1 |
Current device name. |
device-name2 |
New device name. The maximum length is 64 characters. |
None
Device alias database configuration mode
|
|
Release 4.0 |
This command was introduced. |
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
|
|
---|---|
device-alias database |
Enters device alias database configuration mode. |
show device-alias |
Displays device alias database information. |
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
None
EXEC mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
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
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]
None
EXEC mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
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
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
reliable-multicast |
Optimizes the QoS parameters in the fabric to ensure reliable delivery of multicast traffic. |
unicast-optimized |
Optimizes the QoS parameters in the fabric for unicast traffic. |
Unicast-optimized
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
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
|
|
---|---|
show fabric profile |
Displays the current setting of the fabric. |
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
vsan vsan-id |
Specifies the VSAN. The ID of the VSAN is from 1 to 4093. |
force |
(Optional) Forces fabric binding activation. |
Disabled
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
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
|
|
---|---|
fabric-binding database |
Configures a fabric-binding database. |
fabric-binding enable |
Enables fabric-binding. |
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
vsan vsan-id |
Specifies the Virtual SAN (VSAN). The ID of the VSAN is from 1 to 4093. |
None
EXEC mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
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.
This example shows how to copy from the active database to the configuration database in VSAN 1:
switch# fabric-binding database copy vsan 1
|
|
---|---|
fabric-binding diff |
Provides the differences between the fabric-binding databases. |
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
None
EXEC mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
Fabric binding is configured on a per-VSAN basis and can be implemented in both FICON VSANs and Fibre Channel VSANs.
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
|
|
---|---|
fabric-binding copy |
Copies from the active to the configuration fabric binding database. |
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
None
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
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.
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
|
|
---|---|
fabric-binding activate |
Activates fabric binding. |
fabric-binding enable |
Enables fabric binding. |
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
This command has no arguments or keywords.
Disabled
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
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.
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
|
|
---|---|
fabric-binding activate |
Activates fabric binding. |
fabric-binding database |
Configures a fabric-binding database. |
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}
Disabled
Global configuration mode
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.
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
|
|
---|---|
show fc-port-security database |
Displays configured port security information. |
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
vsan vsan-id |
Specifies the VSAN ID. The range is from 1 to 4093. |
None
Global configuration mode
This example shows how to discard a port security CFS distribution session in progress:
switch(config)# fc-port-security abort vsan 33
|
|
---|---|
fc-port-security distribute |
Enables CFS distribution for port security. |
show fc-port-security |
Displays port security information. |
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
vsan vsan-id |
Specifies the VSAN ID. The range is from 1 to 4093. |
None
Global configuration mode
This example shows how to commit changes to the active port security configuration:
switch(config)# fc-port-security commit vsan 13
|
|
---|---|
fc-port-security distribute |
Enables CFS distribution for port security. |
show fc-port-security |
Displays port security information. |
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
None
EXEC mode
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.
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
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
This command has no arguments or keywords.
Disabled
Global configuration mode
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.
This example shows how to distribute the port security configuration to the fabric:
switch(config)# fc-port-security distribute
|
|
---|---|
fc-port-security commit |
Commits the port security configuration changes to the active configuration. |
show fc-port-security |
Displays port security information. |
To clone a Fibre Channel alias, use the fcalias clone command.
fcalias clone origFcalias-Name cloneFcalias-Name vsan vsan-id
None
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
To disable a Fibre Channel alias, use the no form of the fcalias name command.
This example shows how to clone a fcalias called origAlias to cloneAlias on VSAN 45:
switch(config)# fcalias clone origAlias cloneAlias vsan 45
|
|
---|---|
show fcalias |
Displays the member name information in a Fibre Channel alias (fcalias). |
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
alias-name |
Name of the fcalias. The name can a maximum of 64 characters. |
vsan |
Specifies the fcalias for a Virtual SAN (VSAN). |
vsan-id |
VSAN ID. The range is from 1 to 4093. |
None
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
To include multiple members in any alias, use the FCID, fWWN, or pWWN values.
This example shows how to configure an fcalias called AliasSample on VSAN 3:
switch(config)# fcalias name AliasSample vsan 3
switch(config-fcalias)#
|
|
---|---|
member (fcalias configuration mode) |
Configures alias members for a specified zone. |
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
None
Global configuration mode
|
|
Release 4.0 |
This command was introduced. |
This example shows how to rename an fcalias:
switch(config)# fcalias rename oldalias newalias vsan 10
|
|
---|---|
fcalias name |
Configures fcalias names. |
show fcalias |
Displays fcalias information. |
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}
Enabled
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
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.
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
|
|
---|---|
show fcdomain |
Displays global information about the Fibre Channel domain configurations. |
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
vsan-id |
Virtual SAN (VSAN) ID. The range is from 1 to 4093. |
Enabled
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to flush cached data:
switch(config)# fcdomain abort vsan 10
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
vsan vsan-id |
Specifies a VSAN ID. The range is from 1 to 4093. |
Enabled
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to commit cached data:
switch(config)# fcdomain commit vsan 10
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
This command has no arguments or keywords.
Disabled
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
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
|
|
---|---|
fcdomain |
Configures Fibre Channel domain features. |
show fcdomain |
Displays global information about the Fibre Channel domain configurations. |
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
vsan vsan-id |
Specifies a Virtual SAN (VSAN) ID. The range is from 1 to 4093. |
Enabled
Interface configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
Use this option to configure the RCF reject option for the selected Fibre Channel or virtual Fibre Channel interface.
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
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}
2000 millisecond network latency
500 millisecond switch latency
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
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
|
|
---|---|
show fcdroplatency |
Displays the configured Fibre Channel drop latency parameters. |
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}
None
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
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.
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
|
|
---|---|
show fcflow stats |
Displays the configured Fibre Channel drop latency parameters. |
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
area |
Modifies the auto area list of company IDs. |
company-id company-id |
Configures the company IDs. |
None
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
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.
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
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}
auto |
Assigns a single FCID to compatible HBAs. |
flat |
Assign a single FCID. |
none |
Assigns an FCID range. |
The default is automatic allocation of FCIDs.
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
This command defines how the switch assigns FCIDs.
This example shows how to set the FCID allocation to flat:
switch(config)# fcinterop fcid-allocation flat
|
|
---|---|
show flogi database |
Displays the fabric login (FLOGI) table. |
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]
vsan vsan-id |
(Optional) Specifies a Virtual SAN (VSAN) ID. The range is from 1 to 4093. |
wwn wwn-id |
(Optional) Specifies the port WWN, with the format hh:hh:hh:hh:hh:hh:hh:hh. |
None
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to disable automatic polling for VSAN 2:
switch(config)# fcns no-auto-poll vsan 2
|
|
---|---|
show fcns |
Displays the name server database and statistical information for a specified VSAN or for all VSANs. |
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
wwn-id |
Port WWN, with the format hh:hh:hh:hh:hh:hh:hh:hh. |
vsan vsan-id |
Specifies a VSAN ID. The range is from 1 to 4093. |
None
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
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.
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
|
|
---|---|
show fcns |
Displays the name server database and statistical information for a specified VSAN or for all VSANs. |
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
vsan vsan-id |
Specifies a VSAN ID. The range is from 1 to 4093. |
Disabled
Global configuration mode
|
|
Release 4.0 |
This command was introduced. |
This example shows how to reject duplicate FCNS pWWNs for VSAN 2:
switch(config)# fcns reject-duplicate-pwwn vsan 2
|
|
---|---|
show fcns |
Displays the name server database and statistical information for a specified VSAN or for all VSANs. |
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
value |
FCF priority value. The range is from 0 to 255, and the default is 128. |
128
Global configuration mode
Interface vFC mode
|
|
---|---|
4.2(1)N1(1) |
This command was introduced. |
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.
This example shows how to configure the FCF priority on the switch:
switch(config)# fcoe fcf-priority 50
switch(config)#
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
value |
FC-Map value. The range is from 0xefc00 to 0xefcff, and the default is 0xefc00. |
0xefc00
Global configuration mode
|
|
---|---|
4.2(1)N1(1) |
This command was introduced. |
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.
This example shows how to configure the FC-Map value on the switch:
switch(config)# fcoe fcmap 0xefc10
switch(config)#
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
value |
FKA advertisement period (in seconds). The range is from 4 to 60 seconds, and the default is 8. |
8 seconds
Global configuration mode
|
|
---|---|
4.2(1)N1(1) |
This command was introduced. |
Before you use this command, FCoE must be enabled on the switch, using the feature fcoe command.
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)#
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]
vsan_ID |
VSAN ID. The range is from 1 to 4094. |
None
Vlan configuration mode.
|
|
---|---|
4.2(1)N1(1) |
This command was introduced. |
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.
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)#
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]]]
None
EXEC mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
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.
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
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.
fcroute {fcid [network-mask] interface {fc slot/port | san-port-channel port | vfc vfc-id} domain domain-id {metric number | remote | vsan vsan-id}}
no fcroute {fcid network-mask interface {fc slot/port | san-port-channel port | vfc vfc-id} domain domain-id {metric number | remote | vsan vsan-id}}
None
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
Use this command to assign forwarding information to the switch and to activate a preferred path route map.
This example shows how to specify the Fibre Channel interface and the route for the domain of the next hop switch for VSAN 2:
switch(config)# fcroute 0x111211 interface fc3/1 domain 3 vsan 2
This example shows how to specify the SAN port channel interface and the route for the domain of the next hop switch for VSAN 4:
switch(config)# fcroute 0x111211 interface san-port-channel 1 domain 3 vsan 4
This example shows how to specify the Fibre Channel interface, the route for the domain of the next hop switch, and the cost of the route for VSAN 1:
switch(config)# fcroute 0x031211 interface fc1/1 domain 3 metric 1 vsan 1
This example shows how to specify the Fibre Channel interface, the route for the domain of the next hop switch, the cost of the route, and configures the static route for a destination switch remotely connected for VSAN 3:
switch(config)# fcroute 0x111112 interface fc3/1 domain 3 metric 3 remote vsan 3
To enable Fabric Configuration Server (FCS) platform and node-name checking fabric wide, use the fcs plat-check-global command. To disable this feature, use the no form of this command.
fcs plat-check-global vsan vsan-id
no fcs plat-check-global vsan vsan-id
vsan vsan-id |
Specifies the VSAN ID for platform checking, which is from 1 to 4096. |
None
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to enable FCS platform and node-name checking fabric wide:
switch(config)# fcs plat-check-global vsan 2
|
|
---|---|
show fcs |
Displays fabric configuration server information. |
To register Fabric Configuration Server (FCS) attributes, use the fcs register command. To disable this feature, use the no form of this command.
fcs register
no fcs register
This command has no arguments or keywords.
None
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to register FCS attributes:
switch(config)# fcs register
|
|
---|---|
show fcs |
Displays fabric configuration server information. |
To include a virtual device in a query about zone information from an FCS, use the fcs virtual-device-add command. To remove a virtual device, use the no form of this command.
fcs virtual-device-add [vsan-ranges vsan-ids]
no fcs virtual-device-add [vsan-ranges vsan-ids]
vsan-ranges vsan-ids |
(Optional) Specifies one or multiple ranges of VSANs. The range is from 1 to 4093. |
Disabled
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
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.
This example shows how to add to one range of VSANs:
switch(config)# fcs virtual-device-add vsan-ranges 2-4
This example shows how to add to more than one range of VSANs:
switch(config)# fcs virtual-device-add vsan-ranges 2-4,5-8
|
|
---|---|
show fcs |
Displays fabric configuration server information. |
To configure a Fibre Channel Security Protocol (FC-SP) authentication mode for a specific interface in a FC-SP-enabled switch, use the fcsp command. To disable an FC-SP on the interface, use the no form of this command.
fcsp {auto-active | auto-passive | on | off} [timeout-period]
no fcsp
Auto-passive mode
Interface configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
To use this command, FC-SP must be enabled using the feature fcsp command.
This example shows how to turn on the authentication mode for Fibre Channel interface in port 1 of slot 2:
switch(config)# interface fc 2/1
switch(config-if)# fcsp on
switch(config-if)#
This example shows how to revert to the factory default of auto-passive for the selected interface:
switch(config-if)# no fcsp
This example shows how to change the selected interface to initiate FC-SP authentication but does not permit reaunthentication:
switch(config-if)# fcsp auto-active 0
|
|
---|---|
feature fcsp |
Enables FC-SP. |
show interface |
Displays an interface configuration for a specified interface. |
To configure DHCHAP options in a switch, use the fcsp dhchap command. To revert to the factory defaults, use the no form of this command.
fcsp dhchap {devicename switch-wwn password [0 | 7] password |
dhgroup [0] [1][2][3][4] | hash [md5 | sha1] | password [0 | 7] password [wwn wwn-id]}
no fcsp dhchap {devicename switch-wwn password [0 | 7] password |
dhgroup [0 | 1| 2 | 3 | 4] | hash [md5] [sha1] | password [0 | 7] password [wwn-id]}
Disabled
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
You can only see the fcsp dhchap command if you enter the feature fcsp command.
Using SHA-1 as the hash algorithm may prevent RADIUS or TACACS+ usage.
If you change the DH group configuration, make sure that you change it globally for all switches in the fabric.
This example shows how to enable FC-SP:
switch(config)# # feature fcsp
This example shows how to configure the use of only the SHA-1 hash algorithm:
switch(config)# fcsp dhchap hash sha1
This example shows how to configure the use of only the MD-5 hash algorithm:
switch(config)# fcsp dhchap hash md5
This example shows how to define the use of the default hash algorithm priority list of MD-5 followed by SHA-1 for DHCHAP authentication:
switch(config)# fcsp dhchap hash md5 sha1
This example shows how to revert to the factory default priority list of the MD-5 hash algorithm followed by the SHA-1 hash algorithm:
switch(config)# no fcsp dhchap hash sha1
This example shows how to prioritize the use of DH group 2, 3, and 4 in the configured order:
switch(config)# fcsp dhchap dhgroup 2 3 4
This example shows how to configure a clear text password for the local switch:
switch(config)# fcsp dhchap password 0 mypassword
This example shows how to configure a clear text password for the local switch to be used for the device with the specified WWN:
switch(config)# fcsp dhchap password 0 mypassword 30:11:bb:cc:dd:33:11:22
This example shows how to configure a password entered in an encrypted format for the local switch:
switch(config)# fcsp dhchap password 7 sfsfdf
|
|
---|---|
feature fcsp |
Enables FC-SP. |
show fcsp |
Displays configured FC-SP information. |
To reauthenticate a Fibre Channel or virtual Fibre Channel interface, use the fcsp reauthenticate command. To revert to the factory defaults, use the no form of this command.
fcsp reauthenticate interface {fc slot/port | vfc vfc-id}
no fcsp reauthenticate interface {fc slot/port | vfc vfc-id}
30 seconds
EXEC mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to configure the Fibre Channel Security Protocol (FC-SP) reauthentication on a virtual Fibre Channel interface:
switch# fcsp reauthenticate vfc 1
|
|
---|---|
feature fcsp |
Enables FC-SP. |
show fcsp |
Displays configured FC-SP information. |
To configure the timeout value for a Fibre Channel Security Protocol (FC-SP) message, use the fcsp timeout command. To revert to the factory defaults, use the no form of this command.
fcsp timeout timeout-period
no fcsp timeout timeout-period
timeout-period |
Timeout period. The time range is from 20 to 100 seconds. |
30 seconds
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
You can only see the fcsp timeout command if you enable FC-SP by using the feature fcsp command.
This example shows how to configure the FCSP timeout value:
switch(config)# feature fcsp
switch(config)# fcsp timeout 60
|
|
---|---|
feature fcsp |
Enables FC-SP. |
show fcsp |
Displays configured FC-SP information. |
To change the default Fibre Channel timers, use the fctimer command. To revert to the default values, use the no form of this command.
fctimer {d_s_tov milliseconds | e_d_tov milliseconds | r_a_tov milliseconds} [vsan vsan-id]
no fctimer {d_s_tov milliseconds | e_d_tov milliseconds | r_a_tov milliseconds} [vsan vsan-id]
The Fibre Channel timers have the following default values:
•30 seconds for DS_TOV.
•2 seconds for ED_TOV.
•10 seconds for RA_TOV.
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
The Cisco, 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 in the fabric.
Use the vsan option to configure different TOV values for specific VSANs.
This example shows how to change the default Fibre Channel timers:
switch(config)# fctimer e_d_tov 5000
switch(config)# fctimer r_a_tov 7000
|
|
---|---|
show fctimer |
Displays the configured Fibre Channel timer values. |
To discard a Fibre Channel timer (fctimer) Cisco Fabric Services (CFS) distribution session in progress, use the fctimer abort command.
fctimer abort
This command has no arguments or keywords.
None
Global configuration mode
|
|
Release 4.0 |
This command was introduced. |
This example shows how to discard a CFS distribution session in progress:
switch(config)# fctimer abort
|
|
---|---|
fctimer distribute |
Enables CFS distribution for the fctimer. |
show fctimer |
Displays fctimer information. |
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.
fctimer commit
This command has no arguments or keywords.
None
Global configuration mode
|
|
Release 4.0 |
This command was introduced. |
This example shows how to commit changes to the active Fibre Channel timer configuration:
switch(config)# fctimer commit
|
|
---|---|
fctimer distribute |
Enables CFS distribution for the fctimer. |
show fctimer |
Displays fctimer information. |
To enable Cisco Fabric Services (CFS) distribution for the Fibre Channel timer (fctimer), use the fctimer distribute command. To disable this feature, use the no form of this command.
fctimer distribute
no fctimer distribute
This command has no arguments or keywords.
Disabled
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
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.
This example shows how to change the default Fibre Channel timer:
switch(config)# fctimer distribute
|
|
---|---|
fctimer commit |
Commits the Fibre Channel timer configuration changes to the active configuration. |
show fctimer |
Displays fctimer information. |
To trace the route to an N port, use the fctrace command.
fctrace {device-alias aliasname | fcid fcid | pwwn pwwn-id} vsan vsan-id [timeout seconds]
By default, the period to wait before timing out is 5 seconds.
EXEC mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to trace a route to the specified FCID in VSAN 1:
switch# fctrace fcid 0x660000 vsan 1
This example shows how to trace a route to the specified device alias in VSAN 1:
switch# fctrace device-alias x vsan 1
To suppress Fabric-Device Management Interface (FDMI) updates, use the fdmi suppress-updates command.
fdmi suppress-updates vsan vsan-id
vsan vsan-id |
Specifies a VSAN ID. The range is from 1 to 4093. |
By default, FDMI updates are not suppressed.
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to suppress the FDMI updates in VSAN 1:
switch# fdmi suppress-updates vsan 1
To enable port security, use the feature fc-port-security command. To disable port security, use the no form of this command.
feature fc-port-security
no feature fc-port-security
This command has no arguments or keywords.
Disabled
Global configuration mode
Entering the feature fc-port-security command enables the other commands that are used to configure FC port security.
This example shows how to enable port security:
switch(config)# feature fc-port-security
This example shows how to disable port security:
switch(config)# no feature fc-port-security
|
|
---|---|
show fc-port-security |
Displays port security information. |
To enable the Fibre Channel Security Protocol (FC-SP) in a switch, use the feature fcsp command. To disable FC-SP, use the no form of this command.
feature fcsp
no feature fcsp
This command has no arguments or keywords.
Disabled
Global configuration mode
Additional FC-SP commands are available when the FC-SP feature is enabled.
This example shows how to enable FC-SP:
switch(config)# feature fcsp
|
|
---|---|
show fcsp |
Displays configured FC-SP information. |
To enable N Port Identifier Virtualization (NPIV) for all Virtual SANs (VSANs) on a switch, use the feature npiv command. To disable NPIV, use the no form of this command.
feature npiv
no feature npiv
This command has no arguments or keywords.
Disabled
Global configuration mode
NPIV provides a means to assign multiple port IDs to a single N port. This feature allows multiple applications on the N port to use different identifiers and allows access control, zoning, and port security to be implemented at the application level.
You must globally enable NPIV for all VSANs on the switch to allow the NPIV-enabled applications to use multiple N port identifiers.
This example shows how to enable NPIV for all VSANs on the switch:
switch(config)# feature npiv
This example shows how to disable NPIV for all VSANs on the switch:
switch(config)# no feature npiv
|
|
---|---|
show interface |
Displays interface configurations. |
To enable N Port Virtualization (NPV) mode, use the feature npv command. To disable this feature, use the no form of this command.
feature npv
no feature npv
This command has no arguments or keywords.
Disabled
Global configuration mode
When NPV mode is enabled, switch configuration related to interfaces is erased and the switch is rebooted. The switch restarts in NPV mode. Configuration and verification commands for NPV are available only when NPV is enabled on the switch. When you disable NPV mode, all related configurations are automatically erased and the switch is rebooted.
This example shows how to enable NPV mode:
switch(config)# feature npv
|
|
---|---|
show npv status |
Displays the NPV current status. |
To enable port tracking for indirect errors, use the feature port-track command. To disable this feature, use the no form of this command.
feature port-track
no feature port-track
This command has no arguments or keywords.
Disabled
Global configuration mode
The software brings the linked port down when the tracked port goes down. When the tracked port recovers from the failure and comes back up again, the tracked port is also brought up automatically (unless otherwise configured).
This example shows how to enable port tracking:
switch(config)# feature port-track
This example shows how to disable port tracking:
switch(config)# no feature port-track
To configure an Fabric Shortest Path First (FSPF) feature for an entire Virtual SAN (VSAN), use the fspf config command. To delete an FSPF configuration for the entire VSAN, use the no form of this 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 min-ls-arrival
no min-ls-interval
no region
no spf {hold-time | static}
no fspf config vsan vsan-id
In FSPF configuration mode, the default is dynamic SPF computation.
If configuring the spf hold-time, the default value for FSPF is 0.
If configuring the min-ls-arrival, the default value for FSPF is 1000 milliseconds.
If configuring the min-ls-interval, the default value for FSPF is 5000 milliseconds.
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
The fspf config command enters FSPF configuration mode for the specified Virtual SAN (VSAN). In FSPF configuration mode, the commands configure FSPF for this VSAN.
This example shows how to configure a static SPF computation in VSAN 1 and delete the FSPF configuration in VSAN 3:
switch(config)# fspf config vsan 1
switch(fspf-config)# spf static
switch(fspf-config)# exit
switch(config)# no fspf config vsan 3
switch(config)#
To configure Fabric Shortest Path First (FSPF) link cost for an Fibre Channel over IP (FCIP) interface, use the fspf cost command. To revert to the default value, use the no form of this command.
fspf cost link-cost vsan vsan-id
no fspf cost link-cost vsan vsan-id
link-cost |
FSPF link cost in seconds. The range is from 1 to 65535. |
vsan vsan-id |
Specifies a VSAN ID. The range is from 1 to 4093. |
1000 seconds for 1 Gigabits per second interfaces
500 seconds for 2 Gigabits per second interfaces
Interface configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This command is not applicable to virtual Fibre Channel interfaces.
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.
This example shows how to configure the FSPF link cost on an FCIP interface:
switch(config)# interface fc 2/1 switch(config-if)# fspf cost 5000 vsan 1
|
|
---|---|
show fspf interface |
Displays information for each selected interface. |
show interface fc |
Displays an interface configuration for a specified Fibre Channel interface. |
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 this command.
fspf dead-interval seconds vsan vsan-id
no fspf dead-interval seconds vsan vsan-id
seconds |
FSPF dead interval in seconds. The range is from 2 to 65535. |
vsan vsan-id |
Specifies a VSAN ID. The range is from 1 to 4093. |
80 seconds
Interface configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This command is not applicable to virtual Fibre Channel interfaces. This value must be the same in the ports at both ends of the ISL.
This example shows how to configure the maximum interval of 400 seconds for a hello message before the neighbor is considered lost:
switch(config)# interface fc 2/1 switch(config-if)# fspf dead-interval 4000 vsan 1
|
|
---|---|
show fspf interface |
Displays information for each selected interface. |
show interface fc |
Displays an interface configuration for a specified Fibre Channel interface. |
To enable Fabric Shortest Path First (FSPF) for a Virtual SAN (VSAN), use the fspf enable command. To disable FSPF routing protocols, use the no form of this command.
fspf enable vsan vsan-id
no fspf enable vsan vsan-id
vsan vsan-id |
Specifies a VSAN ID. The range is from 1 to 4093. |
Enabled
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This command configures FSPF on VSANs globally.
This example shows how to enable a FSPF in VSAN 5 and disable FSPF in VSAN 7:
switch(config)# fspf enable vsan 5 switch(config)# no fspf enable vsan 7
|
|
---|---|
fspf config vsan |
Configures FSPF features for a VSAN. |
show fspf interface |
Displays information for each selected interface. |
To verify the health of the link, use the fspf hello-interval command. To revert to the default value, use the no form of this command.
fspf hello-interval seconds vsan vsan-id
no fspf hello-interval seconds vsan vsan-id
hello-interval seconds |
Specifies the FSPF hello interval in seconds. The range is from 2 to 65535. |
vsan vsan-id |
Specifies a VSAN ID. The range is from 1 to 4093. |
20 seconds
Interface configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This command is not applicable to virtual Fibre Channel interfaces.
This command configures FSPF for the specified Fibre Channel interface. This value must be the same in the ports at both ends of the ISL.
This example shows how to configure a hello interval of 3 seconds on VSAN 1:
switch(config)# interface fc 2/1 switch(config-if)# fspf hello-interval 3 vsan 1
|
|
---|---|
show fspf interface |
Displays information for each selected interface. |
To disable the Fabric Shortest Path First (FSPF) protocol for selected interfaces, use the fspf passive command. To revert to the default state, use the no form of this command.
fspf passive vsan vsan-id
no fspf passive vsan vsan-id
vsan vsan-id |
Specifies a VSAN ID. The range is from 1 to 4093. |
FSPF is enabled
Interface configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This command is not applicable to virtual Fibre Channel interfaces.
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. FSPF must be enabled on the ports at both ends of the ISL for the protocol to operate correctly.
This example shows how to disable the FSPF protocol for the selected interface on VSAN 1:
switch(config)# interface fc 2/1 switch(config-if)# fspf passive vsan 1
|
|
---|---|
show fspf interface |
Displays information for each selected interface. |
show interface fc |
Displays an interface configuration for a specified FCIP interface. |
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 this command.
fspf retransmit-interval seconds vsan vsan-id
no spf retransmit-interval seconds vsan vsan-id
seconds |
FSPF retransmit interval in seconds. The range is from 1 to 65535. |
vsan vsan-id |
Specifies a VSAN ID. The range is from 1 to 4093. |
5 seconds
Interface configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This command is not applicable to virtual Fibre Channel interfaces. This value must be the same in the ports at both ends of the ISL.
This example shows how to specify a retransmit interval of 6 seconds after which an unacknowledged link state update should be transmitted on the interface for VSAN 1:
switch(config)# interface fc 2/1 switch(config-if)# fspf retransmit-interval 6 vsan 1
|
|
---|---|
show fspf interface |
Displays information for each selected interface. |
show interface fc |
Displays an interface configuration for a specified FCIP interface. |
To enable in-order delivery, use the in-order-guarantee command. To disable in-order delivery, use the no form of this command.
in-order-guarantee [vsan vsan-id]
no in-order-guarantee [vsan vsan-id] [,] [-]
vsan vsan-id |
(Optional) Specifies a VSAN ID. The range is from 1 to 4093. |
[,] [-] |
(Optional) Allows you to enter multiple VSANs separated by commas, or a range of VSANs separated by a dash. |
Disabled
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
In-order delivery of data frames guarantees frame delivery to a destination in the same order that they were sent by the originator.
This example shows how to enable in-order delivery for the entire switch:
switch(config) # in-order-guarantee
This example shows how to disable in-order delivery for the entire switch:
switch(config)# no in-order-guarantee
This example shows how to enable in-order delivery for a specific VSAN:
switch(config)# in-order-guarantee vsan 3452
This example shows how to disable in-order delivery for a specific VSAN:
switch(config)# no in-order-guarantee vsan 101
|
|
---|---|
show in-order-guarantee |
Displays the in-order-guarantee status. |
To configure a Fibre Channel interface on a Cisco Nexus 5000 Series switch, use the interface fc command. To revert to defaults, use the no form of this command.
interface fc slot/port
channel-group {group-id [force] | auto}
fcdomain rcf-reject vsan vsan-id
fcsp {auto-active | auto-passive | on | off} [timeout-period]
fspf {cost link-cost vsan vsan-id | dead-interval seconds vsan vsan-id | hello-interval seconds
vsan vsan-id | passive vsan vsan-id | retransmit-interval seconds vsan vsan-id}
switchport
no interface fc slot/port
no channel-group {group-id [force] | auto}
no fcdomain rcf-reject vsan vsan-id
no fcsp {auto-active | auto-passive | on | off}
no fspf {cost link-cost vsan vsan-id | dead-interval seconds vsan vsan-id | hello-interval seconds vsan vsan-id | passive vsan vsan-id | retransmit-interval seconds vsan vsan-id}
switchport
Disabled
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
You can specify a range of interfaces by entering a command with the following example format:
interface fc 1/1 - 5 , fc 2/5 - 7
See the Cisco Nexus 5000 Series Switch CLI Software Configuration Guide for information on port number allocation.
Use the no shutdown command to enable the interface.
The interface fc command enters interface configuration mode, which includes five commands (each with a no form). These five commands can only be used in the interface configuration mode.
The channel-group auto command enables autocreation of port channels. If autocreation of port channels is enabled for an interface, you must first disable this configuration before downgrading to earlier software versions or before configuring the interface in a manually configured channel group.
This example shows how to configure ports 1 to 4 in Fibre Channel interface 3:
switch(config)# interface fc 3/1 - 4
This example shows how to enable the Fibre Channel interface in port 1 of slot 3:
switch(config)# interface fc 3/1 switch(config-if)# no shutdown
|
|
---|---|
show interface |
Displays an interface configuration for a specified interface. |
shutdown |
Disables and enables an interface. |
To configure a SAN port channel interface on a Cisco Nexus 5000 Series switch, use the interface san-port-channel command. To revert to the defaults, use the no form of this command.
interface san-port-channel port {description line | shutdown [force] | switchport {mode {E | auto} | speed {1000 | 2000 | 4000 | auto} | trunk {allowed vsan {vsan-id | add vsan-id | all} | mode {auto | on | off}}}}
no interface san-port-channel port {no description | no shutdown | no switchport {no mode | no speed | no trunk {allowed vsan {vsan-id | add vsan-id | all}| mode}}}
Disabled
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
The interface san-port-channel command enters interface configuration mode, which includes six commands (each with a no form). These commands can only be used in the interface configuration mode.
Use the no shutdown command to enable the interface.
This example shows how to configure SAN port channel interface 3:
switch(config)# interface san-port-channel 3
|
|
---|---|
show interface |
Displays an interface configuration for a specified interface. |
shutdown |
Disables and enables an interface. |
To configure a virtual Fibre Channel interface on a Cisco Nexus 5000 Series switch, use the interface vfc command. To revert to defaults, use the no form of this command.
interface vfc vfc-id {bind interface ethernet slot/port | description line | shutdown [force] | switchport mode F}
no interface vfc vfc-id {no bind interface ethernet slot/port | no description | no shutdown | no switchport mode}
Disabled
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
You can specify a range of interfaces by entering a command with the following example format:
interface vfc 1 - 3 , vfc 5 - 7
Use the no shutdown command to enable the interface.
This example shows how to enter interface configuration mode for virtual Fibre Channel interface 3:
switch(config)# interface vfc 3
|
|
---|---|
show interface |
Displays an interface configuration for a specified interface. |
shutdown |
Disables and enables an interface. |
To configure the Link Layer Discovery Protocol (LLDP) global options, use the lldp command. To remove the LLDP settings, use the no form of this command.
lldp {holdtime seconds | reinit seconds | timer seconds}
no lldp {holdtime | reinit | timer}
Holdtime: 120 seconds.
Reinit: 2 seconds.
Timer: 30 seconds.
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
Before you use this command, you must enable LLDP on the switch.
The LLDP settings include the length of time before discarding LLDP information received from peers, the length of time to wait before performing LLDP initialization on any interface, and the rate at which LLDP packets are sent.
This example shows how to configure the global LLDP holdtime to 200 seconds:
switch(config)# lldp holdtime 200
switch(config)#
|
|
---|---|
feature lldp |
Enables or disables LLDP on the switch. |
lldp (Interface) |
Configures the LLDP feature on an interface. |
show lldp |
Displays LLDP configuration information. |
To enable the reception, or transmission, of Link Layer Discovery Protocol (LLDP) packets on an interface, use the lldp command. To disable the reception or transmission of LLDP packets, use the no form of this command.
lldp {receive | transmit}
no lldp {receive | transmit}
receive |
Specifies that the interface receive LLDP packets. |
transmit |
Specifies that the interface transmit LLDP packets. |
None
Interface configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
Before you use this command, you must enable LLDP on the switch.
This example shows how to set an interface to transmit LLDP packets:
switch(config)# interface ethernet 2/1
switch(config-if)# lldp transmit
switch(config-if)#
|
|
---|---|
feature lldp |
Enables or disables LLDP on the switch. |
show interface |
Displays configuration information about interfaces. |
To discard the logging Cisco Fabric Services (CFS) distribution session in progress, use the logging abort command.
logging abort
This command has no arguments or keywords.
None
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to discard the logging CFS distribution session in progress:
switch(config)# logging abort
|
|
---|---|
show logging |
Displays logging information. |
To apply the pending configuration pertaining to the logging Cisco Fabric Services (CFS) distribution session in progress in the fabric, use the logging commit command.
logging commit
This command has no arguments or keywords.
None
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to commit changes to the active logging configuration:
switch(config)# logging commit
|
|
---|---|
show logging |
Displays logging information. |
To enable Cisco Fabric Services (CFS) distribution for logging, use the logging distribute command. To disable this feature, use the no form of this command.
logging distribute
no logging distribute
This command has no arguments or keywords.
Disabled
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
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 logging commit command.
This example shows how to change the distribute logging configuration changes:
switch(config)# logging distribute
|
|
---|---|
logging commit |
Commits the logging configuration changes to the active configuration. |
show logging |
Displays logging information. |
To add a member name to a Fibre Channel alias on a Virtual SAN (VSAN), use the member command. To remove a member name from a Fibre Channel alias, use the no form of this command.
member {device-alias aliasname | domain-id domain-id port-number port-number | fcid fc-id | fwwn fwwn-id | interface fc slot/port [domain-id domain-id | swwn swwn-id] | pwwn pwwn-id | symbolic-nodename nodename}
no member {device-alias aliasname | domain-id domain-id port-number port-number | fcid fc-id | fwwn fwwn-id | interface fc slot/port [domain-id domain-id | swwn swwn-id] | pwwn pwwn-id | symbolic-nodename nodename}
None
Fcalias configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to add a member to an alias called samplealias:
switch(config)# fcalias name samplealias
This example shows how to define a Fibre Channel interface for the member:
switch(config-fcalias)# member interface fc3/1
This example shows how to delete the specified member:
switch(config-fcalias)# no member interface fc3/1
|
|
---|---|
fcalias name |
Configures an alias. |
show fcalias |
Displays the member name information in an alias. |
To add a member name to a Fibre Channel zone, use the member command. To remove a member name from a zone, use the no form of this command.
member {device-alias aliasname | domain-id domain-id port-number port | fcalias alias-name | fcid fc-id | fwwn fwwn-id | interface fc slot/port [domain-id domain-id | swwn swwn-id] | pwwn pwwn-id [lun lun-id] | symbolic-nodename nodename}
no member {device-alias aliasname | domain-id domain-id port-number port | fcid fc-id | fwwn fwwn-id | interface fc slot/port [domain-id domain-id | swwn swwn-id] | pwwn pwwn-id [lun lun-id] | symbolic-nodename nodename}
None
Zone set zone configuration mode and zoneset-zone configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
Create a zone set zone member only if you need to add member to a zone from the zone set prompt.
This example shows how to add a member to a zone called zs1 on VSAN 1:
switch(config)# zone name zs1 vsan 1 switch(config-zone)# member fcid 0x111112
This example shows how to add a zone to a zone set called Zoneset1 on VSAN 1:
switch(config)# zoneset name ZoneSet1 vsan 1 switch(config-zoneset-zone)# member fcid 0x111112
This example shows how to assign a Fibre Channel interface member into a zone:
switch(config)# zoneset name ZoneSet1 vsan 1
switch(config-zoneset-zone)# member interface fc 3/1
This example shows how to delete the specified device from a zone:
switch(config-zoneset-zone)# no member interface fc 3/1
|
|
---|---|
zoneset (configuration mode) |
Specifies a name for a zone set. |
zone name (zone set configuration mode) |
Configures a zone in a zone set. |
show zoneset |
Displays zone set information. |
To configure zone set members, use the member command. To remove a zone set member, use the no form of this command.
member member-name
no member member-name
member-name |
Member name. The name can be a maximum of 64 characters. |
None
Zone set configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to add a member zone to a zone set:
switch(config)# zoneset name Zoneset1 vsan 10 switch(config-zoneset)# member ZoneA
|
|
---|---|
show zone |
Displays zone information. |
zoneset name |
Creates a zone set. |
To enable N Port Virtualization (NPV) disruptive load balancing, use the npv auto-load-balance disruptive command. To disable this feature, use the no form of this command.
npv auto-load-balance disruptive
no npv auto-load-balance disruptive
This command has no arguments or keywords.
None
Global configuration mode
|
|
---|---|
4.0(0)N1(2a) |
This command was introduced. |
Disruptive load balancing can be configured only in NPV mode.
When disruptive load balancing is enabled, NPV redistributes the server interfaces across all available NP uplinks when a new NP uplink becomes operational. To move a server interface from one NP uplink to another NP uplink, NPV forces reinitialization of the server interface so that the server performs a new login to the core switch. This action causes traffic disruption on the attached end devices.
To avoid disruption of server traffic, enable this feature only after adding a new NP uplink, and then disable it again after the server interfaces have been redistributed.
This example shows how to enable disruptive load-balancing:
switch(config)# npv auto-load-balance disruptive
|
|
---|---|
feature npv |
Enables NPV mode. |
show npv status |
Displays the NPV current status. |
To configure an N Port Virtualization (NPV) traffic map, use the npv traffic-map command. To disable this feature, use the no form of this command.
npv traffic-map server-interface {fc slot/port | vfc vfc-id} external-interface fc slot/port
no npv traffic-map server-interface {fc slot/port | vfc vfc-id} external-interface fc slot/port
No traffic map. The switch uses automatic uplink selection to select an NP uplink for the server interface.
Global configuration mode
|
|
---|---|
4.0(0)N1(2a) |
This command was introduced. |
This command is only available when the switch is operating in NPV mode.
NPV traffic maps can be configured only in NPV mode.
This example shows how to create a mapping between server interface vfc1 and NP uplink fc 3/1:
switch(config)# npv traffic-map server-interface vfc 1 external-interface fc 3/1
|
|
---|---|
feature npv |
Enables NPV mode. |
show npv status |
Displays the NPV current status. |
To force a shutdown of a tracked port, use the port-track force-shut command. To reenable the port tracking, use the no form of this command.
port-track force-shut
no port-track force-shut
This command has no arguments or keywords.
None
Interface configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
Use the port-track force-shut command to keep the linked port down, even though the tracked port comes back up. You must explicitly bring the port up when required by using the no port-track force-shut command.
This example shows how to force the shutdown of an interface and the interfaces that it is tracking:
switch(config)# interface fc 2/2
switch(config-if)# no port-track force-shut
To enable port tracking for specific interfaces, use the port-track interface command. To disable this feature, use the no form of this command.
port-track interface {fc slot/port | san-port-channel port} [vsan vsan-id]
no port-track interface {fc slot/port | san-port-channel port} [vsan vsan-id]
None
Interface configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
When the port that an interface is tracking goes down, the interface also goes down. When the tracked port comes back up, the linked interface also comes back up. Use the port-track force-shut command to keep the linked interface down.
This example shows how to enable port tracking for specific interfaces:
switch(config)# interface fc 2/3 switch(config-if)# port-track interface san-port-channel 2
To purge persistent FCIDs, use the purge fcdomain fcid command.
purge fcdomain fcid vsan vsan-id
vsan vsan-id |
Indicates that FCIDs are to be purged for a VSAN ID. The range is from 1 to 4093. |
None
EXEC mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to purge all dynamic, unused FCIDs in VSAN 4:
switch# purge fcdomain fcid vsan 4
This example shows how to purge all dynamic, unused FCIDs in VSANs 4, 5, and 6:
switch# purge fcdomain fcid vsan 4-6
To specify a preferred host to receive Registered Link Incident Report (RLIR) frames, use the rlir preferred-cond fcid command. To remove a preferred host, use the no form of this command.
rlir preferred-cond fcid fc-id vsan vsan-id
no rlir preferred-cond fcid fc-id vsan vsan-id
fcid fc-id |
Specifies the FC ID. The format is 0xhhhhhh. |
vsan vsan-id |
Specifies a VSAN ID. The range is from 1 to 4093. |
By default, the switch sends RLIR frames to one of the hosts in the Virtual SAN (VSAN) with the register function set to "conditionally receive" if no hosts have the register function set to "always receive."
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
The switch sends RLIR frames to the preferred host only if it meets the following conditions:
•No host in the VSAN is registered for RLIR with the registration function set to "always receive." If one or more hosts in the VSAN are registered as "always receive," then RLIR sends only to these hosts and not to the configured preferred host.
•The preferred host is registered with the registration function set to "conditionally receive." If all registered hosts have the registration function set to "conditionally receive," then the preferred host receives the RLIR frames.
You can specify only one RLIR preferred host per VSAN.
This example shows how to specify the FCID 0x654321 as the RLIR preferred host for VSAN 2:
switch(config)# rlir preferred-cond fcid 0x654321 vsan 2
This example shows how to remove the FCID 0x654321 as the RLIR preferred host for VSAN 2:
switch(config)# no rlir preferred-cond fcid 0x654321 vsan 2
To configure a registered state change notification (RSCN), which is a Fibre Channel service that informs N ports about changes in the fabric, use the rscn command.
rscn {multi-pid | suppress domain-swrscn} vsan vsan-id
None
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to configure RSCNs in multi-PID format:
switch(config)# rscn multi-pid vsan 1
|
|
---|---|
show rscn src-table |
Displays the state change registration table. |
show rscn statistics |
Displays RSCN statistics. |
To cancel a Registered State Change Notification (RSCN) configuration on a Virtual SAN (VSAN), use the rscn abort command. To reverse the cancellation, use the no form of this command.
rscn abort vsan vsan-id
no rscn abort vsan vsan-id
vsan vsan-id |
Specifies a VSAN where the RSCN configuration should be canceled. The ID of the VSAN is from 1 to 4093. |
None
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to cancel an RSCN configuration on VSAN 1:
switch(config)# rscn abort vsan 1
To apply a pending Registered State Change Notification (RSCN) configuration, use the rscn commit command. To discard a pending RSCN configuration, use the no form of this command.
rscn commit vsan vsan-id
no rscn commit vsan vsan-id
vsan vsan-id |
Specifies a VSAN where the RSCN configuration should be committed. The ID of the VSAN is from 1 to 4093. |
None
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
If you commit the changes made to the active database, the configuration is committed to all the switches in the fabric. On a successful commit, the configuration change is applied throughout the fabric and the lock is released.
This example shows how to commit an RSCN configuration on VSAN 1:
switch(config)# rscn commit vsan 1
To enable distribution of a Registered State Change Notification (RSCN) configuration, use the rscn distribute command. To disable the distribution, use the no form of this command.
rscn distribute
no rscn distribute
This command has no arguments or keywords.
RSCN timer distribution is disabled.
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
The RSCN timer configuration must be the same on all switches in the Virtual SAN (VSAN). Cisco Fabric Service (CFS) automatically distributes the RSCN timer configuration to all switches in a fabric. Only the RSCN timer configuration is distributed.
This example shows how to enable the distribution of an RSCN configuration:
switch(config)# rscn distribute
To configure an event timeout value for a Registered State Change Notification (RSCN) on a specified Virtual SAN (VSAN), use the rscn event-tov command. To cancel the event timeout value and restore the default value, use the no form of this command.
rscn event-tov timeout vsan vsan-id
no rscn event-tov timeout vsan vsan-id
timeout |
Event timeout value in milliseconds. The range is from 0 to 2000. |
vsan vsan-id |
Specifies a VSAN where the RSCN event timer should be used. The ID of the VSAN is from 1 to 4093. |
The default timeout values are 2000 milliseconds for Fibre Channel VSANs.
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
Before changing the timeout value, you must enable RSCN configuration distribution using the rscn distribute command.
The RSCN timer is registered with Cisco Fabric Services (CFS) during initialization and switchover.
This example shows how to configure an RSCN event timeout value on VSAN 1:
switch(config)# rscn event-tov 20 vsan 1
To convert an autocreated SAN port channel to a persistent SAN port channel, use the san-port-channel persistent command.
san-port-channel port-channel-id persistent
port-channel-id |
Port channel ID. The range is from 1 to 128. |
persistent |
Converts the autocreated SAN port channel to a persistent SAN port channel |
None
EXEC mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This command is not reversible. A user-created channel group cannot be converted to an autocreated channel group.When the san-port-channel persistent command is applied to an autocreated channel group, the channel group number does not change and the properties of the member ports change to those of a user-created channel group. The channel mode remains active.
This example shows how to change the properties of an autocreated channel group to a persistent channel group:
switch# san-port-channel 10 persistent
To configure SCSI target discovery, use the scsi-target command. To remove SCSI target discovery, use the no form of this command.
scsi-target {auto-poll [vsan vsan-id] | discovery | ns-poll [vsan vsan-id] | on-demand [vsan vsan-id]}
no scsi-target {auto-poll [vsan vsan-id] | discovery | ns-poll [vsan vsan-id] | on-demand [vsan vsan-id]}
SCSI target discovery for each option is enabled.
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
Automatic global SCSI target discovery is on by default. Discovery can also be triggered for specific VSANs using on-demand, name server polling, or auto-polling options. All options are on by default. Use the no scsi-target discovery command to turn off all discovery options. You can also turn off specific options by using the no form of this command.
This example shows how to configure a SCSI target auto-polling discovery for VSAN 1:
switch(config)# scsi-target auto-poll vsan 1
This example shows how to remove the SCSI target auto-polling discovery for VSAN 1:
switch(config)# no scsi-target auto-poll vsan 1
This example shows how to configure a SCSI target discovery:
switch(config)# scsi-target discovery
This example shows how to configure a SCSI target ns-polling discovery for VSAN 1:
switch(config)# scsi-target ns-poll vsan 1
This example shows how to remove a SCSI target ns-polling discovery for VSAN 1:
switch(config)# no scsi-target ns-poll vsan 1
This example shows how to configure a SCSI target on-demand discovery for VSAN 1:
switch(config)# scsi-target on-demand vsan 1
This example shows how to remove a SCSI target on-demand discovery for VSAN 1:
switch(config)# no scsi-target on-demand vsan 1
To shut down the Ethernet traffic on a Fibre Channel over Ethernet (FCoE) link, use the shutdown lan command. To restore Ethernet traffic, use the no form of this command.
shutdown lan
no shutdown lan
This command has no arguments or keywords.
Not shut down.
Interface configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
Use this command to shut down Ethernet traffic on the interface. If the interface is part of an FCoE VLAN, the shutdown has no impact on the FCoE traffic.
This example shows how to shut down an Ethernet interface on an FCoE link:
switch(config)# interface ethernet 2/1
switch(config-if)# shutdown lan
switch(config-if)#
This example shows how to restore traffic on an interface after you have shut down, or disabled, the interface:
switch(config)# interface ethernet 2/1
switch(config-if)# no shutdown lan
switch(config-if)#
|
|
---|---|
fcoe |
Configures FCoE parameters. |
To configure a switch port parameter on a Fibre Channel or virtual Fibre Channel interface, use the switchport command. To discard the configuration, use the no form of this command.
Fibre Channel Interface:
switchport
{fcrxbbcredit {credit [mode E | F] | default | } |
mode {F | NP | SD} |
speed {1000 | 2000 | 4000 | 8000 | auto [max 2000]} |
trunk {allowed vsan {[add] vsan-id | all} | mode {auto | off | on}}}
no switchport {fcrxbbcredit| mode | speed | trunk {allowed vsan [[add] vsan-id | all] | mode}}
Virtual Fibre Channel Interface:
switchport mode F
The EISL encapsulation is disabled.
The default receive data buffer size is 2112 bytes.
The port mode is auto.
The speed is auto.
The maximum auto speed is 2000.
The trunk mode is on.
Interface configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
You can specify a range of interfaces by entering a command with the following example format:
interface fc 1/1 - 5 , fc 2/5 - 7
The port speed on an interface determines the amount of shared resources available to the ports in the port group. Port group resources are reserved even though the bandwidth is not used. For example, if an interface is configured for autosensing (auto), then 4 Gbps of bandwidth is reserved even though the maximum operating speed is 2 Gbps. For the same interface, if autosensing with a maximum speed of 2 Gbps (auto max 2000) is configured, then only 2 Gbps of bandwidth is reserved and the unused 2 Gbps is shared with the other interface in the port group.
When configuring port modes, observe the following guidelines:
•Auto port mode and E port mode cannot be configured in shared rate mode.
•Shared to dedicated ports should be configured in this order: speed, port mode, credit.
•Dedicated to shared ports should be configured in this order: credit, port mode, speed.
For a virtual Fibre Channel interface, you can set the port mode to F. The remaining switch port parameters are not configurable.
This example shows how to configure the switch port parameters for a Fibre Channel interface:
switch(config)# interface fc 2/3
switch(config-if)# switchport description techdocsSample
switch(config-if)# switchport mode E switch(config-if)# switchport trunk mode auto switch(config-if)# switchport trunk allowed vsan all switch(config-if)# switchport trunk allowed vsan 3 switch(config-if)# switchport trunk allowed vsan add 2
switch(config-if)# switchport fcrxbbcredit 20
This example shows how to configure the mode of a virtual Fibre Channel interface:
switch(config)# interface vfc 2 switch(config-if)# switchport mode F
|
|
---|---|
fcrxbbcredit extended enable |
Enables extended BB_credits on the switch. |
show interface |
Displays an interface configuration for a specified interface. |
To prevent the detection of bit error threshold events from disabling the interface on Fibre Channel interfaces, use the switchport ignore bit-errors command. To revert to the default, use the no form of this command.
switchport ignore bit-errors
no switchport ignore bit-errors
This command has no arguments or keywords.
None
Interface configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
The bit error rate threshold is used by the switch to detect an increased error rate before performance degradation seriously affects traffic.
Bit errors can occur for the following reasons:
•Faulty or bad cable
•Faulty or bad SFP
•SFP is specified to operate at 1 Gbps but is used at 2 Gbps
•Short haul cable is used for long haul or long haul cable is used for short haul
•Momentary sync loss
•Loose cable connection at one or both ends
•Improper SFP connection at one or both ends
A bit error rate threshold is detected when 15 error bursts occur in a 5-minute period. By default, the switch disables the interface when the threshold is reached. You can enter a shutdown/no shutdown command sequence to reenable the interface.
Regardless of the setting of the switchport ignore bit-errors command, the switch generates a syslog message when bit error threshold events are detected.
This example shows how to prevent the detection of bit error events from disabling the interface:
switch(config)# interface fc2/1 switch(config-if)# switchport ignore bit-errors
This example shows how to allow the detection of bit error events from disabling the interface:
switch(config)# interface fc2/1 switch(config-if)# no switchport ignore bit-errors
|
|
---|---|
show interface |
Displays interface information. |
To configure port attributes for Fibre Channel interfaces, use the system default switchport command. To disable port attributes, use the no form of this command.
system default switchport {shutdown | trunk mode {auto | off | on}}
no system default switchport {shutdown | trunk mode {auto | off | on}}
Enabled
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
Attributes configured using this command are applied globally to all future switch port configurations, even if you do not individually specify them at that time.
This command changes the configuration of the following ports to administrative mode F:
•All ports that are down.
•All F ports that are up, whose operational mode is F, and whose administrative mode is not F.
This command does not affect non-F ports that are up; however, if non-F ports are down, this command changes the administrative mode of those ports.
This example shows how to configure a port shutdown:
switch(config)# system default switchport shutdown
This example shows how to configure the trunk mode:
switch(config)# system default switchport trunk mode auto
|
|
---|---|
show system default switchport |
Displays default values for switch port attributes. |
show interface brief |
Displays Fibre Channel port modes. |
To configure default values for a zone, use the system default zone default-zone permit command. To revert to the defaults, use the no form of this command.
system default zone default-zone permit
no system default zone default-zone permit
This command has no arguments or keywords.
No default values for zones.
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This command defines the default values for the default zone for all Virtual SANs (VSANs). The default values are used when you initially create a VSAN and it becomes active. If you do not want to use the default values, use the zone default-zone permit vsan command to define the operational values for the default zone.
The system default zone default-zone permit command should only be used with VSANs that have not yet been created; it has no effect on existing VSANs.
Because VSAN 1 is the default VSAN and is always present, this command has no effect on it.
This example shows how to set the default zone to use the default values:
switch(config)# system default zone default-zone permit
This example shows how to restore the default setting:
switch(config)# no system default zone default-zone permit
To configure default values for distribution to a zone set, use the system default zone distribute full command. To revert to the defaults, use the no form of this command.
system default zone distribute full
no system default zone distribute full
This command has no arguments or keywords.
Distribution to active zone sets only.
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This command distributes the default values for the default zone to all Virtual SANs (VSANs). The default values are used when you initially create a VSAN and it becomes active. If you do not want to use the default values, use the zoneset distribute full vsan command to distribute the operational values for the default zone.
The system default zone distribute full command should only be used with VSANs that have not yet been created; it has no effect on existing VSANs.
Because VSAN 1 is the default VSAN and is always present, this command has no effect on it.
This example shows how to distribute the default values to the full zone set:
switch(config)# system default zone distribute full
This example shows how to distribute the default values to the active zone set only:
switch(config)# no system default zone distribute full
|
|
---|---|
zoneset distribute full vsan |
Distributes the operational values for the default zone to all zone sets. |
show system default zone |
Displays default values for the default zone. |
To configure the trunking protocol for Fibre Channel interfaces, use the trunk protocol enable command. To disable this feature, use the no form of this command.
trunk protocol enable
no trunk protocol enable
This command has no arguments or keywords.
Enabled
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
If the trunking protocol is disabled on a switch, no port on that switch can apply new trunk configurations. Existing trunk configurations are not affected, and the TE port continues to function in trunking mode, but only supports traffic in Virtual SANs (VSANs) that it negotiated previously (when the trunking protocol was enabled). Also, other switches that are directly connected to this switch are similarly affected on the connected interfaces. In some cases, you may need to merge traffic from different port VSANs across a nontrunking ISL. Before you merge traffic, you need to disable the trunking protocol.
This example shows how to disable the trunk protocol feature:
switch(config)# no trunk protocol enable
This example shows how to enable the trunk protocol feature:
switch(config)# trunk protocol enable
|
|
---|---|
show trunk protocol |
Displays the trunk protocol status. |
To create multiple fabrics sharing the same physical infrastructure, assign ports to Virtual SANs (VSANs), turn on or off interop mode, load balance either per originator exchange or by source-destination ID, and VSAN membership, use the vsan command. To remove a configuration, use the no form of this command.
vsan vsan-id
[interface {fc slot/port | san-port-channel port | vfc vfc-id} |
interop [mode] [loadbalancing {src-dst-id | src-dst-ox-id}] |
loadbalancing {src-dst-id | src-dst-ox-id} |
name name [interop [mode] [loadbalancing {src-dst-id | src-dst-ox-id}] | loadbalancing {src-dst-id | src-dst-ox-id}] | suspend [interop [mode] [loadbalancing {src-dst-id | src-dst-ox-id}] | loadbalancing {src-dst-id | src-dst-ox-id}] |
suspend [interop [mode] [loadbalancing {src-dst-id | src-dst-ox-id}] | loadbalancing {src-dst-id | src-dst-ox-id}]]
no vsan vsan-id
[interop [mode] [loadbalancing {src-dst-id | src-dst-ox-id}] |
loadbalancing {src-dst-id | src-dst-ox-id} |
name name [interop [mode] [loadbalancing {src-dst-id | src-dst-ox-id}] | loadbalancing {src-dst-id | src-dst-ox-id}] | suspend [interop [mode] [loadbalancing {src-dst-id | src-dst-ox-id}] | loadbalancing {src-dst-id | src-dst-ox-id}] |
suspend [interop [mode] [loadbalancing {src-dst-id | src-dst-ox-id}] | loadbalancing {src-dst-id | src-dst-ox-id}]]
None
VSAN database configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
4.2(1)N1(1) |
The VSAN ID range is increased to 4094. |
To use this command, change to the VSAN database mode.
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:
For example, show int fc2/1 - 3 , fc2/4 , fc3/2
•The format for a SAN port channel is
san-port-channel portchannel-number.subinterface-number:
For example, show int san-port-channel 5.1
There are four interop modes:
•Interop mode 1 — Standards based interop mode that requires all other vendors in the fabric to be in interop mode.
•Interop mode 2 — Brocade native mode (Core PID 0).
•Interop mode 3 — Brocade native mode (Core PID 1).
•Interop mode 4 — McData native mode. Before you configure Interop mode 4 (or remove the configuration), you must suspend the VSAN. You should unsuspend the VSAN only after you configure a VSAN-dependent switch WWN with the McData OUI [08:00:88].
The no form of the vsan vsan-id interface command is not supported. To remove a VSAN membership of an interface (for example, interface fc1/8 from VSAN 7), you must assign the interface to another VSAN. The best practice is to assign the interface back to the default VSAN (VSAN 1).
This example shows how to create multiple fabrics sharing the same physical infrastructure and how to assign ports to VSANs:
switch(config)# vsan database
switch-config-vsan-db# vsan 2
switch(config-vsan-db)# vsan 2 name TechDoc
switch(config-vsan-db)# vsan 2 loadbalancing src-dst-id
switch(config-vsan-db)# vsan 2 loadbalancing src-dst-ox-id
switch(config-vsan-db)# vsan 2 suspend
switch(config-vsan-db)# no vsan 2 suspend
switch(config-vsan-db)# end
This example shows how to suspend a VSAN and enable Interop mode 4:
switch(config)# vsan database switch(config-vsan-db)# vsan 100 suspend switch(config-vsan-db)# vsan 100 interop 4 switch(config-vsan-db)# exit
This example shows how to configure a VSAN to create a FCOE-VLAN to VSAN mapping:
switch(config)# vsan database
switch(config-vsan-db)# vsan 377
switch(config-vsan-db)# exit
switch(config)# vlan 30
switch(config-vlan)# fcoe vsan 337
switch(config-vlan)#
This example shows how to remove interface fc2/1 from VSAN 7:
switch(config)# vsan database
switch(config-vsan-db)# vsan 1 interface fc2/1
switch(config-vsan-db)#
To enter Virtual SAN (VSAN) database mode to configure VSAN information and membership, use the vsan database command.
vsan database
This command has no arguments or keywords.
None
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
To exit from the VSAN database configuration mode, use the exit command.
This example shows how to enter the VSAN database configuration mode:
switch(config)# vsan database
switch(config-vsan-db)# exit
switch(config)#
To allocate a secondary MAC address to a SAN node, use the wwn secondary-mac command.
wwn secondary-mac wwn-id range address-range
wwn-id |
Secondary MAC address with the format hh:hh:hh:hh:hh:hh. |
range address-range |
Specifies the range for the specified WWN. The only valid value is 64. |
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This command cannot be undone.
Changes to the worldwide names are only performed as required. They should not be changed on a daily basis. These changes should be made by an administrator or individual who is completely familiar with switch operations.
For more information, see the Cisco Nexus 5000 Series Switch CLI Software Configuration Guide.
This example shows how to allocate a secondary range of MAC addresses:
switch(config)# wwn secondary-mac 00:99:55:77:55:55 range 64
To configure a WWN for a suspended Virtual SAN (VSAN) that has interop mode 4 enabled, use the wwn vsan command. To discard the configuration, use the no form of this command.
wwn vsan vsan-id vsan-wwn wwn
no wwn vsan vsan-id vsan-wwn wwn
vsan-id |
VSAN ID. The range is from 1 to 4093. |
vsan-wwn wwn |
Specifies the WWN for the VSAN. The format is hh:hh:hh:hh:hh:hh:hh:hh. |
None
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
This command can succeed only if the following conditions are satisfied:
•The VSAN must be suspended.
•The VSAN must have interop mode 4 enabled before you can specify the switch WWN for it.
•The switch WWN must be unique throughout the entire fabric.
•The configured switch WWN must have McData OUI [08:00:88].
This example shows how to assign a WWN to a VSAN:
switch(config)# wwn vsan 100 vsan-wwn 20:64:08:00:88:0d:5f:81 switch(config)# vsan database switch(config-vsan-db)# vsan 100 suspend switch(config-vsan-db)# exit switch(config)# wwn vsan 100 vsan-wwn 20:64:08:00:88:0d:5f:81
To clone a zone name, use the zone clone command.
zone clone current-zone-name new-zone-name vsan vsan-id
current-zone-name new-zone-name |
Zone attribute group name. The name can be a maximum of 64 characters. |
vsan vsan-id |
Specifies the VSAN ID. The range is from 1 to 4093. |
None
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
Use the no form of the zone name (configuration mode) command to delete the zone name.
This example shows how to create a clone of the original zone group called origZone into the clone zone group cloneZone on VSAN 45:
switch(config)# zone clone origZone cloneZone vsan 45
|
|
---|---|
show zone |
Displays zone information. |
To commit zoning changes to a Virtual SAN (VSAN), use the zone commit command. To negate the command, use the no form of this command.
zone commit vsan vsan-id [force]
no zone commit vsan vsan-id [force]
vsan vsan-id |
Specifies the VSAN ID. The range is from 1 to 4093. |
force |
(Optional) Forces the commit. |
None
Global configuration mode
|
|
---|---|
4.0(0)N1(1a) |
This command was introduced. |
Use the no form of the zone commit command to clear a session lock on a switch where the lock originated.
This example shows how to commit zoning changes to VSAN 200:
switch(config)# zone commit vsan 200
|
|
---|---|
show zone |
Displays zone information. |
To compact a zone database in a Virtual SAN (VSAN), use the zone compact command.
zone compact vsan vsan-id
vsan vsan-id |
Specifies the VSAN ID. The range is from 1 to 4093. |
None
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
8000 zones are supported in a Cisco Nexus 5000 Series switch.
If you attempt to merge VSANs, the merge will fail if more than 2000 zones are present in a VSAN and the neighboring VSAN cannot support more than 2000 zones.
Activation will fail if more than 2000 zones are present in the VSAN and one or more switches in the fabric cannot support more than 2000 zones.
This example shows how to compact a zone database in VSAN 1:
switch(oongif)# zone compact vsan 1
|
|
---|---|
show zone |
Displays zone information. |
show zone analysis |
Displays detailed analysis and statistical information about the zoning database. |
To copy the active zone set to the full zone set, use the zone copy command. To negate the command or revert to the factory defaults, use the no form of this command.
zone copy active-zoneset full-zoneset [include-auto-zones] vsan vsan-id
zone copy vsan vsan-id active-zoneset {bootflash: | ftp: | full-zoneset | scp: | sftp: | tftp: | volatile:}
no zone copy
None
EXEC mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to copy the active zone set to the full zone set:
switch# zone copy active-zoneset full-zoneset vsan 1
This example shows how to copy the active zone set in VSAN 3 to a remote location using SCP:
switch# zone copy vsan 3 active-zoneset scp://guest@myserver/tmp/active_zoneset.txt
|
|
---|---|
show zone |
Displays zone information. |
To define whether a default zone (assigned to nodes not assigned to a created zone) permits or denies access to all nodes in the default zone, use the zone default-zone command. To negate the command or revert to the factory defaults, use the no form of this command.
zone default-zone permit vsan vsan-id
no zone default-zone permit vsan vsan-id
permit |
Permits access to all nodes in the default zone. |
vsan vsan-id |
Sets default zoning behavior for the specified Virtual SAN (VSAN). The ID of the VSAN is from 1 to 4093. |
All default zones are permitted access.
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
Use the zone default-zone permit vsan command to define the operational values for the default zone in a VSAN. This command applies to existing VSANs; it has no effect on VSANs that have not yet been created.
Use the system default zone default-zone permit command to use the default values defined for the default zone for all VSANs. The default values are used when you initially create a VSAN and it becomes active.
This example shows how to permit the default zoning in VSAN 2:
switch(config)# zone default-zone permit vsan 2
|
|
---|---|
system default zone default-zone permit |
Configures default values for a zone. |
show zone |
Displays zone information. |
To restrict zone database merging, use the zone merge-control restrict vsan command. To disable this feature, use the no form of this command.
zone merge-control restrict vsan vsan-id
no zone merge-control restrict vsan vsan-id
vsan vsan-id |
Specifies the VSAN ID. The range is from 1 to 4093. |
Disabled
Global configuration mode
|
|
Release 4.0 |
This command was introduced. |
If merge control is set to restricted and the two databases are not identical, the merge fails and Inter-Switch Links (ISLs) between the switches become isolated.
This example shows how to set the zone merge control for VSAN 10 to restricted:
switch(config)# zone merge-control restrict vsan 10
|
|
---|---|
show zone |
Displays zone information. |
To enable enhanced zoning for a Virtual SAN (VSAN), use the zone mode enhanced command. To disable this feature, use the no form of this command.
zone mode enhanced vsan vsan-id
no zone mode enhanced vsan vsan-id
vsan vsan-id |
Specifies the VSAN ID. The range is from 1 to 4093. |
Disabled
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
Before using the zone mode enhanced command, verify that all switches in the fabric are capable of working in enhanced zoning mode. If one or more switches are not capable of working in enhanced zoning mode, the request to enable enhanced zoning mode is rejected.
When the zone mode enhanced vsan command completes successfully, the software automatically starts a session, distributes the zoning database using the enhanced zoning data structures, applies the configuration changes, and sends a release change authorization (RCA) to all switches in the fabric. All switches in the fabric then enable enhanced zoning mode.
This example shows how to enable enhanced zoning mode:
switch(config)# zone mode enhanced vsan 10
|
|
---|---|
show zone |
Displays zone information. |
To create a zone, use the zone name command. To negate the command or revert to the factory defaults, use the no form of this command.
zone name zone-name vsan vsan-id
member
zone name zone-name vsan vsan-id
no member
no zone name zone-name vsan vsan-id
zone-name |
Name of the zone. The name can be a maximum of 64 characters. |
vsan vsan-id |
Specifies the VSAN ID. The range is from 1 to 4093. |
None
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
Zones are assigned to zone sets. Zone sets are then activated from one switch and propagate across the fabric to all switches. Zones allow security by permitting and denying access between nodes (hosts and storage). zone name commands are entered from the configuration mode. Configure a zone for a VSAN from the config-zone mode.
Use the show wwn switch command to retrieve the switch world wide name (sWWN). If you do not provide an sWWN, the software automatically uses the local sWWN.
This example shows how to configure attributes for the specified zone (Zone1) based on the member type (pWWN, fabric pWWN, FCID, or Fibre Channel alias) and value specified:
switch(config)# zone name Zone1 vsan 10
switch(config-zone)# member device-alias device1
This example shows how to configure the members for the specified zone (Zone2) based on the member type (pWWN, fabric pWWN, FCID, or Fibre Channel alias) and value specified:
switch(config)# zone name Zone2 vsan 10 switch(config-zone)# member fcalias Payroll switch(config-zone)# member domain-id 2 portnumber 23
|
|
---|---|
show zone |
Displays zone information. |
zone rename |
Renames zones. |
zone-attribute-group name |
Configures zone attribute groups. |
To configure a zone in a zone set, use the zone name command. To delete the zone from the zone set, use the no form of this command.
zone name zone-name
no zone name zone-name
zone-name |
Name of the zone. The name can be a maximum of 64 characters. |
None
Zone set configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to configure a zone in a zone set:
switch(config)# zoneset name Sample vsan 1
switch(config-zoneset)# zone name MyZone
This example shows how to delete a zone from a zone set:
switch(config-zoneset)# no zone name Zone2
switch(config-zoneset)#
|
|
---|---|
show zoneset |
Displays zone set information. |
zone name (configuration mode) |
Configure zones. |
zoneset |
Configures zone set attributes. |
To rename a zone, use the zone rename command.
zone rename current-name new-name vsan vsan-id
None
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
This example shows how to rename a zone:
switch# zone rename ZoneA ZoneB vsan 10
|
|
---|---|
show zone |
Displays zone information. |
zone name |
Creates and configures zones. |
To group zones under one zone set, use the zoneset command. To negate the command or revert to the factory defaults, use the no form of this command.
zoneset {activate [name zoneset-name] vsan vsan-id | clone zoneset-currentName zoneset-cloneName vsan vsan-id | distribute full vsan vsan-id name zoneset-name vsan vsan-id | rename current-name new-name vsan vsan-id}
no zoneset {activate [name zoneset-name] vsan vsan-id | clone zoneset-currentName zoneset-cloneName vsan vsan-id | distribute full vsan vsan-id name zoneset-name vsan vsan-id | rename current-name new-name vsan vsan-id}
None
Global configuration mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
Zones are activated by activating the parent zone set.
The zoneset distribute full vsan command distributes the operational values for the default zone to all zone sets in a VSAN. If you do not want to distribute the operation values, use the system default zone distribute full command to distribute the default values.The default values are used when you initially create a VSAN and it becomes active.
The zoneset distribute full vsan command applies to existing VSANs; it has no effect on VSANs that have not yet been created.
This example shows how to activate a zone set called zSet1 in VSAN 333:
switch(config)# zoneset activate name zSet1 vsan 333
This example shows how to clone a zone set called zSet1 into a new zoneset called zSetClone in VSAN 45:
switch(config)# zoneset clone existing zSet1 zSetClone vsan 45
This example shows how to distribute the operational values for the default zone to all zone sets in VSAN 22:
switch(config)# zoneset distribute full vsan 22
|
|
---|---|
system default zone distribute full |
Configures default values for distribution to a zone set |
show zoneset |
Displays zone set information. |
To merge zone set databases, use the zoneset command.
zoneset {distribute | export | import interface {fc slot/port | san-port-channel port-number}} vsan vsan-id
None
EXEC mode
|
|
4.0(0)N1(1a) |
This command was introduced. |
You can also enter the zoneset import and the zoneset export commands for a range of VSANs.
The zoneset distribute vsan vsan-id command is supported in interop 2 and interop 3 modes, and not in interop 1 mode.
This example shows how to import the zone set database from the adjacent switch connected through the VSAN 2 interface:
switch# zoneset import interface fc2/3 vsan 2
This example shows how to export the zone set database to the adjacent switch connected through VSAN 5:
switch# zoneset export vsan 5
This example shows how to distribute the zone set in VSAN 333:
switch# zoneset distribute vsan 333
|
|
---|---|
show zone status vsan |
Displays the distribution status for the specified VSAN. |
show zoneset |
Displays zone set information. |