Aller au contenu principal

Transfert d’utilisateurs entre les serveurs FASTPANEL

Introduction​

Cet article décrit le processus de transfert des comptes utilisateurs et de leurs données associées (sites web, bases de données, e-mail, etc.) d’un serveur FASTPANEL à un autre à l’aide de l’utilitaire de migration intégré.

Termes clés​

  • Serveur source - Le serveur depuis lequel les données sont transférées.
  • Serveur de destination - Le serveur vers lequel les données sont transférées.

Remarques importantes​

  • Par défaut, la migration fonctionne correctement uniquement pour les sites avec une configuration FASTPANEL standard.

  • Les sites avec des modifications de configuration manuelle ne peuvent être transférés que si l’indicateur -m est utilisé pour le mappage des adresses IP.

  • Si un mot de passe chiffré pour le propriétaire d’une base de données n’est pas disponible, la base de données ne sera pas transférée.

  • Si un site web n’est pas transféré, ses bases de données associées ne seront pas transférées non plus.

  • Seules les bases de données locales peuvent être transférées.

Processus de migration​

Connexion​

Le serveur de destination se connecte au serveur source via SSH. Lors de la première connexion, le serveur de destination installe une clé SSH sur le serveur source (soit fournie à l’avance, soit générée à partir d’un mot de passe).

Étapes de la migration​

  • Installation des modules
  • Collecte d’informations sur les objets transférables
  • Création des utilisateurs
  • Transfert des certificats SSL
  • Création des sites web, des comptes FTP, des domaines de messagerie et des comptes de messagerie
  • Création des bases de données et des utilisateurs de bases de données
  • Transfert des fichiers de site web et des fichiers des boîtes mail
  • Transfert des tâches cron

Le transfert de fichiers est exécuté à l’aide de rsync. Les bases de données sont transférées en créant un dump via un tunnel SSH.

Commande pour démarrer la migration​

La commande est exécutée sur le serveur de destination en tant qu’utilisateur disposant des privilèges root :

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

Indicateurs de ligne de commande​

Connexion SSH​

  • --remote_host="SOURCE_IP" - Adresse IP du serveur source.
  • --remote_port="SSH_PORT" - Port SSH.
  • --remote_username="SSH_USER" - Utilisateur (doit être root).
  • --remote_password="USER_PASSWORD" - Mot de passe pour l’utilisateur SSH spécifié.
  • --ssh_key_path="PATH_TO_KEY" - Chemin vers la clé SSH privée sur le serveur de destination pour se connecter au serveur source. Si une clé est utilisée, le mot de passe (--remote_password) n’est pas nécessaire.

Adresses IP​

Vous devez utiliser un seul des indicateurs suivants pour gérer les adresses IP des sites pendant le transfert. L’indicateur -m est prioritaire.

  • -i "IP_ADDRESS_ON_DESTINATION" - Assigne l’adresse IP spécifiée à tous les sites transférés sur le serveur de destination. Pour spécifier plusieurs adresses IP (par exemple, s’il y en avait plusieurs sur la source), répétez l’indicateur pour chaque IP source qui doit être transférée.

  • -m "SOURCE_IP,DESTINATION_IP" - Méthode recommandée. Établit un mappage direct : tous les sites utilisant SOURCE_IP sur le serveur source utiliseront DESTINATION_IP sur le serveur de destination. Cet indicateur peut être spécifié plusieurs fois pour différentes paires d’IP. Obligatoire pour transférer les sites avec des modifications manuelles de configuration, car il permet de remplacer correctement les adresses IP dans les directives listen.

Paramètres supplémentaires​

  • --users="USER_LIST" - Transfère uniquement les utilisateurs spécifiés (séparés par des virgules). S’il n’est pas spécifié, tous les utilisateurs sont transférés.
  • --disable_disk_quota - Désactive le transfert des quotas de disque des utilisateurs.
  • --with_user_data - Inclut la copie de l’intégralité du contenu des répertoires personnels des utilisateurs (à l’exception du sous-répertoire logs/). À utiliser avec précaution, car cela peut augmenter considérablement le temps de transfert et la quantité de données transférées.
  • --only_data - Transfère uniquement les données (fichiers de site web, fichiers de messagerie, dumps de bases de données). Utile si la migration initiale de la structure (utilisateurs, sites, BDD, etc.) a réussi, mais que des erreurs se sont produites lors de l’étape de copie des fichiers ou des dumps. Permet de relancer uniquement la partie copie des données.
  • --transfer_timeout - Définit le délai d’expiration de l’opération (60 minutes par défaut).

Exemple de commande​

Transférez tous les utilisateurs du serveur 11.22.33.44 vers le serveur actuel. Sur l’ancien serveur, les sites utilisaient les IP 11.22.33.44 et 11.22.33.55 ; sur le nouveau serveur, ils doivent utiliser respectivement 99.88.77.66 et 99.88.77.67. Connexion via SSH avec un mot de passe.

/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

Problèmes possibles et types d’erreurs​

Une erreur dans le journal de migration n’indique pas toujours un problème critique, mais peut signaler la raison pour laquelle un objet spécifique n’a pas été transféré.

  • Conflits : surviennent lorsqu’il est impossible de transférer un objet en raison de la configuration actuelle du serveur de destination (par exemple, un utilisateur ou un site du même nom existe déjà) ou si la configuration du site sur le serveur source est inconnue du panneau (par exemple, en raison de modifications manuelles importantes).

  • Mot de passe enregistré manquant : Comme mentionné précédemment, les utilisateurs de bases de données MySQL sans mot de passe enregistré dans FASTPANEL sur le serveur source ne peuvent pas être transférés.

  • Paramètres manuels et adresses IP : Si un site sur le serveur source comporte des modifications manuelles de la configuration du serveur web et que l’indicateur -m n’est pas utilisé pendant la migration pour mapper son adresse IP, un tel site ne sera pas transféré, car le panneau ne sait pas quelle adresse IP spécifier dans la configuration sur le serveur de destination.