Installation & Einrichtung

Vollständige Schritt-für-Schritt-Anleitung zur Installation des Server Sync Plugins und Grundkonfiguration.

Voraussetzungen

Pelican Panel mit Plugin-Unterstützung installiert und aktiv
PHP 8.2 oder neuer auf dem Panel-Server
Datenbankbenutzer mit CREATE TABLE-Berechtigung
storage/ und bootstrap/cache/ beschreibbar (Berechtigungen 0755, Eigentümer: Webserver-Benutzer)

Schritt 1: Plugin installieren

Lade die neueste Version von den GitHub Releases herunter
Entpacke die ZIP-Datei nach:
```
/var/www/pelican/plugins/server-sync/
```

Überprüfe die Verzeichnisstruktur:

plugins/server-sync/
├── src/
├── config/
├── database/
├── lang/
├── resources/
├── plugin.json
└── composer.json

Leere den Anwendungscache:

php artisan cache:clear
php artisan config:clear
php artisan view:clear

Überprüfe, ob das Plugin unter Admin Panel → Plugins als „Server Sync" erscheint

Die Migration (2026_03_13_100000_create_server_sync_tables.php) wird automatisch ausgeführt und erstellt die benötigten Datenbanktabellen.

Schritt 2: Plugin-Einstellungen konfigurieren

Navigiere zu Admin → Plugin Settings → Server Sync und konfiguriere die globalen Einstellungen:

Einstellung	Standard	Beschreibung
Enforce Same Egg	An	Nur Server mit identischem Egg können gepaart werden
Max Pairs Per Server	3	Maximale Sync-Paare pro Server (global)
Default Interval	60 Min.	Standard-Sync-Intervall für neue Paare
Minimum Interval	1 Min.	Minimal erlaubtes Sync-Intervall
Max Archive Size	5120 MB	Maximale Archivgröße (bei Überschreitung: Batch-Splitting)
Concurrent Sync Limit	3	Maximale gleichzeitig laufende Syncs
Log Retention	30 Tage	Aufbewahrungsdauer der Sync-Protokolle

Schritt 3: Server-Limit setzen

Für jeden Server, der synchronisiert werden soll:

Gehe zu Admin → Server → Server bearbeiten
Navigiere zum Tab Server Sync
Setze das Server Sync Limit (z.B. 3)
Speichere

Wichtig: Ein Limit von 0 deaktiviert Server Sync für diesen Server komplett — die Seite ist nicht sichtbar und Berechtigungen werden nicht angezeigt.

Schritt 4: Erstes Sync-Paar erstellen

Im Admin-Panel:

Navigiere zu Admin → Server Sync
Klicke auf Create Pair
Wähle Main-Server und Sub-Server
Konfiguriere Richtung, Umfang, Sync-Modus und Intervall
Optional: Nutze den File Browser um Exclude-Pfade zu setzen
Klicke auf Create

Im Server-Panel:

Öffne den Server und navigiere zum Tab Server Sync
Klicke auf Create Pair
Wähle einen Partner-Server aus (nur berechtigte Server werden angezeigt)
Konfiguriere die Sync-Einstellungen
Klicke auf Create

Fehlerbehebung

Problem	Lösung
Plugin nicht sichtbar	Cache leeren: `php artisan cache:clear`
Migration fehlgeschlagen	Datenbankberechtigungen prüfen (CREATE TABLE erforderlich)
Server Sync Tab fehlt	Server Sync Limit > 0 setzen
Sync schlägt fehl	Node-Erreichbarkeit prüfen (Wings Daemon muss auf beiden Servern laufen)
„Server offline" Fehler	Server muss installiert sein (`installed_at` darf nicht NULL sein)