Procédure pour la mise à jour vers Debian 13 (ScoDoc 9.7)¶

Cette page documente la mise à jour d'un serveur ScoDoc 9.7 tournant sous Linux Debian 12 bookworm vers la version suivante, Debian 13 trixie, parue en août 2025.

Note: si vous souhaitez installer ScoDoc 9.7 de zéro, voir la page d'installation

On commence par mettre à jour normalement le système Debian, puis on met à jour ScoDoc.

Tout compris, la mise à jour d'un serveur typique prend environ 15 à 20 minutes et ne demande aucune compétence particulière, autre que de suivre scrupuleusement les instructions ci-dessous, sans oublier d'étape.

Upgrade Debian 12 vers Debian 13¶

La documentation officielle de Debian, qui couvre tous les cas, est là: Mises à niveau depuis Debian 12. En général notre serveur ScoDoc est plus simple et il suffit de suivre le résumé ci-dessous.

Sauvegarder¶

Avant tout, sauvegarder vos données et l'ensemble de votre serveur. Vérifiez que vous avez assez d'espace disque disponible (par exemple avec la commande df -h).

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¶

apt-get update
apt-get upgrade
apt-get full-upgrade

Supprimer les éventuels paquets obsolètes et nettoyer¶

apt purge '?obsolete'
apt clean
apt autoremove

Modifier les sources de mise à jour¶

Il est conseillé de reprendre copier ceci dans /etc/apt/sources.list.d/debian.sources

  wget -O /etc/apt/sources.list.d/debian.sources https://scodoc.org/attachments/trixie-debian.sources
  rm -f /etc/apt/sources.list

Sinon, vous pouvez créer le fichier /etc/apt/sources.list.d/debian.sources manuellement avec ce contenu:

Types: deb
URIs: https://deb.debian.org/debian
Suites: trixie trixie-updates
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Types: deb
URIs: https://security.debian.org/debian-security
Suites: trixie-security
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

sans oublier de supprimer l'ancien fichier:

rm -f /etc/apt/sources.list

Mettre à jour le système Debian¶

/bin/rm -f /etc/apt/sources.list.d/scodoc.list 
rm -f /etc/apt/sources.list
apt update

Les deux commandes ci-dessous vont mettre à jour tout le système et 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 (lorsqu'un texte long s'affiche, taper 'q' puis "entrée"...).

apt upgrade --without-new-pkgs
#

# Puis:
apt full-upgrade

NB: on va vous demander si vous souhaiter mettre à jour le cluster de base de données (version 15 à version 17 de postgresql): répondre OUI. Si jamais vous avez répondu non, vous devrez lancer:

pg_upgradecluster 15 main -v 17

À la fin, vous devriez voir ce message:

Success. Please check that the upgraded cluster works. If it does,
you can remove the old cluster with
    pg_dropcluster 15 main

Mise à jour du logiciel scodoc (paquet `scodoc9`)¶

Installer la clé: en root sur le serveur, lancer

  apt-get -y install gnupg curl
  curl -fsSL https://scodoc.org/misc/scodoc-repo.gpg.key | gpg --dearmor -o /usr/share/keyrings/scodoc-repo.gpg

Ajouter le dépôt scodoc: créer le fichier /etc/apt/sources.list.d/scodoc.sources soit en le copiant:

  wget -O /etc/apt/sources.list.d/scodoc.sources https://scodoc.org/attachments/trixie-scodoc.sources

ou bien le créer afin qu'il contienne ce texte:

Types: deb
URIs: http://scodoc.org/deb/trixie/
Suites: trixie
Components: main
Signed-By: /usr/share/keyrings/scodoc-repo.gpg

Puis mettre à jour:

apt update
apt upgrade

Nettoyage du système¶

apt autoremove
apt purge '?obsolete'

Redémarrage¶

shutdown -r now

Après reconnexion, vous avez un serveur Debian 13 et ScoDoc à jour.

Lorsque vous avez vérifié que tout fonctionne et que les données sont bien accessibles, effacez l'ancien cluster de base de données. En tant que root:

pg_dropcluster 15 main

Commandes de contrôle du service ScoDoc¶

Comme d'habitude, en tant que root:

État du service:

systemctl status scodoc9

Démarrer le service:

systemctl start scodoc9

Arrêter le service

systemctl stop scodoc9

Voir aussi