qos-profile enforced
To specify a quality-of-service (QoS) profile that should be enforced when users violate their registered QoS profiles, use the qos-profile enforced command in enforce-rule configuration mode. To delete the enforced QoS profile from the enforce-rule, use the no form of this command.
qos-profile enforced profile-id [no-persistence]
no qos-profile enforced profile-id [no-persistence]
Syntax Description
profile-id |
Specifies the QoS profile to be enforced. The valid range is 0 to 16383, with a default of 0. |
no-persistence |
(Optional) Specifies that the enforced QoS profile should not remain in force when a cable modem reboots. Instead, when a cable modem that is in the penalty period reboots, it is automatically removed from the penalty period and assigned the QoS profile that is specified in its DOCSIS configuration file. The default behavior is that enforced QoS profiles remain in force for cable modems across reboots. |
Command Default
The value of profile-id defaults to 0, and enforced QoS profiles are persistent across cable modem reboots.
Command Modes
Enforce-rule configuration (enforce-rule)
Command History
Release |
Modification |
---|---|
12.3(9a)BC |
This command was introduced. This command replaces the enforced qos-profile command. |
12.2(33)SCA |
This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added. |
IOS-XE 3.15.0S |
This command is not supported on the Cisco cBR Series Converged Broadband Routers. |
IOS-XE 3.17.0S |
This command was implemented on the Cisco cBR Series Converged Broadband Routers. |
Usage Guidelines
Both the originally provisioned QoS profile and the enforced QoS profile must be created on the Cisco CMTS router. The profile-id does not support QoS profiles that are created by the cable modem.
An enforce-rule can specify an enforced QoS profile, which is automatically applied to subscribers who transmit more traffic than allowed by their registered QoS profile. The enforced QoS profile remains in effect during the penalty time period (see the penalty-period command). At the end of the penalty period, the subscriber returns to the registered QoS profile.
If a cable modem reboots while it is in its penalty time period, it continues using the enforced QoS profile, unless the service provider has manually changed the cable modem’s registered QoS profile using the cable modem qos profile command.
When you change the enforced QoS profile for a currently active enforce-rule, any cable modems using this rule that are currently in the penalty period continue using the previously configured enforced QoS profile. Any cable modems that enter the penalty period after this configuration change, however, use the new enforced QoS profile.
An enforced QoS profile must already have been created on the Cisco CMTS router before you can assign it to an enforce-rule. If the rule does not exist, the system displays an error message.
When the no-persistence option is specified, the enforced QoS profile is still automatically applied to subscribers who violate their bandwidth requirements. However, when the cable modem reboots, the Cisco CMTS router allows the cable modem to use the QoS profile that is specified in its DOCSIS configuration file.
The no-persistence option can be used when initially using the Subscriber Traffic Management feature to identify potential problem applications and users. When repeat offenders are identified, they can then be assigned enforce-rules that do not use the no-persistence option, so that they remain in the penalty period even if they reboot their cable modems.
Note |
The system automatically applies the enforced QoS profile to violators only if the enforce keyword has been used with the activate-rule-at-byte-count command. |
Examples
The following example shows profile 12 being assigned as the enforced QoS profile to an enforce-rule:
Router# configure terminal
Router(config)# cable qos enforce-rule residential
Router(enforce-rule)# qos-profile enforced 12
The following example shows profile 12 being assigned as the enforced QoS profile to an enforce-rule, but with the no-persistence option specified, so that the enforced QoS profile does not remain in force if the cable modem reboots:
Router# configure terminal
Router(config)# cable qos enforce-rule residential
Router(enforce-rule)# qos-profile enforced 12 no-persistence
The following example shows the error message that is displayed when the specified QoS profile does not exist on the CMTS:
Router# configure terminal
Router(config)# cable qos enforce-rule test
Router(enforce-rule)# qos-profile enforced 98
The qos profile 98 doesn't exist or it's a cm created QoS profile