Interface Commands
  • 10 Aug 2023
  • 14 Minutes to read
  • Contributors
  • PDF

Interface Commands

  • PDF

Article summary

Interface CLI commands are categorized as follows:

Configuration Commands

This section includes Interface configuration commands.

alias - For interface

Command Objective:

This command configures the alias name for the interface/L3 Subinterface. This value is a string of maximum size 63.


Note: This command is also supported in Katana Platform for L3SubInterface feature.

Syntax:
alias <string(63)>

Mode:
Interface Configuration Mode / Sub Interface Configuration Mode

Example:

Your Product (config-if)# alias interface1
Your Product (config-subif)# alias interface1

bridge port-type

Command Objective:
This command configures the bridge port type for an interface.

Syntax:
bridge port-type { providerNetworkPort | providerNetworkPort three-tagged | customerNetworkPort port-based | customerEdgePort }

Parameter Description:

  • providerNetworkPort - Sets the bridge port type as provider network port. This option is the default value. The port is connected to a single provider.
  • providerNetworkPort three-tagged - Sets the bridge port-type as a provider network port with a third VLAN. The third VLAN is a Tunnel VLAN component.
  • customerNetworkPort port-based - Customer network port; sets the bridge port type as port based.
  • customerEdgePort - Sets the bridge port type as Customer Edge Port. The port is in a PEB that is connected to a single customer.

    The packets received on this port are initially classified to a C-VLAN. C-VLAN classification is done based on the VID in the C-tag present in the packet or from the PVID of the port. Service instance selection is done for a frame based on the entry present in the C-VID registration table for the pair (C-VID, reception port).

Mode:
Interface Configuration Mode


Notes:

Tunneling must be enabled to change port type from Provider Network Port.

Tunneling must be disabled to change port type to Provider Network Port.

Port must be administratively down for changing to another port type.

customerEdgePort is valid only in Provider Edge Bridge.

Bridge port type can be set only for switch ports and not for router ports, IVR interfaces and I-LAN interfaces.

The port type cannot be set for a port-channel port, if physical ports are aggregated in the port-channel.

The port type cannot be set for a port that is part of a port-channel.


Example:

Your Product(config-if)# bridge port-type providerNetworkPort    

default IP Address

Command Objective:

This command configures the IP address and subnet mask for the default interface.

Syntax:

default ip address < ip-address > [ subnet-mask < subnet mask > ] [ interface < interface-id > ]

Parameter Description:

  • < ip address > - Sets the IP address for the default interface / specified interface. If the network in which the switch is implemented contains a server such as DHCP server, dynamically allocating IP address, the configured IP address should not be within the range of the addresses that will be allocated by the server to the other switches. This precaution avoids creation of IP address conflicts between the switches.
  • subnet-mask < subnet mask > - Sets the subnet mask for the configured IP address. The configured subnet mask should be in the same subnet of the network in which the switch is placed

    Note: If the subnet-mask is not specified, then it will be derived automatically from the class of the configured "ip address".
  • < interface-type > - Sets the IP address and / or subnet mask for the specified type of interface. The interface can be:
    • fastethernet – Officially referred to as 100BASE-T standard. This is a version of LAN standard architecture that supports data transfer up to 100 Megabits per second.
    • gigabitethernet – A version of LAN standard architecture that supports data transfer up to 1 Gigabit per second.
    • extreme-ethernet – A version of Ethernet that supports data transfer upto 10 Gigabits per second. This Ethernet supports only full duplex links.
    • i-lan – Internal LAN created on a bridge per IEEE 802.1ap.
  • < interface-id > - Sets the IP address and / or subnet mask for the specified interface identifier. This is a unique value that represents the specific interface. This value is a combination of slot number and port number separated by a slash, for interface type other than i-lan. For Example: 0/1 represents that the slot number is 0 and port number is 1. Only i-lan ID is provided, for interface type i-lan. For Example: 1 represents i-lan ID.

Mode:

Global Configuration Mode

Default:

  • ip address - 10.0.0.1
  • subnet-mask - 255.0.0.0

Example:

Your Product(config)# default ip address 20.0.0.1 subnet-mask 255.0.0.0 interface gigabitethernet 0/1

