The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter describes the Cisco NX-OS Fibre Channel, virtual Fibre Channel, and Fibre Channel over Ethernet (FCoE) commands that begin with S.
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
Converts the autocreated SAN port channel to a persistent SAN port channel |
|
|
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:
|
|
---|---|
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 ]}
(Optional) Specifies a VSAN ID. The range is from 1 to 4093. |
|
Configures SCSI target name-server polling globally or per VSAN. |
|
|
|
---|---|
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:
This example shows how to remove the SCSI target auto-polling discovery for VSAN 1:
This example shows how to configure a SCSI target discovery:
This example shows how to configure a SCSI target ns-polling discovery for VSAN 1:
This example shows how to remove a SCSI target ns-polling discovery for VSAN 1:
This example shows how to configure a SCSI target on-demand discovery for VSAN 1:
This example shows how to remove a SCSI target on-demand discovery for VSAN 1:
|
|
---|---|
Discovers SCSI targets on local storage to the switch or remote storage across the fabric. |
|
Displays information about existing SCSI target configurations. |
To change the virtual Fibre Channel interface or SAN port channel interface state to administrative down, use the shutdown command. To enable an interface, use the no form of this command.
(Optional) Specifies that the interface state be forcefully changed to administrative down. |
Virtual Fibre Channel interface configuration mode
SAN port channel configuration mode
This example shows how to disable virtual Fibre Channel interface 3:
This example shows how to enable virtual Fibre Channel interface 3:
This example shows how to forcefully bring a SAN port channel interface to the administratively down state:
|
|
---|---|
Displays the specified VFC interface, attributes, and status. |
|
Displays the specified VFC interface, attributes, and status. |
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.
|
|
---|---|
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:
This example shows how to restore traffic on an interface after you have shut down, or disabled, the interface:
|
|
---|---|
To configure a switch port parameter on a Fibre Channel, use the switchport command. To discard the configuration, use the no form of this command.
switchport
{ fcrxbbcredit { number [ 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 }}
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.
|
|
You can specify a range of interfaces by entering a command with the following example format:
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:
This example shows how to configure the switch port parameters for a Fibre Channel interface:
This example shows how to configure the mode of a virtual Fibre Channel interface:
|
|
---|---|
Displays an interface configuration for a specified interface. |
To configure switch port parameters on a SAN port channel interface, use the switchport command. To discard the configuration, use the no form of this command.
switchport { description line | mode { NP | auto } | speed { 1000 | 2000 | 4000 | 8000 | auto } | trunk { allowed vsan { vsan-id | add vsan-id | all } | mode { auto | on | off }}}
no switchport { description | mode | speed | trunk { allowed vsan [ vsan-id | add vsan-id | all ] | mode }}
Specifies a description for the interface. The description can be a maximum of 80 alphanumeric characters. |
|
Configures the SAN port channel interface as an N-Port Virtualizer (NPV) port. |
|
SAN port channel configuration mode
This example shows how to configure switch port parameters for a SAN port channel interface:
This example shows how to remove the switch port configuration for a SAN port channel interface:
|
|
---|---|
Displays an interface configuration for a specified interface. |
|
Configures a SAN port channel interface as an active port channel port. |
To configure a switch port parameter on a virtual Fibre Channel interface, use the switchport command. To discard the configuration, use the no form of this command.
switchport mode { E | F | NP }
Virtual Fibre Channel interface configuration mode
|
|
The bind, description, shutdown, and switchport commands were separated from the interface vfc command. |
|
The Ethernet or EtherChannel interface that you bind to the virtual Fibre Channel interface must be a trunk port.
You can bind an F port to a member of a virtual port channel (vPC) if it is the only member of the vPC on the local switch. Because of limitations in the hardware, you cannot bind multiple virtual Fibre Channel interfaces to multiple members of the vPC. You can, however, bind an F port to non-vPC EtherChannels.
By default, a VE port is enabled for trunk mode. A VE port cannot be bound to a MAC address.
VE-capable ports allow the discovery and instantiation of virtual links between Cisco Nexus 5500 Series switches and SAN switches, which enables multi-hop FCoE on the switch.
This example shows how to configure an F port on virtual Fibre Channel interface 3:
This example shows how to configure a VE port on virtual Fibre Channel interface 3:
|
|
---|---|
Displays the specified VFC interface, including its attributes and status. |
|
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.
|
|
---|---|
Switchport trunk mode is on by default for virtual Fibre Channel interfaces. |
The Ethernet interface must be configured 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 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.
no switchport ignore bit-errors
|
|
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:
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:
This example shows how to allow the detection of bit error events from disabling the interface:
|
|
---|---|
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 defaults, 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.
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:
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 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 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:
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. |
|