Deutsch | English
Romexis Admin
Der Dienst romexis-admin bietet browserbasierten Zugriff auf Romexis Admin / RomexisConfig.
Er ist vom Romexis-Server-Container getrennt, damit der Serverprozess auf die Backend-Laufzeit konzentriert bleibt, während die administrative Konfiguration in einem eigenen grafischen Container erfolgt.
Laufzeitkomponenten
Der Admin-Container startet die grafische Laufzeitumgebung mit:
Xvfb
Openbox
xcompmgr
x11vnc
noVNC / websockify
Openbox und xcompmgr sind erforderlich, weil Romexis Admin Swing-/AWT-Dialoge mit Transparenz- und Transluzenzfunktionen verwendet.
Das Openbox-Kontextmenü des Root-Desktops ist im Startskript deaktiviert, weil es in der noVNC-Laufzeit nicht nützlich ist.
Gemeinsame GUI-Runtime
romexis-admin installiert den vollständigen Java-/X11-/noVNC-/Native-Stack nicht mehr selbst. Diese architekturspezifischen Abhängigkeiten werden durch romexis-gui-runtime:1-<arch> bereitgestellt, die ebenfalls von romexis-client verwendet wird.
Das finale Admin-Image ergänzt nur noch das versionsspezifische Admin-Payload, materialisiert die gemeinsamen Runtime-Artefakte im Admin-Verzeichnis und fügt die Admin-Start-/Testskripte hinzu. Admin und Client sind unabhängige finale Images; keines erbt vom jeweils anderen.
Zugriff
Admin-Oberfläche über noVNC öffnen:
http://localhost:6080/vnc.html?host=localhost&port=6080&autoconnect=true
Wenn ADMIN_NOVNC_PORT geändert wird, muss der Port entsprechend angepasst werden.
VNC-Lifecycle-Modus
Wenn aktiviert, wird RomexisConfig erst gestartet, wenn sich ein VNC-/noVNC-Client verbindet.
ADMIN_VNC_LIFECYCLE=true
Verhalten:
first VNC client connects -> start RomexisConfig
last VNC client disconnects -> stop RomexisConfig after a short grace period
Wenn der Benutzer RomexisConfig manuell schließt, während die VNC-Sitzung noch verbunden ist, wird es erst bei der nächsten VNC-Verbindungssitzung neu gestartet.
Wenn deaktiviert:
ADMIN_VNC_LIFECYCLE=false
RomexisConfig startet sofort mit dem Container.
Lokalisierter Startbildschirm
Im VNC-Lifecycle-Modus wird beim Start der VNC-Sitzung und während des Starts von RomexisConfig ein kleiner Startbildschirm angezeigt.
Die Sprache wird gesteuert über:
ADMIN_LANGUAGE=de
Unterstützte Werte:
de
en
Dieselbe Variable wird RomexisConfig als Startparameter language= übergeben.
Debug-xterm
Innerhalb der VNC-Sitzung kann ein Debug-xterm gestartet werden:
DEBUG_XTERM=true
Standard:
DEBUG_XTERM=false
Dies ist nützlich, um die Laufzeit-Displayumgebung zu untersuchen, ohne den Container-Entrypoint zu ändern.
Typische Compose-Einstellungen
ADMIN_NOVNC_PORT=6080
ADMIN_VNC_PORT=5900
ADMIN_VNC_PASSWORD=promax
ADMIN_RESOLUTION=1280x900x24
ADMIN_JAVA_OPTS=-Xms256m -Xmx1024m
ADMIN_LANGUAGE=de
DEBUG_XTERM=false
ADMIN_VNC_LIFECYCLE=true
ENABLE_PROPERTY_AGENT=true
PropertyAgent im Admin
Der Romexis PropertyAgent ist für den Admin-Container standardmäßig aktiviert:
ENABLE_PROPERTY_AGENT=true
Der Agent setzt den Linux-spezifischen Admin-Service-INI-Pfad und stellt den für
den zuverlässigen Betrieb unter Java 17 erforderlichen RomexisOptionPaneUI-
Null-Guard bereit. Der Guard verhindert eine Swing-Lifecycle-
NullPointerException, wenn ein PropertyChange-Event den Planmeca-Listener
erreicht, bevor m_MessageArea initialisiert wurde. Der serverspezifische
RxCr2-Ersatz bleibt in Admin über ROMEXIS_AGENT_RXCR2_PATCH=false deaktiviert.
Der Patch ist im Agenten standardmäßig aktiv. Nur für einen kontrollierten Vergleich kann er folgendermaßen deaktiviert werden:
ROMEXIS_AGENT_OPTIONPANE_PATCH=false
Protokolle und Debugging
Protokolle anzeigen:
docker compose logs -f romexis-admin
Eine Shell im Admin-Image öffnen:
docker compose run --rm --entrypoint /bin/bash romexis-admin
Wenn ein gestoppter Container untersucht werden muss:
docker cp romexis-admin:/opt/romexis/admin ./admin-debug
Wichtige Laufzeitabhängigkeiten
Das Admin-Image benötigt Pakete wie:
xvfb
openbox
xcompmgr
x11vnc
x11-utils
novnc
websockify
openjfx
libopenjfx-java
libopenjfx-jni
x11-utils stellt xmessage bereit, das für den Startbildschirm verwendet wird.
Romexis Docker Wiki
English
Getting Started
- Project Overview
- Architecture
- Quick Start
- Synology Quick Start
- Use with Docker + WSL in Windows
- Compose Runtime
- Configuration
- Container Images
Runtime Services
- Romexis Admin
- Romexis Client
- mRomexis Web App
- Runtime Layout
- Backup and Restore
- Troubleshooting
- Security
Build System
Database
Migration
Development
Source Documents
Deutsch
Erste Schritte
- Projektübersicht
- Architektur
- Schnellstart
- Synology Quick Start
- Nutzung mit Docker + WSL unter Windows
- Compose-Runtime
- Konfiguration
- Container-Images
Runtime-Dienste
- Romexis Admin
- Romexis Client
- mRomexis Web App
- Runtime-Layout
- Sicherung und Wiederherstellung
- Fehlerbehebung
- Sicherheit
Build-System
Datenbank
Migration
Entwicklung
Quelldokumente
Romexis Docker Project Wiki / Romexis-Docker-Projekt-Wiki
English Home · Deutsche Startseite · English source documents · Deutsche Quelldokumente · Security · Sicherheit
Internal operations and development wiki / Internes Betriebs- und Entwicklungswiki