9.4 KiB
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:
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.