Table of Contents
- Fehlersuche
- Wirksame Compose-Konfiguration untersuchen
- Falsches Datenbank-Backend startet
- Firebird-Modus startet weiterhin die MSSQL-Initialisierung
- MSSQL_SA_PASSWORD wird im Firebird-Modus benötigt
- Firebird zeigt die unixODBC-isql-Hilfe
- Admin-Container startet RomexisConfig nicht
- Admin-JavaFX- oder Transluzenzfehler
- Admin-Startbildschirm wird nicht angezeigt
- Build der mRomexis Web App schlägt wegen fehlender WAR-Datei fehl
- Backend-Aufrufe der mRomexis Web App schlagen fehl
- Build verwendet weiterhin alte Dateien
- Container zum Debuggen mit Bash starten
Deutsch | English
Fehlersuche
Wirksame Compose-Konfiguration untersuchen
Da das aktive Backend über .env ausgewählt wird, mit Folgendem beginnen:
docker compose config
Prüfen, ob das erwartete Backend-Override geladen wurde.
Falsches Datenbank-Backend startet
.env prüfen:
DATABASE_BACKEND=mssql
COMPOSE_FILE=docker-compose.yml:docker-compose.${DATABASE_BACKEND}.yml
oder:
DATABASE_BACKEND=firebird
COMPOSE_FILE=docker-compose.yml:docker-compose.${DATABASE_BACKEND}.yml
Anschließend die Umgebung des laufenden Containers untersuchen:
docker compose exec romexis env | grep -E 'SERVER_DB|ROMEXIS_DB|MSSQL|FIREBIRD'
Erwartete Backend-Kennungen:
SERVER_DB=5 # MSSQL
SERVER_DB=4 # Firebird
Firebird-Modus startet weiterhin die MSSQL-Initialisierung
Wenn SERVER_DB fehlt, kann der Entrypoint standardmäßig MSSQL verwenden.
Prüfen:
docker compose exec romexis env | grep SERVER_DB
Das Firebird-Compose-Override muss Folgendes setzen:
SERVER_DB=4
MSSQL_SA_PASSWORD wird im Firebird-Modus benötigt
Dies bedeutet, dass weiterhin das alte MSSQL-Initialisierungsskript ausgeführt wird oder alter Skriptinhalt im Image vorhanden ist.
Im Romexis-Container prüfen:
docker compose exec romexis cat /opt/init-romexis-db.sh
docker compose exec romexis ls -lah /opt/init-romexis-*
Neu bauen und erstellen:
docker buildx prune -a -f
./scripts/build-local.sh server
docker compose up -d --force-recreate
Firebird zeigt die unixODBC-isql-Hilfe
Wenn Folgendes erscheint:
unixODBC - isql and iusql
wird das falsche isql-Werkzeug verwendet.
Verwenden:
isql-fb
oder setzen:
export ISQL=isql-fb
Admin-Container startet RomexisConfig nicht
Protokolle prüfen:
docker compose logs -f romexis-admin
Wenn ADMIN_VNC_LIFECYCLE=true gesetzt ist, startet RomexisConfig erst, nachdem sich ein VNC-/noVNC-Client verbunden hat.
Öffnen:
http://localhost:6080/vnc.html?host=localhost&port=6080&autoconnect=true
Admin-JavaFX- oder Transluzenzfehler
Romexis Admin benötigt Openbox und xcompmgr.
Das Admin-Image sollte Folgendes enthalten:
openbox
xcompmgr
x11-utils
openjfx
libopenjfx-java
libopenjfx-jni
Fehler wie TRANSLUCENT translucency is not supported bedeuten üblicherweise, dass der Compositor fehlt oder nicht läuft.
Admin-Startbildschirm wird nicht angezeigt
Der Startbildschirm verwendet xmessage aus x11-utils.
Prüfen:
docker compose run --rm --entrypoint which romexis-admin xmessage
Build der mRomexis Web App schlägt wegen fehlender WAR-Datei fehl
mromexis-html.war existiert nur in Romexis 6.5.3 und neuer.
Payload prüfen:
docker run --rm --entrypoint find gitea.buchhorster.de/planmeca/romexis-payload:6.5.3.444.203 /opt/romexis -name 'mromexis-html.war'
Backend-Aufrufe der mRomexis Web App schlagen fehl
Proxy-Protokolle prüfen:
docker compose logs -f proxy
Erreichbarkeit des Romexis-Backends aus dem Proxy-Container prüfen:
docker compose exec proxy wget -O- http://romexis:8093/ || true
Build verwendet weiterhin alte Dateien
Lokalen Buildcache bereinigen:
docker buildx prune -a -f
Anschließend mit dem lokalen Skript neu bauen:
./scripts/build-local.sh all
Laufzeit-Stack neu erstellen:
docker compose up -d --force-recreate
Container zum Debuggen mit Bash starten
Romexis-Server:
docker compose exec romexis bash
Shell des Admin-Images:
docker compose run --rm --entrypoint /bin/bash romexis-admin
Shell des mRomexis-Web-App-Images:
docker compose run --rm --entrypoint /bin/bash romexis-app
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