From 03f5b6800c1a9bf3fdcb17089f36ffa8e9a56bbe Mon Sep 17 00:00:00 2001
From: viennet <emmanuel.viennet@gmail.com>
Date: Mon, 28 Aug 2023 08:49:33 +0200
Subject: [PATCH] =?UTF-8?q?Upgrade=20Deb12:=20petites=20am=C3=A9liorations?=
 =?UTF-8?q?=20via=20Yann=20T.=20(IUT=20Starsbourg)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/ScoDoc9API.md          |  8 ++++----
 docs/UpgradeToDeb12Sco96.md | 41 ++++++++++++++++++++++++++++++-------
 2 files changed, 38 insertions(+), 11 deletions(-)

diff --git a/docs/ScoDoc9API.md b/docs/ScoDoc9API.md
index bbe94f8..5639700 100644
--- a/docs/ScoDoc9API.md
+++ b/docs/ScoDoc9API.md
@@ -1566,7 +1566,7 @@ Cette API est disponible à partir de ScoDoc 9.6 et remplace les absences.
   * `nip`
   * `ine`
 * **Query string:**
-  * `etat` ('present','retard','absent)
+  * `etat` ('present','retard','absent')
   * `moduleimpl_id` (X : id du moduleimpl concerné)
   * `date_debut` (X : date format ISO)
   * `date_fin` (X : date format ISO)
@@ -1597,7 +1597,7 @@ Cette API est disponible à partir de ScoDoc 9.6 et remplace les absences.
 * **Permission: `ScoView`**
 * **Paramètres:** `formsemestre_id`
 * **Query string:**
-  * `etat` ('present','retard','absent)
+  * `etat` ('present','retard','absent')
   * `moduleimpl_id` (X : id du moduleimpl concerné)
   * `date_debut` (X : date format ISO)
   * `date_fin` (X : date format ISO)
@@ -1619,7 +1619,7 @@ Cette API est disponible à partir de ScoDoc 9.6 et remplace les absences.
 * **Permission: `ScoView`**
 * **Paramètres:** `formsemestre_id`
 * **Query string:**
-  * `etat` ('present','retard','absent)
+  * `etat` ('present','retard','absent')
   * `moduleimpl_id` (X : id du moduleimpl concerné)
   * `date_debut` (X : date format ISO)
   * `date_fin` (X : date format ISO)
@@ -1641,7 +1641,7 @@ Cette API est disponible à partir de ScoDoc 9.6 et remplace les absences.
 * **Permission: `ScoView`**
 * **Query string:**
   * `etudids` **Obligatoire** (liste des etudids sous la forme `x,y,z,...`)
-  * `etat` ('present','retard','absent)
+  * `etat` ('present','retard','absent')
   * `moduleimpl_id` (X : id du moduleimpl concerné)
   * `date_debut` (X : date format ISO)
   * `date_fin` (X : date format ISO)
diff --git a/docs/UpgradeToDeb12Sco96.md b/docs/UpgradeToDeb12Sco96.md
index eae556c..cae2ca2 100644
--- a/docs/UpgradeToDeb12Sco96.md
+++ b/docs/UpgradeToDeb12Sco96.md
@@ -42,9 +42,13 @@ apt-get full-upgrade
 
 Si vous savez le faire, éditer le fichier `/etc/apt/sources.list` (par exemple
 avec la commande `nano /etc/apt/sources.list`) et remplacer le mot `bullseye`par
-`bookworm`.
+`bookworm`. Vous pouvez aussi utiliser `sed`
 
-Sinon, il peut être plus simple de reprendre ce contenu:
+```bash
+sed -i 's/bullseye/bookworm/g' /etc/apt/sources.list
+```
+
+Bien vérifier le résultat. Sinon, il peut être plus simple de reprendre ce contenu:
 
 ```txt
 deb http://deb.debian.org/debian/ bookworm main contrib non-free non-free-firmware
@@ -93,6 +97,12 @@ 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 n'a pas redémarré:
 
+```bash
+systemctl status scodoc9
+```
+
+et si besoin le stopper avec :
+
 ```bash
 systemctl stop scodoc9
 ```
@@ -113,17 +123,26 @@ Procédure inspirée de
 Toujours dans un shell root, copier/coller les commandes suivantes:
 
 ```bash
+# Arrêter et mettre à jour
 service postgresql stop
 pg_dropcluster --stop 15 main
 pg_upgradecluster -m upgrade 13 main
 systemctl start postgresql
+# Vérifier l'etat du service
+systemctl status postgresql
+```
 
-su -c "/usr/lib/postgresql/15/bin/vacuumdb --all --analyze-in-stages" postgres
+Puis
+
+```bash
+/bin/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
 ```
 
+Soyez attentif et vérifier que les commandes précédentes se sont exécutées sans erreur.
+
 ## Passage de ScoDoc 9.5 (ou 9.4) à 9.6
 
 ### Modification des sources de paquets Debian
@@ -134,15 +153,23 @@ apt-get autoremove --purge postgresql-13 postgresql-client-13
 /bin/rm -f /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:
+- Ajouter le dépot scodoc: copier le fichier <a href="/attachments/scodoc.list"
+   download>scodoc.list</a> dans `/etc/apt/sources.list.d/` à l'aide de la
+   commande
+
+```bash
+wget --directory-prefix=/etc/apt/sources.list.d/ https://scodoc.org/attachments/scodoc.list
+```
+
+ou si vous préférez 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
 ```
 
+
+
 ### Installation de la clé
 
 L'ancienne clé crypto qui authentifie scodoc est toujours valide, mais il faut
@@ -169,7 +196,7 @@ les commandes suivantes:
 
 ```bash
 systemctl stop scodoc9 # le service DOIT etre stoppé !
-su scodoc
+/bin/su scodoc
 #
 cd /opt/scodoc
 source venv/bin/activate