Généralités sur la migration

Le serveur Zéphir prend en compte la migration des serveurs enregistrés lors du passage à une nouvelle version de la distribution (suivant les cas supportés). Le but est de conserver l'identifiant du serveur en mettant à jour les informations sur la machine et en changeant le nom du module. Il propose également des fonctions permettant de préparer les configurations des serveurs à migrer lorsque cela est nécessaire.

Remarque

La migration des données applicatives des serveurs enregistrés n'est pas gérée par le serveur Zéphir. La migration réelle du serveur est gérée par des scripts spécifiques à chaque module (si disponible) :

  • Upgrade-Auto et Maj-Release (dans le cas où le serveur peut être mis à niveau par mise à jour) ;
  • Scripts spécifiques de sauvegarde / restauration si une réinstallation est nécessaire (ex : migration2X.sh).

Une documentation spécifique est mise à disposition pour ces procédures lorsqu'elles deviennent disponibles.

Certaines données connues du serveur Zéphir (fichiers divers : voir le chapitre suivant pour les différents cas gérés) peuvent être récupérées automatiquement. Par contre, les modifications effectuées sur les serveurs (patchs, dictionnaires locaux, ...) doivent être mises à jour manuellement (en re-créant des variantes équivalentes pour la nouvelle version des modules).

La migration d'un serveur dans l'application Zéphir est effectuée lors de l'enregistrement d'un serveur réinstallé avec la nouvelle version sur son ancien identifiant ou en fin de procédure Upgrade-Auto (ou Maj-Release).

Lorsqu'un serveur est ré-enregistré, les clés de connexion de l'ancien serveur sont invalidées et les anciennes données sont sauvegardées dans un répertoire de sauvegarde (si nécessaire, éteindre l'ancien serveur pour éviter qu'il remonte des journaux systèmes d'échec de surveillance).

Truc & astuce

Dans le cas d'une migration nécessitant une préparation de configuration (voir chapitre suivant), il est possible de revenir dans la configuration d'origine pour remettre l'ancien serveur en service.

RemarqueRetour en arrière après migration

Dans la page de description du serveur dans l'application web Zéphir, un bouton retour en version XXX permet de remettre en place les données du module dans sa version précédente.

Cette manipulation entraîne la perte des modifications effectuées depuis le passage sur la nouvelle version (données éditées sur Zéphir, ou remontées sur Zéphir par le serveur). Il faut recommencer la procédure d'enregistrement pour migrer à nouveau le serveur.

Migration du serveur Zéphir

Le serveur Zéphir est le premier serveur à faire migrer lorsqu'une nouvelle version de la distribution est disponible.

Zéphir gère les serveurs dont la version est inférieure ou égale à sa propre version.

Attention

  • Les modules Zéphir 2.6 et 2.7 gèrent uniquement les modules de version supérieure ou égale à 2.4 et non supérieur à eux même, (zephir 2.7 ne gère pas les modules en 2.8 et 2.9)
  • Les modules Zéphir 2.8 et 2.9 gèrent uniquement les modules de version supérieure ou égale à 2.6.0 et non supérieur à eux même, (zephir 2.8 ne gère pas les modules en 2.9)

Si la base de l'ancien serveur est importée dans la nouvelle version de Zéphir, tous les serveurs de version non gérée seront supprimés.

  • Depuis Zéphir 2.6/2.7 vers Zéphir 2.8.n : Vérifier que le serveur est bien à jour en version stable, puis :

    • Exécuter le script sauvegarde.sh et mettre de côté l'archive générée ;
    • Installer la version voulue de Zéphir et effectuer une mise à jour stable (de préférence, conserver l'ancienne machine temporairement en cas de soucis) ;
    • Mettre en place l'archive créée précédemment dans /var/lib/zephir_backups/ sur le nouveau serveur
    • Pour exécuter la restauration sur une nouvelle machine non instanciée il faut préciser le chemin absolu de la commande /usr/share/eole/restauration.sh (en effet les PATHS ne sont pas encore renseignés).
    • Éditer et sauvegarder la configuration avec gen_config et lancer instance (répondre non lorsqu'il est demandé de recréer les données).

  • Depuis Zéphir 2.7.2 vers Zéphir 2.8 :

    • Utiliser le script Upgrade-Auto pour effectuer la mise à niveau du serveur (La configuration de Zéphir sera adaptée automatiquement si besoin) ;
    • reconfigurer le serveur.

  • Depuis Zéphir 2.8.n vers Zéphir 2.8.n+x :

    • Utiliser le script Maj-Release pour effectuer la mise à niveau du serveur (La configuration de Zéphir sera adaptée automatiquement si besoin) ;
    • reconfigurer le serveur.

Migration des serveurs enregistrés auprès de Zéphir

Depuis EOLE 2.5, les variantes sont copiées automatiquement entre 2 versions successives (voir chapitre suivant) et les configurations des serveurs sont adaptées automatiquement lors de la mise à niveau.