Table Of Contents

S Commands

state enabled

switch-profile

sync-peers destination

system-mac

system-priority

S Commands

---

This chapter describes the Cisco NX-OS virtual port channel (vPC) commands that begin with S.

state enabled

To enable a port profile, use the state enabled command. To disable a port profile, use the no form of this command.

state enabled

no state enabled

Syntax Description

This command has no arguments or keywords.

Command Default

Disabled

Command Modes

Port profile configuration mode

Command History

Release	Modification
5.2(1)N1(1)	This command was introduced.

Usage Guidelines

Use this command to enable a port profile to apply the port profile configurations to the interfaces. You can configure and inherit a port profile onto a range of interfaces before you enable that port profile. You must then enable that port profile for the configurations to take effect on the specified interfaces.

Examples

This example shows how to enable a port profile named ppEth that is configured for Ethernet interfaces:

switch# configure terminal 

switch(config)# port-profile ppEth 

switch(config-port-prof)# state enabled 

switch(config-port-prof)# 

This example shows how to disable a port profile named ppEth that is configured for Ethernet interfaces:

switch# configure terminal 

switch(config)# port-profile ppEth 

switch(config-port-prof)# no state enabled 

switch(config-port-prof)# 

Related Commands

Command	Description
copy running-config startup-config	Copies the running configuration to the startup configuration.
inherit	Attaches a port profile to an interface.
show port-profile	Displays information about all port profiles.
show running-config port-profile	Displays the running configuration for the port profile.

switch-profile

To create or configure a switch profile, use the switch-profile command. To delete a switch profile, use the no form of this command.

switch-profile sw-profile-name

no switch-profile sw-profile-name {all-config | local-config}

Syntax Description

sw-profile-name	Name of the switch profile. The name is case sensitive, can be a maximum of 64 alphanumeric characters and can include an underscore and hyphen. The name cannot contain spaces or special characters.
all-config	Specifies that the switch profile be deleted with all local and peer configurations.
local-config	Specifies that the switch profile and all local configurations be deleted.

Command Default

None

Command Modes

Configuration synchronization mode

Command History

Release	Modification
5.2(1)N1(1)	This command was introduced.

Usage Guidelines

Use this command to create a switch profile on each of the peer switches. You must use the same profile name on both the switches in the Cisco Fabric Services (CFS) peer configuration.

---

Note In this release of Cisco NX-OS, only a pair of switches can be configured as a peer.

---

You can configure only one active switch profile on each peer switch. If you create or configure a second switch profile, you see the following error message:

Error: Another switch profile already exists. Cannot configure more than one 
switch-profile.

The configuration that is made locally on the switch is synchronized and made available on the peer switch only after the connectivity is established between the peer switches and the configuration is verified and committed on the local switch.

You can configure a switch profile to include the interface configuration, quality of service (QoS), and virtual port channel (vPC) commands. FCoE commands are not supported on a switch profile.

When you delete a switch profile, you can choose to delete the local switch profile with the local configurations on the switch, or delete the switch profile with the local configurations and configuration information in the peer. The peer becomes unreachable.

Examples

This example shows how to create a switch profile named s5010 on switch 1 of the peer:

Peer A

switch# configure terminal 

switch(config)# cfs ipv4 distribute 

switch(config)# exit 

switch# config sync 

Enter configuration commands, one per line.  End with CNTL/Z.

switch(config-sync)# switch-profile s5010 

Switch-Profile started, Profile ID is 1

switch(config-sync-sp)#

This example shows how to create a switch profile named s5010 on switch 2 of the peer:

Peer B

switch# configure terminal 

switch(config)# cfs ipv4 distribute 

switch(config)# exit 

switch# config sync 

Enter configuration commands, one per line.  End with CNTL/Z.

switch(config-sync)# switch-profile s5010 

Switch-Profile started, Profile ID is 1

switch(config-sync-sp)#

This example shows how to delete a switch profile named s5010 and its local configuration on switch 1 of the peer:

Peer A

switch# config sync 

Enter configuration commands, one per line.  End with CNTL/Z.

switch(config-sync)# no switch-profile s5010 local-config 

switch(config-sync)#

Related Commands

Command	Description
config sync	Enters configuration synchronization mode.
show switch-profile	Displays the switch profile created on the switch and its configuration revision.
sync-peers destination	Configures the peer switch for configuration synchronization.

sync-peers destination

To add a peer switch to a switch profile, use the sync-peers destination command. To remove a peer from the switch profile, use the no form of this command.

sync-peers destination ipv4-address

no sync-peers destination ipv4-address

Syntax Description

destination	Specifies the destination IPv4 address of the peer switch.
ipv4-address	Destination IPv4 address of the peer switch in the format A.B.C.D.

Command Default

