Table Of Contents
Local Template-Based ATM PVC Provisioning
Information About Local Template-Based ATM Provisioning
How to Configure Local Template-Based ATM Provisioning
Configuring ATM PVC Local Autoprovisioning in a VC Class
Configuring ATM PVC Local Autoprovisioning on a PVC
Configuring ATM PVC Local Autoprovisioning on an ATM PVC Range
Configuring ATM PVC Local Autoprovisioning on PVC Within a Range
Verifying ATM PVC Autoprovisioning
Monitoring and Maintaining ATM PVC Local Autoprovisioning
ATM PVC Local Autoprovisioning on an ATM Interface Example
ATM PVC Local Autoprovisioning on a PVC Example
ATM PVC Local Autoprovisioning on an ATM PVC Range Example
ATM PVC Local Autoprovisioning on a PVC Within a Range Example
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 Modification12.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
•Information About Local Template-Based ATM Provisioning
•How to Configure Local Template-Based ATM Provisioning
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.
ATM PVC local autoprovisioning supports the following applications: PPP over ATM, PPP over Ethernet, ATM routed bridge encapsulation, and routed RFC 1483.
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.
•Configuring ATM PVC Local Autoprovisioning in a VC Class
•Configuring ATM PVC Local Autoprovisioning on a PVC
•Configuring ATM PVC Local Autoprovisioning on an ATM PVC Range
•Configuring ATM PVC Local Autoprovisioning on PVC Within a Range
•Verifying ATM PVC Autoprovisioning
•Monitoring and Maintaining ATM PVC Local Autoprovisioning
Configuring ATM PVC Local Autoprovisioning in a VC Class
To enable ATM PVC local autoprovisioning in a VC class, use the following commands beginning in global configuration mode:
A VC class configured with ATM PVC autoprovisioning can be assigned to an ATM interface, an ATM PVC, an ATM PVC range, and an ATM PVC with a range.
Note If a VC class that is configured with ATM PVC autoprovisioning is assigned to an ATM interface, all PVCs on the interface will be autoprovisioned.
Configuring ATM PVC Local Autoprovisioning on a PVC
To enable ATM PVC local autoprovisioning on a PVC, use the following commands beginning in global configuration mode:
ATM PVC local autoprovisioning can also be configured on a PVC by assigning a VC class that has been configured with ATM PVC local autoprovisioning to the PVC.
Configuring ATM PVC Local Autoprovisioning on an ATM PVC Range
To enable ATM PVC autoprovisioning on an ATM PVC range, use the following commands beginning in global configuration mode:
ATM PVC local autoprovisioning can also be configured on a range by assigning a VC class that has been configured with ATM PVC local autoprovisioning to the range.
Configuring ATM PVC Local Autoprovisioning on PVC Within a Range
To enable ATM PVC autoprovisioning on a PVC within an ATM PVC range, use the following commands beginning in global configuration mode:
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 BurstInterface Name VPI VCI Type Encaps SC Kbps Kbps Cells Sts5/0.1 117 0 50 PVC-A SNAP UBR 149760 UP5/0.1 118 0 51 PVC-A SNAP UBR 149760 UP5/0.1 119 0 52 PVC-A SNAP UBR 149760 UPStep 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.
Router# show atm pvc 0/51
ATM5/0.1: VCD: 118, VPI: 0, VCI: 51UBR, PeakRate: 149760AAL5-LLC/SNAP, etype:0x0, Flags: 0x20000C20, VCmode: 0x0OAM frequency: 0 second(s), OAM retry frequency: 1 second(s), OAM retry frequency: 1 second(s)OAM up retry count: 3, OAM down retry count: 5OAM Loopback status: OAM DisabledOAM VC state: Not ManagedILMI VC state: Not ManagedInARP frequency: 15 minutes(s)Transmit priority 4InPkts: 0, OutPkts: 0, InBytes: 0, OutBytes: 0InPRoc: 0, OutPRoc: 0, Broadcasts: 0InFast: 0, OutFast: 0, InAS: 0, OutAS: 0InPktDrops: 0, OutPktDrops: 0CrcErrors: 0, SarTimeOuts: 0, OverSizedSDUs: 0, LengthViolation: 0, CPIErrors: 0Out CLP=1 Pkts: 0OAM cells received: 0F5 InEndloop: 0, F5 InSegloop: 0, F5 InAIS: 0, F5 InRDI: 0F4 InEndloop: 0, F4 InSegloop: 0, F4 InAIS: 0, F4 InRDI: 0OAM cells sent: 0F5 OutEndloop: 0, F5 OutSegloop: 0, F5 OutRDI: 0F4 OutEndloop: 0, F4 OutSegloop: 0, F4 OutRDI: 0OAM cell drops: 0Status: UPPPP: Virtual-Access3 from Virtual-Template1VC Auto Creation Enabled: local
Monitoring and Maintaining ATM PVC Local Autoprovisioning
To monitor and maintain ATM PVC autoprovisioning, use one or more of the following commands in privileged EXEC mode:
Configuration Examples
This section provides the following configuration examples:
•ATM PVC Local Autoprovisioning on an ATM Interface Example
•ATM PVC Local Autoprovisioning on a PVC Example
•ATM PVC Local Autoprovisioning on an ATM PVC Range Example
•ATM PVC Local Autoprovisioning on a PVC Within a Range Example
ATM PVC Local Autoprovisioning on an ATM Interface Example
In the following example, local autoprovisioning is enabled on all PVCs on ATM interface 5/0.
vc-class atm auto-pppoevbr-nrt 1000 100protocol pppoecreate on-demandidle-timeout 300 10!interface atm 5/0class-int auto-pppoeatm autovc retry 10ATM PVC Local Autoprovisioning on a PVC Example
The following example shows the configuration of local autoprovisioning on a PVC:
interface atm 5/0pvc 1/300create on-demandidle-timeout 300 10
ATM PVC Local Autoprovisioning on an ATM PVC Range Example
The following example shows the configuration of local autoprovisioning on an ATM PVC range called "auto":
interface atm 5/0range auto pvc 0/100 1/200create on-demandATM PVC Local Autoprovisioning on a PVC Within a Range Example
The following example shows the configuration of local autoprovisioning on a PVC within a PVC range:
interface atm 5/0range auto pvc 0/100 1/200pvc-in-range 0/101create on-demandAdditional References
The following sections provide references related to local template-based ATM PVC provisioning.
Related Documents
Related Topic Document TitleATM PVC configuration
Cisco IOS Wide-Area Networking Configuration Guide, Release 12.2
ATM commands
Cisco IOS Wide-Area Networking Command Reference, Release 12.2
Standards
MIBs
MIB MIBs LinkNone
To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:
RFCs
Technical Assistance
Command Reference
This section documents new and modified commands only.
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
Command Default
The retry interval is one minute.
Command Modes
Interface configuration
Command History
Release Modification12.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-pppoevbr-nrt 1000 100protocol pppoecreate on-demandidle-timeout 300 10interface atm 5/0class-int auto-pppoeatm autovc retry 5Related Commands
Command Descriptioncreate 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.
create on-demand
no create on-demand
default create on-demand
Syntax Description
This command has no arguments or keywords.
Command Default
ATM PVC autoprovisioning is not enabled.
Command Modes
ATM VC configuration
ATM PVC range configuration
ATM PVC-in-range configuration
ATM VC class configurationCommand History
Release Modification12.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-pppoevbr-nrt 1000 100protocol pppoecreate on-demandidle-timeout 300 10interface atm 5/0class-int auto-pppoeatm autovc retry 5Related Commands
Command Descriptiondebug 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 Modification12.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 allAutoVC all debugging is onRouter#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.00:09:03:AutoVC(ATM1/0):process VC 1/101! PVC 1/101 is in the process of being autoprovisioned.00:09:03:AutoVC(ATM1/0.1):bring up vc 1/101! PVC 1/101 is being brought up.00:09:03:%ATM-5-UPDOWN:Interface ATM1/0.1, Changing autovc 1/101 to UP! This message indicates that the PVC was brought up successfully.Related Commands
Command Descriptioncreate 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 Default
Default idle timeout for SVCs: 300 seconds.
Default idle timeout for autoprovisioned PVCs: 0 seconds
Default minimum-rate: 0 kbps
Command Modes
ATM virtual circuit configuration (for ATM permanent virtual circuits [PVCs] or SVCs)
VC-class configuration (for virtual circuit [VC] classes)Command History
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 5The following example shows the idle timeout configured for an autoprovisioned PVC:
interface atm 5/0pvc 1/300create on-demandidle-timeout 300 10Related Commands
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.
© 2003, 2006 Cisco Systems, Inc. All rights reserved.