Table Of Contents
Prerequisites for Using the PPPoE Client DDR Idle-Timer
Information About the PPPoE Client DDR Idle-Timer
DDR Functionality and the PPPoE Client
How to Configure the PPPoE Client DDR Idle-Timer
Configure the PPPoE Client DDR Idle Timer on an ATM PVC Interface
Configure the PPPoE Client DDR Idle Timer on an Ethernet Interface
Configure the Dialer Interface
Configuration Examples for PPPoE Client DDR Idle-Timer
PPPoEoA Client Configuration Example
PPPoEoE Client Configuration Example
PPPoE Client DDR Idle Timer
The PPPoE Client DDR Idle Timer feature supports the dial-on-demand routing (DDR) interesting traffic control list functionality of the dialer interface with a PPP over Ethernet (PPPoE) client, but also keeps original functionality (PPPoE connection up and always on after configuration) for those PPPoE clients that require it.
Feature Specifications for the PPPoE Client DDR Idle Timer Feature
Feature History Release Modification12.2(13)T
This feature was introduced.
12.2(27)SBA
This feature was integrated into Cisco IOS Release 12.2(27)SBA.
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
•Prerequisites for Using the PPPoE Client DDR Idle-Timer
•Information About the PPPoE Client DDR Idle-Timer
•How to Configure the PPPoE Client DDR Idle-Timer
•Configuration Examples for PPPoE Client DDR Idle-Timer
Prerequisites for Using the PPPoE Client DDR Idle-Timer
Before configuring the PPPoE Client DDR Idle Timer feature, you must understand the concept of DDR interesting packets and access control lists and PPPoE Stage Protocols. See the "Additional References" section for links to the documents describing these concepts.
Information About the PPPoE Client DDR Idle-Timer
To configure the PPPoE client DDR idle-timer, you need to understand the following concept:
•DDR Functionality and the PPPoE Client
DDR Functionality and the PPPoE Client
Before Cisco IOS Release 12.2(13)T, the DDR interesting traffic control list functionality of the dialer interface was not supported for PPPoE. However, the PPPoE Client DDR Idle Timer feature, available as part of Cisco IOS Release 12.2(13)T, now supports this DDR functionality for a PPPoE client.
Protocol access lists and dialer access lists are central to the operation of DDR. Access lists are used as the screening criteria for determining when to initiate DDR calls. All packets are tested against the dialer access list. Packets that match a permit entry are deemed interesting. Packets that do not match a permit entry or that do match a deny entry are deemed uninteresting. When a packet is found to be interesting, either the dialer idle timer is reset (if the line is active) or a connection is attempted (assuming the line is available but not active). If a tested packet is deemed uninteresting, it will be forwarded if it is intended for a destination known to be on a specific interface and the link is active. However, such a packet will not initiate a DDR call and will not reset the idle timer. If dialer idle timer expires, the dialer interface calls a PPPoE function to tear down the connection.
A new command, pppoe-client dial-pool-number, allows configuring a DDR interesting traffic control list for PPPoE connections, but also keeps original connection functionality for those PPPoE clients that require it. If you do not require DDR, the PPPoE connection will be up and always on after configuration. If you do require DDR functionality, the connection will be brought up when interesting traffic comes in from the LAN interface and brought down after the dialer idle timer expires. Interesting traffic that comes from WAN interface will only reset the dialer idle timer.
Protocol access lists and dialer access lists have already been implemented in the dialer interface for the operation of DDR. For a PPPoE client, access lists are used as the screening criteria for determining if PPPoE Discovery initiation or a dialer idle timer reset is needed. But a protocol access list is not required for this feature; it depends on your network needs. An access-list can be configured and associated with dialer-list, or you can configure only the dialer list.
All packets destined to the dialer interface are tested against the dialer access list. Packets that match a permit entry are deemed interesting. Packets that do not match a permit entry or that do match a deny entry are deemed uninteresting. When a packet is found to be interesting, the dialer idle timer will be reset if the PPPoE session has already been set up, or a PPPoE Discovery will be attempted if there is no PPPoE session. If a tested packet is deemed uninteresting, it will not initiate PPPoE Discovery and will not reset the idle timer.
How to Configure the PPPoE Client DDR Idle-Timer
This section contains the following procedures. Each procedure is identified as either required or optional.
•Configure the PPPoE Client DDR Idle Timer on an ATM PVC Interface (required)
•Configure the PPPoE Client DDR Idle Timer on an Ethernet Interface (required)
•Configure the Dialer Interface (required)
Configure the PPPoE Client DDR Idle Timer on an ATM PVC Interface
To configure the PPPoE Client DDR Idle Timer in interface-ATM-VC configuration mode, use the following commands:
SUMMARY STEPS
1. enable
2. configure {terminal | memory | network}
3. interface atm atm-interface-number
4. pvc vpi/vci
5. pppoe-client dial-pool-number number [dial-on-demand]
6. exit
DETAILED STEPS
What to Do Next
To support DDR functionality for the PPPoE client, DDR functionality must be configured. See the "Configure the Dialer Interface" section for the steps to do this.
Configure the PPPoE Client DDR Idle Timer on an Ethernet Interface
To configure the PPPoE Client DDR Idle Timer on an Ethernet interface, use the following commands:
SUMMARY STEPS
1. enable
2. configure {terminal | memory | network}
3. interface ethernet ethernet-number
4. pppoe enable
5. pppoe-client dial-pool-number number [dial-on-demand]
DETAILED STEPS
What to Do Next
To support DDR functionality for the PPPoE client, DDR functionality must be configured. See the "Configure the Dialer Interface" section for the steps to do this.
Configure the Dialer Interface
To configure the dialer interface (required when using the pppoe-client dial-pool-number command), you must also configure the following commands:
SUMMARY STEPS
1. enable
2. configure {terminal | memory | network}
3. interface dialer dialer-rotary-group-number
4. dialer idle-timeout seconds [inbound | either]
5. dialer hold-queue packets [timeout seconds]
6. dialer-group group-number
7. exit
8. dialer-list dialer-group protocol protocol-name {permit | deny | list access-list-number | access-group}
DETAILED STEPS
Configuration Examples for PPPoE Client DDR Idle-Timer
This section provides configuration examples to match the identified configuration tasks in the previous sections. The dialer interface configurations for each interface type required by the pppoe-client dial-pool-number command are included in the following client configuration examples:
•PPPoEoA Client Configuration Example
•PPPoEoE Client Configuration Example
PPPoEoA Client Configuration Example
The following example shows how to configure the PPPoE Client DDR Idle Timer on an ATM PVC interface:
!vpdn enableno vpdn logging!vpdn-group 1request-dialinprotocol pppoe!interface ATM2/0pvc 2/100pppoe-client dial-pool-number 1 dial-on-demand!interface Dialer1ip address negotiatedip mtu 1492encapsulation pppdialer pool 1dialer idle-timeout 180 eitherdialer hold-queue 100dialer-group 1!dialer-list 1 protocol ip permit!ip route 0.0.0.0 0.0.0.0 Dialer1PPPoEoE Client Configuration Example
The following example shows how to configure the PPPoE Client DDR Idle Timer on an Ethernet interface:
!vpdn enableno vpdn logging!vpdn-group 1request-dialinprotocol pppoe!interface Ethernet1pppoe enablepppoe-client dial-pool-number 1 dial-on-demand!interface Dialer1ip address negotiatedip mtu 1492encapsulation pppdialer pool 1dialer idle-timeout 180 eitherdialer hold-queue 100dialer-group 1!dialer-list 1 protocol ip permit!ip route 0.0.0.0 0.0.0.0 Dialer1Additional References
For additional information related to the PPPoE client DDR idle-timer, refer to the following references:
Related Documents
Related Topic Document TitleDDR interesting packets and access control lists
Cisco IOS Dial Technologies Configuration Guide, Release 12.2. See the section "Configuring Access Control for Outgoing Calls " in the chapter "Configuring Legacy DDR Hubs."
DDR and dialer commands: complete command syntax, command mode, defaults, usage guidelines, and examples
Cisco IOS Dial Technologies Command Reference, Release 12.2.
PPPoE Stage Protocols
Cisco IOS Wide-Area Networking Configuration Guide, Release 12.2. See the section "PPPoE Stage Protocols" in the chapter "Configuring Broadband Access: PPP and Routed Bridge Encapsulation."
PPPoE configuration commands: complete command syntax, command mode, defaults, usage guidelines, and example
Cisco IOS Wide-Area Networking Command Reference, Release 12.2. See the chapter "Broadband Access: PPP and Routed Bridge Encapsulation Commands."
Standards
MIBs
To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:
http://tools.cisco.com/ITDIT/MIBS/servlet/index
If Cisco MIB Locator does not support the MIB information that you need, you can also obtain a list of supported MIBs and download MIBs from the Cisco MIBs page at the following URL:
http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml
To access Cisco MIB Locator, you must have an account on Cisco.com. If you have forgotten or lost your account information, send a blank e-mail to cco-locksmith@cisco.com. An automatic check will verify that your e-mail address is registered with Cisco.com. If the check is successful, account details with a new random password will be e-mailed to you. Qualified users can establish an account on Cisco.com by following the directions found at this URL:
RFCs
Technical Assistance
Command Reference
This section documents one modified command only.
•pppoe-client dial-pool-number
pppoe-client dial-pool-number
To configure a PPP over Ethernet (PPPoE) client and to specify dial-on-demand routing (DDR) functionality, use the pppoe-client dial-pool-number command in either interface configuration mode or ATM virtual circuit configuration mode. To disable any configured functionality, use the no form of this command.
pppoe-client dial-pool-number number [dial-on-demand]
no pppoe-client dial-pool-number number [dial-on-demand]
Syntax Description
number
Unique number of a dial group configured with the dialer-group dialer interface command.
dial-on-demand
(Optional) Enables DDR functionality for the PPPoE connection.
Defaults
A PPPoE client is not configured, and DDR functionality is disabled.
Command Modes
Interface configuration
ATM virtual circuit configurationCommand History
Usage Guidelines
One permanent virtual circuit (PVC) will support only one PPPoE client. Multiple PPPoE clients can run concurrently on different permanent virtual circuits (PVCs), but each PPPoE client must use a separate dialer interface and a separate dialer pool.
Use this command to configure dial-on-demand routing (DDR) interesting traffic control list functionality of the dialer interface with a PPP over Ethernet (PPPoE) client. When the DDR functionality is configured for this command, the following DDR commands must also be configured: dialer-group, dialer hold-queue, dialer idle-timeout, and dialer-list.
Tips for Configuring the Dialer Interface
If you are configuring a hard-coded IP address under the dialer interface, you can configure a default IP route using the ip route command as follows:
ip route 0.0.0.0 0.0.0.0 dialer1
But if you are configuring a negotiated IP address using the ip address negotiated command under the dialer interface, you must configure a default IP route using the ip route command as follows:
ip route 0.0.0.0 0.0.0.0 dialer1 permanent
The reason is that the dialer interface will lose its IP address when a PPPoE session is brought down (even if the dialer does not go down), and hence the route removal routine will take effect and remove all IP routes pointed at the dialer interface, even the default IP route. Although the default IP route will be added back about one minute later by IP background processes, you may risk losing incoming packets during the interval.
Examples
PPPoE Client DDR Idle-Timer on an Ethernet Interface
The following example shows how to configure the PPPoE client DDR idle-timer on an Ethernet interface and includes the required DDR commands:
!vpdn enableno vpdn logging!vpdn-group 1request-dialinprotocol pppoe!interface Ethernet1pppoe enablepppoe-client dial-pool-number 1 dial-on-demand!interface Dialer1ip address negotiatedip mtu 1492encapsulation pppdialer pool 1dialer idle-timeout 180 eitherdialer hold-queue 100dialer-group 1!dialer-list 1 protocol ip permit!ip route 0.0.0.0 0.0.0.0 Dialer1PPPoE client DDR Idle-Timer on an ATM PVC
The following example shows how to configure the PPPoE client DDR idle-timer on an ATM PVC interface and includes the required DDR commands:
!vpdn enableno vpdn logging!vpdn-group 1request-dialinprotocol pppoe!interface ATM2/0pvc 2/100pppoe-client dial-pool-number 1 dial-on-demand!interface Dialer1ip address negotiatedip mtu 1492encapsulation pppdialer pool 1dialer idle-timeout 180 eitherdialer hold-queue 100dialer-group 1!dialer-list 1 protocol ip permit!ip route 0.0.0.0 0.0.0.0 Dialer1Related Commands
Copyright © 2002, 2005 Cisco Systems, Inc. All rights reserved.