Schnelle Antworten auf häufige Fragen zu syncopio™.
Allgemein
Was ist syncopio?
Ein Enterprise-Tool für Datenmigrationen zwischen Storage-Systemen.
Web-UI, verteilte Worker und integrierte Verifizierung — damit du Millionen von Dateien zuverlässig zwischen NAS-Systemen verschieben kannst.
Welche Speicherprotokolle unterstützt syncopio?
NFS (v3/v4), SMB/CIFS und S3-kompatiblen Object Storage.
Cross-Protokoll-Transfers funktionieren out of the box — z. B. von NFS nach SMB oder von lokalem NFS zu S3-kompatiblem Cloud Storage.
Auf welchen Betriebssystemen läuft syncopio?
Worker laufen auf Linux und Docker. Der Controller läuft via Docker Compose.
Worker laufen auf allen gängigen Linux-Distributionen und als Docker-Container. Controller, Web-UI und Datenbank starten gemeinsam per Docker Compose — einfaches Setup.
So funktioniert's
Was ist der Controller?
Der zentrale Server — hostet Web-UI, APIs, Scheduler und die Task-Queue.
Er koordiniert alle Worker, speichert den State in PostgreSQL und pusht Live-Updates per Server-Sent Events an die Web-UI. Normalerweise läuft ein Controller pro Umgebung.
Was ist ein Worker?
Ein leichtgewichtiger Agent, der Storage mountet, Verzeichnisse scannt, Dateien überträgt und Checksums berechnet.
Worker laufen auf oder nah am Storage, der migriert wird. Sie holen sich Tasks vom Controller und melden Fortschritt in Echtzeit. Einen deployen oder Dutzende — je nach Throughput-Bedarf.
Welche Phasen hat eine Migration?
Vier Phasen: Discovery, Assessment, Transfer und Verifizierung.
Discovery scannt und katalogisiert Dateien. Assessment analysiert Risiken und Zusammensetzung. Transfer verschiebt die Daten. Verification bestätigt, dass alles intakt angekommen ist. Jede Phase läuft unabhängig und ist wiederholbar.
Was ist der Unterschied zwischen Mirror, Sync und Copy?
Mirror = exakte Kopie (löscht Überflüssiges). Sync = hinzufügen/aktualisieren (kein Löschen). Copy = alles übertragen.
Mirror für exakte Replikate, Sync für sichere inkrementelle Updates, Copy für einmalige Bulk-Transfers.
Performance
Wie verteilt syncopio die Arbeit?
Worker verteilen die Arbeit automatisch über die gesamte Flotte — idle Worker übernehmen Tasks von beschäftigten.
So bleiben alle Worker beschäftigt. Kein einzelner Bottleneck bremst die Migration — auch wenn Verzeichnisse stark unterschiedlich groß sind.
Wie geht syncopio mit Millionen kleiner Dateien um?
Adaptives Batching, effizienter Scan-Cache und parallele Verarbeitung halten den Throughput hoch.
Progress-Reports werden gebatcht, um Overhead zu minimieren. Die Task-Queue verteilt die Last über alle Worker und vermeidet Single-Thread-Bottlenecks.
Was ist der inkrementelle Scan-Cache?
Gecachte Scan-Ergebnisse, die wiederholte Scans um Größenordnungen beschleunigen.
Nur geänderte Daten werden neu gescannt. Alles andere kommt aus dem Cache.
Datenintegrität
Wie stellt syncopio sicher, dass keine Daten verloren gehen oder beschädigt werden?
Checksums während des Transfers + dedizierte Verify-Phase danach + detaillierte Reports.
Drei Verify-Level zur Auswahl (Quick, Standard, Deep) — je nachdem, wie gründlich du es brauchst.
Was sind die drei Verifizierungsmodi?
Quick (Metadaten-Vergleich), Standard (+ schnelle Checksums), Deep (+ kryptografische Checksums).
Alle Modi prüfen zusätzlich Permissions, Ownership (UID/GID) und Extended Attributes.
Welche Metadaten werden beim Transfer erhalten?
Timestamps, Ownership (UID/GID), POSIX Permissions, Extended Attributes, ACLs, Hardlinks und Symlinks.
Hardlinks werden beim Scan erkannt und am Ziel neu erstellt — erhält Dateibeziehungen und spart Speicherplatz. Symlinks bleiben erhalten, inklusive Zielvalidierung und Erkennung defekter Links.
Zuverlässigkeit
Was passiert, wenn ein Worker während des Transfers abstürzt?
Sein Task wird automatisch zurück in die Queue gestellt. Ein anderer Worker übernimmt. Kein Datenverlust, kein manuelles Eingreifen.
Jeder Task hat ein zeitlich begrenztes Lease. Erneuert der Worker es nicht mehr, läuft das Lease ab und der Task geht zurück in die Queue.
Kann ich eine fehlgeschlagene Migration fortsetzen?
Ja — abgeschlossene Tasks werden übersprungen, nur offene oder fehlgeschlagene werden neu verarbeitet.
Du musst nie von vorne anfangen, nur weil ein temporärer Fehler aufgetreten ist.
Was passiert, wenn der Controller ausfällt?
Worker pausieren, bis er wieder da ist, reconnecten automatisch und machen weiter.
Laufende Tasks sind durch den Lease-Mechanismus geschützt — sie gehen zurück in die Queue, wenn das Lease abläuft, während der Controller offline ist.
Erste Schritte
Was ist ein Endpoint?
Eine wiederverwendbare Storage-Verbindung — Protokoll, Adresse und Credentials für einen NFS-Server, eine SMB-Share oder einen S3-Bucket.
Einmal anlegen, in beliebig vielen Jobs wiederverwenden.
Was ist ein Dataset?
Ein bestimmter Verzeichnispfad auf einem Endpoint, z. B. /projects auf einem NFS-Server.
Jobs können mehrere Source-Target-Dataset-Paare enthalten, die jeweils unabhängig für Progress und Verification getrackt werden.
Kann ich wiederkehrende Migrationen planen?
Ja — eingebauter Cron-Scheduler. Kein externer Cron nötig.
Tägliche, wöchentliche oder Custom-Schedules einrichten. Der Status ist im Dashboard, in der Job-Liste und auf den Operations-Seiten sichtbar.
Sendet syncopio Benachrichtigungen?
Ja — E-Mail (SMTP) und ntfy-Push-Notifications für Scan-, Transfer-, Error- und Cutover-Events.
Empfänger und Event-Typen lassen sich pro Job konfigurieren. Errors werden standardmäßig immer gemeldet. Worker senden außerdem ntfy-Alerts bei Storage- und Health-Problemen.
Wie stelle ich syncopio bereit?
Deployment via Docker Compose. Controller, Web-UI, Worker und PostgreSQL starten zusammen.
Eine einzige docker-compose.yml startet den kompletten Stack. Worker können auch auf separaten Hosts mit demselben Docker-Image deployed werden.
Wie füge ich Remote-Worker hinzu?
Deploy einen Worker auf einem beliebigen Linux- oder Docker-Host. Zeige ihn per API-Key auf deine Controller-URL.
Der Worker registriert sich automatisch beim Controller und fängt an, Tasks zu übernehmen. Keine Änderung an der Controller-Config nötig.
Welche Exportformate sind verfügbar?
PDF, CSV und Excel. Plus ein interaktiver Report-Viewer in der Web-UI.
PDF für Stakeholder und Compliance, CSV für Spreadsheets, Excel für detaillierte Analysen.
Immer noch Copy & Pray?
Schau, was dir entgeht. Und was es dich kostet.