From 3868eb31aa869d5d39e61b7fd44ccbc99b103ebd Mon Sep 17 00:00:00 2001 From: Kevin Janssen Date: Tue, 17 Nov 2026 18:07:09 +0100 Subject: [PATCH] Accept real Windows Update installation and native restart recovery --- .../windows-update-installation-20261117.json | 110 ++++++++++++++++++ docs/handover.md | 6 +- docs/mvp-completion-plan.md | 12 +- docs/windows-update-dev-window.md | 2 + 4 files changed, 124 insertions(+), 6 deletions(-) create mode 100644 docs/evidence/windows-update-installation-20261117.json diff --git a/docs/evidence/windows-update-installation-20261117.json b/docs/evidence/windows-update-installation-20261117.json new file mode 100644 index 0000000..180a0df --- /dev/null +++ b/docs/evidence/windows-update-installation-20261117.json @@ -0,0 +1,110 @@ +{ + "date": "2026-11-17", + "environment": "development", + "platform": "windows-x86_64-gnu", + "authorization": "Explicit user request to install real Windows Updates and restart this test VM if necessary", + "agent_id": "858a27db-8ba3-4a75-af51-66f6a0909a91", + "asset_id": "26d4cdef-dc84-47c3-8f49-49e22ef64ea8", + "agent_version": "0.1.4", + "preexisting_restart_requirement": { + "job": "84cc1051-e95c-4d98-988f-da5b3ff923bf", + "state": "failed", + "exit_code": 1, + "reboot_required": true, + "status": "restart_pending" + }, + "restart": { + "scheduled": true, + "boot_before": "2026-11-14T12:26:49.3911430Z", + "agent_id": "858a27db-8ba3-4a75-af51-66f6a0909a91", + "delay_seconds": 20, + "origin": "authorized development SSH maintenance" + }, + "boot_after": "2026-11-17T16:43:17.5000000Z", + "windows_time_service": { + "utc": "2026-11-17T16:54:30.7486108Z", + "service": "Running", + "startup": "Auto", + "status": "Sprungindikator: 0(keine Warnung)\nStratum: 5 (Sekund�rreferenz - synchr. �ber (S)NTP)\nPr�zision: -23 (119.209ns pro Tick)\nStammverz�gerung: 0.0246275s\nStammabweichung: 8.4119144s\nReferenz-ID: 0x33917B1D (Quell-IP: 51.145.123.29)\nLetzte erfolgr. Synchronisierungszeit: 17.11.2026 17:54:04\nQuelle: time.windows.com,0x9 \nAbrufintervall: 10 (1024s)\n" + }, + "bounded_time_correction": { + "ntp_reference": "time.windows.com", + "measured_offset_seconds": -0.6382626, + "utc_before": "2026-11-17T16:57:23.9464196Z", + "utc_after": "2026-11-17T16:57:23.3180395Z", + "resync_exit": 0 + }, + "plan_and_approval": { + "revision": "0f7c8eca-ac4e-4697-b912-6479dfa4ecae", + "version": 1, + "plan": "f3f0aa7e-0741-4ced-a243-65fc815a75af", + "plan_hash": "820e2384e46370a1a86fc52d1e81fbca52505c27689ea98d7b4b0d5f34ab370d", + "job": "6d5f9437-8285-4158-bdb0-7a73493f86d2", + "attempt": "8d653eaf-0be0-4a44-909c-572217d320c7", + "job_payload_hash": "b6cdaadc4c496c7f4f61e1449d31a6bed5fa935925395a4dbce643972b4bdc8d", + "agent": "858a27db-8ba3-4a75-af51-66f6a0909a91", + "asset": "26d4cdef-dc84-47c3-8f49-49e22ef64ea8", + "operation": "10380fe3-b9bd-4bad-b5c9-e144448c5f50", + "preapproval_job_count": 0, + "approval": "dev_test_browser_simulation", + "approved_at": "2026-11-17T17:00:04.122Z", + "ui_result": true, + "stdout": "{\"id\":\"20a25326-d78f-4a69-bc81-fa8430093374\",\"title\":\"Windows-Tool zum Entfernen b�sartiger Software x64 - v5.147 (KB890830)\",\"status\":2,\"hresult\":0,\"reboot_required\":false}\\u000d\n{\"reboot_required\":false,\"found\":1}\\u000d\n", + "observed_at": "2026-11-17T17:03:24.561Z" + }, + "script_sha256": "0fa5f513a06b6cf902a3f9ac1989987642c181eedd6c305b3912771bd10f2ebf", + "outcome": { + "job": "6d5f9437-8285-4158-bdb0-7a73493f86d2", + "attempt": "8d653eaf-0be0-4a44-909c-572217d320c7", + "state": "succeeded", + "revision": 2, + "exit_code": 0, + "reboot_required": false, + "stdout_base64": "eyJpZCI6IjIwYTI1MzI2LWQ3OGYtNGE2OS1iYzgxLWZhODQzMDA5MzM3NCIsInRpdGxlIjoiV2luZG93cy1Ub29sIHp1bSBFbnRmZXJuZW4gYpRzYXJ0aWdlciBTb2Z0d2FyZSB4NjQgLSB2NS4xNDcgKEtCODkwODMwKSIsInN0YXR1cyI6MiwiaHJlc3VsdCI6MCwicmVib290X3JlcXVpcmVkIjpmYWxzZX0NCnsicmVib290X3JlcXVpcmVkIjpmYWxzZSwiZm91bmQiOjF9DQo=", + "stdout_encoding": "OEM CP850, raw native bytes retained", + "parsed_lines": [ + { + "id": "20a25326-d78f-4a69-bc81-fa8430093374", + "title": "Windows-Tool zum Entfernen bösartiger Software x64 - v5.147 (KB890830)", + "status": 2, + "hresult": 0, + "reboot_required": false + }, + { + "reboot_required": false, + "found": 1 + } + ], + "stderr_bytes": 0, + "ui_result_verified": true + }, + "independent_native_verification": { + "system_event_id": 19, + "system_event_record": 1567, + "system_event_time_utc": "2026-11-17T17:01:37.7856413Z", + "update_id": "20a25326-d78f-4a69-bc81-fa8430093374", + "update_revision": 201, + "matching_completed_native_consumptions_per_lane": 1, + "matching_start_evidence_bytes_per_lane": 14243, + "matching_outcome_bytes_per_lane": 2274, + "native_outcome_sha256": "9351f221df7897a45a58d114d42bf70fda273d45486c0ce5d3eef3c8c3487ee0", + "execution_sid": "S-1-5-18", + "windows_update_reboot_marker": false, + "cbs_reboot_marker": false, + "marker_readback_utc": "2026-11-17T17:03:28Z" + }, + "final_state": { + "contact": "2026-11-17T17:05:33.327672+00:00", + "sync_ready": true, + "helper_service": null, + "system_capability": false, + "open_jobs": 0, + "agent": "Running", + "release_puller": "Running" + }, + "notes": [ + "The first maintenance restart was performed through the pinned development SSH connection. It is an external VM-maintenance observation, not an acceptance of the RMM reboot job.", + "The original install attempt briefly reported unknown. It reconciled to succeeded revision 2 from matching native outcome bytes without any new attempt.", + "Native CP850 output bytes are preserved. The UTF-8 text view renders one German umlaut incorrectly; KB, version, status and raw bytes are verifiable." + ] +} diff --git a/docs/handover.md b/docs/handover.md index fe9e537..17997e5 100644 --- a/docs/handover.md +++ b/docs/handover.md @@ -2,9 +2,11 @@ **Der nächste Auftrag steht im [Umsetzungsplan](mvp-completion-plan.md).** Er enthält den letzten Betriebsbefund je Nutzeranforderung und die Reihenfolge für die nächste Lieferung. [Entwicklungsbefehle](development.md) und [Zugänge](operations-access.md) beschreiben den Arbeitsweg. -**Abschlussstand am 17. November, 17:08 Uhr MEZ.** API und Gateway laufen mit Revision `a799272` und Datenbankschema 25. Der abgegrenzte Lieferstand liegt auf `codex/mvp-development-release`. Der ausgecheckte Lieferstand liegt auf `codex/mvp-development-release`. Ältere, noch gesondert zu prüfende Arbeiten sind im Arbeitsbaum erhalten. +**Abschlussstand am 17. November, 18:05 Uhr MEZ.** Der Lieferbranch ist `codex/mvp-development-release`. API und Gateway laufen mit Revision `a799272`, Datenbankschema 25. Die WebUI wurde separat mit der geprüften 3.600-Sekunden-Planvalidierung bereitgestellt. Linux betreibt `0.1.0-mvp.2`, Windows GNU `0.1.4`. Ältere aufgabenfremde Arbeiten sind im Arbeitsbaum erhalten. -Der Windows-Agent hat um 15:45:22 UTC nach der gezielten Workerreparatur selbstständig `0.1.3` aktiviert. Beide Dienste laufen, Sync ist bereit, die Geräteidentität `858a27db…` blieb gleich und der Prozesshash stimmt mit dem signierten Release überein. Der zuvor unter `0.1.2` ausgeführte Bibliotheksauftrag ist genau einmal erfolgreich abgeschlossen. Der stabile Prüfer `de75510b…` ist außerdem für neue Installer im Entwicklungsmandanten veröffentlicht. Auch der nächste reguläre Versionswechsel auf `0.1.4` ist nativ mit passendem Prozesshash und bereitem Sync nachgewiesen. Die separate SYSTEM-Identitätsprobe lieferte über WebUI und MCP `S-1-5-18` mit Exitcode 0. Der zentrale Wartungsscope ist geschlossen und der temporäre Helper entfernt. Nach der kontrollierten Archivierung der terminalen Arbeitsprojektionen meldeten beide Produktgeräte um 16:08 UTC wieder bereiten Sync. Windows-Agent und Updatedienst laufen, die SYSTEM-Capability ist entzogen. Die nächste Abnahme steht im [Lieferplan](mvp-completion-plan.md). [Windows-Beleg](evidence/windows-https-release-20261117.json) +Die beiden zuletzt offenen Punkte sind erledigt. Die Windows-Test-VM hat KB890830 v5.147 über die gespeicherte Updatevorlage installiert. Ein vorbestehender Neustartbedarf wurde vorher durch einen autorisierten administrativen SSH-Neustart behoben. Der ursprüngliche Installationsversuch wurde genau einmal ausgeführt und nach signiertem Abgleich als erfolgreich bestätigt. Windows-Ereignis 19 und beide nativen Journale bestätigen die Installation. Ein weiterer Neustart war nicht erforderlich. Agent und Updater laufen nach geschlossenem Wartungsfenster wieder, Sync ist bereit und SYSTEM-Rechte sind entzogen. [Installation](evidence/windows-update-installation-20261117.json) + +Der frühe Abbruch wurde mit einem tatsächlich beendeten Controller und unabhängigem Wiederanlauf geprüft. Auch ein leerer Helperkopf ohne jemals angewendete Entscheidung wird nun gebunden archiviert und zurückgebaut. Die Windows-Zeitsynchronisation ist aktiviert. [Wiederanlauf](evidence/windows-update-early-abort-20261117.json) Die ausdrücklich zur Löschung benannte Entwicklungsanfrage ist entfernt. Beide registrierten Testgeräte laufen über HTTPS-Polling. Den Bereinigungs- und Journalnachweis sowie die aktiven Buildrevisionen im [Lieferplan](mvp-completion-plan.md) verwenden. Die [frühere Bestandsaufnahme](evidence/product-audit-20261117.json) zeigt den Zustand vor der Bereinigung. diff --git a/docs/mvp-completion-plan.md b/docs/mvp-completion-plan.md index 627044d..2e0b9d2 100644 --- a/docs/mvp-completion-plan.md +++ b/docs/mvp-completion-plan.md @@ -1,6 +1,6 @@ # Lieferplan für Skriptverwaltung, Installation und Agentupdates -**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) +**Abschlussstand 17. November 2026. Echte Windows-Updates und der Wiederanlauf nach frühem Abbruch sind nativ abgenommen.** 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 @@ -8,7 +8,7 @@ | --- | --- | --- | | Server, WebUI und MCP | Dedizierter ARM64-Server mit TLS, getrenntem Gateway und privater Verwaltung. Die WebUI genehmigte je eine feste Skriptrevision auf Linux und Windows. MCP und WebUI lieferten dieselbe Ausgabe und dieselbe Versuch-ID. | [Ergebnisse beider Geräte](evidence/script-library-acceptance-20261117.json) | | Linux- und Windows-Client | Auf beiden Gästen HTTPS-Polling mit mehreren echten Kontakten. Ein Leerlaufkontakt übermittelt Inventar und Heartbeats auch bei leerer Auftragsliste. | [Bereinigung und Geräteabgleich](evidence/dev-cleanup-pull-20261117.json) | -| Skriptbibliothek | Versionierte, mandantengebundene Skripte, feste Revision im Plan, WebUI und MCP. Die Windows-Update-Vorlage ist enthalten. | SYSTEM-Identitätsprobe über WebUI/Pull mit Exitcode 0. Eigentliche OS-Updateinstallation braucht einen eigenen Wartungsauftrag. | +| Skriptbibliothek | Versionierte, mandantengebundene Skripte, feste Revision im Plan, WebUI und MCP. Die Windows-Update-Vorlage ist enthalten. | KB890830 v5.147 über den festen SYSTEM-Bibliotheksauftrag installiert. [Installationsbeleg](evidence/windows-update-installation-20261117.json) | | Veröffentlichung und Erstaufnahme | Auf dem dedizierten Server liegen signierte Linux- und Windows-GNU-Releases. Beide öffentlichen Installer wurden mit einem per WebUI erzeugten Einmalcode auf den Testgästen erfolgreich ausgeführt. | Regulärer PowerShell-Auftrag auf dem frisch aufgenommenen Windows-Gerät mit Exitcode 0. | | Selbstupdate | Linux wechselte auf `0.1.0-mvp.2`, der frische Windows-GNU-Client nach seinem Skriptauftrag auf `0.1.3` und anschließend `0.1.4`. Prozesshash und Geräteidentität wurden nativ geprüft. | [Linux](evidence/linux-public-installer-update-20261117.json) · [Windows](evidence/windows-https-release-20261117.json) | | Entwicklungsbereitstellung | Linux-, Windows- und ARM64-Builder nutzen feste Git-Revisionen. SSH-Staging prüft den übertragenen Hash. Der Serverrunner prüft laufende Binärdatei, Migrationen, beide TLS-Healthchecks und die ausgelieferte WebUI. | Siehe [Entwicklungsbefehle](development.md). | @@ -30,7 +30,7 @@ „Windows-Updates installieren“ ist eine versionierte PowerShell-Vorlage im serverseitigen Katalog. Sie verwendet die Windows Update Agent API, protokolliert die Ergebnisse je Update und meldet den Neustartbedarf. Der feste Plan bindet Skriptinhalt, Ziel, SYSTEM-Rechte und Zeitlimit. Nur für die freigegebene Vorlagenrevision kann die gesonderte Wartungsrichtlinie bis zu 3.600 Sekunden zulassen. [Vorlagentext](../crates/domain/src/windows_update.ps1) · [Laufzeitprüfung](../crates/domain/src/jobs.rs) -Der Windows-Installer richtet den Agenten als LocalService ein. Der [Dev-Operator](windows-update-dev-window.md) richtet für die konkrete Geräteidentität und das signierte Agentpaar ein befristetes Wartungsfenster ein. Auf Windows `0.1.4` wurde die feste lesende Identitätsabfrage über die sichtbare dev/test-WebUI genehmigt und als regulärer Pullauftrag genau einmal mit Exitcode 0 und `S-1-5-18` ausgeführt. WebUI und MCP zeigen denselben Versuch. Anschließend wurden der zentrale Scope entzogen, der lokale Helper entfernt und die exakt gebundenen abgeschlossenen Arbeitsprojektionen archiviert. Ein neuer Geräteabgleich bestätigte um 16:08 UTC `sync_ready=true` ohne SYSTEM-Capability, bei laufendem Agent und Updatedienst. Die tatsächliche OS-Updateinstallation bleibt ein eigener Wartungsauftrag. [Nachweis für Einrichtung, Ausführung und Rückbau](evidence/windows-update-window-20261117.json) +Der Windows-Installer richtet den Agenten als LocalService ein. Der [Dev-Operator](windows-update-dev-window.md) richtet für die konkrete Geräteidentität und das signierte Agentpaar ein befristetes Wartungsfenster ein. Auf Windows `0.1.4` wurde die feste lesende Identitätsabfrage über die sichtbare dev/test-WebUI genehmigt und als regulärer Pullauftrag genau einmal mit Exitcode 0 und `S-1-5-18` ausgeführt. WebUI und MCP zeigen denselben Versuch. Anschließend wurden der zentrale Scope entzogen, der lokale Helper entfernt und die exakt gebundenen abgeschlossenen Arbeitsprojektionen archiviert. Ein neuer Geräteabgleich bestätigte um 16:08 UTC `sync_ready=true` ohne SYSTEM-Capability, bei laufendem Agent und Updatedienst. Am 17. November installierte der separat genehmigte Auftrag KB890830 v5.147 mit Exitcode 0, WUA-Resultcode 2 und HRESULT 0. Das Windows-Systemprotokoll bestätigt Ereignis 19. Ein bereits vorher erforderlicher Neustart wurde administrativ ausgeführt und anhand der neuen Bootzeit bestätigt. Danach waren WUA- und CBS-Neustartmarker gelöscht. [Echte Installation](evidence/windows-update-installation-20261117.json) [Nachweis für Einrichtung, Ausführung und Rückbau](evidence/windows-update-window-20261117.json) ### 4 · Signierte Binaries zentral veröffentlichen — im Entwicklungsmandanten nachgewiesen @@ -57,10 +57,14 @@ Aus einem sauberen Klon von `95aa707` wurden drei Buildpläne geprüft und der R ## Fortsetzung nach dieser Lieferung -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. +Den aktuellen Kernablauf mit den vorhandenen Build-, Deployment- und Operatorbefehlen benutzen. Die Windows-Updatevorlage ist mit einer tatsächlichen Installation und dokumentiertem Neustartbedarf abgenommen. 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) + +### Tatsächliche Updateinstallation — abgenommen + +Der ursprüngliche Installationsversuch `6d5f9437…` wurde nach kurzzeitigem `unknown` durch den signierten Abgleich als `succeeded`, Revision 2 bestätigt. Es gab genau einen nativen Grantverbrauch und Start je Ledger, keinen weiteren Versuch. Das Wartungsfenster wurde anschließend geschlossen. Um 17:05 UTC liefen Agent und ReleasePull mit bereitem Sync, ohne SYSTEM-Fähigkeit und ohne offene Jobs. Die Windows-Zeitsynchronisation wurde aktiviert und ihre zuvor gemessene Abweichung korrigiert. Die WebUI erlaubt nun das feste 3.600-Sekunden-Budget der Originalvorlage auch in der gemeinsamen Planprüfung. Drei Python-Zeitstempelregressionen und 68 WebUI-Tests bestanden. [Gesamtbeleg](evidence/windows-update-installation-20261117.json) diff --git a/docs/windows-update-dev-window.md b/docs/windows-update-dev-window.md index c017da9..9690487 100644 --- a/docs/windows-update-dev-window.md +++ b/docs/windows-update-dev-window.md @@ -44,3 +44,5 @@ 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. + +Die echte Installation von KB890830 v5.147 und der zugehörige administrative Wartungsneustart sind [nativ belegt](evidence/windows-update-installation-20261117.json). Dabei wurde der zuvor gestoppte Windows-Zeitdienst aktiviert und eine gemessene Zeitabweichung korrigiert. Native CP850-Ausgabebytes bleiben unverändert erhalten. Die UTF-8-Textansicht zeigt bei einem Umlaut weiterhin ein Ersatzzeichen.