numin für lokale Offline-Administration

numin ist das lokale Wartungswerkzeug für Betreiber einer selbst gehosteten Workspace-Installation. Nutzen Sie es, wenn der Server für eine unterstützte Pre-Start-, Datenbank- oder Recovery-Aufgabe nicht verfügbar sein muss. Nach der Prüfung kennen Sie den lokalen Schema- oder Projektionszustand und können eine freigegebene Änderung kontrolliert anwenden.

Nutzen Sie für einen laufenden Server und tenantgebundene API-Aufgaben stattdessen nucli. numin besitzt keinen Remote-Login, öffnet keinen Listener und ersetzt keine Serverberechtigung.

Voraussetzungen

Verwenden Sie numin nur in einer privilegierten Betriebsumgebung. Sie benötigen:

dieselbe numin-Version wie der zugehörige Workspace-Server,
Zugriff auf die verschlüsselte Serverkonfiguration und ihren Config-Key,
eine lokale Verbindung zur Workspace-PostgreSQL-Datenbank,
für Site-Vertragsupgrades zusätzlich Zugriff auf den Storage-Root,
eine aktuelle Sicherung und eine dokumentierte Freigabe vor Änderungen.

Geben Sie Config-Key, Datenbankpasswort und neue Administratorpasswörter nie in Logs, Tickets oder Befehlsargumenten aus.

Bereitstellung prüfen

Das Workspace-Server-Image enthält numin unter /bin/numin. Es gibt kein separates portables numin-Release-Archiv. Verwenden Sie das Binary aus demselben Server-Image oder das versionsgleiche Nix-Paket.

Prüfen Sie zuerst die Version:

bash

/bin/numin version

Im Containerbetrieb können Sie den Befehl im vorhandenen Server-Container ausführen:

bash

docker exec <workspace-container> /bin/numin version

Die angezeigte Version muss zur eingesetzten Serverversion passen.

Das richtige Werkzeug wählen

Situation	Vorgehen
Der Server läuft und Sie prüfen Benutzer, Mandant, Ressourcen oder Findings	Verwenden Sie `nucli`.
Der Server startet wegen eines lokalen Schema-Contract- oder Baseline-Befunds nicht	Prüfen Sie mit `numin schema`.
Sie gleichen Inventory-Ledger und Bestandsaggregate ab	Starten Sie `numin inventory reconcile` ohne `--apply`.
Sie aktualisieren den lokalen Source-Vertrag einer Site	Prüfen Sie zuerst `numin site upgrade-contract` ohne `--apply`.
Sie haben den initialen System-Admin-Zugang verloren	Verwenden Sie den expliziten stdin-Passwortreset.
Ein dokumentierter `numin`-Befehl deckt die Aufgabe nicht ab	Stoppen Sie. Erfinden Sie keinen direkten Datenbank-Repair.

Schema und Baseline prüfen

Übergeben Sie den Pfad zur verschlüsselten Serverkonfiguration mit --config:

bash

numin --config /data/nucleus.config.enc schema status --json
numin --config /data/nucleus.config.enc schema migrations status --json
numin --config /data/nucleus.config.enc schema drift --json

Die Befehle verändern keine Daten. Exit-Code 0 bestätigt einen erfolgreichen Zustand ohne Befund. Exit-Code 1 zeigt einen erfolgreich ermittelten Handlungsbedarf. Beheben Sie keinen Drift mit ad-hoc SQL.

Datenbanken unterhalb der unterstützten Mindest-Baseline müssen zuerst über den dokumentierten Zwischenstand aktualisiert werden. Aktuelle Binaries enthalten keine historischen Direkt-Upgrader für beliebig alte Datenbanken.

Inventory-Projektion abgleichen

Prüfen Sie zuerst alle Ledgergruppen und Bestandsaggregate:

bash

numin --config /data/nucleus.config.enc inventory reconcile --json

Grenzen Sie die Prüfung bei Bedarf ein:

bash

numin --config /data/nucleus.config.enc inventory reconcile \
  --tenant-id <tenant-uuid> \
  --warehouse-id <warehouse-uuid> \
  --variant-id <variant-uuid> \
  --json

Die Ausgabe unterscheidet fehlende, verwaiste und mengenabweichende Bestandsaggregate. numin verändert dabei keine Ledgerbuchung.

Wenden Sie den Projektions-Rebuild nur nach Prüfung und Freigabe an:

bash

numin --config /data/nucleus.config.enc inventory reconcile --apply --json

Die Aufgabe ist abgeschlossen, wenn ein anschließender Dry-Run keine Findings mehr meldet.

Site-Vertrag aktualisieren

Prüfen Sie den lokalen Source-Vertrag einer Site:

bash

numin --config /data/nucleus.config.enc site upgrade-contract \
  --site <site-uuid> \
  --target 2 \
  --json

Prüfen Sie Plan, Warnungen und Zielversion. Wenden Sie den Plan erst danach an:

bash

numin --config /data/nucleus.config.enc site upgrade-contract \
  --site <site-uuid> \
  --target 2 \
  --apply \
  --json

Die Aktualisierung ist abgeschlossen, wenn der erneute Dry-Run keine offenen Änderungen mehr zeigt. Verwenden Sie nucli weiterhin für normale Site-Inspektion, Dateien, Builds und Veröffentlichung.

Initiales System-Admin-Passwort zurücksetzen

Der Passwortreset ist eine unmittelbare Recovery-Aktion und besitzt keinen --apply-Schalter. Übergeben Sie das neue Passwort ausschließlich über stdin:

bash

read -rsp 'Neues Passwort: ' NEW_PASSWORD
printf '%s\n' "$NEW_PASSWORD" \
  | numin --config /data/nucleus.config.enc admin reset-password \
      --password-stdin \
      --email admin@system.nucleus
unset NEW_PASSWORD

numin setzt nur das initiale System-Admin-Credential zurück und widerruft zugehörige Sitzungen beziehungsweise Bootstrap-Freigaben. Die Ausgabe enthält das Passwort nicht. Melden Sie sich anschließend neu an und prüfen Sie den Zugang mit nucli whoami.

Exit-Codes auswerten

Exit-Code	Bedeutung
`0`	Der Befehl war erfolgreich; bei Prüfungen besteht kein offener Befund.
`1`	Die Prüfung war erfolgreich und hat Handlungsbedarf erkannt.
`2`	Aufruf, Konfiguration, Verbindung oder Ausführung ist fehlgeschlagen.

Behandeln Sie Exit-Code 1 nicht als Verbindungsfehler. Lesen Sie den strukturierten Befund und entscheiden Sie danach über den nächsten Schritt.

Nächste Schritte

Nutzen Sie nucli für autorisierte Remote-Diagnose und tenantgebundene Administration.
Planen Sie Serverupdates mit Updates und Rollback.
Prüfen und veröffentlichen Sie Sites über Sites und CMS.