Table of Contents

Romexis Docker auf Synology NAS

HOST_IP
ROMEXIS_CONTAINER_DATADIR

4. Neues Projekt im Container Manager erstellen
5. Projekt starten
6. Romexis erreichen
7. Romexis Configuration öffnen
8. Romexis Client im Browser öffnen

3D-Unterstützung im Client-Container

9. Typische Fehlerquellen

Container Station Projekt lässt sich nicht starten
Romexis ist nicht erreichbar
Romexis Configuration ist nicht erreichbar
Romexis Client oder 3D-Darstellung funktioniert nicht
MSSQL startet langsam
MSSQL-Container prüfen

10. Nützliche Prüfungen per SSH
11. Kurzfassung
Zugangsdaten Romexis Configuration

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Romexis Docker auf Synology NAS

English

Demo: Im folgenden Video laufen Romexis Server und Romexis Client gleichzeitig auf der Synology NAS. Der vollständige Romexis Client wird im Container ausgeführt und über VNC/noVNC direkt im Webbrowser bedient. Das Demo wurde auf einer Synology DS-218+ mit 10 GB RAM und 2 × 4 TB HDD erstellt. Der Client-Container enthält außerdem die für Romexis benötigte 3D-Unterstützung über Java3D/JogAmp; im aktuellen Container erfolgt das OpenGL-Rendering softwarebasiert, sodass die 3D-Performance von der CPU-Leistung der NAS abhängt.

Diese Anleitung beschreibt die Einrichtung von Romexis im Docker-Container auf einer Synology NAS mit dem Synology Container Manager beziehungsweise dem älteren Synology-Docker-Paket.

Das Setup startet die folgenden Komponenten auf der NAS:

Romexis Server im Docker-Container
Microsoft SQL Server 2017 im Docker-Container
Romexis Client im Docker-Container mit Browserzugriff über VNC/noVNC und 3D-Unterstützung
Romexis Configuration über Webzugriff

Die Einrichtung erfolgt über die Synology-Oberfläche, insbesondere über File Station, den Synology Text Editor und den Container Manager.

Voraussetzungen

Benötigt wird:

eine Synology NAS mit Docker-Unterstützung
installierter Synology Container Manager oder das ältere Synology-Docker-Paket
Zugriff auf die File Station
Zugriff auf den Synology Text Editor
das bereitgestellte ZIP-Paket mit den Docker-Compose-Dateien und der Ordnerstruktur

Download-Link:

https://nextcloud.buchhorster.de/public.php/dav/files/8ByCodK2rL6FZQ7/synology-romexis-server-and-client.zip

Passwort:

Plandent2026!

1. Zielverzeichnis auf der NAS erstellen

Öffne auf der Synology die File Station.

Erstelle unterhalb von /volume1/docker ein neues Verzeichnis für das Romexis-Docker-Projekt.

Beispiel:

/volume1/docker/romexis

Dieses Verzeichnis wird später als Projektverzeichnis im Container Manager verwendet.

2. ZIP-Paket herunterladen und entpacken

Lade das bereitgestellte ZIP-Paket herunter:

https://nextcloud.buchhorster.de/public.php/dav/files/8ByCodK2rL6FZQ7/synology-romexis-server-and-client.zip

Speichere die ZIP-Datei über die File Station in dem zuvor erstellten Verzeichnis, zum Beispiel:

/volume1/docker/romexis

Entpacke die ZIP-Datei anschließend direkt in diesem Verzeichnis.

Nach dem Entpacken sollte das Verzeichnis unter anderem folgende Dateien enthalten:

docker-compose.yml
.env

sowie die benötigten Unterordner für die Romexis-Server-, Romexis-Client- und SQL-Server-Container.

3. `.env`-Datei anpassen

Öffne in der File Station die Datei:

/volume1/docker/romexis/.env

mit dem Synology Text Editor.

Passe mindestens diese beiden Werte an die verwendete NAS an:

HOST_IP=192.168.xxx.xxx
ROMEXIS_CONTAINER_DATADIR=/volume1/docker/romexis

HOST_IP

Hier muss die IP-Adresse der Synology NAS eingetragen werden.

Beispiel:

HOST_IP=192.168.100.50

ROMEXIS_CONTAINER_DATADIR

Hier muss der Pfad eingetragen werden, unter dem die Romexis-Docker-Dateien auf der NAS liegen.

Beispiel:

ROMEXIS_CONTAINER_DATADIR=/volume1/docker/romexis

Der Pfad muss zu dem Verzeichnis passen, in das die ZIP-Datei entpackt wurde.

Speichere die .env-Datei nach der Anpassung.

4. Neues Projekt im Container Manager erstellen

Öffne den Synology Container Manager.

Gehe in den Bereich:

Projekt

Erstelle ein neues Projekt.

