Configuring ATM Interfaces on Cisco IOS XR

Software

This chapter describes how to configure ATM on the Cisco XR 12000 Series Router using
Cisco IOS XR software. ATM is a cell-switching and multiplexing technology that is widely used in
Wide Area Networks (WANs). ATM protocol standards enable point-to-point, point-to-multipoint, and
broadcast services connections using various slow- and high-speed network media. Connectivity
between two ATM permanent virtual circuits (PVCs) is established using ATM signaling mechanisms.
Various ATM signaling standards are defined by the following ATM forum standards:
• UNI Version 3.0, Version 3.1, and Version 4.0
• ITU
• IETF

Feature History for Configuring Bidirectional Forwarding Detection on Cisco IOS XR

Release Modification
Release 3.4.0 This feature was introduced on the Cisco XR 12000 Series Router on the
following hardware:
• Cisco XR 12000 Series 4-Port OC-3c/STM-1c ATM ISE Line Card,
multimode
• Cisco XR 12000 Series 4-Port OC-3c/STM-1c ATM ISE Line Card,
single-mode
• Cisco XR 12000 Series 4-port OC-12/STM-4 ATM multimode ISE line
card with SC connector
• Cisco XR 12000 Series 4-port OC-12/STM-4 ATM single-mode,
intermediate-reach ISE line card with SC Connector
Release 3.4.1 The Layer 2 Virtual Private Network (L2VPN) feature was first supported
on ATM interfaces on the Cisco XR 12000 Series Router.
Release 3.5.0 OAM configuration was first supported on L2VPN ATM interfaces.
Release 3.6.0 No modifications.

Contents
• Prerequisites for Implementing ATM, page 2
• Information About ATM, page 2

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-1
 Configuring ATM Interfaces on Cisco IOS XR Software
Prerequisites for Implementing ATM

• How to Bring Up and Configure ATM Interfaces, page 6

• How to Create and Configure a Point-to-Point ATM Subinterface with a PVC, page 11
• How to Create and Configure a VP-Tunnel, page 16
• How to Configure a Layer 2 Attachment Circuit, page 22
• How to Create and Configure a Vc-Class, page 33
• How to Configure ILMI on ATM Interfaces, page 41
• Configuration Examples for Configuring ATM on Cisco IOS XR Software, page 45
• Additional References, page 50

Prerequisites for Implementing ATM

The following are required to implement ATM:
• You must be in a user group associated with a task group that includes the proper task IDs for the
ATM commands. Task IDs for commands are listed in Cisco IOS XR Interface and Hardware
Component Command Reference. For detailed information about user groups and task IDs, refer to
the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security
Configuration Guide.
• A Cisco XR 12000 Series Router that runs Cisco IOS XR software.

Information About ATM

Network nodes use ATM connections to transfer bits of data organized as 53-byte ATM cells. User
information (such as voice, video, and data) is segmented into ATM cells on one end of the connection,
and then reassembled on the other end of the connection. ATM Adaptation Layer (AAL) defines the
conversion of user information into ATM cells. AAL1 and AAL2 handle isochronous traffic (such as
voice and video), and are relevant to the ATM node only when it is equipped with either a CES (Circuit
Emulation Service) ATM interface card, or when it has voice over AAL2 capabilities. AAL3/4 and
AAL5 support data communications; that is, they segment and reassemble data packets.
The two types of devices in an ATM network are switches and routers. Typically, ATM switches do
packet switching at Layer 2, while ATM routers do packet switching using Layer 3 addresses, such as
IPv4 network addresses, IPv6 network addresses, and MPLS labels.
ATM is supported on the following line cards:
• 4-port OC12
• 4-port OC3
Cisco IOS XR software ATM interfaces can operate in the following modes:
• Point-to-point
• Layer 2 port mode

Note A single ATM interface can simultaneously support point-to-point and L2VPN subinterfaces.

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-2 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
Information About ATM

In Cisco IOS XR software, ATM interface configuration is hierarchical and comprises the following
elements:
1. The ATM main interface, which is the physical interface. ATM main interfaces can be configured
with point-to-point subinterfaces, VP-tunnels, ILMI interfaces, or as Layer 2 port mode attachment
circuits (ACs) or Layer 2 subinterface ACs.
2. ATM subinterfaces, which are configured under the ATM main interface. An ATM subinterface does
not actively carry traffic until you configure a PVC or PVP under the ATM subinterface.
3. PVCs, which are configured under an ATM subinterface. A single PVC is allowed per subinterface.
PVCs are supported under point-to-point and Layer 2 subinterfaces.
4. Permanent virtual paths (PVPs), which are configured under a Layer 2 ATM subinterface. A single
PVP is allowed per subinterface.

VC-Class Mapping
A virtual circuit (VC) class enables the configuration of VC parameters that are then mapped to a main
interface, subinterface, or PVC. Without vc-classes, you must perform considerable manual
configuration on each ATM main interface, subinterface, and PVC and on the router. This configuration
can be time consuming and error prone. After you have created vc-class, you can apply that vc-class to
as many ATM interfaces, subinterfaces, or PVCs as you want.
Vc-classes include the following types of configuration data:
• ATM encapsulation for the VC
• OAM management
• traffic shaping
The order of configuration precedence is hierarchical, as demonstrated in the following list, where
configuration on the PVC takes the highest precedence, and configuration on a vc-class that is attached
to the ATM main interface takes the lowest precedence:
1. Configuration on the PVC
2. Configuration on a vc-class that is attached to the PVC
3. Configuration on the subinterface
4. Configuration on a vc-class that is attached to the subinterface
5. Configuration on the ATM main interface
6. Configuration on a vc-class that is attached to the ATM main interface
For example, if the a PVC has unspecified bit rate (UBR) traffic shaping configured, but it is attached to
a class map that is configure with CBR traffic shaping, the PVC maintains the UBR traffic shaping.

Note Vc-classes are not applicable to Layer 2 port mode ACs and Layer 2 PVPs. For Layer 2 VPN
configurations, Vc-classes are applicable to the PVC only.

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-3
 Configuring ATM Interfaces on Cisco IOS XR Software
Information About ATM

VP-Tunnels
ATM interfaces support vp-tunnels. Vp-tunnels are typically used to shape PVCs into a bundle and
manage F4 Operation, Administration, and Maintenance (OAM). A Vp-tunnel is configured under the
main ATM interface, and then subinterfaces and PVCs can be added to the vp-tunnel. Vp-tunnels and the
PVCs that are configured under them share the same VPI. When a vp-tunnel goes down, all PVCs
configured under that vp-tunnel go down, too.
By default, two F4 OAM connections are automatically opened for each vp-tunnel. Use the f4oam
disable command in ATM vp-tunnel configuration mode to disable the F4 OAM packets for a vp-tunnel.

F5 OAM on ATM Interfaces

The F5 Operation, Administration, and Maintenance (OAM) feature performs fault-management and
performance-management functions on PVCs. If the F5 OAM feature is not enabled on a PVC, then that
PVC remains up on the end device in the event of a service disruption where network connectivity is lost.
The result is that routing entries that point to the connection remain in the routing table and, therefore,
packets are lost. The F5 OAM feature detects such failures and brings the PVC down if there is a
disruption along its path.
Use the oam-pvc manage command to enable the F5OAM feature on a PVC. After OAM is enabled on
a PVC, the PVC can generate F5 loopback cells and you can configure continuity check (CC)
management for the PVC. Use the oam ais-rdi and oam retry commands to configure continuity
checking on a PVC.
To drop all current and future OAM cells received on an ATM interface, use the atm oam flush command
in interface configuration mode.

Note The oam ais-rdi and oam retry commands take affect only after OAM management is enabled on a PVC
with the oam-pvc manage command.

ILMI on ATM Interfaces

The ILMI protocol is defined by the ATM Forum for setting and capturing physical layer, ATM layer,
virtual path, and virtual circuit parameters on ATM interfaces. When two ATM interfaces run the ILMI
protocol, they exchange ILMI packets across the physical connection. These packets consist of SNMP
messages as large as 484 octets. ATM interfaces encapsulate these messages in an ATM adaptation layer
5 (AAL5) trailer, segment the packet into cells, and schedule the cells for transmission.
You must enable ILMI on ATM interfaces that communicate with end devices that are configured for
ILMI. To enable ILMI, create a PVC with ILMI encapsulation directly under the main ATM interface by
using the pvc vpi/vci ilmi command in interface configuration mode.
PVCs use ILMI encapsulation to carry ILMI messages. Use the pvc vpi/vci ilmi command in interface
configuration mode to create an ILMI PVC on an ATM main interface.

Note You must use the same VPI and VCI values on both ends of the PVC that connects the end device and
the router.

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-4 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
Information About ATM

Note The ILMI configuration commands are available only after an ILMI PVC is created under the ATM main
interface. The ILMI configuration takes affect on the ATM main interface.

Note ILMI configuration is not supported on Layer 2 port mode ACs.

Layer 2 VPN on ATM Interfaces

The Layer 2 VPN (L2VPN) feature enables the connection between different types of Layer 2 attachment
circuits and pseudowires, allowing users to implement different types of end-to-end services.
Cisco IOS XR software supports a point-to-point, end-to-end service, where two ATM ACs are
connected together.
Switching can take place in two ways:
• AC-to-PW—Traffic reaching the PE is tunneled over a pseudowire (and conversely, traffic arriving
over the PW is sent out over the AC). This is the most common scenario.
• Local switching—Traffic arriving on one AC is immediately sent out another AC without passing
through a pseudowire.
Keep the following in mind when configuring L2VPN on an ATM interface:
• Cisco IOS XR software supports up to 2000 ACs per line card.
ATM-over-MPLS supports two types of cell encapsulation:
– AAL5 CPCS mode—Unsegmented ATM cells are transported across an MPLS backbone.
– ATM cell (AAL0) mode—Cells are segmented and then reassembled, or packed. AAL0 is
supported on ATM main ports, PVCs, and PVPs. The benefits of using AAL0 mode is that
groups of ATM cells share a label that maximizes bandwidth efficiencies.

Note AAL5 mode is supported on PVCs only.

Use the following commands to display AC and pseudowire information:

• show interfaces
• show l2vpn xconnect
• show atm pvp
• show atm pvc

Note For detailed information about configuring an L2VPN network, see the “Implementing MPLS Layer 2
VPNs” module of Cisco IOS XR Multiprotocol Label Switching Configuration Guide.

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-5
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Bring Up and Configure ATM Interfaces

Cell Packing on L2VPN ACs with AAL0 Mode Encapsulation

Cell packing is supported on L2VPN ATM interfaces that are configured with AAL0 mode
encapsulation. Cell packing relates to the delay variations that are defined in the ATM standards. Users
can specify the number of cells that can be processed by the pseudowire, and configure the maximum
cell packing timeout (MCPT) timers to use in conjunction with cell packing.
The cell-packing command allows the user to perform the following tasks:
• Configure the maximum number of cells that can be transmitted in a single packet
• Attach one of the three MCPT timers to an individual Layer 2 port mode AC, PVC, or PVP.
The three MCPT timers are defined under the main ATM interface with the atm mcpt-timer command,
which lets the user specify the maximum number of microseconds to wait to complete cell packing on a
single packet before that packet is transmitted. If the associated MCPT timer expires before the
maximum number of cells that can be packed is reached, then the packet is transmitted with the number
of cells that have been packed thus far.
We recommend configuring a low, medium, and high value for the three MCPT timers to accommodate
the different ATM traffic classes. Low- latency constant bit rate (CBR) traffic typically uses a low MCPT
timer value, while high-latency Unspecified bit rate (UBR) traffic typically requires a high MCPT timer
value. Variable bit rate real-time (VBR-rt) and variable bit rate non-real-time (VBR-nrt) traffic typically
use a median MCPT timer value.

