Files
rust-discovery/docs/linux-updater-compatible-controllers.md
T
2026-11-16 16:02:29 +01:00

21 KiB

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. 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 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.

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.

Tatsächlicher Folgebootstrap, anschließend angehalten

Der freigegebene Folgefall devstate/linux-updater-compatible/8fa5c0bd-b0ae-45ec-8cde-3d766d0576d4 stellte die neue Helperbinary und die zwei exakt gerenderten Fulldateien bereit. Die native staged Binary reproduzierte den erwarteten Fullpin unabhängig: Policy-SHA256 4b0900b3f3fe550d829352b6174649bd1e64aa89bdf766ec07f49ee04c582877. Agent 7fef… und stabiler Updater dec6… wurden nicht ersetzt.

Beim ersten Stopvergleich zeigte sich ein enges administratives Statusproblem: systemctl stop lässt einen bereits gescheiterten Dienst unter Umständen im Zustand failed, obwohl MainPID/ControlPID null und Job/Cgroup leer sind. Der Controller brach deshalb vor jeder Dateiänderung ab. Es gab ausschließlich das ursprüngliche Stopintent, keine Swapintents/Kandidaten/Vorgänger. Der Fehlerzustand wurde weder mit reset-failed gelöscht noch ein Stop wiederholt. Eine eigene, auf genau diesen Fall beschränkte Fortsetzung prüfte anschließend die identische ursprüngliche InvocationID/Exit-1-/NRestarts=0-/Restart=no- Bindung, beendete Original-PIDs, unveränderte Originaldateien, Datenbank-Inodes, Wirkungsaggregate und Retainedmetadaten. Unter beiden gehaltenen Originalflocks ersetzte sie danach genau die drei Dateien, mit create-only erhaltenen Vorgängern. Unklare oder schon begonnene Swaps werden von diesem Pfad verweigert.

Die vorhandenen Units und Updaternamespace wurden unverändert übernommen. General bestand vor Fullstart eine echte Policy-Challenge als provisionierte UID 993 mit geprüftem Rootpeer/PID, exaktem Policyhash und ursprünglichen Ledger-/Lock-Inodes. Die Antwort enthielt weder Snapshot noch freigegebene Grants. Danach starteten Full und Agent. Der abschließende rein lesende Beleg zeigt tatsächlich:

Rolle Zustand PID Tatsächliche Imagebytes
Agent active/running 185883 7fef…
General active/running 185875 eaee…
Full active/running 185880 eaee…
Stabiler Updater inactive 0 installiert, nicht gestartet
APT inactive 0 unverändert geschlossen

Alle drei ursprünglichen Datenbank-Inodes, die 27 Agent- und 19 Rootverbräuche samt Originalevidenzen sowie sämtliche ursprünglichen Identitäts-/PKI-/ Generalmetadaten blieben erhalten. Datenbankintegrität ist jeweils ok, keine offene Wirkung und kein Reconcile-/Helperfault. Es gab keine Betriebssystem- oder Paketoperation, keinen Reboot, keinen Job, keine Signierschlüsselerzeugung und keinen Serverdeploy.

Die Baselinequalifikation bleibt trotzdem nicht bestanden: Das tatsächliche Helperlog meldet JOURNAL_STORAGE_CAPACITY_BLOCKED, der Agent schließt mit SYNC_OR_TRANSPORT_DEPENDENCY_UNAVAILABLE. Beide Metas bleiben bei derselben ursprünglichen Generation 134/Entscheidung d6f2b8e3-73a4-47f7-9aa0-664b3829bfd4; es wurde kein neuer normaler signierter Abgleich behauptet. Der Rootledger besitzt tatsächlich 262138 Seiten à 4096 Bytes und null freie Seiten. Die normative Grenze beträgt 262144 Seiten (1 GiB; Spezifikation Kapitel 0, Journalbudgetentscheidung). Die nächsten Captures passen offenbar nicht mehr in die verbleibenden sechs Seiten; die beobachtete konkrete Verweigerung wird nicht durch Anheben des Limits oder Löschen/Ersetzen von Historie umgangen. Agentjournal: 195068 Seiten/43 frei; Agentverbrauch: 21284 Seiten/0 frei. Dieser Kapazitätspunkt braucht eine eigene verbindliche Lösung, bevor neue Linux-Wirkungen oder Updaterabnahmen möglich sind.

Auf ausdrückliche neue Fokussierung auf die Windows-SYSTEM-PowerShell-Abnahme wurde Linux nach genau diesem lesenden Schlussbeleg angehalten. Es gibt weiterhin keinen Baselinequalifikationsrecord, keine Registry, keinen Trust, keinen gestarteten Updater und keinen Updateauftrag. Tatsächlicher Schlussbeleg, SHA256 7c69a4ac4f295cef4e6bf6feacb86492ee3066cbadf7eeda7772e1b4285edb2a.