# Tunnel Interface Configuration Mode Commands

The Tunnel Interface Configuration Mode is used to create and manage the IP interfaces for various types of tunnels including associated parameters, such as addresses and address resolution options.

IMPORTANT:

The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).
description

Enters descriptive text for the current interface.
Platform:

ASR 5000

ASR 5500
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    description text

    no description

no

Clears the description for the interface.
text

Contains the descriptive text for this interface. text must be an alphanumeric string of 0 through 79 characters. If spaces are required, the string must be bracketed with double quotation marks (“). The interface description is case sensitive.
Usage:

Set the description to provide useful information regarding the interface’s primary function, services, end users, etc.
Example:
The following command describes this interface:

    description sampleInterfaceDescriptiveText

end

Exits the current configuration mode and returns to the Exec mode.
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    end

Usage:

Use this command to return to the Exec mode.
exit

Exits the current mode and returns to the parent configuration mode.
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    exit

Usage:

Use this command to return to the parent configuration mode.
ip address

Configures the IPv4 address for this tunnel interface.
Platform:

ASR 5000

ASR 5500
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    ip address [ip_address/ip_mask | ip_address ip_mask]

    no ip address ip_address

no

Removes the configured IPv4 address bound to a tunnel interface.
ip_address/ip_mask | ip_address ip_mask

Specifies a destination IP address or group of addresses that will use this route.

ip_address/ip_mask: Specifies a combined IP address subnet mask bits to indicate what IP addresses to which the route applies. ip_address/ip_mask must be specified using IPv4 dotted-decimal and CIDR notation. ip_maskis an integer which is the number of bits in the subnet mask.

ip_address ip_mask: Specifies an IP address and the networking (subnet) mask pair which is used to identify the set of IP addresses to which the route applies. ip_address must be specified using the IPv4 dotted-decimal notation. ip_mask must be specified using the IPv4 dotted-decimal notation as network mask for subnets.

The mask as specified by ip_mask or resulting from ip_address/ip_mask is used to determine the network for packet routing.

Zeroes (“0”) in the resulting mask indicate that the corresponding bit in the IP address is not significant in determining the network for packet routing.

Ones (“1”) in the resulting mask indicate the corresponding bit in the IP address is significant in determining the network.
Usage:

Use this command to bind the IPv4 address to a tunnel interface. This address does not affect the encapsulation of packets going out on the tunnel interface.
Example:
The following command will assign the 10.2.3.4 as IPv4 address to this tunnel interface:

    ip address 10.2.3.4

ipv6 address

Configures the IPv6 address for the specific tunnel interface.
Platform:

ASR 5000

ASR 5500
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    ipv6 address ipv6_address/ipv6_mask

    no ipv6 address ipv6_address

no

Removes the configured IPv6 address bound to a tunnel interface.
ipv6_address/ipv6_mask

Specifies a destination IP address or group of addresses that will use this route.

ipv6_address/ipv6_mask: Specifies a combined IP address subnet mask bits to indicate what IP addresses to which the route applies. ipv6_address/ipv6_mask must be specified usingIPv6 colon-separated-hexadecimal and CIDR notation. ipv6_mask is a numeric value which is the number of bits in the subnet mask.
Usage:

Use this command to bind the IPv6 address to a tunnel interface. This address does not affect the encapsulation of packets going out on the tunnel interface.
Example:
The following command will assign the 1001::2:010:1234 as IPv6 address to this tunnel interface:

    ipv6 address 1001::2:010:1234

tunnel-mode

Configures the tunnel mode type for this tunnel interface. It also enters the specific tunnel configuration mode, if required.
Platform:

ASR 5000

ASR 5500
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    tunnel-mode { gre | ipv6ip }

    defualt tunnel-mode

default

Sets the default tunnel mode for this interface. By default, the tunnel mode is set to IPv6-to-IPv4 type.
gre

Default: Disabled

Sets the tunnel interface mode to Generic Routing Encapsulation (GRE) type and enters the GRE Tunnel Configuration mode, if required.
ipv6ip

Default: Enabled

Sets the tunnel interface mode to IPv6-to-IPv4 type and creates the IPv6-to-IPv4 Tunnel Configuration mode, if required.
Usage:

Use this command to set the tunnel mode type of GRE or IPv6-to-IPv4 for the tunneling interface.
Example:
The following command sets the tunnel mode to GRE for specific interface:

    tunnel-mode gre