How to Bring Up and Configure ATM Interfaces

The ATM interface configuration tasks are described in the following procedures:
• Bringing Up an ATM Interface, page 6
• Configuring Optional ATM Interface Parameters, page 8

Bringing Up an ATM Interface

This task describes the commands used to bring up an ATM interface.

Prerequisites
You must have one of the following line cards installed in a Cisco XR 12000 Series Router that is
running Cisco IOS XR software:
• 4-port OC12
• 4-port OC3

Restrictions
The configuration on both ends of the ATM connection must match for the interface to be active.

SUMMARY STEPS

1. configure
2. interface atm instance

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-6 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Bring Up and Configure ATM Interfaces

3. no shutdown
4. end
or
commit
5. exit
6. exit
7. Repeat Step 1 through Step 6 to bring up the interface at the other end of the connection.
8. show interfaces atm instance brief

DETAILED STEPSs

Command or Action Purpose

Step 1 configure Enters global configuration mode.

Example:
RP/0/0/CPU0:router# configure
Step 2 interface atm instance Enters ATM interface configuration mode.

Example:
RP/0/0/CPU0:router (config)# interface atm
0/6/0/1
Step 3 no shutdown Removes the shutdown configuration.
Note Removal of the shutdown configuration eliminates
Example: the forced administrative down on the interface,
RP/0/0/CPU0:router (config-if)# no shutdown enabling it to move to an up or down state.
Step 4 end Saves configuration changes.
or
• When you issue the end command, the system prompts
commit you to commit changes:
Uncommitted changes found, commit them before
Example: exiting(yes/no/cancel)?
RP/0/0/CPU0:router (config-if)# end [cancel]:
or
– Entering yes saves configuration changes to the
RP/0/0/CPU0:router(config-if)# commit running configuration file, exits the configuration
session, and returns the router to EXEC mode.
– Entering no exits the configuration session and
returns the router to EXEC mode without
committing the configuration changes.
– Entering cancel leaves the router in the current
configuration session without exiting or
committing the configuration changes.
• Use the commit command to save the configuration
changes to the running configuration file and remain
within the configuration session.

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-7
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Bring Up and Configure ATM Interfaces

Command or Action Purpose

Step 5 exit Exits interface configuration mode and enters global
configuration mode.
Example:
RP/0/0/CPU0:router (config-if)# exit
Step 6 exit Exits global configuration mode and enters EXEC mode.

Example:
RP/0/0/CPU0:router (config)# exit
Step 7 Repeat Step 1 through Step 6 to bring up the interface Brings up the connection.
at the other end of the connection.
Note The configuration on both ends of the ATM
connection must match.
Step 8 show interfaces atm instance brief (Optional) Verifies that the interface is active and properly
configured.
Example: If you have brought up an ATM interface properly, the
RP/0/0/CPU0:router# show interfaces atm 0/6/0/1 “Intf State” field for that interface in the show interfaces
brief atm command output shows “up.”

What to do Next
• To modify the default configuration of the ATM interface you just brought up, see the “Configuring
Optional ATM Interface Parameters” section on page 8.
• To configure a point-to-point subinterface on the ATM interface you just brought up, see the “How
to Create and Configure a Point-to-Point ATM Subinterface with a PVC” section on page 11.
• To create a Vp-tunnel on the ATM interface you just brought up, see the “How to Create and
Configure a VP-Tunnel” section on page 16.
• To use the interface as a Layer 2 post mode AC, see the “How to Configure a Layer 2 Attachment
Circuit” section on page 22.
• To attach a Vc-class to the ATM interface you just brought up, see the “How to Create and Configure
a Vc-Class” section on page 33.
• To enable ILMI on the ATM interface you just brought up, see the “How to Configure ILMI on ATM
Interfaces” section on page 41.

Configuring Optional ATM Interface Parameters

This task describes the commands you can use to modify the default configuration on an ATM interface.

Prerequisites
Before you modify the default ATM interface configuration, we recommend that you bring up the ATM
interface and remove the shutdown configuration, as described in the “Bringing Up an ATM Interface”
section on page 6.

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-8 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Bring Up and Configure ATM Interfaces

Restrictions
The configuration on both ends of the ATM connection must match for the interface to be active.

SUMMARY STEPS

1. configure
2. interface atm instance
3. atm maxvpi-bits 12
4. atm oam flush
5. atm mcpt-timers timer-1 timer-2 timer-3
6. end
or
commit
7. exit
8. exit
9. show atm interface atm [instance]
10. show interfaces atm instance brief

Command or Action Purpose

Step 1 configure Enters global configuration mode.

Example:
RP/0/0/CPU0:router# configure
Step 2 interface atm instance Enters ATM interface configuration mode.

Example:
RP/0/0/CPU0:router (config)# interface atm
0/6/0/1
Step 3 atm maxvpi-bits 12 (Optional) Enables support for the 12-bit VPI NNI cell
format.
Example:
RP/0/0/CPU0:router (config-if)# atm maxvpi-bits
12
Step 4 atm oam flush (Optional) Drops all current and future OAM cells received
on an ATM interface.
Example:
RP/0/0/CPU0:router (config-if)# atm oam flush
Step 5 atm mcpt-timers timer-1 timer-2 timer-3 (Optional) Specifies the maximum cell packing timeout
values for each of the three per-interface MCPT timers, in
microseconds.
Example:
RP/0/0/CPU0:router (config-if)# atm mcpt-timers Note The default value for each timer is 50 microseconds.
50 100 200
Note The atm mcpt-timers command is applicable to
Layer 2 ATM ACs only.

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-9
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Bring Up and Configure ATM Interfaces

Command or Action Purpose

Step 6 end Saves configuration changes.
or
• When you issue the end command, the system prompts
commit you to commit changes:
Uncommitted changes found, commit them before
Example: exiting(yes/no/cancel)?
RP/0/0/CPU0:router (config-if)# end [cancel]:
or
– Entering yes saves configuration changes to the
RP/0/0/CPU0:router(config-if)# commit running configuration file, exits the configuration
session, and returns the router to EXEC mode.
– Entering no exits the configuration session and
returns the router to EXEC mode without
committing the configuration changes.
– Entering cancel leaves the router in the current
configuration session without exiting or
committing the configuration changes.
• Use the commit command to save the configuration
changes to the running configuration file and remain
within the configuration session.
Step 7 exit Exits interface configuration mode and enters global
configuration mode.
Example:
RP/0/0/CPU0:router (config-if)# exit
Step 8 exit Exits global configuration mode and enters EXEC mode.

Example:
RP/0/0/CPU0:router (config)# exit
Step 9 show atm interface atm [instance] (Optional) Displays ATM-specific data for the specified
ATM interface.
Example:
RP/0/0/CPU0:router# show atm interface atm
0/6/0/1
Step 10 show interfaces atm instance (Optional) Displays general information for the specified
ATM interface.
Example:
RP/0/0/CPU0:router# show interfaces atm 0/6/0/1

What to do Next
• To configure a point-to-point subinterface on the ATM interface you just brought up, see the “How
to Create and Configure a Point-to-Point ATM Subinterface with a PVC” section on page 11.
• To create a Vp-tunnel on the ATM interface you just brought up, see the “How to Create and
Configure a VP-Tunnel” section on page 16.
• To use the interface as a Layer 2 ATM AC, see the “How to Configure a Layer 2 Attachment Circuit”
section on page 22.

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-10 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Create and Configure a Point-to-Point ATM Subinterface with a PVC

• To attach a Vc-class to the ATM interface you just brought up, see the “How to Create and Configure
a Vc-Class” section on page 33.
• To enable ILMI on the ATM interface you just brought up, see the “How to Configure ILMI on ATM
Interfaces” section on page 41.

How to Create and Configure a Point-to-Point ATM Subinterface

with a PVC
The configuration tasks for creating and configuring a point-to-point ATM subinterface with a PVC are
described in the following procedures:
• Creating a Point-to-Point ATM Subinterface with a PVC, page 11
• Configuring Optional Point-to-Point ATM PVC Parameters, page 13

Creating a Point-to-Point ATM Subinterface with a PVC

The procedure in this section creates a point-to-point ATM subinterface and configures a permanent
virtual circuit (PVC) on that ATM subinterface.

Prerequisites
Before you can create an ATM subinterface on an ATM interface, you must bring up an ATM interface,
as described in the “Bringing Up an ATM Interface” section on page 6.

Restrictions
Only one PVC can be configured for each point-to-point ATM subinterface.

SUMMARY STEPS

1. configure
2. interface atm instance.subinterface point-to-point
3. ipv4 address ipv4_address/prefix
4. pvc vpi/vci
5. end
or
commit
6. Repeat Step 1 through Step 5 to bring up the ATM subinterface and any associated PVC at the other
end of the connection.

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-11
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Create and Configure a Point-to-Point ATM Subinterface with a PVC

DETAILED STEPS

Command or Action Purpose

Step 1 configure Enters global configuration mode.

Example:
RP/0/0/CPU0:router# configure
Step 2 interface atm instance.subinterface Enters ATM subinterface configuration mode.
point-to-point

Example:
RP/0/0/CPU0:router (config)# interface atm
0/6/0/1.10
Step 3 ipv4 address ipv4_address/prefix Assigns an IP address and subnet mask to the subinterface.

Example:
RP/0/0/CPU0:router (config-subif)#ipv4 address
10.46.8.6/24
Step 4 pvc vpi/vci (Optional) Creates an ATM permanent virtual circuit (PVC)
and enters ATM PVC configuration submode.
Example: Note Only one PVC is allowed per subinterface.
RP/0/0/CPU0:router (config-subif)# pvc 5/10
Step 5 end Saves configuration changes.
or
• When you issue the end command, the system prompts
commit you to commit changes:
Uncommitted changes found, commit them before
Example: exiting(yes/no/cancel)?
RP/0/0/CPU0:router (config-subif)# end [cancel]:
or
– Entering yes saves configuration changes to the
RP/0/0/CPU0:router(config-subif)# commit running configuration file, exits the configuration
session, and returns the router to EXEC mode.
– Entering no exits the configuration session and
returns the router to EXEC mode without
committing the configuration changes.
– Entering cancel leaves the router in the current
configuration session without exiting or
committing the configuration changes.
• Use the commit command to save the configuration
changes to the running configuration file and remain
within the configuration session.
Step 6 Repeat Step 1 through Step 5 to bring up the ATM Brings up the ATM connection.
subinterface and any associated PVC at the other end
Note The configuration on both ends of the subinterface
of the connection.
connection must match.

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-12 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Create and Configure a Point-to-Point ATM Subinterface with a PVC

