show l2tp

This chapter describes the outputs of the show l2tp command.

show l2tp sessions

Table 1. show l2tp sessions Command Output Descriptions
Field Description

L2TP Summary

Sessions In Progress

The total number of L2TP sessions currently being facilitated by the system.

Data Stats

Rx Data Pkts

The total number of data packets received.

Tx Data Pkts

The total number of data packets transmitted.

Rx Data Octs

The total number of data octets received.

Tx Data Octs

The total number of data octets transmitted.

Rx Discard Data Pkts

The total number of data packets received and discarded.



show l2tp session full username

Table 2. show l2tp session full username Command Output Descriptions
Field Description

Username

The username of a currently active subscriber session.

Callid

The call identification number (callid) of a currently active subscriber session.

Msid

The Mobile Station Identification (MSID) number of a currently active subscriber session.

Peer IP Address

The IP address of the LNS to which the subscriber’s L2TP session is connected.

Service Name

The name of the LAC-service configured on the system currently facilitating the subscriber’s L2TP session.

Context Name

The name of the context where service processing the current session is configured.

Service Type

The type of service type processing the current session. Possible values are:
  • LAC
  • LNS

Session State

Indicates the current state of the session as one of the following:
  • LAC_Established
  • LAC_IDLE
  • LAC_WAIT_TUNNEL
  • LAC_WAIT_REPLY

Local Tunnel ID

The unique, system-assigned identification number of the L2TP tunnel facilitating the session.

Local Session ID

The unique, system-assigned identification number of the L2TP session.

Peer Tunnel ID

The unique, LNS-assigned identification number of the L2TP tunnel facilitating the session.

Peer Session ID

The unique, LNS-assigned identification number of the L2TP session.

Call Type

Indicates the type of session as the following:
  • LAC-INCOMING : A call arrived at the LAC service from an MS to be tunneled to an LNS.

Call Serial Num

The Call Serial Number attribute value pair (AVP) assigned to the session.

Rx Connect Speed

The speed of the connection from the LNS to LAC service on the system in bits per second (bps).

Tx Connect Speed

The speed of the connection from the LAC service on the system to the LNS in bits per second (bps).

PPP Proxy-Auth

Indicates the protocol used to authenticate the subscriber as one of the following:
  • CHAP-MD5
  • PAP
  • MS-CHAP

Bearer Type

The Bearer Capabilities AVP for the system indicating the type of interfaces supported.

Framing Type

Indicates the PPP framing type used for the session as one of the following:
  • ASYNC
  • SYNC

Data Rx Sequence Num Enabled

Indicates whether or not the use of sequence numbers is enabled for traffic received.

Data Tx Sequence Num Enabled

Indicates whether or not the use of sequence numbers is enabled for traffic transmitted.

Data Rx Sequence Num

If DATA Rx Sequence Num Enabled is enabled, this field displays the current sequence number being processed.

Data Tx Sequence Num

If DATA Tx Sequence Num Enabled is enabled, this field displays the current sequence number being processed.

Rx Data Pkts

The total number of data packets received.

Tx Data Pkts

The total number of data packets transmitted.

Rx Data Octs

The total number of data octets received.

Tx Data Octs

The total number of data octets transmitted.

Rx Discard Data Pkts

The total number of data packets received and discarded.

Total sessions matching specified criteria

The total number of sessions matching the filter criteria (in this example, the subscriber’s name).



show l2tp statistics lac-service

Table 3. show l2tp statistics lac-service Command Output Descriptions
Field Description

LAC Service

The name of the LAC service for which statistics are being displayed.

Tunnels

Connection Attempts

The total number of attempts made to connect tunnels.

Successful Connections

The total number of tunnels successfully connected.

Failed to Connect

The total number of tunnels that failed to connect.

Active Connections

The total number of tunnels currently connected.

Receive Ctrl Pkt Errors

Total Discarded Packets

The Total number of packets that were discarded.

Ctrl Field Errors

The total number of errors received in packet control fields.

Pkt Len Errors

The total number of errors resulting from the receipt of packets of invalid length.

AVP Len Errors

The total number of errors resulting from the receipt of packets containing attribute value pairs (AVPs) of incorrect length.

Proto Ver Errors

The total number of errors resulting from the receipt of packets containing invalid protocol versions.

MD5 Errors

The total number of errors resulting from the receipt of packets containing incorrect Message Digest 5 (MD5) hashing.

Inval Attr Errors

The total number of errors resulting from the receipt of packets containing invalid attributes.

Unknown Attr Errors

The total number of errors resulting from the receipt of packets containing unknown attributes.

Inval SessIDErrors

The total number of errors resulting from the receipt of packets indicating an invalid session identification (ID) number.

Inval State Errors

The total number of errors resulting from the receipt of packets indicating an invalid state.

Unknown Msg Errors

The total number of errors resulting from the receipt of unknown messages.

Unmatch Pkt Len

The total number of errors resulting from the receipt of packets of invalid length.

Inval TunID Errors

The total number of errors resulting from the receipt of packets indicating an invalid tunnel identification (ID) number.

Tunnel Disconnect or Failure Reasons

General Clear

The total number of tunnels that were disconnected normally (StopCCN result code 1).

Ctrl Conn Exists

The total number of tunnels that failed to connect because the control channel already existed (StopCCN result code 3).

Unauthorized Errors

The total number of tunnels that failed to connect because the requester was not authorized to establish the control channel (StopCCN result code 4).

Bad Protocol Errors

The total number of tunnels that failed to connect because the protocol version of the requester is not supported (StopCCN result code 5).

Requester Shutdown

The total number of tunnels that failed to connect because the requester is being shutdown (StopCCN result code 6).

State Machine Errors

The total number of tunnels that failed to connect because of an error with the finite state machine (StopCCN result code 7).

Wrong Length

The total number of general errors that occurred because the length of the control channel was incorrect (Error code 2).

Out of Range Errors

The total number of general errors that occurred because either one of the values of the field was out of range or the reserved field was non-zero (Error code 3).

Insuff Resources

The total number of general errors that occurred because resources were not available to process the request (Error code 4).

Vendor Specific Errors

The total number of general errors hat occurred because vendor-specific errors occurred in the LAC (Error code 6).

Try Another LNS

The total number of general errors that occurred because the LNS indicated that the LAC service should attempt to establish the control channel with an alternate LNS (Error code 7).

Unknown AVP with M bit

The total number of general errors that occurred because a session or tunnel was disconnected due to the receipt of an unknown AVP with the M-bit set (Error code 8).

IPSEC Disconnects

When IPSec is used, this is the total number of tunnels that were disconnected or that failed to connect due to the IPSec tunnel being disconnected.

IPSEC Failures

When IPSec is used, this is the total number of tunnels that were disconnected or that failed to connect due to failures that occurred for the IPSec tunnel.

License Exceeded

The number of tunnel attempts that failed because the maximum number of tunnels allowed by the installed license key was reached.

New Call Policy Disc

The total number of L2TP tunnels disconnected because of a new call policy being instituted.

Max Retry Exceeded

The total number of tunnels that failed to connect because the value configured for the max-retransmissions parameter set for the LAC-service was exceeded.

Tunnels System Limit

The total number of tunnels that failed because the maximum number of tunnels that the system supports was reached.

Misc Errors

The total number of errors that occurred that did not fall into any of the above categories.

Last Rx Tunnel Result Code

The last tunnel result code generated for received packets.

Last Rx Tunnel Error Code

The last tunnel error code generated for received packets.

Last Rx Tunnel Err Code Msg

The error indicated by the last tunnel error code generated for received packets.

Last Tx Tunnel Result Code

The last tunnel result code generated for transmitted packets.

Last Tx Tunnel Error Code

