To set the PPPoE sessions limit for a particular PPPoE BBA-Group or for the entire router, use the sessions limit command in PPPoE BBA-Group configuration mode. To remove the specified limit for PPPoE sessions, use the no form of this command.
sessions {access-interface | circuit-id | circuit-id-and-remote-id | inner-vlan | {mac | mac-iwf} [access-interface] | max | outer-vlan | remote-id | vlan} limit limit-value [threshold threshold-value]
Syntax Description
access-interface
|
Limits PPPoE
sessions on any one access interface.
|
circuit-id
|
Limits PPPoE
sessions with any one circuit-ID.
|
circuit-id-and-remote-id
|
Limits PPPoE
sessions by circuit-id and remote-id.
|
inner-vlan
|
Limits
PPPoE sessions with any one inner-vlan id.
|
mac
|
Limits
PPPoE sessions from any one mac address.
|
mac-iwf
|
Limits IWF
PPPoE sessions from any one mac address.
|
max
|
Sets a
per-card session limit.
|
outer-vlan
|
Limits
PPPoE sessions with any one outer-vlan id.
|
remote-id
|
Limits
PPPoE sessions with any one remote-id.
|
vlan
|
Limits
PPPoE sessions with matching vlan ids.
|
limit
|
Specifies
the action of limiting the PPPoE sessions for various attributes.
|
limit-value
|
Specifies
the session limit value.
The range
is from 1 to 65535. The default is 65535.
|
threshold
|
Specifies
the action of generating a log message when the threshold has reached.
|
threshold-value
|
Specifies
the threshold value.
The range
is from 1 to 65535.
|
Command Modes
PPPoE BBA-Group configuration
Command History
Release
|
Modification
|
Release 4.2.0
|
This
command was introduced.
|
Release 4.3.1
|
The PPPoE
sessions limit support was extended for
mac
access-interface ,
mac-iwf
access-interface ,
inner-vlan ,
outer-vlan ,
vlan , and
circuit-id-and-remote-id
Support
for the optional argument,
threshold was
added.
|
Release 6.2.1 |
Functionality was included to set a global PPPoE session limit, that is, a session limit for the entire router.
|
Usage Guidelines
If a session limit is configured after the limit has already been exceeded, the existing sessions are torn down until the
number of sessions matches the configured limit.
If both mac limit and mac-iwf limit are configured, only IWF limit is used for IWF sessions, so that a higher IWF limit than
the limit for non-IWF sessions can be used. The same is the case if both mac access-interface limit and mac-iwf access-interface
limit are configured.
 Note |
The sessions outer-vlan limit command limits the sessions only in single VLAN tag scenarios. You must use the sessions vlan limit command, to limit the sessions in double VLAN tag scenarios; this limits the maximum number of sessions allowed for each
inner VLAN and outer VLAN, for each access-interface.
|
In order to set a global PPPoE session limit, use the sessions max limit command under pppoe bba-group global configuration mode. The combined number of sessions on all individual BBA-Groups cannot exceed this global limit. For example,
consider a configuration where the global limit is set as 250, the limit of BBA-Group 1 (say, bba1 ) is set as 100, and the limit of BBA-Group 2 (say, bba2 ) is set as 200. If 100 sessions are already created with bba1 , then only 150 sessions (that is, 250 -100) can be created with bba2 , even though bba2 has a session limit of 200. Similarly there can be different combinations of sessions with local BBA-Groups as long as the
global session limit is not exceeded. For more details, see pppoe bba-group command.
Task ID
Task ID
|
Operation
|
ppp
|
read,
write
|
Examples
This example shows how to configure a pppoe session limit of 1000, for each access-interface in a PPPoE BBA-Group:
RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# pppoe bba-group bba1
RP/0/RSP0/CPU0:router(config-bbagroup)# sessions access-interface limit 1000
This example shows how to configure a pppoe session limit of 5000 and a threshold value of 4900, for each peer mac-address
under individual access-interface in a PPPoE BBA-Group:
RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# pppoe bba-group bba1
RP/0/RSP0/CPU0:router(config-bbagroup)# sessions mac access-interface limit 5000 threshold 4900
This example shows how to set the global PPPoE session limit for a router as 250:
RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# pppoe bba-group global
RP/0/RSP0/CPU0:router(config-bbagroup)# sessions max limit 250