What to do Next
• To configure optional PVC parameters, see the “Configuring Optional Point-to-Point ATM PVC
Parameters” section on page 13.
• To attach Layer 3 service policies, such as Multiprotocol Label Switching (MPLS) or quality of
service (QoS), to the PVC under the PVC submode, refer to the appropriate Cisco IOS XR software
configuration guide.
• To configure a vc-class and apply it to an ATM subinterface or PVC, see the “Creating and
Configuring a VC-Class” section on page 34.

Configuring Optional Point-to-Point ATM PVC Parameters

This task describes the commands you can use to modify the default configuration on an ATM PVC.

Prerequisites
Before you can modify the default PVC configuration, you must create the PVC on an ATM subinterface,
as described in the “Creating a Point-to-Point ATM Subinterface with a PVC” section on page 11.

Restrictions
The configuration on both ends of the PVC must match for the connection to be active.

SUMMARY STEPS

1. configure
2. interface atm instance.subinterface point-to-point
3. pvc vpi/vci
4. encapsulation {aal5mux ipv4 | aal5nlpid | aal5snap}
5. oam-pvc manage [frequency] [disable] [keep-vc-up [seg-aisrdi-failure]]
6. oam ais-rdi [down-count [up-count]]
7. oam retry
8. shape [cbr peak_output_rate | ubr peak_output_rate | vbr-nrt peak_output_rate
sustained_output_rate burst_size| vbr-rt peak_output_rate sustained_output_rate burst_size]
9. service-policy [input | output] policy_name
10. end
or
commit
11. Repeat Step 1 through Step 10 to configure the PVC at the other end of the connection.

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-13
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Create and Configure a Point-to-Point ATM Subinterface with a PVC

DETAILED STEPS

Command or Action Purpose

Step 1 configure Enters global configuration mode.

Example:
RP/0/0/CPU0:router# configure
Step 2 interface atm instance.subinterface Enters ATM subinterface configuration mode.
point-to-point

Example:
RP/0/0/CPU0:router (config)# interface atm
0/6/0/1.10 point-to-point
Step 3 pvc vpi/vci Enters subinterface configuration mode for the PVC.

