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 SAN Switching commands available on Cisco NX-OS switches.
To clear device alias information, use the clear device-alias command.
clear device-alias { database | session | statistics }
|
|
This example shows how to clear the device alias session:
|
|
---|---|
Displays the state of the application's logical or physical locks. |
To clear the entire list of configured hosts, use the clear fcdomain command.
clear fcdomain session vsan vsan-id
|
|
---|---|
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:
|
|
---|---|
Displays local application information by the domain manager. |
To clear the name server statistics, use the clear fcns statistics command.
clear fcns statistics vsan vsan-id
|
|
---|---|
This example shows how to clear the name server statistics:
|
|
---|---|
To clear the Fabric Startup Configuration Manager (FSCM) log, use the clear fscm log command.
|
|
---|---|
This example shows how to clear the FSCM log:
|
|
---|---|
Displays local application information by the Fabric Startup Configuration Manager. |
To clear the fabric configuration server statistics, use the clear fcs statistics command.
clear fcs statistics vsan vsan-id
|
|
---|---|
This example shows how to clear the fabric configuration server statistics for VSAN 10:
|
|
---|---|
Displays fabric configuration server statistics information. |
To clear fctimer Cisco Fabric Services (CFS) session configuration and locks, use the clear fctimer session command.
|
|
You must enable the fctimer for CFS distribution before this command is valid.
This example shows how to clear an fctimer session:
|
|
---|---|
Displays local application information by the Fibre Channel timer. |
To clear the Fabric Shortest Path First (FSPF) statistics, use the clear fspf counters command.
clear fspf counters vsan vsan-id [ interface type ]
(Optional) Specifies that the counters are to be cleared for an interface. |
|
Interface type. The interface types are FC (Fibre Channel) and san-port-channel (SAN port channel). |
|
|
---|---|
If the interface is not specified, all of the counters of a VSAN are cleared. If the interface is specified, the counters of the specific interface are cleared.
The only type of valid interface is virtual Fibre Channel (VFC) interface.
This example shows how to clear the FSPF statistics on VSAN 1:
This example shows how to clear the FSPF statistics in VSAN 1 for the specified Fibre Channel interface:
|
|
---|---|
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 }
|
|
---|---|
This example shows how to clear the RLIR statistics for VSAN 1:
|
|
---|---|
To clear a Registered State Change Notification (RSCN) session for a specified VSAN, use the clear rscn session command.
clear rscn session vsan vsan-id
|
|
---|---|
The RSCN application must be enabled for CFS distribution before this command is valid.
This example shows how to clear an RSCN session on VSAN 1:
|
|
---|---|
To clear the Registered State Change Notification statistics for a specified VSAN, use the clear rscn statistics command.
clear rscn statistics vsan vsan-id
|
|
---|---|
This example shows how to clear the RSCN statistics for VSAN 1:
|
|
---|---|
To clear all configured information in the zone server for a specified VSAN, use the clear zone command.
clear zone { database | lock | statistics } vsan vsan-id
|
|
---|---|
After entering 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:
|
|
---|---|
To clear the smart zoning configuration, use the clear zone smart-zoning command.
clear zone smart-zoning {fcalias name fcalias-name vsan vsan-id | vsan vsan-id | zone name zone-name vsan vsan-id | zoneset name zoneset-name vsan vsan-id }
Specifies the fcalias name. The maximum size is 64 characters. |
|
Specifies the zoneset name. The maximum size is 64 characters. |
|
|
|
---|---|
The following example shows how to clear the smart zoing command for a VSAN:
|
|
---|---|
To discard a Distributed Device Alias Services (device alias) Cisco Fabric Services (CFS) distribution session in progress, use the device-alias abort command.
|
|
This example shows how to discard a device alias CFS distribution session in progress:
|
|
---|---|
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.
|
|
This example shows how to commit pending changes to the device-alias database:
|
|
---|---|
To initiate a Distributed Device Alias Services (device alias) session and configure the device alias database, use the device-alias database command. To deactivate the device alias database, use the no form of this command.
|
|
The device-alias database command starts a device alias session that locks all the databases on all the switches in this fabric. 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:
|
|
---|---|
Commits changes from the temporary device alias database to the active device alias database. |
|
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.
|
|
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:
|
|
---|---|
To import device alias database information from another 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
|
|
You can import legacy device name configurations using this feature without losing data, if they satisfy the following restrictions:
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, enter the device-alias distribute command to enable the modified global fcalias table to distribute device name configuration to all other switches in the physical fabric command so that new definitions are available everywhere.
This example shows how to import device alias information:
|
|
---|---|
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.
|
|
This example shows how to configure the device alias enhanced mode:
|
|
---|---|
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. The name can be a maximum of 64 alphanumeric characters. |
|
Specifies the pWWN ID. The format is hh : hh : hh : hh : hh : hh : hh : hh, where h is a hexadecimal number. |
Device alias database configuration mode
|
|
This example shows how to configure a device name alias entry in the device name database:
|
|
---|---|
To rename 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
New device name. The maximum length is 64 alphanumeric characters. |
Device alias database configuration mode
|
|
This example shows how to rename a device name alias entry in the device name database:
|
|
---|---|
To activate fabric binding in a 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
|
|
---|---|
You must enable the fabric-binding feature before you enter the fabric-binding activate command to work, Also this is licensed feature on ame on N7K.
This example shows how to activate the fabric binding database for the specified VSAN:
This example shows how to deactivate the fabric binding database for the specified VSAN:
This example shows how to forcefully activate the fabric binding database for the specified VSAN:
This example shows how to revert to the previously configured state or to the factory default (if no state is configured):
|
|
---|---|
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
|
|
---|---|
Fabric binding is configured on a per-VSAN basis and can be implemented in both Fibre Connection FICON VSANs and Fibre Channel VSANs.
If the configured database is empty, you cannot use this command.
This example shows how to copy from the active database to the configuration database in VSAN 1:
|
|
---|---|
Provides the differences between the fabric-binding databases. |
To view the differences between the active database and the configuration database in a VSAN, use the fabric-binding database diff command.
fabric-binding database diff { active | config } vsan vsan-id
|
|
---|---|
Fabric binding is configured on a per-VSAN basis and can be implemented in both FICON VSANs and Fibre Channel VSANs.
You must enable fabric-binding feature before you can use the fabric-binding database diff command.
This example shows how to display the differences between the active database and the configuration database in VSAN 1:
This example shows how to display information about the differences between the configuration database and the active database:
|
|
---|---|
Copies from the active to the configuration fabric binding database. |
To configure a user-specified fabric binding list in a 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
no fabric-binding database vsan vsan-id no swwn switch-wwn domain domain-id
|
|
---|---|
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 Inter Switch Link 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 add the sWWN and domain ID of a switch to the configured database list:
This example shows how to delete a fabric binding database for the specified VSAN:
This example shows how to delete the sWWN and domain ID of a switch from the configured database list:
|
|
---|---|
To enable fabric binding in a VSAN, use the fabric-binding enable command. To disable fabric binding, use the no form of this command.
|
|
---|---|
Fabric binding is configured on a per-VSAN basis.
you must enable fabric binding in each switch in the fabric that participates in the fabric binding.
This example shows how to enable fabric binding on that switch:
This example shows how to disable fabric binding on that switch:
|
|
---|---|
To clone a Fibre Channel alias, use the fcalias clone command.
fcalias clone origFcalias-Name cloneFcalias-Name vsan vsan-id
Fibre Channel alias. The name can be a maximum of 64 alphanumeric characters. |
|
|
|
---|---|
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 1:
|
|
---|---|
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
Name of the fcalias. The name can a maximum of 64 alphanumeric characters. |
|
|
|
---|---|
To include multiple members in any alias, use the FC ID, fWWN, or pWWN values.
This example shows how to configure an fcalias called AliasSample on VSAN 3:
|
|
---|---|
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
Current fcalias name. The name can be a maximum of 64 alphanumeric characters. |
|
New fcalias name. The name can be a maximum of 64 alphanumeric characters. |
|
|
|
This example shows how to rename an fcalias:
|
|
---|---|
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 }
|
|
---|---|
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 1:
This example shows how to specify the disruptive fabric reconfiguration for VSAN 1:
This example shows how to enable the domain manager fast restart for VSANs 7 through 10:
This example shows how to configure the fabric world wide name (fWWN) for VSAN 1:
|
|
---|---|
Displays global information about the Fibre Channel domain configurations. |
To flush cached data without committing the cached data and releasing the lock, use the fcdomain abort vsan command. To disable the flushing of cached data, use the no form of this command.
no fcdomain abort vsan vsan-id
|
|
---|---|
This example shows how to flush cached data:
|
|
---|---|
Displays global information about the Fibre Channel domain configurations. |
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.
no fcdomain commit vsan vsan-id
|
|
---|---|
This example shows how to commit cached data:
|
|
---|---|
Flushes cached data without committing and releases the lock. |
|
Displays global information about the Fibre Channel domain configurations. |
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.
|
|
---|---|
This example shows how to enable fabric distribution using CFS:
This example shows how to disable fabric distribution using CFS:
|
|
---|---|
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
|
|
---|---|
Use this command to configure the RCF reject option for the selected Fibre Channel or virtual Fibre Channel interface.
This example shows how to configure the Fibre Channel Over IP RCF reject fcdomain feature on a virtual Fibre Channel interface:
|
|
---|---|
Displays global information about the Fibre Channel domain configurations. |
|
Displays an interface configuration for a specified Fibre Channel interface. |
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 }
Network latency. The range is from 500 to 60000 milliseconds. |
|
|
|
---|---|
This example shows how to configure the network latency to 5000 milliseconds:
This example shows how to revert to the default switch latency:
|
|
---|---|
Displays the configured Fibre Channel drop latency parameters. |
To manually add a Fibre Channel ID (FC ID) to the default area company ID list, use the fcid-allocation command. To remove an FC ID 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
|
|
---|---|
Fibre Channel standards require a unique FC ID to be allocated to an N port attached to a Fx port in any switch. To conserve the number of FCIDs used, Cisco NX-OS 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 ID for other HBAs, 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 FCID is allocated. Regardless of the type (whole area or single) of FCID allocated, the FCID entries remain persistent.
This example shows how to add a new company FCID to the default area company ID list:
|
|
---|---|
Displays the configured Fibre Channel drop latency parameters. |
To allocate Fibre Channel IDs (FC IDs) on the switch, use the fcinterop fcid-allocation command. To disable FC IDs on the switch, use the no form of this command.
fcinterop fcid-allocation { auto | flat | none }
no fcinterop fcid-allocation { auto | flat | none }
|
|
---|---|
This example shows how to set the FC ID allocation to flat:
|
|
---|---|
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 ]
Port WWN. The format is hh : hh : hh : hh : hh : hh : hh : hh. |
|
|
---|---|
This example shows how to disable automatic polling for VSAN 2:
|
|
---|---|
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
Port WWN. The format is hh : hh : hh : hh : hh : hh : hh : hh. |
|
|
|
---|---|
You can configure name server to proxy another name server. You can display the name server information using the CLI, but you can view the name server by using either the CLI or the Cisco DCNM for SAN.
All name server registration requests come from the same port whose parameter is registered or changed. If a port request comes from a different port, then the request is rejected.
This example shows how to configure a proxy port for VSAN 2:
|
|
---|---|
Displays the name server database and statistical information for a specified VSAN or for all VSANs. |
To reject duplicate the Fibre Channel name server (FCNS) proxies on a VSAN, use the fcns reject-duplicate-pwwn vsan command.
fcns reject-duplicate-pwwn vsan vsan-id
no fcns reject-duplicate-pwwn vsan vsan-id
|
|
This example shows how to reject duplicate FCNS PWWNs for VSAN 2:
|
|
---|---|
Displays the name server database and statistical information for a specified VSAN or for all VSANs. |
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 ]]]
|
|
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 command requires the FCoE license.
Note fctrace is not supported.
This example shows how to configure an fcping operation for the FC ID of the destination. By default, five frames are sent.
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.
This example shows how to configure the timeout value:
This example shows how to display the fcping operation using the device alias of the specified destination:
|
|
---|---|
Displays the name server database and statistical information for a specified VSAN or for all VSANs. |
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 | port-channel port | vfc vfc-id } domain domain-id { metric number | remote | vsan vsan-id }}
no fcroute { fcid network-mask interface { fc slot / port | port-channel port | vfc vfc-id } domain domain-id { metric number | remote | vsan vsan-id }}
|
|
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:
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:
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:
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 the static route for a destination switch that is remotely connected for VSAN 3:
|
|
---|---|
Displays the preferred path route map configuration and status. |
|
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
|
|
This example shows how to enable FCS platform and node-name checking fabric wide:
|
|
---|---|
To register Fabric Configuration Server (FCS) attributes, use the fcs register command. To disable this feature, use the no form of this command.
|
|
This example shows how to register FCS attributes:
|
|
---|---|
To include a virtual device in a query about zone information from a Fabric Configuration Server (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 ]
|
|
Enter VSAN ranges 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:
This example shows how to add to more than one range of VSANs:
|
|
---|---|
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-active | auto-passive | on | off } [ timeout-period ]
|
|
You must enable FC-SP by using the feature fcsp command before you can use the fcsp command.
This example shows how to turn on the authentication mode for Fibre Channel interface in port 1 of slot 2:
This example shows how to revert to the factory default of auto-passive for the selected interface:
This example shows how to change the selected interface to initiate FC-SP authentication but do not permit reaunthentication:
|
|
---|---|
Displays an interface configuration for a specified interface. |
To configure Dixie-Hellman Challenge Handshake Protocol (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 ]}
|
|
You can see only the fcsp dhchap command if you enable FS-CP by using the feature fcsp command.
Using SHA-1 as the hash algorithm might 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:
This example shows how to configure the use of only the SHA-1 hash algorithm:
This example shows how to configure the use of only the MD-5 hash algorithm:
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:
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:
This example shows how to prioritize the use of DH group 2, 3, and 4 in the configured order:
This example shows how to configure a clear text password for the local switch:
This example shows how to configure a clear text password for the local switch to be used for the device with the specified WWN:
This example shows how to configure a password entered in an encrypted format for the local switch:
|
|
---|---|
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 }
|
|
This example shows how to configure the Fibre Channel Security Protocol (FC-SP) reauthentication on a virtual Fibre Channel interface:
|
|
---|---|
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.
no fcsp timeout timeout-period
|
|
You can see only 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:
|
|
---|---|
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 ]
ED_TOV. The range is from 1000 to 4000 milliseconds with a default of 2000. |
|
RA_TOV. The range is from 5000 to 100000 milliseconds with a default of 10000. |
|
|
|
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 keyword to configure different TOV values for specific VSANs. The VSAN must be suspended before you can alter the timers.
This example shows how to change the default Fibre Channel timers:
|
|
---|---|
To discard a Fibre Channel timer (fctimer) Cisco Fabric Services (CFS) distribution session that is in progress, use the fctimer abort command.
|
|
This example shows how to discard a CFS distribution session in progress:
|
|
---|---|
Displays the state of the CFS state for Fibre Channel timer. |
To commit pending configuration changes for the Fibre Channel timer (fctimer) Cisco Fabric Services (CFS) distribution session that is in progress, use the fctimer commit command.
|
|
This example shows how to commit pending changes to the Fibre Channel timer configuration:
|
|
---|---|
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.
|
|
Before distributing the Fibre Channel timer changes to the fabric, you must commit the temporary changes to the active configuration by using the fctimer commit command.
This example shows how to enable CFS distribution for the fctimer:
|
|
---|---|
Commits the Fibre Channel timer configuration changes to the active configuration. |
|
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 ]
Device alias name. The name can be a maximum of 64 alphanumeric characters. |
|
PWWN ID. The format is hh : hh : hh : hh : hh : hh : hh : hh. |
|
VSAN ID of the destination port. The range is from 1 to 4093. |
|
By default, the period to wait before timing out is 5 seconds.
|
|
This example shows how to trace a route to the specified FC ID in VSAN 1:
This example shows how to trace a route to the specified device alias in VSAN 1:
To suppress Fabric-Device Management Interface (FDMI) updates, use the fdmi suppress-updates command.
fdmi suppress-updates vsan vsan-id
|
|
This example shows how to suppress the FDMI updates in VSAN 1:
To install the Fibre Channel over Ethernet (FCoE) feature set in the default virtual device context (VDC), use the install feature-set fcoe command.
|
|
---|---|
This command was introduced on the Cisco Nexus 7000 and 9000 Series Switches. |
This example shows how to install the FCoE feature set in the default VDC:
|
|
---|---|
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.
|
|
Additional FC-SP commands are available when you enable the FC-SP feature.
This example shows how to enable FC-SP:
|
|
---|---|
To enable N port identifier virtualization (NPIV) for all VSANs on a switch, use the feature npiv command. To disable NPIV, use the no form of this command.
|
|
NPIV allows you 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:
This example shows how to disable NPIV for all VSANs on the switch:
|
|
---|---|
To enable port tracking for indirect errors, use the feature port-track command. To disable this feature, use the no form of this command.
|
|
The Cisco NX-OS 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:
This example shows how to disable port tracking:
|
|
---|---|
Displays configuration and status information for a specified Fibre Channel interface. |
|
Displays configuration and status information for a specified SAN port channel interface. |
To configure a Fabric Shortest Path First (FSPF) feature for an entire 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 fspf config vsan vsan-id {no min-ls-arrival ls-arrival-time | no min-ls-interval ls-interval-time | no region region-id | no spf {hold-time spf-holdtime | static}
This command is not applicable to virtual Fibre Channel interfaces.
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.
|
|
Use the fspf config command to enter FSPF configuration mode for the specified VSAN. In FSPF configuration mode, the fscp config 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:
To configure the Fabric Shortest Path First (FSPF) link cost for a Fibre Channel over IP (FCIP) interface or virtual Fibre Channel 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
|
|
FSPF tracks the state of links on all switches in the fabric, associates a cost with each link in its database, and chooses the path with a minimal cost. You can change the cost associated with an interface can be changed by using the fspf cost command to implement the FSPF route selection.
For virtual Fibre Channel interfaces, this command configures the FSPF parameters for the virtual E (VE) port.
This example shows how to configure the FSPF link cost on an FCIP interface:
This example shows how to configure the FSPF link cost on a virtual Fibre Channel interface:
|
|
---|---|
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
FSPF dead interval in seconds. The range is from 2 to 65535. |
|
|
|
This value must be the same in the ports at both ends of the Inter-Switch-Link (ISL).
For virtual Fibre Channel interfaces, this command configures the FSPF parameters for the virtual E (VE) port.
This example shows how to configure the maximum interval of 4000 seconds for a hello message before the neighbor is considered lost:
This example shows how to configure the maximum interval of 300 seconds for a hello message in a virtual Fibre Channel interface before the neighbor is considered lost:
|
|
---|---|
Displays an interface configuration for a specified Fibre Channel interface. |
|
To enable Fabric Shortest Path First (FSPF) for a VSAN, use the fspf enable command. To disable FSPF routing protocols, use the no form of this command.
|
|
This command is not applicable to virtual Fibre Channel interfaces.
This example shows how to enable a FSPF in VSAN 5 and disable FSPF in VSAN 7:
|
|
---|---|
To verify the health of the link, use the fspf hello-interval command. To revert to the default settings, use the no form of this command.
fspf hello-interval seconds vsan vsan-id
no fspf hello-interval seconds vsan vsan-id
FSPF interval in seconds. The range is from 2 to 65535 for Fibre Channel over IP (FCIP) interfaces and from 1 to 65534 for virtual Fibre Channel interfaces. |
|
|
|
This command configures Fabric Shortest Path First (FSPF) for the specified Fibre Channel interface. This value must be the same in the ports at both ends of the Inter-Switch-Link (ISL) for Fibre Channel over IP (FCIP) interfaces.
For virtual Fibre Channel interfaces, this command configures the FSPF parameters for the virtual E (VE) port.
This example shows how to configure a hello interval of 3 seconds on VSAN 1:
This example shows how to configure a hello interval of 30 seconds for a virtual Fibre Channel interface on VSAN 1:
|
|
---|---|
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.
|
|
By default, FSPF is enabled on all E ports and TE ports of an Fibre Channel over IP (FCIP) interface. You by using the fspf passive command. You must enable FSPF on the ports at both ends of the Inter-Switch-Link (ISL) for the protocol to operate correctly.
For virtual Fibre Channel interfaces, this command configures the FSPF parameters for the virtual E (VE) port.
This example shows how to disable the FSPF protocol for a virtual Fibre Channel interface on VSAN 1 and verify the interface configuration:
|
|
---|---|
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 settings, use the no form of this command.
fspf retransmit-interval seconds vsan vsan-id
no spf retransmit-interval seconds vsan vsan-id
Fabric Shortest Path First (FSPF) retransmit interval in seconds. The range is from 1 to 65535. |
|
|
|
This value must be the same in the ports at both ends of the ISL for Fibre Channel over IP (FCIP) interfaces.
For virtual Fibre Channel interfaces, this command configures the FSPF parameters for the virtual E (VE) port.
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:
This example shows how to specify a retransmit interval of 3 seconds after which an unacknowledged link state update should be transmitted on the virtual Fibre Channel interface on VSAN 1:
|
|
---|---|
Displays an interface configuration for a specified Fibre Channel over IP (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 ] [, ] [ - ]
(Optional) Allows you to enter multiple VSANs separated by commas or a range of VSANs separated by a dash. |
|
|
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:
This example shows how to disable in-order delivery for the entire switch:
This example shows how to enable in-order delivery for a specific VSAN:
This example shows how to disable in-order delivery for a specific VSAN:
|
|
---|---|
To add a member name to a Fibre Channel alias on a 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 devicealias name both initiator target | domain-id domain-id | fcid fc-id both initiator target | fwwn fwwn-id | interface fc slot/port | ip-address ip-address | pwwn pwwn-id both initiator target | symbolic-nodename nodename}
no member {device-alias devicealias name both initiator target | domain-id domain-id | fcid fc-id both initiator target | fwwn fwwn-id | interface fc slot/port | ip-address ip-address | pwwn pwwn-id both initiator target | symbolic-nodename nodename}
|
|
---|---|
Added the keywords both, initiator, target to the syntax description. |
|
This example shows how to add a member to an alias called samplealias:
This example shows how to define a Fibre Channel interface for the member:
This example shows how to delete the specified member:
This example shows how to add the IP address member to fcalias:
This example shows how to specify the device type as initiator:
This example shows how to specify the device type as target:
This example shows how to specify the device type as both:
|
|
---|---|
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 device aliasname [both initiator target] | domain-id domain-id port-number port | fcalias alias-name | fcid fc-id [both initiator target] | fwwn fwwn-id | interface fc slot / port [ domain-id domain-id | swwn swwn-id ] | pwwn pwwn-id [ lun lun-id ] [ both initiator target] | symbolic-nodename nodename }
no member { device-alias device aliasname [both initiator target] | domain-id domain-id port-number port | fcalias alias-name | fcid fc-id [both initiator target] | fwwn fwwn-id | interface fc slot / port [ domain-id domain-id | swwn swwn-id ] | pwwn pwwn-id [ lun lun-id ] [ both initiator target] | symbolic-nodename nodename }
Zone set zone configuration mode and zoneset-zone configuration mode
|
|
---|---|
Added the keywords both, initiator, target to the syntax description. |
|
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:
This example shows how to add a zone to a zone set called Zoneset1 on VSAN 1:
This example shows how to assign a Fibre Channel interface member into a zone:
This example shows how to delete the specified device from a zone:
switch(config-zoneset-zone)# no member interface fc 3/1
This example shows how to specify the device type as both:
This example shows how to specify the device type as initiator:
|
|
---|---|
To configure zone set members, use the member command. To remove a zone set member, use the no form of this command.
Member name. The name can be a maximum of 64 alphanumeric characters. |
|
|
This example shows how to add a member zone to a zone set:
|
|
---|---|
To purge persistent Fibre Channel IDs (FCIDs), use the purge fcdomain fcid command.
purge fcdomain fcid vsan vsan-id
|
|
This example shows how to purge all dynamic, unused FCIDs in VSAN 4:
This example shows how to purge all dynamic, unused FCIDs in VSANs 4, 5, and 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
By default, the switch sends RLIR frames to one of the hosts in the VSAN with the register function set to “conditionally receive” if no hosts have the register function set to “always receive.”
|
|
---|---|
The switch sends RLIR frames to the preferred host only if it meets the following conditions:
This example shows how to specify the FC ID 0x654321 as the Registered Link IncidentRF Report (RLIR) preferred host for VSAN 2:
switch(config)# rlir preferred-cond fcid 0x654321 vsan 2
Stub Library could not be opened
*** libficoncmi.so: cannot open shared object file: No such file or directory *
This example shows how to remove the FCID 0x654321 as the RLIR preferred host for VSAN 2:
|
|
---|---|
Displays information about RLIR, Link Incident Record Registration (LIRR), and Distribute Registered Link Incident Record (DRLIR) frames. |
|
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. To revert to the default settings, use the no form of this command.
rscn {abort vsan vsan-id | commit vsan vsan-id | distribute | event-tov event-timeout vsan vsan-id multi-pid vsan vsan-id | restrict swrscn-event vsan vsan-id | suppress domain-swrscn vsan vsan-id }
no rscn {abort vsan vsan-id | commit vsan vsan-id | distribute | event-tov event-timeout vsan vsan-id multi-pid vsan vsan-id | restrict swrscn-event vsan vsan-id | suppress domain-swrscn vsan vsan-id }
|
|
This example shows how to configure RSCNs in multi-PID format:
|
|
---|---|
To cancel a Registered State Change Notification (RSCN) configuration on a VSAN, use the rscn abort command. To reverse the cancellation, use the no form of this command.
Specifies the VSAN where the RSCN configuration should be canceled. |
|
|
|
---|---|
This example shows how to cancel an RSCN configuration on 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.
Specifies the VSAN where the RSCN configuration should be committed. |
|
|
|
---|---|
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:
|
|
---|---|
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.
|
|
---|---|
The RSCN timer configuration must be the same on all switches in the VSAN. Cisco Fabric Services (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:
|
|
---|---|
To configure an event timeout value for a Registered State Change Notification (RSCN) on a specified 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
Event timeout value in milliseconds. The range is from 0 to 2000. |
|
Specifies the VSAN where the RSCN event timer should be used. |
|
The default timeout values are 2000 milliseconds for Fibre Channel VSANs.
|
|
---|---|
Before changing the timeout value, you must enable RSCN configuration distribution by 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:
|
|
---|---|
To display the device name information, use the show device-alias command.
show device-alias { database | merge status | name device-name [ pending ] | pending | pending-diff | pwwn pwwn-id [ pending ] | session status | statistics | status}
|
|
---|---|
To make use of fcaliases as device names instead of using the cryptic device name, add only one member per fcalias.
This example shows how to display the contents of the device alias database:
This example shows how to display all global fcaliases and all VSAN dependent fcaliases:
This example shows how to display all global fcaliases and all VSAN-dependent fcaliases:
|
|
---|---|
To display configured fabric binding information, use the show fabric-binding command.
show fabric-binding { database [ active ] [ vsan vsan-id ] | efmd statistics [ vsan vsan-id ] | statistics [ vsan vsan-id ] | status [ vsan vsan-id ] | violations [ last number ]}
(Optional) Displays the active database configuration information. |
|
(Optional) Specifies the Fibre Connection (FICON) enabled VSAN ID. |
|
|
|
---|---|
This example shows how to display the configured fabric binding database information:
This example shows how to display the active fabric binding information:
This example shows how to display the active VSAN-specific fabric binding information for 61:
This example shows how to display the configured VSAN-specific fabric binding information for VSAN 4:
This example shows how to display the fabric binding statistics:
This example shows how to display the fabric binding status for each VSAN:
This example shows how to display the EFMD statistics:
This example shows how to display the EFMD statistics for a specified VSAN:
This example shows how to display the fabric binding violations:
|
|
---|---|
To display FC2 information, use the show fc2 command.
show fc2 { bind | classf | exchange | exchresp | flogi | nport | plogi | plogi_pwwn | port brief | socket | sockexch | socknotify | socknport | vsan }
Displays FC2 local N port PLOGI/LOGO notifications for each socket. |
|
|
|
---|---|
This example shows how to display the FC2 active socket information:
This example shows how to display the FC2 socket binding information:
This example shows how to display the FC2 local N port information:
This example shows how to display the FC2 PLOGI session information:
This example shows how to display the FC2 physical port information:
This example shows how to display the FC2 local N port PLOGI notifications for each socket:
This example shows how to display the FC2 local N ports for each socket:
This example shows how to display the FC2 VSAN table:
To display the member name information in a Fibre Channel alias (fcalias), use the show fcalias command.
show fcalias [ name fcalias-name ] [ pending ] [ vsan vsan-id ]
(Optional) Displays fcalias information for a specific name. |
|
(Optional) Name. The maximum length is 64 alphanumeric characters. |
|
Displays a list of all global fcaliases and all VSAN-dependent fcaliases.
|
|
---|---|
To make use of fcaliases as device names instead of using the cryptic device name, add only one member per fcalias.
This example shows how to display the fcalias configuration information for VSAN 1:
|
|
---|---|
To display the Fibre Channel domain (fcdomain) information, use the show fcdomain command.
show fcdomain [ address-allocation [ cache ] | allowed | domain-list | fcid persistent [ unused ] | pending [ vsan vsan-id ] | pending-diff [ vsan vsan-id ] | session-status [ vsan vsan-id ] | statistics [ interface { fc slot / port [ vsan vsan-id ] } | san-port-channel port [ vsan vsan-id ] ] | status | vsan vsan-id ]
|
|
---|---|
When you enter the show fcdomain with no arguments, all VSANs appear. The VSANs should be active or you get an error.
This example shows how to display the fcdomain information for VSAN 1:
This example shows how to display the fcdomain domain-list information for VSAN 76:
Table 1-1 describes the significant fields shown in the show fcdomain domain-list command output.
This example shows how to display the allowed domain ID lists for VSAN 1:
This example shows how to display the status of the Cisco Fabroic Services (CFS) distribution for allowed domain ID lists:
This example shows how to display the pending configuration changes for VSAN 10:
This example shows how to display the differences between the pending configuration and the current configuration for VSAN 10:
This example shows how to display the status of the distribution session for VSAN 1:
|
|
---|---|
To display the configured Fibre Channel latency parameters, use the show fcdroplatency command.
show fcdroplatency [ network | switch ]
|
|
---|---|
This example shows how to display the configured Fibre Channel latency parameters:
|
|
---|---|
Configures the network and switch Fibre Channel drop latency time. |
To display the Fibre Channel area list of company IDs, use the show fcid allocation command.
show fcid-allocation area | company-id-from-wwn wwn [ company-id ]
Displays the company ID from the specified world wide name (WWN). |
|
(Optional) Company ID (also known as Organizational Unit Identifier, or OUI) to display. |
|
|
---|---|
This example shows how to display the Fibre Channel area company list of company IDs:
Table 1-2 describes the significant fields shown in the display.
|
|
---|---|
|
|
---|---|
To display the results of the discovery or to display the name server database for a specified VSAN or for all VSANs, use the show fcns database command.
show fcns database { detail [ vsan vsan-id ] | domain domain-id [ detail ] [ vsan vsan-range ] | fcid fcid-id [ detail ] vsan vsan-range | local [ detail ] [ vsan vsan-range ] | vsan vsan-id | npv [detail] vsan vsan-id node_wwn node_wwn vsan vsan-id proxy-host vsan vsan-id }
|
|
---|---|
The discovery can take several minutes to complete, especially if the fabric is large or if several devices are slow to respond.
Virtual enclosure ports can be viewed by using the show fcns database command.
This example shows how to display the contents of the FCNS database:
This example shows how to display the detailed contents of the FCNS database:
This example shows how to display the management VSAN (VSAN 2):
This example shows how to display the database for all configured VSANs:
|
|
---|---|
Specifies the configuration mode command for the name server configuration. |
To display the statistical information for a specified VSAN or for all VSANs, use the show fcns statistics command.
show fcns statistics [ detail ] [ vsan vsan-id ]
|
|
---|---|
This example shows how to display the statistical information for a specified VSAN:
|
|
---|---|
Specifies the configuration mode command for the name server configuration. |
To view specific information about existing Fibre Channel and Fabric Shortest Path First (FSPF) configurations, use the show fcroute command.
show fcroute { distance | label [ label ] vsan vsan-id | multicast [ fc-id vsan vsan-id | vsan vsan-id ] | summary [ vsan vsan-id ] | unicast [[ host ] fc-id fc-mask vsan vsan-id | vsan vsan-id ]}
Unicast routes for hosts that match the range of FCIDs that are specified by the mask. |
|
|
---|---|
When the number of routes is displayed in the command output, both visible and hidden routes are included in the total number of routes.
This example shows how to display the administrative distance:
This example shows how to display the multicast routing information:
This example shows how to display the FC ID information for a specified VSAN:
This example shows how to display the FC ID and interface information for a specified VSAN:
This example shows how to display the unicast routing information:
This example shows how to display the unicast routing information for a specified VSAN:
This example shows how to display the unicast routing information for a specified FC ID:
This example shows how to display the route database information:
This example shows how to display the route database information for a specified VSAN:
|
|
---|---|
Configures Fibre Channel routes and activates policy routing. |
To display the Fibre Channel timers (fctimers), use the show fctimer command.
show fctimer [ d_s_tov [ vsan vsan-id ] | e_d_tov [ vsan vsan-id ] | f_s_tov [ vsan vsan-id ] | r_a_tov [ vsan vsan-id ] | last action status | pending | pending-diff | session status | status | vsan vsan-id ]
|
|
---|---|
This example shows how to display the configured global TOVs:
This example shows how to display the configured TOVs for a specified VSAN:
|
|
---|---|
To display the Fabric-Device Management Interface (FDMI) database information, use the show fdmi command.
show fdmi database [ detail [ hba-id { hba-id vsan vsan-id } | vsan vsan-id ] | vsan vsan-id ] | suppress-updates
(Optional) Displays detailed information for the specified host bus adapter (HBA) entry. |
|
(Optional) Specifies FDMI information for the specified VSAN. |
|
|
|
---|---|
This example shows how to display all HBA management servers:
This example shows how to display the VSAN 1-specific FDMI information:
This example shows how to display the details for the specified HBA entry in VSAN 1:
|
|
---|---|
To list all the fabric login (FLOGI) sessions through all interfaces across all VSANs, use the show flogi command.
show flogi { auto-area-list } | database { fcid fcid-id | interface { fc slot / port | vfc vfc-id } | vsan vsan-id }
|
|
---|---|
The output of this command is sorted by interface numbers and then by VSAN IDs.
In a Fibre Channel fabric, each host or disk requires an FC ID. Use the show flogi database command to verify if a storage device is displayed in the fabric login (FLOGI) table as in the Examples section. If the required device is displayed in the FLOGI table, the fabric login is successful. Examine the FLOGI database on a switch that is directly connected to the host HBA and connected ports.
This example shows how to display the list of Organisational Unit Identifiers that are allocated areas:
This example shows how to display the details about the FLOGI database:
This example shows how to display a specific FLOGI interface:
This example shows how to display the FLOGI for VSAN 100:
This example shows how to display the FLOGI for a specific FC ID:
|
|
---|---|
To display global Fibre Shortest Path First (FSPF) routing information, use the show fspf command.
show fspf [ database [ vsan vsan-id ] [ detail | domain domain-id detail ] | interface | vsan vsan-id interface { fc slot / port | port-channel port-channel number | san-port-channel port-channel-number| vfc vfc-id }]
Slot and port number. The range for slot numbers is from 1 to 12 |
|
Port channel number. The range for port numbers is from 1 to 256. |
|
|
|
---|---|
If you enter the command without parameters, all the entries in the database are displayed.
This example shows how to display the FSPF interface information:
This example shows how to display the FSPF database information:
This command shows how to display the FSPF information for a specified VSAN:
This command shows how to display the FSPF information for all interfaces:
|
|
---|---|
To display Registered Link Incident Report (RLIR) information, use the show rlir command.
show rlir { erl [ vsan vsan-id ] | history | recent { interface fc slot / port | portnumber port } | statistics [ vsan vsan-id ]}
Slot and port number. The range for the slot numbers is from 1 to 12 and the range for the port numbers is from 1 to 48. |
|
Displays RLIR statistics for all VSANs or the specified VSAN. |
|
|
---|---|
This example shows how to display the RLIR information for VSAN 1:
This example shows how to display the RLIR statistics for VSAN 1:
|
|
---|---|
To display Registered State Change Notification (RSCN) information, use the show rscn command.
show rscn {brief-log | event-tov vsan vsan-id | pending vsan vsan-id | pending-diff vsan vsan-id | scr-table [ vsan vsan-id ] | session status vsan vsan-id | statistics [ vsan vsan-id ]}
Displays the difference between the active and the pending configuration. |
|
|
|
---|---|
The SCR table cannot be configured. It is only populated if one or more N ports send SCR frames to register for RSCN information. If the show rscn scr-table command does not return any entries, no N port is interested in receiving RSCN information.
This example shows how to display the RSCN information on VSAN 1:
This example shows how to display the RSCN statistics on VSAN 1:
This example shows how to display he RSCN event timeout value configured on VSAN 1:
This example shows how to display the difference between the active RSCN configuration and the pending RSCN configuration on VSAN 1:
|
|
---|---|
To display the trunk protocol status, use the show trunk protocol command.
|
|
---|---|
This example shows how to display the trunk protocol status:
|
|
---|---|
Configures the trunking protocol for Fibre Channel interfaces. |
To display information about configured VSAN, use the show vsan command.
show vsan [ vsan-id [ membership ] | membership [ interface { fc slot / port | san-port-channel port | vfc vfc-id }] | usage ]
|
|
---|---|
When you enter the show vsan membership interface command, interface information appears for interfaces that are configured in this VSAN.
The interface range must be in ascending order and nonoverlapping. You can specify a range using a hyphen and several interfaces using commas:
This example shows how to display the configured VSAN information:
This example shows how to display the membership information for all VSANs:
This example shows how to display the membership information for a specified interface:
|
|
---|---|
To display the status of the WWN configuration, use the show wwn command.
show wwn { status [ block-id number ] | switch | vsan-wwn }
(Optional) Displays the WWN usage and alarm status for a block ID. |
|
|
|
---|---|
This example shows how to display the WWN of the switch:
This example shows how to display a user-configured VSAN WWN:
|
|
---|---|
Configures a WWN for a suspended VSAN that has interop mode 4 enabled. |
To display zone information, use the show zone command.
show zone [ active [ vsan vsan-id ] | analysis { active vsan vsan-id | vsan vsan-id | zoneset zoneset-name } | ess [ vsan vsan-id ] | member { fcalias alias-name | fcid fc-id [ active | lun lun-id | vsan vsan-id ] | pwwn wwn [ active | lun lun-id | vsan vsan-id ]} | name string [ active ] [ pending ] [ vsan vsan-id ] | pending [ active ] [ vsan vsan-id ] | pending-diff [ vsan vsan-id ] | policy [ pending ] [ vsan vsan-id ] | statistics [ vsan vsan-id ] | status [ vsan vsan-id ]]
|
|
---|---|
This example shows how to display the configured zone information:
This example shows how to display the zone information for a specific VSAN:
This example shows how to display the members of a specific zone:
This example shows how to display all zones to which a member belongs using the PWWN:
This example shows how to display the number of control frames exchanged with other switches:
This example shows how to display the status of the configured zones:
This example checks the status of the zoneset distribute vsan command and displays the default zone attributes of a specific VSAN or all active VSANs:
This example shows how to display the zone status:
This example shows how to display zones that are part of the active zoneset:
Table 1-3 describes the significant fields shown in the show zone status vsan display.
|
|
---|---|
To display detailed analysis and statistical information about the zoning database, use the show zone analysis command.
show zone analysis { active vsan vsan-id | pending | vsan vsan-id | zoneset name vsan vsan-id }
Displays zone set analysis information for the specified zone set. |
|
|
|
---|---|
This example shows how to display the detailed statistics and analysis of the active zoning database for VSAN 1:
This example shows how to display the detailed statistics and analysis of the full zoning database for VSAN 1:
Table 1-4 describes the fields displayed in the output of the show zone analysis command for the full zoning database.
This example shows how to display the zone set analysis information for VSAN 100:
|
|
---|---|
To display the zone global information, use the show zone internal global-info command.
show zone internal global-info
|
|
---|---|
The following example displays the zone server internal state for a VSAN:
To display the zone server internal state for a VSAN, use the show zone internal vsan command.
show zone internal vsan vsan-id
|
|
---|---|
The following example displays the zone server internal state for a VSAN:
To display the zone policies, use the show zone policy command.
|
|
---|---|
Changed the command output to include (smart-zone disabled). |
The following example displays the zone policies:
To display the previous auto convert status, use the show zone smart-zoning auto-conv command.
show zone smart-zoning auto-conv{log errors | status vsan vsan-id}
|
|
---|---|
The following example displays the previous auto convert status for a VSAN:
To display the configured zone sets, use the show zoneset command.
show zoneset [ active [ vsan vsan-id ] | brief [ active [ vsan vsan-id ] | vsan vsan-id ] | name zoneset-name [ active [ vsan vsan-id ] | brief [ active [ vsan vsan-id ] | vsan vsan-id ] | vsan vsan-id ] | pending [ active [ vsan vsan-id ] | brief [ active [ vsan vsan-id ] | vsan vsan-id ] | vsan vsan-id ] | vsan vsan-id
Zone set name. The maximum size is 64 alphanumeric characters. |
|
|
|
---|---|
This example shows how to display the configured zone set information for VSAN 1:
This example shows how to display the configured zone set information for a VSANs 2 and 3:
|
|
---|---|
To configure an Ethernet interface as a trunk port, use the switchport mode trunk command. To remove the configuration, use the no form of this command.
|
|
---|---|
You must configure the Ethernet interface as a trunk port to allow both Fibre Channel and Ethernet traffic on the same interface.
Note On Cisco NX-OS 5.0(2)N1(1), the switchport trunk mode is on by default for virtual Fibre Channel interfaces and cannot be configured.
This example shows how to enable the trunk mode for interface Ethernet 2/1:
|
|
---|---|
Displays information on all interfaces configured as switch ports. |
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 }}
|
|
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:
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:
This example shows how to configure the trunk mode:
|
|
---|---|
To configure default values for a zone, use the system default zone default-zone permit command. To revert to the default settings, use the no form of this command.
system default zone default-zone permit
no system default zone default-zone permit
|
|
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.
Use the system default zone default-zone permit command only be used with VSANs that have not yet been created; this command 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:
This example shows how to restore the default setting:
|
|
---|---|
Defines whether a default zone (nodes not assigned a created zone) permits or denies access to all in the default zone. |
|
To configure default values for a zone, use the system default zone command. To revert to the default settings, use the no form of this command.
system default zone {default-zone permit | distribute full | gs read read-write | mode enhanced}
no system default zone {default-zone permit | distribute full | gs read read-write | mode enhanced}
Specifies the default zone generic services permission as read. |
|
Specifies the default zone generic services permission as read-write. |
|
|
|
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.
Use the system default zone distribute full command only be used with VSANs that have not yet been created; thus command 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 configure the default values for enhanced zone mode:
This example shows how to configure the default zone generic services permission as read:
This example shows how to configure the default zone generic services permission as read-write:
This example shows how to distribute the default values to the active zone set only:
|
|
---|---|
Distributes the operational values for the default zone to all zone sets. |
|
To configure the default values for smart zoning, use the system default zone smart-zone command in the configuration mode. To disable this feature, use the no form of the command.
system default zone smart-zone enable
no system default zone smart-zone enable
|
|
---|---|
The following example shows how to configure the default values for smart-zone :
|
|
---|---|
Displays the default value of zone mode as basic and enhanced. |
To configure the trunking protocol for virtual Fibre Channel and virtual port channel interfaces, use the trunk protocol enable command. To disable this feature, use the no form of this command.
|
|
You disable the trunking protocol 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 Inter-Switch Link (ISL). Before you merge traffic, you must disable the trunking protocol.
This example shows how to disable the trunk protocol feature:
This example shows how to enable the trunk protocol feature:
|
|
---|---|
To create multiple fabrics that share 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 create 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 [ 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 }]]
VSAN database configuration mode
|
|
---|---|
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:
For example, show int fc2/1 - 3, fc2/4, fc3/2
For example, show int san-port-channel 5.1
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:
This example shows how to suspend a VSAN and enable Interop mode 4:
This example shows how to configure a VSAN to create a Fibre Channel over Ethernet (FCOE)-VLAN to VSAN mapping:
This example shows how to remove interface fc2/1 from VSAN 7:
|
|
---|---|
Configures a WWN for a suspended VSAN that has interop mode 4 enabled. |
To enter VSAN database mode to configure VSAN information and membership, use the vsan database command.
|
|
---|---|
To exit from the VSAN database configuration mode, use the exit command.
This example shows how to enter the VSAN database configuration mode:
|
|
---|---|
Displays the Fibre Channel over Ethernet (FCoE) VLAN to VSAN mappings. |
|
To allocate a secondary MAC address to a SAN node, use the wwn secondary-mac command.
wwn secondary-mac wwn-id range address-range
Secondary MAC address. The format is hh : hh : hh : hh : hh : hh. |
|
|
|
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.
This example shows how to allocate a secondary range of MAC addresses:
To configure a WWN for a suspended VSAN that has interop mode 4 enabled, use the wwn vsan command. To discard the configuration, use the no form of this command.
no wwn vsan vsan-id vsan-wwn wwn
VSAN WWN. The format is hh : hh : hh : hh : hh : hh : hh : hh. |
|
|
---|---|
This command can succeed only if the following conditions are satisfied:
This example shows how to assign a WWN to a VSAN:
To clone a zone name, use the zone clone command.
zone clone current-zone-name new-zone-name vsan vsan-id
Zone attribute group name. The name can be a maximum of 64 characters. |
|
|
|
---|---|
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:
|
|
---|---|
To commit zoning changes to a 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 ]
|
|
---|---|
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:
|
|
---|---|
To compact a zone database in a VSAN, use the zone compact command.
|
|
8000 zones are supported in a Cisco NX-OS switch.
If you attempt to merge VSANs, the merge fails if more than 2000 zones are present in a VSAN and the neighboring VSAN cannot support more than 2000 zones.
Activation fails 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:
|
|
---|---|
Displays detailed analysis and statistical information about the zoning database. |
To configure smart zoning convert commands, use the zone convert smart-zoning command in configuration mode.
zone convert smart-zoning {fcalias name fcalias-name vsan vsan-id | vsan vsan-id | zone name zone-name vsan vsan-id | zoneset name zoneset-name vsan vsan-id }
Specifies the fcalias name. The maximum size is 64 characters. |
|
Specifies the zoneset name. The maximum size is 64 characters. |
|
|
|
---|---|
The following example shows how to Specify the auto convert commands for a VSAN.
|
|
---|---|
Displays the status of the auto conversion that just happened. |
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: }
|
|
This example shows how to copy the active zone set to the full zone set:
This example shows how to copy the active zone set in VSAN 3 to a remote location using SCP:
|
|
---|---|
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
|
|
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:
|
|
---|---|
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
|
|
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:
|
|
---|---|
To enable enhanced zoning for a 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
|
|
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 for VSAN 10:
|
|
---|---|
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
Name of the zone. The name can be a maximum of 64 characters. |
|
|
|
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). Enter the zone name commands 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, FC ID, or Fibre Channel alias) and value specified:
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:
|
|
---|---|
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.
Name of the zone. The name can be a maximum of 64 characters. |
|
|
This example shows how to configure a zone in a zone set:
This example shows how to delete a zone from a zone set:
|
|
---|---|
To rename a zone, use the zone rename command.
zone rename current-name new-name vsan vsan-id
Current fcalias name. The name can be a maximum of 64 characters. |
|
New fcalias name. The name can be a maximum of 64 characters. |
|
|
|
This example shows how to rename a zone:
|
|
---|---|
To switch the port-address format, use th zone rscn address-format port command. To revert to the default format, use the no form of this command.
zone rscn address-format port vsan vsan-id
no zone rscn address-format port vsan vsan-id
|
|
This example shows how to switch the port-address format:
|
|
---|---|
To enable the smart zoning feature, use the zone smart-zoning enable command. To disbale this feature, use the no form of this command.
zone smart-zoning enable vsan vsan-id
no zone smart-zoning enable vsan vsan-id
|
|
The following example shows how to enable the smart zoning feature on the given VSAN:
|
|
---|---|
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 | capability change-abort distribute full | 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 | capability change-abort distribute full | 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 }
(Optional) Zone set name. The name can be a maximum of 64 alphanumeric characters. |
|
Clones a zone set from the current name to a new name. The name can be a maximum of 64 characters. |
|
|
|
Zones are activated by activating the parent zone set.
Use the zoneset distribute full vsan command to distribute 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:
This example shows how to clone a zone set called zSet1 into a new zone set called zSetClone in VSAN 45:
This example shows how to distribute the operational values for the default zone to all zone sets in VSAN 22:
|
|
---|---|
To merge zone set databases, use the zoneset command.
zoneset { distribute | export | import interface { vfc vfc-id } vsan vsan-id
|
|
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 but 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:
This example shows how to export the zone set database to the adjacent switch connected through VSAN 5:
This example shows how to distribute the zone set in VSAN 333:
|
|
---|---|