authentication (L2TP)

To enable L2TP authentication for a specified L2TP class name, use the authentication command in L2TP class configuration mode. To return to the default behavior, use the no form of this command.

authentication

noauthentication

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

L2TP class configuration

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Note

You can also enable L2TP authentication for a specified class name from L2TP class configuration submode. To enter this submode, enter the l2tp-class command followed by the class name.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to configure L2TP authentication for the specified L2TP class name “cisco”:

backup disable (L2VPN)

To specify how long a backup pseudowire should wait before resuming operation after the primary pseudowire goes down, use the backup disable command in L2VPN pseudowire class configuration mode. To disable this feature, use the no form of this command.

backupdisable
{ delayvalue | never }

nobackupdisable
{ delayvalue | never }

Syntax Description

delayvalue

Specifies the number of seconds that elapse after the primary pseudowire becomes nonfunctional before the Cisco IOS XR software attempts to activate the secondary pseudowire.

The range, in seconds, is from 0 to 180. The default is 0.

never

Specifies that the secondary pseudowire does not fall back to the primary pseudowire if the primary pseudowire becomes available again, unless the secondary pseudowire fails.

Command Default

The default disable delay is the value of 0, which means that the primary pseudowire is activated immediately when it comes back up.

Command Modes

L2VPN pseudowire class configuration

Command History

Release

Modification

Release 3.8.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how a backup delay is configured for point-to-point pseudowire in which the backup disable delay is set to 50 seconds:

clear l2tp counters control session

To clear L2TP control counters for a session, use the clear l2tp counters control session command in EXEC mode.

clearl2tpcounterscontrolsessionfsm
[ event | statetransition ]

Syntax Description

fsm

(Optional) Clears finite state machine counters.

event

(Optional) Clears state machine event counters.

state

(Optional) Clears state machine state counters.

transition

(Optional) Clears state machine transition counters.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 3.7.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to clear all L2TP state machine transition counters:

clear l2tp counters control tunnel

To clear L2TP control counters for a tunnel, use the clear l2tp counters control tunnel command in EXEC mode.

clearl2tpcounterscontroltunnel
{ all | authentication | idtunnelid }

Syntax Description

all

Clears all L2TP counters, except authentication counters

authentication

Clears tunnel authentication counters.

idtunnel id

Clears a specified counter. Range is 1 to 4294967295.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to clear all L2TP control tunnel counters:

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Related Commands

clear l2vpn collaborators

To clear the state change counters for L2VPN collaborators, use the clear l2vpn collaborators command in EXEC mode.

clearl2vpncollaborators

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 3.4.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to clear change counters for L2VPN collaborators:

Syntax Description

(Optional) Configures the pseudowire ID. The range is from 1 to 4294967295.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Clears the MAC withdrawal statistics over the specified pseudowire. The range is from 1 to 4294967295.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to clear the MAC withdrawal statistics over all the bridges:

clear l2vpn forwarding counters

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 3.4.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Syntax Description

(Optional) Interface type. For more information, use the question mark (?) online help function.

interface-path-id

Physical interface or a virtual interface.

Note

Use the show interfaces command to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.

locationnode-id

Clears L2VPN forwarding message counters for the specified location. The node-id argument is entered in the rack/slot/module notation.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 3.5.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write, execute

Examples

The following example shows how to clear L2VPN forwarding MAC address tables on a specified node:

Syntax Description

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 3.5.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to clear L2VPN forwarding message counters on a specified node:

Related Commands

Displays forwarding information from the layer2_fib manager on the line card.

clear l2vpn forwarding table

To clear an L2VPN forwarding table at a specified location, use the clear l2vpn forwarding table command in EXEC mode.

clearl2vpnforwardingtablelocationnode-id

Syntax Description

locationnode-id

Clears L2VPN forwarding tables for the specified location.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 3.4.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to clear an L2VPN forwarding table from a specified location:

Command Default

hash: Default is MD5 if the digest command is issued without the secret keyword option and L2TPv3 integrity checking is enabled.

Command Modes

