I Commands

inherit port-profile

To assign a port profile to an interface or range of interfaces and to inherit an additional port profile onto an existing port profile, use the inherit port-profile command. To remove an inherited port profile or to remove a port profile from specified interfaces, use the no form of this command.

inherit port-profile name

no inherit port-profile name

Syntax Description

name

Port profile that you want to assign to interfaces or to inherit onto the existing port profile.

Command Default

None

Command Modes

Interface configuration modePort-profile configuration mode

Command History

Release

Modification

4.2(1)

This command was introduced.

Usage Guidelines

Use the inherit port-profile command to do the following:

  • Assign the port profile to a specified interface or range of specified interfaces. You do this action in the interface configuration mode. The maximum number of interfaces that can inherit a single profile is 512.

  • Inherit configuration parameters from another port profile onto an existing port profile. You do this action in the port-profile mode, using the name of the port profile that you want to inherit configurations into. Only port profiles of the same type can be inherited by another port profile. The device supports four levels of inheritance except for the switchport private-vlan mapping and the private-vlan mapping commands, which support only one inheritance level. The same port profile can be inherited by any number of port profiles. In a port-profile inheritance hierarchy, all the profiles must have the same switchport configuration.

See the port-profile command and the state-enabled command for information about creating, configuring, and enabling port profiles.

If you attempt to inherit a port profile to the wrong type of interface, the system returns an error.

When you remove a port profile from a range of interfaces, the system undoes the configuration from the interfaces first and then removes the port-profile link. Also, when you remove a port profile, the system checks the interface configuration and either skips port-profile commands that have been overridden by directly entered interface commands or returns the command to the default value.

You can also choose a subset of interfaces from which to remove a port profile from those interfaces to which you originally applied the profile. For example, if you configured a port profile and configured 10 interfaces to inherit that port profile, you can remove the port profile from just some of the specified 10 interfaces. The port profile continues to operate on the remaining interfaces to which it is applied.

You use the port-profile configuration mode to remove an inherited port profile from an original port profile.

This command does not require a license.

Examples

This example shows how to assign a specified port profile to a range of interfaces:

switch(config)# interface ethernet 2/1-10
switch(config-if)# port-profile test

This example shows how to inherit the configuration parameters from the port profile named switch onto the port profile named test:

switch(config)# test
switch(config-ppm)# inherit port-profile switch

interface cmp-mgmt module

To create a Connectivity Management Processor (CMP) management interface and enter interface configuration mode, use the interface cmp-mgmt module command.

interface cmp-mgmt module number

Syntax Description

number

Active or standby supervisor module number. Valid values are 9 or 10.

Command Default

None

Command Modes

Global configuration mode

Interface configuration mode

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

Use the interface cmp-mgmt module command to create a CMP management interface.

This command does not require a license.

Examples

This example shows how to create a CMP management interface:

switch(config)# interface cmp-mgmt module 9
switch(config-if-cmp)#

interface ethernet

To configure an Ethernet interface and enter interface configuration mode, use the interface ethernet command.

interface ethernetslot/port-list

Syntax Description

slot/port-list

Slot number and port list for the Ethernet interface. The range is from 1 to 253 for slots and from 1 to 128 for ports.

Command Default

None

Command Modes

Global configuration mode

Interface configuration mode

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

Use the interface ethernet command to enter the interface configuration mode for the specified interface or range of interfaces.


Note

slot/port-list is a space-separated list of slots and ports.

This command does not require a license.

Examples

This example shows how to enter the interface command mode for the Ethernet interface on slot 2, port 1:

switch(config)# interface ethernet 2/1
switch(config-if)#

interface loopback

To create a loopback interface and enter interface configuration mode, use the interface loopback command. To remove a loopback interface, use the no form of this command.

interface loopback number

no interface loopback number

Syntax Description

number

Interface number. The range is from 0 to 1023.

Command Default

None

Command Modes

Global configuration mode

Interface configuration mode

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

Use the interface loopback command to create or modify loopback interfaces.

This command does not require a license.

Examples

This example shows how to create a loopback interface:

switch(config)# interface loopback 50
switch(config-if)#

interface mgmt

To configure the management interface and enter interface configuration mode, use the interface mgmt command.

interface mgmt number

Syntax Description

number

Interface number. The range is from 0 to 1023.

Command Default

None

Command Modes

Global configuration mode

Interface configuration mode

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

