Prepare reviewed preserving joint Windows component upgrade
Rust development slice / linux (push) Failing after 6s
Rust development slice / linux (push) Failing after 6s
This commit is contained in:
@@ -0,0 +1,81 @@
|
||||
# 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>
|
||||
```
|
||||
Reference in New Issue
Block a user