From d5ff90dc7f966c0f4389f59ce750c5b165543fef Mon Sep 17 00:00:00 2001 From: viennet Date: Tue, 18 Jul 2023 16:19:13 +0300 Subject: [PATCH] =?UTF-8?q?Instructions=20pour=20mise=20=C3=A0=20jour=20ve?= =?UTF-8?q?rs=20ScoDoc=209.6=20/=20Debian=2012?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/BUTReferentielCompetences.md | 8 +- docs/GuideInstallDebian11.md | 6 +- docs/UpgradeToDeb12Sco96.md | 160 ++++++++++++++++++++++++++ docs/attachments/scodoc-bullseye.list | 2 + docs/attachments/scodoc.list | 4 +- 5 files changed, 171 insertions(+), 9 deletions(-) create mode 100644 docs/UpgradeToDeb12Sco96.md create mode 100644 docs/attachments/scodoc-bullseye.list diff --git a/docs/BUTReferentielCompetences.md b/docs/BUTReferentielCompetences.md index 6051f57a9..3030fc2d5 100644 --- a/docs/BUTReferentielCompetences.md +++ b/docs/BUTReferentielCompetences.md @@ -8,12 +8,12 @@ Le référentiel de compétence définit notamment les compétences et leurs niv pour chaque parcours de la spécialité. Ce document publié par le ministère ne peut pas être modifié par les universités: les adaptations portent uniquement sur les modalités de formation (adaptations locales du référentiel de formation, -validée par le CFVU de chaque établissement). +validées par le CFVU de chaque établissement). -ScoDoc propose de charger les référentiels de compétences, qui ont été publié +ScoDoc propose de charger les référentiels de compétences, qui ont été publiés en format XML par l'application Orébut de l'ADIUT. -Une fois chargés, ces données ne sont pas modifiables. +Une fois chargées, ces données ne sont pas modifiables. ## Formation et référentiel de compétences @@ -29,7 +29,7 @@ détail de la configuration sur la page ## Changement de versions du référentiel de compétences Il peut arriver que le référentiel de compétences d'une spécialité soit mis à -jour: ainsi, en 2023 de nouvelles versions ont été publiés pour de nombreuses +jour: ainsi, en 2023 de nouvelles versions ont été publiées pour de nombreuses spécialités, corrigeant certains détails (intitulés de parcours, ...). Les étudiants ayant commencé dans un référentiel devraient en principe continuer diff --git a/docs/GuideInstallDebian11.md b/docs/GuideInstallDebian11.md index fea0ef3f1..49bb3a435 100644 --- a/docs/GuideInstallDebian11.md +++ b/docs/GuideInstallDebian11.md @@ -109,7 +109,7 @@ Checklist minimale de votre système Linux Debian: reboot. L'utilisation d'un serveur de temps (ntp) est recommandée ( `apt-get install ntp`), et éventuellement `dpkg-reconfigure tzdata`). 1. Si vous avez installé à partir d'un support (DVD, clé USB...), pensez à le - retirer des sources Debian afin de ne pas bloquer les mise à jour (commenter + retirer des sources Debian afin de ne pas bloquer les mises à jour (commenter la ligne `deb cdrom:` dans le fichier `/etc/apt/sources.list`) 1. Cette liste est incomplète... et n'oubliez pas: avant de passer en production, mettez en place des sauvegardes sérieuses ! @@ -228,8 +228,8 @@ Remarque: *Si ce n'est pas déjà le cas, vous avez intérêt à ouvrir une sess `ssh` (ou `putty`) depuis une machine normale, afin de pouvoir copier/coller facilement les commandes et éditer les fichiers de configuration.* -- Ajouter le dépot scodoc: copier ce fichier scodoc.list dans `/etc/apt/sources.list.d/` +- Ajouter le dépôt scodoc: copier ce fichier scodoc-bullseye.list dans `/etc/apt/sources.list.d/` ou le créer contenant juste cette ligne: ```text diff --git a/docs/UpgradeToDeb12Sco96.md b/docs/UpgradeToDeb12Sco96.md new file mode 100644 index 000000000..fa2b7e463 --- /dev/null +++ b/docs/UpgradeToDeb12Sco96.md @@ -0,0 +1,160 @@ +# Procédure pour la mise à jour vers Debian 12 et ScoDoc 9.6 + +Cette page documente la mise à jour d'un serveur ScoDoc 9.4 ou 9.5 tournant sous +Linux Debian 11 vers la version suivante: ScoDoc 9.6 sous Debian 12. + +On commence par mettre à jour normalement le système Debian, puis on change la +version de la base de données postgresql puis on met à jour ScoDoc. + +## Upgrade Debian 11 vers Debian 12 + +La documentation officielle est là: +[DebianUpgrade](https://wiki.debian.org/DebianUpgrade). Elle couvre tous les +cas, mais en général notre serveur ScoDoc est plus simple: résumé ci-dessous + +### Sauvegarder + +Avant tout, sauvegarder vos données et l'ensemble de votre serveur. + +Prévenez les utilisateurs et arrêtez le service: `systemctl stop scodoc9` + +### Mettre à jour Debian + +Dans la suite, on suppose que vous avez un shell root. Sinon, utilisez `sudo`. + +#### Vérifier qu'on est à jour + +```bash +apt-get update +apt-get upgrade +apt-get full-upgrade +``` + +#### Modifier les sources de mise à jour + +Éditer le fichier `/etc/apt/sources.list` (par exemple avec la commande +`nano /etc/apt/sources.list`) et remplacer le mot `bullseye`par +`bookworm`. + +Il peut être plus simple de reprendre ce contenu: + +```txt +deb http://deb.debian.org/debian/ bookworm main contrib non-free non-free-firmware +deb-src http://deb.debian.org/debian/ bookworm main contrib non-free non-free-firmware + +deb http://security.debian.org/debian-security bookworm-security main +deb-src http://security.debian.org/debian-security bookworm-security main + +deb http://deb.debian.org/debian/ bookworm-updates main +deb-src http://deb.debian.org/debian/ bookworm-updates main +``` + +#### Mettre à jour + +```bash +apt-get clean +apt-get update +``` + +Les deux commandes suivantes sont longues, surtout ne pas les interrompre. +Répondre "oui" (ou la réponse par défaut) aux diverses question, ou dire que +vous conservez les versions locales modifiées de vos fichiers de configuration. + +```bash +apt-get upgrade +# + +# Puis: +apt-get full-upgrade +``` + +Un petit nettoyage: + +```bash +apt-get autoremove +``` + +Et un redémarrage + +```bash +shutdown -r now +``` + +Après reconnexion, vous avez un serveur Debian 12. Reste à s'occuper de la base +de données et de ScoDoc. D'abord, s'assurer que le service na pas redémarré: + +```bash +systemctl stop scodoc9 +`````` + +## Upgrade Postgresql + +Debian 12 est livré avec Postgresql 15, tandis que l'installation précédente +tournait sous Postgresql 13. Il est donc nécessaire de migrer les données en +base vers la nouvelle version. +Procédure inspirée de +[ce tuto en français](https://wiki.fiat-tux.fr/books/administration-syst%C3%A8mes/page/migration-d%E2%80%99une-version-majeure-de-postgresql-%C3%A0-une-autre] + +Toujours dans un shell root, copier/coller les commandes suivantes: + +```bash +service postgresql stop +pg_dropcluster --stop 15 main +pg_upgradecluster -m upgrade 13 main +systemctl start postgresql + +su -c "/usr/lib/postgresql/15/bin/vacuumdb --all --analyze-in-stages" postgres + +pg_dropcluster 13 main --stop +apt-get autoremove --purge postgresql-13 postgresql-client-13 +``` + +## Passage de ScoDoc 9.5 (ou 9.4) à 9.6 + +### Modification des sources de paquets Debian + +- Supprimer l'ancien fichier: + +```bash +rm /etc/apt/sources.list.d/scodoc* +``` + +- Ajouter le dépot scodoc: copier ce fichier scodoc.list dans `/etc/apt/sources.list.d/` +ou bien l'éditer pour qu'il contienne juste cette ligne: + +```text + # contenu du fichier /etc/apt/sources.list.d/scodoc.list + deb http://scodoc.org/deb/bookworm bookworm main +``` + +### Mise à jour du paquet scodoc9 + +```bash +apt update && apt upgrade +``` + +devrait installer `scodoc9.6.x`. + +### Migration des absences vers les assiduités + +Le nouveau module de gestion des assiduité (absences/présences/justificatifs) +permet d'importer les anciennes "absences" (et justificatifs). Pour cela, lancer +les commandes suivantes + +```bash +su scodoc +cd /opt/scodoc +source venv/bin/activate +flask migrate-abs-to-assiduites +``` + +Le traitement est assez long et peut prendre plusieurs dizaines de minutes, +suivant le nombre d'absences et la vitesse de votre serveur. + +### Démarrage du service + +Comme d'habitude, en tant que `root`: +```bash +systemctl start scodoc9 +``` diff --git a/docs/attachments/scodoc-bullseye.list b/docs/attachments/scodoc-bullseye.list new file mode 100644 index 000000000..aa8d932ea --- /dev/null +++ b/docs/attachments/scodoc-bullseye.list @@ -0,0 +1,2 @@ +# ScoDoc repository +deb http://scodoc.org/repo bullseye main diff --git a/docs/attachments/scodoc.list b/docs/attachments/scodoc.list index aa8d932ea..963ce4cbe 100644 --- a/docs/attachments/scodoc.list +++ b/docs/attachments/scodoc.list @@ -1,2 +1,2 @@ -# ScoDoc repository -deb http://scodoc.org/repo bullseye main +# ScoDoc repository for Debian 12 bookworm +deb http://scodoc.org/deb/bookworm bookworm main