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 virtual port channel (vPC) commands that begin with I.
To import an interface configuration to a switch profile, use the import interface command.
import interface {ethernet slot/[QSFP-module/]port | port-channel channel-no}
None
Switch profile configuration mode
|
|
---|---|
6.0(2)N1(2) |
Support for the QSFP+ GEM was added. |
5.2(1)N1(1) |
This command was introduced. |
When no option is specified with the import command, an empty switch profile is created. You can then selectively add the configuration that is needed to be synchronized with the peer switch.
You can import a switch profile based on the set of commands that you want to import. The following three ways can be used to import commands that were added using the configuration terminal mode:
1. Add selected commands to the switch profile.
2. Add supported commands that were specified for an interface.
3. Add supported system-level commands.
When you import commands to a switch profile, the switch profile buffer must be empty.
Use the commit command to complete the import process and move the configuration into the switch profile. Because configuration changes are not supported during the import process, if new commands are added before entering the commit command, the switch profile remains unsaved and the switch remains in the switch profile import mode (config-sync-sp-import). You can remove the added commands or use the abort command to stop the import. Unsaved configurations are lost if the process is aborted. New commands can be added to the switch profile after the import is complete.
This example shows how to import the Ethernet interface configuration to a switch profile named s5010 on switch 1 of the peer:
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)# show switch-profile s5010 buffer
switch-profile : s5010
----------------------------------------------------------
Seq-no Command
----------------------------------------------------------
switch(config-sync-sp)# import interface ethernet 1/1
switch(config-sync-sp)# show switch-profile buffer
switch-profile : s5010
----------------------------------------------------------
Seq-no Command
----------------------------------------------------------
1 interface Ethernet1/1
switch(config-sync-sp-import)# commit
Verification successful...
Proceeding to apply configuration. This might take a while depending on amount o
f configuration in buffer.
Please avoid other configuration changes during this time.
Commit Successful
switch(config-sync)#
This example shows how to create an empty switch profile named sp100 on switch 1 of the peer and then add the configuration commands:
switch# config sync
Enter configuration commands, one per line. End with CNTL/Z.
switch(config-sync)# switch-profile sp100
Switch-Profile started, Profile ID is 1
switch(config-sync-sp)# show switch-profile sp100 buffer
switch-profile : sp100
----------------------------------------------------------
Seq-no Command
----------------------------------------------------------
switch(config-sync-sp)# import
switch(config-sync-sp-import)# interface port-channel 100
switch(config-sync-sp-import-if)# switchport mode trunk
switch(config-sync-sp-import-if)# vpc peer-link
switch(config-sync-sp-import-if)# exit
switch(config-sync-sp-import)# commit
Verification successful...
Proceeding to apply configuration. This might take a while depending on amount o
f configuration in buffer.
Please avoid other configuration changes during this time.
Commit Successful
switch(config-sync)#
This example shows how to import an interface in a switch profile:
switch(config)# cfs ipv4 distribute
switch(config)# config sync
switch(config-sync)# switch-profile test Switch-Profile started, Profile ID is 1
switch(config-sync-sp)# import interface e3/1/1
switch(config-sync-sp-import)# show switch
switch-profile switchname
switch(config-sync-sp-import)# show switch-profile buffer
switch-profile : test
----------------------------------------------------------
Seq-no Command
----------------------------------------------------------
1 interface Ethernet3/1/1
switch(config-sync-sp-import)#
To import the running configuration to a switch profile, use the import running-config command.
import running-config [exclude interface ethernet]
None
Switch profile configuration mode
|
|
---|---|
5.2(1)N1(1) |
This command was introduced. |
The import running-config exclude interface ethernet command discards all physical interface commands in the running configuration during the import operation.
When no option is specified with the import command, an empty switch profile is created. You can then selectively add the configuration that is needed to be synchronized with the peer switch.
You can import a switch profile based on the set of commands that you want to import. The following three ways can be used to import commands that were added using the configuration terminal mode:
1. Add selected commands to the switch profile.
2. Add supported commands that were specified for an interface.
3. Add supported system-level commands.
When you import commands to a switch profile, the switch profile buffer must be empty.
Use the commit command to complete the import process and move the configuration into the switch profile. Because configuration changes are not supported during the import process, if new commands are added before entering the commit command, the switch profile remains unsaved and the switch remains in the switch profile import mode (config-sync-sp-import). You can remove the added commands or use the abort command to stop the import. Unsaved configurations are lost if the process is aborted. New commands can be added to the switch profile after the import is complete.
This example shows how to import the running configuration to a switch profile named s5010 on switch 1 of the peer:
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)# show switch-profile buffer
switch-profile : s5010
----------------------------------------------------------
Seq-no Command
----------------------------------------------------------
switch(config-sync-sp)# import running-config exclude interface ethernet
switch(config-sync-sp-import)# show switch-profile buffer
switch-profile : s5010
----------------------------------------------------------
Seq-no Command
----------------------------------------------------------
2 interface port-channel1
2.1 vpc 1
2.2 speed 10000
3 interface port-channel100
3.1 vpc peer-link
3.2 spanning-tree port type network
3.3 speed 10000
switch(config-sync-sp-import)# commit
Verification successful...
Proceeding to apply configuration. This might take a while depending on amount o
f configuration in buffer.
Please avoid other configuration changes during this time.
Commit Successful
switch(config-sync)#
To inherit a port profile into an existing profile or to apply a port profile configuration to an interface, use the inherit port-profile command. To remove the inheritance, use the no form of this command.
inherit port-profile port-profile-name
no inherit port-profile port-profile-name
None
Port profile configuration mode
Interface configuration mode
Virtual Ethernet interface configuration mode
|
|
---|---|
5.2(1)N1(1) |
This command was introduced. |
You inherit the port profile when you attach the port profile to an interface or range of interfaces. When you attach, or inherit, a port profile to an interface or range of interfaces, the switch applies all the commands in that port profile to the interfaces. A port profile configured for an interface type can be applied only to that type of interface. For example, a port profile created for VLAN interfaces must be attached onto a VLAN interface. If you delete a port profile after you attach the port profile to an interface, the port profile configuration is removed from the interface.
To apply the port profile configurations to the interfaces, you must enable the specific port profile.
This example shows how to inherit a port profile named ppEth that is configured for Ethernet interfaces into an existing port profile named test:
switch# configure terminal
switch(config)# port-profile test
switch(config-port-prof)# inherit port-profile ppEth
switch(config-port-prof)#
This example shows how to assign a port profile named ppEth that is configured for Ethernet interfaces to a range of Ethernet interfaces:
switch# configure terminal
switch(config)# interface ethernet 1/2-5
switch(config-if)# inherit port-profile ppEth
switch(config-if)#
This example shows how to assign a port profile named ppVEth that is configured for virtual Ethernet interfaces to a virtual Ethernet interface:
switch# configure terminal
switch(config)# interface ethernet 10
switch(config-if)# inherit port-profile ppVEth
switch(config-if)#
This example shows how to remove an inherited port profile named ppEth from an existing port profile named test:
switch# configure terminal
switch(config)# port-profile test
switch(config-port-prof)# no inherit port-profile ppEth
switch(config-port-prof)#
To enable Address Resolution Protocol (ARP) synchronization between the virtual port channel (vPC) peers, use the ip arp synchronize comand. To disable ARP synchronization, use the no form of this command.
ip arp synchronize
no ip arp synchronize
This command ahs no arguments or keywords.
Disabled
vPC domain configuration mode
|
|
---|---|
5.1(3)N1(1) |
This command was introduced. |
The ARP table sync feature overcomes the delay involved in ARP table restoration that can be triggered when one of the switches in the vPC domain goes offline and comes back online and also when there are peer-link port channel flaps. Enabling ARP on a vPC domain improves convergence times for unicast traffic.
This command does not require a license.
This example shows how to enable ARP synchronization on a vPC domain:
switch# configure terminal
switch(config)# vpc domain 1
switch(config-vpc-domain)# ip arp synchronize
switch(config-vpc-domain)#
This example shows how to disable ARP synchronization on a vPC domain:
switch# configure terminal
switch(config)# vpc domain 1
switch(config-vpc-domain)# no ip arp synchronize
switch(config-vpc-domain)#
|
|
---|---|
show ip arp vpc-statistics |
Displays the global ARP statistics for vPCs. |
show running-config vpc |
Displays the running configuration information for vPCs. |
To configure a static connection to a virtual port channel (vPC) peer link, use the ip igmp snooping mrouter vpc-peer-link command. To remove the static connection, use the no form of this command.
ip igmp snooping mrouter vpc-peer-link
no ip igmp snooping mrouter vpc-peer-link
This command has no arguments or keywords.
None
Global configuration mode
|
|
5.0(3)N1(1) |
This command was introduced. |
By default, a vPC Peer-link is considered an IGMP snooping mrouter port. The multicast traffic is sent over to a peer-link for the source VLAN and for each receiving VLAN. If you use the no ip igmp snooping mrouter vpc-peer-link command, the multicast traffic is not sent over to a peer-link for the source VLAN and receiver VLAN unless there are orphan ports in the VLAN.
Note In Cisco NX-OS Release 5.0(3)N1(1), the no ip igmp snooping mrouter vpc-peer-link command is not supported in topologies where there is a dual-homed Cisco Nexus 2000 Series Fabric Extender attached to a Cisco Nexus 5000 Series switch.
This command does not require a license.
This example shows how to configure a static connection to a vPC peer link:
switch(
config)#
ip igmp snooping mrouter vpc-peer-link
switch(
config)#
This example shows how to remove a static connection to a vPC peer link:
switch(
config)#
no ip igmp snooping mrouter vpc-peer-link
Warning: IGMP Snooping mrouter vpc-peer-link should be globally disabled on peer
VPC switch as well.
switch(
config)#
|
|
---|---|
show ip igmp snooping |
Displays IGMP snooping information. |