ip address

Command Objective:

This command sets the IP address for an interface.

The no form of the command resets the IP address of the interface to its default value.


Note: This command is also supported in Katana Platform for L3SubInterface feature.

Syntax:

ip address < ip-address > < subnet-mask > [secondary]

ip address < ip-address > < subnet-mask >

ip address < ip-address > < subnet-mask > [secondary] [gateway < ip-address >]

ip address < ip-address > < subnet-mask > [secondary {node0 | node1}]

no ip address [< ip_addr >]

no ip address < ip-address > < subnet-mask >

no ip address [secondary {node0 | node1}]

Parameter Description:

  • < ip-address >/<ip_addr> - Sets the IP address for an interface. If the network in which the switch is implemented contains a server such as DHCP server, dynamically allocating IP address, the configured IP address should not be within the range of the addresses that will be allocated by the server to the other switches. This precaution avoids creation of IP address conflicts between the switches.

  • < subnet-mask > - Sets the subnet mask for the configured IP address. The configured subnet mask should be in the same subnet of the network in which the switch is placed.


    Note: The parameters ip-address and subnet-mask are used implicitly in BCM Target.

  • secondary - Sets the configured IP address as an additional IP address for the interface (the configured address is used as secondary address instead of primary address).


    Note: This parameter is not supported on the OOB and PPP interface.

  • gateway ip-addres> - Sets the gateway Next hop for default gateway route.

  • node0 - Specifies the secondary IP address associated with the OOB interface of Node0

  • node1 - Specifies the secondary IP address associated with the OOB interface of Node1

Mode:

Interface Configuration Mode

Default:

  • IP address specified in issnvram.txt is taken as default for the default VLAN identifier.
  • IP address is assigned as 0.0.0.0 and subnet mask as 255.255.255.255 for other interfaces.

Prerequisites:

  • The interface should be shutdown before executing this command.
  • The Primary and secondary IP address should be different.
  • Primary address should be configured before configuring the secondary address.
  • The connection to the switch is lost if the IP address of the connected interface is modified
  • When the same network interface is used for OOB and NFS mounting, the operation done on OOB will have an impact on NFS.
  • For PPP mode, the PPP interface should be attached to the physical interface first.

Example:

Your Product(config-if)# ip address 10.0.0.3 255.255.255.0
Your Product(config-if)# ip address 10.0.0.2 255.255.255.0 secondary
Your Product(config-subif)# ip address 10.0.0.3 255.255.255.0
Your Product(config-subif)# ip address 10.0.0.2 255.255.255.0 secondary
Your Product (config-ppp)# ip address 17.0.0.100 255.255.255.0

ip address - rarp/dhcp

Command Objective:

This command configures the current VLAN / OOB interface to dynamically acquire an IP address from the RARP / DHCP server.

The no form of the command resets the IP address for the interface to its default value.

Syntax:

ip address { dhcp | rarp}[client-id { FastEthernet | GigabitEthernet | Port-channel | Vlan } <interface_list>] [hostname <host_name>]

no ip address

Parameter Description:

  • dhcp - Allows the client device to obtain configuration parameters such as network address, from the DHCP server.
  • rarp - Allows the client device to dynamically find its IP address from RARP server, when it has only its hardware address such as MAC address.
  • client-id - Sets the client identifier that specifies the interface type and hexadecimal MAC address of the specified interface. The various interface types that can be specified are:
    • FastEthernet - Officially referred to as 100BASE-T standard. This is a version of LAN standard architecture that supports data transfer up to 100 Megabits per second.
    • GigabitEthernet - A version of LAN standard architecture that supports data transfer up to 1 Gigabit per second.
    • Port-channel - Logical interface that represents an aggregator which contains several ports aggregated together.
    • Vlan - Logical interface that specifies a group of hosts which can communicate with each other as in the same broadcast domain.
  • < interface list > - Sets the list of interfaces or a specific interface identifier. This value is a combination of slot number and port number separated by a slash, for interface types other than port-channel and VLAN. Only VLAN or port-channel ID is provided, for interface types VLAN and port-channel. Use comma as a separator without space while configuring a list of interfaces. Example: 0/1,0/3 or 1,3. Feature not supported - This feature has been included to adhere to the Industry Standard CLI syntax. This feature is currently not supported.
  • hostname - Sets the name of the host from which the IP address is to be acquired dynamically. Feature not supported - This feature has been included to adhere to the Industry Standard CLI syntax. This feature is currently not supported.