None

Command Modes

Switch profile configuration mode

Command History

Release	Modification
5.2(1)N1(1)	This command was introduced.

Usage Guidelines

Use this command to add the peer switch that will be included in the synchronization. You must have the IPv4 address of the peer switch. You can ensure that configuration synchronization is enabled on the peer switch by using the config sync command.

After you add a peer to a switch profile, you can add commands to the switch profile.

Peers maintain a configuration revision of their local configuration as well as the revision. After a network outage, when connectivity is established between the peer switches and the peers are reachable, each peer determines if any configuration in the switch needs to be synchronized with the other peer. Changed configurations will then be synchronized between the peers.

When you remove a peer from the switch profile, all configuration information about the peer is deleted from the local switch.

Examples

This example shows how to add a peer switch with IPv4 address 192.168.1.37 to a switch profile named s5010 on switch 1 of the peer:

Peer A

switch# config sync 

Enter configuration commands, one per line.  End with CNTL/Z.

switch(config-sync)# switch-profile s5010 

Switch-Profile started, Profile ID is 1

switch(config-sync-sp)# sync-peers destination 192.168.1.37 

switch(config-sync-sp)#

This example shows how to add a peer switch with IPv4 address 192.168.120.3 to a switch profile named s5010 on switch 2 of the peer:

Peer B

switch# config sync 

Enter configuration commands, one per line.  End with CNTL/Z.

switch(config-sync)# switch-profile s5010 

Switch-Profile started, Profile ID is 1

switch(config-sync-sp)# sync-peers destination 192.168.120.3 

switch(config-sync-sp)#

This example shows how to delete a peer with IPv4 address 192.168.1.37 from a switch profile named s5010 on switch 1 of the peer:

Peer A

switch# config sync 

Enter configuration commands, one per line.  End with CNTL/Z.

switch(config-sync)# switch-profile s5010 

switch(config-sync-sp)# no sync-peers destination 192.168.1.37 

switch(config-sync-sp)#

Related Commands

Command	Description
command	Adds, modifies, or removes commands from a switch profile.
copy running-config startup-config	Copies the running configuration to the startup configuration.
import	Imports the commands from the running configuration to the switch profile.
show switch-profile	Displays the switch profile created on the switch and its configuration revision.
show switch-profile status	Displays the switch profile status.
switch-profile	Configures a switch profile.

system-mac

To manually configure the virtual port channel (vPC) domain MAC address, use the system-mac command. To restore the default vPC system MAC address, use the no form of this command.

system-mac mac_address

no system-mac mac_address

Syntax Description

mac_address

MAC address that you want for the specified vPC domain in the following format aaaa.bbbb.cccc.

Command Default

None

Command Modes

vPC domain configuration mode

Command History

Release	Modification
5.2(1)N1(1)	This command was introduced.

Usage Guidelines

When you create a vPC domain, the Cisco NX-OS software automatically creates a vPC system MAC address, which is used for operations that are confined to the link-scope, such as the Link Aggregation Control Protocol (LACP). However, you may choose to configure the vPC domain MAC address manually.

Examples

This example shows how to configure the MAC address for the vPC domain:

switch(config-vpc-domain)# system-mac 23fb.4ab5.4c4e 

switch(config-vpc-domain)# 

Related Commands

Command	Description
copy running-config startup-config	Copies the running configuration to the startup configuration.
show vpc peer-keepalive	Displays the status of the peer-keepalive link.
show running-config vpc	Displays the running configuration information for vPCs.
show vpc role	Displays the vPC system priority.
show vpc statistics	Displays information about the configuration for the keepalive messages.

system-priority

To manually configure a system priority for the virtual port channel (vPC) domain, use the system-priority command. To restore the default system priority, use the no form of this command.

system-priority priority_value

no system-priority priority_value

Syntax Description

priority_value

System priority that you want for the specified vPC domain. The range is from 1 to 65535, and the default value is 32667.

Command Default

The default for the system priority is 32667.

Command Modes

vPC domain configuration mode

Command History

Release	Modification
5.2(1)N1(1)	This command was introduced.

Usage Guidelines

We recommend that you manually configure the vPC system priority when you are running Link Aggregation Control Protocol (LACP) to ensure that the vPC peer devices are the primary devices on LACP. When you manually configure the system priority, ensure that you configure the same priority value on both vPC peer devices. If these values do not match, vPC will not come up.

Examples

This example shows how to configure the system priority for the vPC domain:

switch(config-vpc-domain)# system-priority 3000 

switch(config-vpc-domain)# 

Related Commands

Command	Description
copy running-config startup-config	Copies the running configuration to the startup configuration.
show running-config vpc	Displays the running configuration information for vPCs.
show vpc role	Displays the vPC system priority.