From 0ac1b11a5e2c2de4e9757730c5aa7abbc831cc7b Mon Sep 17 00:00:00 2001 From: Alexandre Aubin Date: Wed, 10 Jul 2024 19:53:15 +0200 Subject: [PATCH] Cleanup stuff from the pre-buster era --- .../stretch_buster_migration.fr.md | 72 ------------------- .../stretch_buster_migration.md | 72 ------------------- .../jessie_stretch_migration.fr.md | 66 ----------------- .../jessie_stretch_migration.md | 66 ----------------- .../15.admin_guide/55.upgrade/upgrade.md | 4 -- 5 files changed, 280 deletions(-) delete mode 100644 pages/02.administer/15.admin_guide/55.upgrade/10.stretch_buster_migration/stretch_buster_migration.fr.md delete mode 100644 pages/02.administer/15.admin_guide/55.upgrade/10.stretch_buster_migration/stretch_buster_migration.md delete mode 100644 pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.fr.md delete mode 100644 pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.md diff --git a/pages/02.administer/15.admin_guide/55.upgrade/10.stretch_buster_migration/stretch_buster_migration.fr.md b/pages/02.administer/15.admin_guide/55.upgrade/10.stretch_buster_migration/stretch_buster_migration.fr.md deleted file mode 100644 index b308c36c..00000000 --- a/pages/02.administer/15.admin_guide/55.upgrade/10.stretch_buster_migration/stretch_buster_migration.fr.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Migrer de 3.x vers 4.x -template: docs -taxonomy: - category: docs -routes: - default: '/stretch_buster_migration' ---- - -L'objectif cette page est de décrire le processus de migration d'une instance en YunoHost 3.8.x (tournant sous Debian Stretch/9.x) vers YunoHost 4.x (tournant sous Debian Buster/10.x) - -## Notes importantes - -- L'équipe de YunoHost a fait de son mieux pour que cette migration se passe autant en douceur que possible. Elle a été testée durant plusieurs mois et sur plusieurs types d'installations. - -- Néanmoins, vous devez être conscient qu'il s'agit d'une opération délicate. L'administration système est un sujet compliqué et couvrir tous les cas particuliers n'est pas chose aisée. En conséquence, si vous hébergez des données et des systèmes critiques, [faites des sauvegardes](/backup). Et dans tous les cas, soyez patients et attentifs durant la migration. - -- Ne vous précipitez pas à vouloir faire une réinstallation de votre système en pensant que cela serait "plus simple" (sigh). (Une attitude qui revient régulièrement est de vouloir réinstaller son système à la moindre complication...). À la place, si vous rencontrez des problèmes, nous vous encourageons à investiguer, chercher à comprendre et [trouver de l'aide sur le chat ou le forum](/help). - -## Procédure de migration - -### Depuis la webadmin - -Après avoir mis à jour vers la version en 3.8.5.x, allez dans Outils > Migrations pour accéder à l'interface de migration. Il vous faudra ensuite lire l'avertissement attentivement et l'accepter pour lancer la migration. - -### Depuis la ligne de commande - -Après avoir mis à jour vers la version 3.8.5.x, lancez : - -```bash -sudo yunohost tools migrations migrate -``` - -puis lisez attentivement l'avertissement et les instructions. - -## Pendant la migration - -En fonction de votre matériel et des paquets installés, la migration peut prendre jusqu'à une ou deux heures. - -Les logs seront affichés dans la barre de message en haut (vous pouvez approcher la souris dessus pour voir l'historique en entier). Ils seront également consultable après coup (comme les autres opérations) dans Outils > Journaux. - -Notez que même si vous fermez la page d'admin, la migration continuera (par contre l'interface d'admin sera partiellement indisponible). - -### Si la migration a crashé / échoué à un moment - -Si la migration a échoué a un moment donné, la première chose à faire est de tenter de la relancer. Si cela ne fonctionne toujours pas, il vous faut [trouver de l'aide](/help) (prière de fournir le/les messages correspondants ou tout élément qui vous fait penser que ça n'a pas marché). - -## Choses à vérifier après la migration - -### Vérifiez que vous êtes véritablement sous Debian Buster / YunoHost 4.x - -Pour cela, vous pouvez aller dans la partie Diagnostic (section Système de base). (Vous pouvez aussi regarder ce qui est affiché à droite dans le pied de page de la webadmin). En ligne de commande, vous pouvez aussi utiliser `lsb_release -a` et `yunohost --version`. - -### Vérifiez que le diagnostic ne rapporte pas de problème particulier - -Également dans la section Diagnostic de la webadmin, vérifiez qu'il n'y a pas de problème apparu suite à la migration (par exemple un service qui ne tournerais plus...) - -### Vérifiez que les applications fonctionnent - -Vérifiez que vos applications installées fonctionnent... Si elles ne fonctionnent pas, il est recommandé de tenter de les mettre à jour. (ou bien de manière générale, il est recommandé de les mettre à jour même si elles fonctionnent !). - -## Soucis (mineurs) connus après la migration - -- Quelques fichiers de configurations (`/etc/nsswitch.conf` et `/etc/nslcd.conf`) apparaîtrons comme manuellement modifiés. Vous pouvez appliquer la regen-conf en toute sécurité pour régler le problème avec la commande: - -```bash -yunohost tools regen-conf nsswitch nslcd --force -``` - -(nous allons essayer de corriger ceci automatiquement) - -- Il se peut que la migration postgresql (censée s'effectuer automatiquement après la migration à Buster) ne fonctionne pas correctement... Certains utilisateurs ont rapporté que relancer la migration suffisait à résoudre le problème. (Nous allons voir pour comprendre et corriger ce soucis) diff --git a/pages/02.administer/15.admin_guide/55.upgrade/10.stretch_buster_migration/stretch_buster_migration.md b/pages/02.administer/15.admin_guide/55.upgrade/10.stretch_buster_migration/stretch_buster_migration.md deleted file mode 100644 index e7498578..00000000 --- a/pages/02.administer/15.admin_guide/55.upgrade/10.stretch_buster_migration/stretch_buster_migration.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Migrating from 3.x to 4.x -template: docs -taxonomy: - category: docs -routes: - default: '/stretch_buster_migration' ---- - -This page is dedicated to help you migrating an instance from YunoHost 3.8.x (running on Debian Stretch/9.x) to YunoHost 4.x (running on Debian Buster/10.x). - -## Important notes - -- The YunoHost team did its best to make sure that the migration is as smooth as possible and was tested over the course of several months in several cases. - -- With that said, please be aware that this is a delicate operation. System administration is a complicated topic and covering every particular cases is quite hard. Therefore, if you host critical data and services, please [make backups](/backup). And in any case, be patient and attentive during the migration. - -- Please don't rush into thinking that you should need to reinstall your system from scratch thinking it would be "simpler" (sigh). (A common attitude is to be willing to reinstall a server at the slightest complication...) Instead, if you happen to run into issues, we encourage you to try to investigate and understand what's going on and [reach for help on the chat and the forum](/help). - -## Migration procedure - -### From the webadmin - -After upgrading to 3.8.5.x, go to Tools > Migrations to access the migrations interface. You will have to read carefully and accept the disclaimer then launch the migration. - -### From the command line - -After upgrading to 3.8.5.x, run: - -```bash -sudo yunohost tools migrations migrate -``` - -then read carefully and accept the disclaimer. - -## During the migration - -Depending on your hardware and packages installed, the migration might take up to a few hours. - -The logs will be shown in the message bar (you can hover it to see the whole history). They will also be available after the migration (like any other operations) in Tools > Logs. - -Note that even if you close the webadmin page for some reason, the migration will continue in the background (but the webadmin will be partially unavailable). - -### If the migration crashed / failed at some point - -If the migration failed at some point, it should be possible to relaunch it. If it still doesn't work, you can try to [get help](/help) (please provide the corresponding messages or whatever makes you tell that it's not working). - -## What to do after the upgrade - -### Check that you actually are on Debian Buster and YunoHost 4.x - -For this, go in Diagnosis (category Base system) or look at the footer of the webadmin. In the command line, you can use `lsb_release -a` and `yunohost --version`. - -### Check that no issue appeared in the diagnosis - -Also in the Diagnosis in the webadmin, make sure that no specific issue appeared after running the migration (for example a service that crashed for some reason). - -### Check that your applications are working - -Test that your applications are working. If they aren't, you should try to upgrade them (it is also a good idea to upgrade them even if they are working anyway). - -## Current known (minor) issues after the migration - -- Some file (`/etc/nsswitch.conf` and `/etc/nslcd.conf`) will appear as manually modified after the migration. You can safely apply the regen-conf with: - -```bash -yunohost tools regen-conf nsswitch nslcd --force -``` - -(we will try to do this automatically somehow) - -- Sometimes the postgresql migration (that is supposed to happen automatically after the buster migration is ran) fails to run properly... Some users reported that re-launching manually the postgresql migration fixed the issue (we will try to understand and fix this somehow) diff --git a/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.fr.md b/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.fr.md deleted file mode 100644 index 92d2fbdf..00000000 --- a/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.fr.md +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: Migrer de 2.4+ vers 3.x -template: docs -taxonomy: - category: docs -routes: - default: '/jessie_stretch_migration' ---- - -L'objectif cette page est de décrire le processus de migration d'une instance en YunoHost 2.7.x (tournant sous Debian Jessie/8.x) vers YunoHost 3.0 (tournant sous Debian Stretch/9.x) - -## Notes importantes - -- L'équipe de YunoHost a fait de son mieux pour que cette migration se passe autant en douceur que possible. Elle a été testée durant plusieurs mois et sur plusieurs types d'installations. - -- Néanmoins, vous devez être conscient qu'il s'agit d'une opération délicate. L'administration système est un sujet compliqué et couvrir tous les cas particuliers n'est pas chose aisée. En conséquence, si vous hébergez des données et des systèmes critiques, [faites des sauvegardes](/backup). Et dans tous les cas, soyez patients et attentifs durant la migration. - -- Cependant, ne vous précipitez pas non plus à vouloir faire une réinstallation de votre système. Une attitude qui revient régulièrement est de vouloir réinstaller son système à la moindre complication. Pourtant, réinstaller peut aussi s'avérer compliqué. À la place, si vous rencontrez des problèmes, nous vous encourageons à investiguer, chercher à comprendre et trouver de l'aide, plutôt que de se précipiter à vouloir réinstaller simplement parce que cela semble plus simple. - -- Si vous ou vos utilisateurs utilisez des clients emails externes (typiquement Thunderbird ou K9Mail) : le port SMTP a changé. Il s'agissait auparavant du port 465 (avec SSL/TLS) qui a été remplacé par 587 (STARTTLS). Voir [cette page de doc dédiée à la configuration des clients mails](/email_configure_client). La configuration des webmails comme Rainloop doit également être mise à jour, en passant par l'interface d'administration dédiée. - -- Pour les utilisateurs avancés : si vous avez des scripts personnels pour faire des backups, certains changements cassent (de façon mineure) la rétrocompatibilité de la ligne de commande. Les options dépréciées `--hooks`/`--ignore-hooks` ont été enlevées, ainsi que `--ignore-apps`, `--ignore-system`. Pour rendre les choses plus intuitives, `yunohost backup create --apps wordpress` (par exemple) créera uniquement un backup de wordpress, c.-à-d. pas besoin d'ajouter `--ignore-system` pour ne pas backuper le système. - -## Procédure de migration - -### Depuis la webadmin - -Après avoir mis à jour vers la version 2.7.14, allez dans Outils > Migrations pour accéder à l'interface de migration. Il vous faudra ensuite lire l'avertissement attentivement et l'accepter pour lancer la migration. Les logs seront affichés dans la barre de message en haut (vous pouvez approcher la souris dessus pour voir l'historique en entier). - -### Depuis la ligne de commande - -Après avoir mis à jour vers la version 2.7.14, lancez : - -```bash -sudo yunohost tools migrations migrate -``` - -puis lisez attentivement l'avertissement et les instructions. - -## Pendant la migration - -En fonction de votre matériel et des paquets installés, la migration peut prendre jusqu'à quelques heures. - -Notez qu'il est attendu de voir certaines erreurs (en particulier à propos de Fail2Ban) pendant la migration - ne vous en inquiétez pas trop. - -### Si la migration a crashé / échoué à un moment - -Si la migration a échoué a un moment donné, la première chose à faire est de tenter de la relancer. Si cela ne fonctionne toujours pas, il vous faut [trouver de l'aide](/help) (prière de fournir le/les messages correspondants ou tout élément qui vous fait penser que ça n'a pas marché). - -## Choses à vérifier après la migration - -### Vérifiez que vous êtes véritablement sous Debian Stretch / YunoHost 3.0 - -Pour cela, allez dans Outils > Diagnostique. (Vous pouvez aussi regarder ce qui est affiché dans le pied de page). En ligne de commande, vous pouvez aussi utiliser `lsb_release -a` et `yunohost --version`. - -### Vérifiez que Fail2Ban et le pare-feu sont actifs - -Vous devriez voir que Fail2Ban et le firewall sont actifs. Depuis la webadmin, dans Services (chercher `fail2ban` et `yunohost-firewall`). Depuis la ligne de commande, faites `yunohost service status fail2ban yunohost-firewall` : les deux devraient être en `active: active`. - -### Vérifiez que les applications fonctionnent - -Vérifiez que vos applications installées fonctionnent... Si elles ne fonctionnent pas, il est recommandé de tenter de les mettre à jour. (ou bien de manière générale, il est recommandé de les mettre à jour même si elles fonctionnent !). - -### Si vous utilisez les mails : vérifiez votre score - -Si vous utilisez les emails (en particulier les envois), vérifiez que votre score est toujours bon via [mail-tester](https://www.mail-tester.com/) par exemple. diff --git a/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.md b/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.md deleted file mode 100644 index fde3c32f..00000000 --- a/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.md +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: Migrating from 2.4+ to 3.x -template: docs -taxonomy: - category: docs -routes: - default: '/jessie_stretch_migration' ---- - -This page is dedicated to help you migrating an instance from YunoHost 2.7.x (running on Debian Jessie/8.x) to YunoHost 3.0 (running on Debian Stretch/9.x). - -## Important notes - -- The YunoHost team did its best to make sure that the migration is as smooth as possible and was tested over the course of several months in several cases. - -- With that said, please be aware that this is a delicate operation. System administration is a complicated topic and covering every particular cases is quite hard. Therefore, if you host critical data and services, please [make backups](/backup). And in any case, be patient and attentive during the migration. - -- Yet, please don't rush into thinking that you should rush into reinstalling your system. A common "mistake" is to be willing to reinstall a server at the slightest complication. But turns out that reinstalling a system can also be complicated. Instead, if you happen to run into issues, we encourage you to try to investigate and understand what's going on and reach for help instead of just throwing away everything because it looks simpler. - -- About external email clients: if you or your users are using external email clients (typically Thunderbird, K9Mail...) be aware that the SMTP port changed from 465 (with SSL/TLS) to 587 (STARTTLS). See [this page of doc dedicated to email clients](/email_configure_client). Webmail configurations such as Rainloop should also be updated using the corresponding administration interface. - -- For advanced users: if you have some custom scripts for backups, be aware that we made some backward-incompatible changes in the backup command line. The deprecated `--hooks`/`--ignore-hooks` options were removed, as well as the options `--ignore-apps`, `--ignore-system`. To make things more intuitive, `yunohost backup create --apps wordpress` (for example) will only backup wordpress, i.e. you don't have to add `--ignore-system` to not backup the system. - -## Migration procedure - -### From the webadmin - -After upgrading to 2.7.14, go to Tools > Migrations to access the migrations interface. You will have to read carefully and accept the disclaimer then launch the migration. The logs will be shown in the message bar (you can hover it to see the whole history). - -### From the command line - -After upgrading to 2.7.14, run: - -```bash -sudo yunohost tools migrations migrate -``` - -then read carefully and accept the disclaimer. - -## During the migration - -Depending on your hardware and packages installed, the migration might take up to a few hours. - -Note that it is expected to see some errors (in particular about Fail2Ban) during the migration, so don't worry too much about them. - -### If the migration crashed / failed at some point - -If the migration failed at some point, it should be possible to relaunch it. If it still doesn't work, you can try to [get help](/help) (please provide the corresponding messages or whatever makes you tell that it's not working). - -## What to do after the upgrade - -### Check that you actually are on Debian Stretch and YunoHost 3.0 - -You should be able to see this from the webadmin Tools > Diagnosis, and also in the footer of the page. On the command line, you can use `lsb_release -a` and `yunohost --version`. - -### Check that Fail2Ban and the firewall are active - -You should be able to see that Fail2Ban and the firewall are active. From the webadmin in Services (look for `fail2ban` and `yunohost-firewall`). From the command line, run `yunohost service status fail2ban yunohost-firewall`. They should both have `active: active`. - -### Check that your applications are working - -Test that your applications are working. If they aren't, you should try to upgrade them (it is also a good idea to upgrade them even if they are working anyway). - -### Mail users: check your mail score - -If you are using mails (especially sending them), check that your score is still good by using [mail-tester](https://www.mail-tester.com/) for example. diff --git a/pages/02.administer/15.admin_guide/55.upgrade/upgrade.md b/pages/02.administer/15.admin_guide/55.upgrade/upgrade.md index 05f4e021..a689c11c 100644 --- a/pages/02.administer/15.admin_guide/55.upgrade/upgrade.md +++ b/pages/02.administer/15.admin_guide/55.upgrade/upgrade.md @@ -32,7 +32,3 @@ yunohost tools upgrade apps # Upgrade a specific application yunohost app upgrade wordpress ``` - -!! If you are upgrading from YunoHost below v4.2.2, `system` and `apps` were flags of the command. Add `--` before them: -!! `yunohost tools upgrade --system` -!! `yunohost tools upgrade --apps`