Local Template-Based ATM PVC Provisioning

The Local Template-Based ATM Provisioning feature enables ATM permanent virtual circuits (PVCs) to be provisioned automatically as needed from a local configuration. ATM PVC autoprovisioning can be configured on a PVC, an ATM PVC range, or a VC class. If a VC class configured with ATM PVC autoprovisioning is assigned to an interface, all the PVCs on that interface will be autoprovisioned; this configuration is sometimes referred to as an infinite range.

Feature History

Release

Modification

12.2(15)B

This feature was introduced.

12.2(28)SB

This feature was integrated into Cisco IOS Release 12.2(28)SB.

Finding Support Information for Platforms and Cisco IOS Software Images

Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at the login dialog box and follow the instructions that appear.

Contents

Restrictions

The number of PVCs that can be established on an interface that is configured as an infinite range is limited to the maximum number of VCs that the platform can support.

Information About Local Template-Based ATM Provisioning

Autoprovisioned ATM PVCs are not created until there is activity on the virtual path identifier (VPI)/virtual channel identifier (VCI) pair. When the interface is disabled and reenabled using the shutdown and no shutdown commands, autoprovisioned PVCs that are part of a PVC range or infinite range are removed upon shutdown and are not reestablished until the first incoming packet triggers PVC creation. During router reload, autoprovisioned PVCs are created when there is activity on the connection.

The total number of VCs that can be configured on an ATM port adapter is limited by the capacity of port adapter. In cases of ATM link oversubscription, where a PVC range or infinite range is configured to provision more PVCs than the port adapter allows, the PVCs can be configured with a timeout so that they can be dynamically brought down as needed. When the timeout expires, the idle PVCs are removed, allowing the PVC range or infinite range of PVCs to share system resources.

The Local Template-Based ATM Provisioning feature enables ATM PVCs to be created automatically as needed from a local configuration, making the provisioning of large numbers of digital subscriber line (DSL) subscribers easier, faster, and less prone to error.

How to Configure Local Template-Based ATM Provisioning

See the following sections for configuration tasks for the Local Template-Based ATM Provisioning feature. One or more of the first four tasks is required. The last task is optional.

ATM PVC local autoprovisioning can also be configured on a PVC within a range by assigning a VC class that has been configured with ATM PVC local autoprovisioning to the PVC.

Verifying ATM PVC Autoprovisioning

To verify that ATM PVC local autoprovisioning is configured and working correctly, perform the tasks in the following steps:

Step 1 Enter the show running-config command to verify that the configuration is correct.

Step 2 Enter the show atm pvc command. PVCs that have been autoprovisioned will have the value "PVC-A" ("A" stands for automatic) in the Type field.

Router# show atm pvc

VCD / Peak Avg/Min Burst

Interface Name VPI VCI Type Encaps SC Kbps Kbps Cells Sts

5/0.1 117 0 50 PVC-A SNAP UBR 149760 UP

5/0.1 118 0 51 PVC-A SNAP UBR 149760 UP

5/0.1 119 0 52 PVC-A SNAP UBR 149760 UP

Step 3 Enter the show atm pvc command with the vpi/vci arguments to see if ATM PVC local autoprovisioning is configured on a specific PVC. If ATM PVC local autoprovisioning is configured, the text "VC Auto Creation Enabled: local" will appear in the output.

MIBs

RFCs

RFC

Title

None

—

Technical Assistance

Description

Link

The Cisco Technical Support & Documentation website contains 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.

Command Reference

atm autovc retry

To configure the intervals at which a router will repeat the attempt to create autoprovisioned PVCs after a failure of the initial attempt at creation fails, use the atm autovc retry command in interface configuration mode. To reset the retry interval to the default, use the no form of this command.

atm autovc retry interval

no atm autovc retry interval

Syntax Description

interval

Interval, in minutes, at which the router will repeat the attempt to create autoprovisioned PVCs after the initial attempt at creation fails. The range is from 1 to 60 minutes. The default is one minute.

Command Default

The retry interval is one minute.

Command Modes

Interface configuration

Command History

Release

Modification

12.2(15)B

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

Usage Guidelines

Use the atm autovc retry command to configure the retry interval for autoprovisioned ATM PVCs.

Examples

In the following example, local autoprovisioning is enabled on all PVCs on ATM interface 5/0. The retry interval is 5 minutes.

vc-class atm auto-pppoe

vbr-nrt 1000 100

protocol pppoe

