Files
rust-discovery/docs/windows-system-pipe-upgrade.md
2026-11-14 15:55:45 +01:00

149 lines
8.6 KiB
Markdown

# Windows Pipe-v2: erhaltender Paarupgrade nativ bestanden
Stand: 2026-11-14. Paarupgrade und tatsächlicher authentisierter Austausch des
laufenden LocalService-Agenten mit seinem SYSTEM-Helper sind bestanden.
Die ursprünglichen Vorbereitungsabschnitte unten bleiben Verlauf. RMM-Jobs,
TrustedClock und Helperwirkungen bleiben weiterhin gesperrt.
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.
## Tatsächlicher Abschluss im selben Fall
Nach der getrennt verifizierten SSH-Zugangswiederherstellung wurde derselbe
Fall14fb genau einmal betreten. Die frische CAS-Prüfung bestätigte vor der
Mutation die unveränderte ursprüngliche Baseline, beide lokalen Runtimeindizes
und die geschlossenen Serverzähler/Policies. Der bereits gestoppte Helper
wurde nicht vorab gestartet. Beide Dienste blieben während aller vier
Dateiersetzungen gestoppt; Originale und native Backups sind erhalten.
Das anschließende rein lesende Finish bestätigt:
- Agent `f10c78dd738e7fb277e0c4d24fadf0f61ae3269458399b9224570ba5e66abc2c`
läuft als LocalService/Auto, PID5528, Geburt `134391415551175930`.
- Helper `5f8c62fab6bc8ea1bbb009166b3d0e741c034c36690a4e32ea4e3cb2d7729a79`
läuft als SYSTEM/Manual, PID9464, Geburt `134391415512591188`.
- Tatsächliche Agentprobe: `authenticated_pipe_exchange=true` und
`client_service_pid_verified_by_helper=true`; Helperkonto/Service-SID und
feste EXE-/Policybindungen geprüft. Der frühere Win32233-Lauf bleibt
fehlgeschlagen; daraus wird keine rückwirkend bewiesene Fehlerursache.
- Zwei neue WSS-Heartbeats, ursprüngliche mTLS-Geräteidentität,
Inventar-ACK/Sequenz2813 und Tenantverweigerung bestätigt. Agent-/Helper-
DB-/Lock-/PKI-Datei-IDs, Historie und leere Intentleaves erhalten.
- Windows0/0/0/0, Linux30/30/26/0, geschlossene Testflags/Policies,
`helper_ready=false`, `helper_clock_qualified=false`, keine SYSTEMcapability
und keine Jobs oder Wirkung. Private Schlüssel wurden nicht gelesen.
Originaler `result.json`-SHA256:
`d5c4996821911a5bdac5014e9f985c56bbb592b803f2e33411dd28bb986b8eed`.
Er wurde samt Intent/Baseline bytegleich im privaten Main-Evidenzpfad
archiviert. Erst danach veröffentlichte Root lokal beide Indizes per CAS unter
einem gemeinsamen Lock, mit erhaltenen Vorgängerdateien und eigener
Publikationsreceipt. Keine erneute Zielmutation:
Runtimeindex `e49231e72aff7b001189b8507200c6c701f73e47f77c29194116cf1da41ca0c2`,
Komponentenindex `005317e652f50de3e1277be3bc42717318226208015e7c8011e1b73469cc7562`.
Der Nachweis qualifiziert den Pipe-v2-Peertransport und die passive Erhaltung,
keine Clock, SYSTEM-Skriptkonsole oder Paketwirkung.