Das eigene Relay aktualisieren, sichern und auf einen neuen Server umziehen

Worum es geht

Je nach Installationsweg aktualisiert sich ein eigenes Relay nicht von selbst, und seine Daten gehören in eine Sicherung. Diese Seite zeigt, wie Sie es je nach Installationsweg aktualisieren, wie die Sicherung in der Konsole funktioniert, wie Sie sie zurückspielen und was beim Umzug auf einen anderen Server wichtig ist.

Das brauchen Sie

• Ein eigenes Relay (B2) und ein Konsolenkonto als System-Administrator.
• Für Docker und Linux: Zugriff auf die Kommandozeile des Servers.

So geht's

Aktualisieren

In der Konsole: Einstellungen → Relay-Update → Auf Update prüfen, dann Update einspielen. Ob das Relay sich selbst aktualisiert, steht in Konfiguration → Selbstupdate und Spiegel → „Selbstupdate des Relays“. Bei Linux-Installationen, die Sie per Skript aktualisieren, lassen Sie das Selbstupdate aus.

Sichern

1. Einstellungen → Wartungsplan.
2. Unter Backup-Passphrase eine Passphrase setzen und Speichern. Ohne Passphrase sichert das Relay seine Schlüssel nicht mit.
3. Job hinzufügen → Sicherung (Datenbank + Bilder) wählen und einen Zeitplan festlegen. Jetzt ausführen testet den Job sofort.
4. Die Sicherungen stehen unter Vorhandene Backups. Zu jeder Datenbank-Sicherung gehört ein verschlüsseltes Archiv mit den Schlüsseln (….nachweise.zip.enc). Laden Sie beide herunter und legen Sie sie außerhalb des Servers ab.

Den Wert BD_KEYRING_KEY (bei Docker in der Datei .env) sichern Sie getrennt und sicher, zum Beispiel im Passwortmanager (B9).

Zurückspielen (gleicher Server)

1. Einstellungen → Wartungsplan → Vorhandene Backups → Zeile mit der Datenbank-Sicherung (….dump.gz) → Einspielen.
2. Im Dialog Datenbank einspielen? den Namen der Datenbank eintippen und Einspielen klicken.
3. Das Relay startet neu. Danach neu anmelden.

Auf einen neuen Server umziehen

1. Auf dem neuen Server das Relay auf demselben Weg installieren (B2), aber noch nicht starten bzw. gleich wieder anhalten.
2. Das Schlüssel-Archiv mit der Backup-Passphrase entschlüsseln und vor dem ersten Start in das Datenverzeichnis des Relays entpacken: openssl enc -d -aes-256-cbc -pbkdf2 -in <name>.nachweise.zip.enc -out nachweise.zip
3. War der Wert BD_KEYRING_KEY gesetzt, auf dem neuen Server denselben Wert setzen, bevor das Relay startet.
4. Relay starten, dann die Datenbank-Sicherung einspielen (wie oben).
5. Den Namen (DNS) auf den neuen Server zeigen lassen. Behalten die Geräte dieselbe Adresse, müssen Sie an ihnen nichts ändern. Bei einer neuen Adresse: C6.
6. Lizenz: Eine Lizenz gilt für eine Installation. Lassen Sie die Aktivierung bei browserdesk.de freigeben (info@browserdesk.de) und spielen Sie die Lizenzdatei auf dem neuen Server erneut ein (A5).

Daran sehen Sie, dass es geklappt hat

• Nach einem Update zeigt Relay-Status (oder /health) die neue Fassung.
• Nach dem Einspielen: „Datenbank eingespielt (… s). Der vorherige Stand liegt als … Der Relay startet neu — gleich neu anmelden.“
• Nach einem Umzug melden sich die Geräte am neuen Server an, und ihre Gerätezertifikate gelten weiter.

Gut zu wissen

• Laufende Sitzungen bei einem Update: Der Betrachter zeigt „Relay wird aktualisiert – Verbindung wird wiederhergestellt …“ und verbindet selbst neu. Eine direkte Sitzung läuft weiter.
• Einspielen setzt alles zurück: Geräte, Zugänge, Benutzer, Tickets, Einstellungen. Was danach kam, ist weg. Der Stand davor liegt als …-vor-einspielen.dump.gz in derselben Liste — so nehmen Sie es zurück.
• Alle Anmeldungen an der Konsole enden beim Einspielen.
• Ohne die Schlüssel sind auf einem neuen Server alle verschlüsselten Werte leer: neue Geräte-CA (alle Gerätezertifikate ungültig), Zugangsdaten für Mail und Anmeldung weg.
• Windows hüllt die Schlüssel an den Rechner (ohne BD_KEYRING_KEY). Ein Umzug auf einen anderen Rechner ist dann nicht möglich, ohne dass die verschlüsselten Werte verloren gehen; einen Weg zum Umhüllen gibt es noch nicht. Schreiben Sie vor einem solchen Umzug an info@browserdesk.de.
• Linux ohne BD_KEYRING_KEY legt die Schlüssel unverschlüsselt ab und warnt beim Start (B9).
• Docker: Die ganze Sicherung ist der Ordner data/ plus der Wert BD_KEYRING_KEY aus .env.
• Rückkehr zur alten Fassung bei Docker: RELAY_VERSION in .env zurückstellen und docker compose up -d, solange das alte Abbild noch geladen ist.

Wenn es nicht klappt