117 lines
7.3 KiB
Markdown
117 lines
7.3 KiB
Markdown
# Gemeinsames passives Windows-Komponentenupgrade
|
|
|
|
Stand 2026-11-14: **Native Wartung begonnen, erster Dateitausch fehlgeschlagen;
|
|
beide eigenen Dienste derzeitStopped. Kein abgeschlossener Upgradebeleg.**
|
|
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.
|