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 virtual cicuit (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 .
Your software release may not support all the features documented in this module. For the latest caveats and feature information, see
Bug Search Tool and the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the feature information table at the end of this module.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to
www.cisco.com/go/cfn. An account on Cisco.com is not required.
Restrictions for Local Template-Based ATM Provisioning
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 andnoshutdown 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
Configuring ATM PVC Local Autoprovisioning in a VC Class
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.
To enable ATM PVC local autoprovisioning in a VC class, use the following commands.
SUMMARY STEPS
1.enable
2.configureterminal
3.vc-classatmvc-class-name
4.createon-demand
5.idle-timeoutseconds
[minimum-rate
]
6.end
DETAILED STEPS
Command or Action
Purpose
Step 1
enable
Example:
Router> enable
Enables privileged EXEC mode.
Enter your password if prompted.
Step 2
configureterminal
Example:
Router# configure terminal
Enters global configuration mode.
Step 3
vc-classatmvc-class-name
Example:
Router(config)# vc-class atm vctest
Creates a VC class for an ATM PVC, SVC, or ATM interface and enters ATM VC class configuration mode.
Step 4
createon-demand
Example:
Router(config-vc-class)# create on-demand
Configures ATM PVC autoprovisioning, which enables a PVC or range of PVCs to be created automatically on demand.
Step 5
idle-timeoutseconds
[minimum-rate
]
Example:
Router(config-vc-class)# idle-timeout 10
(Optional) Configures the idle timeout parameter for tearing down ATM SVC connections or autoprovisioned ATM PVC connections.
Step 6
end
Example:
Router(config-vc-class)# end
Returns to privliged EXEC mode.
Configuring ATM PVC Local Autoprovisioning on a PVC
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.
To enable ATM PVC local autoprovisioning on a PVC, use the following commands.
SUMMARY STEPS
1.enable
2.configureterminal
3.interfaceatmslot/port
4.atmautovcretryinterval
5.pvc [name] vpi/vci
6.createon-demand
7.idle-timeoutseconds [minimum-rate]
8.end
DETAILED STEPS
Command or Action
Purpose
Step 1
enable
Example:
Router> enable
Enables privileged EXEC mode.
Enter your password if prompted.
Step 2
configureterminal
Example:
Router# configure terminal
Enters global configuration mode.
Step 3
interfaceatmslot/port
Example:
Router(config)# interface atm 2/0
Configures an ATM interface and enters interface configuration moed.
Step 4
atmautovcretryinterval
Example:
Router(config-if)# atm autovc retry 32
(Optional) Configures the interval at which the router will repeat the attempt to create autoprovisioned PVCs after a failure of the initial creation attempt.
Step 5
pvc [name] vpi/vci
Example:
Router(config-if)# pvc vctest 32/3
Creates an ATM PVC and enters ATM virtual circuit configuration mode.
Step 6
createon-demand
Example:
Router(config-if-atm-vc)# create on-demand
Configures ATM PVC autoprovisioning, which enables a PVC or range of PVCs to be created automatically on demand.
Step 7
idle-timeoutseconds [minimum-rate]
Example:
Router(config-if-atm-vc)# idle-timeout 12
(Optional) Configures the idle timeout parameter for tearing down ATM SVC connections or autoprovisioned ATM PVC connections.
Step 8
end
Example:
Router(config-if-atm-vc)# end
Returns to privileged EXEC mode.
Configuring ATM PVC Local Autoprovisioning on an ATM PVC Range
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.
To enable ATM PVC autoprovisioning on an ATM PVC range, use the following commands.
Configures an ATM interface and enters interface configuration mode.
Step 4
atmautovcretryinterval
Example:
Router(config-if)# atm autovc retry 12
(Optional) Configures the interval at which the router will repeat the attempt to create autoprovisioned PVCs after a failure of the initial creation attempt.
Step 5
range [range-name] pvcstart-vpi/start-vciend-vpi/end-vci
Example:
Router(config-if)# range pvc pvctest 2/3 4/6
Defines a range of ATM PVCs and enters ATM PVC range configuration mode.
Step 6
createon-demand
Example:
Router(config-if-atm-range)# create on-demand
Configures ATM PVC autoprovisioning, which enables a PVC or range of PVCs to be created automatically on demand.
Step 7
idle-timeoutseconds
[minimum-rate
]
Example:
Router(config-if-atm-range)# idle-timeout 12
(Optional) Configures the idle timeout parameter for tearing down ATM SVC connections or autoprovisioned ATM PVC connections.
Step 8
end
Example:
Router(config-if-atm-range)# end
Returns to privileged EXEC mode.
Configuring ATM PVC Local Autoprovisioning on PVC Within a Range
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.
To enable ATM PVC autoprovisioning on a PVC within an ATM PVC range, use the following commands.
Configures an ATM interface and enters interface configuration mode.
Step 4
atmautovcretryinterval
Example:
Router(config-if)# atm autovc retry 23
(Optional) Configures the interval at which the router will repeat the attempt to create autoprovisioned PVCs after a failure of the initial creation attempt.
Step 5
range [range-name] pvcstart-vpi/start-vciend-vpi/end-vci
Example:
Router(config-if)# range range1 pvc 2/4 5/6
Defines a range of ATM PVCs and enters ATM PVC range configuration mode.
Step 6
pvc-in-range[pvc-name
] [[vpi/]vci
]
Example:
Router(config-if-atm-range)# pvc-in-range pvc1
Defines an individual PVC within a PVC range and enables PVC-in-range configuration mode.
Step 7
createon-demand
Example:
Router(config-if-atm-range-pvc)# create on-demand
Configures ATM PVC autoprovisioning, which enables a PVC or range of PVCs to be created automatically on demand.
Step 8
idle-timeoutseconds
[minimum-rate
]
Example:
Router(config-if-atm-range-pvc)# idle-timeout 10
(Optional) Configures the idle timeout parameter for tearing down ATM SVC connections or autoprovisioned ATM PVC connections.
Step 9
end
Example:
Router(config-if-atm-range-pvc)# end
Returns to privileged EXEC mode.
Verifying ATM PVC Autoprovisioning
To verify that ATM PVC local autoprovisioning is configured and working correctly, perform the tasks in the following steps:
SUMMARY STEPS
1.
Enter the showrunning-config command to verify that the configuration is correct.
2.
Enter the showatmpvc command. PVCs that have been autoprovisioned will have the value "PVC-A" ("A" stands for automatic) in the Type field.
3.
Enter the showatmpvc 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.
DETAILED STEPS
Step 1
Enter the showrunning-config command to verify that the configuration is correct.
Step 2
Enter the showatmpvc command. PVCs that have been autoprovisioned will have the value "PVC-A" ("A" stands for automatic) in the Type field.
Example:
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 showatmpvc 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.
The Cisco Support website provides extensive online resources, including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies.
To receive security and technical information about your products, you can subscribe to various services, such as the Product Alert Tool (accessed from Field Notices), the Cisco Technical Services Newsletter, and Really Simple Syndication (RSS) Feeds.
Access to most tools on the Cisco Support website requires a Cisco.com user ID and password.
Feature Information for Local Template-Based ATM PVC Provisioning
The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to
www.cisco.com/go/cfn. An account on Cisco.com is not required.
Table 1
Feature Information for Local Template-Based ATM PVC Provisioning
Feature Name
Releases
Feature Information
Local Template-Based ATM PVC Provisioning
12.2(15)B 15.0(1)M 12.2(28)SB 12.2(33)SRE
The Local Template-Based ATM Provisioning feature enables ATM permanent virtual circuits (PVCs) to be provisioned automatically as needed from a local configuration.
This feature was introduced in Cisco IOS Release 12.2(15)B and integrated into Cisco IOS Release 12.2(28)SB, Cisco IOS Release 15.0(1)M and Cisco IOS Release 2.2(33)SRE.
The following commands were introduced or modified:
atmautovcretry,
createon-demand,
debugatmautovc,idle-timeout
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL:
www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.