Mode:

Interface Configuration Mode

Default:

dhcp

Prerequisite:

When the same network interface is used for OOB and NFS mounting, the operation done on OOB will have an impact on NFS.

Example:

Your Product(config-if)# ip address dhcp

shutdown

Command Objective:
This command disables a physical interface / VLAN interface / port-channel interface / tunnel interface / OOB interface / L3SubInterface.

The no form of the command enables a physical interface / VLAN interface / port-channel interface / tunnel interface / OOB interface / L3SubInterface.


Note: This command is also supported in Katana Platform for L3SubInterface feature.

Syntax:
shutdown

no shutdown

Mode:
Interface Configuration Mode for physical interface / port-channel/tunnel interface/OOB Interface / Sub Interface Configuration Mode

VLAN Interface Mode for VLAN interface

Default:

  • The Physical Interface eth0 is enabledThe interface VLAN 1 is enabled
  • The Port-channel interface is disabled

Prerequisites:

  • All functions on the specified interface are disabled by the shutdown command
  • If OOB interface is enabled, then the Physical Interface eth0 is disabled
  • When the same network interface is used for OOB and NFS mounting, the operation done on OOB will have an impact on NFS. For Example, when interface eth0 is used for OOB and NFS mounting, executing shutdown command on the OOB interface will make the admin shut down and the NFS communication will be lost.

Example:

Your Product(config-if)# shutdown
Your product(config-subif)# shutdown

Display Commands

This section includes Interface display commands.

show ip interface

Command Objective:
This command displays the IP interface/L3 sub interface configuration.

Syntax:
show ip interface [vrf < vrf-name >] [{[Vlan < vlan_vfi_inner_id > [switch < switch-name >]] | [< interface-type > < interface-id >] | [loopback < loopback-id(0-100) >] | null0}] [vlan-counters]

Parameter Description:

  • vrf< vrf-name > - Displays IP interface for the specified VRF instance. This value represents unique name of the VRF instance. This value is a string whose maximum size is 32
  • Vlan< vlan_vfi_inner_id > - Displays the IP interface configuration for the specified VLAN/VFI ID. This is a unique value that represents the specific VLAN/VFI created. This value ranges from 1 to 4094. For double tagged VLAN the syntax is < vlan id:inner vlan id >
  • switch< switch-name > - Configures IP interface for the specified context. This value represents unique name of the switch context. This value is a string whose maximum size is 32 This parameter is specific to multiple instance feature. This feature has been included to adhere to the Industry Standard CLI syntax.
  • < interface-type > - Displays the IP interface configuration for the specified type of interface. The interface can be:
    • fastethernet - Officially referred to as 100BASE-T standard. This is a version of LAN standard architecture that supports data transfer up to 100 Megabits per second.
    • gigabitethernet - A version of LAN standard architecture that supports data transfer upto 1 Gigabit per second.
    • extreme-ethernet -A version of Ethernet that supports data transfer up to 10 Gigabits per second. This Ethernet supports only full duplex links.
    • internal-lan - Internal LAN created on a bridge per IEEE 802.1ap.
  • < interface-id > - Displays the IP interface configuration for the specified interface/L3 SubInterface identifier. This is a unique value that represents the specific interface/L3 SubInterface. This value is a combination of slot number and port number separated by a slash, for interface type other than i-lan. For example: 0/1 represents that the slot number is 0 and port number is 1. Only i-lan ID is provided, for interface type i-lan. For example: 1 represents i-lan ID. For example - subinterface: Slot number followed by port number followed by period and a logical number.
  • loopback< loopback-id(0-100) > - Displays the IP interface configuration for the specified loopback ID. This is a unique value that represents the specific loopback created. This value ranges from 0 to 100.
  • null0 - Displays the NULL interface configuration.
  • vlan-counters - Displays the VLAN traffic statistics details for all interfaces (for which the member port details are configured) available in the switch / all contexts.

