Files
rust-discovery/docs/windows-system-delegation-upgrade.md
T
2026-11-14 11:38:42 +01:00

151 lines
9.4 KiB
Markdown

# Gemeinsames passives Windows-Komponentenupgrade
Stand 2026-11-14: **Passive Wartung nach separat dokumentiertem ersten APIfehler und
enger Recovery abgeschlossen. Positive Pipeabnahme weiterhin fehlgeschlagen.**
Lokale Guards und PowerShell-Parserprüfung ersetzen weder
die neuen nativen Unitnachweise noch den tatsächlichen Erhaltungs-/Pipebeleg.
Der Notebookhost bleibt ausschließlich Entwicklungsrechner.
`deploy/windows/system_delegation_upgrade.py` ist eine eigene enge Strecke für
den vorhandenen Agenten `2beed7fa…` und Helper `921cf182…`, zuletzt PID5140/6240.
Die historischen Runtime- und Helperbootstraprunner bleiben unverändert. Sie
eignen sich absichtlich nicht zur erneuten Installation oder zum Neustart eines
bereits vorhandenen Helperjournals. Der Originalfall `59c2fd6f…` bleibt erhalten.
Die neue Strecke benötigt das gemeinsame Artefaktmanifest und den tatsächlichen
nativen Unitbeleg aus `system_delegation_acceptance.py`. Sie bindet Agent, Helper,
unveränderten `RuntimeStateProbe.exe` und den neuen lesenden `SystemStateProbe.exe`.
Die gemeinsame Core-Qualifikation Linux80→Windows58 ist eine Voraussetzung;
sie ist keine native Windows-Pipe- oder SCM-Wirkungsabnahme.
Der feste Ablauf speichert vor der Mutation lokale und entfernte Create-only-
Intents. Er hält die tatsächlichen Prozesshandles samt Startzeit, stoppt zuerst
den ursprünglichen Agenten und wartet auf dessen Prozessende; erst danach stoppt
er den ursprünglichen Helper. Beide Dienste müssen während sämtlicher
Dateitausche gestoppt bleiben. Alle vier Originalbackups werden vor dem ersten
`File.Replace` geschrieben und geprüft. Agent-EXE, Helper-EXE, `helper.json` und
`agent-pin.json` erhalten jeweils eigene CAS-/Phasenbelege und ihre bisherigen
Datei-ACLs. Erst nach Prüfung aller vier neuen Dateien darf der Helper einmal,
anschließend der Agent einmal gestartet werden. Die beiden Startbelege binden
PID und Prozessstartzeit auch beim späteren Finish.
Die beiden öffentlichen Konfigurationen ändern ausschließlich die zwei
Binaryhashes und den daraus berechneten Policyhash. Die sechs Agentconfigfelder,
Geräteidentität, Zertifikate und Schlüsselmetadaten bleiben erhalten. Private
Schlüsselbytes werden nicht gelesen oder übertragen. Dienste behalten Konten,
Startmodi, Service-SID-Typ, Kommandozeilen und Service-ACL-Hashes. Telemetrie und
Helperledger behalten ihre Dateiidentitäten, Erstellungszeiten, bestehenden
Schemas und Zeilenbelege. Zwischen Stopp und Neustart werden zusätzlich ihre
Dateibytes verglichen; danach darf die passive Telemetrie nur regulär fortschreiten.
Die separat nativ vorbereiteten Intentdateien aus Fall `f322a4d2…` werden über
dessen unveränderten Beleg `c4ef6fed…` gebunden: genau zwei reguläre 0-Byte-Blätter
mit unveränderten Dateiidentitäten und engen ACLs. Der Runner initialisiert sie
nicht und öffnet sie nicht als SQLite. Vorbereitung bedeutet weiterhin keine
PERSIST-/Hotjournal-, Agenttoken-Zugriffs- oder Delegationsqualifikation.
`enable_jobs=false`, kein Jobbinding, unqualifizierter Produktionsclockadapter,
`allowed_services=[]`, `enable_effects=false` und `allow_reboot=false` bleiben
unverändert. Der Runner führt keine RMM-Jobs, Paket-/Diensttests, Reboots,
Uhränderungen, Freigaben oder Servermutationen aus. Die einzigen Dienstaktionen
sind die ausdrücklich beauftragten Stopps/Starts dieser beiden eigenen
Komponenten. Staging benutzt den bekannten gepinnten SSH-/SFTP-Pfad und feste
hashgeprüfte PowerShell-Dateien mit RemoteSigned, keine freien Befehle oder
ExecutionPolicy-Umgehung. Bereits qualifiziert vorhandene Stageartefakte werden
anhand ihres exakten Hashpointers ausschließlich lesend verifiziert und nicht
erneut übertragen oder überschrieben.
Diagnosen sind auf den bestehenden Agentbeleg `state/helper-probe.json` und die
zwei festen Helperdateien `state/pipe-last-error.json` sowie deren bekannte
Stagingdatei `.pipe-last-error.pending` begrenzt. Helperdiagnosen sind maximal
1024Byte und enthalten ausschließlich Prozess-ID, Beobachtungszeit und feste
Fehlerstufen/-codes. Sie liefern keinen positiven Pipebeweis. Dieser benötigt
den frischen Beleg des tatsächlichen neuen Agentprozesses mit Challenge,
reziproken Pins und erfolgreich authentisiertem Austausch.
Bei Antwortverlust ist ausschließlich `readback --id …` zulässig. Dieser liest
auch einen Teilstand und wiederholt keinen Stop, Dateitausch oder Start. Es
gibt keinen automatischen Rollback, Retry, Journalreset oder Markerabbau.
`finish --id …` benötigt beide tatsächlichen neuen Einzelstartinstanzen,
Erhaltungsbelege, frische gespeicherte WSS-Heartbeats/Inventar-ACKs und unveränderte
Windows-/Linux-Jobzählungen sowie Servergates. Erst danach wird der bisherige
Runtimeindex per lokalem CAS um einen neuen Komponentenbeleg ergänzt. Ein noch
fehlgeschlagener Pipebeleg bleibt ausdrücklich fehlgeschlagen; ein erfolgreiches
passives Komponentenupgrade behauptet keine Jobfähigkeit.
Aufrufvorlagen; tatsächlichen Fallstand unten beachten:
```text
python3 deploy/windows/system_delegation_upgrade.py upgrade-passive --manifest <manifest.json> --qualification <passed.json>
python3 deploy/windows/system_delegation_upgrade.py readback --id <ursprüngliche UUID>
python3 deploy/windows/system_delegation_upgrade.py finish --id <ursprüngliche UUID>
```
## Tatsächlicher Fall6d2df065: erster Dateiaufruf fehlgeschlagen
Originalfall `6d2df065-0877-41c4-983c-2c9fdb6e5437` scheiterte zunächst vor dem
Server-Beforecheckpoint. Nach wiederhergestelltem gepinntem SSH-Zugang wurden
fehlender entfernter Fall/Activeintent und unveränderte Originalprozesse separat
lesend bestätigt. Ein zusätzlicher dauerhafter Fortsetzungsintent führte
ausschließlich die erste zuvor nicht erreichte Phase desselben Falls aus.
Originale Fehlermeldung und Quellen blieben erhalten, kein neuer Enrollment-
oder RMM-Jobkontext.
Native Stopps beider eigenen Dienste bestanden. Frozenbeleg und sämtliche vier
privaten Originalbackups wurden gespeichert. Beim ersten Dateitausch meldete
`[IO.File]::Replace($candidate,$destination,$null)` eine ArgumentException.
Sofortiger gesonderter Readback: Agent/HelperStopped, vier Zielhashesoriginal,
keine Replaced-/Swapped-/Startmarker. Eine weitere Nur-Leseprüfung bestätigt
Frozen-DBbytes, Zeilen, tatsächliche Dateiidentitäten und PKI-Metadaten erhalten.
Nur der erste Agentcandidate (exakter neuer Hash) und sein ursprünglicher
Replaceversuchsmarker existieren; andere Candidates/Replaceversuche fehlen.
Eigene native Einbyte-API-Fixture `45a21a07-a115-47ec-93e1-694aa519520a`:
Nullbackupaufruf reproduziert ArgumentException, Quelle/Destination unverändert;
separater Aufruf mit explizitem Backup schreibt erwartete Destination und
Originalbackup. Keine Runtime-Datei wurde durch diese Fixture berührt. Die
genauere interne PowerShell-/Framework-Konvertierungsursache wird daraus nicht
als bewiesen behauptet.
Der ursprüngliche Enter wird nicht erneut ausgeführt, Originalmarker und
Quellen nicht geändert. Eine separate create-only Recovery muss vor jeder
Fortsetzung diesen konkreten Vier-Dateien-/Frozen-/Nichtstartzustand bestätigen,
den existierenden ersten Candidate hashgeprüft erhalten und einen ausdrücklich
benannten zusätzlichen Nativebackup verwenden. Erst nach allen vier neuen
Datei-/ACL-/Frozenbelegen dürfen die bisher noch nicht versuchten eigenen
Helper-/Agentstarts folgen. Kein automatischer Retry oder Rücksetzen.
## Tatsächliche enge Recovery und Abschluss
Neue Quelle `deploy/windows/system_delegation_recovery.py`, SHA `64ced170…`,
Script `65e480f2…`, unabhängig geprüft und lokal Python-/PS-AST geprüft. Originale
Quelle `f8dc1c8f…` unverändert. Recoveryfall
`595dd1da-0d7f-4364-9040-a75e16c6da83` bestätigte separat den vollständigen
Stopped-/Frozen-/Datei-ID-/Candidatekontext und führte einmal vier Tausche mit
expliziten zusätzlichen Nativebackups durch. Alle vier neuen Dateien, ACLs und
Frozen-Datenbanken wurden vor dem ersten Start geprüft. Anschließend Helper,
danach Agent jeweils einmal gestartet; getrenntes Readback bindet dieselben
Phasen. Originalmarker und erste ArgumentException bleiben erhalten.
Originales `finish` war danach ausschließlich lesend: zwei frische WSS-
Heartbeats, konkretes Inventar-ACK/fortgeschrittene Sequenz, gleicher Tenant/
Geräteidentität und fremder Tenant verweigert. Journale/Dateiidentitäten/Zeilen,
Konfiguration und PKI-Metadaten erhalten. ZählerWindows0/0/0/0, Linux30/30/26/0
und geschlossene Flags/Rootpolicy unverändert. Runtime-/Komponentenindex erst
nach diesen Belegen lokal per CAS veröffentlicht. Kein OS-Reboot, kein Job,
kein Binding oder neuer Clock-/Wirkungsgate; Intentdateien weiter0Byte.
Tatsächlicher Agent `89004ad3…`, LocalService/Auto, PID8108, Geburtswert
`134391259111815072`; Helper `e6aacbdd…`, SYSTEM/Manual, PID2620, Geburtswert
`134391259068713651`. Policy `007adf5f…`, reziproker Pin `126670bc…`.
Privater Originalabschluss `result.json` SHA256
`ac00411fe1e109b18b28fd9c020245f462c179bb3ac99a37b69c7cff39c38460`;
Recoveryabschluss `acceptance.json` SHA256
`5ad5925c8928f49cd0f9d48a64f81018281b5b6e3704c799bae64a42898322bb`.
Die positive Pipeprobe bleibt ausdrücklich fehlgeschlagen: tatsächlicher neuer
Agent meldet `client_read_reply`/`HELPER_PIPE_IO`, Win32233, kein authentisierter
Austausch und kein privater Helperdiagnosebeleg. Dies ist ein erfolgreicher
passiver Erhaltungs-/Wartungsnachweis, kein SYSTEM-Sync-/Job-/Clocknachweis.
Kein erneutes Enter oder Wiederverwenden der ursprünglichen Startbefehle.