L2TP class configuration

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

The digest secret and hash algorithm can be configured in the l2tp-class configuration for authentication of the control channel. For control channel authentication to work correctly, however, both sides of the L2TP control channel connection must share a common secret and hash algorithm.

To update of digest secret without network disruption, Cisco supports a maximum to two digest secrets. You can configure a new secret while keeping the old secret valid. You can safely remove the old secret after you update all affected peer nodes with a new secret,

hello-interval (L2TP)

To configure the hello-interval value for L2TP (duration between control channel hello packets), use the hello interval (L2TP) command in L2TP class configuration mode. To return to the default behavior, use the no form of this command.

hello-intervalinterval

nohello-intervalinterval

Syntax Description

interval

Interval (in seconds) between control channel hello packets. The range is from 0 to 1000. Default is 60 seconds.

Command Default

interval: 60 seconds

Command Modes

L2TP class configuration

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to configure the hello-interval value for L2TP to 22 seconds:

hidden (L2TP)

To enable hidden attribute-value pairs (AVPs), use the hidden command in L2TP class configuration mode. To return to the default behavior, use the no form of this command.

hidden

nohidden

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

L2TP class configuration

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

hostname (L2TP)

To define the name used in the L2TP hostname AVP, use the hostname command in L2TP class configuration mode. To return to the default behavior, use the no form of this command.

hostnamename

nohostnamename

Syntax Description

name

Hostname used to identify the router during L2TP control channel authentication.

Command Default

None

Command Modes

L2TP class configuration

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to configure a hostname using the word “cisco”:

interface (p2p)

To configure an attachment circuit, use the interface command in p2p configuration submode. To return to the default behavior, use the no form of this command.

interfacetypeinterface-path-id

nointerfacetypeinterface-path-id

Syntax Description

type

Interface type. For more information, use the question mark (?) online help function.

interface-path-id

Physical interface or a virtual interface.

Note

Use the show interfaces command to see a list of all possible interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.

Command Default

None

Command Modes

p2p configuration submode

Command History

Release

Modification

Release 3.4.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to configure an attachment circuit on a TenGigE interface:

Related Commands

l2tp-class

To enter L2TP class configuration mode where you can define an L2TP signaling template, use the l2tp-class command in global configuration mode. To delete the L2TP class, use the no form of this command.

l2tp-classl2tp-class-name

nol2tp-classl2tp-class-name

Syntax Description

l2tp-class-name

L2TP class name.

Command Default

No L2TP classes are defined.

Command Modes

Global configuration

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Note

An L2TP class name must be defined before configuring L2TP control plane configuration settings.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to enter L2TP configuration mode to create a template of L2TP control plane configuration settings that can be inherited by different pseudowire classes (in this case, the word “cisco” is used):

l2transport

To configure a physical interface to operate in Layer 2 transport mode, use the l2transport command in interface configuration mode. To return to the default behavior, use the no form of this command.

l2transport

nol2transport

This command has no arguments or keywords.

Command Default

None

Command Modes

Interface configuration

Command History

Release

Modification

Release 3.4.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

The l2transport command and these configuration items are mutually exclusive:

IPv4 address and feature (for example, ACL) configuration

IPv4 enable, address and feature (for example, ACL) configuration

Bundle-enabling configuration

L3 subinterfaces

Layer 3 QoS Policy

Note

After an interface or connection is set to Layer 2 switched, commands such as ipv4 address are not usable. If you configure routing commands on the interface, l2transport is rejected.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to configure an interface or connection as Layer 2 switched under several different modes:

Command Default

None

Command Modes

Interface configuration

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

These L2 protocols are available:

Cisco Discovery Protocol (CDP)—CDP is protocol-independent and is used to obtain protocol addresses, platform information, and other data about neighboring devices.

PVST maintains a spanning tree instance for each VLAN configured in the network and permits a VLAN trunk to be forwarding for some VLANs and not for others. It can also load balance Layer 2 traffic by forwarding some VLANs on one trunk and other VLANs n others.

