# Kompatibler Linux-Updater: konkrete administrative Controller Stand 16. November 2026. Die nachstehenden Quellen sind vorbereitet und lokal geprüft. Der spätere freigegebene native Teilschritt steht unten; die Baseline ist noch nicht qualifiziert. Kein Signierschlüssel, gestarteter Updater oder Updatejob entstand dabei. Die Zielphasen koordiniert der Rootprozess; RMM-Aufträge brauchen weiterhin den tatsächlichen Weg MCP → `pending_approval` → WebUI → Originalgrant. ## Genau verwendbare Artefakte Das unveränderte ursprüngliche Buildpack `21d20391-6102-4996-8a7a-efbd3e78bd7d` bleibt erhalten. Der neue Agent muss zusätzlich die beiden bereits bestehenden Domaincapabilities `agent.update.apply/1` und `agent.update.check/1` nach einem gültigen geschützten Fullobserver melden. Außerdem muss der bestehende 60-Sekunden-Tick das fertige Observerergebnis vor seinem Capabilityvergleich abholen. Andernfalls wurde die alte Probe erst nach dem Vergleich geerntet und konnte beim nächsten Vergleich bereits älter als die erlaubten 90 Sekunden sein. Der Tickaufruf wurde verschoben, ohne Samplerate oder Gültigkeitsgrenze zu ändern. Beide Änderungen sind in der eigenständigen Derivation `devstate/linux-updater-capability-build/9923a97f-4c8c-4e0a-bbad-4f1d88f0d43a` eingefroren. Manifest-SHA256: `a41ad700b4b7527bf911bf00f2745914188760c631af0c3255364c05f1ef4fbc`. Source0/Source1 verwenden unverändert 0.1.0/0.1.1. | Artefakt | SHA256 | |---|---| | Source0 Agent | `7fef8d0f1e2bcf5cd6c373e567a0c17bfb08d8c780cd4d1925b6c1355e572547` | | Source1 Agent | `4d212066bef226af3fa679ffe95f69c43a9668cbef7e665d53328f4e41aa3799` | | Source0 Helper, unverändert aus 21D | `8fdc6ded02278eb18e64003d0bc7bf45d452cd48ded0450e6e900ca66e44d449` | | Source1 Helper, unverändert aus 21D | `89b28db3afe870c667297dff97ad7a042c550ccce1f712d69108e8de672ad450` | | Stabiler Updater, unverändert aus 21D | `dec6336728eac8af1e0d84d4921c7c9ecbcc45bc4619d357d346b716336be90a` | Die Derivation verwendet einen eigenen kopierten Buildcache. Beide Agenten bestanden all-targets Clippy mit `-D warnings` und den Releasebuild im gepinnten Offlinebuilder. Alle 18 zuvor nativ geprüften Contractexecutables, Helper und Updater wurden nicht neu gebaut und ihre Originalhashes erneut verglichen. Der frühere reine Capabilitymarker-Fall `f89fbb79-…` bleibt historisch erhalten; er enthält die Tickkorrektur noch nicht und ist hier nicht die Baseline. Der separate öffentliche Metadaten-SDK liegt im eingefrorenen Fall `devstate/linux-updater-bootstrap-sdk/d309c949-3a70-4448-88da-49c710093221`. Manifest-SHA256 `cf9464ff21b48b28903369692e3bb63148b2c488297ec709e8fd9c9881448528`, Binary-SHA256 `6fcc543d538fca30ceb499364880e4dc3689700d50597f18bd11bfe3559a0021`. Sein Worker-all-targets-Clippy und Releasebuild bestanden. Er schreibt keine Zieldateien und startet keine Dienste. Er rendert Full über die bestehenden Rusttypen, erzeugt kanonische öffentliche Manifest-/Record-/Policybytes und misst bei `qualify_pair`/`registry` ausschließlich die wirklichen Zielzeugen. Die Bundlecodecoperation kennzeichnet ausdrücklich nur die Formprüfung. ## Vorbereitete erhaltende Phasen `deploy/linux_updater_compatible_apply.py` trennt folgende explizite Phasen; keine Fehlerantwort startet einen bereits begonnenen Schritt erneut: 1. `prepare`: Nur lesender Original-CAS auf der VM und lokale Paketvorbereitung. Diese Phase wurde tatsächlich ausgeführt. Der lokale Fall `devstate/linux-updater-compatible/ac6cf439-e0a6-4323-82e1-c55df96b2441` enthält `package.json`, den lesenden Vorbeleg und Manifest-SHA256 `d3917236c03b93273b4f43f1df3b6773cc04873018262567d3d31510c993c082`. Es wurde noch kein Paket auf der VM bereitgestellt. 2. `stage`: Ausschließlich create-only sieben feste geprüfte öffentliche Artefakte in einem neuen Root-700-Fallverzeichnis bereitstellen. 3. `install`: Frischen geschlossenen zentralen Scope und null offene Jobs prüfen; echte Original-PIDs halten, Agent/General/Full stoppen, beide Originalflocks halten und alle ursprünglichen DB-Inodes/Start-/Outcomeaggregate bewahren. Vier feste Dateien mit create-only Vorgänger- und Kandidatennamen ersetzen. Alle drei Dienste bleiben danach gestoppt. Bei bestehendem Intent nur lesen. 4. `units`: Den stabilen Updater und die feste Unit create-only installieren, Full-Override `Restart=no` vor der Registry bereitstellen, daemon-reload und tatsächlichen inaktiven Updater/Restartzustand prüfen. Keine Dienststarts. 5. `start`: General, Full, Agent jeweils genau einmal starten. Das ist zunächst nur ein Dienststart, noch kein Baselinequalifikationsnachweis. 6. `qualify`: Der SDK prüft echte PID/Birth/Image-/Unitzeugen und dieselbe frisch signierte normale Agent-/Helpersynchronisierung mit aktuellem NativeClock, unabhängig gepinnten öffentlichen Jobkeys und erhaltener History. Kein vergangener Clockwert und kein administrativer Ready-Ersatz. Die ausgegebene Qualifikation enthält `ready/helper_ready/unlock/job_authority=false`. 7. `registry`: Die wirkliche feste 21-Unit-Schließung, etwaige Rollbacktimer, Host-/Namespaceidentitäten und tatsächliche Dateipins zweimal messen. Ein geladener APTdienst verlangt seinen vierten lokalen Servicepin, bleibt aber inaktiv/disabled und erhält keine neue APT-Laufzeitqualifikation. 8. `trust`: Kanonische Form nativ mit dem SDK prüfen, Release- und separate Baselinesignatur über genau diese Bytes zusätzlich mit OpenSSL prüfen, aktuelle Artefakt-/Identitäts-/Registrybindungen vergleichen und die festen Trustdateien create-only anlegen. Private Originalkeys werden nur per Metadaten in die Retainedliste aufgenommen, niemals gelesen oder exportiert. 9. `updater-start`: Nach vollständiger Trustinstallation den stabilen Dienst genau einmal starten und seinen echten gehaltenen PID/Imagezeugen prüfen. 10. `passive-check`: Nur serverseitig lesen. Die wirkliche normale Agentmeldung muss weniger als 90 Sekunden alt sein, gültige Fullobserver-/Syncbezüge, den exakten Vorgänger/Updater/Policy/Keyring/Healthpin und die benötigten Runtimecapabilities enthalten. Es gibt keinen SQL-Schreibersatz für eine fehlende Capability. `readback` holt nach einem verlorenen Transport nur feste öffentliche Belege ab. Der vorhandene Generalpin Schema 1 enthält ausdrücklich keinen Binarypin; der Produktcode verlangt hier `helper_binary_sha256=None`. Seine exakten Bytes und Policy bleiben erhalten. Das erlaubt keine Umdeutung des alten Pins zu einem Native-Abnahmenachweis für die neuen Helperbytes. Dafür ist Schritt 6 getrennt notwendig. Der alte APTproof bleibt unverändert und weiterhin geschlossen. ## Servertrust und Signieren `deploy/updater_server_signing_bootstrap.py` ist ein separat aufzurufender Server-Rootbootstrap. Der reine Read `public-separation` wurde tatsächlich ausgeführt: Er las ausschließlich den bestehenden öffentlichen Timepin und verglich ihn mit dem unabhängig geschützten öffentlichen Jobkey. Timepin-Rawhash `c31d31d2d61f881d04f55f704abbbf98f4822650c016f39e39d4d2318bc3f6e2`; die beiden tatsächlichen Publickey-SHA256-Werte sind `1d9b8f83191a99d69b435dc69e8c9b52650680e8e02025f3e338e5083924def8` und `4338aabe7e7ba77428e969750a7a5323d7b7349aa52ef7e1a5f24c90be12ca7a`. Der Read erzeugte keine Schlüssel und änderte keinen Dienst. Der öffentliche Beleg und der noch nicht ausgeführte `signer-provision-input.json` liegen im lokalen kompatiblen Bootstrapfall `ac6cf439-…`. `provision` erzeugt für Linux und Windows jeweils einen eigenen Release-/Baselineschlüssel. Der globale Healthschlüssel wird nur beim ersten Aufruf erzeugt und später ausschließlich nach unveränderter öffentlicher Provenienz und Schlüsselmetadaten wiederverwendet. Der Aufruf verlangt echte Job-/Zeit-Publickey-SHA256-Werte als Ausschlussliste; Rollenalias-IDs genügen nicht. Kein privater Schlüssel verlässt den Server oder erscheint im Output. Releasekeys bleiben Root in 0700/0600. Der tatsächliche Server-Trustreader verlangt den bestehenden Jobkey-Dateiowner 10001 auch für Keyring/Healthdatei, Datei 0600/ein Link und geschützten Elternpfad. Deshalb erhält jede Plattform ein eigenes öffentliches Verzeichnis 10001/0700 mit `keyring.json` 0600. Dieses wird später read-only in API **und** Gateway gemountet; der separate Healthkey wird read-only ausschließlich in das Gateway gemountet. Der Container behält seine vorhandene UID und schreibgeschützte Root-FS. Private Releasekeys werden überhaupt nicht in Anwendungscontainer gemountet. Neue statische Serverkonfiguration: | Einstellung | Zweck | |---|---| | `RMM_AGENT_UPDATE_LINUX_KEYRING_FILE` | ausschließlich geschützter Linux-Keyring | | `RMM_AGENT_UPDATE_WINDOWS_KEYRING_FILE` | ausschließlich geschützter Windows-Keyring | | `RMM_AGENT_UPDATE_KEYRING_FILE` | unveränderter Legacyfallback, nur wenn der Plattformslot fehlt | | `RMM_AGENT_UPDATE_HEALTH_KEY_FILE` | separater Gateway-Healthsignierer | Ein vom Netz empfangener Plattformenum wählt ausschließlich einen dieser zwei fest konfigurierten Pfade. Ein leerer/relativer expliziter Plattformslot wird verweigert. Danach gelten weiterhin sämtliche Signatur-, Plattform-, Revocation-, Generation- und Original-Rawhashprüfungen. Ein gemeinsamer Mehrplattformkeyring würde die bestehenden streng plattformgebundenen Clients nicht erfüllen; deshalb wird deren Trustvertrag nicht gelockert. Die beiden gezielten Serververträge bestanden mit echten lokalen Ed25519-Signaturen für beide Plattformen und negativen Kreuzkeyring-/Signatur-/Revocation-/Generation-/ Rawhashfällen; Server-all-targets-Clippy bestand ebenfalls. Diese Quellen brauchen noch einen neuen, getrennt koordinierten ARM64-Imagebuild/Deploy. `deploy/linux_updater_public_materials.py` verwendet den sealed SDK für `release-input`, `record-input`, `trust-package`. Es signiert nichts. Der Server signiert ausschließlich die zwei fest qualifizierten Linux-Codepaare und die Initialbaseline mit dem tatsächlichen Qualifikationshash. Ein Ausgabe-JSON ist keine lokale Vertrauensquelle. Die kanonischen Manifestcodec-Rundläufe für beide wirklichen Linux-Artefaktpaare und Python-Syntaxprüfung aller drei Controller bestanden lokal; dabei wurden weder Schlüssel noch Signaturen erzeugt. Windows-GNU-Artefakte werden ausdrücklich nicht als kanonische Windows-MSVC- Releases signiert. Die tatsächliche MSVC-Qualifikation ist ein eigener offener Schritt. Das ändert weder das Linux-first-Gate noch einen Plattformvertrag. ## Danach noch tatsächlich abzunehmen Die beschriebenen Zielphasen sind weiterhin auszuführen. Neue Servermounts, plattformbezogener Keyring, Gateway-Healthkey, enger Update-Denyscope und Tenantkatalog müssen anschließend konkret und mit erhaltenen Composepins bereitgestellt werden. Erst dann folgen der tatsächlich über MCP beantragte und in der WebUI genehmigte Linux-Updatejob, dessen Originalverbrauch, Codepaarwechsel, signierte Health und endgültiger Record/Floor sowie der bekannte geschlossene Fullstart-Fehlerfall mit erhaltender Rückführung. Lokale Codec-/Build-/Syntaxbelege ersetzen diese nativen Abnahmen nicht. ## Tatsächlicher Baselineteilschritt und offener Startfehler Nach Quellencommit und Giteapush `96a2b6e` bestand der frische Cloud-Linux-CAS: unveränderter Boot/Originalcode, drei Originaldatenbank-Inodes, 27 Agent- und 19 Rootverbräuche, keine offene Wirkung/kein Fault. Der zentrale Rootscope war tatsächlich abgelaufen, es gab null offene Linuxaufträge. Anschließend wurden `stage`, `install`, `units`, `start` tatsächlich ausgeführt. Die vier ursprünglichen Dateien bleiben unter ihren create-only `.bootstrap-…previous`-Namen erhalten. Im Stop/Swap wurden beide ursprünglichen Locks gehalten; die Datenbank-Inodes, Originalstart-/Outcomeaggregate sowie sämtliche gehaltenen Identitäts-/PKI-/ Generalmetadaten blieben nach unabhängigem Readback unverändert. Der Agent läuft als PID 183607 mit `7fef…`, General als PID 183601 mit `8fdc…`. Full startete am 16. November um 14:28:05 UTC, beendete sich jedoch nach rund 96 ms mit Exit 1. Das gebundene `Restart=no` verhinderte eine Wiederholung; `NRestarts=0`. Die normale SDKqualifikation verweigerte daher korrekt den Erfolg. Es entstanden kein Qualifikationsrecord, keine Registry, kein Trust und kein Updaterstart. Full wurde nicht erneut gestartet. Die rein lesende Diagnose zeigte: Derselbe neue Helper bestand `--inspect-full-maintenance-profile` mit dem tatsächlichen neuen Policyhash `e1ca870c3ff2ff1b9485ff9413178b5f3f934169b3595cb444b5235ada42c1ae`. Kein alter Socket blieb liegen, keine AppArmor-/Seccomp-Verweigerung wurde beobachtet. Das Fehlerlog enthält ausschließlich den sicheren generischen Code `HELPER_VALIDATION_OR_IO_FAILURE`; daraus wird keine bewiesene Ursache abgeleitet. Die Startzeiten überlappen Generalinitialisierung und Fullstart; der bestehende nichtblockierende exklusive Initialisierungslock kann diese Parallelität verweigern. General hält ihn nur im Initialisierungsblock und bei Wirkungen, nicht lebenslang. Eine eng begrenzte Initialisierungsrobustheits- korrektur und ihre native Prozessprüfung sind der nächste ausdrücklich koordinierte Schritt. Der fehlgeschlagene Lauf bleibt als solcher erhalten. Öffentlicher Originalbeleg: [native Teilabnahme](evidence/linux-updater-compatible-partial.json). Vor einem späteren Updateauftrag ist zusätzlich zu beachten: Full initialisiert seine optionale Updaterclock beim Dienststart. Start ohne Trust bleibt korrekt geschlossen; nach separat freigegebener Trustinstallation braucht Full einen eigenen abgestimmten Start mit anschließend erneut normalem signiertem Sync. Der neue ARM64-Serverbuild für die statischen Keyrings bestand unabhängig: Image `sha256:577b3af6b4948d17786bc1fea302e7c490f3bed3d5848c78d6e95e66935f54a7`, Serverbinary `6c7f197ad87dc405f5bd221e4b5e2c915ada448eff7bee9c8e5922d30d64a8ec`. Der separat gebaute Broker blieb bytegleich `da8e…`. API/Gateway/PostgreSQL hatten vor/nach dem Build exakt dieselben Container-IDs, Startzeiten und Restartzähler. **Nur gebaut: kein Deploy, keine Migration, keine Mount-/Env-/ Keyänderung.** Der öffentliche [Buildbeleg](evidence/server-updater-platform-keyrings-build.json) bindet Source-Manifest `376b744896e3ca7845c4824ae41286e1fb0c486118e491993435724446a3ef31`. ## Begrenzter Initialisierungslock: tatsächlich nativ geprüfter Folgefix Der Produktstart verwendet jetzt ausschließlich für die Ledgerinitialisierung `startup_lock_state`: Ein einziger geöffneter Original-Lock-FD und der gehaltene Stateverzeichnis-FD bleiben über die Wartezeit erhalten. Nur `WouldBlock` auf demselben exklusiven Lock wird für höchstens fünf Sekunden abgewartet. Pfad- und FD-Identitäten werden vor jeder Probe verglichen; andere I/O-Fehler verweigern sofort. Fristüberschreitung meldet `HELPER_STARTUP_EXECUTOR_LOCK_TIMEOUT`. Normale Wirkungslocks, Grants, Jobs und Sync werden dadurch nicht wiederholt. Das ändert die noch unbewiesene Ursache des ursprünglichen 96-ms-Fehlers nicht. Die separate Source0/Source1-Helperderivation liegt unter `devstate/linux-updater-helper-start-build/d674db1c-ebca-48ed-b04c-8f7ec9e45ca1`, Manifest-SHA256 `3520d0cfdda856b2c9c075197059047e47a24dab42270f4676416dd1ec5871cf`. Geändert wurden ausschließlich Helperlib, Helpermain und der gezielte native Prozessvertrag. Beide Helper bestanden all-targets Clippy mit `-D warnings` und Releasebuild. Neue Helperhashes: | Version | SHA256 | Bytes | |---|---|---:| | 0.1.0 | `eaee85d7d9d7d9592928448186d883ccb8384cdad967b5d98f47e925b9a8ae8d` | 13323816 | | 0.1.1 | `1a65e2d9ca7f862578c12fb3d3bff9f1a381a44ce9e8bccd47271a129e64e6e7` | 13328416 | Die beiden Agenten bleiben exakt `7fef…`/`4d21…`, der stabile Updater exakt `dec6…`. Frühere Artefakte/Snapshots wurden nicht überschrieben. Der erste erhaltene Buildversuch verweigerte einen nun unbenutzten Import; nach dessen Entfernung entstand der erfolgreiche neue Fall, ohne Warningunterdrückung. Der eine gezielte Zweiprozessvertrag lief zuerst auf der tatsächlichen Cloud-Linux-VM: **1 passed, 0 failed, 42 filtered, 5.22 Sekunden**. Ein Child wartete auf den vom Parent gehaltenen Original-Lock und erhielt nach Freigabe denselben Inode; ein weiteres Child verweigerte nach fünf Sekunden den weiter gehaltenen Lock. Im temporären Root-Fall entstand ausschließlich die leere Lockdatei. Keine ursprüngliche DB und kein Produktdienst wurde dabei geöffnet beziehungsweise verändert. Executable-SHA256 `3d22b6831d3922ec1c6b92de930b7af4dc7b44ad13d6e44759d72f504ff18859`. [Originalbeleg](evidence/linux-helper-startup-lock-native.json). Diese neue Helperderivation ist zu diesem Zeitpunkt **noch nicht im laufenden Agent/General/Full installiert**. Der anschließend freigegebene eigene Followupbootstrap muss den bekannten gestoppten Fullzustand und alle Originalhistorien erneut prüfen, die drei betroffenen Dateien mit erhaltenen Vorgängern ersetzen und vor Fullstart eine tatsächlich authentisierte General-Policyprobe bestehen. Erst die folgende normale signierte Synchronisierung kann die neue Baseline qualifizieren.