Aller au contenu principal

Migration de la version 11.x à la version 12.x

Cette page est destinée à vous aider à migrer une instance de YunoHost 11.x (fonctionnant sous Debian Bullseye) vers YunoHost 12 (fonctionnant sous Debian Bookworm).

Notes importantes​

  • L'équipe YunoHost a fait tout son possible pour que la migration se déroule dans les meilleures conditions possibles et l'a testée pendant plusieurs mois dans différents cas de figure.

  • Faites des sauvegardes de votre serveur et de vos données ! Cette migration est une opération complexe et éviter tous les problèmes possibles est difficile. Dans tous les cas, soyez patients et attentifs durant la migration.

  • Ne vous précipitez pas en pensant que vous devriez réinstaller votre système à partir de zéro, croyant que ce serait "plus simple" (soupir). (Une attitude courante consiste à vouloir réinstaller un serveur à la moindre complication ...). Au contraire, si vous rencontrez des problèmes, nous vous encourageons à essayer de comprendre ce qui se passe et à demander de l'aide sur le chat et le forum.

  • Vous devriez consulter les problèmes connus au bas de cette page, afin de vous assurer que vos migrations fonctionneront correctement.

Procédure de migration​

Vous devez d'abord vous assurer que votre système est à jour. La migration est disponible à partir de la version 11.3.

Il est recommandé d'exécuter la migration à partir de la ligne de commande, mais cela peut également être fait à partir de l'interface d'administration web.

Depuis la webadmin​

Allez dans Outils > Migrations pour accéder à l'interface de migration. Vous devrez lire attentivement et accepter la clause de non-responsabilité, puis lancer la migration.

Notez que même si vous fermez la page webadmin pour une raison quelconque, la migration se poursuivra en arrière-plan (mais la webadmin sera partiellement indisponible).

Depuis la ligne de commande​

Exécuter :

sudo yunohost tools migrations run

puis lisez attentivement et acceptez la clause de non-responsabilité.

Pendant la migration​

En fonction de votre matériel, des applications et autres paquets installés, la migration peut prendre jusqu'à une ou deux heures.

Les journaux (logs) seront affichés dans la fenêtre modale de l'administration Web au milieu de la page. Ils pourront également être consultés après la migration, comme toute autre opération importante, sous Outils > Journaux.

Si la migration échoue à un moment donné​

Si la migration échoue, la première chose à essayer est de la relancer. Si cela ne fonctionne toujours pas, vous devez demander de l'aide à la communauté (veuillez fournir le message d'erreur, les journaux complets et tous les éléments contextuels susceptiblent d'aider à déboguer le problème).

Après la migration​

Vérifiez que vous êtes bien sous Debian Bookworm et YunoHost 12.x​

Allez dans Diagnostic (catégorie Système de base) ou regardez en bas à droite de l'interface d'administration web pour vérifier la version de YunoHost.

À partir de la ligne de commande, vous pouvez utiliser lsb_release -a et yunohost --version.

Exécutez les nouvelles migrations en attente​

D'autres migrations sont apparues après la mise à niveau :

  • Reconstruction des virtualenvs de vos applications Python
  • Migration de PostgreSQL 13 vers 15

Vous devriez les exécuter dès que possible pour vous assurer que vos applications fonctionnent correctement.

Accepter les nouvelles conditions d'utilisation via la ligne de commande​

YunoHost 12.x exige désormais que vous acceptiez les nouvelles Conditions d'utilisation. Après les avoir lues et acceptées, vous pouvez démarrer la migration :

yunohost tools migrations run 0031_terms_of_services --accept-disclaimer

Vérifiez le diagnostic​

Dans la section Diagnostic de l'interface d'administration Web, assurez-vous qu'aucun problème spécifique n'est apparu après l'exécution de la migration (par exemple, un service qui s'est arrêté pour une raison quelconque).

Vérifiez que vos applications fonctionnent correctement​

Vérifiez que vos applications fonctionnent correctement. Si ce n'est pas le cas, essayez de les mettre à jour (il est également recommandé de les mettre à jour même si elles fonctionnent correctement).

Si votre application ne fonctionne plus et que vous disposiez déjà de la dernière version, vous pouvez relancer la mise à niveau grâce à l'option -F|--force :

yunohost app upgrade --force APP_NAME

Problèmes courants connus après la migration​

Veuillez consulter la FAQ sur les problèmes courants connus après la migration.