Skip to content
English
  • There are no suggestions because the search field is empty.

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-manager
2. Check that the service is active, and NetdevManager reports running and healthy:
systemctl status preseem-netdev-manager
preseemctl system show
3. 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.

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