Spanning-Tree Protocol (STP)—STP is a link management protocol that provides path redundancy in the network. For Ethernet networks to function properly, only one active path can exist between two stations.

VLAN Trunk Protocol (VTP)—VTP is a Cisco-proprietary protocol that reduces administration in a switched network. When you configure a new VLAN on one VTP server, the VLAN is distributed through all switches in the domain.

Task ID

Task ID

Operations

l2vpn

read, write

atm

read, write

Examples

The following example shows how to configure Layer 2 protocol handling:

Related Commands

Displays forwarding information from the layer2_fib manager on the line card.

l2transport propagate

To propagate Layer 2 transport events, use the l2transport propagate command in interface configuration mode. To return to the default behavior, use the no form of this command.

l2transportpropagateremote-status

nol2transportpropagateremote-status

Syntax Description

remote-status

Propagates remote link status changes.

Command Default

None

Command Modes

Interface configuration

Command History

Release

Modification

Release 3.6.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

The l2transport propagate command provides a mechanism for the detection and propagation of remote link failure for port mode EoMPLS.

To display the state of l2transport events, use the show controller internal command in Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router

Note

This command is supported on the following Cisco CRS Router SPA cards:

Related Commands

Displays forwarding information from the layer2_fib manager on the line card.

l2transport service-policy

To configure a Layer 2 transport quality of service (QoS) policy, use the l2transport service-policy command in interface configuration mode. To return to the default behavior, use the no form of this command.

l2transportservice-policy
{ inputpolicy-name | outputpolicy-name }

nol2transportservice-policy
{ inputpolicy-name | outputpolicy-name }

Syntax Description

inputpolicy-name

Configures the direction of service policy application: input.

outputpolicy-name

Configures the direction of service policy application: output.

Command Default

None

Command Modes

Interface configuration

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

atm

read, write

Examples

The following example shows how configure an L2 transport quality of service (QoS) policy:

Related Commands

Displays forwarding information from the layer2_fib manager on the line card.

l2vpn

To enter L2VPN configuration mode, use the l2vpn command in global configuration mode. To return to the default behavior, use the no form of this command.

l2vpn

nol2vpn

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Global configuration

Command History

Release

Modification

Release 3.4.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Related Commands

Displays forwarding information from the layer2_fib manager on the line card.

load-balancing flow-label

To balance the load based on flow-labels, use the
load balancing flow label command in l2vpn pseudowire class mpls configuration mode. To undo flow-label based load-balancing, use the
no form of this command.

load-balancingflow-label
{ both | receive | transmit } [ static ]

noload-balancingflow-label
{ both | receive | transmit } [ static ]

Syntax Description

both

Inserts or discards flow labels on transmit or receive.

receive

Discards flow label on receive.

transmit

Inserts flow label on transmit.

static

Sets flow label parameters statically.

Command Default

None

Command Modes

L2vpn pseudowire class mpls configuration mode

Command History

Release

Modification

Release 4.2.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operation

l2vpn

read, write

Examples

This example shows the output of the load-balancing flow-label command of the both keyword.

Related Commands

logging (l2vpn)

To enable cross-connect logging, use the logging command in L2VPN configuration submode. To return to the default behavior, use the no form of this command.

loggingpseudowirestatus

nologgingpseudowirestatus

Syntax Description

pseudowire status

Enables pseudowire state change logging.

Command Default

None

Command Modes

L2VPN configuration submode

Command History

Release

Modification

Release 3.5.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Related Commands

monitor-session (l2vpn)

To attach a traffic monitoring session as one of the segments for a cross connect, use the monitor-session command in point-to-point cross connect configuration mode. To remove the association between a traffic mirroring session and a cross connect, use the no form of this command.

monitor-sessionsession-name

nomonitor-sessionsession-name

Syntax Description

session-name

Name of the monitor session to configure.

Command Default

No default behavior or values

Command Modes

Point-to-point cross connect configuration

Command History

Release

Modification