Use the interface mgmt command to configure the management interface and to enter the interface configuration mode.

This command does not require a license.

Examples

This example shows how to enter the interface configuration mode to configure the management interface:

switch(config)# interface mgmt
switch(config-if)#

interface port-channel

To create a port-channel interface and enter interface configuration mode, use the interface port-channel command. To remove a logical port-channel interface or subinterface, use the no form of this command.

interface port-channel channel-number

no interface port-channel channel-number

Syntax Description

channel-number

Channel number that is assigned to this port-channel logical interface. The range is from 1 to 4096.

Command Default

None

Command Modes

Global configuration mode

Interface configuration mode

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

Use the interface port-channel command to create or delete port-channel groups and to enter the interface configuration mode for the port channel.

You can create port channels implicitly using the auto-recovery command or explicitly using the feature tunnel command.

A port can belong to only one channel group.

You can create subinterfaces on a Layer 3 port-channel interface. However, you cannot add a Layer 3 interface that has existing subinterfaces to a port channel.


Note

The Layer 3 port-channel interface is the routed interface.

The Link Aggregation Control Protocol (LACP) system ID is unique for each virtual device context (VDC), and channel-group numbers and names can be reused in different VDCs.

When you use the interface port-channel command, follow these guidelines:

  • If you are using the Cisco Discovery Protocol (CDP), you must configure it only on the physical interface and not on the port-channel interface.

  • If you do not assign a static MAC address on the port-channel interface, a MAC address is automatically assigned. If you assign a static MAC address and then later remove it, the MAC address is automatically assigned.

  • The MAC address of the port channel is the address of the first operational port added to the channel group. If this first-added port is removed from the channel, the MAC address comes from the next operational port added, if there is one.

This command does not require a license.

Examples

This example shows how to create a port-channel group interface with channel-group number 50:

switch(config)# interface port-channel 50
switch(config-if)#

interface tunnel

To create a tunnel interface and enter interface configuration mode, use the interface tunnel command. To remove a tunnel interface, use the no form of this command.

interface tunnel number-list

no interface tunnel number-list

Syntax Description

number-list

Identifying interface number list. The range is from 0 to 4095.

Command Default

None

Command Modes

Global configuration mode

Interface configuration mode

Command History

Release

Modification

5.0(1)

The maximum valid range of values was changed from 65535 to 4095.

4.0

This command was introduced.

Usage Guidelines

Use the interface tunnel command to create or modify tunnel interfaces.

Cisco NX-OS supports the generic routing encapsulation (GRE) header defined in IETF RFC 2784. Cisco NX-OS does not support tunnel keys and other options from IETF RFC 1701.

You can configure IP tunnels only in the default virtual device context (VDC).


Note

number-list is a space-separated list of tunnels.

This command requires the Enterprise license.

Examples

This example shows how to create a tunnel interface:

switch(config)# interface tunnel 50
switch(config-if)#

interface vlan

To create a VLAN interface and enter interface configuration mode, use the interface vlan command. To remove a VLAN interface, use the no form of this command.

interface vlan vlan-id

no interface vlan vlan-id

Syntax Description

vlan-id

VLAN to set when the interface is in access mode. The range is from 1 to 4094, except for the VLANs reserved for the internal switch use.

Command Default

None

Command Modes

Global configuration mode

Interface configuration mode

Command History

Release

Modification

4.0

This command was introduced.

Usage Guidelines

Use the interface vlan command to create or modify VLAN interfaces.

The VLAN interface is created the first time that you enter the interface vlan command for a particular VLAN. The vlan-id argument corresponds to the VLAN tag that is associated with the data frames on an Inter-Switch Link (ISL), the IEEE 802.1Q-encapsulated trunk, or the VLAN ID that is configured for an access port.

This command does not require a license.

Examples

This example shows how to create a VLAN interface for VLAN 50:

switch(config)# interface vlan 50
switch(config-if)#

ip eigrp bfd

To enable Bidirectional Forwarding Detection (BFD) on an Enhanced Interior Gateway Routing Protocol (EIGRP) interface, use the ip eigrp bfd command. To return to the default setting, use the no form of this command.

ip eigrp instance-tag bfd

no ip eigrp instance-tag bfd

Syntax Description

instance-tag

EIGRP instance tag. The instance tag can be any case-sensitive, alphanumeric string up to 20 characters.

Command Default

None

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(2)

