82 lines
5.2 KiB
Markdown
82 lines
5.2 KiB
Markdown
# Gemeinsames passives Windows-Komponentenupgrade
|
|
|
|
Stand 2026-11-14: **Source vorbereitet; dieser Upgradefall wurde noch nicht auf
|
|
der VM ausgeführt.** 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.
|
|
|
|
Geplante Befehle, **nicht ausgeführt**:
|
|
|
|
```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>
|
|
```
|