Release 4.0.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Before you can attach a traffic mirroring session to a cross connect, you must define it using the monitor-session global configuration command. Once the traffic mirroring session is defined, use the monitor-session point-to-point cross connect configuration command to attach this session as one of the segments for the cross connect. Once attached, all traffic replicated from the monitored interfaces (in other words, interfaces that are associated with the monitor-session) is replicated to the pseudowire that is attached to the other segment of the cross-connect.

The session-name argument should be different than any interface names currently used in the system.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

This example shows how to attach a traffic mirroring session as segment for the xconnect:

Related Commands

mpls static label (L2VPN)

To configure static labels for MPLS L2VPN, use the mpls static label command in L2VPN cross-connect P2P pseudowire configuration mode. To have MPLS assign a label dynamically, use the no form of this command.

mplsstaticlabellocallabelremotevalue

nomplsstaticlabellocallabelremotevalue

Syntax Description

locallabel

Configures a local pseudowire label. Range is 16 to 15999.

remotevalue

Configures a remote pseudowire label. Range is 16 to 15999.

Command Default

The default behavior is a dynamic label assignment.

Command Modes

L2VPN cross-connect P2P pseudowire configuration

Command History

Release

Modification

Release 3.7.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to configure static labels for MPLS L2VPN:

neighbor (L2VPN)

To configure a pseudowire for a cross-connect, use the neighbor command in p2p configuration submode. To return to the default behavior, use the no form of this command.

neighborA.B.C.D pw-idvalue
[ backup | mpls | | pw-class ]

no neighborA.B.C.D pw-idvalue
[ backup | mpls | | pw-class ]

Syntax Description

A.B.C.D

IP address of the cross-connect peer.

pw-idvalue

Configures the pseudowire ID and ID value. Range is 1 to 4294967295.

Command Default

None

Command Modes

p2p configuration submode

Command History

Release

Modification

Release 3.4.0

This command was introduced.

Release 3.4.1

The vccv disable keyword was added.

Release 3.7.0

The following keywords were removed:

control-word

pw-static-label local

remote

vccv

transport-mode

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

A cross-connect may have two segments:

An Attachment Circuit (AC)

An second AC or a pseudowire

Note

The pseudowire is identified by two keys: neighbor and pseudowire ID. There may be multiple pseudowires going to the same neighbor. It is not possible to configure a neighbor only.

password (L2TP)

To define the password and password encryption type for control channel authentication, use the password command in L2TP class configuration mode. To return to the default behavior, use the no form of this command.

password
[ 0 | 7 ]
password

nopassword

Syntax Description

0

(Optional) Specifies that an unencrypted password will follow.

7

(Optional) Specifies that an encrypted password will follow.

password

Unencrypted or clear text user password.

Command Default

None

Command Modes

Global configuration

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to define an unencrypted password using the word “cisco” for control channel authentication:

pw-class (L2VPN)

To enter pseudowire class submode to define a pseudowire class template, use the pw-class command in L2VPN configuration submode. To delete the pseudowire class, use the no form of this command.

pw-classclass-name

nopw-classclass-name

Syntax Description

class-name

Pseudowire class name.

Command Default

None

Command Modes

L2VPN configuration submode

Command History

Release

Modification

Release 3.5.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Note

All L2VPN configurations can be deleted using the no l2vpn command.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to define a simple pseudowire class template:

Related Commands

pw-class encapsulation l2tpv3

To configure L2TPv3 pseudowire encapsulation, use the pw-class encapsulation l2tpv3 command in L2VPN pseudowire class configuration mode. To return to the default behavior, use the no form of this command.

(Optional) Configures L2TPv3 as the signaling protocol for the pseudowire class.

tos {reflect value0-255 | value0-255}

(Optional) Configures TOS and the TOS value. Range is 0 to 255.

ttlvalue

Configures the Time-to-live (TTL) value. Range is 1 to 255.

Command Default

None

Command Modes

L2VPN pseudowire class configuration

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Note

All L2VPN configurations can be deleted using the no l2vpn command.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to define L2TPV3 pseudowire encapsulation:

Command Default

Command Modes

Command History

