Plugin: Firmware-Metadaten und Registrierung (nicht mehr „misconfigured“) #29

Merged
jochen merged 1 commit from fix/plugin-register into master 2026-11-11 08:10:38 +00:00
Collaborator

Befund aus dem Test: System → Firmware → Plugins zeigt os-mdns-bridge als misconfigured, auch nach register.php install und nach einer Installation über die GUI.

Ursache

register.php (OPNsense-Core) trägt ein Plugin nur dann in config.xml (system/firmware/plugins) ein, wenn /usr/local/opnsense/version/<Name ohne "os-"> existiert und dort product_id = Paketname steht. Diese Datei schreibt bei offiziellen Plugins Mk/plugins.mk, unser Paket hatte sie nicht.

Änderung (opnsense/build-plugin.sh)

  • liefert /usr/local/opnsense/version/mdns-bridge mit (product_id, product_version, product_hash, product_website, product_tier, leeres product_conflicts). Den eigenen Namen in product_conflicts würde register.php wieder austragen; daran scheitert mimugmails os-speedtest-community.
  • post-install: register.php install os-mdns-bridge
  • post-deinstall: register.php remove os-mdns-bridge. Die Metadatei ist zu diesem Zeitpunkt schon weg, also wird ausgetragen.

Getestet

  • build-plugin.sh mit pkg-Stub: Metadatei mit gültigem JSON, product_id = os-mdns-bridge, in der Dateiliste; Skripte wie oben; shellcheck sauber
  • Logik gegen den register.php-Quelltext der Box geprüft (plugins_disk_found: Dateiname mdns-bridge → product_id os-mdns-bridge)
  • Auf der Box: nach dem Upgrade aus testing muss das Plugin als installed erscheinen

🤖 Generated with Claude Code

https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp

Befund aus dem Test: System → Firmware → Plugins zeigt `os-mdns-bridge` als **misconfigured**, auch nach `register.php install` und nach einer Installation über die GUI. ## Ursache `register.php` (OPNsense-Core) trägt ein Plugin nur dann in `config.xml` (`system/firmware/plugins`) ein, wenn `/usr/local/opnsense/version/<Name ohne "os-">` existiert und dort `product_id` = Paketname steht. Diese Datei schreibt bei offiziellen Plugins `Mk/plugins.mk`, unser Paket hatte sie nicht. ## Änderung (`opnsense/build-plugin.sh`) - liefert `/usr/local/opnsense/version/mdns-bridge` mit (`product_id`, `product_version`, `product_hash`, `product_website`, `product_tier`, leeres `product_conflicts`). Den eigenen Namen in `product_conflicts` würde `register.php` wieder austragen; daran scheitert mimugmails `os-speedtest-community`. - post-install: `register.php install os-mdns-bridge` - post-deinstall: `register.php remove os-mdns-bridge`. Die Metadatei ist zu diesem Zeitpunkt schon weg, also wird ausgetragen. ## Getestet - `build-plugin.sh` mit `pkg`-Stub: Metadatei mit gültigem JSON, `product_id` = `os-mdns-bridge`, in der Dateiliste; Skripte wie oben; shellcheck sauber - Logik gegen den `register.php`-Quelltext der Box geprüft (`plugins_disk_found`: Dateiname `mdns-bridge` → `product_id` `os-mdns-bridge`) - **Auf der Box:** nach dem Upgrade aus `testing` muss das Plugin als *installed* erscheinen 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
Plugin: firmware metadata and registration
All checks were successful
build-freebsd / freebsd (pull_request) Successful in 2m57s
build-freebsd / release (pull_request) Has been skipped
ci / rust (push) Successful in 3m31s
ci / rust (pull_request) Successful in 3m36s
f0ded4be36
System: Firmware: Plugins showed os-mdns-bridge as "misconfigured":
installed, but not recorded in config.xml (system/firmware/plugins).
The firmware's register.php only records a plugin if
/usr/local/opnsense/version/<name without "os-"> exists with
product_id = package name - our package did not ship that file, so
neither register.php nor an install via the GUI could register it.

- ship /usr/local/opnsense/version/mdns-bridge (product_id, version,
  hash, website, tier; empty product_conflicts - naming the plugin
  itself there would unregister it again)
- post-install: register.php install os-mdns-bridge
- post-deinstall: register.php remove os-mdns-bridge (metadata is gone
  by then, so it unregisters)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
jochen approved these changes 2026-11-11 08:08:18 +00:00
jochen merged commit aebc884eb2 into master 2026-11-11 08:10:38 +00:00
jochen deleted branch fix/plugin-register 2026-11-11 08:10:38 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
jochen/mdns-bridge!29
No description provided.