Table of Contents

Konfiguration

MSSQL
Firebird

Microsoft-SQL-Server-Einstellungen
Firebird-Einstellungen
RMI-Ports
Romexis-Admin-Einstellungen
Einstellungen der mRomexis Web App
Einstellungen des Migrationsdienstes
Versionslimit der Datenbankinitialisierung
Property Agent

Konfiguration

Die Konfiguration erfolgt größtenteils über Umgebungsvariablen in .env und Docker Compose.

Kernvariablen

Variable	Beschreibung
`REGISTRY`	Namespace der Container-Registry
`ROMEXIS_VERSION`	Auszuführende Romexis-Version
`IMAGE_SUFFIX`	Optionales Branch-spezifisches Image-Suffix
`DATABASE_BACKEND`	Ausgewähltes Backend, normalerweise `mssql` oder `firebird`
`COMPOSE_FILE`	Compose-Dateikette auf Basis des ausgewählten Backends
`HOST_IP`	Host-IP-Adresse, die Romexis-Clients bereitgestellt wird
`ROMEXIS_DATA_ROOT`	Stammverzeichnis für persistente Romexis-Daten

Beispiel:

REGISTRY=gitea.buchhorster.de/planmeca
ROMEXIS_VERSION=6.5.3.444.203
IMAGE_SUFFIX=
DATABASE_BACKEND=mssql
COMPOSE_PATH_SEPARATOR=:
COMPOSE_FILE=docker-compose.yml:docker-compose.${DATABASE_BACKEND}.yml
HOST_IP=192.168.65.177
ROMEXIS_DATA_ROOT=/srv/romexis-data

Variablen für Image-Namen

ROMEXIS_IMAGE=romexis-server
MIGRATION_IMAGE=romexis-migration-service
ADMINISTRATION_IMAGE=romexis-admin
MROMEXIS_WEBAPP_IMAGE=romexis-mromexis-app

Diese werden durch die Compose-Dateien mit REGISTRY, ROMEXIS_VERSION und IMAGE_SUFFIX kombiniert.

Auswahl des Datenbank-Backends

Die Backend-Auswahl wird durch die Auswahl der Compose-Dateien gesteuert, nicht nur durch SERVER_DB.

MSSQL

DATABASE_BACKEND=mssql
COMPOSE_PATH_SEPARATOR=:
COMPOSE_FILE=docker-compose.yml:docker-compose.${DATABASE_BACKEND}.yml

Das MSSQL-Override setzt anschließend die Romexis-Backend-Werte, beispielsweise:

SERVER_DB=5
MSSQL_HOST=mssql

Firebird

DATABASE_BACKEND=firebird
COMPOSE_PATH_SEPARATOR=:
COMPOSE_FILE=docker-compose.yml:docker-compose.${DATABASE_BACKEND}.yml

Das Firebird-Override setzt anschließend die Romexis-Backend-Werte, beispielsweise:

SERVER_DB=4
FIREBIRD_HOST=firebird

Microsoft-SQL-Server-Einstellungen

MSSQL_PORT=1433
MSSQL_SA_PASSWORD=Pwr0mex!s!!!
MSSQL_PID=Express

ROMEXIS_DB_NAME=Romexis_db
ROMEXIS_DB_USER=romexis
ROMEXIS_DB_PASSWORD=romexis

Erzeugte JDBC-URL:

jdbc:sqlserver://mssql:1433;databaseName=Romexis_db;encrypt=true;trustServerCertificate=true;

Firebird-Einstellungen

FIREBIRD_PORT=3050
FIREBIRD_USER=sysdba
FIREBIRD_PASSWORD=pwr0mex!
FIREBIRD_DB_PATH=/firebird/data/romexis.fdb

Erzeugte JDBC-URL:

jdbc:firebirdsql://firebird:3050//firebird/data/romexis.fdb

Für die Romexis-Authentifizierung:

ROMEXIS_DB_USER=sysdba
ROMEXIS_DB_PASSWORD=pwr0mex!

RMI-Ports

SERVER_RMI_LOW_PORT=1100
SERVER_RMI_HIGH_PORT=1120

Diese Ports müssen für Romexis-Clients erreichbar sein.

Romexis-Admin-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

Wichtiges Verhalten:

ADMIN_LANGUAGE wird für den Startbildschirm und als Parameter language= für RomexisConfig verwendet.
DEBUG_XTERM=true startet ein optionales Debug-Terminal innerhalb der noVNC-Sitzung.
ADMIN_VNC_LIFECYCLE=true startet RomexisConfig bei der ersten VNC-/noVNC-Verbindung und beendet es nach dem Trennen der letzten Verbindung.
Der Admin-Container verwendet Openbox und xcompmgr als erforderliche Runtime-Komponenten.

Einstellungen der mRomexis Web App

MROMEXIS_WEB_PORT=8081

Der mRomexis-Web-App-Container wird über den Proxy-Dienst bereitgestellt. Das Backend-Proxy-Ziel wird intern auf den Romexis-Serverdienst umgeschrieben.

Einstellungen des Migrationsdienstes

MIGRATION_HTTP_PORT=8080
MIGRATION_SFTP_PORT=2222
MIGRATION_API_TOKEN=change-me
DATABASE_BACKUP_DIR=/srv/romexis-data/sql-backup

DATABASE_BACKUP_DIR wird für Datenbank-Wiederherstellungsworkflows gemeinsam vom Migrationsdienst und dem Datenbank-Backend verwendet.

Versionslimit der Datenbankinitialisierung

Der Datenbankinitialisierer leitet das Schema-Ziel ab aus:

/opt/romexis/version

Beispiel:

6.5.3.444.203 -> 653

Um die Initialisierung auf eine maximale Schema-Kennung zu begrenzen:

ROMEXIS_DB_MAX_VERSION=653

Ist die Romexis-Version des Containers neuer als das konfigurierte Maximum, gibt das Skript eine Warnung aus und initialisiert nur bis zur konfigurierten Kennung.

Property Agent

Der Java Property Agent kann Romexis-RxProperties über Umgebungsvariablen setzen.

Syntax:

PROPERTY_AGENT_SET_<RXPROPERTY_NAME>=<value>

Der Server verwendet den Agenten für Runtime-Properties und den RxCr2-Ersatz. Admin aktiviert ihn standardmäßig für die Service-INI-Integration und den Java-17-RomexisOptionPaneUI-Null-Guard. Der Client lädt denselben Agenten aus der GUI-Runtime, deaktiviert RxCr2 und aktiviert standardmäßig den OptionPane-Patch.

ROMEXIS_AGENT_RXCR2_PATCH=true
ROMEXIS_AGENT_OPTIONPANE_PATCH=true

Romexis Docker Wiki

English · Deutsch

English

Home

Getting Started

Runtime Services

Build System

Database

Migration

Development

Source Documents

Source README References

Deutsch

Startseite

Erste Schritte

Runtime-Dienste

Build-System

Datenbank

Migration

Entwicklung

Quelldokumente

README-Quellreferenzen

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