create on-demand

idle-timeout 300 10

interface atm 5/0

class-int auto-pppoe

atm autovc retry 5

Related Commands

Command

Description

create on-demand

Configures ATM PVC autoprovisioning, which enables a PVC or range of PVCs to be created automatically on demand.

create on-demand

To configure ATM PVC autoprovisioning, which enables a PVC or range of PVCs to be created automatically on demand, use the create on-demand command in the appropriate mode. To disable ATM PVC autoprovisioning, use the no form of this command. To disable ATM PVC autoprovisioning but allow inheritance of PVC parameters, use the default version of this command.

Command Default

Command Modes

Command History

Release

Modification

12.2(15)B

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

Usage Guidelines

The create on-demand command follows existing VC class inheritance rules. This means that if the command is not explicitly configured on an ATM VC, the VC will inherit the configuration from VC classes in the following order:

•From a VC class assigned to the VC itself

•From a VC class assigned to the VC's ATM subinterface

•From a VC class assigned to the VC's ATM main interface

Examples

In the following example, local autoprovisioning is enabled on all PVCs on ATM interface 5/0:

vc-class atm auto-pppoe

vbr-nrt 1000 100

protocol pppoe

create on-demand

idle-timeout 300 10

interface atm 5/0

class-int auto-pppoe

atm autovc retry 5

Related Commands

Command

Description

debug atm autovc

Displays information about autoprovisioned ATM PVC events and errors.

debug atm autovc

To display information about autoprovisioned ATM PVC events and errors, use the debug atm autovc command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug atm autovc {event|error|all}

no debug atm autovc

Syntax Description

event

Displays all autoprovisioned PVC events.

error

Displays all autoprovisioned PVC errors.

all

Displays all autoprovisioned PVC events and errors.

Command Default

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release

Modification

12.2(15)B

This command was introduced.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

Examples

The following is sample output for the debug atm autovc command:

Router# debug atm autovc all

AutoVC all debugging is on

Router#

00:09:03:AutoVC(ATM1/0):1/101 enqueued

! There is incoming traffic on PVC 1/101 and the pvc is enqueued to be processed.

Related Commands

Command

Description

create on-demand

Configures ATM PVC autoprovisioning, which enables a PVC or range of PVCs to be created automatically on demand.

idle-timeout

To configure the idle timeout parameter for tearing down an ATM switched virtual circuit (SVC) connection or autoprovisioned ATM PVC connections, use the idle-timeout command in the appropriate mode. To disable the timeout parameter, use the no form of this command.

idle-timeout seconds [minimum-rate]

no idle-timeout seconds [minimum-rate]

Syntax Description

seconds

Number of seconds that the VC is idle, after which the ATM VC is disconnected.

minimum-rate

(Optional) Minimum traffic rate, in kbps, required on an ATM SVC to maintain the SVC connection.

Command History

This command was modified to configure idle timeout parameters for autoprovisioned ATM PVCs.

12.2(28)SB

This command was modified to configure idle timeout parameters for autoprovisioned ATM PVCs.

Usage Guidelines

If, within the idle timeout period, both the input and output traffic rates are below the minimum rate, the VC connection is torn down. The input and output traffic rates are set using the ubr, ubr+, or vbr-nrt command.

If the idle-timeout command is not explicitly configured on an ATM VC, the VC inherits the following default configuration (listed in order of next highest precedence):

•Configuration of the idle-timeout command in a VC class assigned to the VC itself.

•Configuration of the idle-timeout command in a VC class assigned to the VC's ATM subinterface.

•Configuration of the idle-timeout command in a VC class assigned to the VC's ATM main interface.

•Global default—The global idle timeout default is the value set using the idle-timeout interface configuration command. If the idle-timeout command is not configured, the default idle timeout is 300 seconds for SVCs and 0 seconds for autoprovisioned PVCs, and the minimum rate is 0 kbps.

Examples

The following example shows how to configure an ATM SVC connection to become inactive after an idle period of 300 seconds. The SVC connection is also configured so that it is considered to be inactive if the traffic rate is less than 5 kbps.

idle-timeout 300 5

The following example shows the idle timeout configured for an autoprovisioned PVC:

interface atm 5/0

pvc 1/300

create on-demand

idle-timeout 300 10

Related Commands

Command

Description

create on-demand

Configures ATM PVC autoprovisioning, which enables a PVC or range of PVCs to be created automatically on demand.

Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.