Rocky Linux 10 : tutoriel / Diagnostiquer les erreurs de paquets et utiliser l’historique DNF
Les erreurs de paquet dans Rocky Linux 10 doivent être résolues après avoir distingué les problèmes liés aux noms, aux dépôts, aux métadonnées, aux dépendances et aux fichiers d'installation. L'historique DNF est utilisé pour examiner ce qui a changé et pour revenir sur des opérations de paquet spécifiques, mais ce n'est pas une sauvegarde qui restaure les données utilisateur ou l'ensemble du serveur à un état antérieur.
Rassemblez d'abord les messages d'erreur et l'état actuel
Lorsqu'une erreur se produit, enregistrez la commande initialement exécutée avant de la répéter ou d'ajouter des options forcées, le message d'erreur complet, le statut de sortie et l'état actuel de l'installation. Si la connexion SSH a été interrompue en cours de route, l'installation réelle du package peut avoir été terminée, il faut donc vérifier d'abord l'état enregistré.
cat /etc/rocky-release
dnf --version
rpm -q tree
dnf repolist --enabled
sudo dnf history list
sudo dnf check
DNF (Dandified YUM) est un outil pour gérer les paquets et les dépendances dans les dépôts, tandis que RPM (RPM Package Manager) est un outil fondamental pour gérer les informations et les fichiers des paquets installés. L'environnement de laboratoire source enregistré était Rocky Linux 10.2, DNF 4.20.0, et RPM 4.19.1.1. Le dépôt par défaut a été utilisé sur une machine virtuelle (VM) dédiée, et tree n'était pas installé au départ. dnf check vérifie les problèmes de cohérence tels que les dépendances des paquets installés, et le fait qu'il n'y ait aucune sortie ne signifie pas que tous les services ou les données utilisateur ont été inspectés.
| Indices représentatifs | Problèmes à distinguer en premier |
|---|---|
| Aucune correspondance pour l'argument | Savoir si le nom, la version et l'architecture sont corrects, et si le dépôt requis les fournit |
| Erreurs de métadonnées, de miroir ou de résolution de nom | Réseau, DNS, heure, proxy, cache et état du dépôt |
| Rien ne fournit, demandes conflictuelles | Dépendances requises, versions actuellement installées, combinaisons de dépôts |
| Erreurs de clé de signature ou de certificat | Source exacte et clé officielle·heure système·vérification du certificat |
| Fichiers exécutables ou documents manquants | État d'installation·relations de propriété des paquets·différences réelles de fichiers |
S'il s'agit d'une erreur de verrouillage, vérifiez d'abord si une autre opération DNF·RPM ou une mise à jour automatique est en cours et attendez qu'elle se termine. Ne faites pas de suppression arbitraire de fichiers de verrouillage·base de données RPM ni de terminaison forcée des opérations normales comme première solution.
Séparez les erreurs de nom et les problèmes de référentiel·dépendances
Dans le laboratoire source, une requête intentionnelle a utilisé un nom de paquet pratique inexistant pour reproduire l'erreur suivante. --assumeno n'est pas approuvé pour l'installation.
sudo dnf --assumeno install lf-course-missing-package-20261112
No match for argument: lf-course-missing-package-20261112
Error: Unable to find a match: lf-course-missing-package-20261112
À ce stade, le code de sortie était 1. Vérifiez le nom du paquet réel et la source selon l'erreur.
dnf search tree
dnf info tree
dnf provides /usr/bin/tree
dnf repoquery --requires --resolve tree
sudo dnf --assumeno install tree
Dans le même environnement, tree a été confirmé comme un candidat pour 2.1.0-8.el10.x86_64 dans BaseOS, et il y avait un plan d'installation. Cette comparaison est un test pour distinguer les noms utilisés incorrectement et les candidats normaux. Si le paquet requis existe uniquement dans un dépôt supplémentaire, utilisez le guide des dépôts CRB et EPEL pour vérifier son rôle, son statut activé et les combinaisons supportées. Corriger simplement le nom ne résout pas tous les conflits de dépendances.
Pour nothing provides, identifiez la bibliothèque ou la capacité manquante ainsi que le paquet qui en a besoin. Vérifiez la version majeure du système d’exploitation, la compatibilité des dépôts et les candidats en conflit. Ne contournez pas les dépendances avec l’option RPM --nodeps, ne désactivez pas la vérification des signatures et n’appliquez pas l’option DNF --allowerasing de manière indiscriminée. Examinez chaque suppression proposée ainsi que les services affectés avant d’approuver une solution.
Appliquez le nettoyage du cache en fonction de la cause que vous avez identifiée.
Si la liste est ancienne ou si elle ne peut pas être interrogée à cause des limites de cache, reverifiez d’abord les métadonnées du dépôt actuel.
sudo dnf --refresh info tree
Dans l’exercice de recherche de paquets avec DNF, la requête a échoué en raison d'un manque de cache pour la liste des fichiers requis par dnf -C provides, mais lorsque -C a été exclu et qu'une requête normale a été effectuée, les informations nécessaires ont été obtenues. L'échec de la requête en utilisant uniquement le cache et l'absence du package dans le dépôt sont des problèmes différents.
Reportez-vous à la référence officielle des commandes DNF, où clean expire-cache expire les métadonnées mises en cache pour une revalidation, clean metadata voit ses métadonnées supprimées afin qu'elles puissent être téléchargées à nouveau plus tard, et clean all efface plusieurs caches en même temps. Par conséquent, si vous effacez le cache entier à chaque fois, vous risquez seulement d'augmenter les téléchargements sans résoudre la cause.
Si une corruption des métadonnées est détectée et qu’un nettoyage est nécessaire, sélectionnez la plage requise comme une nouvelle requête de sudo dnf clean metadata et un dépôt normal. Pour l’exercice présenté dans cet article, le cache normal n’a pas été intentionnellement supprimé, ni les vérifications du dépôt ou des certificats affaiblies.
Trouvez les fichiers manquants avec RPM et restaurez-les par réinstallation.
Interroger le propriétaire et vérifier les fichiers d’installation sont des tâches différentes. rpm -qf trouve le paquet propriétaire, tandis que rpm -V compare les attributs enregistrés dans la base de données d’installation avec les fichiers actuels. La signification peut également être confirmée dans référence officielle des commandes RPM , et les étapes ci-dessous ont été testées sur RPM 4.19.1.1 sur cette VM.
La reproduction suivante est effectuée uniquement sur une VM dédiée sans données de travail. Les fichiers ne sont pas déplacés délibérément sur des serveurs utilisant déjà tree. Tout d'abord, passez en revue le plan d'installation, installez tree et enregistrez l'ID de transaction d'installation réel.
sudo dnf --assumeno install tree
sudo dnf install tree
sudo dnf history info last
rpm -qf /usr/share/doc/tree/README
rpm -V tree
L'ID d'installation sur cette VM pour cette session était 6, et le paquet tree a été installé. Les ID diffèrent sur d'autres ordinateurs. La reproduction ci-dessous ne déplace qu'un seul document README appartenant à ce paquet au lieu des fichiers exécutables ou des paramètres de service. Si ce n'est pas la version, le document ou le nouvel emplacement de sauvegarde attendu, arrêtez avant d'apporter des modifications.
sudo bash <<'BASH'
set -eu
test "$(rpm -qf /usr/share/doc/tree/README)" = tree-2.1.0-8.el10.x86_64
test -f /usr/share/doc/tree/README
test ! -e /root/lf-course-12-before
mkdir -m 700 /root/lf-course-12-before
mv -- /usr/share/doc/tree/README /root/lf-course-12-before/tree-README
BASH
rpm -V tree
printf 'verify exit=%s\n' "$?"
Si votre version est différente ou si un dossier de sauvegarde existe déjà, les vérifications de conditions ci-dessus ne sont pas supprimées pour forcer le passage. Vérifiez à nouveau le chemin du fichier et l'état de préparation de la pratique. Sur cette VM, les résultats suivants et le statut de sortie 1 ont été confirmés.
missing d /usr/share/doc/tree/README
missing signifie qu’un fichier enregistré dans le paquet est absent, et d indique un fichier de document. rpm -V signale uniquement le problème et ne restaure pas le contenu de ce document. Vérifiez si les modifications ou omissions réelles étaient intentionnelles, puis lisez le plan de réinstallation.
sudo dnf --assumeno reinstall tree
sudo dnf reinstall tree
sudo cmp /root/lf-course-12-before/tree-README /usr/share/doc/tree/README
rpm -V tree
printf 'verify exit=%s\n' "$?"
Cette opération a réinstallé la même version du paquet tree provenant de BaseOS. Les documents récupérés étaient identiques à la sauvegarde, cmp s'est terminé sans aucune différence, et la vérification RPM a également renvoyé 0 sans sortie. Pour réinstaller, vous devez obtenir le RPM de la version exacte actuellement installée depuis la source. Les fichiers de configuration peuvent être traités séparément selon la politique de remplacement des paquets, donc les commandes qui écrasent toujours les paramètres opérationnels avec les originaux ne sont pas généralisées.
Si la réinstallation échoue et que le document est toujours manquant, vous pouvez copier la sauvegarde /root/lf-course-12-before/tree-README effectuée dans cette pratique vers le chemin d'origine /usr/share/doc/tree/README tout en préservant les attributs et vérifier de nouveau. Même dans ce cas, vérifiez d'abord si la cible est réellement manquante afin d'éviter d'écraser d'autres modifications. Puisque la récupération réelle dans ce cas a réussi, le chemin pour recopier la sauvegarde n'a pas été exécuté.
Lisez ensemble les colonnes de l'historique et les enregistrements détaillés.
sudo dnf history list tree
sudo dnf history info last
Cette installation a été enregistrée avec l'ID 6, et la réinstallation a été enregistrée avec l'ID 7. L'Action(s) pour la réinstallation était R et Modifié était 2, mais Réinstaller et Réinstallé dans la liste détaillée étaient des actions de remplacement du même paquet tree. Interpréter Modifié 2 comme signifiant que deux programmes différents ont été installés conduit à une conclusion incorrecte.
| Éléments à vérifier | Contenu à interpréter |
|---|---|
| ID · Ligne de commande · Heure | Quelle commande a été exécutée quand, et si elle correspond au changement actuellement examiné |
| Action(s) | Types d'actions effectuées telles que l'installation, la mise à niveau, la suppression, la réinstallation |
| Modifié · Symbole supplémentaire | Nombre d'actions de modification et indices de statut supplémentaires. Comparer avec la liste détaillée des paquets |
| Code de retour · Paquets modifiés | Statut résultant et les paquets effectivement modifiés · version · source |
| Sortie du scriptlet | Directives ou avertissements laissés par les scripts de paquets exécutés pendant l'installation ou la suppression |
La colonne * pour Modifié peut indiquer des transactions incomplètes, # indique des tâches qui se sont terminées dans un état non nul, et E peut indiquer une réussite mais avec des avertissements ou des messages d'erreur. Dans les historiques réels d'installation passés de la configuration EPEL, le marquage E était également visible, mais le code de retour détaillé était Succès et les instructions du script pouvaient être vérifiées. Ne concluez pas à un échec global de l'installation ou à une compromission sur la base d'un seul symbole.
Les indicateurs de l'état de la base de données comme < et > fournissent également des indices pour comparer les actions précédentes et suivantes ainsi que l'historique complet. Ne vous contentez pas de regarder la liste filtrée par nom de package ; si nécessaire, vérifiez l'ensemble de sudo dnf history list et les enregistrements détaillés pour l'ID concerné. Ne supposez pas que les commandes échouées soient enregistrées dans l'historique de la même manière que les transactions réussies ; les sorties d'erreur originales doivent également être conservées.
Annuler une transaction d'installation vérifiée
Cet exercice annule l’installation du seul paquet tree effectuée sur une VM qui ne possédait pas initialement le paquet tree. Créez également une note utilisateur unique pour vérifier si elle reste séparée de la tâche du package. Si un fichier portant le même nom existe, ne l'écrasez pas ; utilisez un chemin de pratique nouveau différent.
test ! -e ~/history-lab-note.txt && printf 'keep my notes\n' > ~/history-lab-note.txt
cat ~/history-lab-note.txt
sudo dnf history list tree
Dans la liste, trouvez la transaction ayant installé uniquement le paquet tree pour ce laboratoire. Utilisez son identifiant réel, pas la valeur d'exemple du laboratoire source de 6.
read -r -p 'Verified tree installation ID: ' TXID
if [[ "$TXID" =~ ^[1-9][0-9]*$ ]]; then
sudo dnf history info "$TXID"
sudo dnf --assumeno history undo "$TXID"
else
printf 'Enter a positive numeric transaction ID. Stop and check the history.\n' >&2
unset TXID
fi
Vérifiez si l'enregistrement détaillé montre l'installation prévue et uniquement le paquet tree à supprimer dans le plan de restauration. Il n'est pas approuvé si d'autres programmes ou paquets de configuration sont inclus, ou s'il s'agissait déjà du paquet tree déjà utilisé avant l’exercice. Le plan de restauration pour l'ID 6 de cette VM était Remove 1 Package et le paquet tree, et il a été appliqué après révision.
sudo dnf history undo "${TXID:?Read and verify a positive numeric transaction ID first}"
rpm -q tree
cat ~/history-lab-note.txt
sudo dnf history info last
sudo dnf check
Dans le résultat réel, le paquet tree est revenu à l’état désinstallé, et l'opération de restauration de l’ID 8 est restée en tant que Succès. La note utilisateur keep my notes est restée inchangée. C'est-à-dire que l'opération inverse de l'installation a été effectuée, mais les fichiers créés par l'utilisateur n'ont pas été restaurés dans le passé. Après vérification, seules les notes créées personnellement ont été organisées comme rm -- ~/history-lab-note.txt.
Le test source enregistré n'a annulé que l’installation vérifiée du seul paquet tree. Les paramètres EPEL précédents, les mises à jour du système d'exploitation et d'autres transactions n'ont pas été restaurés ensemble, et aucune restauration complète du serveur n'a été effectuée. En fait, les fichiers de dépôt existants, SSH, SELinux en mode Enforcing et le noyau en cours d'exécution le plus récent ont été préservés.
Distinguer la portée et les limites de récupération de l'annulation, de la réexécution et de la restauration.
| Tâches historiques | Portée et précautions |
|---|---|
history undo ID |
Tente l'action inverse des opérations incluses dans la transaction spécifiée. |
history redo ID |
Répète les actions de la transaction spécifiée dans l'état actuel. |
history rollback ID |
Puisqu'il s'agit de la portée du retour en arrière de plusieurs transactions après l'ID spécifié, son impact est plus large que l'annulation d'une seule action. |
Les commandes d'historique sont limitées par l'état actuel de l'installation et la disponibilité des packages. Si la version à ce moment-là a disparu du dépôt ou si les dépendances ont changé, il peut ne pas être possible de revenir en arrière. Le simple fait qu'un ancien ID DNF existe ne signifie pas que les RPM et les données de service nécessaires à la restauration sont conservés.
Les modifications externes effectuées par les scripts de package, les schémas de base de données, les données des utilisateurs et les configurations directement modifiées doivent être gérées à travers les procédures de récupération et les sauvegardes de l'application. En particulier, avant de revenir à une version unique d'un package OS de base ou d'une mise à jour à grande échelle, examinez les méthodes de récupération prises en charge et les impacts potentiels. Le succès limité d'une annulation de package dans cet exercice ne garantit pas la récupération sur tous les serveurs.
Les critères de complétion pour la résolution des problèmes ne se limitent pas à savoir si le message d'erreur a disparu. Vous devez vérifier si le paquet, la version, le fichier et l'état des dépendances prévus sont corrects, si les services et les données affectés sont normaux, et enregistrer les changements qui ont réellement été effectués.




