Table of Contents
Migrationsworkflow
Dieses Dokument beschreibt den vorgesehenen Workflow zur Migration einer vorhandenen Romexis-Installation in den Docker-basierten Romexis-Server-Stack.
┌──────────────────────────────┐ │ Existing Romexis Server │ └──────────────┬───────────────┘ │ │ Romexis Migration Client │ ▼ SFTP / REST API │ ▼ ┌──────────────────────────────┐ │ Romexis Migration Service │ │ │ │ • Migration Jobs │ │ • Upload Validation │ │ • Restore Workflow │ └──────────────┬───────────────┘ │ ▼ ┌──────────────────────────────┐ │ Romexis Docker Container │ │ SQL Server │ │ Images │ │ Ergodata │ └──────────────────────────────┘
Aktualisierter detaillierter Workflow
created
-> database_uploaded
-> database_restored
-> upload_complete
-> validated
-> restored
-> completed
Endzustände:
completed
cancelled
failed
Manueller Browser-Workflow
- Migrationsjob in der Web-UI erstellen.
- Datenbanksicherung im Browser hochladen.
- Der Dienst erstellt automatisch
manifest.json. - Datenbankwiederherstellung auslösen.
- Dateiverzeichnisse über SFTP hochladen.
- Abschluss des Uploads bestätigen.
- Upload validieren.
- Wiederherstellung ausführen.
- Migration abschließen und SFTP-Zugriff entfernen.
Windows-Client-Workflow
- Romexis-Installation erkennen.
- SQL-Server-Konfiguration erkennen.
- Datenverzeichnisse erkennen.
- Migrationsjob erstellen oder verwenden.
- Datenbanksicherung erstellen.
- Daten über rclone/SFTP hochladen.
- API-Endpunkte aufrufen, um den Migrationsworkflow voranzubringen.
- Logs und Wiederherstellungsstatus anzeigen.
Neustart nach der Wiederherstellung
Der Migrationsdienst und der Romexis-Container kommunizieren über:
/data/romexis_images/.romexis_restart_state
Der Migrationsdienst schreibt eine ausstehende Neustartanforderung. Der Romexis-Entrypoint stoppt und startet den Romexis-Prozess neu, schreibt den endgültigen Status und der Migrationsdienst entfernt die Zustandsdatei.
Phase 1: Vorbereitung auf dem Quellsystem
Das Quellsystem ist üblicherweise ein vorhandener Windows-basierter Romexis-Server.
Erforderliche Daten:
- SQL-Server-Datenbanksicherung (
.bak) - Romexis-Bildverzeichnis
- Romexis-Ergo-Datenverzeichnis
- optionales Cache-Verzeichnis
Das Cache-Verzeichnis kann normalerweise ausgelassen werden, da es neu erzeugt werden kann.
Phase 2: Migrationsjob erstellen
Ein Migrationsjob wird in der Web-UI erstellt.
Der Dienst erzeugt:
- Migrations-ID
- SFTP-Benutzername
- SFTP-Passwort
- Upload-Pfad
Phase 3: Daten hochladen
Empfohlene Werkzeuge:
- rclone über SFTP
- WinSCP
- FileZilla
- OpenSSH SFTP
Beispiel mit rclone:
rclone copy ./migration-data sftp:upload \
--transfers 8 \
--checkers 16 \
--progress
Phase 4: Upload validieren
Der Migrationsdienst validiert:
- Manifest ist vorhanden
- SQL-Sicherung ist vorhanden
- Bildverzeichnis ist vorhanden
- Ergo-Verzeichnis ist vorhanden
Spätere Versionen sollten ergänzen:
- Prüfsummenvalidierung
- Vergleich der Dateianzahl
- Validierung der erwarteten Größe
Phase 5: Wiederherstellung
Der Wiederherstellungsprozess führt aus oder koordiniert:
- Romexis-Server-Container stoppen
- SQL-Server-Datenbanksicherung wiederherstellen
- Datenverzeichnisse in die Ziel-Volumes kopieren
- Eigentümer und Berechtigungen korrigieren
- Romexis-Server-Container starten
- abschließende Validierung ausführen
Der aktuelle Workflow verwendet explizite Zustandsübergänge und hält die Neustartkoordination über die gemeinsame Zustandsdatei getrennt.
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