The last tunnel error code generated for transmitted packets.

Last Tx Tunnel Err Code Msg

The error indicated by the last tunnel error code generated for transmitted packets.

Sessions

Session Attempts

The total number of attempts made to connect sessions.

Successful Sessions

The total number of sessions successfully connected.

Failed to Connect

The total number of sessions that failed to connect.

Active Sessions

The total number of sessions currently connected.

Intra-PDSN Handoff Sessions

Attempts

The total number of attempts to handoff subscriber sessions to another PDSN within this system.

Success

The total number of successful handoffs of subscriber sessions to another PDSN within this system.

Failures

The total number of failures when attempting to handoff subscriber sessions to another PDSN within this system.

Inter-PDSN Handoff Sessions

Attempts

The total number of attempts were made by outside PDSNs to transfer a call to this PDSN.

Session Disconnect or Failure Reasons

No General Error:

The total number of normal disconnect with no errors.

Administrative

The total number of sessions that failed to connect due to administrative reasons (CDN result code of 3).

Loss of Carrier

The total number of sessions that were disconnected due to a loss of carrier (CDN result code of 1).

Remote Administrative:

The total number of sessions that failed to connect due to remote administrative reasons.

No Facility Avl Tmp

The total number of sessions that failed to connect due to the temporary lack of required facilities (CDN result code of 4).

No Facility Avl Perm

The total number of sessions that failed to connect due to the permanent lack of required facilities (CDN result code of 5).

Invalid Destination

The total number of sessions that failed to connect due to the specification of an invalid destination (CDN result code of 6).

No Carrier Detected

The total number of sessions that failed to connect because no carrier signal was detected (CDN result code of 7).

Busy Signal

The total number of sessions that failed to connect due to the receipt of a busy signal (CDN result code of 8).

No Dial Tone

The total number of sessions that failed to connect because no dial tone was detected (CDN result code of 9).

LAC Timeout

The total number of sessions that failed to connect within the time allotted by the LAC service (CDN result code of 10).

No Approp Framing

The total number of sessions that failed to connect because no appropriate framing was detected (CDN result code of 11).

No Ctrl Conn

The total number of sessions that failed to connect because no control channel existed (StopCCN result code of 1).

Wrong Length

The total number of general errors that occurred because the length of the control channel was incorrect (Error code 2).

Out of Range

The total number of general errors that occurred because either one of the values of the field was out of range or the reserved field was non-zero (Error code 3).

Insufficient Resources

The total number of general errors that occurred because resources were not available to process the request (Error code 4).

Invalid SessID

The total number of general errors that occurred because of an invalid session identification (ID) number (Error code 5).

Vendor Specific Errors

The total number of general errors hat occurred because vendor-specific errors occurred in the LAC (Error code 6).

Try Another LNS

The total number of general errors that occurred because the LNS indicated that the LAC service should attempt to establish the control channel with an alternate LNS (Error code 7).

Unknown AVP with M bit

The total number of general errors that occurred because a session or tunnel was disconnected due to the receipt of an unknown AVP with the M-bit set (Error code 8).

Max Tunnel Limit

The total number of sessions that failed to connect because the number of tunnels supported by the LAC service was exceeded. This parameter is configured for the LAC service using the max-tunnels parameter.

IPSEC Failures

When IPSec is used, this is the total number of sessions that were disconnected or that failed to connect due to failures that occurred for the IPSec tunnel.

IPSEC Disconnects

When IPSec is used, this is the total number of disconnects caused by the IPSec tunnel going down.

New Call Policy Disconnects

The total number of disconnects caused by a newcall policy being implemented.

License Exceeded

The total number of subscriber sessions that failed because the total number of subscriber sessions allowed by the installed license key was exceeded.

Service Mismatch

The total number of subscriber sessions that failed due to a mismatch in the service and the call type.

Misc Errors

The total number of errors that occurred that did not fall into any of the above categories.



