151 lines
9.4 KiB
Markdown
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.
|