Traffic Management and Subscriber Plan Enforcement
Subscriber plan enforcement applies configured download and upload rates while Preseem’s traffic-management policies help maintain customer QoE. The following instructions explain how to enable or disable plan enforcement and configure fallback rates in Preseem V1 and V2.
How to identify what version of Preseem you’re running
Once logged into the Preseem server, run the following command to confirm which version of Preseem you’re actively using.
preseemctl version show
Preseem v1 is indicated by the listed components using 1. x.x. If the above command does not work, use the following command instead.
preseemctl show version
Preseem v2 is indicated by the listed components using 2. x.x.
Before editing the configuration
V1 and V2 both use /etc/preseem/config.yaml for saved enforcement settings and default rates. Back up the file before editing it. Choose a different backup filename if config.yaml.bak already exists:
sudo cp -a /etc/preseem/config.yaml /etc/preseem/config.yaml.bak
sudo vi /etc/preseem/config.yaml
Edit the existing settings and keep other values unchanged. Use spaces, not tabs. Rate values are in kilobits per second: 100000 means 100 Mbps. The examples below are illustrative; choose rates suitable for your network.
Preseem V1: Disable or Enable Subscriber Plan Enforcement
File to edit: /etc/preseem/config.yaml
List the bridges and their member interfaces:
brctl show
Find the bridge carrying the traffic you want to change. In /etc/preseem/config.yaml, locate both member interfaces under links and update qosTransmitPolicy.name on each one.
Disable plan enforcement
Set the policy name to count. Preseem continues measuring traffic without policy enforcement:
name: count
Enable plan enforcement
Restore the previous enforcement policy, normally two-level-mq:
name: two-level-mq
If the appliance previously used two-level, restore that value instead. Save the file, then follow “Preseem V1: Apply Changes” below.
Preseem V1: Change Default Rates
File to edit: /etc/preseem/config.yaml
Under links, find twoLevelConfig for both traffic interfaces. Change the two default rates shown below. They apply to subscribers with no speed defined. Example: 100 Mbps download and 20 Mbps upload.
twoLevelConfig:
defaultLevel2DownloadRate: 100000
defaultLevel2UploadRate: 20000
Leave the separate rate setting unchanged. Save the file and apply the changes below.
Preseem V1: Apply Changes
Use these steps after changing either the enforcement policy or default rates. The restart affects traffic handling; perform it during a maintenance window.
1. Restart the service:sudo systemctl restart preseem-netdev-manager2. Check that the service is active, and NetdevManager reports running and healthy:
systemctl status preseem-netdev-manager3. Check an affected subscriber and run an upload/download test. If the change causes a problem, restore the previous values, restart the service again, and repeat the checks.
preseemctl system show
Preseem V2: Disable or Enable Subscriber Plan Enforcement
These commands change enforcement immediately. No file edit or service restart is needed.
Disable plan enforcement
Forward traffic without enforcement or queue management, then check the mode:
preseemctl set config traffic-mode pass
preseemctl get config traffic-mode
The displayed mode may be named SHUNT.
Enable plan enforcement
Resume the configured enforcement policies, then confirm the mode is PROCESS:
preseemctl set config traffic-mode process
preseemctl get config traffic-mode
This resumes the existing policies and rates. Traffic excluded by the subnet configuration remains excluded.
Keep the setting after a restart
File to edit: /etc/preseem/config.yaml
Under netdev_manager, set initial_traffic_mode to process for enforcement on or pass for enforcement off. This saves your choice for the next service or appliance restart. Example for enforcement on:
netdev_manager:
initial_traffic_mode: process
Keep the other netdev_manager settings. Save the file; the startup setting applies when the service next starts. Use the commands above to change the mode now.
Preseem V2: Change Default Rates
File to edit: /etc/preseem/config.yaml
Change the default rates for the situation below. These fallback values apply when rate information is missing; they do not replace configured plan rates.
Subscriber service with no rate
Under shaper_and_service_dump_config, set the fallback for a known service whose rate is missing. Example: 100 Mbps download and 20 Mbps upload.
default_service_download_rate_kbps:100000
default_service_upload_rate_kbps:20000
Network shaper with no rate
Under shaper_and_service_dump_config, set the fallback for a network shaper with no rate. This can limit combined traffic, so choose a value suitable for its capacity. Example: 1 Gbps in each direction.
default_shaper_download_rate_kbps: 1000000
default_shaper_upload_rate_kbps: 1000000
Unmatched IP address
Under netdev_manager.default_ip_rates, set the fallback for IP addresses with no matching entry in the enforcement hierarchy. This applies to the policy: shapertree. Example: 100 Mbps download and 20 Mbps upload.
default_ip_rates:
downstream_kbps: 100000
upstream_kbps: 20000
Preseem V2: Apply and Check the Rates
Save the file, reload the configuration, and check the system:
preseemctl reload config
preseemctl show system
A netdev-manager restart is not required. Check the rates for an affected subscriber and run an upload/download test. If the result is unexpected, restore the previous values and reload the configuration