Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

show services l2tp tunnel

Syntax

Description

Display information about L2TP tunnels for LAC and LNS; the tunnels may or may not have active sessions.

Options

none

Display standard information about all active L2TP tunnels.

brief | detail | extensive

(Default) Display the specified level of output.

local-gateway gateway-address

(Optional) Display L2TP tunnel information for only the specified local gateway address.

local-gateway-name gateway-name

(Optional) Display L2TP tunnel information for only the specified local gateway name.

local-tunnel-id tunnel-id

(Optional) Display L2TP tunnel information for only the specified local tunnel identifier.

peer-gateway gateway-address

(Optional) Display L2TP tunnel information for only the specified peer gateway address.

peer-gateway-name gateway-name

(Optional) Display L2TP tunnel information for only the specified peer gateway name.

statistics

(Optional) Display the number of control packets and bytes transmitted and received for the tunnel. The statistics for a tunnel are retained until the tunnel is disconnected, rather than until the last session in the tunnel is cleared. Retaining the statistics enables them to increment in the event a new session subsequently uses the tunnel. You cannot include this option with any of the level options, brief, detail, or extensive.

tunnel-group group-name

(Optional) Display L2TP tunnel information for only the specified tunnel group.

Required Privilege Level

view

Output Fields

show services l2tp tunnel lists the output fields for the show services l2tp tunnel command. Output fields are listed in the approximate order in which they appear.

Table 1: show services l2tp tunnel Output Fields

Field Name

Field Description

Interface

(LNS only) Name of an adaptive services interface.

Tunnel group

(LNS only) Name of a tunnel group.

Local ID

On the LNS, number assigned by the LNS that identifies the local endpoint of the tunnel relative to the LNS: the LNS.

On the LAC, number assigned by the LAC that identifies the local endpoint of the tunnel relative to the LAC: the LAC.

Remote ID

On the LNS, number assigned by the LAC that identifies the remote endpoint of the tunnel relative to the LNS: the LAC.

On the LAC, number assigned by the LNS that identifies the remote endpoint of the tunnel relative to the LAC: the LNS.

Remote IP

IP address of the peer endpoint of the tunnel.

Sessions

Number of L2TP sessions established through the tunnel.

State

State of the L2TP tunnel:

  • cc_responder_accept_new—The tunnel has received and accepted the start control connection request (SCCRQ).

  • cc_responder_reject_new—The tunnel has received and rejected the SCCRQ.

  • cc_responder_idle—The tunnel has just been created.

  • cc_responder_wait_ctl_conn—The tunnel has sent the start control connection response (SCCRP) and is waiting for the start control connection connected (SCCCN) message.

  • clean-up—The tunnel is being cleaned up.

  • closed—The tunnel is being closed.

  • destroyed—The tunnel is being destroyed.

  • Drain—Creation of new sessions and destinations is disabled for this tunnel.

  • Established—The tunnel is operating. This is the only state supported for the LAC.

  • Terminate—The tunnel is terminating.

  • Unknown—The tunnel is not connected to the router.

Tunnel Name

(LAC only) Name of the created tunnel. This value includes the destination name followed by the value of the RADIUS Tunnel-Assignment-ID VSA [82].

Local IP

IP address of the local endpoint of the tunnel.

Local name

Name used for local tunnel endpoint during tunnel negotiation.

Remote name

Name used for remote tunnel endpoint during tunnel negotiation.

Effective Peer Resync Mechanism

(LAC only) Peer resynchronization mechanism (PRM) in effect for the tunnel:

  • Failover protocol

  • Silent failover—Recovery takes place in the failed endpoint only using the proprietary silent failover protocol.

Nas Port Method

NAS port method (type), which indicates whether the LAC sends Cisco NAS Port Info AVP (100) in ICRQs to the LNS:

  • cisco-avp—sends the AVP.

  • none—does not send the AVP.

Tunnel Logical System

Logical system in which the L2TP tunnel is brought up.

Tunnel Routing Instance

Routing instance in which the L2TP tunnel is brought up.

Max sessions

Maximum number of sessions that can be established on this tunnel.

The displayed limit for configured sessions is set to the lowest of the following configured session values for either LAC or LNS:

  • Global (chassis)—set services l2tp tunnel maximum-sessionsnumber

  • Tunnel profile (individual tunnel)—set access tunnel-profile profile-name tunnel tunnel-idmax-sessionsnumber]

  • RADIUS—Value of VSA 26–33, Tunnel-Max-Sessions

For LNS only, the following configuration is also considered:

  • Host profile—access profile l2tp-profile client default l2tp maximum-sessions-per-tunnel

Window size

Number of control messages that can be sent without receipt of an acknowledgment.

Hello interval

Interval between the transmission of hello messages, in seconds.

Create time

Date and time when the tunnel was created. While the LNS and LAC are connected, this value should correspond to the when the call was created. If connection to the LAC is severed, the State changes to Unknown and the Create time value resets.

Up time

Amount of time elapsed since the tunnel became active, in hours, minutes, and seconds.

Idle time

Amount of time elapsed since the tunnel became idle, in hours, minutes, and seconds.

Statistics since

Date and time when collection of the following statistics began:

  • Control Tx—Amount of control information transmitted, in packets and bytes.

  • Control Rx—Amount of control information received, in packets and bytes.

  • Data Tx—Amount of data transmitted, in packets and bytes.

  • Data Rx—Amount of data received, in packets and bytes.

  • Errors Tx—Number of errors transmitted, in packets.

  • Errors Rx—Number of errors received, in packets.

Sample Output

show services l2tp tunnel (LAC)

show services l2tp tunnel detail (LAC)

show services l2tp tunnel detail (LNS)

show services l2tp tunnel extensive (LAC)

show services l2tp tunnel extensive (LNS)

show services l2tp tunnel statistics