2. Prerequisites

Before installing CPESIM you need:

Requirement Notes
QuantumBNG v1.2.0-21 or later Older wrappers ship an older CPESIM pin and miss the throughput-reporting + traffic-continuity fixes. sudo cat /opt/bng-deploy/installer/PINS.sh should show BUNDLE_VERSION="1.2.0-21".
An admin login to the BNG web UI Install / remove require the admin_only role. A read_write operator can Start/Stop the demo but can't install the plugin.
Outbound HTTPS to github.com Install pulls the plugin tarball from github.com/Bluedot-Insight/cpesim/releases. Air-gapped labs can point at an internal mirror — see §7.
~50 MB free disk at /opt/bng-demo The engine payload itself is small; per-run state fits comfortably.
VPP running and healthy CPESIM uses vppctl to attach its own host-demo0p and host-demo-upp interfaces. Confirm with sudo systemctl is-active vpp.

CPESIM is idle-safe: installing it does not affect any production traffic on the BNG until you start a demo run.