Virtual Private Network Commands on Cisco IOS XR Software
Available Languages
Table Of Contents
Virtual Private Network Commands on Cisco IOS XR Software
clear l2tp counters control session
clear l2tp counters control tunnel
clear l2vpn counters bridge mac-withdrawal
clear l2vpn forwarding counters
clear l2vpn forwarding mac-address-table
clear l2vpn forwarding message counters
show l2tp counters forwarding session
Virtual Private Network Commands on Cisco IOS XR Software
This chapter describes the commands used to configure, monitor, and troubleshoot a Layer 2 or Layer 3 virtual private network (VPN).
For detailed information about MPLS concepts, configuration tasks, and examples, refer to the
Cisco IOS XR MPLS Configuration Guide.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
no authentication
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
L2TP class configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
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
Examples
The following example shows how to configure L2TP authentication for the specified L2TP class name "cisco":
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2tp-class ciscoRP/0/0/CPU0:router(config-l2tp-class)# authenticationRelated Commands
clear l2tp counters control session
To clear L2TP control counters for a session, use the clear l2tp counters control session command in EXEC mode.
clear l2tp counters control session {fsm} [event | state transition]
Syntax Description
fsm
Clears finite state machine counters.
event
Clears state machine event counters.
state
Clears state machine state counters.
transition
Clears state machine transition counters.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to clear all L2TP state machine transition counters:
RP/0/0/CPU0:router# clear l2tp counters control session fsm state transitionRelated Commands
Clears L2TP control tunnel counters.
Clears L2TP tunnels.
Shows L2TP forward session 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.
clear l2tp counters control tunnel {all | authentication | id tunnel id}
Syntax Description
all
Clears all L2TP counters, except authentication counters
authentication
Clears tunnel authentication counters.
id tunnel id
Clears a specified counter. Range is 1 to 4294967295.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to clear all L2TP control tunnel counters:
RP/0/0/CPU0:router# clear l2tp counters control tunnel allRelated Commands
Clears L2TP control session counters.
Clears L2TP tunnels.
Shows L2TP forward session counters.
clear l2tp tunnel
To clear L2TP tunnels, use the clear l2tp tunnel command in EXEC mode.
clear l2tp tunnel {all | id tunnel id | l2tp-class class name | local ipv4 ipv4 address |
remote ipv4 ipv4 address]Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to clear all L2TP tunnels:
RP/0/0/CPU0:router# clear l2tp tunnel allRelated Commands
Clears L2TP session counters.
Clears L2TP tunnel counters.
Displays information about L2TP sessions.
clear l2vpn collaborators
To clear the state change counters for L2VPN collaborators, use the clear l2vpn collaborators command in EXEC mode.
clear l2vpn collaborators
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to clear change counters for L2VPN collaborators:
RP/0/RP0/CPU0:router# clear l2vpn collaboratorsRelated Commands
clear l2vpn counters l2tp
To clear L2VPN statistical information, such as, packets dropped, use the clear l2vpn counters l2tp command in EXEC mode.
clear l2vpn counters l2tp [neighbor ip-address [pw-id value]]
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to clear all L2TP counters:
RP/0/RP0/CPU0:router# clear l2vpn counters l2tpRelated Commands
clear l2vpn counters bridge mac-withdrawal
To clear the MAC withdrawal statistics for the counters of the bridge domain, use the clear l2vpn counters bridge mac-withdrawal command in EXEC mode.
clear l2vpn counters bridge mac-withdrawal {all | group group name {bd-name bd-name} | neighbor ip-address {pw-id value}}
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to clear the MAC withdrawal statistics over all the bridges:
RP/0/0/CPU0:router# clear l2vpn counters bridge mac-withdrawal allclear l2vpn forwarding counters
To clear L2VPN forwarding counters, use the clear l2vpn forwarding counters command in EXEC mode.
clear l2vpn forwarding counters
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to clear L2VPN forwarding counters:
RP/0/RP0/CPU0:router# clear l2vpn forwarding countersRelated Commands
Displays the state of the interprocess communications connections between l2vpn_mgr and other processes.
clear l2vpn forwarding mac-address-table
To clear L2VPN forwarding MAC address tables, use the clear l2vpn forwarding mac-address-table command in EXEC mode.
clear l2vpn forwarding mac-address-table {address address | bridge-domain name | interface type interface-id | location node-id}
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to clear L2VPN forwarding MAC address tables on a specified node:
RP/0/RP0/CPU0:router# clear l2vpn forwarding mac-address location 1/1/1Related Commands
Displays the state of the interprocess communications connections between l2vpn_mgr and other processes.
clear l2vpn forwarding message counters
To clear L2VPN forwarding message counters, use the clear l2vpn forwarding message counters command in EXEC mode.
clear l2vpn forwarding message counters {location node-id}
Syntax Description
location node-id
Clears L2VPN forwarding message counters for the specified location. The node-id argument is entered in the rack/slot/module notation.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to clear L2VPN forwarding message counters:
RP/0/RP0/CPU0:router# clear l2vpn forwarding message counters location 0/1/0Related Commands
Displays the state of the interprocess communications connections between l2vpn_mgr and other processes.
clear l2vpn forwarding table
To clear an L2VPN forwarding table at a specified location, use the clear l2vpn forwarding table command in EXEC mode.
clear l2vpn forwarding table {location node-id}
Syntax Description
location node-id
Clears L2VPN forwarding tables for the specified location. The L2TP class name argument is entered using standard rack/slot/module notation.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to clear an L2VPN forwarding table from a specified location:
RP/0/RP0/CPU0:router# clear l2vpn forwarding table location 1/2/3/5Related Commands
Displays the state of the interprocess communications connections between l2vpn_mgr and other processes.
digest (L2TP)
To configure digest options. use the digest command in L2TP class configuration mode. To return to the default behavior, use the no form of this command.
digest {check disable | hash {MD5 | SHA1} | secret {0 | 7 | word}}
no digest {check disable | hash {MD5 | SHA1} | secret {0 | 7 | word}}
Syntax Description
check disable
Disables digest checking.
hash {MD5 | SHA1}
Configures the digest hash method (MD5 or SHA1). Default is MD5.
secret {0 | 7 | word}
Configures a shared secret for message digest.
Defaults
check disable: Digest checking is enabled by 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
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
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,
Task ID
Examples
The following example shows how to configure digest options for L2TP:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2tp-class ciscoRP/0/0/CPU0:router(config-l2tp-class)# digest checkRP/0/0/CPU0:router(config-l2tp-class)# digest secret cisco hash md5Related Commands
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-interval interval
no hello-interval interval
Syntax Description
interval
Interval (in seconds) between control channel hello packets. The range is from 0 to 1000. Default is 60 seconds.
Defaults
interval: 60 seconds
Command Modes
L2TP class configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to configure the hello-interval value for L2TP to 22 seconds:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2tp-class ciscoRP/0/0/CPU0:router(config-l2tp-class)# hello-interval 22Related Commands
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
no hidden
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
L2TP class configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to enable hidden AVPs:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2tp-class ciscoRP/0/0/CPU0:router(config-l2tp-class)# hiddenRelated Commands
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.
hostname {name}
no hostname {name}
Syntax Description
Defaults
No default behavior or values
Command Modes
L2TP class configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to configure a hostname using the word "cisco":
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2tp-class ciscoRP/0/0/CPU0:router(config-l2tp-class)# hostname ciscoRelated Commands
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.
interface interface name
no interface interface name
Syntax Description
interface name
Configures the name of the interface or attachment circuit in rack/slot/instance/port format.
Defaults
No default behavior or values
Command Modes
p2p configuration submode
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to configure an attachment circuit on a TenGigE interface:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# l2vpnRP/0/RP0/CPU0:router(config-l2vpn)# xconnect group gr1RP/0/RP0/CPU0:router(config-l2vpn-xc)# p2p p001RP/0/RP0/CPU0:router(config-l2vpn-xc-p2p)# interface TenGigE 1/1/1/1Related Commands
l2tp-class
To enter L2TP class configuration mode where you can define an L2TP signalling template, use the l2tp-class command in global configuration mode. To delete the L2TP class, use the no form of this command.
l2tp-class l2tp-class name
no l2tp-class l2tp-class name
Syntax Description
Defaults
No L2TP classes are defined.
Command Modes
Global configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the l2tp-class command to enter L2TP class configuration mode.
Note
Task ID
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):
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2tp-class ciscoRP/0/0/CPU0:router(config-l2tp-class)#Related Commands
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
no l2transport
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Interface configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The l2transport keyword and the following configuration items are mutually exclusive:
•
•
•
•
•
Note
Task ID
Examples
The following example shows how to configure an interface or connection as Layer 2 switched under several different modes:
Ethernet Port Mode:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# interface GigabitEthernet 0/0/0/0RP/0/RP0/CPU0:router(config-if)# l2transportEthernet VLAN Mode:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# interface GigabitEthernet 0/0/0/0.900 l2transportRP/0/RP0/CPU0:router(config-if)# do1q vlan 999Ethernet VLAN Mode (QinQ):
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# interface GigabitEthernet 0/0/0/0.900 l2transport RP/0/RP0/CPU0:router(config-if)# do1q vlan 999 inner-vlan 888Ethernet VLAN Mode (QinAny):
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# interface GigabitEthernet 0/0/0/0.900 l2transportRP/0/RP0/CPU0:router(config-if)# do1q vlan 999 vlan anyRelated Commands
Displays the state of the interprocess communications connections between l2vpn_mgr and other processes.
l2transport cell-packing
To configure L2VPN cell packing parameters, use the l2transport cell-packing command in interface configuration mode. To return to the default behavior, use the no form of this command.
l2transport cell-packing {maximum} {timer}
no l2transport cell-packing {maximum} {timer}
Syntax Description
maximum
Maximum number of cells to be packed in a packet. Range is 2 to 86.
timer
Cell packing timer (1, 2, or 3).
Defaults
No default behavior or values
Command Modes
Interface configuration
Command History
Release 3.5.0
This command was introduced on the Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to configure L2VPN cell packing parameters:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# interface GigabitEthernet 0/0/0/0RP/0/0/CPU0:router(config-if)# l2transport cell-packing 33 2Related Commands
Displays the state of the interprocess communications connections between l2vpn_mgr and other processes.
l2transport l2protocol
To configure Layer 2 protocol handling, use the l2transport l2protocol command in interface configuration mode. To return to the default behavior, use the no form of this command.
l2transport l2protocol {cdp | pvst | stp | vtp} {drop | experimental bits | tunnel experimental bits}
no l2transport l2protocol {cdp | pvst | stp | vtp} {drop | experimental bits | tunnel experimental bits}
Syntax Description
Defaults
No default behavior or values
Command Modes
Interface configuration
Command History
Release 3.5.0
This command was introduced on the Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The following L2 protocols are available:
•
–
•
–
•
–
•
–
Task ID
Examples
The following example shows how to configure Layer 2 protocol handling:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# interface GigabitEthernet 0/0/0/0RP/0/0/CPU0:router(config-if)# l2transport l2protocol stp dropRelated Commands
Displays the state of the interprocess communications connections between l2vpn_mgr and other processes.
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.
l2transport propagate {remote-status}
no l2transport propagate {remote-status}
Syntax Description
Defaults
No default behavior or values
Command Modes
Interface configuration
Command History
Release 3.6.0
This command was introduced on the Cisco CRS-1 router.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
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 Interfaces and Hardware Command Reference.
Note
For more information about the Ethernet remote port shutdown feature, see Cisco IOS XR MPLS Configuration Guide.
Task ID
Examples
The following example shows how to propagate remote link status changes:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# interface GigabitEthernet 0/0/0/0RP/0/RP0/CPU0:router(config-if)# l2transport propagate remote statusRelated Commands
show controller internal
Displays show output for internal interfaces.
Displays the state of the interprocess communications connections between l2vpn_mgr and other processes.
l2transport service-policy
To configure an L2 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.
l2transport service-policy {input policy-name | output policy-name}
no l2transport service-policy {input policy-name | output policy-name}
Syntax Description
input policy-name
Configures the direction of service policy application: input.
output policy-name
Configures the direction of service policy application: output.
Defaults
No default behavior or values
Command Modes
Interface configuration
Command History
Release 3.5.0
This command was introduced on the Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how configure an L2 transport quality of service (QoS) policy:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# interface GigabitEthernet 0/0/0/0RP/0/0/CPU0:router(config-if)# l2transport service-policy input sp_0001Related Commands
Displays the state of the interprocess communications connections between l2vpn_mgr and other processes.
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
no l2vpn
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Global configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Note
Task ID
Examples
The following example shows how to enter l2vpn configuration mode:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# l2vpnRelated Commands
Displays the state of the interprocess communications connections between l2vpn_mgr and other processes.
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.
logging {pseudowire status}
no logging {pseudowire status}
Syntax Description
Defaults
No default behavior or values
Command Modes
L2VPN configuration submode
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Note
Task ID
Examples
The following example shows how to enable cross-connect logging:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# l2vpnRP/0/RP0/CPU0:router(config-l2vpn)# logging pseudowire statusRelated 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.
mpls static label {local label} {remote value}
no mpls static label {local label} {remote value}
Syntax Description
local label
Configures a local pseudowire label. Range is 16 to 15999.
remote value
Configures a remote pseudowire label. Range is 16 to 15999.
Defaults
The default behavior is a dynamic label assignment.
Command Modes
L2VPN cross-connect P2P pseudowire configuration
Command History
Release 3.7.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to configure static labels for MPLS L2VPN:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# l2vpn xconnect group l2vpnRP/0/RP0/CPU0:router(config-l2vpn-xc)# p2p rtrA_to_rtrBRP/0/RP0/CPU0:router(config-xc-p2p)# neighbor 10.1.1.2 pw-id 1000RP/0/RP0/CPU0:router(config-l2vpn-xc-p2p-pw)# mpls static label local 800 remote 500Related Commands
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.
neighbor {A.B.C.D} {pw-id value}
no neighbor {A.B.C.D} {pw-id value}
Syntax Description
A.B.C.D
IP address of the cross-connect peer.
pw-id value
Configures the pseudowire ID and ID value. Range is 1 to 4294967295.
Defaults
No default behavior or values
Command Modes
p2p configuration submode
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
A cross-connect may have two segments:
1.
2.
Note
All L2VPN configurations can be deleted using the no l2vpn command.
Task ID
Examples
The following example shows a point-to-point cross-connect configuration (including pseudowire configuration):
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# l2vpn xconnect group l2vpnRP/0/RP0/CPU0:router(config-l2vpn-xc)# p2p rtrA_to_rtrBRP/0/RP0/CPU0:router(config-xc-p2p)# neighbor 10.1.1.2 pw-id 1000 pw-class fooRP/0/RP0/CPU0:router(config-xc-p2p)# neighbor 10.1.1.3 pw-id 1001 pw-class fooRP/0/RP0/CPU0:router(config-xc)# p2p rtrC_to_rtrDRP/0/RP0/CPU0:router(config-xc-p2p)# neighbor 20.2.2.3 pw-id 200 pw-class bar1RP/0/RP0/CPU0:router(config-xc-p2p)# neighbor 20.2.2.4 pw-id 201 pw-class bar2Related Commands
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
no password
Syntax Description
0
(Optional) Specifies that an unencrypted password will follow.
7
(Optional) Specifies that an encrypted password will follow.
password
Configures an unencrypted or clear text user password.
Defaults
No default behavior or values
Command Modes
Global configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to define an unencrypted password using the word "cisco" for control channel authentication:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2tp-class sanjoseRP/0/0/CPU0:router(config-l2tp-class)# password 0 ciscoRelated Commands
preferred-path
To configure an MPLS TE tunnel to be used for L2VPN traffic, use the preferred-path command in Encapsulation MPLS configuration mode. To delete the preferred-path, use the no form of this command.
preferred-path {interface} {tunnel-te value} [fallback disable]
no preferred-path {interface} {tunnel-te value} [fallback disable]
Syntax Description
Defaults
No default behavior or values
Command Modes
Encapsulation MPLS configuration
Command History
Release 3.6.0
This command was introduced on the Cisco CRS-1.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The preferred-path command is applicable only to pseudowires with MPLS encapsulation.
Cisco IOS XR Software Release 3.7 supports only fallback disable. Traffic does not use the default LDP path if the tunnel is down.
Use the show l2vpn xconnect detail command to show the status of fallback (that is, enabled or disabled).
Note
Task ID
Examples
The following example shows how to configure preferred-path tunnel settings:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# l2vpnRP/0/RP0/CPU0:router(config-l2vpn)# pw-class kanata01RP/0/RP0/CPU0:router(config-l2vpn-pwc)# encapsulation mplsRP/0/RP0/CPU0:router(config-l2vpn-pwc-encap-mpls)# preferred-path interface tunnel 6666 fallback disableRelated Commands
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-class {class name}
no pw-class {class name}
Syntax Description
Defaults
No default behavior or values
Command Modes
L2VPN configuration submode
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Note
Task ID
Examples
The following example shows how to define a simple pseudowire class template:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# l2vpnRP/0/RP0/CPU0:router(config-l2vpn)# xconnect group l1vpnRP/0/RP0/CPU0:router(config-l2vpn-xc)# p2p rtrA_to_rtrBRP/0/RP0/CPU0:router(config-l2vpn-xc-p2p)# neighbor 10.1.1.2 pw-id 1000RP/0/RP0/CPU0:router(config-l2vpn-xc-p2p-pw)# pw-class kanata01Related 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.
pw-class {class name} encapsulation l2tpv3 [cookie size {0 | 4 | 8} | ipv4 source address | pmtu max 68-65535 | protocol l2tpv3 class name | tos {reflect value 0-255 | value 0-255} | {ttl value}]
no pw-class {class name} encapsulation l2tpv3 [cookie size {0 | 4 | 8} | ipv4 source address | pmtu max 68-65535 | protocol l2tpv3 class name | tos {reflect value 0-255 | value 0-255} | {ttl value}]
Syntax Description
Defaults
No default behavior or values
Command Modes
L2VPN pseudowire class configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Note
Task ID
Examples
The following example shows how to define L2TPV3 pseudowire encapsulation:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2vpnRP/0/0/CPU0:router(config-l2vpn)# pw-class kanata01RP/0/0/CPU0:router(config-l2vpn-pwc)# encapsulation l2tpv3Related Commands
Enters pw-class configuration submode.
Configures MPLS pseudowire encapsulation.
pw-class encapsulation mpls
To configure MPLS pseudowire encapsulation, use the pw-class encapsulation mpls command in L2VPN pseudowire class configuration mode. To return to the default behavior, use the no form of this command.
pw-class {class name} encapsulation mpls {control word disable | protocol ldp | vccv none}
no pw-class {class name} encapsulation mpls {control word disable | protocol ldp | vccv none}
Syntax Description
Defaults
No default behavior or values
Command Modes
L2VPN pseudowire class configuration
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Note
Task ID
Examples
The following example shows how to define MPLS pseudowire encapsulation:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# l2vpnRP/0/RP0/CPU0:router(config-l2vpn)# pw-class kanata01RP/0/RP0/CPU0:router(config-l2vpn-pwc)# encapsulation mplsRelated Commands
Enters pseudowire class submode to define a pseudowire class template.
Configures L2TPv3 pseudowire encapsulation.
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.
p2p {xconnect-name}
no p2p
Syntax Description
Defaults
No default behavior or values
Command Modes
l2vpn xconnect
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The name of the point-to-point cross-connect string is a free format description string.
Task ID
Examples
The following example shows a point-to-point cross-connect configuration (including pseudowire configuration):
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# l2vpnRP/0/RP0/CPU0:router(config-l2vpn)# xconnect group group 1RP/0/RP0/CPU0:router(config-l2vpn-xc)# p2p xc1Related 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-window {size}
no receive-window {size}
Syntax Description
size
Maximum number of packets that are received from a peer before back-off is applied. Default is 512.
Defaults
size: 512
Command Modes
L2TP class configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to configure the receive window size for the L2TP server to 10 packets:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2tp-class ciscoRP/0/0/CPU0:router(config-l2tp-class)# receive-window 10Related Commands
retransmit (L2TP)
To configure retransmit retry and timeout values, use the retransmit command in L2TP class configuration mode. To return to the default behavior, use the no form of this command.
retransmit {initial initial-retries | retries retries | timeout {max | min} timeout}
no retransmit {initial initial-retries | retries retries | timeout {max | min} timeout}
Syntax Description
Defaults
initial retries: 2
retries: 15
min timeout: 1
max timeout: 8
Command Modes
L2TP class configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to configure a retransmit retry value to 1:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2tp-class ciscoRP/0/0/CPU0:router(config-l2tp-class)# retransmit initial retries 1Related Commands
rollover
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.
rollover {periodic time} {holdown time}
no rollover {periodic time} {holdown time}
Syntax Description
periodic time
Configures the periodic rollover time in seconds. Range is 60 to 31536000.
holddown time
Configures the holddown time for old session cookie values.
Defaults
No default behavior or values
Command Modes
tunnel encapsulation l2tp configuration
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The name of the point-to-point cross-connect string is a free format description string.
Task ID
Examples
The following example shows how to configure rollover times for a tunnel-template:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# tunnel-template kanata_9RP/0/RP0/CPU0:router(config-tuntem) encapsulation l2tpRP/0/RP0/CPU0:router(config-tunencap-l2tp)# rolloverRelated Commands
sequencing (L2VPN)
To configure L2VPN pseudowire class sequencing, use the pw-class sequencing command in L2VPN pseudowire class encapsulation mode. To return to the default behavior, use the no form of this command.
sequencing {both | receive | transmit {resynch 5-65535}}
no sequencing {both | receive | transmit {resynch 5-65535}}
Syntax Description
Defaults
No default behavior or values
Command Modes
L2VPN pseudowire class encapsulation mode
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Do not configure sequence resync on high speed circuits. On low speed circuits, do not configure a threshold lower than 10 to 20 seconds of traffic.
Note
Task ID
Examples
The following example shows how to configure L2VPN pseudowire class sequencing:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# l2vpnRP/0/RP0/CPU0:router(config-l2vpn)# pw-class kanata01RP/0/RP0/CPU0:router(config-l2vpn-pw)# encapsulation mplsRP/0/RP0/CPU0:router(config-l2vpn-encap-mpls)# sequencing bothRelated Commands
show l2tp class
To display information about an L2TP class, use the show l2tp class command in EXEC mode.
show l2tp class name name
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows sample output for the show l2vtp session class command:
RP/0/0/CPU0:router# show l2tp class name kanata_02l2tp-class kanata_02manually configured classconfiguration parameters:(not) hidden(no) authentication(no) digestdigest check enablehello 60(no) hostname(no) password(no) accounting(no) security crypto-profile(no) ip vrfreceive-window 888retransmit retries 15retransmit timeout max 8retransmit timeout min 1retransmit initial retries 2retransmit initial timeout max 8retransmit initial timeout min 1timeout setup 300Table 86 describes the significant fields shown in the display.
Related Commands
show l2tp counters forwarding session
To show L2TP forward session counters, use the show l2tp counter forwarding session command in EXEC mode.
show l2tp counters forwarding session [id identifier | name local-name remote-name]
Syntax Description
id identifier
Configures the session counter identifier.
name local-name remote name
Configures the local and remote names for a session counter.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows sample output for the show l2tp counters forwarding session command:
RP/0/0/CPU0:router# show l2tp counters forwarding sessionLocID RemID TunID Pkts-In Pkts-Out Bytes-In Bytes-Out22112 15584 14332 0 0 0 0Table 87 describes the significant fields shown in the display.
Related Commands
show l2tp session
To display information about L2TP sessions, use the show l2tp session command in EXEC mode.
show l2tp session [detail | brief | interworking | circuit | sequence | state] {id id | name name}
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following sample output is from the show l2vtp session brief command:
RP/0/0/CPU0:router# show l2tp session briefL2TP Session Information Total tunnels 1 sessions 6LocID TunID Peer-address State Vcidsess/cir26093 43554 13.0.0.2 est,UP 6026094 43554 13.0.0.2 est,UP 4026095 43554 13.0.0.2 est,UP 5026096 43554 13.0.0.2 est,UP 7026097 43554 13.0.0.2 est,UP 2026098 43554 13.0.0.2 est,UP 30Table 88 describes the significant fields shown in the display.
Related Commands
show l2tp tunnel
To display information about L2TP tunnels, use the show l2tp tunnel command in EXEC mode.
show l2tp tunnel {detail | brief | state | transport} {id identifier | name local-name remote-name}
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following sample output is from the show l2tp tunnel command:
RP/0/0/CPU0:router# show l2tp tunnelL2TP Tunnel Information Total tunnels 1 sessions 6LocID RemID Remote Name State Remote Address Port Sessions L2TPClass43554 6220 PE2 est 13.0.0.2 0 6 fooTable 89 describes the significant fields shown in the display.
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.
show l2vpn collaborators
Syntax Description
This command has no arguments or keywords
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows sample output for the show l2vpn collaborators command:
RP/0/RP0/CPU0:router# show l2vpn collaboratorsL2VPN Collaborator stats:Name State Up Cnts Down Cnts-------------------- ---------- ----------- -----------IMC Down 0 0LSD Up 1 0Table 90 describes the significant fields shown in the display.
Related Commands
show l2vpn forwarding
To display forwarding information from the layer2_fib manager on the line card, use the show l2vpn forwarding command in EXEC mode.
show l2vpn forwarding {detail | hardware | interface | location | message | resource | summary | unresolved} location node-id
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following sample output is from the show l2vpn forwarding command:
RP/0/RP0/CPU0:router# show l2vpn forwarding location 0/2/cpu0ID Segment 1 Segment 2-----------------------------------1 Gi0/2/0/0 1 1.1.1.1 9)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/CPU0Major version num:1, minor version num:0Shared memory timestamp:0x66ff58e894Number of forwarding xconnect entries:2Up:1 Down:0AC-PW:0 AC-AC:0 AC-BP:1 PW-BP:1Number of xconnects down due to:AIB:0 L2VPN:0 L3FIB:0Number of nexthops:1Number of static macs: 5Number of locally learned macs: 5Number of remotely learned macs: 0Number of total macs: 10Related Commands
show l2vpn forwarding l2tp
To display L2VPN forwarding information, use the show l2vpn forwarding l2tp command in EXEC mode.
show l2vpn forwarding l2tp {disposition} {local session id session-ID | hardware | location node-id} location node-id
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows sample output for the show l2vpn forwarding l2tp command:
RP/0/0/CPU0:router# show l2vpn forwarding l2tp disposition hardware location 0/3/1ID Segment 1 Segment 2-----------------------------------1 Gi0/2/0/0 1 1.1.1.1 9)Related Commands
show l2vpn pw-class
To display L2VPN pseudowire class information, use the show l2vpn pw-class command in EXEC mode.
show l2vpn pw-class [detail | name class name]
Syntax Description
detail
Displays detailed information.
name class name
Displays information about a specific pseudowire class name.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows sample output for the show l2vpn pw-class command:
RP/0/RP0/CPU0:router# show l2vpn pw-className Encapsulation Protocol------------------------- ---------- ----------l2tp-dynamic L2TPv3 L2TPv3Table 91 describes the significant fields shown in the display.
Table 91 show l2vpn pw-class Field Descriptions
Name
Displays the name of the pseudowire class.
Encapsulation
Displays the encapsulation type.
Protocol
Displays the protocol type.
Related Commands
show l2vpn resource
To displays the memory state in the L2VPN process, use the show l2vpn resource command in EXEC mode.
show l2vpn resource
Syntax Description
This command has no arguments or keywords
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows sample output for the show l2vpn resource command:
RP/0/RP0/CPU0:router# show l2vpn resourceMemory: NormalTable 92 describes the significant fields shown in the display.
show l2vpn xconnect
To display brief information on configured cross-connects, use the show l2vpn connect command in EXEC mode.
show l2vpn xconnect [detail | group | interface | neighbor | state | summary | type | state unresolved]
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The following command uses the tag customer1 to display all cross-connects in that group. 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
Examples
The following example shows sample output for the show l2vpn xconnect command:
RP/0/RP0/CPU0:router# show l2vpn xconnectLegend: ST = State, UP = Up, DN = Down, AD = Admin Down, UR = Unresolved,LU = Local Up, RU = Remote Up, CO = ConnectedXConnect Segment 1 Segment 2Group Name ST Description ST Description ST---------------------------- --------------------------- -------------------------siva_xc siva_p2p UP Gi0/4/0/1 UP 1.1.1.1 1 UPBackup2.2.2.2 2 UP--------------------------------------------------------------------------------The following sample output shows that the backup is in standby mode for the show l2vpn xconnect detail command:RP/0/RP0/CPU0:router# show l2vpn xconnect detailGroup siva_xc, XC siva_p2p, state is up; Interworking noneAC: GigabitEthernet0/4/0/1, state is upType EthernetMTU 1500; XC ID 0x5000001; interworking none; MSTi 0Statistics:packet totals: send 90byte totals: send 19056PW: neighbor 1.1.1.1, PW ID 1, state is up ( established )PW class not set, XC ID 0x5000001Encapsulation MPLS, protocol LDPPW type Ethernet, control word enabled, interworking nonePW backup disable delay 0 secSequencing not setMPLS Local Remote------------ ------------------------------ -----------------------------Label 30005 16003Group ID 0x5000300 0x5000400Interface GigabitEthernet0/4/0/1 GigabitEthernet0/4/0/2MTU 1500 1500Control word enabled enabledPW type Ethernet EthernetVCCV CV type 0x2 0x2(LSP ping verification) (LSP ping verification)VCCV CC type 0x3 0x3(control word) (control word)(router alert label) (router alert label)------------ ------------------------------ -----------------------------Create time: 20/11/2007 21:45:07 (00:49:18 ago)Last time status changed: 20/11/2007 21:45:11 (00:49:14 ago)Statistics:packet totals: receive 0byte totals: receive 0Backup PW:PW: neighbor 2.2.2.2, PW ID 2, state is up ( established )Backup for neighbor 1.1.1.1 PW ID 1 ( standby )PW class not set, XC ID 0x0Encapsulation MPLS, protocol LDPPW type Ethernet, control word enabled, interworking nonePW backup disable delay 0 secSequencing not setMPLS Local Remote------------ ------------------------------ -----------------------------Label 30006 16003Group ID unassigned 0x5000400Interface unknown GigabitEthernet0/4/0/2MTU 1500 1500Control word enabled enabledPW type Ethernet EthernetVCCV CV type 0x2 0x2(LSP ping verification) (LSP ping verification)VCCV CC type 0x3 0x3(control word) (control word)(router alert label) (router alert label)------------ ------------------------------ -----------------------------Backup PW for neighbor 1.1.1.1 PW ID 1Create time: 20/11/2007 21:45:45 (00:48:40 ago)Last time status changed: 20/11/2007 21:45:49 (00:48:36 ago)Statistics:packet totals: receive 0byte totals: receive 0The following sample output shows that the backup is active for the show l2vpn xconnect detail command:RP/0/RP0/CPU0:router# show l2vpn xconnect detailGroup siva_xc, XC siva_p2p, state is down; Interworking noneAC: GigabitEthernet0/4/0/1, state is upType EthernetMTU 1500; XC ID 0x5000001; interworking none; MSTi 0Statistics:packet totals: send 98byte totals: send 20798PW: neighbor 1.1.1.1, PW ID 1, state is down ( local ready )PW class not set, XC ID 0x5000001Encapsulation MPLS, protocol LDPPW type Ethernet, control word enabled, interworking nonePW backup disable delay 0 secSequencing not setMPLS Local Remote------------ ------------------------------ -----------------------------Label 30005 unknownGroup ID 0x5000300 0x0Interface GigabitEthernet0/4/0/1 unknownMTU 1500 unknownControl word enabled unknownPW type Ethernet unknownVCCV CV type 0x2 0x0(none)(LSP ping verification)VCCV CC type 0x3 0x0(none)(control word)(router alert label)------------ ------------------------------ -----------------------------Create time: 20/11/2007 21:45:06 (00:53:31 ago)Last time status changed: 20/11/2007 22:38:14 (00:00:23 ago)Statistics:packet totals: receive 0byte totals: receive 0Backup PW:PW: neighbor 2.2.2.2, PW ID 2, state is up ( established )Backup for neighbor 1.1.1.1 PW ID 1 ( active )PW class not set, XC ID 0x0Encapsulation MPLS, protocol LDPPW type Ethernet, control word enabled, interworking nonePW backup disable delay 0 secSequencing not setMPLS Local Remote------------ ------------------------------ -----------------------------Label 30006 16003Group ID unassigned 0x5000400Interface unknown GigabitEthernet0/4/0/2MTU 1500 1500Control word enabled enabledPW type Ethernet EthernetVCCV CV type 0x2 0x2(LSP ping verification) (LSP ping verification)VCCV CC type 0x3 0x3(control word) (control word)(router alert label) (router alert label)------------ ------------------------------ -----------------------------Backup PW for neighbor 1.1.1.1 PW ID 1Create time: 20/11/2007 21:45:44 (00:52:54 ago)Last time status changed: 20/11/2007 21:45:48 (00:52:49 ago)Statistics:packet totals: receive 0byte totals: receive 0Table 93 describes the significant fields shown in the display.
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.
timeout setup {seconds}
no timeout setup {seconds}
Syntax Description
seconds
Time, in seconds, to setup a control channel. Range is 60 to 6000 seconds. Default is 300 seconds.
Defaults
seconds: 300
Command Modes
L2TP class configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to configure a timeout value for L2TP session setup of 400 seconds:
RP/0/0/CPU0:router# configureRP/0/0/CPU0:router(config)# l2tp-class ciscoRP/0/0/CPU0:router(config-l2tp-class)# timeout setup 400Related Commands
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.
transport mode {ethernet | vlan}
no transport mode {ethernet | vlan}
Syntax Description
Defaults
No default behavior or values
Command Modes
L2VPN pseudowire class MPLS encapsulation
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Note
Task ID
Examples
The following example shows how to configure Ethernet transport mode:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# l2vpnRP/0/RP0/CPU0:router(config-l2vpn)# pw-class kanata01RP/0/RP0/CPU0:router(config-l2vpn-pw)# encapsulation mplsRP/0/RP0/CPU0:router(config-l2vpn-encap-mpls)# transport-mode ethernetRelated Commands
tunnel-template
To enter tunnel-template configuration submode, use the tunnel-template command in global configuration mode.
tunnel-template template name
no tunnel-template template name
Syntax Description
Defaults
No default behavior or values
Command Modes
Global configuration
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to enter tunnel-template configuration submode:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# tunnel-template template_01Related 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.
xconnect group group-name
no xconnect group group-name
Syntax Description
Defaults
No default behavior or values
Command Modes
L2VPN configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Note
Task ID
Examples
The following example shows how to group all cross -connects for customer_atlantic:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# l2vpnRP/0/RP0/CPU0:router(config-l2vpn)# xconnect group customer_atlanticRelated Commands
Feedback