This command was introduced.

Usage Guidelines

Use the ip eigrp bfd command to enable BFD on an EIGRP interface. This command takes precedence over the bfd command in router configuration mode.

This command does not require a license.

Examples

This example shows how to enable BFD for an EIGRP interface:

switch# configure terminal
switch(config)# interface ethernet 2/1
switch(config-if)# ip eigrp Test1 bfd

ip ospf bfd

To enable Bidirectional Forwarding Detection (BFD) on an Open Shortest Path First version 2 (OSPFv2) interface, use the ip ospf bfd command. To return to the default setting, use the no form of this command.

ip ospf bfd

no ip ospf bfd

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(2)

This command was introduced.

Usage Guidelines

Use the ip ospf bfd command to enable BFD on an OSPFv2 interface. This command takes precedence over the bfd command in router configuration mode.

This command does not require a license.

Examples

This example shows how to enable BFD for an OSPF interface:

switch# configure terminal
switch(config)# interface ethernet 2/1
switch(config-if)# ip ospf bfd

ip pim bfd-instance

To enable Bidirectional Forwarding Detection (BFD) for Protocol Independent Multicast (PIM) on an interface, use the ip pim bfd-instance command. To return to the default setting, use the no form of this command.

ip pim bfd-instance [disable]

no ip pim bfd-instance [disable]

Syntax Description

disable

(Optional) Disables BFD for PIM on this interface.

Command Default

None

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(2)

This command was introduced.

Usage Guidelines

Use the ip pim bfd-instance command to enable BFD for PIM on an interface. This configuration (with or without the disable keyword) overrides the BFD configuration for PIM at the global or VRF configuration level.

This command does not require a license.

Examples

This example shows how to disable BFD for PIM on interface ethernet 2/1 when BFD is enabled globally for PIM:

switch# configure terminal
switch(config)# ip pim bfd
switch(config)# interface ethernet 2/1
switch(config-if)# ip pim bfd-instance disable

ip pim bfd

To enable Bidirectional Forwarding Detection (BFD) for Protocol Independent Multicast (PIM), use the ip pim bfd command. To return to the default setting, use the no form of this command.

ip pim bfd

no ip pim bfd

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

Global configuration mode

Command History

Release

Modification

5.0(2)

This command was introduced.

Usage Guidelines

Use the ip pim bfd command to enable BFD for PIM.

This command does not require a license.

Examples

This example shows how to enable BFD for PIM:

switch# configure terminal
switch(config)# ip pim bfd

ipv6 eigrp bfd

To enable Bidirectional Forwarding Detection (BFD) on an Enhanced Interior Gateway Routing Protocol (EIGRP), use the ipv6 eigrp bfd command. To return to the default setting, use the no form of this command.

ipv6 eigrp instance-tag bfd

no ipv6 eigrp instance-tag bfd

Syntax Description

instance-tag

EIGRP instance tag. The instance tag can be any case-sensitive, alphanumeric string up to 20 characters.

Command Default

None

Command Modes

Interface configuration mode

Command History

Release

Modification

5.0(2)

This command was introduced.

Usage Guidelines

Use the ipv6eigrpbfd command to enable BFD on an EIGRP interface. This command takes precedence over the bfd command in router configuration mode.

This command does not require a license.

Examples

This example shows how to enable BFD for an EIGRP interface:

switch# configure terminal
switch(config)# interface ethernet 2/1
switch(config-if)# ipv6 eigrp Test1 bfd

isis bfd

To enable Bidirectional Forwarding Detection (BFD) on an Intermediate System-to-Intermediate System (IS-IS) interface, use the isis bfd command. To return to the default setting, use the no form of this command.

isis [ipv6] bfd

no isis bfd

Syntax Description

ipv6

(Optional) Enables IPv6 BFD on a specific interface that is configured for IS-IS.

Command Default

None

Command Default

None

Command Modes

Interface configuration mode

Command History

Release

Modification

6.2(2)

Added the ipv6 keyword to the syntax description.

5.0(2)

This command was introduced.

Usage Guidelines

Use the isis bfd command to enable BFD on an IS-IS interface. This command takes precedence over the bfd command in router configuration mode.

This command does not require a license.

Examples

This example shows how to enable BFD for an IS-IS interface:

switch# configure terminal
switch(config)# interface ethernet 2/1
switch(config-if)# isis ipv6 bfd
switch(config-if)#