Migrationsworkflow

Diese Seite beschreibt den vorgesehenen Migrationsworkflow von einem vorhandenen Romexis-Server in den Docker-basierten Romexis-Stack.

Quellsystem

Das Quellsystem ist üblicherweise ein Windows-basierter Romexis-Server.

Erforderliche Daten:

SQL Server database backup (.bak)
Romexis image directory
Romexis ergo data directory
optional Romexis cache directory

Das Cache-Verzeichnis ist optional, da es normalerweise neu erzeugt werden kann.

Zielsystem

Auf dem Zielsystem laufen:

Romexis Server container
Database backend container
Migration Service container
Persistent data volumes

Workflow-Übersicht

Existing Romexis Server
        |
        | database backup
        | image data
        | ergo data
        v
Romexis Migration Service
        |
        | validation
        | database restore
        | data restore
        v
Docker-based Romexis Server

Manueller Workflow

Migrations-Web-UI öffnen.
Neuen Migrationsjob erstellen.
Datenbanksicherung im Browser hochladen.
Den Dienst manifest.json erstellen lassen.
Datenbankwiederherstellung auslösen.
Bilder und Ergo-Daten über SFTP hochladen.
Upload als abgeschlossen markieren.
Hochgeladene Daten validieren.
Wiederherstellung ausführen.
Migration abschließen.
SFTP-Zugangsdaten werden entfernt oder deaktiviert.

Client-gestützter Workflow

Der Migrationsclient soll die meisten Schritte auf der Quellseite automatisieren:

Romexis-Installation erkennen
Datenbankkonfiguration erkennen
Datenverzeichnisse erkennen
Migrationsjob erstellen oder verwenden
Datenbanksicherung erstellen
Daten über rclone/SFTP hochladen
API-Endpunkte aufrufen, um den Workflow voranzubringen
Logs und Wiederherstellungsstatus anzeigen

Erwartetes Upload-Layout

/upload/
├── meta/
│   └── manifest.json
├── database/
│   └── Romexis_db.bak
├── romexis_images/
├── romexis_ergodata/
└── romexis_cache/

Manifest

Das Manifest beschreibt die hochgeladenen Migrationsdaten.

Beispiel:

{
  "migration_id": "example",
  "name": "Example Migration",
  "source_host": "old-romexis-server",
  "database": {
    "backup": "database/Romexis_db.bak"
  },
  "romexis_images": true,
  "romexis_ergodata": true,
  "romexis_cache": false
}