Downloads |
Table Of Contents
Supported Standards, MIBs, and RFCs
Enabling PPPoE Session Count SNMP Traps
Configuring the PPPoE Session-Count Threshold for the Router
Configuring the PPPoE Session-Count Threshold for a PVC
Configuring the PPPoE Session Count Threshold for a VC Class
Configuring the PPPoE Session-Count Threshold for an ATM PVC Range
Configuring the PPPoE Session-Count Threshold for an Individual PVC
Within a RangeVerifying PPPoE Session Count Thresholds
Monitoring and Maintaining PPPoE Session Counts and
SNMP NotificationsConfiguring PPPoE Session-Count SNMP Traps Example
PPPoE Session-Count Threshold for the Router Example
PPPoE Session-Count Threshold for a PVC Example
PPPoE Session-Count Threshold for a VC Class Example
PPPoE Session-Count Threshold for a PVC Range Example
PPPoE Session-Count Threshold for an Individual PVC Within a
PVC Range Examplesnmp-server enable traps pppoe
PPPoE Session-Count MIB
Feature History
12.2(1)DC
This feature was introduced.
12.2(8)T
This feature was integrated into Cisco IOS 12.2(8)T.
This document describes the PPPoE Session Count MIB support introduced in Cisco IOS Release 12.2(8)T. It includes the following sections:
•
Supported Standards, MIBs, and RFCs
•
Feature Overview
The PPPoE Session-Count MIB provides the ability to use Simple Network Management Protocol (SNMP) to monitor in real time the number of PPP over Ethernet sessions configured on permanent virtual circuits (PVCs) and on a router.
This new MIB also introduces two SNMP traps that generate notification messages when a PPPoE session-count threshold is reached on any PVC or on the router. The PPPoE session-count thresholds can be configured using the pppoe limit max-sessions and pppoe max-sessions commands.
Table 1 describes the objects and tables supported by the PPPoE Session-Count MIB. For a complete description of the MIB, see the PPPoE Sessions Management MIB file CISCO-PPPOE-MIB.my, available through Cisco.com at the following URL:
http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml.
Benefits
The PPPoE Session Count MIB provides the following benefits:
•
•
•
Restrictions
The snmp-server enable traps pppoe command enables SNMP traps only. It does not support inform requests.
Related Documents
For information on configuring PPPoE for broadband access, see the following documents:
•
•
•
For information on configuring SNMP using Cisco IOS software, see the following documents:
•
•
Supported Platforms
•
•
•
•
•
•
•
•
•
•
Platform Support Through Feature Navigator
Cisco IOS software is packaged in feature sets that support specific platforms. To get updated information regarding platform support for this feature, access Feature Navigator. Feature Navigator dynamically updates the list of supported platforms as new platform support is added for the feature.
Feature Navigator is a web-based tool that enables you to quickly determine which Cisco IOS software images support a specific set of features and which features are supported in a specific Cisco IOS image.
To access Feature Navigator, you must have an account on Cisco.com. If you have forgotten or lost your account information, e-mail the Contact Database Administration group at cdbadmin@cisco.com. If you want to establish an account on Cisco.com, go to http://www.cisco.com/register and follow the directions to establish an account.
Feature Navigator is updated when major Cisco IOS software releases and technology releases occur. As of May 2001, Feature Navigator supports M, T, E, S, and ST releases. You can access Feature Navigator at the following URL:
http://www.cisco.com/go/fn
Supported Standards, MIBs, and RFCs
Standards
No new or modified standards are supported by this feature.
MIBs
This feature introduces the PPPoE Session Count MIB. The CISCO-PPPOE-MIB.my can be downloaded from the Cisco MIB website on Cisco.com at:
http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml.
To obtain lists of supported MIBs by platform and Cisco IOS release, and to download other MIB modules, go to the Cisco MIB website on Cisco.com at the following URL:
http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml
RFCs
No new or modified RFCs are supported by this feature.
Prerequisites
The tasks as described in this document assume that you have configured SNMP and PPPoE.
Configuration Tasks
See the following sections for configuration tasks for the PPPoE Session Limit MIB feature. Each task in the list is identified as optional or required.
•
•
•
•
•
•
•
Enabling PPPoE Session Count SNMP Traps
To enable SNMP traps that send notification messages when PPPoE session thresholds have been reached, use the following command in global configuration mode:
Router(config)# snmp-server enable traps pppoe
Enables PPPoE session-count Simple Network Management Protocol (SNMP) notifications.
Configuring the PPPoE Session-Count Threshold for the Router
To configure the PPPoE session-count threshold for the router, use the following commands beginning in global configuration mode:
Configuring the PPPoE Session-Count Threshold for a PVC
To configure the PPPoE session-count threshold for a PVC, use the following commands beginning in global configuration mode:
Step 1
Router(config)# interface atm number [point-to-point | multipoint]
Configures an ATM interface.1
Step 2
Router(config-if)# pvc [name] vpi/vci
Configures the PVC.
Step 3
Router(config-if-atm-vc)# pppoe max-session number-of-sessions [threshold-sessions number-of-sessions]
Sets the maximum number of PPPoE sessions that will be permitted on an ATM PVC, PVC range, virtual circuit (VC) class, or VLAN, and sets the PPPoE session-count threshold at which an SNMP trap will be generated.
1 To determine the correct form of the interface atm command, consult your ATM network module, port adapter, or router documentation.
Configuring the PPPoE Session Count Threshold for a VC Class
To configure the PPPoE session-count threshold for a VC class, use the following commands beginning in global configuration mode:
Configuring the PPPoE Session-Count Threshold for an ATM PVC Range
To configure the PPPoE session- count threshold for an ATM PVC range, use the following commands beginning in global configuration mode:
Step 1
Router(config)# interface atm number [point-to-point | multipoint]
Configures an ATM interface.1
Step 2
Router(config-if)# range [range-name] pvc start-vpi/start-vci end-vpi/end-vci
Defines a range of ATM PVCs.
Step 3
Router(cfg-if-atm-range)# pppoe max-session number-of-sessions [threshold-sessions number-of-sessions]
Sets the maximum number of PPPoE sessions that will be permitted on an ATM PVC, PVC range, VC class, or VLAN, and sets the PPPoE session-count threshold at which an SNMP trap will be generated.
1 To determine the correct form of the interface atm command, consult your ATM network module, port adapter, or router documentation.
Configuring the PPPoE Session-Count Threshold for an Individual PVC
Within a RangeTo configure the PPPoE session-count threshold for an individual PVC within an ATM PVC range, use the following commands beginning in global configuration mode:
Step 1
Router(config)# interface atm number [point-to-point | multipoint]
Configures an ATM interface.1
Step 2
Router(config-if)# range [range-name] pvc start-vpi/start-vci end-vpi/end-vci
Defines a range of ATM PVCs.
Step 3
Router(cfg-if-atm-range)# pvc-in-range [pvc-name] [vpi/vci]
Configures an individual PVC within a PVC range.
Step 4
Router(cfg-if-atm-range-pvc)# pppoe max-session number-of-sessions [threshold-sessions number-of-sessions]
Sets the maximum number of PPPoE sessions that will be permitted on an ATM PVC, PVC range, VC class, or VLAN, and sets the PPPoE session-count threshold at which an SNMP trap will be generated.
1 To determine the correct form of the interface atm command, consult your ATM network module, port adapter, or router documentation.
Verifying PPPoE Session Count Thresholds
To verify the configuration of PPPoE session-count thresholds, use the following command in EXEC mode:
Monitoring and Maintaining PPPoE Session Counts and
SNMP NotificationsTo monitor PPPoE session counts and SNMP notifications, use the following commands in EXEC mode:
Configuration Examples
This section provides the following configuration examples:
•
•
•
•
•
•
Configuring PPPoE Session-Count SNMP Traps Example
The following example enables the router to send PPPoE session-count SNMP notifications to the host at the address 10.64.131.20:
snmp-server community public RWsnmp-server enable traps pppoesnmp-server host 10.64.131.20 version 2c public udp-port 1717PPPoE Session-Count Threshold for the Router Example
The following example shows a limit of 4000 PPPoE sessions configured for the router. The PPPoE session-count threshold is set at 3000 sessions, so when the number of PPPoE sessions on the router reaches 3000, an SNMP trap will be generated.
vpdn enableno vpdn logging!vpdn-group 1accept-dialinprotocol pppoevirtual-template 1pppoe limit max-sessions 4000 threshold-sessions 3000PPPoE Session-Count Threshold for a PVC Example
The following example shows a limit of 5 PPPoE sessions configured for the PVC. The PPPoE session-count threshold is set at 3 sessions, so when the number of PPPoE sessions on the PVC reaches 3, an SNMP trap will be generated.
interface ATM0/0/0ip address 10.0.0.1 255.255.255.0no atm ilmi-keepalivepvc 5/120protocol ip 10.0.0.2 broadcastpppoe max-sessions 5 threshold-sessions 3protocol pppoePPPoE Session-Count Threshold for a VC Class Example
The following example shows a limit of 7 PPPoE sessions configured for a VC class called "main". The PPPoE session-count threshold is set at 3 sessions, so when the number of PPPoE sessions for the VC class reaches 3, an SNMP trap will be generated.
vc-class atm mainpppoe max-sessions 7 threshold-sessions 3PPPoE Session-Count Threshold for a PVC Range Example
The following example shows a limit of 20 PPPoE sessions configured for the PVC range. The PPPoE session-count threshold will also be 20 sessions because when the session-count threshold has not been explicitly configured, it defaults to the PPPoE session limit. An SNMP trap will be generated when the number of PPPoE sessions for the range reaches 20.
interface ATM0/0/0.3 point-to-pointrange pvc 3/100 3/105pppoe max-sessions 20protocol pppoePPPoE Session-Count Threshold for an Individual PVC Within a
PVC Range ExampleThe following example shows a limit of 10 PPPoE sessions configured for "pvc1". The PPPoE session-count threshold is set at 3 sessions, so when the number of PPPoE sessions for the PVC reaches 3, an SNMP trap will be generated.
interface atm 6/0.110 multipointrange range1 pvc 100 4/199pvc-in-range pvc1 3/104pppoe max-sessions 10 threshold-sessions 3Command Reference
This section documents new or modified commands. All other commands used with this feature are documented in the Cisco IOS Release 12.2 command reference publications.
•
pppoe limit max-sessions
To set the maximum number of PPP over Ethernet (PPPoE) sessions that will be permitted on a router, and to set the PPPoE session-count threshold at which an SNMP trap will be generated, use the pppoe limit max-sessions command in VPDN group configuration mode. To remove these settings, use the no form of this command.
pppoe limit max-sessions number-of-sessions [threshold-sessions threshold-value]
no pppoe limit max-sessions
Syntax Description
Defaults
There is no default number-of-sessions.
The default threshold-value is the configured number-of-sessions.
Command Modes
VPDN group configuration
Command History
12.2(2)T
This command was introduced.
12.2(8)T
This command was modified to configure the PPPoE session-count threshold.
Usage Guidelines
The snmp-server enable traps pppoe command must be configured in order for SNMP traps to be generated when the PPPoE session-count threshold is reached.
The following statements describe the different types of PPPoE session limits:
•
•
•
Examples
The following example shows a limit of 100 PPPoE sessions configured for the router. An SNMP trap will be generated when the number of PPPoE sessions on the router reaches 90.
vpdn enable!vpdn-group 1accept dialinprotocol pppoevirtual-template 1pppoe limit max-sessions 100 threshold-sessions 90Related Commands
pppoe max-sessions
To set the maximum number of PPP over Ethernet (PPPoE) sessions that will be permitted on an ATM permanent virtual circuit (PVC), PVC range, virtual circuit (VC) class, or VLAN, and to set the PPPoE session-count threshold at which an SNMP trap will be generated, use the pppoe max-sessions command in the appropriate command mode. To remove this specification, use the no form of this command.
pppoe max-sessions number-of-sessions [threshold-sessions threshold-value]
no pppoe max-sessions
Syntax Description
Defaults
The default number-of-sessions is 100.
The default threshold-value is the number-of-sessions.
Command Modes
Ethernet subinterface
Interface-ATM-VC configuration
VC-class configuration
ATM PVC range configuration
PVC-in-range configurationCommand History
Usage Guidelines
Note
The snmp-server enable traps pppoe command must be configured in order for SNMP traps to be generated when the PPPoE session-count threshold is reached.
The following statements describe the different types of PPPoE session limits:
•
•
•
PPPoE session limits created on an ATM PVC take precedence over limits created in a VC class or ATM PVC range.
PPPoE session limits created in an ATM PVC range take precedence over limits created in a VC class.
Examples
VLAN Example
The following example shows a maximum of 200 PPPoE sessions configured for an 802.1Q VLAN subinterface:
interface FastEthernet0/0.10encapsulation dot1Q 10pppoe enablepppoe max-session 200ATM PVC Example
The following example shows a limit of 10 PPPoE sessions configured for the PVC. An SNMP trap will be generated when the number of PPPoE sessions on the router reaches 8.
interface ATM1/0.102 multipointpvc 3/304encapsulation aal5snapprotocol pppoepppoe max-sessions 10 threshold-sessions 8VC Class Example
The following example shows a limit of 20 PPPoE sessions and a session count threshold of 15 sessions configured for the VC class called "main":
vc-class atm mainpppoe max-sessions 20 threshold-sessions 15ATM PVC Range Example
The following example shows a limit of 30 PPPoE sessions configured for the ATM PVC range called "range-1". The session count threshold is also 30 sessions because the threshold-value defaults to the number-of-sessions value when it has not been explicitly configured.
interface atm 6/0.110 multipointrange range-1 pvc 100 4/199encapsulation aal5snapprotocol ppp virtual-template 2pppoe max-sessions 30Individual PVC Within a PVC Range Example
The following example shows a limit of 10 PPPoE sessions configured for "pvc1", which is part of the ATM PVC range called "range1". The PPPoE session count threshold is also 10 sessions.
interface atm 6/0.110 multipointrange range1 pvc 100 4/199pvc-in-range pvc1 3/104pppoe max-sessions 10Related Commands
snmp-server enable traps pppoe
To enable PPPoE session count Simple Network Management Protocol (SNMP) notifications, use the snmp-server enable traps pppoe configuration command in global configuration mode. To disable PPPoE session count SNMP notifications, use the no form of this command.
snmp-server enable traps pppoe
no snmp-server enable traps pppoe
Syntax Description
This command has no arguments or keywords.
Defaults
SNMP notifications are disabled by default.
Command Modes
Global configuration
Command History
12.2(1)DC
This command was introduced.
12.2(8)T
This command was integrated into Cisco IOS Release 12.2(8)T.
Usage Guidelines
This command enables SNMP traps only. It does not support inform requests.
To configure the PPPoE session-count thresholds at which SNMP notifications will be sent, use the pppoe limit max-sessions or pppoe max-sessions commands.
For a complete description of this notification and additional MIB functions, see the CISCO-PPPOE-MIB.my file, available on Cisco.com at http://www.cisco.com/public/mibs/v2/.
Examples
The following example enables the router to send PPPoE session-count SNMP notifications to the host at the address 10.64.131.20:
snmp-server community public RWsnmp-server enable traps pppoesnmp-server host 10.64.131.20 version 2c public udp-port 1717Related Commands
Glossary
ATM—Asynchronous Transfer Mode. International standard for cell relay in which multiple service types (such as voice, video, or data) are conveyed in fixed-length cells. Fixed-length cells allow cell processing to occur in hardware, thereby reducing transit delays.
inform—An SNMP trap message that includes a delivery confirmation request. See trap.
MIB—Management Information Base. Database of network management information that is used and maintained by a network management protocol such as SNMP. The value of a MIB object can be changed or retrieved using SNMP commands, usually through a network management system (NMS). MIB objects are organized in a tree structure that includes public (standard) and private (proprietary) branches.
NMS—network management system. An application or suite of applications designed to monitor networks using SNMP. CiscoView is one example of an NMS.
PPP—Point-to-point protocol. Successor to SLIP that provides router-to-router and host-to-network connections over synchronous and asynchronous circuits.
PVC—Permanent virtual circuit. Virtual circuit that is permanently established. PVCs save bandwidth associated with circuit establishment and teardown in situations in which certain virtual circuits must exist all the time.
SNMP—Simple Network Management Protocol. Management protocol used almost exclusively in TCP/IP networks. SNMP provides a means to monitor and control network devices and to manage configurations, statistics collection, performance, and security, typically through the use of an NMS.
trap—Message sent by an SNMP agent to a network management station, console, or terminal to indicate the occurrence of a significant event, such as a specifically defined condition or the reaching of a threshold.
VLAN—virtual LAN. Group of devices on one or more LANs that are configured (using management software) so that they can communicate as if they were attached to the same wire, when in fact they are located on a number of different LAN segments. Because VLANs are based on logical instead of physical connections, they are extremely flexible.
VPDN—virtual private dial-up network. See also VPN.
VPN—virtual private network. Enables IP traffic to travel securely over a public TCP/IP network by encrypting all traffic from one network to another. A VPN uses "tunneling" to encrypt all information at the IP level.
