ELONIQ / ELONIQ Handbuch
Deutsch English Français
Übersicht / Komponenten / OmniSync

OmniSync

Dateisynchronisation via SFTP, FTP und SMB

OmniSync ist die integrierte Dateisynchronisation von ELONIQ. Sie synchronisiert Dateien zwischen lokalen Verzeichnissen und Remote-Systemen über SFTP, FTP oder SMB — zeitgesteuert oder manuell.

Übersicht

OmniSync synchronisiert Dateien zwischen dem lokalen System und Remote-Servern. Es unterstützt verschiedene Protokolle und Sync-Modi für unterschiedliche Szenarien.

Sync-Modi
ModusBeschreibungAnwendungsfall
DownloadNeue/aktualisierte Dateien vom Remote herunterladenRechnungseingang, Datenimport
UploadNeue/aktualisierte Dateien zum Remote hochladenBackup, Datenexport
BidirektionalIn beide Richtungen synchronisieren (neuere Datei gewinnt)Gemeinsame Projektordner
MirrorLokal exakt wie Remote machen (Remote ist autoritativ)Archiv-Spiegelung
Unterstützte Protokolle
  • SFTP — SSH File Transfer Protocol (empfohlen, verschlüsselt)
  • FTP — File Transfer Protocol (unverschlüsselt, nur für Legacy-Systeme)
  • SMB — Windows/Samba-Netzwerkfreigaben

Funktionen

  • Multi-Protokoll — SFTP (SSH-basiert), FTP und SMB (Windows-Freigaben) als Übertragungsprotokolle.
  • 4 Sync-Modi — Download, Upload, Bidirektional (neuere Datei gewinnt) und Mirror (Remote ist autoritativ).
  • Flexible Zeitplanung — Manuell, intervallbasiert (alle N Minuten) oder per Cron-Ausdruck.
  • Dry-Run — Testlauf ohne tatsächliche Änderungen zur Vorschau der Synchronisation.
  • Orphan-Cleanup — Lokale Dateien löschen, die auf dem Remote nicht mehr existieren (Mirror-Modus).
  • SSH-Key-Authentifizierung — Passwortlose Authentifizierung für SFTP via SSH-Key.
  • Aktionsprotokoll — Detailliertes Logging jeder Dateiaktion (Download, Upload, Löschen, Überspringen, Fehler).
  • Parallele Jobs — Mehrere unabhängige Sync-Jobs gleichzeitig ausführen.
  • Verbindungstest — Verbindung zum Remote-Server vor dem Produktiveinsatz testen.

Verwendung

  1. Komponente öffnen — Navigieren Sie zu Komponenten > OmniSync im AdminUI.
  2. Neuen Job erstellen — Klicken Sie auf "Job hinzufügen" und geben Sie Name, Protokoll und Sync-Modus ein.
  3. Verbindung konfigurieren — Host, Port, Benutzername und Passwort oder SSH-Key eintragen.
  4. Pfade festlegen — Lokales und Remote-Verzeichnis definieren.
  5. Verbindung testen — Testen Sie die Verbindung zum Remote-Server.
  6. Zeitplanung einrichten — Wählen Sie manuell, Intervall oder Cron-Ausdruck.
  7. Dry-Run testen — Aktivieren Sie den Dry-Run und führen Sie den Job einmal manuell aus, um die geplanten Aktionen zu überprüfen.
  8. Job aktivieren — Deaktivieren Sie den Dry-Run und aktivieren Sie den Job.

Best Practices

  • Dry-Run zuerst — Testen Sie jeden neuen Job im Dry-Run-Modus, bevor Sie ihn produktiv schalten.
  • SFTP bevorzugen — Verwenden Sie SFTP statt FTP für verschlüsselte Dateiübertragungen.
  • Orphan-Löschung vorsichtig einsetzendelete_orphans löscht lokale Dateien, die auf dem Remote nicht existieren. Nur im Mirror-Modus verwenden.
  • Sync-Intervalle anpassen — Große Verzeichnisse benötigen längere Intervalle. Beginnen Sie mit 60 Minuten und passen Sie bei Bedarf an.
  • Verbindung vorab testen — Nutzen Sie die Testverbindung-Funktion, bevor Sie einen Job aktivieren.
  • Key-basierte Authentifizierung — Verwenden Sie für SFTP nach Möglichkeit SSH-Keys statt Passwörter.

Beispiele

1. SFTP-Download (stündlich)
Name: Rechnungen-Download
Protokoll: sftp
Sync-Modus: download
Host: sftp.lieferant.de:22
Remote-Pfad: /outbox/invoices
Lokal-Pfad: C:\Import\Rechnungen
Ausführung: interval (60 Min)
2. SMB-Upload (täglich um 02:00)
Name: Backup-Upload
Protokoll: smb
Sync-Modus: upload
Host: nas.firma.local
Share: backup
Remote-Pfad: /eloniq
Lokal-Pfad: /data/export
Ausführung: scheduled
Cron: 0 2 * * *
3. Bidirektional (SFTP mit Key-Auth)
Name: Projektdaten-Sync
Protokoll: sftp
Sync-Modus: bidirectional
Host: dev.firma.de:22
Username: sync_user
Private Key: (SSH-Key einfügen)
Remote-Pfad: /shared/projects
Lokal-Pfad: /data/projects
Ausführung: interval (30 Min)
4. Mirror-Modus (exakte Kopie)
Name: Archiv-Mirror
Protokoll: sftp
Sync-Modus: mirror
Delete Orphans: true
Ausführung: scheduled
Cron: 0 3 * * 0  (sonntags 03:00)