Files
rust-discovery/docs/windows-system-pipe-upgrade.md
T
2026-11-14 14:16:56 +01:00

112 lines
6.5 KiB
Markdown

# Windows Pipe-v2: erhaltender Paarupgrade noch nicht betreten
Stand: 2026-11-14. Der Paarupgrade wurde vorbereitet, aber **nicht betreten**.
Die neue Agent-/Helpergeneration ist noch nicht als laufendes Paar nachgewiesen.
Die Quellen- und nativen Unitbelege des Pipe-v2-Framings ersetzen weder einen
tatsächlichen LocalService/SYSTEM-Pipeaustausch noch einen RMM-Jobnachweis.
Die ursprüngliche quellengebundene
[Framingdokumentation](windows-helper-pipe-drain.md) bleibt unverändert. Diese
separate Datei beschreibt ausschließlich die späteren Upgradevorbereitungen.
Der Notebookhost bleibt reiner Entwicklungsrechner; Ziel ist die eigene
Windows-VM am endgültigen Cloudserver.
## Geprüfter Kandidat und begrenzter Bootstrapvertrag
Der neue Runner
[`system_pipe_upgrade.py`](../deploy/windows/system_pipe_upgrade.py) ist mit
SHA `e466576673a0e5c332cfc1613ae88a62f5b526015ced76b1d22473e292a995e0`
eingefroren. Sein frischer isolierter Prüfer bindet den neuen Pipe-Packtyp und
dessen Originalquellen, genaue native Listen mit **23 Library- und 7
Binarytests** sowie die erhaltenen Linux-first-Corebelege mit 80 Linux- und
58 Windowsfällen. Es gibt keine Umbenennung alter Delegationsmanifeste und
keine Umleitung des eigenen Source-Roots auf Main.
Der gebundene Pipe-Pack hat Manifest-SHA
`b2f77713a4f70deddb6472fb1e869a85443ce1028914f62ccee71f8001fbadb4`.
Die tatsächlichen 23+7 Windows-Administratorunits bestanden im Fall
`db25cd4a-bfd2-45d5-9f80-1881950853f7`; dessen `passed.json` hat SHA
`19a8ccd95b7225f7e8657a696055bea4b52ed2f80f6caa3f42c9396ce6272713`.
Das sind Unitnachweise, kein LocalService-/Pipe-/Clock-Erfolgsbeleg.
Die vorbereitete Mutation verlangt eine separat geprüfte frische Baseline mit
SCM-/Kernel-PID und tatsächlicher Prozessgeburt, Konto, aktivem Service-SID,
Imagehash und ACLs. Ein bereits gestoppter Manual-Helper erhält keinen
Vorabstart. Vor der ersten Ersetzung werden vier private Sicherungen erstellt;
jede Ersetzung verlangt zusätzlich einen eigenen zuvor fehlenden nativen
Backupnamen und frische Datei-ID-/Hash-/ACL-CAS-Prüfungen. Beide Dienste bleiben
bis zur vollständigen neuen EXE-/Policy-/Pingeneration gestoppt. Danach sind
Helper- und Agentstart jeweils create-once. Config-/CA-/Identitäts-/Zertifikats-
und Private-Key-Metadaten samt Datei-IDs werden auch nach den Ersetzungen,
vor dem Start und beim Finish unverändert verlangt.
`readback` ist rein lesend und kann auch einen fehlenden Zielpfad sowie einen
SCM-Pendingzustand ehrlich zeigen. Baseline, Enter und Finish behalten ihre
strengen Identitätsprüfungen. Nach verlorener Mutationsantwort gibt es keinen
automatischen Enter-/Start-/Rollbackretry. Ein Finish benötigt neue passive
Heartbeats und konkrete Inventar-ACKs; es schreibt nur einen lokalen Beleg.
Main-Indizes werden ausschließlich durch Root separat per CAS fortgeschrieben.
## Tatsächlicher Fall 14fb: Timeout und geprüfte erste Fortsetzung
Fallverzeichnis:
`devstate/windows-client/system-pipe-upgrade/14fb176a-f653-4573-a8d7-6f9fe47a3020/`.
Der erste `prepare`-Aufruf begann am `2026-11-14T12:39:48.414511+00:00`
und endete nach 180 Sekunden mit `TimeoutExpired` während des ersten
Stagingaufrufs. Zu diesem Zeitpunkt gab es lokal nur den Prepareintent und
Quellkopien, keine Baseline und keinen Enterintent. Die genaue Ursache des
SSH-/Bootstraptimeouts ist nicht nachgewiesen.
Ein danach gesondert ausgeführter lesender Check bestätigte: beide neuen
EXE-Stagingverzeichnisse, der neue entfernte Komponentenfall und der neue
Active-Marker waren noch nicht vorhanden. Der alte Agent lief, der alte Helper
war gestoppt. Auf dieser Abwesenheit beruhte die explizite create-once
Fortsetzung der tatsächlich noch unerreichten Vorbereitungsphase im selben
Fall; kein neuer Upgradefall und kein wiederholtes Enter.
| Erhaltener Beleg | SHA-256 |
| --- | --- |
| `prepare-first-stage-timeout.json` | `535faf7c6c4c7b3dba1f8d7b7889bc59acdee09fd51c2830fe397c3c9076f1e9` |
| `first-prepare-readonly-absence.json` | `983b38fcc2cdc8e907436eb3053f32ad2cd131e765a82dd1e9930346e1c6877b` |
| Private Fortsetzungsquelle `continue-first-prepare.py` | `86453aef4a1d59f73e423993b548e58ad0541205961a5952c80807403881cf3b` |
| `continue-first-prepare-intent.json` | `7420622b7866e7b43b34087d5334599444a046b95a89e7f48503aca0f4e03be0` |
| Neue lesende `baseline.json` | `57b79e9c918df6165cac0bb451b33fcd0c207933f15351afcd2ad6c400f4e2d7` |
Die Fortsetzung erzeugte schließlich den Baseline-/Intentbeleg und die
serverseitigen Vorherbeobachtungen. Das ursprüngliche Timeout und seine
Abwesenheitsmessung wurden nicht überschrieben.
## Baseline und verbleibende tatsächliche Abnahme
Die frische Baseline zeigt den weiterhin vorhandenen Agenten `89004ad3…`
unter LocalService (`S-1-5-19`), `Running/Auto`, PID `3172`, mit exakter
Kernel-FILETIME `134391328200102621`. Der vorhandene Helper `e6aacbdd…`
ist `Stopped/Manual`, PID `0`; dafür wird kein laufender Prozess behauptet.
Policy `007adf5f…` und Pin `126670bc…` gehören weiterhin zur alten Generation.
Die Telemetriedatenbank wurde lesend mit `integrity=ok`, Sequenz `2564` und
`pending_inventory_events=0` beobachtet. Ursprüngliche PKI-/DB-/Lock-Datei-IDs,
ACLs und die beiden uninitialisierten Nullbyte-Intentleaves sind im privaten
Baselinebeleg gebunden.
Vorherige Serverzählungen blieben:
Windows `jobs/outbox/permits/unresolved = 0/0/0/0`, Linux
`30/30/26/0`. Die beobachteten API-/Gateway-Transportfaultflags waren geschlossen;
dies ist eine konkrete Vorhermessung, kein künftiger Nachherbeleg.
Der vorbereitete Kandidat umfasst Agent `f10c78dd…`, Helper `5f8c62fa…`,
Policy `a3024467…` und Pin `af518db8…`. **Es existiert für diesen Fall noch kein
Enterintent oder tatsächlicher Stop-/Swap-/Start-/Finishbeleg.** Staging ist
keine Installation oder laufende Nutzung der neuen EXEs. Der alte SSH-Zugang
lief anschließend aus; seine getrennte
[Konsolenwiederherstellung](windows-dev-access-recovery.md) ist eine notwendige
Zugangsstrecke und kein Paarupgrade.
Nach tatsächlicher Wiederherstellung des Zugangs muss Root die Baseline vor
Mutation erneut bewerten. Geänderte PID/Birth-, Datei-, Index- oder andere
gebundene Werte dürfen nicht still übernommen werden. Erst danach können der
einmalige erhaltende Paarupgrade, zwei neue tatsächliche WSS-Heartbeats,
Inventar-ACK, Tenantverweigerung und unveränderte Job-/Policygrenzen geprüft
werden. Ein tatsächlicher authentisierter Austausch des laufenden
LocalService-Agenten mit dem neuen SYSTEM-Helper bleibt offen. Jobfreigabe,
Helperwirkungen und Clockqualifikation bleiben geschlossen.