- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
09-Tunneling Commands | 68.65 KB |
The tunnel interface number is in the A/B/C format, where A, B, and C represent the slot number of a card, the slot number of a sub-card, and the tunnel interface number, respectively. The value ranges of A and B vary with devices, and that of C is from 0 to 1023.
Tunnel Configuration Commands
destination
Syntax
destination ip-address
undo destination
View
Tunnel interface view
Default Level
2: System level
Parameters
ip-address: Tunnel destination IPv4 address.
Description
Use the command destination to specify the destination address for the tunnel interface.
Use the undo destination command to remove the configured tunnel destination address.
By default, no tunnel destination address is configured.
Note that:
l The tunnel destination address is the address of the peer interface receiving packets and should be configured as the source address of the peer tunnel interface.
l Two or more tunnel interfaces using the same encapsulation protocol must have different source and destination addresses.
Related commands: interface tunnel, source.
Examples
# Set the interface VLAN-interface 100 (193.101.1.1) of Sysname 1 and the interface VLAN-interface 100 (192.100.1.1) of Sysname 2 as the source and destination interfaces of a tunnel between the two devices, respectively.
<Sysname1> system-view
[Sysname1] interface tunnel 2/0/0
[Sysname1-Tunnel2/0/0] source 193.101.1.1
[Sysname1-Tunnel2/0/0] destination 192.100.1.1
<Sysname2> system-view
[Sysname2] interface tunnel 2/0/1
[Sysname2-Tunnel2/0/1] source 192.100.1.1
[Sysname2-Tunnel2/0/1] destination 193.101.1.1
display interface tunnel
Syntax
display interface tunnel [ number ]
View
Any view
Default Level
1: Monitor level
Parameters
Description
Use the display interface tunnel command to display related information of a specified tunnel interface, such as source address, destination address, and encapsulation mode.
Related commands: interface tunnel, source, destination, tunnel-protocol.
Examples
# Display the information of the interface tunnel 2/0/0.
<Sysname> display interface tunnel 2/0/0
Tunnel2/0/0 current state: UP
Line protocol current state: UP
Description: Tunnel2/0/0 Interface
The Maximum Transmit Unit is 1476
Internet Address is 10.1.2.1/24 Primary
Encapsulation is TUNNEL, service-loopback-group ID is 1.
Tunnel source 192.13.2.1, destination 192.13.2.2
Tunnel protocol/transport IPv6/IP
Output queue : (Urgent queuing : Size/Length/Discards) 0/100/0
Output queue : (Protocol queuing : Size/Length/Discards) 0/500/0
Output queue : (FIFO queuing : Size/Length/Discards) 0/75/0
Last 300 seconds input: 0 bytes/sec, 0 packets/sec
Last 300 seconds output: 0 bytes/sec, 0 packets/sec
361 packets input, 9953388 bytes
0 input error
361 packets output, 30324 bytes
0 output error
Table 1-1 display interface tunnel command output description
Field |
Description |
Tunnel2/0/0 current state: UP |
The physical-layer connectivity of the tunnel interface is established. |
Line protocol current state: UP |
The link-layer connectivity of the tunnel interface is established. |
Description |
Descriptive information of the tunnel interface |
Tunnel2/0/0 Interface |
Tunnel interface number |
Maximum Transmit Unit |
Maximum transmission unit (MTU) in the tunnel |
Encapsulation is TUNNEL |
The encapsulation protocol is tunnel. |
service-loopback-group ID |
Service loopback group referenced by the tunnel. |
Tunnel source |
Tunnel source address |
destination |
Tunnel destination address |
Tunnel protocol/transport |
Tunnel protocol and transport protocol. |
Output queue : (Urgent queuing : Size/Length/Discards) |
Packet statistics of the urgent queue |
Output queue : (Protocol queuing : Size/Length/Discards) |
Packet statistics of the protocol queue |
Output queue : (FIFO queuing : Size/Length/Discards) |
Packet statistics of the FIFO queue |
Last 300 seconds input |
Number of bytes and packets input per second in the last five minutes. |
Last 300 seconds output |
Number of bytes and packets output per second in the last five minutes. |
packets input |
Total number of input packets. |
input error |
Number of error packets among all input packets. |
packets output |
Total number of output packets. |
output error |
Number of error packets in all output packets |
display ipv6 interface tunnel
Syntax
display ipv6 interface tunnel [ number ] [ verbose ]
View
Any view
Default Level
1: Monitor level
Parameters
number: Tunnel interface number.
verbose: Displays the detailed configuration and IPv6 packet statistics of the specified tunnel interface.
Description
Use the display ipv6 interface tunnel command to display the configuration and IPv6 packet statistics of a tunnel interface or all tunnel interfaces.
Note that:
l If no tunnel interface is specified, information about all tunnel interfaces is displayed.
l If the verbose keyword is not specified, summary tunnel interface information is displayed.
Examples
# Display the detailed information of interface tunnel 2/0/0.
<Sysname> display ipv6 interface tunnel 2/0/0 verbose
Tunnel2/0/0 current state :UP
Line protocol current state :UP
IPv6 is enabled, link-local address is FE80::202:201
Global unicast address(es):
3000::1, subnet is 3000::/64
Joined group address(es):
FF02::1:FF02:201
FF02::1:FF00:1
FF02::1:FF00:0
FF02::2
FF02::1
MTU is 1480 bytes
ND reachable time is 30000 milliseconds
ND retransmit interval is 1000 milliseconds
Hosts use stateless autoconfig for addresses
IPv6 Packet statistics:
InReceives: 45
InTooShorts: 0
InTruncatedPkts: 0
InHopLimitExceeds: 0
InBadHeaders: 0
InBadOptions: 0
ReasmReqds: 0
ReasmOKs: 0
InFragDrops: 0
InFragTimeouts: 0
OutFragFails: 0
InUnknownProtos: 0
InDelivers: 45
OutRequests: 45
OutForwDatagrams: 0
InNoRoutes: 0
InTooBigErrors: 0
OutFragOKs: 0
OutFragCreates: 0
InMcastPkts: 0
InMcastNotMembers: 0
OutMcastPkts: 0
InAddrErrors: 0
InDiscards: 0
OutDiscards: 0
Table 1-2 display interface tunnel command output description
Field |
Description |
Tunnel2/0/0 current state |
The physical-layer state of the tunnel interface |
Line protocol current state |
The link-layer protocol state of the tunnel interface |
IPv6 is enabled |
IPv6 forwarding state of the tunnel interface (IPv6 is enabled on the tunnel interface in this example) |
link-local address |
Link-local address of the tunnel interface |
Global unicast address(es) |
Aggregatable global unicast address of the tunnel interface. |
Joined group address(es) |
Multicast address of the tunnel interface. |
MTU is 1500 bytes |
Size of the MTU in the tunnel. |
ND reachable time |
Neighbor reachable time |
ND retransmit interval |
Interval for retransmitting a neighbor discovery request message. |
Hosts use stateless autoconfig for addresses |
Hosts use the stateless auto-configuration mode to acquire IPv6 addresses. |
InReceives |
All IPv6 packets received on the tunnel interface, including error packets. |
InTooShorts |
IPv6 packets that are too short in length received on the tunnel interface, such as a packet with a length less than 40 bytes. |
InTruncatedPkts |
IPv6 packets received on the tunnel interface, with a length less than that specified in the packet header. |
InHopLimitExceeds |
IPv6 packets having exceeded the hop limit received on the tunnel interface |
InBadHeaders |
IPv6 packets with wrong basic headers received on the tunnel interface |
InBadOptions |
IPv6 packets with wrong extension headers received on the tunnel interface |
ReasmReqds |
IPv6 fragments received on the tunnel interface |
ReasmOKs |
Number of IPv6 datagrams reassembled on the tunnel interface. |
InFragDrops |
Wrong IPv6 fragments discarded on the tunnel interface |
InFragTimeouts |
IPv6 fragments discarded on the interface because they had stayed in the cache longer than the specified time. |
OutFragFails |
IPv6 Packets that failed to be fragmented on the outbound tunnel interface |
InUnknownProtos |
IPv6 packets received on the tunnel interface, with an unknown or unsupported protocol type. |
InDelivers |
IPv6 packets delivered to the upper-layer IPv6 protocols (such as ICMPv6, TCP, or UDP) from the tunnel interface |
OutRequests |
Local IPv6 packets from the upper-layer IPv6 protocols |
OutForwDatagrams |
IPv6 packets forwarded by the outbound tunnel interface |
InNoRoutes |
IPv6 packets discarded on the interface because no matching route is found |
InTooBigErrors |
IPv6 packets discarded while being forwarded on the interface due to exceeding MTU values |
OutFragOKs |
Packets that are successfully fragmented on the outbound interface |
OutFragCreates |
Fragments on the outbound interface |
InMcastPkts |
IPv6 multicast packets received on the interface |
InMcastNotMembers |
IPv6 multicast packets discarded on the interface because the interface does not belong to the corresponding multicast groups |
OutMcastPkts |
IPv6 multicast packets sent on the interface |
InAddrErrors |
IPv6 packets discarded on the interface due to illegal destination addresses |
InDiscards |
IPv6 packets received but then discarded on the interface due to resource problems rather than packet content errors |
OutDiscards |
IPv6 packets sent on the interface but then discarded due to resource problems rather than packet content errors |
# Display the summary IPv6 information of the interface tunnel 2/0/0.
<Sysname> display ipv6 interface tunnel 2/0/0
*down: administratively down
(s): spoofing
Interface Physical Protocol IPv6 Address
Tunnel2/0/0 up up 3000::1
Table 1-3 display ipv6 interface tunnel command output description
Field |
Description |
*down |
The tunnel interface is in administrative down state, meaning the interface is shut down using the shutdown command. |
(s) |
Spoofing feature of the tunnel interface. That is, although the link-layer protocol state of the interface is up, no such link exists, or the link is not a permanent one and can only be established as needed. |
Interface |
Name of the tunnel interface |
Physical |
Physical state of the tunnel interface |
Protocol |
Link-layer protocol state of the tunnel interface |
IPv6 Address |
IPv6 address of the tunnel interface. Only the first configured IPv6 address is displayed |
interface tunnel
Syntax
interface tunnel number
undo interface tunnel number
View
System view
Default Level
2: System level
Parameters
number: Tunnel interface number. The tunnel interface number is in the A/B/C format, where A, B, and C represent the slot number of a card, the slot number of a sub-card, and the tunnel interface number, respectively. The value ranges of A and B vary with devices, and that of C is from 0 to 1023.
Description
Use the interface tunnel command to create a tunnel interface and enter tunnel interface view.
Use the undo interface tunnel command to remove the specified tunnel interface.
By default, there is no tunnel interface on the device.
l Executing the interface tunnel command enters interface view of a specified tunnel. If no tunnel interface is created, executing this command first creates a tunnel and then enters the tunnel interface view.
l A tunnel interface number has only local significance, and therefore, the same interface number or different interface numbers can be set at both ends of a tunnel.
Related commands: display interface tunnel, source, destination, tunnel-protocol.
Examples
# Create the interface tunnel 2/0/3.
<Sysname> system-view
[Sysname] interface tunnel 2/0/3
[Sysname-Tunnel2/0/3]
service-loopback-group
Syntax
service-loopback-group number
undo service-loopback-group
View
Tunnel interface view
Default Level
2: System level
Parameters
number: Service loopback group ID, in the range of 1 to 1024.
Description
Use the service-loopback-group command to reference a service loopback group on the tunnel interface.
Use the undo service-loopback-group command to remove the referenced service loopback group from the tunnel interface.
By default, no service loopback group is referenced on a tunnel interface.
The service loopback group to be referenced must have been configured and have the service type set to tunnel in system view.
One tunnel interface can reference only one service loopback group.
Related commands: service-loopback group in Service Loopback Group Commands in the Access Volume.
Examples
# Create service loopback group 1 of tunnel type.
<Sysname> system-view
[Sysname] service-loopback group 1 type tunnel
# Add a Layer 2 GigabitEthernet interface to service loopback group 1.
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] stp disable
[Sysname-GigabitEthernet1/0/1] port service-loopback group 1
[Sysname-GigabitEthernet1/0/1] quit
# Reference service loopback group 1 on interface tunnel 2.
[Sysname] interface tunnel 2/0/2
[Sysname-Tunnel2/0/2] service-loopback-group 1
source
Syntax
source { ip-address | interface-type interface-number }
undo source
View
Tunnel interface view
Default Level
2: System level
Parameters
ip-address: Tunnel source IPv4 address.
Description
Use the source command to specify the source address or interface of the tunnel interface.
Use the undo source command to remove the configured source address or interface of the tunnel interface.
By default, no source address or interface is specified for the tunnel interface.
Note that:
l The tunnel source address is the address of the interface sending packets and should be configured as the destination address of the peer tunnel interface.
l Two or more tunnel interfaces using the same encapsulation protocol must have different source addresses and destination addresses.
Related commands: interface tunnel, destination.
Examples
# Set the tunnel source address to 192.100.1.1 (or the interface VLAN-interface 100) on the interface Tunnel 2/0/5.
<Sysname> system-view
[Sysname] interface tunnel 2/0/5
[Sysname-Tunnel2/0/5] source 192.100.1.1
Or
<Sysname> system-view
[Sysname] interface tunnel 2/0/5
[Sysname-Tunnel2/0/5] source vlan-interface 100
tunnel-protocol
Syntax
tunnel-protocol ipv6-ipv4 [ 6to4 | isatap ]
undo tunnel-protocol
View
Tunnel interface view
Default Level
2: System level
Parameters
ipv6-ipv4: Sets the tunnel to an IPv6 manual tunnel.
ipv6-ipv4 6to4: Sets the tunnel to IPv6 over IPv4 6to4 tunnel.
ipv6-ipv4 isatap: Sets the tunnel to an IPv6 over IPv4 ISATAP tunnel.
Description
Use the tunnel-protocol command to configure the tunnel mode.
Use the undo tunnel-protocol to restore the default tunnel mode.
By default, the tunnel is a IPv6 manual tunnel.
Note that:
l A proper tunnel mode can be selected for packet encapsulation according to the network topology and application. The same tunnel mode must be configured at both ends of the tunnel. Otherwise, packet delivery will fail.
l Only one automatic tunnel can be configured at the same tunnel source.
Examples
# Specify the tunnel mode as IPv6 over IPv4 6to4 tunnel interface.
<Sysname> system-view
[Sysname] interface tunnel 2/0/2
[Sysname-Tunnel2/0/2] tunnel-protocol ipv6-ipv4 6to4