Modifying QoS Configurations with Service Manager
This topic describes how to modify QoS configurations with Service Manager. To modify QoS configurations with Service Manager, perform the following steps:
Modifying Parameter Instances
Service Manager activates services without considering current parameter instance values. For example, when you deactivate a video service, Service Manager can add 5 Mbps to a parameter associated with the shaping rate of a video queue.
Similarly, Service Manager can deactivate services and restore parameter instances to their previous value. For example, when you deactivate a video service, Service Manager can subtract 5 Mbps from a parameter associated with the shaping rate of a video queue.
Table 1 lists the results of a series of activations and deactivations of parameters using the add and initial-value keywords.
Table 1: Sample Modifications Using the Add and Initial-Value Keywords
Action | QoS Parameter Instance | Result |
|---|---|---|
Activate | qos-parameter video-bw add 5000000 initial-value 0 | Parameter instance video-bw is created with a value of 5000000 |
Activate | qos-parameter video-bw add 1000000 initial-value 0 | Parameter instance video-bw is increased by 1000000, for a total of 6000000 |
Deactivate | qos-parameter video-bw add 1000000 initial-value 0 | Parameter instance video-bw is decreased by 1000000, for a total of 500000 |
Deactivate | qos-parameter video-bw add 5000000 initial-value 0 | Parameter instance video-bw is removed |
Removing a parameter instance using profiles is based on the number of times a parameter instance is modified, not the value added.
Modifying parameter instances in profiles and modifying explicit parameter instances can cause invalid parameter instance values. Table 2 lists a series of activations and deactivations using parameter instances in profiles and explicit parameter instances. By the second deactivation, the parameter has a negative value (-4000000).
 | Note: We recommend that you do not configure negative values for Service Manager. |
Table 2: Sample Modifications Using Parameter Instances
Action | QoS Parameter Instance | Result |
|---|---|---|
Activate | qos-parameter video-bw add 5000000 initial-value 0 | Parameter instance video-bw is created with a value of 5000000 |
Activate | qos-parameter video-bw add 1000000 initial-value 0 | 1000000 is added to parameter instance video-bw, for a total of 6000000 |
Activate | qos-parameter video-bw 2000000 | Parameter instance video-bw is set to 2000000 |
Deactivate | qos-parameter video-bw add 1000000 initial-value 0 | 1000000 is subtracted from parameter instance video-bw for a total of 1000000 |
Deactivate | qos-parameter video-bw add 5000000 initial-value 0 | 5000000 is subtracted from parameter instance video-bw for a total of -4000000 |
Deactivate | qos-parameter video-bw 2000000 | Parameter instance video-bw is removed |
Modifying QoS Configurations in a Single Service Manager Event
QoS accepts QoS profile attachments and parameter instances created using multiple sources (profiles, RADIUS, or Service Manager) within a single Service Manager event. Events include:
- Subscriber login
- Subscriber logout
- RADIUS Change of Authority
QoS prioritizes the creation of QoS profiles and parameter instances within events. Table 3 lists the sources that overwrite QoS profiles and parameter instances created by other sources. Each row represents new QoS profiles and parameter instances; columns represent existing QoS profiles and parameter instances.
Table 3: Configuration Within a Single Service Manager Event
| Profile | RADIUS | Service Manager |
|---|---|---|---|
| Profile | ✓ | – | – |
| RADIUS | ✓ | ✓ | – |
| Service Manager | ✓ | ✓ | ✓ |
Modifying QoS Configurations by Using Other Sources
You can modify QoS configurations with Service Manager by using other QoS sources. For example, you can modify a parameter instance that was created with Service Manager by using the CLI. Similarly, you can use SNMP to detach a QoS profile attached by Service Manager.
Table 4 lists the sources that you can use to modify QoS profile attachments and parameter instances.
Table 4: Modifying QoS Configurations with Other Sources
| QoS Profile Attachment | QoS Parameter Instances |
|---|---|---|
Service Manager | ✓ | ✓ |
RADIUS | ✓ | ✓ |
SNMP | ✓ | – |
SRC software | ✓ | – |
CLI | ✓ | ✓ |
The following sections describe the precedence of each source when modifying configurations.
Service Manager
QoS profile attachments and parameter instances created through Service Manager have precedence over all other sources. For example, Service Manager can overwrite a QoS profile attachment modified through RADIUS, SNMP, the SRC software, or the CLI.
Conversely, Service Manager configurations can be overwritten through SNMP, the SRC software, and the CLI, but not by RADIUS.
Service Manager counts references of parameter instances. You can modify parameter instances created by Service Manager using other sources without affecting the reference counts. For more information, see QoS for Service Manager Considerations.
RADIUS
QoS profile attachments and parameter instances configured through RADIUS can overwrite QoS profile attachments and parameter instances configured through the SNMP, the SRC software, and the CLI, but not those created by Service Manager.
Conversely, QoS profiles and parameter instances configured through RADIUS can be overwritten by any source (SNMP, the SRC software, CLI, and Service Manager).
SNMP, the SRC Software, and the CLI
QoS profile attachments and parameter instances configured through the CLI can overwrite QoS profile attachments and parameter instances configured through any source.
QoS profiles attached through SNMP and the SRC software can also overwrite QoS profile attachments configured through any source.
Conversely, QoS profiles and parameter instances configured through the CLI, SNMP, or the SRC software can be overwritten by any source.
