forked from ScoDoc/DocScoDoc
Instructions pour mise à jour vers ScoDoc 9.6 / Debian 12
This commit is contained in:
parent
055a85e274
commit
d5ff90dc7f
@ -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
|
||||
|
@ -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 <a href="/attachments/scodoc.list"
|
||||
download>scodoc.list</a> dans `/etc/apt/sources.list.d/`
|
||||
- Ajouter le dépôt scodoc: copier ce fichier <a href="/attachments/scodoc.list"
|
||||
download>scodoc-bullseye.list</a> dans `/etc/apt/sources.list.d/`
|
||||
ou le créer contenant juste cette ligne:
|
||||
|
||||
```text
|
||||
|
160
docs/UpgradeToDeb12Sco96.md
Normal file
160
docs/UpgradeToDeb12Sco96.md
Normal file
@ -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 <a href="/attachments/scodoc.list"
|
||||
download>scodoc.list</a> 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
|
||||
```
|
2
docs/attachments/scodoc-bullseye.list
Normal file
2
docs/attachments/scodoc-bullseye.list
Normal file
@ -0,0 +1,2 @@
|
||||
# ScoDoc repository
|
||||
deb http://scodoc.org/repo bullseye main
|
@ -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
|
||||
|
Loading…
Reference in New Issue
Block a user