Skip to content

ApmonD 1.0.0

Choose a tag to compare

@bluewavenet bluewavenet released this 26 Oct 19:11
· 74 commits to master since this release
8932837

ApmonD 1.0.0

First release of ApmonD, the access point monitoring daemon for OpenWrt: a standalone port of the apmond functionality of mesh11sd, for networks that do not use mesh11sd. Every node runs the same daemon and the same /etc/config/apmond; the router detects itself and becomes the collector, and every node sends it a signed report.

Highlights

  • One passphrase (apmon_seed) gives the shared IPv6 ULA prefix and the report signing secret
  • Router/collector auto detection, first come wins, with back off and failover
  • Signed reports, protocol v1, same chunked HTTPS transport as mesh11sd; stale, replayed and tampered reports are rejected
  • Wireless and wired clients, optional vlan key per client, vlan_filtering bridges, wired byte counts labelled "stats_scope": "port"
  • apmon.cgi generated at daemon startup as mesh11sd does, cgi_dir option for web servers other than uhttpd, removed with the package
  • CLI: status (JSON, with running and installed checksums), show_ap_data, get_ap_data, send, cleanup, read_log, debuglevel
  • Logging as mesh11sd, optional log_mountpoint
  • Works out of the box with a built-in default passphrase, with a notice at start and every 6 hours until you set your own
  • Log hints to check that apmon_seed is the same on every node when the collector is unreachable or rejects the signature
  • Conflicts with mesh11sd (opkg CONFLICTS, apk !mesh11sd)

Tested on two GL-MT300N-V2 running OpenWrt 25.12.5 (VLAN over 802.11s), and with the mock end to end tests (218 pass).

Install: build the package with the feed template linux_openwrt/apmond/Makefile (OpenWrt 25.12 or later, apk) and install it on every node. Submission to the OpenWrt packages feed is to follow.

LuCI support: luci-app-apmond 1.0.0.

Full list of changes: ChangeLog

Downloads

  • apmond-1.0.0-r1.apk: noarch apk for OpenWrt 25.12 and later, works on every target. Checksum in apmond-1.0.0-r1.apk.sha256.
  • It is not signed by an OpenWrt feed key, so install it with apk add --allow-untrusted ./apmond-1.0.0-r1.apk
  • For LuCI, also install luci-app-apmond-1.0.0-r1.apk after apmond.