Step 6 — Install CPESIM (the subscriber simulator)

The default install has no subscribers. That's realistic for a real customer, useless for a demo. CPESIM is a QuantumBNG plugin that spins up a fleet of simulated CPEs on the same box, sends real DHCP DISCOVER frames into the BNG's access-side veth, and drives real TCP downstream traffic — the same code path our regression suite uses.

Installation is a two-click flow:

  1. Navigate to About in the left nav
  2. Scroll down to the Toybox section
  3. Find the CPESIM card (subtitled Subscriber simulator) and click Install

About → Toybox with CPESIM card in Not-installed state

The install takes about a minute. Under the hood:

  • The plugin tarball is fetched from Bluedot's public release repo
  • Its SHA-256 checksum is verified against a signed manifest
  • Contents are unpacked into /opt/bng-demo/
  • A systemd unit is registered so the simulator restarts on reboot

When install finishes, the card flips to Installed · with a Remove button, and a new Simulator entry appears in the left nav.