Example:
RP/0/0/CPU0:router (config-subif)# pvc 5/10
Step 4 encapsulation {aal5mux ipv4 | aal5nlpid | Configures the ATM adaptation layer (AAL) and
aal5snap} encapsulation type for a PVC.
Note The default encapsulation type for a vc-class is
Example: AAL5/SNAP
RP/0/0/CPU0:router (config-atm-vc)#
encapsulation aal5snap
Step 5 oam-pvc manage [frequency] [disable] Enable ATM OAM F5 loopback cell generation and
[keep-vc-up [seg-aisrdi-failure] configures continuity check (CC) management for the ATM
permanent virtual circuit (PVC).
Example: • Include the disable keyword to disable OAM
RP/0/0/CPU0:router (config-atm-vc)# oam-pvc management on the specified PVC.
manage 200 keep-vc-up
• Include the keep-vc-up keyword specify that PVC
remains in the UP state when CC cells detect
connectivity failure.
• Include the seg-aisrdi-failure keyword to specify that,
if segment AIS/RDI cells are received, the VC will not
be brought down because of end CC failure or loopback
failure.
Step 6 oam ais-rdi [down-count [up-count]] Configures the PVC so that it is brought down after a
specified number of OAM alarm indication signal/remote
defect indication (AIS/RDI) cells are received on the
Example:
RP/0/0/CPU0:router (config-atm-vc)# oam ais-rdi
associated PVC.
25 5
Step 7 oam retry [up-count [down-count Configures parameters related to OAM management for the
[retry-frequency]]] PVC.
If no OAM AIS/RDI cells are received within the specified
Example: interval, the PVC is brought up.
RP/0/0/CPU0:router (config-atm-vc)# oam retry 5
10 5

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-14 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Create and Configure a Point-to-Point ATM Subinterface with a PVC

Command or Action Purpose

Step 8 shape [cbr peak_output_rate | ubr Configures ATM traffic shaping for the PVC.
peak_output_rate| vbr-nrt peak_output_rate
sustained_output_rate burst_size| vbr-rt You must estimate how much bandwidth is required before
peak_output_rate sustained_output_rate you configure ATM traffic shaping.
burst_size]
• peak_output_rate—Configures the maximum cell rate
that is always available for the traffic.
Example:
• Sustained_output_rate—Sustained output rate for the
RP/0/0/CPU0:router (config-atm-vc)# shape
vbr-nrt 100000 100000 8000 bit rate.
• burst size—Burst cell size for the bit rate. Range is
from 1 through 8192.
Step 9 service-policy [input | output] policy_name Attaches a QoS policy to an input or output PVC. Replace
policy_name with the name of the service policy you want
to attach to the PVC.
Example:
RP/0/0/CPU0:router (config-atm-vc)# Note For information on creating and configuring service
service-policy input policyA policies, see the Cisco IOS XR Modular Quality of
Service Configuration Guide.
Step 10 end Saves configuration changes.
or
• When you issue the end command, the system prompts
commit you to commit changes:
Uncommitted changes found, commit them before
Example: exiting(yes/no/cancel)?
RP/0/0/CPU0:router (config-subif)# end [cancel]:
or
– Entering yes saves configuration changes to the
RP/0/0/CPU0:router(config-subif)# commit running configuration file, exits the configuration
session, and returns the router to EXEC mode.
– Entering no exits the configuration session and
returns the router to EXEC mode without
committing the configuration changes.
– Entering cancel leaves the router in the current
configuration session without exiting or
committing the configuration changes.
Use the commit command to save the configuration
changes to the running configuration file and remain within
the configuration session.
Step 11 Repeat Step 1 through Step 10 to configure the PVC at Brings up the connection.
the other end of the connection.
Note The configuration on both ends of the connection
must match.

What to do Next
• To attach Layer 3 service policies, such as MPLS or QoS, to the PVC under the PVC submode, refer
to the appropriate Cisco IOS XR software configuration guide.
• To configure a vc-class and apply it to an ATM subinterface or PVC, see the “Creating and
Configuring a VC-Class” section on page 34.

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-15
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Create and Configure a VP-Tunnel

How to Create and Configure a VP-Tunnel

The configuration tasks for creating and configuring an ATM VP-tunnel are described in the following
procedures:
• Creating and Configuring a VP-Tunnel on an ATM Interface, page 16
• Creating and Configuring Subinterfaces with PVCs on a VP-tunnel, page 19

Note VP-tunnels are specific to point-to-point ATM interfaces and cannot be configured on ATM ACs.

Creating and Configuring a VP-Tunnel on an ATM Interface

The procedures in this section create a vp-tunnel on a point-to-point ATM main interface. The creation
and configuration of a vp-tunnel is a four-step process:
1. Bring up an ATM interface, as described in the “Bringing Up an ATM Interface” section on page 6.
2. Create and configure a vp-tunnel on the ATM interface, as describe in the “Creating and Configuring
a VP-Tunnel on an ATM Interface” section on page 16.
3. Create subinterfaces with PVCs on the vp-tunnel, as described in the “Creating and Configuring
Subinterfaces with PVCs on a VP-tunnel” section on page 19.
4. Ping the other side of the connection through the vp-tunnel to verify the vp-tunnel configuration, as
described in “Creating and Configuring Subinterfaces with PVCs on a VP-tunnel” section on
page 19.
The procedure in this section creates a vp-tunnel on an ATM main interface.

Prerequisites
Before you can create a vp-tunnel on an ATM main interface, you must bring up an ATM interface, as
described in the “Bringing Up an ATM Interface” section on page 6.

Restrictions
• A vp-tunnel is not truly active until a PVC is created with the same VPI value as the vp-tunnel, as
described in the “Creating and Configuring Subinterfaces with PVCs on a VP-tunnel” section on
page 19.
• When a vp-tunnel goes down, all VCs that are configured under that vp-tunnel go down.
• The following cards do not support Vp-tunnels with a VPI of 0:
– 4-Port OC-3c/STM-1c ATM ISE Line Card, multimode
– 4-Port OC-3c/STM-1c ATM ISE Line Card, single-mode
– 4-port OC-12/STM-4 ATM multimode ISE line card with SC connector
– Series 4-port OC-12/STM-4 ATM single-mode, intermediate-reach ISE line card with SC
Connector

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-16 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Create and Configure a VP-Tunnel

SUMMARY STEPS

1. configure
2. interface atm instance
3. vp-tunnel vpi
4. f4oam disable
5. shape [cbr peak_output_rate | vbr-nrt peak_output_rate sustained_output_rate burst_size | vbr-rt
peak_output_rate sustained_output_rate burst_size]
6. end
or
commit
7. exit
8. exit
9. Repeat Step 1 through Step 8 to bring up the vp-tunnel at the other end of the connection.
10. show atm vp-tunnel interface atm [instance]

DETAILED STEPS

Command or Action Purpose

Step 1 configure Enters global configuration mode.

Example:
RP/0/0/CPU0:router# configure
Step 2 interface atm instance Enters ATM interface configuration mode.

Example:
RP/0/0/CPU0:router (config)# interface atm
0/6/0/1
Step 3 vp-tunnel vpi Configures a vp-tunnel on an ATM interface.

Example:
RP/0/0/CPU0:router (config)# vp-tunnel 10
Step 4 f4oam disable (Optional) Disables the passing of OAM packets.

Example:
RP/0/0/CPU0:router(config-atm-vp-tunnel)# f4oam
disable

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-17
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Create and Configure a VP-Tunnel

Command or Action Purpose

Step 5 shape [cbr peak_output_rate | vbr-nrt Configures ATM traffic shaping for the PVC.
peak_output_rate sustained_output_rate
burst_size | vbr-rt peak_output_rate You must estimate how much bandwidth is required before
sustained_output_rate burst_size] you configure ATM traffic shaping.
• peak_output_rate—Configures the maximum cell rate
Example: that is always available for the traffic.
RP/0/0/CPU0:router (config-if)# shape
• Sustained_output_rate—Sustained output rate for the
bit rate.
• burst size—Burst cell size for the bit rate. Range is
from 1 through 8192.
Note After you configure traffic shaping on the
vp-tunnel, you cannot configure traffic shaping
directly on the PVCs configured under that
vp-tunnel. If you attempt to use the shape command
on a PVC that is configured under a tunnel, the
command is rejected.
Step 6 end Saves configuration changes.
or
• When you issue the end command, the system prompts
commit you to commit changes:
Uncommitted changes found, commit them before
Example: exiting(yes/no/cancel)?
RP/0/0/CPU0:router (config-if)# end [cancel]:
or
– Entering yes saves configuration changes to the
RP/0/0/CPU0:router(config-if)# commit running configuration file, exits the configuration
session, and returns the router to EXEC mode.
– Entering no exits the configuration session and
returns the router to EXEC mode without
committing the configuration changes.
– Entering cancel leaves the router in the current
configuration session without exiting or
committing the configuration changes.
• Use the commit command to save the configuration
changes to the running configuration file and remain
within the configuration session.
Step 7 exit Exits interface configuration mode and enters global
configuration mode.
Example:
RP/0/0/CPU0:router (config-if)# exit
Step 8 exit Exits global configuration mode and enters EXEC mode.

Example:
RP/0/0/CPU0:router (config)# exit

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-18 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Create and Configure a VP-Tunnel

Command or Action Purpose

Step 9 Repeat Step 1 through Step 8 to bring up the vp-tunnel Brings up the vp-tunnel.
at the other end of the connection.
Step 10 show atm vp-tunnel interface atm [instance] Displays vp-tunnel information for the entire router or a
specific ATM interface.
Example:
RP/0/0/CPU0:router (config)# show atm vp-tunnel
interface atm 0/6/0/1

What to do Next
To attach Layer 3 service policies, such as MPLS or QoS, to the vp-tunnel or its PVCs, refer to the
appropriate Cisco IOS XR software configuration guide.

Creating and Configuring Subinterfaces with PVCs on a VP-tunnel

The procedure in this section creates and configures a subinterface with a PVC on a vp-tunnel.

Note A vp-tunnel is not truly active until a PVC is created with the same VPI value as the vp-tunnel.

Prerequisites
Before you can create a subinterface with a PVC on an ATM vp-tunnel, you must create a vp-tunnel on
the ATM main interface, as described in the “Creating and Configuring a VP-Tunnel on an ATM
Interface” section on page 16.

Restrictions
• A PVC and its host vp-tunnel must share the same VPI for the connection to be active.
• The following cards do not support Vp-tunnels with a VPI of 0:
– 4-Port OC-3c/STM-1c ATM ISE Line Card, multimode
– 4-Port OC-3c/STM-1c ATM ISE Line Card, single-mode
– 4-port OC-12/STM-4 ATM multimode ISE line card with SC connector
– Series 4-port OC-12/STM-4 ATM single-mode, intermediate-reach ISE line card with SC
Connector

SUMMARY STEPS

1. configure
2. interface atm instance.subinterface point-to-point
3. ipv4 address ipv4_address/prefix
4. pvc vpi/vci

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-19
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Create and Configure a VP-Tunnel

5. end
or
commit
6. Repeat Step 1 through Step 5 to bring up the ATM subinterface and PVC at the other end of the
connection.
7. ping atm interface atm instance.subinterface vpi/vci
8. show atm vp-tunnel [interface atm instance]

DETAILED STEPS

Command or Action Purpose

Step 1 configure Enters global configuration mode.

Example:
RP/0/0/CPU0:router# configure
Step 2 interface atm instance.subinterface Creates a new subinterface and enters ATM subinterface
point-to-point configuration mode for that subinterface.

Example:
RP/0/0/CPU0:router (config)# interface atm
0/6/0/1.10 point-to-point
Step 3 ipv4 address ipv4_address/prefix Assigns an IP address and subnet mask to the subinterface.

Example:
RP/0/0/CPU0:router (config-subif)#ipv4 address
10.46.8.6/24
Step 4 pvc vpi/vci Creates an ATM permanent virtual circuit (PVC) on the
subinterface and attaches it to the vp-tunnel you created in
the “Creating and Configuring a VP-Tunnel on an ATM
Example:
RP/0/0/CPU0:router (config-subif)# pvc 5/10
Interface” section on page 16.
Replace vpi with the VPI of the vp-tunnel on which you are
creating the PVC.
Note The PVC VPI and vp-tunnel VCI must match or the
connection will not be active.

Note A vp-tunnel is not usable until you create PVCs

under it.

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-20 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Create and Configure a VP-Tunnel

Command or Action Purpose

Step 5 end Saves configuration changes.
or
• When you issue the end command, the system prompts
commit you to commit changes:
Uncommitted changes found, commit them before
Example: exiting(yes/no/cancel)?
RP/0/0/CPU0:router (config-subif)# end [cancel]:
or
– Entering yes saves configuration changes to the
RP/0/0/CPU0:router(config-subif)# commit running configuration file, exits the configuration
session, and returns the router to EXEC mode.
– Entering no exits the configuration session and
returns the router to EXEC mode without
committing the configuration changes.
– Entering cancel leaves the router in the current
configuration session without exiting or
committing the configuration changes.
• Use the commit command to save the configuration
changes to the running configuration file and remain
within the configuration session.
Step 6 Repeat Step 1 through Step5 to bring up the Brings up the subinterface and PVC.
subinterface and PVC at the other end of the vp-tunnel.
Step 7 ping atm interface atm instance.subinterface Verifies connectivity between two ATM connection
vpi/vci endpoints through the vp-tunnel you configured in Step 1
through Step 6.
Example: • Replace instance.subinterface with the ATM
RP/0/0/CPU0:router # ping atm interface atm subinterface that is configured on the vp-tunnel whose
0/2/0/0.10 10/100
connectivity you want to verify. This is the same
instance.subinterface you configured in Step 2.
• Replace vci with the VCI of the PVC configured on the
vp-tunnel whose connectivity you want to verify. This
is the same vci you configured in Step 4.
• Replace vpi with the VPI of the PVC that is configured
on the vp-tunnel whose connectivity you want to verify.
This is the same vpi you configured in Step 4.
Step 8 show atm vp-tunnel [interface atm instance] Displays vp-tunnel information for the entire router or a
specific ATM interface.
Example:
RP/0/0/CPU0:router (config)# show atm vp-tunnel
interface atm 0/6/0/1

What to do Next
• To create and configure ATM subinterfaces and PVCs on a vp-tunnel, see the “Creating and
Configuring Subinterfaces with PVCs on a VP-tunnel” section on page 19
• To configure a vc-class and apply it to an ATM interface, see the “Creating and Configuring a
VC-Class” section on page 34.

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-21
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Configure a Layer 2 Attachment Circuit

How to Configure a Layer 2 Attachment Circuit

The Layer 2 AC configuration tasks are described in the following procedures:
• Creating a Layer 2 Port Mode AC
• Configuring Optional Parameters on a Layer 2 Port Mode AC
• Creating an ATM Layer 2 Subinterface with a PVC
• Configuring Optional ATM Layer 2 PVC Parameters
• Creating an ATM Layer 2 Subinterface with a PVP
• Configuring Optional ATM Layer 2 PVP Parameters

Note After you configure an interface for Layer 2 switching, no routing commands such as ipv4 address are
permissible. If any routing commands are configured on the interface, then the l2transport command is
rejected.

Creating a Layer 2 Port Mode AC

The procedure in this section creates a Layer 2 port mode AC.

Prerequisites
Before you can create a Layer 2 port mode AC, you must bring up an ATM main interface, as described
in the “Bringing Up an ATM Interface” section on page 6.

Restrictions
ILMI configuration is not supported on Layer 2 port mode ACs.

Restrictions
Before you can configure an Layer 2 port mode AC, you must ensure that no configuration, such as
subinterfaces, already exists on that port. If any preconfiguration does exist, you must remove it.

SUMMARY STEPS

1. configure
2. interface atm instance
3. l2transport
4. end
or
commit
5. Repeat Step 1 through Step 4 to bring up the ATM AC at the other end of the connection.

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-22 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Configure a Layer 2 Attachment Circuit

DETAILED STEPS

Command or Action Purpose

Step 1 configure Enters global configuration mode.

Example:
RP/0/0/CPU0:router# configure
Step 2 interface atm instance Enters interface configuration mode for an ATM interface.

Example:
RP/0/0/CPU0:router (config)# interface atm
0/6/0/1
Step 3 l2transport Enters ATM Layer 2 transport configuration mode, and
enables Layer 2 port mode on this ATM interface.
Example:
RP/0/0/CPU0:router (config-if)# l2transport
Step 4 end Saves configuration changes.
or
• When you issue the end command, the system prompts
commit you to commit changes:
Uncommitted changes found, commit them before
Example: exiting(yes/no/cancel)?
RP/0/0/CPU0:router (config-if-l2)# end [cancel]:
or
– Entering yes saves configuration changes to the
RP/0/0/CPU0:router(config-if-l2)# commit running configuration file, exits the configuration
session, and returns the router to EXEC mode.
– Entering no exits the configuration session and
returns the router to EXEC mode without
committing the configuration changes.
– Entering cancel leaves the router in the current
configuration session without exiting or
committing the configuration changes.
• Use the commit command to save the configuration
changes to the running configuration file and remain
within the configuration session.
Step 5 Repeat Step 1 through Step 4 to bring up the Layer 2 Brings up the Layer 2 port mode AC.
port mode AC at the other end of the connection.
Note The configuration on both ends of the connection
must match.

What to do Next
• To configure a point-to-point pseudowire XConnect on the Layer 2 port mode AC you just created,
see the “Implementing MPLS Layer 2 VPNs” module of Cisco IOS XR Multiprotocol Label
Switching Configuration Guide.
• To configure optional Layer 2 VPN parameters for the ATM AC, see the “Configuring Optional
Parameters on a Layer 2 Port Mode AC” section on page 24.

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-23
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Configure a Layer 2 Attachment Circuit

Configuring Optional Parameters on a Layer 2 Port Mode AC

The procedure in this section configures optional Layer 2 VPN transport parameters on a Layer 2 port
mode AC.

Prerequisites
Before you can configure Layer 2 VPN parameters on a Layer 2 port mode AC, you must create a Layer
2 port mode AC, as described in the “Creating a Layer 2 Port Mode AC” section on page 22.

SUMMARY STEPS

1. configure
2. interface atm instance
3. atm mcpt-timers timer-1 timer-2 timer-3
4. l2transport
5. cell-packing cells timer
6. end
or
commit
7. Repeat Step 1 through Step 6 to configure the Layer 2 port mode AC at the other end of the
connection.

DETAILED STEPS

Command or Action Purpose

Step 1 configure Enters global configuration mode.

Example:
RP/0/0/CPU0:router# configure
Step 2 interface atm instance Enters interface configuration mode for an ATM interface.

Example:
RP/0/0/CPU0:router (config)# interface atm
0/6/0/1
Step 3 atm mcpt-timers timer-1 timer-2 timer-3 Specifies the maximum cell packing timeout values for each
of the three per-interface MCPT timers, in microseconds.
Example: Note The default value for each timer is 50 microseconds.
RP/0/0/CPU0:router (config-if)# atm mcpt-timers
50 100 200
Step 4 l2transport Enters ATM Layer 2 transport configuration mode.

Example:
RP/0/0/CPU0:router (config-if)# l2transport

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-24 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Configure a Layer 2 Attachment Circuit

Command or Action Purpose

Step 5 cell-packing cells timer Sets the maximum number of cells allowed per packet, and
specifies a maximum cell packing timeout (MCPT) timer to
use for cell packing.
Example:
RP/0/0/CPU0:router (config-if-l2)# cell-packing • Replace cells with the maximum number of cells to use
6 1 per packet. Range is from 2 through 86.
• Replace timer with the number that indicates the
appropriate MCPT timer to use for cell packing. Can be
1, 2, or 3. You can configure up to three different MCPT
values for a single main interface.
Step 6 end Saves configuration changes.
or
• When you issue the end command, the system prompts
commit you to commit changes:
Uncommitted changes found, commit them before
Example: exiting(yes/no/cancel)?
RP/0/0/CPU0:router (config-if-l2)# end [cancel]:
or
– Entering yes saves configuration changes to the
RP/0/0/CPU0:router(config-if-l2)# commit running configuration file, exits the configuration
session, and returns the router to EXEC mode.
– Entering no exits the configuration session and
returns the router to EXEC mode without
committing the configuration changes.
– Entering cancel leaves the router in the current
configuration session without exiting or
committing the configuration changes.
• Use the commit command to save the configuration
changes to the running configuration file and remain
within the configuration session.
Step 7 Repeat Step 1 through Step 6 to configure the AC at the Brings up the Layer 2 port mode AC.
other end of the connection.
Note The configuration on both ends of the connection
must match.

Creating an ATM Layer 2 Subinterface with a PVC

The procedure in this section creates a Layer 2 subinterface with a PVC.

Prerequisites
Before you can create a subinterface on an ATM interface, you must bring up an ATM interface, as
described in the “Bringing Up an ATM Interface” section on page 6.

Restrictions
Only one PVC can be configured for each ATM subinterface.

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-25
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Configure a Layer 2 Attachment Circuit

SUMMARY STEPS

1. configure
2. interface atm instance.subinterface l2transport
3. pvc vpi/vci
4. end
or
commit
5. Repeat Step 1 through Step 4 to bring up the ATM subinterface and any associated PVC at the other
end of the AC.

DETAILED STEPS

Command or Action Purpose

Step 1 configure Enters global configuration mode.

Example:
RP/0/0/CPU0:router# configure
Step 2 interface atm instance.subinterface l2transport Creates a subinterface and enters ATM subinterface
configuration mode for that subinterface.
Example:
RP/0/0/CPU0:router(config)# interface atm
0/6/0/1.10 l2transport
Step 3 pvc vpi/vci Creates an ATM permanent virtual circuit (PVC) and enters
ATM Layer 2 transport PVC configuration mode.
Example: Note Only one PVC is allowed per subinterface.
RP/0/0/CPU0:router(config-if)# pvc 5/20

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-26 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Configure a Layer 2 Attachment Circuit

Command or Action Purpose

Step 4 end Saves configuration changes.
or
• When you issue the end command, the system prompts
commit you to commit changes:
Uncommitted changes found, commit them before
Example: exiting(yes/no/cancel)?
RP/0/0/CPU0:router(config-atm-l2transport-pvc)# [cancel]:
end
or – Entering yes saves configuration changes to the
running configuration file, exits the configuration
RP/0/0/CPU0:router(config-atm-l2transport-pvc)#
commit
session, and returns the router to EXEC mode.
– Entering no exits the configuration session and
returns the router to EXEC mode without
committing the configuration changes.
– Entering cancel leaves the router in the current
configuration session without exiting or
committing the configuration changes.
• Use the commit command to save the configuration
changes to the running configuration file and remain
within the configuration session.
Step 5 Repeat Step 1 through Step 4 to bring up the ATM Brings up the AC.
subinterface and any associated PVC at the other end
Note The configuration on both ends of the AC must
of the AC.
match.

What to do Next
• To configure optional PVC parameters, see the “Configuring Optional ATM Layer 2 PVC
Parameters” section on page 27.
• To configure a vc-class and apply it to the PVC, see the“Attaching a Vc-Class to a PVC on an ATM
Subinterface” section on page 39.
• To configure a point-to-point pseudowire XConnect on the AC you just created, see the
“Implementing MPLS Layer 2 VPNs” module of Cisco IOS XR Multiprotocol Label Switching
Configuration Guide.

Configuring Optional ATM Layer 2 PVC Parameters

This task describes the commands you can use to modify the default configuration on an ATM Layer 2
PVC.

Prerequisites
Before you can modify the default PVC configuration, you must create the PVC on a Layer 2 ATM
subinterface, as described in the “Creating an ATM Layer 2 Subinterface with a PVC” section on
page 25.

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-27
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Configure a Layer 2 Attachment Circuit

Restrictions
The configuration on both ends of the PVC must match for the connection to be active.

SUMMARY STEPS

1. configure
2. interface atm instance.subinterface l2transport
3. pvc vpi/vci
4. encapsulation {aal0 | aal5}
5. cell-packing cells timer
6. shape [cbr peak_output_rate | ubr peak_output_rate | vbr-nrt peak_output_rate
sustained_output_rate burst_size| vbr-rt peak_output_rate sustained_output_rate burst_size]
7. end
or
commit
8. Repeat Step 1 through Step 7 to configure the PVC at the other end of the AC.

DETAILED STEPS

Command or Action Purpose

Step 1 configure Enters global configuration mode.

Example:
RP/0/0/CPU0:router# configure
Step 2 interface atm instance.subinterface l2transport Enters ATM subinterface configuration mode for a Layer 2
ATM subinterface.
Example:
RP/0/0/CPU0:router(config-if)# interface atm
0/6/0/1.10 l2transport
Step 3 pvc vpi/vci Enters ATM Layer 2 transport PVC configuration mode for
the specified PVC.
Example:
RP/0/0/CPU0:router(config-atm-l2transport-pvc)#
pvc 5/20
Step 4 encapsulation {aal0 | aal5} Configures the ATM adaptation layer (AAL) and
encapsulation type for a PVC.
Example: Note The default encapsulation type for a PVC is AAL5.
RP/0/0/CPU0:router(config-atm-l2transport-pvc)#
encapsulation aal5

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-28 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Configure a Layer 2 Attachment Circuit

Command or Action Purpose

Step 5 cell-packing cells timer Sets the maximum number of cells allowed per packet, and
specifies a maximum cell packing timeout (MCPT) timer to
use for cell packing.
Example:
RP/0/0/CPU0:router(config-atm-l2transport-pvc)# • Replace cells with the maximum number of cells to use
cell-packing 5 2 per packet. Range is from 2 through 86.
• Replace timer with the number that indicates the
appropriate MCPT timer to use for cell packing. Can be
1, 2, or 3. You can configure up to three different MCPT
values for a single main interface.
Step 6 shape [cbr peak_output_rate | ubr Configures ATM traffic shaping for the PVC.
peak_output_rate| vbr-nrt peak_output_rate
sustained_output_rate burst_size| vbr-rt You must estimate how much bandwidth is required before
peak_output_rate sustained_output_rate you configure ATM traffic shaping.
burst_size]
• peak_output_rate—Configures the maximum cell rate
that is always available for the traffic.
Example:
• Sustained_output_rate—Sustained output rate for the
RP/0/0/CPU0:router(config-atm-l2transport-pvc)#
shape vbr-nrt 100000 100000 8000 bit rate.
• burst size—Burst cell size for the bit rate. Range is
from 1 through 8192.
Step 7 end Saves configuration changes.
or
• When you issue the end command, the system prompts
commit you to commit changes:
Uncommitted changes found, commit them before
Example: exiting(yes/no/cancel)?
RP/0/0/CPU0:router(config-atm-l2transport-pvc)# [cancel]:
end
or – Entering yes saves configuration changes to the
running configuration file, exits the configuration
RP/0/0/CPU0:router(config-atm-l2transport-pvc)#
commit
session, and returns the router to EXEC mode.
– Entering no exits the configuration session and
returns the router to EXEC mode without
committing the configuration changes.
– Entering cancel leaves the router in the current
configuration session without exiting or
committing the configuration changes.
Use the commit command to save the configuration
changes to the running configuration file and remain within
the configuration session.
Step 8 Repeat Step 1 through Step 7 to configure the PVC at Brings up the AC.
the other end of the AC.
Note The configuration on both ends of the connection
must match.

What to do Next
• To configure a pseudo-wire XConnect on the AC you just created, see the “Implementing MPLS
Layer 2 VPNs” module of Cisco IOS XR Multiprotocol Label Switching Configuration Guide.

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-29
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Configure a Layer 2 Attachment Circuit

• To configure a vc-class and apply it to the PVC, see the“Attaching a Vc-Class to a PVC on an ATM
Subinterface” section on page 39.

Creating an ATM Layer 2 Subinterface with a PVP

The procedure in this section creates an ATM Layer 2 subinterface with a permanent virtual path (PVP)
on that ATM subinterface.

Prerequisites
Before you can create a subinterface with a PVP on an ATM interface, you must bring up an ATM
interface, as described in the “Bringing Up an ATM Interface” section on page 6.

Restrictions
• Only one PVP can be configured for each L2VPN ATM AC.
• F4 OAM emulation is not supported on Layer 2 PVPs.

SUMMARY STEPS

1. configure
2. interface atm instance.subinterface l2transport
3. pvp vpi
4. end
or
commit
5. Repeat Step 1 through Step 4 to bring up the ATM subinterface and any associated PVP at the other
end of the AC.

DETAILED STEPS

Command or Action Purpose

Step 1 configure Enters global configuration mode.

Example:
RP/0/0/CPU0:router# configure
Step 2 interface atm instance.subinterface l2transport Creates an ATM subinterface and enters ATM layer2
transport configuration mode for that subinterface.
Example:
RP/0/0/CPU0:router(config)# interface atm
0/6/0/1.10 l2transport
Step 3 pvp vpi (Optional) Creates an ATM PVP and enters ATM PVP
configuration submode.
Example: Note Only one PVP is allowed per subinterface.
RP/0/0/CPU0:router(config-if)# pvp 100

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-30 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Configure a Layer 2 Attachment Circuit

Command or Action Purpose

Step 4 end Saves configuration changes.
or
• When you issue the end command, the system prompts
commit you to commit changes:
Uncommitted changes found, commit them before
Example: exiting(yes/no/cancel)?
RP/0/0/CPU0:router(config-atm-l2transport-pvp)# [cancel]:
end
or – Entering yes saves configuration changes to the
running configuration file, exits the configuration
RP/0/0/CPU0:router(config-atm-l2transport-pvp)#
commit
session, and returns the router to EXEC mode.
– Entering no exits the configuration session and
returns the router to EXEC mode without
committing the configuration changes.
– Entering cancel leaves the router in the current
configuration session without exiting or
committing the configuration changes.
• Use the commit command to save the configuration
changes to the running configuration file and remain
within the configuration session.
Step 5 Repeat Step 1 through Step 4 to bring up the ATM Brings up the ATM AC.
subinterface and any associated PVP at the other end
Note The configuration on both ends of the AC
of the AC.
connection must match.

What to do Next
• To configure optional PVP parameters, see the “Configuring Optional ATM Layer 2 PVP
Parameters” section on page 31.
• To configure a point-to-point pseudowire XConnect on the AC you just created, see the
“Implementing MPLS Layer 2 VPNs” module of Cisco IOS XR Multiprotocol Label Switching
Configuration Guide.

Configuring Optional ATM Layer 2 PVP Parameters

This task describes the commands you can use to modify the default configuration on an ATM Layer 2
PVP.

Prerequisites
Before you can modify the default PVP configuration, you must create the PVP on an ATM subinterface,
as described in the “Creating an ATM Layer 2 Subinterface with a PVP” section on page 30.

Restrictions
• The following cards do not support Vp-tunnels with a VPI of 0:
– 4-Port OC-3c/STM-1c ATM ISE Line Card, multimode

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-31
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Configure a Layer 2 Attachment Circuit

– 4-Port OC-3c/STM-1c ATM ISE Line Card, single-mode

– 4-port OC-12/STM-4 ATM multimode ISE line card with SC connector
– Series 4-port OC-12/STM-4 ATM single-mode, intermediate-reach ISE line card with SC
Connector

SUMMARY STEPS

1. configure
2. interface atm instance.subinterface l2transport
3. pvp vpi
4. cell-packing cells timer
5. shape [cbr peak_output_rate | ubr peak_output_rate | vbr-nrt peak_output_rate
sustained_output_rate burst_size| vbr-rt peak_output_rate sustained_output_rate burst_size]
6. end
or
commit
7. Repeat Step 1 through Step 6 to configure the PVP at the other end of the connection.

DETAILED STEPS

Command or Action Purpose

Step 1 configure Enters global configuration mode.

Example:
RP/0/0/CPU0:router# configure
Step 2 interface atm instance.subinterface l2transport Enters ATM subinterface configuration mode.

Example:
RP/0/0/CPU0:router(config)# interface atm
0/6/0/1.10 l2transport
Step 3 pvp vpi Enters subinterface configuration mode for the PVP.

Example:
RP/0/0/CPU0:router(config-if)# pvp 10
Step 4 cell-packing cells timer Sets the maximum number of cells allowed per packet, and
specifies a maximum cell packing timeout (MCPT) timer to
use for cell packing.
Example:
RP/0/0/CPU0:router(config-atm-l2transport-pvp)# • Replace cells with the maximum number of cells to use
cell-packing 5 2 per packet. Range is from 2 through 86.
• Replace timer with the number that indicates the
appropriate MCPT timer to use for cell packing. Can be
1, 2, or 3. You can configure up to three different MCPT
values for a single main interface.

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-32 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Create and Configure a Vc-Class

Command or Action Purpose

Step 5 shape [cbr peak_output_rate | ubr Configures ATM traffic shaping for the PVC.
peak_output_rate| vbr-nrt peak_output_rate
sustained_output_rate burst_size| vbr-rt You must estimate how much bandwidth is required before
peak_output_rate sustained_output_rate you configure ATM traffic shaping.
burst_size]
• peak_output_rate—Configures the maximum cell rate
that is always available for the traffic.
Example:
• Sustained_output_rate—Sustained output rate for the
RP/0/0/CPU0:router(config-atm-l2transport-pvp)#
shape vbr-nrt 100000 100000 8000 bit rate.
• burst size—Burst cell size for the bit rate. Range is
from 1 through 8192.
Step 6 end Saves configuration changes.
or
• When you issue the end command, the system prompts
commit you to commit changes:
Uncommitted changes found, commit them before
Example: exiting(yes/no/cancel)?
RP/0/0/CPU0:router(config-atm-l2transport-pvp)# [cancel]:
end
or – Entering yes saves configuration changes to the
running configuration file, exits the configuration
RP/0/0/CPU0:router(config-atm-l2transport-pvp)#
commit
session, and returns the router to EXEC mode.
– Entering no exits the configuration session and
returns the router to EXEC mode without
committing the configuration changes.
– Entering cancel leaves the router in the current
configuration session without exiting or
committing the configuration changes.
Use the commit command to save the configuration
changes to the running configuration file and remain within
the configuration session.
Step 7 Repeat Step 1 through Step 6 to configure the PVP at Brings up the AC.
the other end of the AC.
Note The configuration on both ends of the AC
connection must match.

What to do Next
• To configure a point-to-point pseudowire XConnect on the AC you just created, see the
“Implementing MPLS Layer 2 VPNs” module of Cisco IOS XR Multiprotocol Label Switching
Configuration Guide.

How to Create and Configure a Vc-Class

The configuration tasks for creating and configuring an ATM Vc-Class are described in the following
procedures:
• Creating and Configuring a VC-Class, page 34
• Attaching a Vc-Class to a Point-to-Point ATM Main Interface, page 36

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-33
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Create and Configure a Vc-Class

• Attaching a Vc-Class to a Point-to-Point ATM Subinterface, page 38

• Attaching a Vc-Class to a PVC on an ATM Subinterface, page 39

Creating and Configuring a VC-Class

This section describes the tasks and commands required to create a virtual circuit (VC) class and attach
it to an ATM main interface, subinterface, or permanent virtual circuit (PVC).

Restrictions
For Layer 2 VPN AC configurations, Vc-classes can be applied to PVCs only. Vc-classes are not
supported on Layer 2 port mode interfaces or PVPs.

SUMMARY STEPS

1. configure
2. vc-class atm name
3. encapsulation {aal5mux ipv4 | aal5nlpid | aal5snap}
4. oam ais-rdi [down-count [up-count]]
5. oam retry [up-count [down-count [retry-frequency]]]
6. oam-pvc manage seconds
7. shape [cbr peak_output_rate | ubr peak_output_rate | vbr-nrt peak_output_rate
sustained_output_rate burst_size| vbr-rt peak_output_rate sustained_output_rate burst_size]
8. end
or
commit

DETAILED STEPS

Command or Action Purpose

Step 1 configure Enters global configuration mode.

Example:
RP/0/0/CPU0:router# configure
Step 2 vc-class atm name Creates a vc-class for an ATM interface and enters vc-class
configuration mode.
Example:
RP/0/0/CPU0:router (config)# vc-class atm
class1

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-34 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Create and Configure a Vc-Class

Command or Action Purpose

Step 3 encapsulation {aal5mux ipv4 | aal5nlpid | Configures the ATM adaptation layer (AAL) and
aal5snap} encapsulation type for an ATM vc-class.
Note The default encapsulation type for a vc-class is
Example: AAL5/SNAP
RP/0/0/CPU0:router (config-vc-class-atm)#
encapsulation aal5snap Note In Vc-classes, the encapsulation command applies
to Layer 3 Point-to-point configurations only.
Step 4 oam ais-rdi [down-count [up-count]] Configures the vc-class so that it is brought down after a
specified number of OAM alarm indication signal/remote
defect indication (AIS/RDI) cells are received on the
Example:
RP/0/0/CPU0:router (config-vc-class-atm)# oam
associated PVC.
ais-rdi 25 5 Note In Vc-classes, the oam ais-rdi command applies to
Layer 3 Point-to-point configurations only.
Step 5 oam retry [up-count [down-count Configures parameters related to OAM management.
[retry-frequency]]]
Note In Vc-classes, the oam retry command applies to
Layer 3 Point-to-point configurations only.
Example:
RP/0/0/CPU0:router (config-vc-class-atm)# oam
retry 5 10 5
Step 6 oam-pvc manage seconds Configures the ATM OAM F5 loopback frequency.
Note In Vc-classes, the oam-pvc manage command
Example: applies to Layer 3 Point-to-point configurations
RP/0/0/CPU0:router (config-vc-class-atm)# only.
oam-pvc manage 300

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-35
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Create and Configure a Vc-Class

Command or Action Purpose

Step 7 shape [cbr peak_output_rate | ubr Configures ATM traffic shaping for the PVC.
peak_output_rate | vbr-nrt peak_output_rate
sustained_output_rate burst_size| vbr-rt You must estimate how much bandwidth is required before
peak_output_rate sustained_output_rate you configure ATM traffic shaping.
burst_size]
• peak_output_rate—Configures the maximum cell rate
that is always available for the traffic.
Example:
• Sustained_output_rate—Sustained output rate for the
RP/0/0/CPU0:router (config-vc-class-atm)# shape
vbr-nrt 100000 100000 8000 bit rate.
• burst size—Burst cell size for the bit rate. Range is
from 1 through 8192.
Step 8 end Saves configuration changes.
or
• When you issue the end command, the system prompts
commit you to commit changes:
Uncommitted changes found, commit them before
Example: exiting(yes/no/cancel)?
RP/0/0/CPU0:router (config-if)# end [cancel]:
or
– Entering yes saves configuration changes to the
RP/0/0/CPU0:router(config-if)# commit running configuration file, exits the configuration
session, and returns the router to EXEC mode.
– Entering no exits the configuration session and
returns the router to EXEC mode without
committing the configuration changes.
– Entering cancel leaves the router in the current
configuration session without exiting or
committing the configuration changes.
• Use the commit command to save the configuration
changes to the running configuration file and remain
within the configuration session.

What to do Next
Attach the vc-class to an ATM main interface, subinterface, or PVC.
• To attach a vc-class to an ATM main interface, see the “Attaching a Vc-Class to a Point-to-Point
ATM Main Interface” section on page -36.
• To attach a vc-class to an ATM subinterface, see the “Attaching a Vc-Class to a Point-to-Point ATM
Subinterface” section on page -38.
• To attach a vc-class to an ATM PVC, see the “Attaching a Vc-Class to a PVC on an ATM
Subinterface” section on page -39.

Attaching a Vc-Class to a Point-to-Point ATM Main Interface

This section describes the tasks and commands required to attach a vc-class to a point-to-point ATM
main interface.

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-36 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Create and Configure a Vc-Class

Restrictions
Vc-classes are not applicable to Layer 2 port mode ACs. For Layer 2 VPN configurations, Vc-classes
are applicable to the PVC only.

SUMMARY STEPS

1. configure
2. interface atm instance point-to-point
3. class-int vc-class-name
4. end
or
commit

DETAILED STEPS

Command or Action Purpose

Step 1 configure Enters global configuration mode.

Example:
RP/0/0/CPU0:router# configure
Step 2 interface atm instance point-to-point Enters ATM interface configuration mode.

Example:
RP/0/0/CPU0:router (config)# interface atm
0/6/0/1 point-to-point

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-37
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Create and Configure a Vc-Class

Command or Action Purpose

Step 3 class-int vc-class-name Attaches the vc-class to an ATM main interface. Replace the
vc-class-name argument with the name of the vc-class you
configured in the “Creating and Configuring a VC-Class”
Example:
RP/0/0/CPU0:router (config-if)# class-int
section on page 34.
classA
Step 4 end Saves configuration changes.
or
• When you issue the end command, the system prompts
commit you to commit changes:
Uncommitted changes found, commit them before
Example: exiting(yes/no/cancel)?
RP/0/0/CPU0:router (config-if)# end [cancel]:
or
– Entering yes saves configuration changes to the
RP/0/0/CPU0:router(config-if)# commit running configuration file, exits the configuration
session, and returns the router to EXEC mode.
– Entering no exits the configuration session and
returns the router to EXEC mode without
committing the configuration changes.
– Entering cancel leaves the router in the current
configuration session without exiting or
committing the configuration changes.
• Use the commit command to save the configuration
changes to the running configuration file and remain
within the configuration session.

Attaching a Vc-Class to a Point-to-Point ATM Subinterface

This section describes the tasks and commands required to attach a vc-class to an ATM subinterface.

SUMMARY STEPS

1. configure
2. interface atm instance.subinterface point-to-point
3. class-int vc-class-name
4. end
or
commit

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-38 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Create and Configure a Vc-Class

DETAILED STEPS

Command or Action Purpose

Step 1 configure Enters global configuration mode.

Example:
RP/0/0/CPU0:router# configure
Step 2 interface atm instance.subinterface Enters ATM subinterface configuration mode.
point-to-point

Example:
RP/0/0/CPU0:router (config)# interface atm
0/6/0/1.10 point-to-point
Step 3 class-int vc-class-name Assigns the vc-class to an ATM subinterface. Replace the
vc-class-name argument with the name of the vc-class you
configured in the “Creating and Configuring a VC-Class”
Example:
RP/0/0/CPU0:router (config-subif)# class-int
section on page -34.
classA
Step 4 end Saves configuration changes.
or
• When you issue the end command, the system prompts
commit you to commit changes:
Uncommitted changes found, commit them before
Example: exiting(yes/no/cancel)?
RP/0/0/CPU0:router (config-subif)# end [cancel]:
or
– Entering yes saves configuration changes to the
RP/0/0/CPU0:router(config-subif)# commit running configuration file, exits the configuration
session, and returns the router to EXEC mode.
– Entering no exits the configuration session and
returns the router to EXEC mode without
committing the configuration changes.
– Entering cancel leaves the router in the current
configuration session without exiting or
committing the configuration changes.
• Use the commit command to save the configuration
changes to the running configuration file and remain
within the configuration session.

Attaching a Vc-Class to a PVC on an ATM Subinterface

This section describes the tasks and commands required to attach a vc-class to a PVC on an ATM
subinterface.

Note Vc-classes are supported on point-to-point and Layer 2 PVCs.

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-39
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Create and Configure a Vc-Class

SUMMARY STEPS

1. configure
2. interface atm instance[.subinterface] [point-to-point | l2transport]
3. pvc vpi/vci
4. class vc vc-class-name
5. end
or
commit

DETAILED STEPS

Command or Action Purpose

Step 1 configure Enters global configuration mode.

Example:
RP/0/0/CPU0:router# configure
Step 2 interface atm instance.subinterface Enters subinterface configuration mode and creates the
[point-to-point | l2transport] ATM subinterface if it does not already exist.
Use the point-to-point keyword if you are attaching the
Example: vc-class to a point-to-point subinterface. Use the
RP/0/0/CPU0:router (config)# interface atm l2transport keyword if you are attaching the vc-class to a
0/6/0/1.10
Layer 2 transport subinterface.
Note For more information on creating and configuring
ATM subinterfaces, see the “Creating a
Point-to-Point ATM Subinterface with a PVC”
section on page 11.
Step 3 pvc vpi/vci Enters ATM PVC configuration mode and creates the PVC
if it does not already exist.
Example: Note For more information on creating and configuring
RP/0/0/CPU0:router (config-if)# pvc 5/50 PVCs on ATM subinterfaces, see the “Creating a
Point-to-Point ATM Subinterface with a PVC”
section on page 11.

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-40 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Configure ILMI on ATM Interfaces

Command or Action Purpose

Step 4 class-vc vc-class-name Assigns a vc-class to an ATM PVC. Replace the
vc-class-name argument with the name of the vc-class you
want to attach to the PVC.
Example:
RP/0/0/CPU0:router (config-atm-vc)# class-vc
classA
Step 5 end Saves configuration changes.
or
• When you issue the end command, the system prompts
commit you to commit changes:
Uncommitted changes found, commit them before
Example: exiting(yes/no/cancel)?
RP/0/0/CPU0:router (config-if)# end [cancel]:
or
– Entering yes saves configuration changes to the
RP/0/0/CPU0:router(config-if)# commit running configuration file, exits the configuration
session, and returns the router to EXEC mode.
– Entering no exits the configuration session and
returns the router to EXEC mode without
committing the configuration changes.
– Entering cancel leaves the router in the current
configuration session without exiting or
committing the configuration changes.
• Use the commit command to save the configuration
changes to the running configuration file and remain
within the configuration session.

How to Configure ILMI on ATM Interfaces

The configuration tasks for managing ILMI on ATM interfaces are described in the following
procedures:
• Enabling ILMI on an ATM Interface, page 41
• Disabling ILMI on an ATM Interface, page 43

Enabling ILMI on an ATM Interface

This task describes the commands you can use to configure an ATM interface for ILMI.

Note For ILMI, a PVC is configured directly on the ATM main interface. Subinterface configuration is not
necessary for ATM interfaces that are used for ILMI.

Prerequisites
Bring up the ATM interface and remove the shutdown configuration, as described in the “Bringing Up
an ATM Interface” section on page 6.

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-41
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Configure ILMI on ATM Interfaces

Restrictions
• The configuration on both ends of the ATM ILMI connection must match for the interface to be
active.
• ILMI configuration is not supported on Layer 2 port mode ACs.

SUMMARY STEPS

1. configure
2. interface atm instance
3. atm address-registration
4. atm ilmi-keepalive [act-poll-freq frequency] [retries count] [inact-poll-freq frequency]
5. pvc vpi/vci ilmi
6. end
or
commit
7. exit
8. exit
9. show atm ilmi-status [atm instance]

DETAILED STEPS

Command or Action Purpose

Step 1 configure Enters global configuration mode.

Example:
RP/0/0/CPU0:router# configure
Step 2 interface atm instance Enters ATM interface configuration mode.

Example:
RP/0/0/CPU0:router (config)# interface atm
0/6/0/1
Step 3 atm address-registration (Optional) Enables the router to engage in address
registration and callback functions with the Interim Local
Management Interface (ILMI).
Example:
RP/0/0/CPU0:router (config-if)# atm
address-registration
Step 4 atm ilmi-keepalive [act-poll-freq frequency] (Optional) Enables ILMI keepalives on an ATM interface.
[retries count] [inact-poll-freq frequency]

Example:
RP/0/0/CPU0:router (config-if)# atm
ilmi-keepalive

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-42 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Configure ILMI on ATM Interfaces

Command or Action Purpose

Step 5 pvc vpi/vci ilmi Creates an ATM permanent virtual circuit (PVC) with ILMI
encapsulation.
Example:
RP/0/0/CPU0:router (config-if)# pvc 5/30 ilmi
Step 6 end Saves configuration changes.
or
• When you issue the end command, the system prompts
commit you to commit changes:
Uncommitted changes found, commit them before
Example: exiting(yes/no/cancel)?
RP/0/0/CPU0:router (config-if)# end [cancel]:
or
– Entering yes saves configuration changes to the
RP/0/0/CPU0:router(config-if)# commit running configuration file, exits the configuration
session, and returns the router to EXEC mode.
– Entering no exits the configuration session and
returns the router to EXEC mode without
committing the configuration changes.
– Entering cancel leaves the router in the current
configuration session without exiting or
committing the configuration changes.
• Use the commit command to save the configuration
changes to the running configuration file and remain
within the configuration session.
Step 7 exit Exits interface configuration mode and enters global
configuration mode.
Example:
RP/0/0/CPU0:router (config-if)# exit
Step 8 exit Exits global configuration mode and enters EXEC mode.

Example:
RP/0/0/CPU0:router (config)# exit
Step 9 show atm ilmi-status [atm instance] (Optional) Verifies the ILMI configuration for the specified
interface.
Example:
RP/0/0/CPU0:router (config)# show atm
ilmi-status atm 0/6/0/1

Disabling ILMI on an ATM Interface

This task describes the commands you can use to disable ILMI on an ATM interface.

SUMMARY STEPS

1. configure
2. interface atm instance

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-43
 Configuring ATM Interfaces on Cisco IOS XR Software
How to Configure ILMI on ATM Interfaces

3. atm ilmi-config disable

4. end
or
commit
5. exit
6. exit
7. show atm ilmi-status [atm instance]

DETAILED STEPS

Command or Action Purpose

Step 1 configure Enters global configuration mode.

Example:
RP/0/0/CPU0:router# configure
Step 2 interface atm instance Enters ATM interface configuration mode.

Example:
RP/0/0/CPU0:router (config)# interface atm
0/6/0/1
Step 3 atm ilmi-config disable (Optional) Disables ILMI on the ATM interface.
To re-enable ILMI on an ATM interface, use the no atm
Example: ilmi-config disable form of this command.
RP/0/0/CPU0:router (config-if)# atm ilmi-config
disable
Step 4 end Saves configuration changes.
or
• When you issue the end command, the system prompts
commit you to commit changes:
Uncommitted changes found, commit them before
Example: exiting(yes/no/cancel)?
RP/0/0/CPU0:router (config-if)# end [cancel]:
or
– Entering yes saves configuration changes to the
RP/0/0/CPU0:router(config-if)# commit running configuration file, exits the configuration
session, and returns the router to EXEC mode.
– Entering no exits the configuration session and
returns the router to EXEC mode without
committing the configuration changes.
– Entering cancel leaves the router in the current
configuration session without exiting or
committing the configuration changes.
• Use the commit command to save the configuration
changes to the running configuration file and remain
within the configuration session.

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-44 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
Configuration Examples for Configuring ATM on Cisco IOS XR Software

Command or Action Purpose

Step 5 exit Exits interface configuration mode and enters global
configuration mode.
Example:
RP/0/0/CPU0:router (config-if)# exit
Step 6 exit Exits global configuration mode and enters EXEC mode.

Example:
RP/0/0/CPU0:router (config)# exit
Step 7 show atm ilmi-status [atm instance] (Optional) Verifies the ILMI configuration for the specified
interface.
Example:
RP/0/0/CPU0:router (config)# show atm
ilmi-status atm 0/6/0/1

Configuration Examples for Configuring ATM on Cisco IOS XR

Software
This section provides the following configuration examples:
• ATM Interface Bring Up and Configuration: Example, page 45
• Point-To-Point ATM Subinterface Configuration: Example, page 45
• VP-Tunnel Configuration: Example, page 47
• Layer 2 AC Creation and Configuration: Example, page 47
• VC-Class Creation and Configuration: Example, page 48

ATM Interface Bring Up and Configuration: Example

The following example shows how to bring up and configure an ATM interface:
RP/0/0/CPU0:router # configure
RP/0/0/CPU0:router(config)# interface atm 0/6/0/0
RP/0/0/CPU0:router(config-if)# atm address-registration
RP/0/0/CPU0:router(config-if)# no shutdown
RP/0/0/CPU0:router(config-if)# commit

Point-To-Point ATM Subinterface Configuration: Example

The following example shows how to configure a point-to-point ATM subinterface on an ATM main
interface:
RP/0/0/CPU0:router # configure
RP/0/0/CPU0:router (config)# interface atm 0/2/0/2.1 point-to-point
RP/0/0/CPU0:router (config-if)# ipv4 address 10.46.8.6/24
RP/0/0/CPU0:router (config-if)# pvc 0/200
RP/0/0/CPU0:router (config-atm-vc)# commit
RP/0/0/CPU0:router (config-atm-vc)# exit
RP/0/0/CPU0:router (config-if)# exit

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-45
 Configuring ATM Interfaces on Cisco IOS XR Software
Configuration Examples for Configuring ATM on Cisco IOS XR Software

RP/0/0/CPU0:router (config)# exit

RP/0/0/CPU0:router # show interfaces atm 0/2/0/2.1

ATM0/2/0/2.1 is up, line protocol is up

Hardware is ATM network sub-interface(s)
Description: Connect to P4_C12810 ATM 1/2.1
Internet address is 10.46.8.6/24
MTU 4470 bytes, BW 155000 Kbit
reliability Unknown, txload Unknown, rxload Unknown
Encapsulation AAL5/SNAP, controller loopback not set,
Last clearing of "show interface" counters Unknown
Datarate information unavailable.
Interface counters unavailable.

RP/0/0/CPU0:router # show atm interface atm 0/2/0/2

Interface : ATM0/2/0/2
AAL Enabled : AAL5
Max-VP : 254
Max-VC : 2048
Configured VP-Tunnels : 0
Configured PVCs : 4
VP-Tunnels in Down State : 0
PVCs in Down State : 4

Received Side Statistics:

Received Cells : 1691252892
Received Bytes : 480532
Received AAL Packets : 9241

Receive Side Cells Dropped:

Unrecognized VPI/VCI : 64

Receive Side AAL5 Packets Dropped:

Unavailable SAR Buffer : 0
Non-Resource Exhaustion : 0
Reassembly Timeout : 0
CRC-32 Errors : 0
Zero Length : 0

RP/0/0/CPU0:router # show atm pvc 0/200

Detailed display of VC(s) with VPI/VCI = 0/200

ATM0/2/0/0.1: VPI: 0 VCI: 200

CBR, PeakRate: 100000 Kbps
AAL5-LLC/SNAP
OAM frequency: 300 second(s), OAM retry frequency: 1 second(s),
OAM up retry count: 3, OAM down retry count: 5,
OAM Keep-vc-up: False, OAM AIS-RDI failure: None,
OAM AIS-RDI down count: 1, OAM AIS-RDI up time: 3 second(s),
OAM Loopback status: No loopback enabled,
OAM VC state: Loopback verified,
VC is managed by OAM,

OAM cells received: 2290,

F5 InEndLoop: 2290, F5 InSegLoop: 0,
F5 InEndAIS: 0, F5 InSegAIS: 0,
F5 InEndRDI: 0, F5 InSegRDI: 0,
OAM cells sent: 2290,
F5 OutEndLoop: 2290, F5 OutSegLoop: 0,
F5 OutEndAIS: 0, F5 OutSegAIS: 0,
F5 OutEndRDI: 0, F5 OutSegRDI: 0,

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-46 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
Configuration Examples for Configuring ATM on Cisco IOS XR Software

OAM cells drops: 0

InPkts: 2290 OutPkts: 2290

InBytes: 119080 OutBytes: 119080
WRED pkt drop: 0
Non WRED pkt drop: 0

Internal state: READY

Status: UP

VP-Tunnel Configuration: Example

The following example shows how to configure one endpoint of a vp-tunnel on an ATM main interface:
RP/0/0/CPU0:router # configure
RP/0/0/CPU0:router(config)# interface atm 0/6/0/0
RP/0/0/CPU0:router(config-if)# vp-tunnel 10
RP/0/0/CPU0:router(config-atm-vp-tunnel)# shape cbr 150000
RP/0/0/CPU0:router(config-atm-vp-tunnel)# f4oam disable
RP/0/0/CPU0:router(config-atm-vp-tunnel)# commit
RP/0/0/CPU0:router(config-atm-vp-tunnel)# exit
RP/0/0/CPU0:router(config-if)# exit
RP/0/0/CPU0:router(config)# exit
RP/0/0/CPU0:router# show atm vp-tunnel
Data Peak Avg/Min Burst
Interface VPI SC VCs Kbps Kbps Cells Status

ATM0/2/0/3 30 UBR 2 155000 N/A N/A UP

The following example shows how to create and configure an ATM subinterface and PVC on one
endpoint of a a vp-tunnel, and then verify connectivity through that vp-tunnel:
RP/0/0/CPU0:router # configure
RP/0/0/CPU0:router(config)# interface atm 0/6/0/0.16 point-to-point
RP/0/0/CPU0:router(config-subif)# pvc 10/100
RP/0/0/CPU0:router (config-atm-vc)# commit
RP/0/0/CPU0:router (config-subif)# exit
RP/0/0/CPU0:router (config)# exit
RP/0/0/CPU0:router # ping atm interface atm 0/6/0/0.16 10/100

Sending 5, 53-byte end-to-end OAM echos, timeout is 2 seconds:

!!!!!
Success rate is 100 percent (5/5), round-trip min/avg/max = 1/3/4 ms

Layer 2 AC Creation and Configuration: Example

The following example shows how to create and configure one endpoint of a Layer 2 port mode AC:
RP/0/0/CPU0:router# configure
RP/0/0/CPU0:router (config)# interface atm 0/6/0/1
RP/0/0/CPU0:router (config-if)# l2transport
RP/0/0/CPU0:router (config-if-l2)# cell-packing 6 1
RP/0/0/CPU0:router(config-if-l2)# commit

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-47
 Configuring ATM Interfaces on Cisco IOS XR Software
Configuration Examples for Configuring ATM on Cisco IOS XR Software

The following example shows how to create and configure an AC on a Layer 2 subinterface with a PVC:
RP/0/0/CPU0:router# configure
RP/0/0/CPU0:router(config)# interface atm 0/1/0/0.230 l2transport
RP/0/0/CPU0:router(config-if)# pvc 15/230
RP/0/0/CPU0:router(config-atm-l2transport-pvc)# encapsulation aal0
RP/0/0/CPU0:router(config-atm-l2transport-pvc)# cell-packing 5 2
RP/0/0/CPU0:router(config-atm-l2transport-pvc)# shape cbr 622000
RP/0/0/CPU0:router(config-atm-l2transport-pvc)# commit
RP/0/0/CPU0:router(config-atm-l2transport-pvc)#
RP/0/0/CPU0:router(config-if)# exit
RP/0/0/CPU0:router(config)# exit
RP/0/0/CPU0:router# show atm pvc

Peak Avg/Min Burst

Interface VPI VCI Type Encaps SC Kbps Kbps Cells Sts
ATM0/1/0/0.230 15 230 PVC AAL0 UBR 622000 N/A N/A UP
ATM0/1/0/3.19 17 19 PVC SNAP UBR 622000 N/A N/A UP

The following example shows how to create and configure an AC on an ATM subinterface with a PVP:
RP/0/0/CPU0:router# configure
RP/0/0/CPU0:router(config)# interface atm 0/6/0/1.10 l2transport
RP/0/0/CPU0:router(config-if)# pvp 100
RP/0/0/CPU0:router(config-atm-l2transport-pvp)# cell-packing 5 2
RP/0/0/CPU0:router(config-atm-l2transport-pvp)# shape ubr 155000
RP/0/0/CPU0:router(config-atm-l2transport-pvp)# commit

RP/0/0/CPU0:router# show atm pvp interface atm 0/6/0/1

Peak Avg/Min Burst

Interface VPI SC Kbps Kbps Cells Sts
ATM0/6/0/1.10 100 UBR 155000 N/A N/A UP

VC-Class Creation and Configuration: Example

The following example shows how to configure a vc-class:
RP/0/0/CPU0:router # configure
RP/0/0/CPU0:router(config)# vc-class atm atm-class-1
RP/0/0/CPU0:router(config-vc-class-atm)# encapsulation aal5snap
RP/0/0/CPU0:router(config-vc-class-atm)# oam ais-rdi 25 5
RP/0/0/CPU0:router(config-vc-class-atm)# oam retry 5 10 5
RP/0/0/CPU0:router(config-vc-class-atm)# oam-pvc manage 300
RP/0/0/CPU0:router(config-vc-class-atm)# shape cbr 100000
RP/0/0/CPU0:router(config-vc-class-atm)# commit

The following example shows how to attach a vc-class to an ATM main interface:
RP/0/0/CPU0:router # configure
RP/0/0/CPU0:router(config)# interface ATM0/2/0/0.1 point-to-point
RP/0/0/CPU0:router (config-if)# class-int atm-class-1
RP/0/0/CPU0:router (config-if)# commit

The following example shows how to attach a vc-class to an ATM subinterface:

RP/0/0/CPU0:router # configure
RP/0/0/CPU0:router(config)# interface ATM0/2/0/0.1 point-to-point
RP/0/0/CPU0:router(config-if)# pvc 10/100
RP/0/0/CPU0:router (config-atm-vc)# class-vc atm-class-1
RP/0/0/CPU0:router (config-atm-vc)# commit

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-48 OL-14352-03
Configuring ATM Interfaces on Cisco IOS XR Software
Configuration Examples for Configuring ATM on Cisco IOS XR Software

The following example shows how to display information about a specific ATM vc-class:
RP/0/0/CPU0:router # show atm vc-class atm-class-1
ATM vc-class atm-class-1

encapsulation - aal5snap
shape - cbr 100000
oam ais-rdi - not configured
oam retry - not configured
oam-pvc - manage 300

The following example shows how to display configuration information for the parameters on a virtual
circuit (VC) class that is associated with a particular PVC:
RP/0/0/CPU0:router # show atm class-link 10/100

Detailed display of VC(s) with VPI/VCI = 10/100

Class link for VC 10/100

ATM0/2/0/0.1: VPI: 10 VCI: 100
shape : cbr 100000 (VC-class configured on VC)
encapsulation : aal5snap (VC-class configured on VC)
oam-pvc : manage 300 (VC-class configured on VC)
oam retry : 3 5 1 (Default value)
oam ais-rdi : 1 3 (Default value)

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-49
 Configuring ATM Interfaces on Cisco IOS XR Software
Additional References

Additional References
The following sections provide references related to implementing ATM for Cisco IOS XR software.

Related Documents
Related Topic Document Title
ATM commands: complete command syntax, Cisco IOS XR Interface and Hardware Command Reference
command modes, command history, defaults, usage
guidelines, and examples

Standards
Standards Title
No new or modified standards are supported by this —
feature, and support for existing standards has not been
modified by this feature.

MIBs

MIBs MIBs Link

— To locate and download MIBs using Cisco IOS XR software, use the
Cisco MIB Locator found at the following URL and choose a
platform under the Cisco Access Products menu:
http://cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-50 OL-14352-03
 Configuring ATM Interfaces on Cisco IOS XR Software
Additional References

RFCs
RFCs Title
RFC 1483 Multiprotocol Encapsulation over ATM Adaptation Layer 5
RFC 1577 Classical IP and ARP over ATM.
RFC 2225 Classical IP and ARP over ATM
RFC 2255 The LDAP URL Format
RFC 2684 Multiprotocol Encapsulation over ATM Adaptation Layer 5.
RFC 4385 Pseudowire Emulation Edge-to-Edge (PWE3) Control Word for Use
over an MPLS PSN
RFC 4717 Encapsulation Methods for Transport of Asynchronous Transfer
Mode (ATM) over MPLS Networks
RFC 4816 Pseudowire Emulation Edge-to-Edge (PWE3) Asynchronous
Transfer Mode (ATM) Transparent Cell Transport Service

Technical Assistance
Description Link
The Cisco Technical Support website contains http://www.cisco.com/techsupport
thousands of pages of searchable technical content,
including links to products, technologies, solutions,
technical tips, and tools. Registered Cisco.com users
can log in from this page to access even more content.

Cisco IOS XR Interface and Hardware Component Configuration Guide

OL-14352-03 HC-51
 Configuring ATM Interfaces on Cisco IOS XR Software
Additional References

Cisco IOS XR Interface and Hardware Component Configuration Guide

HC-52 OL-14352-03