Feedback
Table Of Contents
Interfaces Command Reference
Revised: September 2011This chapter includes the commands used for configuring interfaces on Cisco MXE-OS devices.
clear counters
To clear interface counters, use the clear counters command.
clear counters {ethernet slot/port | MGT1}
Syntax Description
ethernet
Specifies data interface.
slot/port
Ethernet slot and port values. The range is from 1 to 2.
MGT1
Specifies management interface.
Syntax Description
This command has no keywords or arguments.
Defaults
None
Command Modes
EXEC
Supported User Rolesnetwork-admin
Command History
Usage Guidelines
None
Examples
This example clears the MGT1 counters:
mxe# clear counters MGT1clear ip traffic
To clear IP statistics, use the clear ip traffic command.
clear ip traffic
Syntax Description
This command has no keywords or arguments.
Defaults
None
Command Modes
EXEC
Supported User Rolesnetwork-admin
network-operatorCommand History
Usage Guidelines
None
Examples
This example clears the IP interface statistics:
mxe# clear ip trafficRelated Commands
description (interface)
To configure the description of an interface, use the description command. To remove this configuration, use the no form of this command.
description description
no description
Syntax Description
Defaults
None
Command Modes
Interface configuration
Supported User Rolesnetwork-admin
Command History
Usage Guidelines
None
Examples
This example configures a description for an Ethernet 1/1 interface:
mxe# configure terminalmxe(config)# interface ethernet 1/1mxe(config-if)# description Ethernet Port 1 on Module 1Related Commands
interface
To configure the Ethernet or management interface, use the interface command. To remove this configuration, use the no form of this command.
interface {ethernet slot/port | MGT1}
no interface {ethernet slot/port | MGT1}
Syntax Description
ethernet
Specifies data interface.
slot/port
Ethernet slot and port values. The range is from 1 to 2.
MGT1
Specifies management interface.
Defaults
None
Command Modes
Global configuration
Supported User Rolesnetwork-admin
Command History
Usage Guidelines
None
Examples
This example configures an Ethernet interface:
mxe# configure terminalmxe(config)# interface ethernet 1/1Related Commands
ip address
To configure an IP address for an interface, use the ip address command. To remove an IP address configuration, use the no form of this command.
ip address ip-address netmask
no ip address ip-address netmask
Syntax Descriptiondefault-
Defaults
None
Command Modes
Interface configuration
Supported User Rolesnetwork-admin
Command History
Usage Guidelines
None
Examples
These examples configure an IP address for an Ethernet interface:
mxe# configure terminalmxe(config)# interface ethernet 1/1mxe(config-if)# ip address 10.194.60.57 255.255.255.0Related Commands
ip default-gateway
To configure an IP default gateway address for an interface, use the ip default-gateway command. To remove an IP address configuation, use the no form of this command.
ip default-gateway ip-address
no ip default-gateway ip-address
Syntax Descriptiondefault-
Defaults
None
Command Modes
Interface configuration
Supported User Rolesnetwork-admin
Command History
Usage Guidelines
None
Examples
These examples configure a default gateway for an Ethernet interface:
mxe# configure terminalmxe(config)# interface ethernet 1/1mxe(config-if)# ip default-gateway 10.194.60.1Related Commands
ip domain-list
To declare the name(s) of the domain list(s) that Cisco MXE 5600 can use to complete unqualified host names, use the ip domain-list command. To remove an IP domain list name, use the no form of this command
ip domain-list domain-list-name
no ip domain-list domain-list-name
Syntax Description
Defaults
None
Command Modes
Global configuration
Supported User Rolesnetwork-admin
Command History
Usage Guidelines
A maximum of ten ip domain-list names can be declared.
Examples
This example configures an ip domain-list name:
mxe# configure terminalmxe(config)# ip domain-list mycompany.comRelated Commands
ip domain-lookup
To enable Domain Name Server (DNS) address translation, use the ip domain-lookup command. To disable IP domain lookup, use the no form of this command
ip domain-lookup
no ip domain-lookup
Syntax Description
This command has no keywords or arguments.
Defaults
Disabled
Command Modes
Global configuration
Supported User Rolesnetwork-admin
Command History
Usage Guidelines
None
Examples
This example enables DNS-based address translation on the Cisco MXE 5600:
mxe# configure terminalmxe(config)# ip domain-lookupRelated Commands
ip domain-name
To declare the name of the default domain that the Cisco MXE 5600 will use to complete unqualified host names, use the ip domain-name command. To remove a default domain server, use the no form of this command
ip domain-name default-domain-name
no ip domain-name default-domain-name
Syntax Description
Defaults
None
Command Modes
Global configuration
Supported User Rolesnetwork-admin
Command History
Usage Guidelines
The Cisco MXE 5600 appends the declared default-domain name to any host name that does not contain a complete domain name before starting a Domain Name Server (DNS) domain-name lookup.
Examples
This example declares myserver.com as the default domain server:
mxe# configure terminalmxe(config)# ip domain-name myserver.comRelated Commands
ip name-server
To configure the IP addresses of Domain Name Servers (DNS), use the ip name-server command. To remove a default domain server, use the no form of this command
ip name-server address [address2...address6]
no ip name-server address [address2...address6]
Syntax Description
Defaults
None
Command Modes
Global configuration
Supported User Rolesnetwork-admin
Command History
Usage Guidelines
Up to six IP addresses are allowed. A space must be placed between each IP address.
Examples
This example declares two DNS server IP addresses:
mxe# configure terminalmxe(config)# ip name-server 192.0.2.22 192.0.2.25Related Commands
ip route
To configure a static route, use the ip route command. To remove the static route, use the no form of this command.
ip route ip-prefix netmask ip-forward
no ip route ip-prefix netmask ip-forward
Syntax Description
Defaults
None
Command Modes
Global configuration
Supported User Rolesnetwork-admin
Command History
Usage Guidelines
None
Examples
This example creates a static route for destinations with the IP address prefix 10.0.0.0, reachable through the next-hop address 10.194.59.40:
mxe# configure terminalmxe(config)# ip route 10.0.0.0 255.255.255.255 10.194.59.40Related Commands
show hosts
To display information about the Domain Name Server (DNS) configuration, use the show host command.
show hosts
Syntax Description
This command has no keywords or arguments.
Defaults
None
Command Modes
EXEC
Supported User Rolesnetwork-admin
network-operatorCommand History
Usage Guidelines
None
Examples
This example shows DNS configuration information displayed using the show hosts command:
mxe# show hostsDNS lookup enabledDefault domain is myserver.comDomain list: mycompany.comName/address lookup uses domain serviceName servers are 192.0.2.22 192.0.2.25Related Commands
show interface
To display interface configurations and Cisco MXE-OS statistics, use the show interface command.
show interface [ethernet slot/port | mgt1]
Syntax Description
Defaults
None
Command Modes
EXEC
Supported User Rolesnetwork-admin
network-operatorCommand History
Usage Guidelines
If no parameter is specified the show interface command displays all interfaces available in the system.
Examples
This example displays all Cisco MXE-OS interface configurations:
mxe-node10# show interfaceEthernet 1/1 is upHardware type is ETHERNETMAC address is 68:ef:bd:48:5a:83IP address is 10.200.201.249 netmask is 255.255.255.0Description: not setMTU: 1500 bytes, BW: 1000000 Kbit/secLast clearing of "show interface" counters neverRx1409751 input packets 1347424 unicast packets 62319 multicast packets8 broadcast packets 972273734 bytes0 CRC 0 no buffer0 input error 0 short frame 0 overrun0 input discard 0 Rx pauseTx0 output packets 0 unicast packets 0 multicast packets0 broadcast packets 0 bytes0 output error 0 collision 0 deferred 0 late collision0 babble 0 Tx pauseMGT1 is upMAC address is 68:ef:bd:48:5a:55IP address is 10.194.59.249 netmask is 255.255.255.0Description: not setMTU: 1500 bytes, BW: 1000000 Kbit/secLast clearing of "show interface" counters neverRx374710 input packets 45585 unicast packets 122800 multicast packets206325 broadcast packets 63712267 bytes0 CRC 0 no buffer0 input error 0 short frame 0 overrun0 input discard 0 Rx pauseTx113936 output packets 113788 unicast packets 0 multicast packets148 broadcast packets 156725183 bytes0 output error 0 collision 0 deferred 0 late collision0 babble 0 Tx pauseThis example displays an MGT1 interface configuration and related statistics:
mxe# show interface MGT1MGT1 is upMAC address is 00:e0:0c:00:02:fdIP address is 10.194.58.222 netmask is 255.255.255.0Description: Local Management InterfaceMTU: 1500 bytesThis example displays an Ethernet interface configuration and related statistics:
mxe# show interface ethernet 1/1Ethernet 1/1 is upHardware type is ETHERNETMAC address is 00:e0:0c:02:01:fdIP address is 10.194.58.71 netmask is 255.255.255.0Description: Layer 2 Gigabit Ethernet LAN InterfaceMTU: 1500 bytesRelated Commands
show ip interface brief
To display brief summary of IP interface status, use the show ip interface brief command.
show ip interface brief [ethernet slot/port | mgt1]
Syntax Description
Defaults
None
Command Modes
EXEC
Supported User Rolesnetwork-admin
network-operatorCommand History
Usage Guidelines
None
Examples
This example displays IP information for MGT1:
mxe# show ip interface briefInterface IP-Address Status ProtocolEthernet 1/1 10.194.58.95 up upMGT1 10.195.58.95 up upRelated Commands
show ip route
To display an ip route table, use the show ip route command.
show ip route [summary]
Syntax Description
Defaults
None
Command Modes
EXEC
Supported User Rolesnetwork-admin
network-operatorCommand History
Usage Guidelines
None
Examples
This example displays an IP route table:
mxe# show ip routeIP Routing Table----------------Codes: H - host, I - interface, C - ConnectedS - static, N - natA - need arp resolve, E - ecmpDestination Gateway Interface Flags------------------------------------------------------------------------10.0.0.0/8 0.0.0.0 MGT1 IAC0.0.0.0/0 10.194.59.40 MGT1 IASRelated Commands
no ip route
Clears entries in the route table.
show ip traffic
To display IP traffic information, use the show ip traffic command.
show ip traffic
Syntax Description
This command has no keywords or arguments.
Defaults
None
Command Modes
EXEC
Supported User Rolesnetwork-admin
network-operatorCommand History
Usage Guidelines
None
Examples
This example displays the IP traffic information:
mxe(config)# show ip trafficIP Statistics for Management Processor--------------------------------------IP Statistics:Rcvd: 373517 packets937 input errors, 0 no route0 unknown protocolFrags: 0 reassembled, 0 couldn't assemble0 fragmented, 0 couldn't fragmentBcast: 3374 received, 97 sentMcast: 181 received, 0 sentSent: 322691 packets0 no routeDrop: 0 no route, 0 out discardedICMP statistics:Rcvd: 0 redirects, 14 unreachable0 echo, 375 echo reply, 0 mask requests, 0 mask replies, 0 quench0 parameter, 0 timestampSent: 0 redirects, 59 unreachable, 375 echo, 0 echo reply0 mask requests, 0 mask replies, 0 quench, 0 timestamp0 parameter, 0 time exceededTCP Statistics:Rcvd: 203057 total, 0 errorsSent: 200506 totalUDP Statistics:Rcvd: 168532 total, 0 errors, 148 no portSent: 121750 total