Record preserved Linux full-maintenance runtime startup
Rust development slice / linux (push) Failing after 6s

This commit is contained in:
2026-11-14 17:57:04 +01:00
parent 7ef068fff2
commit cfd32eac72
5 changed files with 704 additions and 15 deletions
+30 -12
View File
@@ -1,10 +1,13 @@
# Explizite Hostwartung mit full_maintenance_v1
Stand 2026-11-14, Spezifikation1.20. Die Batch-Skriptkonsole und der unabhängig
geprüfte Fullhelper-Binärpinfix sind lokal implementiert und neu quellqualifiziert.
Kein FullMaintenanceprofil wurde durch diese Dateien auf einem Ziel installiert,
kein RMM-Job ausgeführt oder genehmigt. Cloud-Linux-VM zuerst, Windowsgast separat;
Notebook ausschließlich Entwicklung.
geprüfte Fullhelper-Binärpinfix sind implementiert, neu quellqualifiziert und nach
tatsächlichem Linux-Unitlauf erhaltend auf der Cloud-Linux-VM bereitgestellt.
Agent, General und Full laufen mit den geprüften Images; signierter Folgeabgleich
und WebUI-genehmigter Fulljob bleiben separat offen. Tatsächliche Teilfehler,
Fortsetzungen und unveränderte Originalbelege:
[Bootstrap-Ergebnisse](../../docs/script-console-bootstrap-results.md).
Cloud-Linux-VM zuerst, Windowsgast separat; Notebook ausschließlich Entwicklung.
## Aktueller korrigierter lokaler Nachweis
@@ -33,8 +36,11 @@ Linux-Release-Helper SHA256
Agent `0a7ad6eefaefda79ee80b6a41b2df904e9e7f50ae6ebeed01b98c25b6ce5c06f`;
Server `610017637a9f9e55a6cb3cd8264937b953996af84e86dd49f2ea00c8e59739cd`.
Keine dieser neuen Binaries ist durch den Builder auf einem Ziel installiert.
Native Cloud-Linux-/Windows-Units, Erhaltungsbootstrap und WebUI-genehmigter
FullMaintenancejob bleiben ausdrücklich offen.
Native Cloud-Linux-Units bestanden anschließend tatsächlich; siehe den separaten
Beleg unten. Auch die späteren 36+7 Windows-Units bestanden separat nativ:
[Windows-Nachweis und Grenzen](../../docs/script-console-windows-link.md).
Laufende Windows-SYSTEM-Runtime und WebUI-genehmigter FullMaintenancejob sind
eigenständige, dadurch nicht ersetzte Nachweise.
## Frühere lokale Nachweise und der danach behobene Binärpinbefund
@@ -91,7 +97,12 @@ Er verwendet ausschließlich den vorhandenen strikten Bootstraptransport und
SSH-Key und strenger Hostprüfung. Keine
Zugangsdatenkopie ins Scriptworktree, keine alternative IP oder Passwortfallback.
**Geplant, noch nicht ausgeführt:**
**Tatsächlich ausgeführt:** Alle vier Listen wurden vor jedem Unitstart geprüft;
84 Tests bestanden, fünf ausdrücklich ausgelassene DB-Verträge waren zuvor im
isolierten lokalen PostgreSQL-Lauf bestanden. Fall
`7b61ce46-7913-492b-9c6b-414a0c2b6ffc`, Beleg-SHA256
`a831a70a3cf76a3e8a9bf5820dcca7100d2ef9860dd9388539fe9c13f949f470`.
Der verwendete Aufruf war:
```bash
python3 deploy/script_console_acceptance.py execute-linux
@@ -119,7 +130,11 @@ wiederholt. Native Units sind keine RMM-Dienst-/WebUI-/FullMaintenanceabnahme.
## Bootstrapvorbereitung nach gesondertem Erhaltungsreview
Die folgenden Schritte sind nur geplant. Aktuelle Cloudbelege, Geräte-/Boot-/
Der ursprüngliche Erhaltungsplan und die weiterhin geltenden Schutzgrenzen
folgen unten; tatsächliche Ausführung samt fehlgeschlagenen Teilphasen und
separaten Erststartfortsetzungen steht in den
[Bootstrap-Ergebnissen](../../docs/script-console-bootstrap-results.md).
Aktuelle Cloudbelege, Geräte-/Boot-/
Journalidentitäten, Inodes, Verbrauchszeilen und Dienstzustände werden vor einer
Änderung durch den verantwortlichen Rootprozess unabhängig gegengeprüft. Die
bisherigen General-/APT-Units und Pins sowie deren Historie bleiben erhalten;
@@ -194,8 +209,11 @@ Beleg `passed-e214cd9b-21ac-48ce-82dc-d10364329d04.json`, SHA256
`a831a70a3cf76a3e8a9bf5820dcca7100d2ef9860dd9388539fe9c13f949f470`.
Keine Agent-/Helperinstallation, Änderung bestehender Dienste/Policies/PKI/
Datenbanken, veröffentlichte Capability oder WebUI-Genehmigung durch diesen
Unitlauf. Der oben ursprünglich geplante Unitaufruf ist damit abgeschlossen;
Bootstrap, tatsächlicher FullMaintenancejob und Windowsabnahme bleiben offen.
Unitlauf. Der oben ursprünglich geplante Unitaufruf ist damit abgeschlossen.
Der inzwischen erhaltend ausgeführte Bootstrap steht in den separaten
[Bootstrap-Ergebnissen](../../docs/script-console-bootstrap-results.md);
signierter Folgeabgleich und tatsächlicher FullMaintenancejob sind dadurch
noch nicht abgenommen.
## Verbindlicher Generationsentscheid vor dem Bootstrap
@@ -216,8 +234,8 @@ Fall `7b61ce46-7913-492b-9c6b-414a0c2b6ffc`, Proof-SHA256
`a831a70a3cf76a3e8a9bf5820dcca7100d2ef9860dd9388539fe9c13f949f470`,
84PASS und5 ausdrücklich ausgelassene DB-Fälle. Diese5 sind im isolierten lokalen
45er-Lauf bestanden. Keine RMM-Jobs oder neue Capabilities aus diesem Unitlauf;
Runtimeaustausch, tatsächlicher signierter Abgleich und genehmigter Fulljob bleiben
eigene noch offene Schritte.
der inzwischen ausgeführte Runtimeaustausch ist separat belegt. Tatsächlicher
signierter Folgeabgleich und genehmigter Fulljob bleiben eigene offene Schritte.
Details und Nach-MVP-Entdeckung:
[script-console-helper-generations.md](../../docs/script-console-helper-generations.md).
+257
View File
@@ -0,0 +1,257 @@
#!/usr/bin/env python3
"""One preserving continuation of the installed, never-started Linux Full pair.
No stop, swap, install, rollback, SQL write, job or approval. Parent executes after
review; absent original restart intent and exact fresh pre-start CAS required.
"""
import argparse
import base64
import hashlib
import inspect
import json
import os
from pathlib import Path
import uuid
ROOT=Path(__file__).resolve().parents[1]
INSTALL_SHA='667b56f7e5f085db249f27a7094919c7c0e6055dabc9f0600cb261c34760cd26'
if hashlib.sha256((ROOT/'deploy/script_console_install.py').read_bytes()).hexdigest()!=INSTALL_SHA:
raise RuntimeError('Original install source must stay unchanged')
import script_console_install as old
support=old.support
ORIGINAL=ROOT/'devstate/script-console-install/2e27c312-58cc-444d-92a6-863a11ac6ffd'
ORIGINAL_SHA='8aec7bf7df13bc4968f47ca1554c813406409530613ce95241e74a81204cd02e'
READBACK=ORIGINAL/'readback-36f94d52-caf4-4b63-ac07-827edda4f806.json'
READBACK_SHA='b8964cd12ffd57226081980edfa1d33c99718fcb470979a29aa02a8af8fbd9ba'
STATE=ROOT/'devstate/script-console-continue'
def require(value,code):
if not value:raise RuntimeError(code)
def guards():
require(support.sha(ROOT/'deploy/script_console_install.py')==INSTALL_SHA
and support.sha(ROOT/'deploy/script_console_bootstrap.py')==old.PREFLIGHT_SHA
and support.sha(ORIGINAL/'intent.json')==ORIGINAL_SHA and support.sha(READBACK)==READBACK_SHA,
'exact original install/readback/source')
old.pre.native.verify_support()
manifest=support.load(old.pre.native.PACK/'manifest.json')
require(support.sha(old.pre.native.PACK/'manifest.json')==old.pre.native.MANIFEST_SHA
and support.sha(old.pre.NATIVE)==old.pre.NATIVE_SHA and len(manifest['source_files'])==158
and all(support.sha(ROOT/n)==h for n,h in manifest['source_files'].items()),'unchanged158 inputs and native Linux84')
def continue_vm(request):
import base64
import datetime as dt
import fcntl
import hashlib
import json
import os
from pathlib import Path
import sqlite3
import stat
import subprocess
import traceback
import uuid
os.umask(0o077)
p=request['original'];ident=p['id'];recovery=str(uuid.UUID(request['id']))
require(recovery==request['id'] and ident=='2e27c312-58cc-444d-92a6-863a11ac6ffd'
and request['action'] in ('continue','read') and os.geteuid()==0 and os.uname().machine=='x86_64','fixed root continuation')
case=Path('/var/lib/rmm-bootstrap-history')/('script-console-v1-'+ident)
# Exact reviewed original helpers are copied below, no installation branch.
def encode(v):return json.dumps(v,sort_keys=True,separators=(',',':')).encode()
def sha(b):return hashlib.sha256(b).hexdigest()
def fsync_dir(path):
fd=os.open(path,os.O_RDONLY|os.O_DIRECTORY|os.O_NOFOLLOW)
try:os.fsync(fd)
finally:os.close(fd)
def create(path,raw,mode=0o600,gid=0):
fd=os.open(path,os.O_WRONLY|os.O_CREAT|os.O_EXCL|os.O_NOFOLLOW,mode)
with os.fdopen(fd,'wb') as out:
out.write(raw);out.flush();os.fchmod(out.fileno(),mode);os.fchown(out.fileno(),0,gid);os.fsync(out.fileno())
fsync_dir(path.parent)
def safe(path,directory=False,owner=0):
m=path.lstat();require(not path.is_symlink() and m.st_uid==owner and not m.st_mode&0o022
and (stat.S_ISDIR(m.st_mode) if directory else stat.S_ISREG(m.st_mode) and m.st_nlink==1),'safe owned path')
return m
def run(args,**kwargs):return subprocess.run(args,capture_output=True,check=True,timeout=25,**kwargs).stdout
def svc(name):
return dict(line.split('=',1) for line in run(['systemctl','show',name,'-p','ActiveState','-p','MainPID','-p','UnitFileState']).decode().splitlines())
def retained_files():
# Never open private device keys. Retain all file identities, sizes,
# modes and change timestamps; SQL content has its own full row witness.
value={}
for root in (Path('/var/lib/rmm-agent-remote'),Path('/var/lib/rmm-helper')):
for path in [root,*sorted(root.rglob('*'))]:
m=path.lstat();require(not path.is_symlink() and (stat.S_ISDIR(m.st_mode) or stat.S_ISREG(m.st_mode)),'no unexpected retained state object')
if str(path).endswith(('-journal','-wal','-shm')):raise RuntimeError('Settled journal required')
value[str(path)]=[m.st_dev,m.st_ino,m.st_uid,m.st_gid,m.st_mode,m.st_size,m.st_mtime_ns,m.st_ctime_ns]
return value
def sql_witness():
result={}
for name,identity in p['preflight']['database_inodes'].items():
path=Path(name);m=path.lstat();require([m.st_dev,m.st_ino]==identity and not path.is_symlink(),'preserved DB identity')
require(all(not os.path.lexists(str(path)+suffix) for suffix in ('-wal','-shm','-journal')),'no live SQLite sidecars')
db=sqlite3.connect(path.as_uri()+'?mode=ro',uri=True)
try:
db.execute('PRAGMA query_only=ON');db.execute('BEGIN')
require(db.execute('PRAGMA integrity_check').fetchone()[0]=='ok','retained SQL integrity')
tables=dict(db.execute("SELECT name,sql FROM sqlite_master WHERE type='table' ORDER BY name"))
rows={}
for table in tables:
require(table.replace('_','').isalnum(),'fixed SQLite identifier')
rows[table]=[sha(encode([dict(blob_sha256=sha(v),bytes=len(v)) if isinstance(v,bytes) else v for v in row]))
for row in db.execute('SELECT rowid,* FROM "'+table+'" ORDER BY rowid')]
result[name]=dict(schema=tables,rows=rows,identity=identity)
if path.name=='journal.sqlite':
require(db.execute("SELECT count(*) FROM job_attempts WHERE state NOT IN ('succeeded','failed','cancelled','expired')").fetchone()[0]==0,'no running job')
if path.parent.name=='rmm-helper':
current=db.execute('SELECT c.grant_id,c.agent,c.generation,c.job,c.attempt,c.result,e.start,e.outcome FROM consumed c LEFT JOIN execution_evidence e USING(grant_id) ORDER BY grant_id').fetchall()
exact={r[0]:sha(json.dumps([dict(sha256=sha(v),size=len(v)) if isinstance(v,bytes) else v for v in r],separators=(',',':')).encode()) for r in current}
require(exact==p['preflight']['root_rows'] and len(exact)==18 and all(r[5] is not None for r in current),'exact retained Root18')
finally:db.close()
return result
def description(path):
if not os.path.lexists(path):return dict(present=False)
m=path.lstat();require(not path.is_symlink() and stat.S_ISREG(m.st_mode),'fixed regular public file')
return dict(present=True,device=m.st_dev,inode=m.st_ino,uid=m.st_uid,gid=m.st_gid,
mode=stat.S_IMODE(m.st_mode),bytes=m.st_size,symlink=False,regular=True,sha256=sha(path.read_bytes()))
def receipt(path):
safe(path);require(path.stat().st_size<=8*1024*1024,'bounded private receipt')
return json.loads(path.read_bytes())
def services():
value={}
for name in ('rmm-helper-cloud.service','rmm-full-maintenance-helper.service','rmm-agent-remote.service','rmm-apt-helper.service'):
reply=subprocess.run(['systemctl','show',name,'-p','LoadState','-p','ActiveState','-p','SubState','-p','MainPID','-p','UnitFileState'],capture_output=True,timeout=25)
value[name]=dict(exit_code=reply.returncode,properties=dict(line.split('=',1) for line in reply.stdout.decode().splitlines() if '=' in line))
return value
safe(case,True);safe(case/'intent.json')
require((case/'intent.json').read_bytes()==encode(p),'complete original remote intent')
marker=case/'continuation-start-intent.json';result_path=case/'continuation-result.json'
if request['action']=='read':
return dict(id=recovery,readback_only=True,original_case=ident,services=services(),
original_report_historical=receipt(case/'report.json'),
original_restart_intent_present=os.path.lexists(case/'restart-intent.json'),
continuation_entered=os.path.lexists(marker),continuation_intent=receipt(marker) if os.path.lexists(marker) else None,
historical_continuation_result=receipt(result_path) if os.path.lexists(result_path) else None,
current_files={name:description(Path(path)) for name,path in (('agent','/usr/local/libexec/rmm-agent-remote'),('helper','/usr/local/libexec/rmm-privileged-helper'))},
state_writes=False,rmm_jobs=False,approvals=False,retry_allowed=False)
gate=request['fresh_server_gate']
require(gate['closed'] is True and gate['counts']==dict(jobs=30,outbox=30,permits=26,unresolved=0)
and gate['policy_sha256']==p['central_policy_sha256'],'fresh central scope still closed')
observed_at=dt.datetime.fromisoformat(gate['observed_at'])
require(observed_at.utcoffset() is not None and -5<=(dt.datetime.now(dt.timezone.utc)-observed_at).total_seconds()<=60,'fresh bounded server gate')
require(not os.path.lexists(case/'restart-intent.json') and not os.path.lexists(marker)
and not os.path.lexists(result_path),'no prior original or continuation start')
require(Path('/proc/sys/kernel/random/boot_id').read_text().strip()==p['preflight']['boot_id'],'same boot before continuation')
observed=request['original_readback']
for name,expected in observed['markers'].items():
current=description(case/(name+'.json'))
require(current=={k:v for k,v in expected.items() if k!='historical_content'},'original markers retained exactly')
require(description(case/'report.json')=={k:v for k,v in observed['historical_report'].items() if k!='historical_content'},'original failed report retained exactly')
report=receipt(case/'report.json')
require(report['stage']=='incomplete_manual_review' and report['preserved_before_restart'] is True
and report['completed_preserving_bootstrap'] is False and report['full_job_accepted'] is False,'exact installed-before-first-start phase')
states=services()
for name,item in states.items():
require(item['exit_code']==0 and item['properties']==observed['services'][name]['properties']
and item['properties']['ActiveState']=='inactive' and item['properties']['MainPID']=='0','all four services still inactive')
binaries={'agent':Path('/usr/local/libexec/rmm-agent-remote'),'helper':Path('/usr/local/libexec/rmm-privileged-helper')}
for key,path in binaries.items():
require(description(path)==observed['files'][key+'_current'] and sha(path.read_bytes())==p['artifacts'][key]['sha256'],'same qualified installed image')
require(description(case/(key+'-previous'))==observed['files'][key+'_previous'],'same preserved old image')
require(not os.path.lexists(case/(key+'-next')),'no leftover image exchange')
for name,expected in p['baseline']['controls'].items():
if name in [str(x) for x in binaries.values()]:continue
path=Path(name);m=path.lstat()
require(not path.is_symlink() and dict(device=m.st_dev,inode=m.st_ino,mode=stat.S_IMODE(m.st_mode),uid=m.st_uid,gid=m.st_gid,bytes=m.st_size,sha256=sha(path.read_bytes()))==expected,'all General/APT/package controls unchanged')
# GeneralPin/Identity serde declaration order is the original inspector's
# order. The historical report uses sorted object keys and is not the raw
# pin-file encoding. Reconstruct the original exact compact bytes explicitly.
full_pin={k:report['full_pin'][k] for k in ('schema_version','profile','identity','policy_sha256','helper_binary_sha256')}
full_pin['identity']={k:full_pin['identity'][k] for k in ('tenant_id','asset_id','agent_id','enrollment_generation','assignment_version','signing_key_id')}
new_files={
'/etc/rmm-remote/helper-full-maintenance.json':(base64.b64decode(p['baseline']['full_config_candidate']['bytes_b64'],validate=True),0o600,0),
'/etc/rmm-remote/full-maintenance-helper-proof.json':(json.dumps(full_pin,separators=(',',':')).encode(),0o640,984),
'/etc/systemd/system/rmm-full-maintenance-helper.service':(base64.b64decode(p['unit_bytes_b64'],validate=True),0o644,0),
'/etc/systemd/system/rmm-agent-remote.service.d/60-full-maintenance.conf':(b'[Service]\nEnvironment=RMM_FULL_MAINTENANCE_HELPER_SOCKET=/run/rmm-helper-maintenance/control.sock\nEnvironment=RMM_FULL_MAINTENANCE_POLICY_FILE=/etc/rmm-remote/full-maintenance-helper-proof.json\n',0o644,0)}
for name,(raw,mode,gid) in new_files.items():
path=Path(name);m=safe(path)
require(m.st_gid==gid and stat.S_IMODE(m.st_mode)==mode and path.read_bytes()==raw,'exact new Full control bytes/modes')
env={'PATH':'/usr/sbin:/usr/bin:/sbin:/bin','LANG':'C','LC_ALL':'C','RMM_HELPER_CONFIG':'/etc/rmm-remote/helper-full-maintenance.json'}
pin=json.loads(run([str(binaries['helper']),'--inspect-full-maintenance-profile'],env=env))
require(pin==report['full_pin'] and pin['helper_binary_sha256']==p['artifacts']['helper']['sha256']
and pin['identity']==p['general_pin']['identity'],'actual protected Full image/policy/identity')
env['RMM_HELPER_CONFIG']='/etc/rmm-remote/helper-general.json'
require(json.loads(run([str(binaries['helper']),'--inspect-general-profile'],env=env))==p['general_pin'],'preserved General profile')
names=('User','Group','NoNewPrivileges','PrivateNetwork','PrivateTmp','ProtectSystem','ProtectHome',
'ProtectKernelTunables','ProtectKernelModules','ProtectControlGroups','RestrictSUIDSGID',
'RestrictAddressFamilies','SystemCallFilter','RootDirectory','RootImage','NeedDaemonReload','FragmentPath','DropInPaths')
effective=dict(line.split('=',1) for line in run(['systemctl','show','rmm-full-maintenance-helper.service',*[a for n in names for a in ('-p',n)]]).decode().splitlines())
require(effective['User']=='root' and effective['Group']=='rmm-agent'
and all(effective[n]=='no' for n in names[2:11])
and all(effective[n] in ('','~') for n in names[11:13])
and effective['RootDirectory']==effective['RootImage']==effective['DropInPaths']==''
and effective['NeedDaemonReload']=='no' and effective['FragmentPath']=='/etc/systemd/system/rmm-full-maintenance-helper.service','exact unrestricted loaded Fullunit; empty allow/deny lists only')
locks=[]
for path in (Path('/var/lib/rmm-agent-remote/agent.lock'),Path('/var/lib/rmm-helper/executor.lock')):
fd=os.open(path,os.O_RDONLY|os.O_NOFOLLOW);fcntl.flock(fd,fcntl.LOCK_EX|fcntl.LOCK_NB);locks.append(fd)
try:
before_sql=receipt(case/'sql-before.json');before_files=receipt(case/'files-before.json')
require(sql_witness()==before_sql and retained_files()==before_files,'all original SQL rows/inodes/PKI metadata preserved before first start')
require(services()==states and not os.path.lexists(case/'restart-intent.json'),'fresh final stopped-state CAS')
first_start_not_before=dt.datetime.now(dt.timezone.utc).isoformat()
create(marker,encode(dict(id=recovery,original_case=ident,runner_sha256=request['runner_sha256'],first_start_not_before=first_start_not_before,
original_report_sha256=description(case/'report.json')['sha256'],sql_before_sha256=sha((case/'sql-before.json').read_bytes()),
files_before_sha256=sha((case/'files-before.json').read_bytes()),first_start_once=True,no_retry=True,
fresh_server_gate=gate,effective_full_unit=effective)))
finally:
for fd in reversed(locks):fcntl.flock(fd,fcntl.LOCK_UN);os.close(fd)
outcome=dict(id=recovery,original_case=ident,first_start_entered=True,completed=False,first_start_not_before=first_start_not_before,
preserved_before_first_start=True,signed_sync_verified=False,full_job_accepted=False,
direct_product_state_writes=False,rmm_jobs=False,approvals=False,package_effects=False,reboot_requested=False,started=[])
try:
for name,key,uid in (('rmm-helper-cloud.service','general',0),('rmm-full-maintenance-helper.service','full',0),('rmm-agent-remote.service','agent',993)):
run(['systemctl','start',name]);state=svc(name);require(state['ActiveState']=='active' and int(state['MainPID'])>0,'exact first service start active')
pid=int(state['MainPID']);proc=Path('/proc',str(pid));ticks=(proc/'stat').read_text().rsplit(')',1)[1].split()[19]
status=(proc/'status').read_text().splitlines();uids=next(x.split()[1:] for x in status if x.startswith('Uid:'));gids=next(x.split()[1:] for x in status if x.startswith('Gid:'))
image=sha((proc/'exe').read_bytes())
require(uids==[str(uid)]*4 and gids==['984']*4 and image==p['artifacts']['agent' if key=='agent' else 'helper']['sha256']
and (proc/'stat').read_text().rsplit(')',1)[1].split()[19]==ticks and svc(name)['MainPID']==str(pid),'actual same new process/code/account')
evidence=dict(name=name,pid=pid,start_ticks=ticks,sha256=image,uids=uids,gids=gids)
create(case/('continuation-'+key+'-started.json'),encode(evidence));outcome['started'].append(evidence)
require(svc('rmm-apt-helper.service')['ActiveState']=='inactive' and svc('rmm-apt-helper.service')['UnitFileState']=='disabled','APT remains closed')
require(Path('/proc/sys/kernel/random/boot_id').read_text().strip()==p['preflight']['boot_id'],'same final boot')
outcome['completed']=True
except Exception as e:outcome.update(error_class=type(e).__name__,frames=[dict(function=f.name,line=f.lineno) for f in traceback.extract_tb(e.__traceback__)])
create(result_path,encode(outcome));return outcome
def main():
parser=argparse.ArgumentParser(description=__doc__);parser.add_argument('mode',choices=('prepare-local','continue','read'));parser.add_argument('--case');args=parser.parse_args()
os.umask(0o077);STATE.mkdir(mode=0o700,parents=True,exist_ok=True);guards()
if args.mode=='prepare-local':
require(args.case is None,'new local-only continuation intent');case=str(uuid.uuid4());folder=STATE/case;folder.mkdir(mode=0o700)
intent=dict(id=case,runner_sha256=support.sha(__file__),install_sha256=INSTALL_SHA,original=support.load(ORIGINAL/'intent.json'),original_readback=support.load(READBACK))
support.save(folder/'intent.json',intent)
else:
case=str(uuid.UUID(args.case));require(case==args.case,'original canonical recovery case');folder=STATE/case;intent=support.load(folder/'intent.json')
require(intent==dict(id=case,runner_sha256=support.sha(__file__),install_sha256=INSTALL_SHA,original=support.load(ORIGINAL/'intent.json'),original_readback=support.load(READBACK)),'exact original same-source recovery JSON')
guards()
if args.mode=='continue':
support.save(folder/'continue-entered-local.json',dict(start_once=True,no_retry=True))
gate=old.rpc(old.server_prefix(),old.server_gate,intent['original'],folder);support.save(folder/'server-gate.json',gate)
guards();result=old.rpc(support.access_settings(old.pre.ACCESS_ROOT,'linux'),continue_vm,dict(intent,action='continue',fresh_server_gate=gate),folder)
support.save(folder/'continue-reply.json',result)
require(result['completed'] is True and result['preserved_before_first_start'] is True
and result['signed_sync_verified'] is False and result['full_job_accepted'] is False
and result['rmm_jobs'] is False and result['approvals'] is False,'continuation incomplete; readback only')
else:
result=old.rpc(support.access_settings(old.pre.ACCESS_ROOT,'linux'),continue_vm,dict(intent,action='read'),folder)
support.save(folder/('readback-'+str(uuid.uuid4())+'.json'),result)
print(json.dumps(dict(case_id=case,mode=args.mode,intent=str(folder/'intent.json'),intent_sha256=support.sha(folder/'intent.json'),target_called=args.mode!='prepare-local',rmm_jobs=False,approvals=False)))
if __name__=='__main__':main()
+300
View File
@@ -0,0 +1,300 @@
#!/usr/bin/env python3
"""Finish the two never-started services; never start/stop/restart General.
Exact original installation + first-start receipts preserved. Each remaining
service has its own durable intent before one start, with a bounded native probe.
"""
import argparse
import hashlib
import inspect
import json
import os
from pathlib import Path
import uuid
ROOT=Path(__file__).resolve().parents[1]
PRIOR_SHA='c0c0ecf1e1bcb2d2f9ce0bcf6973aa430e9e28ba86823ca5ad0954744a589238'
if hashlib.sha256((ROOT/'deploy/script_console_continue.py').read_bytes()).hexdigest()!=PRIOR_SHA:
raise RuntimeError('Original continuation source stays unchanged')
import script_console_continue as prior
old=prior.old
support=prior.support
PREVIOUS=ROOT/'devstate/script-console-continue/43dae370-6862-4cf4-a83c-0b2612af6c79'
PREVIOUS_INTENT_SHA='f9059e74b3abca44f49216cbde45e036ac4701354d76d0cc9cca8acc41aaff0c'
PREVIOUS_READBACK=PREVIOUS/'readback-b49d10b0-fda3-459a-b286-e6911c9c37eb.json'
PREVIOUS_READBACK_SHA='5aac963e78fa5e587d9137ddd7394f6fde19cd1cfedbbb8528517b0d15e18006'
STATE=ROOT/'devstate/script-console-finish-start'
def require(value,code):
if not value:raise RuntimeError(code)
def guards():
prior.guards()
require(support.sha(ROOT/'deploy/script_console_continue.py')==PRIOR_SHA
and support.sha(PREVIOUS/'intent.json')==PREVIOUS_INTENT_SHA
and support.sha(PREVIOUS_READBACK)==PREVIOUS_READBACK_SHA,'exact original continuation/source/readback')
def finish_vm(request):
import base64
import datetime as dt
import fcntl
import time
import hashlib
import json
import os
from pathlib import Path
import sqlite3
import stat
import subprocess
import traceback
import uuid
os.umask(0o077)
p=request['original'];ident=p['id'];recovery=str(uuid.UUID(request['id']))
require(recovery==request['id'] and ident=='2e27c312-58cc-444d-92a6-863a11ac6ffd'
and request['action'] in ('finish','read') and os.geteuid()==0 and os.uname().machine=='x86_64','fixed root continuation')
case=Path('/var/lib/rmm-bootstrap-history')/('script-console-v1-'+ident)
# Exact reviewed original helpers are copied below, no installation branch.
def encode(v):return json.dumps(v,sort_keys=True,separators=(',',':')).encode()
def sha(b):return hashlib.sha256(b).hexdigest()
def fsync_dir(path):
fd=os.open(path,os.O_RDONLY|os.O_DIRECTORY|os.O_NOFOLLOW)
try:os.fsync(fd)
finally:os.close(fd)
def create(path,raw,mode=0o600,gid=0):
fd=os.open(path,os.O_WRONLY|os.O_CREAT|os.O_EXCL|os.O_NOFOLLOW,mode)
with os.fdopen(fd,'wb') as out:
out.write(raw);out.flush();os.fchmod(out.fileno(),mode);os.fchown(out.fileno(),0,gid);os.fsync(out.fileno())
fsync_dir(path.parent)
def safe(path,directory=False,owner=0):
m=path.lstat();require(not path.is_symlink() and m.st_uid==owner and not m.st_mode&0o022
and (stat.S_ISDIR(m.st_mode) if directory else stat.S_ISREG(m.st_mode) and m.st_nlink==1),'safe owned path')
return m
def run(args,**kwargs):return subprocess.run(args,capture_output=True,check=True,timeout=25,**kwargs).stdout
def svc(name):
return dict(line.split('=',1) for line in run(['systemctl','show',name,'-p','ActiveState','-p','MainPID','-p','UnitFileState']).decode().splitlines())
def retained_files():
# Never open private device keys. Retain all file identities, sizes,
# modes and change timestamps; SQL content has its own full row witness.
value={}
for root in (Path('/var/lib/rmm-agent-remote'),Path('/var/lib/rmm-helper')):
for path in [root,*sorted(root.rglob('*'))]:
m=path.lstat();require(not path.is_symlink() and (stat.S_ISDIR(m.st_mode) or stat.S_ISREG(m.st_mode)),'no unexpected retained state object')
if str(path).endswith(('-journal','-wal','-shm')):raise RuntimeError('Settled journal required')
value[str(path)]=[m.st_dev,m.st_ino,m.st_uid,m.st_gid,m.st_mode,m.st_size,m.st_mtime_ns,m.st_ctime_ns]
return value
def sql_witness():
result={}
for name,identity in p['preflight']['database_inodes'].items():
path=Path(name);m=path.lstat();require([m.st_dev,m.st_ino]==identity and not path.is_symlink(),'preserved DB identity')
require(all(not os.path.lexists(str(path)+suffix) for suffix in ('-wal','-shm','-journal')),'no live SQLite sidecars')
db=sqlite3.connect(path.as_uri()+'?mode=ro',uri=True)
try:
db.execute('PRAGMA query_only=ON');db.execute('BEGIN')
require(db.execute('PRAGMA integrity_check').fetchone()[0]=='ok','retained SQL integrity')
tables=dict(db.execute("SELECT name,sql FROM sqlite_master WHERE type='table' ORDER BY name"))
rows={}
for table in tables:
require(table.replace('_','').isalnum(),'fixed SQLite identifier')
rows[table]=[sha(encode([dict(blob_sha256=sha(v),bytes=len(v)) if isinstance(v,bytes) else v for v in row]))
for row in db.execute('SELECT rowid,* FROM "'+table+'" ORDER BY rowid')]
result[name]=dict(schema=tables,rows=rows,identity=identity)
if path.name=='journal.sqlite':
require(db.execute("SELECT count(*) FROM job_attempts WHERE state NOT IN ('succeeded','failed','cancelled','expired')").fetchone()[0]==0,'no running job')
if path.parent.name=='rmm-helper':
current=db.execute('SELECT c.grant_id,c.agent,c.generation,c.job,c.attempt,c.result,e.start,e.outcome FROM consumed c LEFT JOIN execution_evidence e USING(grant_id) ORDER BY grant_id').fetchall()
exact={r[0]:sha(json.dumps([dict(sha256=sha(v),size=len(v)) if isinstance(v,bytes) else v for v in r],separators=(',',':')).encode()) for r in current}
require(exact==p['preflight']['root_rows'] and len(exact)==18 and all(r[5] is not None for r in current),'exact retained Root18')
finally:db.close()
return result
def description(path):
if not os.path.lexists(path):return dict(present=False)
m=path.lstat();require(not path.is_symlink() and stat.S_ISREG(m.st_mode),'fixed regular public file')
return dict(present=True,device=m.st_dev,inode=m.st_ino,uid=m.st_uid,gid=m.st_gid,
mode=stat.S_IMODE(m.st_mode),bytes=m.st_size,symlink=False,regular=True,sha256=sha(path.read_bytes()))
def receipt(path):
safe(path);require(path.stat().st_size<=8*1024*1024,'bounded private receipt')
return json.loads(path.read_bytes())
def services():
value={}
for name in ('rmm-helper-cloud.service','rmm-full-maintenance-helper.service','rmm-agent-remote.service','rmm-apt-helper.service'):
reply=subprocess.run(['systemctl','show',name,'-p','LoadState','-p','ActiveState','-p','SubState','-p','MainPID','-p','UnitFileState'],capture_output=True,timeout=25)
value[name]=dict(exit_code=reply.returncode,properties=dict(line.split('=',1) for line in reply.stdout.decode().splitlines() if '=' in line))
return value
safe(case,True);safe(case/'intent.json')
require((case/'intent.json').read_bytes()==encode(p),'complete original remote intent')
marker=case/'finish-start-intent.json';result_path=case/'finish-result.json'
if request['action']=='read':
return dict(id=recovery,readback_only=True,original_case=ident,services=services(),
original_report_historical=receipt(case/'report.json'),
original_restart_intent_present=os.path.lexists(case/'restart-intent.json'),
finish_entered=os.path.lexists(marker),finish_intent=receipt(marker) if os.path.lexists(marker) else None,
first_continuation_report_historical=receipt(case/'continuation-result.json'),
historical_finish_result=receipt(result_path) if os.path.lexists(result_path) else None,
current_files={name:description(Path(path)) for name,path in (('agent','/usr/local/libexec/rmm-agent-remote'),('helper','/usr/local/libexec/rmm-privileged-helper'))},
state_writes=False,rmm_jobs=False,approvals=False,retry_allowed=False)
previous=request['first_continuation_readback']
require((case/'continuation-start-intent.json').read_bytes()==encode(previous['continuation_intent'])
and (case/'continuation-result.json').read_bytes()==encode(previous['historical_continuation_result']),
'original first-start marker/result retained byte-for-byte')
require(previous['historical_continuation_result']['completed'] is False
and previous['historical_continuation_result']['started']==[],'known first General probe stopped the sequence')
for label in ('general','full','agent'):
require(not os.path.lexists(case/('continuation-'+label+'-started.json'))
and not os.path.lexists(case/('finish-'+label+'-start-intent.json'))
and not os.path.lexists(case/('finish-'+label+'-started.json')),'no previous confirmed or remaining-service start')
def probe(name,uid):
state=svc(name);require(state['ActiveState']=='active' and int(state['MainPID'])>0,'service process not ready')
pid=int(state['MainPID']);proc=Path('/proc',str(pid));ticks=(proc/'stat').read_text().rsplit(')',1)[1].split()[19]
status=(proc/'status').read_text().splitlines();uids=next(x.split()[1:] for x in status if x.startswith('Uid:'));gids=next(x.split()[1:] for x in status if x.startswith('Gid:'))
image=sha((proc/'exe').read_bytes());key='agent' if name=='rmm-agent-remote.service' else 'helper'
require(uids==[str(uid)]*4 and gids==['984']*4 and image==p['artifacts'][key]['sha256']
and (proc/'stat').read_text().rsplit(')',1)[1].split()[19]==ticks and svc(name)['MainPID']==str(pid)
and Path('/proc/sys/kernel/random/boot_id').read_text().strip()==p['preflight']['boot_id'],'same actual process/account/image/boot')
return dict(name=name,pid=pid,start_ticks=ticks,sha256=image,uids=uids,gids=gids)
def exact_general():
value=probe('rmm-helper-cloud.service',0)
require(value['pid']==65562 and value['start_ticks']=='7308498','original already-running General birth')
return value
def poll_started(name,uid):
deadline=time.monotonic()+5;first_birth=None;settled=None
while time.monotonic()<deadline:
state=svc(name);pid=int(state['MainPID'])
if pid>0:
try:birth=(pid,Path('/proc',str(pid),'stat').read_text().rsplit(')',1)[1].split()[19])
except FileNotFoundError:birth=None
if birth is not None:
if first_birth is None:first_birth=birth
require(birth==first_birth,'no service PID/birth replacement during first start')
try:value=probe(name,uid)
except (RuntimeError,FileNotFoundError,ProcessLookupError):value=None
if value is not None and value==settled:return value
settled=value;time.sleep(0.05)
raise RuntimeError('First-start process did not settle in five seconds; readback only')
gate=request['fresh_server_gate']
require(gate['closed'] is True and gate['counts']==dict(jobs=30,outbox=30,permits=26,unresolved=0)
and gate['policy_sha256']==p['central_policy_sha256'],'fresh central scope still closed')
observed_at=dt.datetime.fromisoformat(gate['observed_at'])
require(observed_at.utcoffset() is not None and -5<=(dt.datetime.now(dt.timezone.utc)-observed_at).total_seconds()<=60,'fresh bounded server gate')
require(not os.path.lexists(case/'restart-intent.json') and not os.path.lexists(marker)
and not os.path.lexists(result_path),'no prior original or continuation start')
require(Path('/proc/sys/kernel/random/boot_id').read_text().strip()==p['preflight']['boot_id'],'same boot before continuation')
observed=request['original_readback']
for name,expected in observed['markers'].items():
current=description(case/(name+'.json'))
require(current=={k:v for k,v in expected.items() if k!='historical_content'},'original markers retained exactly')
require(description(case/'report.json')=={k:v for k,v in observed['historical_report'].items() if k!='historical_content'},'original failed report retained exactly')
report=receipt(case/'report.json')
require(report['stage']=='incomplete_manual_review' and report['preserved_before_restart'] is True
and report['completed_preserving_bootstrap'] is False and report['full_job_accepted'] is False,'exact installed-before-first-start phase')
states=services()
for name,item in states.items():
require(item['exit_code']==0 and item['properties']==previous['services'][name]['properties']
and ((name=='rmm-helper-cloud.service' and item['properties']['ActiveState']=='active' and item['properties']['MainPID']=='65562')
or (name!='rmm-helper-cloud.service' and item['properties']['ActiveState']=='inactive' and item['properties']['MainPID']=='0')),'exact General running and remaining services inactive')
general_before=exact_general()
binaries={'agent':Path('/usr/local/libexec/rmm-agent-remote'),'helper':Path('/usr/local/libexec/rmm-privileged-helper')}
for key,path in binaries.items():
require(description(path)==observed['files'][key+'_current'] and sha(path.read_bytes())==p['artifacts'][key]['sha256'],'same qualified installed image')
require(description(case/(key+'-previous'))==observed['files'][key+'_previous'],'same preserved old image')
require(not os.path.lexists(case/(key+'-next')),'no leftover image exchange')
for name,expected in p['baseline']['controls'].items():
if name in [str(x) for x in binaries.values()]:continue
path=Path(name);m=path.lstat()
require(not path.is_symlink() and dict(device=m.st_dev,inode=m.st_ino,mode=stat.S_IMODE(m.st_mode),uid=m.st_uid,gid=m.st_gid,bytes=m.st_size,sha256=sha(path.read_bytes()))==expected,'all General/APT/package controls unchanged')
# GeneralPin/Identity serde declaration order is the original inspector's
# order. The historical report uses sorted object keys and is not the raw
# pin-file encoding. Reconstruct the original exact compact bytes explicitly.
full_pin={k:report['full_pin'][k] for k in ('schema_version','profile','identity','policy_sha256','helper_binary_sha256')}
full_pin['identity']={k:full_pin['identity'][k] for k in ('tenant_id','asset_id','agent_id','enrollment_generation','assignment_version','signing_key_id')}
new_files={
'/etc/rmm-remote/helper-full-maintenance.json':(base64.b64decode(p['baseline']['full_config_candidate']['bytes_b64'],validate=True),0o600,0),
'/etc/rmm-remote/full-maintenance-helper-proof.json':(json.dumps(full_pin,separators=(',',':')).encode(),0o640,984),
'/etc/systemd/system/rmm-full-maintenance-helper.service':(base64.b64decode(p['unit_bytes_b64'],validate=True),0o644,0),
'/etc/systemd/system/rmm-agent-remote.service.d/60-full-maintenance.conf':(b'[Service]\nEnvironment=RMM_FULL_MAINTENANCE_HELPER_SOCKET=/run/rmm-helper-maintenance/control.sock\nEnvironment=RMM_FULL_MAINTENANCE_POLICY_FILE=/etc/rmm-remote/full-maintenance-helper-proof.json\n',0o644,0)}
for name,(raw,mode,gid) in new_files.items():
path=Path(name);m=safe(path)
require(m.st_gid==gid and stat.S_IMODE(m.st_mode)==mode and path.read_bytes()==raw,'exact new Full control bytes/modes')
env={'PATH':'/usr/sbin:/usr/bin:/sbin:/bin','LANG':'C','LC_ALL':'C','RMM_HELPER_CONFIG':'/etc/rmm-remote/helper-full-maintenance.json'}
pin=json.loads(run([str(binaries['helper']),'--inspect-full-maintenance-profile'],env=env))
require(pin==report['full_pin'] and pin['helper_binary_sha256']==p['artifacts']['helper']['sha256']
and pin['identity']==p['general_pin']['identity'],'actual protected Full image/policy/identity')
env['RMM_HELPER_CONFIG']='/etc/rmm-remote/helper-general.json'
require(json.loads(run([str(binaries['helper']),'--inspect-general-profile'],env=env))==p['general_pin'],'preserved General profile')
names=('User','Group','NoNewPrivileges','PrivateNetwork','PrivateTmp','ProtectSystem','ProtectHome',
'ProtectKernelTunables','ProtectKernelModules','ProtectControlGroups','RestrictSUIDSGID',
'RestrictAddressFamilies','SystemCallFilter','RootDirectory','RootImage','NeedDaemonReload','FragmentPath','DropInPaths')
effective=dict(line.split('=',1) for line in run(['systemctl','show','rmm-full-maintenance-helper.service',*[a for n in names for a in ('-p',n)]]).decode().splitlines())
require(effective['User']=='root' and effective['Group']=='rmm-agent'
and all(effective[n]=='no' for n in names[2:11])
and all(effective[n] in ('','~') for n in names[11:13])
and effective['RootDirectory']==effective['RootImage']==effective['DropInPaths']==''
and effective['NeedDaemonReload']=='no' and effective['FragmentPath']=='/etc/systemd/system/rmm-full-maintenance-helper.service','exact unrestricted loaded Fullunit; empty allow/deny lists only')
locks=[]
for path in (Path('/var/lib/rmm-agent-remote/agent.lock'),Path('/var/lib/rmm-helper/executor.lock')):
fd=os.open(path,os.O_RDONLY|os.O_NOFOLLOW);fcntl.flock(fd,fcntl.LOCK_EX|fcntl.LOCK_NB);locks.append(fd)
try:
before_sql=receipt(case/'sql-before.json');before_files=receipt(case/'files-before.json')
require(sha((case/'sql-before.json').read_bytes())==previous['continuation_intent']['sql_before_sha256']
and sha((case/'files-before.json').read_bytes())==previous['continuation_intent']['files_before_sha256'],'exact original preserved state witnesses')
require(sql_witness()==before_sql and retained_files()==before_files,'all original SQL rows/inodes/PKI metadata preserved before first start')
require(services()==states and exact_general()==general_before
and not os.path.lexists(case/'restart-intent.json'),'fresh General-birth and remaining-stopped CAS')
first_start_not_before=previous['continuation_intent']['first_start_not_before']
remaining_start_not_before=dt.datetime.now(dt.timezone.utc).isoformat()
create(marker,encode(dict(id=recovery,original_case=ident,runner_sha256=request['runner_sha256'],first_start_not_before=first_start_not_before,remaining_start_not_before=remaining_start_not_before,
general_before=general_before,original_report_sha256=description(case/'report.json')['sha256'],sql_before_sha256=sha((case/'sql-before.json').read_bytes()),
files_before_sha256=sha((case/'files-before.json').read_bytes()),first_start_once=True,no_retry=True,
fresh_server_gate=gate,effective_full_unit=effective)))
finally:
for fd in reversed(locks):fcntl.flock(fd,fcntl.LOCK_UN);os.close(fd)
outcome=dict(id=recovery,original_case=ident,first_start_entered=True,completed=False,first_start_not_before=first_start_not_before,remaining_start_not_before=remaining_start_not_before,
general_before=general_before,
preserved_before_first_start=True,signed_sync_verified=False,full_job_accepted=False,
direct_product_state_writes=False,rmm_jobs=False,approvals=False,package_effects=False,reboot_requested=False,started=[])
try:
for name,key,uid in (('rmm-full-maintenance-helper.service','full',0),('rmm-agent-remote.service','agent',993)):
require(exact_general()==general_before,'General remains the same process; never start it again')
create(case/('finish-'+key+'-start-intent.json'),encode(dict(id=recovery,name=name,start_once=True,no_retry=True,
observed_at=dt.datetime.now(dt.timezone.utc).isoformat())))
run(['systemctl','start',name])
evidence=poll_started(name,uid)
create(case/('finish-'+key+'-started.json'),encode(evidence));outcome['started'].append(evidence)
require(exact_general()==general_before,'same original General after remaining starts')
require(svc('rmm-apt-helper.service')['ActiveState']=='inactive' and svc('rmm-apt-helper.service')['UnitFileState']=='disabled','APT remains closed')
require(Path('/proc/sys/kernel/random/boot_id').read_text().strip()==p['preflight']['boot_id'],'same final boot')
outcome['completed']=True
except Exception as e:outcome.update(error_class=type(e).__name__,frames=[dict(function=f.name,line=f.lineno) for f in traceback.extract_tb(e.__traceback__)])
create(result_path,encode(outcome));return outcome
def main():
parser=argparse.ArgumentParser(description=__doc__);parser.add_argument('mode',choices=('prepare-local','finish','read'));parser.add_argument('--case');args=parser.parse_args()
os.umask(0o077);STATE.mkdir(mode=0o700,parents=True,exist_ok=True);guards()
before=support.load(PREVIOUS/'intent.json')
def expected(case):return dict(id=case,runner_sha256=support.sha(__file__),prior_sha256=PRIOR_SHA,
original=before['original'],original_readback=before['original_readback'],first_continuation_readback=support.load(PREVIOUS_READBACK))
if args.mode=='prepare-local':
require(args.case is None,'new local-only remaining-start intent');case=str(uuid.uuid4());folder=STATE/case;folder.mkdir(mode=0o700)
support.save(folder/'intent.json',expected(case))
else:
case=str(uuid.UUID(args.case));require(case==args.case,'original canonical finish case');folder=STATE/case;intent=support.load(folder/'intent.json')
require(intent==expected(case),'complete original same-source JSON for every finish/read')
guards()
if args.mode=='finish':
support.save(folder/'finish-entered-local.json',dict(start_once=True,no_retry=True))
gate=old.rpc(old.server_prefix(),old.server_gate,intent['original'],folder);support.save(folder/'server-gate.json',gate)
guards();result=old.rpc(support.access_settings(old.pre.ACCESS_ROOT,'linux'),finish_vm,dict(intent,action='finish',fresh_server_gate=gate),folder)
support.save(folder/'finish-reply.json',result)
require(result['completed'] is True and result['preserved_before_first_start'] is True
and result['signed_sync_verified'] is False and result['full_job_accepted'] is False
and result['rmm_jobs'] is False and result['approvals'] is False,'finish incomplete; readback only')
else:
result=old.rpc(support.access_settings(old.pre.ACCESS_ROOT,'linux'),finish_vm,dict(intent,action='read'),folder)
support.save(folder/('readback-'+str(uuid.uuid4())+'.json'),result)
print(json.dumps(dict(case_id=case,mode=args.mode,intent=str(folder/'intent.json'),intent_sha256=support.sha(folder/'intent.json'),target_called=args.mode!='prepare-local',rmm_jobs=False,approvals=False)))
if __name__=='__main__':main()
+110
View File
@@ -0,0 +1,110 @@
# Tatsächliche Linux-Bereitstellung der Skriptkonsole
Stand 2026-11-14, Spezifikation 1.20. Ausschließlich die Cloud-Linux-Test-VM
wurde als Client verwendet. Der Entwicklungsrechner erhielt keinen RMM-Dienst.
Sämtliche Zielaufrufe führte der übergeordnete Entwickleragent nach unabhängiger
Quellprüfung aus. Diese Bootstrapnachweise ersetzen keine WebUI-Jobgenehmigung.
Der korrigierte Quellpack mit 158 unveränderten Eingaben ist Manifest
`ddd1a78d1cd289b02b1f98572f9652171ec00be84e01ce099fd722d689bcaacd`.
Auf der Cloud-VM bestanden tatsächlich 84 Units; fünf Datenbankfälle blieben
ausdrücklich ausgelassen. Dieselben fünf waren bereits im isolierten lokalen
PostgreSQL-Lauf mit allen 45 Servertests bestanden. Der native Beleg des Falls
`7b61ce46-7913-492b-9c6b-414a0c2b6ffc` hat SHA256
`a831a70a3cf76a3e8a9bf5820dcca7100d2ef9860dd9388539fe9c13f949f470`.
Kein RMM-Job, keine Genehmigung oder Produktzustandsänderung gehörte zum Unitlauf.
Der getrennte lesende Vorher-CAS band bestehende Boot-/Geräteidentität,
tatsächliche alte Prozessimages, General-/APT-Kontrollen und drei
Datenbankinodes. Für die Bereitstellung wurden sämtliche aktiven Leser des
gemeinsamen Root-Ledgers auf die neue decoderfähige Generation gebracht;
[Begründung und APT-Grenze](script-console-helper-generations.md) bleiben bindend.
## Originalinstallation und erhaltene Fehlerbelege
Der Originalfall `2e27c312-58cc-444d-92a6-863a11ac6ffd` verwendete
`deploy/script_console_install.py`, SHA256
`667b56f7e5f085db249f27a7094919c7c0e6055dabc9f0600cb261c34760cd26`.
Nach frischem geschlossenem Servergate wurden Agent und General angehalten,
die alten Dateien erhalten und die qualifizierten neuen Images eingesetzt.
Generalunit, Sandbox, Konfiguration und bestehende Pins blieben unverändert.
Fullkonfiguration, geschützter Binär-/Policypin, eigene Unit und Agentdropin
wurden additiv angelegt. Alle ursprünglichen SQL-Zeilen und Dateimetadaten
einschließlich PKI blieben vor dem Wiederstart erhalten; insbesondere drei
Datenbankinodes und die ursprünglichen 18 abgeschlossenen Rootverbräuche mit
Originalrequest-/Grant-/Start-/Outcomebytes. Es gab keinen Ledgerreset.
Die Installation hielt danach vor `restart-intent` an: Der ursprüngliche
Unitguard erwartete leere Filterwerte, tatsächlich lieferte systemd bei
`SystemCallFilter` und `RestrictAddressFamilies` jeweils `~`, also eine leere
Ausschlussliste. Die übrigen Fullunitwerte entsprachen der beabsichtigten vollen
Hostautorität. Der unmittelbare Readback zeigte alle drei Dienste inaktiv mit
PID 0. Der Originalbericht bleibt ein fehlgeschlagener Installationsbericht;
er wurde nach späterer Fortsetzung nicht als erfolgreicher Bericht überschrieben.
Die separate Fortsetzung `43dae370-6862-4cf4-a83c-0b2612af6c79` verwendete
`deploy/script_console_continue.py`, SHA256
`c0c0ecf1e1bcb2d2f9ce0bcf6973aa430e9e28ba86823ca5ad0954744a589238`.
Sie ließ ausschließlich die beiden exakten leeren Filterdarstellungen `''`
und `'~'` zu, prüfte alle bestehenden Kontrollen und SQL-/PKI-Zeugen frisch
und schrieb vor dem erstmaligen Start einen dauerhaften eigenen Startintent.
Der Generalstart wurde ausgeführt; seine sofortige Prozessprüfung verweigerte
jedoch die Fortsetzung. Full und Agent wurden noch nicht gestartet. Der
Bericht enthält deshalb `started:[]`; daraus folgt ausdrücklich nicht, dass
kein Startbefehl ausgeführt wurde. Ein zusätzlicher frischer Readback belegte
den tatsächlich laufenden richtigen Generalprozess. Eine Beobachtung vor
abgeschlossenem `exec` bei `Type=simple` ist eine plausible Erklärung, wurde
aber nicht als bewiesene Ursache ausgegeben.
## Einmalige verbleibende Starts und aktueller Beleg
Ein neuer getrennter Fall `66a537bb-e676-421e-80dc-f653b069738a` verwendete
`deploy/script_console_finish_start.py`, SHA256
`ebe6170d489689ad0ffaf23eeba60db7979dd243d386d3a5c33885212f5c086b`.
Er erhielt beide vorherigen Quellen, Intents, Berichte und Startmarker unverändert.
Der bereits laufende General wurde frisch an PID, Prozessgeburt, Image und
Konten gebunden und weder gestartet, gestoppt noch neu gestartet. Vor jedem
verbleibenden Full-/Agentstart wurde ein eigener dauerhafter Einmalintent
geschrieben. Prozessbeobachtung führte keinen weiteren Start aus.
Der Poll verwendet eine fünfsekündige Beobachtungsdeadline und verlangt zwei
übereinstimmende korrekte Prozessbeobachtungen; der erste positive PID-/Geburtsbezug
darf nicht wechseln. **Grenze:** Einzelne geerbte `systemctl`-Abfragen haben
weiterhin 25 Sekunden Timeout. Es gibt deshalb keine harte Zusage von fünf
Sekunden Gesamtzeit. Diese Grenze betrifft den Bootstrapbeobachter, nicht die
Laufzeit genehmigter Skriptjobs. Die bereits verwendete Quelle bleibt unverändert.
Tatsächliches Ergebnis: erfolgreiche verbleibende Starts und zusätzlicher
rein lesender Readback aller drei aktiven Dienste, gleicher Boot und korrekte
Konten/Images:
| Dienst | PID / Startticks | UID / GID |
| --- | --- | --- |
| General | `65562 / 7308498` unverändert | `0 / 984` |
| Full | `66122 / 7344457` | `0 / 984` |
| Agent | `66132 / 7344482` | `993 / 984` |
Helperimage SHA256
`79442727c3ba31cda02a8bc0e67481f14db9f39fc07520a880a90b64f10f1eaf`,
Agentimage
`0a7ad6eefaefda79ee80b6a41b2df904e9e7f50ae6ebeed01b98c25b6ce5c06f`.
Der tatsächliche Ergebnisbeleg liegt privat unter
`devstate/script-console-finish-start/66a537bb-e676-421e-80dc-f653b069738a/finish-reply.json`,
SHA256 `85c98d39d666ce05abc7c3747cd58978496fc059b1f833997ed4d6eff5229153`.
Der zusätzliche Readback hat SHA256
`5d94f79b29c7be6310fbbeec4178c0dadb849566506239b01b8db3d48c622316`.
Erster General-Startintent: `2026-11-14T16:44:24.389303+00:00`;
Intent für die verbleibenden Starts: `2026-11-14T16:50:23.921400+00:00`.
APT blieb disabled/inactive, ohne Agentendpoint und bereits zuvor nicht aktuell
qualifiziert. Keine Paketwirkung, kein Reboot, kein neuer Rootverbrauch und kein
RMM-Job oder Approval wurden durch diese Bootstrapquellen angefordert. Normale
Dienstaktivität nach dem Start ist separat zu attestieren; der Startbeleg setzt
deshalb `signed_sync_verified:false` und `full_job_accepted:false`.
**Noch offen:** Frischer signierter Abgleich mit kryptografisch geprüfter
Erhaltung der ursprünglichen Root-/Agenthistorie, aktuelle passive Meldung an
den festgelegten Server und danach der tatsächlich über die WebUI genehmigte
begrenzte FullMaintenance-Skriptauftrag. Dienststart, Unitprüfung und bestehende
Policy sind keine Jobgenehmigung. Fehlende oder unklare Ergebnisse dürfen weder
automatisch wiederholt noch durch Journal-/Datenbankänderungen repariert werden.
+7 -3
View File
@@ -1,9 +1,13 @@
# Gemeinsames Root-Ledger und Helpergenerationen
Entscheidung2026-11-14, Spezifikation1.20. Dieser Nachtrag erklärt eine im
Bootstrapreview gefundene Voraussetzung der neuen Skriptkonsole. Er behauptet
keinen bereits ausgeführten Runtimeaustausch und ändert keinen eingefrorenen
Compilerinput.
Bootstrapreview gefundene Voraussetzung der neuen Skriptkonsole. Dieser
Entscheidungstext ersetzt keinen Ausführungsbeleg und ändert keinen eingefrorenen
Compilerinput. Der inzwischen tatsächlich erhaltend ausgeführte Paarwechsel mit
unveränderten ursprünglichen Fehlerberichten und getrennten Erststartfortsetzungen
ist in den [Bootstrap-Ergebnissen](script-console-bootstrap-results.md) belegt.
Agent, General und Full laufen; signierter Folgeabgleich und WebUI-genehmigter
Fulljob sind dadurch noch nicht abgenommen.
`consumed` ist kein bloßer Pool opaker Hashes: `execution_evidence.start` enthält
den vollständigen Originalrequest mit exakten Jobbytes, Grantbytes und Signatur.