show l2tp tunnels all

Table 4. show l2tp tunnels all Command Output Descriptions
Field Description

State

The state of the tunnel as one of the following:
  • C : The tunnel is currently connected.
  • c : The tunnel is in the process of being connected.
  • d : The tunnel is in the process of being disconnected.
  • u : The state of the tunnel is unknown.

LocalTun ID

The unique identification number assigned to the tunnel by the system.

PeerTun ID

The unique identification number assigned to the tunnel by the peer LNS.

Active Sess

The number of sessions currently being facilitated by the tunnel.

Peer IPAddress

The IP address of the peer-LNS that the tunnel is established with.

Service Name

The name of the LAC-service that established the tunnel.

Uptime

The uptime for connected tunnel.

Total tunnels matching specified criteria

The total number of tunnels facilitated by the context.



show l2tp tunnels full lac-service

Table 5. show l2tp tunnels full lac-service Command Output Descriptions
Field Description

Local Tunnel ID

The unique identification number assigned to the tunnel by the system.

Peer Tunnel ID

The unique identification number assigned to the tunnel by the peer LNS.

Peer IP Address

The IP address of the peer-LNS that the tunnel is established with.

Service Name

The name of the LAC service that established the tunnel.

Context Name

The context where the LAC service resides.

Uptime

The uptime for connected tunnel.

Service Type

The type of L2TP service. LAC or LNS.

Tunnel State

The state of the tunnel as one of the following:
  • ESTABLISHED : The tunnel is currently connected.
  • IDLE : The initial state of the LAC prior to attempting tunnel establishment.
  • WAIT_CTRL_REPLY : The LAC has sent a tunnel establish request message to the LNS and is waiting for the reply.
  • CLEARING : The tunnel is being cleared.

Peer Host Name

The name of the LNS with which the tunnel is established.

Peer Vendor Name

The name of the peer’s vendor.

Authentication

Indicates the direction of the peer authentication as one of the following:
  • LOCAL TO REMOTE : From the LAC service to the LNS.
  • REMOTE TO LOCAL : From the LNS to the LAC service.

Tunnel Initiation

Indicates the direction of the tunnel initiation as one of the following:
  • LOCAL TO REMOTE : Originated by the LAC service.
  • REMOTE TO LOCAL : Originated by the LNS.

Callid Hint

The call identification number of a session currently being facilitated by the tunnel.

Ctrl Tx Sequence Num

Indicates the current transmit sequence number for control traffic.

Ctrl Rx Sequence Num

Indicates the current receive sequence number for control traffic.

Ctrl Tx Acked by Peer

Indicates the last transmit sequence number for control traffic acknowledged by the LNS.

Ctrl Rx Acked By Local

Indicates the last receive sequence number for control traffic acknowledged by the LAC service.

Init Peer Rx Win Size

The initial size of the LNS’s receive window.

Current Peer Rx Win Size

The current size of the LNS’s receive window.

Init Local Rx Win Size

The initial size of the LAC service’s receive window.

Last Rx Session Result Code

The last session result code generated for received packets.

Last Rx Session Error Code

The last session error code generated for received packets.

Last Rx Session Err Code Msg

The error indicated by the last session error code generated for received packets.

Last Tx Session Result Code

The last session result code generated for transmitted packets.

Last Tx Session Error Code

The last session error code generated for transmitted packets.

Last Tx Session Err Code Msg

The error indicated by the last session error code generated for transmitted packets.

Session Disconnect or Failure Reasons

No General Error:

The total number of normal disconnect with no errors.

Administrative

The total number of sessions that failed to connect due to administrative reasons (CDN result code of 3).

Loss of Carrier

The total number of sessions that were disconnected due to a loss of carrier (CDN result code of 1).

Remote Administrative:

The total number of sessions that failed to connect due to remote administrative reasons.

No Facility Avl Tmp

The total number of sessions that failed to connect due to the temporary lack of required facilities (CDN result code of 4).