Mode:
Privileged EXEC Mode

Default:
vrf - default


Note: If executed without the optional parameters this command displays the IP interface statistics and configuration for all the available interfaces.

Example:

Your product# show ip interface vrf default**
vlan1 is up, line protocol is down
Internet Address is 12.0.0.6/8
Broadcast Address  12.255.255.255
Vlan counters disabled

Gi0/1 is down, line protocol is down
Internet Address is 0.0.0.0/0
Broadcast Address  255.255.255.255
Vlan counters enabled

Gi0/1.1 is down, line protocol is down
Internet Address is 10.0.0.2/24
Broadcast Address  10.0.0.255
Vlan counters disabled
Your product # show ip interface vlan 1 switch default vlan-counters
vlan1 is up, line protocol is up
Internet Address is 12.0.0.1/8
Broadcast Address  12.255.255.255
Vlan counters disabled

Clear Commands

This section includes Interface debug and clear command.

clear counters

Command Objective:
This command clears all the current interface counters from the interface unless the optional arguments type and number are specified to clear only a specific interface type (serial, Ethernet, Token Ring, and so on).


Note: This command is a standardized implementation of the existing command and operates similar to that of the command clear interfaces - counters.

Syntax:
clear counters [ < interface-type > < interface-id > ]

Parameter Description:

  • < interface-type > -Clears the current counters for the specified type of interface/L3Subinterface. The interface can be:
    • fastethernet – Officially referred to as 100BASE-T standard. This is a version of LAN standard architecture that supports data transfer up to 100 Megabits per second.
    • gigabitethernet – A version of LAN standard architecture that supports data transfer up to 1 Gigabit per second.
    • extreme-ethernet – A version of Ethernet that supports data transfer up to 10 Gigabits per second. This Ethernet supports only full duplex links.
  • < interface-id > - Clears the current counters for the specified type of interface/L3Subinterface identifier. This is a unique value that represents the specific interface/L3Subinterface. This value is a combination of slot number and port number separated by a slash, for interface type other than i-lan. For Example: 0/1 represents that the slot number is 0 and port number is 1. Only i-lan ID is provided, for interface type i-lan. For Example: 1 represents i-lan ID. For example - subinterface: Slot number followed by port number followed by period and a logical number.

Mode :
Privileged EXEC Mode / Global Configuration Mode

Example:

Your product# clear counters
Your product (config)# clear counters

clear interfaces – counters

Command Objective:
This command clears all the current interface counters from the interface unless the optional arguments type and number are specified to clear only a specific interface type (serial, Ethernet, Token Ring, and so on).

Syntax:
clear interfaces [ < interface-type > < interface-id > ] counters

Parameter Description:

  • < interface-type > - Displays the IP interface configuration for the specified type of interface. The interface can be:
    • fastethernet – Officially referred to as 100BASE-T standard. This is a version of LAN standard architecture that supports data transfer up to 100 Megabits per second.
    • gigabitethernet – A version of LAN standard architecture that supports data transfer up to 1 Gigabit per second.
    • extreme-ethernet – A version of Ethernet that supports data transfer up to 10 Gigabits per second. This Ethernet supports only full duplex links.
  • < interface-id > - Displays the IP interface configuration for the specified interface identifier. This is a unique value that represents the specific interface. This value is a combination of slot number and port number separated by a slash, for interface type other than i-lan. For Example: 0/1 represents that the slot number is 0 and port number is 1. Only i-lan ID is provided, for interface type i-lan. For Example: 1 represents i-lan ID.

Mode :
Privileged EXEC Mode / Global Configuration Mode

Example:

Your product# clear interfaces counters
Your product (config)# clear interfaces counters

© 2024 Cisco and/or its affiliates. All rights reserved.
 
For more information about trademarks, please visit: Cisco trademarks
For more information about legal terms, please visit: Cisco legal terms

For legal information about Accedian Skylight products, please visit: Accedian legal terms and tradmarks



Was this article helpful?

What's Next
Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.