Als Projektverzeichnis wählst du das zuvor erstellte Verzeichnis aus, zum Beispiel:

/volume1/docker/romexis

Der Container Manager erkennt die vorhandene docker-compose.yml.

Wenn die Synology fragt, ob die vorhandene Compose-Datei verwendet werden soll, bestätige dies mit:

Ja

Anschließend kann das Projekt erstellt werden.

5. Projekt starten

Nach dem Erstellen kann das Projekt im Container Manager gestartet werden.

Beim ersten Start dauert es etwas, bis alle Container vollständig initialisiert sind.

Besonders der MSSQL-Container benötigt beim ersten Start etwas Zeit, da Microsoft SQL Server 2017 zunächst seine Systemdatenbanken erstellt und initialisiert.

Während dieser Phase kann Romexis noch nicht sofort erreichbar sein.

Empfehlung:

Nach dem ersten Start mindestens 3 bis 5 Minuten warten.

6. Romexis erreichen

Nach erfolgreichem Start sollte Romexis über die IP-Adresse der Synology NAS als Server erreichbar sein.

Beispiel:

192.168.100.50

Die genaue Verwendung hängt vom jeweiligen Romexis-Client beziehungsweise von der vorhandenen Romexis-Umgebung ab.

Neben lokal installierten Romexis-Clients enthält das Paket auch einen Romexis-Client-Container, der direkt auf der NAS ausgeführt und über den Browser bedient werden kann. Dieser Zugriff wird in Abschnitt 8 beschrieben.

7. Romexis Configuration öffnen

Die Romexis Configuration ist im Browser erreichbar unter:

http://NAS-IP:6080

Beispiel:

http://192.168.100.50:6080

Das Passwort lautet:

promax

Wichtig: Die Adresse wird mit http:// aufgerufen, nicht mit https://.

8. Romexis Client im Browser öffnen

Das Paket enthält zusätzlich den Container romexis-client. Darin läuft der vollständige Romexis Client auf der NAS. Die grafische Sitzung wird über VNC bereitgestellt und über noVNC im Webbrowser angezeigt. Dadurch kann der Client verwendet werden, ohne Romexis auf dem Arbeitsplatzrechner lokal zu installieren.

Öffne im Browser die IP-Adresse der NAS zusammen mit dem für den Romexis-Client veröffentlichten noVNC-Port:

Der Romexis Client ist im Browser erreichbar unter:

http://NAS-IP:6081

Beispiel:

http://192.168.100.50:6081

Das Passwort lautet:

promax

Wichtig: Die Adresse wird mit http:// aufgerufen, nicht mit https://.

Der tatsächlich verwendete Port ergibt sich aus der mitgelieferten .env- beziehungsweise docker-compose.yml-Konfiguration. Wird der Port dort geändert, muss beim Browserzugriff entsprechend der geänderte Port verwendet werden.

3D-Unterstützung im Client-Container

Der Client-Container enthält die Linux-Unterstützung für Java3D, JOGL und GlueGen/JogAmp. Beim Image-Build wird die in der jeweiligen Romexis.jar enthaltene JogAmp-Version erkannt und es werden die dazu passenden nativen Linux-Bibliotheken für die Zielarchitektur eingebunden. Damit stehen auch die Romexis-Funktionen zur Verfügung, die auf der Java3D-/JogAmp-3D-Darstellung aufbauen.

Das OpenGL-Rendering des aktuellen Client-Containers ist softwarebasiert. Dadurch ist kein direkt an den Container durchgereichter Grafikadapter erforderlich; bei aufwendigen 3D-Darstellungen hängt die Geschwindigkeit jedoch stärker von der CPU-Leistung der NAS ab.

Das oben eingebettete Demo wurde vollständig auf einer Synology DS-218+ mit 10 GB RAM und 2 × 4 TB HDD aufgenommen. Dabei liefen sowohl der Romexis Server als auch der Romexis Client auf derselben NAS, während der Client über noVNC im Browser bedient wurde.

9. Typische Fehlerquellen

Container Station Projekt lässt sich nicht starten

Ordnerberechtigungen auf /volume1/docker/romexis prüfen ggf. - everybody Lesen und Schreiben

Romexis ist nicht erreichbar

Prüfe:

Ist das Projekt im Container Manager gestartet?
Laufen alle Container?
Wurde nach dem ersten Start lange genug gewartet?
Ist in der .env die richtige NAS-IP bei HOST_IP eingetragen?
Ist in der .env der richtige Pfad bei ROMEXIS_CONTAINER_DATADIR eingetragen?
Wurde die .env nach der Änderung gespeichert?
Wurde das Projekt nach Änderungen an der .env neu gestartet?

Romexis Configuration ist nicht erreichbar

Prüfe, ob die URL korrekt ist:

http://NAS-IP:6080

Beispiel:

http://192.168.100.50:6080

Außerdem prüfen:

läuft das Projekt im Container Manager?
läuft der Romexis-Configuration-Container?
wird Port 6080 nicht durch einen anderen Dienst blockiert?
wurde die richtige NAS-IP verwendet?

Romexis Client oder 3D-Darstellung funktioniert nicht

Prüfe:

läuft der Container romexis-client?
wird der für den Client konfigurierte noVNC-Port von der NAS veröffentlicht und nicht durch einen anderen Dienst blockiert?
wurde beim Aufbau des Client-Images eine JogAmp-Version erfolgreich erkannt?
wurden die passenden nativen JogAmp-Bibliotheken für die Architektur der NAS in das Image übernommen?
zeigt der Browser die noVNC-Oberfläche und lässt sich eine VNC-Verbindung zum Client aufbauen?

Bei softwarebasiertem OpenGL kann eine aufwendige 3D-Darstellung auf schwächerer NAS-Hardware deutlich langsamer sein als auf einem Arbeitsplatzrechner mit dedizierter GPU.

MSSQL startet langsam

Das ist beim ersten Start normal.

Der SQL Server 2017 Container erstellt zunächst seine Systemdatenbanken. Während dieser Initialisierung kann Romexis noch keine Verbindung zur Datenbank aufbauen.

MSSQL-Container prüfen

Über SSH auf der Synology kann der Container-Log geprüft werden:

docker logs --tail 300 romexis-mssql

Live-Log:

docker logs -f romexis-mssql

10. Nützliche Prüfungen per SSH

Containerstatus anzeigen:

docker ps

Logs des MSSQL-Containers anzeigen:

docker logs --tail 300 romexis-mssql

Logs des Romexis-Client-Containers anzeigen:

docker logs --tail 300 romexis-client

Logs live verfolgen:

docker logs -f romexis-mssql

SQL Server innerhalb des Containers testen:

docker exec -it romexis-mssql /opt/mssql-tools/bin/sqlcmd \
  -S 127.0.0.1,1433 \
  -U sa \
  -P 'YOUR_PASSWORD' \
  -Q "SELECT @@VERSION"

Hinweis: Bei SQL Server 2017 liegt sqlcmd normalerweise unter:

/opt/mssql-tools/bin/sqlcmd

11. Kurzfassung

1. ZIP-Paket herunterladen.
2. In der File Station /volume1/docker/romexis erstellen.
3. ZIP-Paket nach /volume1/docker/romexis kopieren.
4. ZIP-Paket dort entpacken.
5. .env mit dem Synology Text Editor öffnen.
6. HOST_IP an die IP-Adresse der NAS anpassen.
7. ROMEXIS_CONTAINER_DATADIR an den NAS-Pfad anpassen.
8. Container Manager öffnen.
9. Neues Projekt erstellen.
10. Als Zielverzeichnis /volume1/docker/romexis auswählen.
11. Vorhandene docker-compose.yml verwenden.
12. Projekt erstellen und starten.
13. Einige Minuten warten, bis MSSQL initialisiert ist.
14. Romexis über die NAS-IP verwenden.
15. Romexis Configuration über http://NAS-IP:6080 öffnen.
16. Optional den Romexis-Client-Container über den veröffentlichten noVNC-Port im Browser öffnen.
17. Für 3D-Funktionen den Client-Container verwenden; die passenden JogAmp-Native-Bibliotheken sind im Image enthalten.

Zugangsdaten Romexis Configuration

Adresse:

http://NAS-IP:6080

Passwort:

promax

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

Romexis Docker auf Synology NAS

Voraussetzungen

1. Zielverzeichnis auf der NAS erstellen

2. ZIP-Paket herunterladen und entpacken

3. .env-Datei anpassen

HOST_IP

ROMEXIS_CONTAINER_DATADIR

4. Neues Projekt im Container Manager erstellen

5. Projekt starten

6. Romexis erreichen

7. Romexis Configuration öffnen

8. Romexis Client im Browser öffnen

3D-Unterstützung im Client-Container

9. Typische Fehlerquellen

Container Station Projekt lässt sich nicht starten

Romexis ist nicht erreichbar

Romexis Configuration ist nicht erreichbar

Romexis Client oder 3D-Darstellung funktioniert nicht

MSSQL startet langsam

MSSQL-Container prüfen

10. Nützliche Prüfungen per SSH

11. Kurzfassung

Zugangsdaten Romexis Configuration

Romexis Docker Wiki

English

Getting Started

Runtime Services

Build System

Database

Migration

Development

Source Documents

Deutsch

Erste Schritte

Runtime-Dienste

Build-System

Datenbank

Migration

Entwicklung

Quelldokumente

3. `.env`-Datei anpassen