Zum Hauptinhalt springen

Übertragung von Benutzern zwischen FASTPANEL-Servern

Einführung​

Dieser Artikel beschreibt den Prozess der Übertragung von Benutzerkonten und den damit verbundenen Daten (Websites, Datenbanken, E-Mail usw.) von einem FASTPANEL-Server auf einen anderen mithilfe des integrierten Migrationswerkzeugs.

Wichtige Begriffe​

  • Quellserver - Der Server, von dem Daten übertragen werden.
  • Zielserver - Der Server, auf den Daten übertragen werden.

Wichtige Hinweise​

  • Standardmäßig funktioniert die Migration nur für Websites mit einer standardmäßigen FASTPANEL-Konfiguration korrekt.

  • Websites mit Änderungen an der manuellen Konfiguration können nur übertragen werden, wenn das Flag -m für die Zuordnung von IP-Adressen verwendet wird.

  • Wenn kein verschlüsseltes Passwort für einen Datenbankbesitzer verfügbar ist, wird die Datenbank nicht übertragen.

  • Wenn eine Website nicht übertragen wird, werden ihre zugehörigen Datenbanken ebenfalls nicht übertragen.

  • Es können nur lokale Datenbanken übertragen werden.

Migrationsprozess​

Verbindung​

Der Zielserver verbindet sich über SSH mit dem Quellserver. Bei der ersten Verbindung installiert der Zielserver einen SSH-Schlüssel auf dem Quellserver (entweder im Voraus bereitgestellt oder aus einem Passwort generiert).

Migrationsschritte​

  • Installation des Moduls
  • Erfassung von Informationen über übertragbare Objekte
  • Erstellen von Benutzern
  • Übertragung von SSL-Zertifikaten
  • Erstellen von Websites, FTP-Konten, E-Mail-Domains und E-Mail-Konten
  • Erstellen von Datenbanken und Datenbankbenutzern
  • Übertragung von Website- und E-Mail-Postfachdateien
  • Übertragung von Cronjobs

Die Dateiübertragung wird mit rsync ausgeführt. Datenbanken werden durch Erstellen eines Dumps über einen SSH-Tunnel übertragen.

Befehl zum Starten der Migration​

Der Befehl wird auf dem Zielserver als Benutzer mit Root-Rechten ausgeführt:

/usr/local/fastpanel2/fastpanel transfer run [SSH_PARAMETERS] [IP_PARAMETERS] [ADDITIONAL_OPTIONS]

Befehlszeilen-Flags​

SSH-Verbindung​

  • --remote_host="SOURCE_IP" - IP-Adresse des Quellservers.
  • --remote_port="SSH_PORT" - SSH-Port.
  • --remote_username="SSH_USER" - Benutzer (muss root sein).
  • --remote_password="USER_PASSWORD" - Passwort für den angegebenen SSH-Benutzer.
  • --ssh_key_path="PATH_TO_KEY" - Pfad zum privaten SSH-Schlüssel auf dem Zielserver für die Verbindung mit dem Quellserver. Wenn ein Schlüssel verwendet wird, wird das Passwort (--remote_password) nicht benötigt.

IP-Adressen​

Sie müssen nur eines der folgenden Flags verwenden, um die IP-Adressen der Websites während der Übertragung zu verwalten. Das Flag -m hat Priorität.

  • -i "IP_ADDRESS_ON_DESTINATION" - Weist allen übertragenen Websites auf dem Zielserver die angegebene IP-Adresse zu. Um mehrere IPs anzugeben (z. B. wenn es auf dem Quellserver mehrere gab), wiederholen Sie das Flag für jede Quell-IP, die übertragen werden muss.

  • -m "SOURCE_IP,DESTINATION_IP" - Empfohlene Methode. Erstellt eine direkte Zuordnung: Alle Websites, die auf dem Quellserver SOURCE_IP verwenden, verwenden auf dem Zielserver DESTINATION_IP. Dieses Flag kann für verschiedene IP-Paare mehrfach angegeben werden. Erforderlich für die Übertragung von Websites mit manuellen Konfigurationsbearbeitungen, da dadurch IP-Adressen in Listen-Direktiven korrekt ersetzt werden können.

Zusätzliche Einstellungen​

  • --users="USER_LIST" - Überträgt nur die angegebenen Benutzer (durch Kommas getrennt). Wenn nichts angegeben ist, werden alle Benutzer übertragen.
  • --disable_disk_quota - Deaktiviert die Übertragung von Festplattenkontingenten der Benutzer.
  • --with_user_data - Schließt das Kopieren des gesamten Inhalts der Home-Verzeichnisse der Benutzer ein (außer dem Unterverzeichnis logs/). Mit Vorsicht verwenden, da dies die Übertragungszeit und die Menge der übertragenen Daten erheblich erhöhen kann.
  • --only_data - Überträgt nur Daten (Website-Dateien, Mail-Dateien, Datenbank-Dumps). Nützlich, wenn die anfängliche Strukturmigration (Benutzer, Websites, DBs usw.) erfolgreich war, aber während der Phase des Kopierens von Dateien oder Dumps Fehler auftraten. Ermöglicht das erneute Ausführen nur des Teils zum Kopieren der Daten.
  • --transfer_timeout - Legt das Zeitlimit für den Vorgang fest (Standard ist 60 Minuten).

Beispielbefehl​

Übertragen Sie alle Benutzer vom Server 11.22.33.44 auf den aktuellen Server. Auf dem alten Server verwendeten die Websites die IPs 11.22.33.44 und 11.22.33.55; auf dem neuen Server sollten sie jeweils 99.88.77.66 und 99.88.77.67 verwenden. Verbindung über SSH mit einem Passwort.

/usr/local/fastpanel2/fastpanel transfer run \
--remote_host=11.22.33.44 \
--remote_username=root \
--remote_password=YourSourceRootPassword \
-m 11.22.33.44,99.88.77.66 \
-m 11.22.33.55,99.88.77.67

Mögliche Probleme und Fehlertypen​

Ein Fehler im Migrationsprotokoll weist nicht immer auf ein kritisches Problem hin, sondern kann auf den Grund hinweisen, warum ein bestimmtes Objekt nicht übertragen wurde.

  • Konflikte: Treten auf, wenn die Übertragung eines Objekts aufgrund der aktuellen Konfiguration des Zielservers unmöglich ist (z. B. wenn ein Benutzer oder eine Website mit demselben Namen bereits existiert) oder wenn die Konfiguration der Website auf dem Quellserver dem Panel unbekannt ist (z. B. aufgrund umfangreicher manueller Bearbeitungen).

  • Fehlendes gespeichertes Passwort: Wie bereits erwähnt, können MySQL-Datenbankbenutzer ohne ein in FASTPANEL auf dem Quellserver gespeichertes Passwort nicht übertragen werden.

  • Manuelle Einstellungen und IP-Adressen: Wenn eine Website auf dem Quellserver manuelle Bearbeitungen der Webserver-Konfiguration aufweist und das Flag -m während der Migration nicht verwendet wird, um ihre IP-Adresse zuzuordnen, wird eine solche Website nicht übertragen, weil das Panel nicht weiß, welche IP in der Konfiguration auf dem Zielserver angegeben werden soll.