Clone
4
Runtime Layout
Patrick Gniza edited this page 2026-08-21 09:04:39 +02:00

Deutsch | English

Runtime Layout

Persistent Data

Recommended persistent root:

/srv/romexis-data

Typical directories:

/srv/romexis-data/sconfig
/srv/romexis-data/programdata
/srv/romexis-data/romexis_images
/srv/romexis-data/romexis_ergodata
/srv/romexis-data/romexis_cache
/srv/romexis-data/sql-backup
/srv/romexis-data/firebird

Runtime Services

romexis
  Main Romexis Server process.

mssql
  Microsoft SQL Server backend when DATABASE_BACKEND=mssql.

firebird
  Firebird backend when DATABASE_BACKEND=firebird.

romexis-admin
  Browser-accessible Romexis Admin / RomexisConfig runtime.

romexis-client
  Browser-accessible Romexis Client runtime.

romexis-app
  Tomcat-based mRomexis Web App.

proxy
  OpenResty/Nginx proxy for mRomexis Web App.

romexis-migration
  Migration service for upload, validation and restore workflows.

romexis-control-agent
  Restricted container-control service used for coordinated runtime operations.

Romexis Container Paths

/opt/romexis
/opt/romexis/server
/opt/romexis/sconfig
/programdata/planmeca/romexis

/data/romexis_images
/data/romexis_ergodata
/data/romexis_cache

Admin Container Paths

/opt/romexis/admin
/opt/romexis/client
/opt/romexis/sconfig
/programdata/Planmeca/Romexis/Admin
/tmp/romexis-admin-vnc-state

The Admin container provides browser access through noVNC and uses VNC state files to start or stop RomexisConfig based on active sessions.

Client Container Paths

/opt/romexis/client
/opt/romexis/sconfig
/programdata/Planmeca/Romexis
/tmp/romexis-client-vnc-state

The Client container uses the same shared GUI runtime as Admin, but receives its application files from the separate romexis-client-payload image.



mRomexis Web App Paths

/usr/local/tomcat/webapps/ROOT.war

The WAR originates from the Romexis payload:

/opt/romexis/broker/mromexis-html.war

Database Paths

MSSQL

/var/opt/mssql
/var/opt/mssql/backup

Firebird

/firebird/data/romexis.fdb

Restart State File

Used by migration restore coordination:

/data/romexis_images/.romexis_restart_state

Runtime Scripts

/entrypoint.sh
/opt/init-romexis-db.sh
/opt/init-romexis-mssql-db.sh
/opt/init-romexis-firebird-db.sh
/opt/fix-keystore-alias.sh

Admin startup script:

/usr/local/bin/start.sh