====== Rétrograder une Debian ======

  * Niveau requis : {{tag>avisé}}
  * Suivi : {{tag>à-tester}}
    * Création par [[user>vv222]] 24/11/2023
    * Testé par <...> le <...> FIXME
  * Commentaires sur le forum : [[https://debian-facile.org/viewtopic.php?id=34252|Rétrograder une Debian / Suivi du Wiki et des Projets Git]]

===== Introduction =====

Dans cet article nous décrirons les étapes permettant de rétrograder une Debian à une version antérieure, sans passer par une réinstallation du système. C’est une action explicitement déconseillée par Debian, donc il ne faudra pas s’attendre à une opération triviale sans risque d’échec. En cas de problème lors d’une des étapes décrites dans cet article, ne passez pas à la suite en ignorant les erreurs, mais ouvrez plutôt une discussion sur [[https://debian-facile.org/viewforum.php?id=10|le forum Debian-Facile]] pour pouvoir être guidés.

===== Préparer la configuration du système de paquets =====

==== Trixie → Bookworm ====

  - Supprimez le fichier ''/etc/apt/sources.list'' et tous les fichiers dans ''/etc/apt/sources.list.d''.
  - Créez un fichier ''/etc/apt/sources.list.d/debian.sources'' avec le contenu suivant (attention à ne pas omettre la ligne vide entre les deux blocs) : <file apt_sources /etc/apt/sources.list.d/debian.sources>
Types: deb
URIs: http://deb.debian.org/debian
Suites: bookworm bookworm-updates bookworm-proposed-updates
Architectures: amd64
Components: main
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Types: deb
URIs: http://deb.debian.org/debian-security
Suites: bookworm-security
Architectures: amd64
Components: main
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
</file>
  - Supprimez le fichier ''/etc/apt/preferences'' et tous les fichiers dans ''/etc/apt/preferences.d''.
  - Créez un fichier ''/etc/apt/preferences.d/downgrade'' avec le contenu suivant (attention à ne pas omettre la ligne vide entre les deux blocs) : <file apt_preferences /etc/apt/preferences.d/downgrade>

Package: *
Pin: release o=Debian,n=bookworm
Pin-Priority: 1001

Package: *
Pin: release o=Debian,n=bookworm-security
Pin-Priority: 1001
</file>
  - Mettez à jour l’index des paquets avec la commande suivante : <code root>apt update</code>

==== Bookworm → Bullseye ====

  - Supprimez le fichier ''/etc/apt/sources.list'' et tous les fichiers dans ''/etc/apt/sources.list.d''.
  - Créez un fichier ''/etc/apt/sources.list.d/debian.sources'' avec le contenu suivant (attention à ne pas omettre la ligne vide entre les deux blocs) : <file apt_sources /etc/apt/sources.list.d/debian.sources>
Types: deb
URIs: http://deb.debian.org/debian
Suites: bullseye bullseye-updates bullseye-proposed-updates
Architectures: amd64
Components: main
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Types: deb
URIs: http://deb.debian.org/debian-security
Suites: bullseye-security
Architectures: amd64
Components: main
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
</file>
  - Supprimez le fichier ''/etc/apt/preferences'' et tous les fichiers dans ''/etc/apt/preferences.d''.
  - Créez un fichier ''/etc/apt/preferences.d/downgrade'' avec le contenu suivant (attention à ne pas omettre la ligne vide entre les deux blocs) : <file apt_preferences /etc/apt/preferences.d/downgrade>

Package: *
Pin: release o=Debian,n=bullseye
Pin-Priority: 1001

Package: *
Pin: release o=Debian,n=bullseye-security
Pin-Priority: 1001
</file>
  - Mettez à jour l’index des paquets avec la commande suivante : <code root>apt update</code>

===== Désinstaller les paquets qui risquent de poser des problèmes =====

Les paquets actuellement installés mais n’étant pas disponibles dans les dépôts de la version de Debian ciblée risquent de complexifier le retour en arrière. Ces paquets peuvent être listés avec la commande suivante :

<code user>apt list '?obsolete'</code>

Pour simplifier le retour en arrière qui va suivre il vaut mieux que cette liste soit la plus courte possible, idéalement vide. Une bonne approche est donc de désinstaller tout ce qu’elle retourne et dont on sait qu’on pourra le réinstaller plus tard, une fois le système remis sur pieds.

===== Forcer le rétrogradage du système =====

Lancez les commandes suivantes, dans cet ordre, **en ne passant pas à la suivante tant que la précédente ne s'achève pas sans erreur** :

<code root>apt upgrade --without-new-pkgs</code>
<code root>apt autoremove</code>
<code root>apt upgrade</code>
<code root>apt autoremove</code>
<code root>apt full-upgrade</code>
<code root>apt autoremove</code>

En cas d'erreur à une étape, n’essayez pas de forcer quoi que ce soit. Demandez plutôt de l’aide sur [[https://debian-facile.org/viewforum.php?id=10|le forum Debian-Facile]] en indiquant bien la commande qui pose problème et en partageant son retour complet.

===== Vérifier la cohérence du système =====

Lancez la commande suivante pour lister les paquets encore installés dans des versions ne venant pas des dépôts de la version de Debian actuellement installée :

<code user>apt list '?obsolete'</code>

Ces paquets devront soit être supprimés, soit être installés dans la version correcte par un autre biais. N’hésitez pas à demander de l’aide sur [[https://debian-facile.org/viewforum.php?id=10|le forum Debian-Facile]] en partageant la liste donnée par la commande précédente pour vous faire accompagner.

===== Nettoyer la configuration du système de paquets =====

Une fois le rétrogradage achevé, vous pouvez supprimer le fichier ''/etc/apt/preferences.d/downgrade''.

===== Articles liés =====

  * [[doc:systeme:apt|APT : Gestionnaire de Paquets Avancé]]
  * [[doc:systeme:apt:apt|Gestion des paquets avec APT]]