Plugin: Modell-Migration scheitert bei Neuinstallation #33

Merged
jochen merged 2 commits from fix/fresh-install-migration into master 2026-11-11 15:32:23 +00:00
Collaborator

Problem

Bei einer Neuinstallation (ohne vorhandene Einstellungen) meldet das post-install:

Failed OPNsense\MDNSBridge\MDNSBridge from 0.0.0 to 1.1.0

run_migrations.php migriert das Modell von 0.0.0 und prüft die daraus entstehende Standardkonfiguration. general.site_id ist ein Pflichtfeld, hatte aber keinen Default. Es bleibt also leer, die Validierung schlägt fehl, und die Modellversion wird nicht gespeichert. Upgrades von der ersten GUI-Version waren nicht betroffen, weil dort schon eine Site-ID gesetzt war.

Änderung

  • site_id hat jetzt den Default 1. Der Hilfetext sagt, dass jeder Standort eine eigene Site-ID braucht.
  • Neuer CI-Check opnsense/tests/check_model.py: Jedes Pflichtfeld außerhalb von ArrayFields muss einen Default haben. Gegen den alten Stand meldet er genau general.site_id, mit dem Fix 0 Probleme.

Die OPNsense-Migration selbst kann ich hier nicht ausführen. Die Ursache ist abgeleitet: Laut OPNsense-Doku muss der Standardstand die Validierung bestehen, und site_id war das einzige Pflichtfeld ohne Default. Bestätigen lässt sich das mit der Syslog-Zeile failed migrating from version 0.0.0 ....

Version unverändert. Für ein Release 0.1.1 müssten Cargo.toml/Cargo.lock und PLUGIN_VERSION hochgezählt werden.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp

## Problem Bei einer Neuinstallation (ohne vorhandene Einstellungen) meldet das post-install: ``` Failed OPNsense\MDNSBridge\MDNSBridge from 0.0.0 to 1.1.0 ``` `run_migrations.php` migriert das Modell von 0.0.0 und prüft die daraus entstehende Standardkonfiguration. `general.site_id` ist ein Pflichtfeld, hatte aber keinen Default. Es bleibt also leer, die Validierung schlägt fehl, und die Modellversion wird nicht gespeichert. Upgrades von der ersten GUI-Version waren nicht betroffen, weil dort schon eine Site-ID gesetzt war. ## Änderung - `site_id` hat jetzt den Default 1. Der Hilfetext sagt, dass jeder Standort eine eigene Site-ID braucht. - Neuer CI-Check `opnsense/tests/check_model.py`: Jedes Pflichtfeld außerhalb von ArrayFields muss einen Default haben. Gegen den alten Stand meldet er genau `general.site_id`, mit dem Fix 0 Probleme. Die OPNsense-Migration selbst kann ich hier nicht ausführen. Die Ursache ist abgeleitet: Laut OPNsense-Doku muss der Standardstand die Validierung bestehen, und `site_id` war das einzige Pflichtfeld ohne Default. Bestätigen lässt sich das mit der Syslog-Zeile `failed migrating from version 0.0.0 ...`. Version unverändert. Für ein Release 0.1.1 müssten `Cargo.toml`/`Cargo.lock` und `PLUGIN_VERSION` hochgezählt werden. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
Plugin: fresh install fails the model migration (site_id has no default)
All checks were successful
build-freebsd / freebsd (pull_request) Successful in 2m56s
build-freebsd / release (pull_request) Has been skipped
ci / rust (push) Successful in 3m22s
ci / rust (pull_request) Successful in 3m21s
cc05fae01d
On a box without saved settings, run_migrations.php migrates the model
from 0.0.0 and validates the resulting default configuration. general.
site_id was required without a default, so it was empty and the step
failed: "Failed OPNsense\MDNSBridge\MDNSBridge from 0.0.0 to 1.1.0".
Upgrades from the first GUI version were not affected - their config
already had a site ID.

- site_id defaults to 1 (help text: give every site its own).
- opnsense/tests/check_model.py, run in CI: every required field
  outside an ArrayField must have a default.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
build-plugin.sh: clear the menu/ACL cache in /var/lib/php/tmp
All checks were successful
build-freebsd / freebsd (pull_request) Successful in 2m59s
build-freebsd / release (pull_request) Has been skipped
ci / rust (push) Successful in 3m25s
ci / rust (pull_request) Successful in 3m26s
7cb5756cf4
Current OPNsense keeps opnsense_menu_cache.xml and opnsense_acl_cache.json
in /var/lib/php/tmp, not in /tmp. post-install only removed the /tmp
copies, so on a fresh install the stale menu stayed and Services: mDNS
Bridge did not appear. Both locations are cleared now.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
Author
Collaborator

Zweites Problem bei Neuinstallation, im selben PR behoben (7cb5756): Services: mDNS Bridge tauchte im Menü nicht auf.

Ursache: Aktuelle OPNsense-Versionen legen den Menü- und ACL-Cache in /var/lib/php/tmp/ ab (opnsense_menu_cache.xml, opnsense_acl_cache.json), nicht in /tmp/. Das post-install und das post-deinstall haben nur die Dateien in /tmp gelöscht, deshalb blieb das alte Menü ohne den neuen Eintrag stehen. Auf dem Testsystem gefunden; nach dem Löschen war der Eintrag da.

Jetzt werden beide Orte geleert.

🤖 Generated with Claude Code

Zweites Problem bei Neuinstallation, im selben PR behoben (7cb5756): **Services: mDNS Bridge** tauchte im Menü nicht auf. Ursache: Aktuelle OPNsense-Versionen legen den Menü- und ACL-Cache in `/var/lib/php/tmp/` ab (`opnsense_menu_cache.xml`, `opnsense_acl_cache.json`), nicht in `/tmp/`. Das post-install und das post-deinstall haben nur die Dateien in `/tmp` gelöscht, deshalb blieb das alte Menü ohne den neuen Eintrag stehen. Auf dem Testsystem gefunden; nach dem Löschen war der Eintrag da. Jetzt werden beide Orte geleert. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
jochen approved these changes 2026-11-11 15:32:16 +00:00
jochen merged commit a128f14633 into master 2026-11-11 15:32:23 +00:00
jochen deleted branch fix/fresh-install-migration 2026-11-11 15:32:24 +00:00
claude referenced this pull request from a commit 2026-11-11 15:59:30 +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!33
No description provided.