The keywords control word disable and vccv none were replaced by the keywords control word and vccv verification-type none.

Release 3.9.0

The following keywords were added:

preferred-path

sequencing

tag-rewrite

transport-mode

Release 4.3.0

The keyword load-balancing flow-label was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Related Commands

p2p

To enter p2p configuration submode to configure point-to-point cross-connects, use the p2p command in L2VPN xconnect mode. To return to the default behavior, use the no form of this command.

p2pxconnect-name

nop2pxconnect-name

Syntax Description

xconnect-name

(Optional) Configures the name of the point-to-point cross- connect.

Command Default

None

Command Modes

L2VPN xconnect

Command History

Release

Modification

Release 3.4.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

The name of the point-to-point cross-connect string is a free format description string.

Related Commands

receive-window (L2TP)

To configure the receive window size for the L2TP server, use the receive-window command in L2TP class configuration mode. To return to the default behavior, use the no form of this command.

receive-windowsize

noreceive-windowsize

Syntax Description

size

Maximum number of packets that are received from a peer before back-off is applied. Default is 512.

Command Default

size: 512

Command Modes

L2TP class configuration

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to configure the receive window size for the L2TP server to 10 packets:

Syntax Description

Configures the number of SCCRQ messages resent before giving up on a particular control channel. Range is 1 to 1000. Default is 2.

retriesretries

Configures the maximum number of retransmissions before determining that peer router does not respond. Range is 5 to 1000. Default is 15.

timeout {max | min} timeout

Configures the maximum and minimum retransmission interval in seconds for control packets. Range is 1 to 8. Maximum timeout default is 8 seconds. Minimum timeout default is 1 second.

Command Default

initial retries: 2

retries: 15

min timeout: 1

max timeout:8

Command Modes

L2TP class configuration

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to configure a retransmit retry value to 1:

rollover (L3VPN)

To configure rollover times for a tunnel-template, use the rollover command in tunnel encapsulation l2tp configuration mode. To return to the default behavior, use the no form of this command.

rolloverperiodictimeholdowntime

norolloverperiodictimeholdowntime

Syntax Description

periodictime

Configures the periodic rollover time in seconds. Range is 60 to 31536000.

holddowntime

Configures the holddown time for old session cookie values.

Command Default

None

Command Modes

tunnel encapsulation l2tp configuration

Command History

Release

Modification

Release 3.5.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

The name of the point-to-point cross-connect string is a free format description string.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to configure rollover times for a tunnel-template:

Related Commands

show l2tp class

To display information about an L2TP class, use the show l2tp class command in EXEC mode.

showl2tpclassnamename

Syntax Description

namename

Configures an L2TP class name.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows sample output for the show l2vtp session class command:

Syntax Description

(Optional) Configures the local and remote names for a session counter.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows sample output for the show l2tp counters forwarding session command:

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following sample output is from the show l2vtp session brief command:

Syntax Description

Displays transport information (IP) for each selected control channel.

id identifier

Displays local control channel identifiers.

namelocal-name remote-name

Displays the local and remote names of a control channel.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Related Commands

show l2vpn collaborators

To display information about the state of the interprocess communications connections between l2vpn_mgr and other processes, use the show l2vpn collaborators command in EXEC mode.

showl2vpncollaborators

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 3.4.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows sample output for the show l2vpn collaborators command:

Displays layer2_fib manager information for the specified location. The node-id argument is entered in the rack/slot/module notation.

message

Displays messages exchanged with collaborators.

mstp

Displays multi-spanning tree related forwarding information.

resource

Displays resource availability information in the layer2_fib manager.

retry-list

Displays retry list related information.

summary

Displays summary information about cross-connects in the layer2_fib manager.

unresolved

Displays unresolved entries only.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 3.4.0

This command was introduced.

Release 3.7.0

Sample output was updated to add MAC information for the layer2_fib manager summary.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read

Examples

The following sample output is from the show l2vpn forwarding bridge detail location command:

The following sample output shows the MAC information in the layer2_fib manager summary:

RP/0/RP0/CPU0:router# show l2vpn forwarding summary location 0/3/CPU0
Major version num:1, minor version num:0
Shared memory timestamp:0x66ff58e894
Number of forwarding xconnect entries:2
Up:1 Down:0
AC-PW:0 AC-AC:0 AC-BP:1 PW-BP:1
Number of xconnects down due to:
AIB:0 L2VPN:0 L3FIB:0
Number of nexthops:1
Number of static macs: 5
Number of locally learned macs: 5
Number of remotely learned macs: 0
Number of total macs: 10

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read

Examples

The following example shows sample output for the show l2vpn forwarding l2tp command:

Syntax Description

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 3.5.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read

Examples

The following example shows sample output for the show l2vpn pw-class command:

Related Commands

show l2vpn resource

To display the memory state in the L2VPN process, use the show l2vpn resource command in EXEC mode.

showl2vpnresource

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 3.4.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read

Examples

The following example shows sample output for the show l2vpn resource command:

Command History

Sample output was updated to display the backup pseudowire information.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

If a specific cross-connect is specified in the command (for instance, AC_to_PW1) then only that cross-connect will be displayed; otherwise, all cross-connects are displayed.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows sample output for the show l2vpn xconnect command:

Related Commands

tag-rewrite

To configure VLAN tag rewrite, use the tag-rewrite command in Encapsulation MPLS configuration mode. To disable VLAN tag rewrite, use the no form of this command.

tag-rewriteingressvlanvlan-id

notag-rewriteingressvlanvlan-id

Syntax Description

ingress

Configures ingress mode.

vlan

Configures VLAN tagged mode

vlan-id

Specifies the value of the ID of the VLAN.

Command Default

None

Command Modes

Encapsulation MPLS configuration

Command History

Release

Modification

Release 3.6.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

The tag-rewrite command is applicable only to pseudowires with MPLS encapsulation.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to configure preferred-path tunnel settings:

Related Commands

timeout setup (L2TP)

To configure timeout definitions for L2TP session setup, use the timeout setup command in L2TP class configuration mode. To return to the default behavior, use the no form of this command.

timeoutsetupseconds

notimeoutsetupseconds

Syntax Description

seconds

Time, in seconds, to setup a control channel. Range is 60 to 6000 seconds. Default is 300 seconds.

Command Default

seconds: 300

Command Modes

L2TP class configuration

Command History

Release

Modification

Release 3.9.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to configure a timeout value for L2TP session setup of 400 seconds:

transport mode (L2VPN)

To configure L2VPN pseudowire class transport mode, use the transport mode command in L2VPN pseudowire class MPLS encapsulation mode. To return to the default behavior, use the no form of this command.

transportmode
{ ethernet | vlan
}

notransportmode
{ ethernet | vlan
}

Syntax Description

ethernet

Configures Ethernet port mode.

vlan

Configures VLAN tagged mode.

Command Default

None

Command Modes

L2VPN pseudowire class MPLS encapsulation

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Related Commands

tunnel-template

To enter tunnel-template configuration submode, use the tunnel-template command in global configuration mode.

tunnel-templatetemplatename

notunnel-templatetemplate-name

Syntax Description

template-name

Configures a name for the tunnel template.

Command Default

None

Command Modes

Global configuration

Command History

Release

Modification

Release 3.5.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

tunnel

read, write

Examples

The following example shows how to enter tunnel-template configuration submode:

Related Commands

xconnect group

To configure cross-connect groups, use the xconnect group command in L2VPN configuration mode. To return to the default behavior, use the no form of this command.

xconnectgroupgroup-name

noxconnectgroupgroup-name

Syntax Description

group-name

Configures a cross-connect group name using a free-format 32-character string.

Command Default

None

Command Modes

L2VPN configuration

Command History

Release

Modification

Release 3.4.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Note

You can configure up to a maximum of 16K cross-connects per box.

Task ID

Task ID

Operations

l2vpn

read, write

Examples

The following example shows how to group all cross -connects for customer_atlantic: