Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

show dynamic-tunnels database

date_range 19-Nov-23

Syntax

content_copy zoom_out_map
show dynamic-tunnels database 
<destination> 
<logical-system (all | logical-system-name) >
<table routing-table-name>

Description

Display dynamic tunnel database information.

Options

none

Display dynamic tunnel database information for all destinations and routing tables.

destination

(Optional) Display database entries for the specified IP address (with optional destination prefix length) only.

logical-system (all | logical-system-name)

(Optional) Perform this operation on all logical systems or on a particular logical system.

table routing-table-name

(Optional) Display database entries for the specified table only.

Required Privilege Level

view

Output Fields

Table 1 lists the output fields for the show dynamic-tunnels database command. Output fields are listed in the approximate order in which they appear.

Table 1: show dynamic-tunnels database Output Fields

Field Name

Field Description

Table

Name of the routing table (for example, inet.0).

Destination-network

Destination IP address and subnet.

Tunnel to

Destination IP address and prefix of the tunnel.

State

State of the tunnel: Up, Up (expires in nn:nn:nnseconds), or Dn (down).

Reference count

Number of routes across the dynamic tunnel that are currently being resolved.

Next-hop type

Type of tunnel: GRE or UDP (BGP-Signal).

  • GRE, IPoIP, or UDP (BGP signal)

  • SR-TE—Segment routing traffic-engineered LSP.

  • GREv6,

  • UDPv6

  • IPIPv6.

Source address

Source IP address of the tunnel.

Next-hop

IP address of the destination interface.

VPN Label

The label provided by the peer device to identify the VPN through which the packet needs to go. This label is used to identify the VRF for route lookup.

Ingress Route

The IGP route along with the corresponding metric that has been selected for forwarding the tunnel-encapsulated packet.

Localized PFE

Packet Forwarding Engine interface which is the anchor Packet Forwarding Engine for the localized next-hop-based dynamic tunnels.

When the anchor Packet Forwarding Engine of the tunnel goes down, it is represented by a # near the Packet Forwarding Engine name.

LSP template name

Name of the segment routing traffic-engineered template configured for dynamic creation of segment routing LSPs.

State

State of the destination interface: Up, Dn, or Dn (no tunnel pic).

Status

Status of the dynamic segment routing LSP.

Tunnel Encapsulation

State of the encapulated packet.

Traffic Statistics Number of packets transmitted.

Sample Output

show dynamic-tunnels database (Tunnel Is Up)

content_copy zoom_out_map
user@host> show dynamic-tunnels database   
Table: inet.3

Destination-network: 10.255.120.94/32
Tunnel to: 10.255.120.94/32
  Reference count: 4
  Next-hop type: UDP
    Source address: 10.255.120.92
    Next hop: tunnel-composite, 0x31132f64, nhid 3406
      VPN Label: Push 120 Reference count: 3
      Ingress Route: 10.255.120.94/32, via metric 2
      Traffic Statistics: Packets 241367951, Bytes 356741831578 
      State: Up

show dynamic-tunnels database (No Tunnel PIC)

content_copy zoom_out_map
user@host> show dynamic-tunnels database   
Table: inet.3

Destination-network: 10.255.120.94/32
Tunnel to: 10.255.120.94/32 State: Dn
  Reference count: 2
  Next-hop type: gre
    Source address: 10.255.120.92
    State: Dn (no tunnel pic)

show dynamic-tunnels database (Tunnel Is Expiring)

content_copy zoom_out_map
user@host> show dynamic-tunnels database   
Table: inet.3

Destination-network: 10.255.120.94/32
Tunnel to: 10.255.120.94/32 State: Up (expires in 00:14:56 seconds)
  Reference count: 0
  Next-hop type: gre
    Source address: 10.255.120.92
    Next hop: gr-4/3/0.32769
    State: Up

show dynamic-tunnels database (Destination Specified)

content_copy zoom_out_map
user@host> show dynamic-tunnels database 10.255.120.94   
Table: inet.3

Destination-network: 10.255.120.94/32
Tunnel to: 10.255.120.94/32 State: Up
  Reference count: 2
  Next-hop type: gre
    Source address: 10.255.120.92
    Next hop: gr-4/3/0.32769
    State: Up

show dynamic-tunnels database (Localization)

content_copy zoom_out_map
user@host> show dynamic-tunnels database
Destination-network: 10.0.0.0/8
Tunnel to: 10.1.1.6/32
  Reference count: 5
  Next-hop type: UDP
	Source address: 10.1.1.2
	Next hop: tunnel-composite, 0xc807930, nhid 1016
	Localized PFE: pfe-1/0/0
 	VPN Label: Push 299808 Reference count: 4
 Ingress Route: 10.1.1.6/32, via metric 2
 Traffic Statistics: Packets 0, Bytes 0
 State: Up

show dynamic-tunnels database (MPLS-over-UDP Dynamic Tunnels on PTX Series Routers and QFX Series Switches)

content_copy zoom_out_map
user@host> show dynamic-tunnels database
*- Signal Tunnels #- PFE-down
Table: inet.3       

Destination-network: 10.33.0.0/16

Destination-network: 10.33.44.0/24

show dynamic-tunnels database (Segment Routing LSPs)

content_copy zoom_out_map
user@host> show dynamic-tunnels database
Table: inetcolor.0

Destination-network: 10.33.44.0:0/24    
Tunnel to: 10.33.44.55:124/64
  Reference count: 2
  Next-hop type: SRTE
  LSP template name: 10.33.44.55:7c:dt-srte-tunnel1
  Status: Initiated/Established

show dynamic-tunnels database (Dynamic Tunnels for IPv6 underlay on PTX Series Routers)

content_copy zoom_out_map
user@host> show dynamic-tunnels database
*- Signal Tunnels #- PFE-down
Table: inet6.3

Destination-network: 100::6464:6402/128

Tunnel to: 100::6464:6402/128
  Reference count: 3
  Next-hop type: UDPv6 (forwarding-nexthop)
    Source address: 1010::1
    Next hop: tunnel-composite, 0x7b42614, nhid 559
      Reference count: 2
      Ingress Route: [OSPF3] 100::6464:6402/128, via metric 1
      Traffic Statistics: Packets 0, Bytes 0
      State: Up
  Aggregate Traffic Statistics:
    Tunnel Encapsulation: Dest 100::6464:6402, Src 1010::1, UDPv6, Tunnel-Id 2
    Traffic Statistics: Packets 0, Bytes 0

show dynamic-tunnels database summary

content_copy zoom_out_map
user@host> show dynamic-tunnels database summary
Dynamic Tunnels,  Total 1 displayed
GRE Tunnel:
Active Tunnel Mode, Next Hop Base
  IFL Based,  Total 0 displayed, Up 0, Down 0
  Nexthop Based,  Total 0 displayed, Up 0, Down 0
RSVP Tunnel:
  Total 0 displayed
SPRING-TE tunnel:
  Total 0 displayed, Up 0, Down 0
UDP Tunnel:
  Total 0 displayed, Up 0, Down 0
IPIP Tunnel:
  Total 0 displayed, Up 0, Down 0
GREv6 Tunnel:
Active Tunnel Mode, Next Hop Base
  IFL Based,  Total 0 displayed, Up 0, Down 0
  Nexthop Based,  Total 0 displayed, Up 0, Down 0
UDPv6 Tunnel:
  Total 1 displayed, Up 1, Down 0
IPIPv6 Tunnel:
  Total 0 displayed, Up 0, Down 0

show route table inet6.3 extensive

content_copy zoom_out_map
user@host> show route table inet6.3 extensive 
inet6.3: 1 destinations, 2 routes (1 active, 0 holddown, 0 hidden)
100::6464:6402/128 (2 entries, 1 announced)
        *Tunnel Preference: 5
                Next hop type: Tunnel Composite, Next hop index: 0
                Address: 0x7b3eb04
                Next-hop reference count: 2, key opaque handle: 0x0, non-key opaque handle: 0x0
                Tunnel type: UDPv6, (extended-attr), Reference count: 1, nhid: 0
                Destination address: 100::6464:6402, Source address: 1010::1
                Tunnel encap routing table id : 0, Tunnel decap routing table id : 0
                State: <Active>
                Local AS:  1000
                Age: 3:18:04    Metric: 1
                Validation State: unverified
                Area: 0.0.0.0
                Task: DYN_TUNNEL
                Announcement bits (3): 0-Resolve tree 2 1-Resolve_IGP_FRR task 2-Resolve tree 4
                AS path: I
                Thread: junos-main
         Tunnel Preference: 5
                Next hop type: Tunnel, Next hop index: 0
                Address: 0x7b3e7f4
                Next-hop reference count: 1, key opaque handle: 0x0, non-key opaque handle: 0x0
                Inactive reason: Route Preference
                Local AS:  1000
                Age: 3:18:04
                Validation State: unverified
                Task: DYN_TUNNEL
                AS path: I
                Thread: junos-main

show dynamic-tunnels database <destination> terse tunnel-type ?

content_copy zoom_out_map
user@host> show dynamic-tunnels database 100::6464:6402 terse tunnel-type udpv6 tunnel-id 2
Warning: License key missing; requires 'mplsoudp' license

*- Signal Tunnels #- PFE-down
Table: inet6.3

Destination-network: 100::6464:6402/128
Destination                      Source          Next-hop                 Type       Status
100::6464:6402/128               1010::1         0x7b42614 nhid 559       UDPv6      Up (via metric 1)

show dynamic-tunnels database statistics tunnel-type ?

content_copy zoom_out_map
user@host>show dynamic-tunnels database statistics tunnel-type ?
Possible completions:
  gre                  GRE tunnel type
  grev6                GRE v6 tunnel type
  ipoip                IPIP tunnel type
  ipv6                 IPv6 tunnel type
  udp                  UDP tunnel type
  udpv6                UDP v6 tunnel type

Release Information

Command introduced before Junos OS Release 7.4.

footer-navigation