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.0(2)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.