- san-port-channel persistent
- scsi-target
- shutdown
- shutdown lan (FCoE)
- switchport (Fibre Channel)
- switchport (SAN PortChannel)
- switchport (virtual Fibre Channel interface)
- switchport mode trunk
- switchport ignore bit-errors
- system default switchport
- system default zone default-zone permit
- system default zone distribute full
S Commands
This chapter describes the Cisco NX-OS Fibre Channel, virtual Fibre Channel, and Fibre Channel over Ethernet (FCoE) commands that begin with S.
san-port-channel persistent
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
Syntax Description
Converts the autocreated SAN port channel to a persistent SAN port channel |
Command Default
Command Modes
Command History
|
|
|
Usage Guidelines
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.
Examples
This example shows how to change the properties of an autocreated channel group to a persistent channel group:
Related Commands
|
|
|
|---|---|
scsi-target
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 ]}
Syntax Description
(Optional) Specifies a VSAN ID. The range is from 1 to 4093. |
|
Configures SCSI target name-server polling globally or per VSAN. |
|
Command Default
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
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.
Examples
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:
Related Commands
|
|
|
|---|---|
Discovers SCSI targets on local storage to the switch or remote storage across the fabric. |
|
Displays information about existing SCSI target configurations. |
shutdown
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.
Syntax Description
(Optional) Specifies that the interface state be forcefully changed to administrative down. |
Command Default
Command Modes
Virtual Fibre Channel interface configuration mode
SAN port channel configuration mode
Command History
|
|
|
Usage Guidelines
Examples
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:
Related Commands
|
|
|
|---|---|
Displays the specified VFC interface, attributes, and status. |
|
Displays the specified VFC interface, attributes, and status. |
shutdown lan (FCoE)
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.
Syntax Description
Command Default
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
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.
Examples
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:
Related Commands
|
|
|
|---|---|
switchport (Fibre Channel)
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 }}
Syntax Description
Command Default
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.
Command Modes
Command History
|
|
|
Usage Guidelines
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:
Examples
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:
Related Commands
|
|
|
|---|---|
Displays an interface configuration for a specified interface. |
switchport (SAN PortChannel)
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 }}
Syntax Description
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. |
|
Command Default
Command Modes
SAN port channel configuration mode
Command History
|
|
|
|---|---|
Usage Guidelines
Examples
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:
Related Commands
|
|
|
|---|---|
Displays an interface configuration for a specified interface. |
|
Configures a SAN port channel interface as an active port channel port. |
switchport (virtual Fibre Channel interface)
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 }
Syntax Description
Command Default
Command Modes
Virtual Fibre Channel interface configuration mode
Command History
|
|
|
Usage Guidelines
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 5000 Series switches and SAN switches, which enables multi-hop FCoE on the switch.
Examples
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:
Related Commands
|
|
|
|---|---|
Displays the specified VFC interface, including its attributes and status. |
|
switchport mode trunk
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.
Syntax Description
Command Default
Command Modes
Command History
|
|
|
|---|---|
Usage Guidelines
The Ethernet interface must be configured as a trunk port to allow both Fibre Channel and Ethernet traffic on the same interface.
Examples
This example shows how to enable the trunk mode for interface Ethernet 2/1:
Related Commands
|
|
|
|---|---|
Displays information on all interfaces configured as switch ports. |
switchport ignore bit-errors
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
Syntax Description
Command Default
Command Modes
Command History
|
|
|
Usage Guidelines
The bit error rate threshold is used by the switch to detect an increased error rate before performance degradation seriously affects traffic.
Bit errors can occur for the following reasons:
- Faulty or bad cable
- Faulty or bad SFP
- SFP is specified to operate at 1 Gbps but is used at 2 Gbps
- Short haul cable is used for long haul or long haul cable is used for short haul
- Momentary sync loss
- Loose cable connection at one or both ends
- Improper SFP connection at one or both ends
A bit error rate threshold is detected when 15 error bursts occur in a 5-minute period. By default, the switch disables the interface when the threshold is reached. You can enter a shutdown/no shutdown command sequence to reenable the interface.
Regardless of the setting of the switchport ignore bit-errors command, the switch generates a syslog message when bit error threshold events are detected.
Examples
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:
Related Commands
|
|
|
|---|---|
system default switchport
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 }}
Syntax Description
Command Default
Command Modes
Command History
|
|
|
Usage Guidelines
Attributes configured using this command are applied globally to all future switch port configurations, even if you do not individually specify them at that time.
This command changes the configuration of the following ports to administrative mode F:
- All ports that are down.
- All F ports that are up, whose operational mode is F, and whose administrative mode is not F.
This command does not affect non-F ports that are up; however, if non-F ports are down, this command changes the administrative mode of those ports.
Examples
This example shows how to configure a port shutdown:
This example shows how to configure the trunk mode:
Related Commands
|
|
|
|---|---|
system default zone default-zone permit
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
Syntax Description
Command Default
Command Modes
Command History
|
|
|
Usage Guidelines
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.
Examples
This example shows how to set the default zone to use the default values:
This example shows how to restore the default setting:
Related Commands
|
|
|
|---|---|
Defines whether a default zone (nodes not assigned a created zone) permits or denies access to all in the default zone. |
|
system default zone distribute full
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
Syntax Description
Command Default
Command Modes
Command History
|
|
|
Usage Guidelines
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.
Examples
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:
Related Commands
|
|
|
|---|---|
Distributes the operational values for the default zone to all zone sets. |
|
Feedback