No Facility Avl Perm

The total number of sessions that failed to connect due to the permanent lack of required facilities (CDN result code of 5).

Invalid Destination

The total number of sessions that failed to connect due to the specification of an invalid destination (CDN result code of 6).

No Carrier Detected

The total number of sessions that failed to connect because no carrier signal was detected (CDN result code of 7).

Busy Signal

The total number of sessions that failed to connect due to the receipt of a busy signal (CDN result code of 8).

No Dial Tone

The total number of sessions that failed to connect because no dial tone was detected (CDN result code of 9).

LAC Timeout

The total number of sessions that failed to connect within the time allotted by the LAC service (CDN result code of 10).

No Approp Framing

The total number of sessions that failed to connect because no appropriate framing was detected (CDN result code of 11).

No Ctrl Conn

The total number of sessions that failed to connect because no control channel existed (StopCCN result code of 1).

Wrong Length

The total number of general errors that occurred because the length of the control channel was incorrect (Error code 2).

Out of Range

The total number of general errors that occurred because either one of the values of the field was out of range or the reserved field was non-zero (Error code 3).

Insufficient Resources

The total number of general errors that occurred because resources were not available to process the request (Error code 4).

Invalid SessID

The total number of general errors that occurred because of an invalid session identification (ID) number (Error code 5).

Vendor Specific Errors

The total number of general errors hat occurred because vendor-specific errors occurred in the LAC (Error code 6).

Try Another LNS

The total number of general errors that occurred because the LNS indicated that the LAC service should attempt to establish the control channel with an alternate LNS (Error code 7).

Unknown AVP with M bit

The total number of general errors that occurred because a session or tunnel was disconnected due to the receipt of an unknown AVP with the M-bit set (Error code 8).

Misc Reasons

Unspecified reasons.

Rx Data Pkts

The total number of data packets received.

Tx Data Pkts

The total number of data packets transmitted.

Rx Data Octs

The total number of data octets received.

Tx Data Octs

The total number of data octets transmitted.

Rx Discard Data Pkts

The total number of data packets received and discarded.

Rx Control Pkts

The total number of control packets received.

Tx Control Pkts

The total number of control packets transmitted.

Rx Control Octs

The total number of control octets received.

Tx Control Octs

The total number of control octets transmitted.

Rx Control ZLB Pkts

The total number of zero-length body (ZLB) control packets received.

Tx Control ZLB Pkts

The total number of zero-length body (ZLB) control packets transmitted.

Rx HELLO Pkts

The total number of “Hello” packets received.

Tx HELLO Pkts

The total number of “Hello” packets transmitted.

Rx Dup Control Pkts

The total number of duplicate control packets received.

Control ACK Timeouts

The total number local timeouts which happen when we have not responded to the peer LNSs control packet.

Typically, the system starts a timer when it receives a packet from the peer LNS. The system attempts to send the ACK message with a regular control message destined for the LNS. If the timer expires prior to the sending of the ACK message, the system sends a ZLB message which serves as an ACK.

Control Msg Retx Timeouts

The total number of timeouts that occurred after the retransmission timeout period expired when sending control messages.

Sessions Attempted

The total number of attempts made to connect sessions.

Sessions Connected

The total number of sessions successfully connected.

Sessions Failed

The total number of sessions that failed to connect.

Sessions Active

The total number of sessions currently connected.

Intra-PDSN Handoff Sessions

Attempts

The total number of attempts to handoff subscriber sessions to another PDSN within this system.

Success

The total number of successful handoffs of subscriber sessions to another PDSN within this system.

Failures

The total number of failures when attempting to handoff subscriber sessions to another PDSN within this system.

Inter-PDSN Handoff Sessions

Attempts

The total number of attempts were made by outside PDSNs to transfer a call to this PDSN.

Total tunnels matching specified criteria

The total number of tunnels currently facilitated by all LAC-services configured within the current context.