Recover a Windows maintenance setup interrupted before policy activation

This commit is contained in:
2026-11-17 17:32:17 +01:00
parent fe55995154
commit 8c39e79a79
9 changed files with 303 additions and 63 deletions
@@ -0,0 +1,58 @@
{
"schema_version": 1,
"date": "2026-11-17",
"environment": "development",
"test_command": "python3 tests/windows_update_early_abort.py --execute",
"platform": "windows-x86_64-gnu",
"agent_version": "0.1.4",
"case_id": "ef29ea93-b730-4fdc-861e-46a4ba632c25",
"enrollment": {
"agent_id": "858a27db-8ba3-4a75-af51-66f6a0909a91",
"agent_sha256": "f30ffac8b9f674c4933d50645bf93f6ee89442608ff73f597cedef3a42172292",
"asset_id": "26d4cdef-dc84-47c3-8f49-49e22ef64ea8",
"helper_binary_sha256": "eeb81736a3ddf297230d808b81f4fbf29f5ebe29723fc298455746f3e4b8f2b7",
"release_id": "3dcb2484-fb2d-418d-84f0-aa54f5c4c209",
"tenant_id": "11111111-1111-4111-8111-111111111111"
},
"prepared": {
"at": "2026-11-17T16:29:13.662531+00:00",
"signed_decision_id": "145ae67c-f6e4-46dc-85d6-fe8b24547e9e",
"checkpoint": 453,
"journal_id": "0c1ec1d3-c868-42f7-a783-70d99a4f9636",
"helper_journal_id": null,
"helper_checkpoint": 0
},
"injected_failure": {
"actual_controller_exit_code": 85,
"before_central_activation": true,
"first_observed_authenticated_scoped_heartbeat": "2026-11-17T16:30:21.655709+00:00",
"sync_ready": true,
"helper_sync_ready": true,
"signed_head": {
"checkpoint": 476,
"decision_id": "5eda9bd1-6cd8-4475-a317-25436e610312",
"helper_checkpoint": 3,
"helper_id": "aef1b629-f417-4dc3-9bd7-ef6be94ec7b8",
"journal_id": "0c1ec1d3-c868-42f7-a783-70d99a4f9636"
},
"open_jobs": 0
},
"recovery": {
"separate_process": "python3 tools/windows_update_scope.py close --case ef29ea93-b730-4fdc-861e-46a4ba632c25",
"central_tombstone_at": "2026-11-17T16:30:25.544765+00:00",
"window_candidate_persisted": false,
"new_system_jobs_or_grants_since_preparation": 0,
"native_verified_decision_id": "5eda9bd1-6cd8-4475-a317-25436e610312",
"native_archived_attempts": 0,
"central_helper_detach_committed": true,
"native_helper_detach_committed": true,
"helper_service_registered": false,
"agent_service": "Running",
"release_pull_service": "Running",
"post_close_contact": "2026-11-17T16:30:43.878785+00:00",
"sync_ready": true,
"system_caps": false,
"open_jobs": 0
},
"result": "passed"
}
+5 -1
View File
@@ -1,6 +1,6 @@
# Lieferplan für Skriptverwaltung, Installation und Agentupdates
**Stand 17. November 2026. Die Kernstrecke des Entwicklungs-MVP ist auf Linux und Windows nativ nachgewiesen.** Ziel ist ein Gerät, das sich per HTTPS-Installer anmeldet, im Leerlauf Inventar meldet, einen Bibliotheksauftrag abholt, sein Ergebnis liefert und den nächsten signierten Release selbst übernimmt. [Produktvertrag](../Rust_RMM_Implementierungsspezifikation.md)
**Fortsetzung am 17. November 2026. Beauftragt sind die echte Windows-Updateinstallation einschließlich erforderlicher Wartungsneustarts und der Wiederanlauf nach frühem Abbruch der Wartungseinrichtung.** Ziel ist ein Gerät, das sich per HTTPS-Installer anmeldet, im Leerlauf Inventar meldet, einen Bibliotheksauftrag abholt, sein Ergebnis liefert und den nächsten signierten Release selbst übernimmt. [Produktvertrag](../Rust_RMM_Implementierungsspezifikation.md)
## Produkt und Betriebsstand
@@ -60,3 +60,7 @@ Aus einem sauberen Klon von `95aa707` wurden drei Buildpläne geprüft und der R
Den aktuellen Kernablauf mit den vorhandenen Build-, Deployment- und Operatorbefehlen benutzen. Eine tatsächliche Windows-Updateinstallation mit Ergebnis je Update und festgestelltem Neustartbedarf kann als eigener Wartungsauftrag abgenommen werden. Dafür das dokumentierte Fenster öffnen, die gespeicherte Updatevorlage wählen und den festen Plan in der WebUI genehmigen. Den automatischen Agentversionswechsel und bereits erfolgreiche Bibliotheksaufträge nur bei einem betroffenen Fehler erneut abnehmen.
Der integrierte Quellstand liegt auf `codex/mvp-development-release`. Die auf dem dedizierten Server aktivierte API-/Gatewayrevision ist `a799272`, Datenbankschema 25. Linux betreibt Release `0.1.0-mvp.2`, Windows GNU `0.1.4`. Ältere, aufgabenfremde Arbeiten liegen weiterhin gesondert im Arbeitsbaum.
### Wiederanlauf nach frühem Abbruch — nativ abgenommen
Der Controller wurde nach registriertem Helperkontakt vor der zentralen Freigabe mit Exitcode 85 beendet. Ein unabhängiger erneuter Aufruf stellte den normalen Geräteabgleich wieder her. Geräteidentität, Archivnachweise und Release blieben gebunden, die Probe erzeugte keine Aufträge. [Abnahme vom 17. November](evidence/windows-update-early-abort-20261117.json)
+4
View File
@@ -2,6 +2,10 @@
Stand: **2026-11-17**, Spezifikation **1.34** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung.
## Native Windows-Updateabnahme am 17. November 2026
Der Betreiber hat die Installation echter Windows-Updates auf der Windows-Test-VM, erforderliche Wartungsneustarts und die Prüfung des Wiederanlaufs nach einem frühen Abbruch der Wartungseinrichtung ausdrücklich beauftragt. Die Updatevorlage wird als eigener fester Bibliotheksauftrag über die WebUI genehmigt. Ein benötigter administrativer Neustart der Entwicklungs-VM kann über den geprüften SSH-Zugang erfolgen und wird mit Bootwechsel und anschließendem Agentkontakt belegt.
## Entwicklungsdaten und MVP-Abnahme (Version 1.34)
Der Betreiber hat für das Entwicklungssystem die Löschung der benannten Anfrage und der blockierenden Testdaten freigegeben. Eine frische Geräteidentität ist für die Installationsabnahme zulässig. Der reguläre Updatepfad erhält die Identität. Der Windows-GNU-Entwicklungsbuild ist als eigener signierter Release adressierbar. Für die mitgelieferte unveränderte Windows-Update-Vorlage dürfen feste Freigabe, Server- und Helperpolicy bei passender Capability bis 3600 Sekunden erlauben. Der dedizierte Gateway stellt den Geräteauftrag über HTTPS-Polling zu. Der Entwicklungsoperator darf nach geschlossenem Wartungsscope, terminalem Ergebnis und geprüftem Geräte-/Releasebezug die abgeschlossenen lokalen Arbeitsprojektionen archivieren und die dazugehörige Helper-Zuordnung lösen. Das ermöglicht den Rückbau eines temporären Wartungshelpers. Serverergebnisse und native Ausführungsnachweise werden dabei erhalten. [Bereinigungsnachweis](evidence/dev-cleanup-pull-20261117.json)
+10 -2
View File
@@ -15,7 +15,7 @@ Auf dem per HTTPS aufgenommenen Windows-Testgerät läuft der Agent als LocalSer
python3 tools/windows_update_scope.py window --minutes 15
```
Der Befehl gibt die Fall-ID aus. Der Dev-Operator setzt die aktuelle HTTPS-Erstaufnahme mit Enrollmentgeneration 1 und Zuweisungsversion 1 voraus. Beim Öffnen prüft er die signierte Paarversion, den laufenden Agenten und seine Gerätebindung. Der Server aktiviert die Richtlinie erst nach einem aktuellen, passenden Geräte-Heartbeat. Die einzige zugelassene Bedienperson im Entwicklungsprofil ist `simulated-testprincipal-a`. Das Release-Polling pausiert während des Fensters. Die Ablaufzeit des Fensters steht in UTC in der Ausgabe. Ein anderes noch aktives SYSTEM-Fenster bleibt dem bisherigen Betreiber zugeordnet.
Der Befehl gibt die Fall-ID aus. Der Dev-Operator setzt die aktuelle HTTPS-Erstaufnahme mit Enrollmentgeneration 1 und Zuweisungsversion 1 voraus. Vor der ersten Geräteänderung speichert der Server die Fall-ID, den signierten Ausgangscheckpoint, beide Binärhashes und die ursprüngliche Richtlinie. Beim Öffnen prüft der Operator die signierte Paarversion, den laufenden Agenten und seine Gerätebindung. Nach einem passenden Geräte-Heartbeat und einer aktuellen signierten Helper-Uhr meldet der Operator `central_scope_open`. Ab dann steht die Richtlinie bereit. Die einzige zugelassene Bedienperson im Entwicklungsprofil ist `simulated-testprincipal-a`. Das Release-Polling pausiert während des Fensters. Die Ablaufzeit des Fensters steht in UTC in der Ausgabe. Ein anderes noch aktives SYSTEM-Fenster bleibt dem bisherigen Betreiber zugeordnet.
3. In der privaten WebUI das Windows-Gerät und die gewünschte gespeicherte Skriptversion wählen. Zur Prüfung der Identität eine Bibliotheksrevision für Windows PowerShell und Identität `system` verwenden. Der Skripttext ist die folgende Zeile mit genau einem abschließenden LF.
@@ -35,4 +35,12 @@ Auf dem per HTTPS aufgenommenen Windows-Testgerät läuft der Agent als LocalSer
Die native Identitätsabfrage und der vollständige Rückbau sind im [Entwicklungsnachweis vom 17. November](evidence/windows-update-window-20261117.json) dokumentiert.
Bei einem Abbruch der allerersten Einrichtung vor der zentralen Fensterakte kann bereits eine Helper-Journalzuordnung bestehen. Der Operator verlangt dann eine fallbezogene Prüfung der Geräte- und Journalbindung. Der automatische Rückbau dieses frühen Abbruchfalls ist noch nicht abgenommen.
Derselbe `close --case` schließt eine abgebrochene Einrichtung, sobald die Fall-ID ausgegeben wurde. War der Helper schon synchronisiert, vergleicht der Controller den ursprünglichen und den aktuellen signierten Checkpoint mit den lokalen Journalen. Zum Abschluss müssen Agent und Release-Polling laufen und ein neuer synchroner Heartbeat ohne SYSTEM-Fähigkeiten vorliegen.
Die [native Abbruchabnahme](evidence/windows-update-early-abort-20261117.json) beendet den Controller nach dem ersten passenden authentisierten Helper-Heartbeat und vor dem Öffnen der Richtlinie. Auf einem freien Windows-Entwicklungsgerät lässt sich der Ablauf wiederholen.
```sh
python3 tests/windows_update_early_abort.py --execute
```
Auch nach einem abgebrochenen Test gibt der Befehl die Fall-ID aus, mit der sich der Rückbau fortsetzen lässt.