Rocky Linux 10: tutorial / Diagnosticar fallos de paquetes y usar reinstalación e historial de DNF

Los errores de paquetes en Rocky Linux 10 deben resolverse después de distinguir entre problemas con nombres, repositorios, metadatos, dependencias y archivos de instalación. El historial de DNF se usa para investigar qué ha cambiado y para revertir operaciones de paquetes específicas, pero no es una copia de seguridad que restaure los datos del usuario o todo el servidor a un estado anterior.

Primero recopile los mensajes de error y el estado actual

Cuando ocurra un error, registre el comando ejecutado inicialmente antes de repetirlo o agregar opciones forzadas, el mensaje de error completo, el estado de salida y el estado actual de la instalación. Si la conexión SSH se desconectó a mitad de camino, la instalación del paquete puede haberse completado, así que primero verifique el estado guardado.

cat /etc/rocky-release
dnf --version
rpm -q tree
dnf repolist --enabled
sudo dnf history list
sudo dnf check

DNF (Dandified YUM) es una herramienta para gestionar paquetes y dependencias en repositorios, mientras que RPM (RPM Package Manager) es una herramienta fundamental para gestionar información y archivos de paquetes instalados. El entorno de laboratorio de origen registrado era Rocky Linux 10.2, DNF 4.20.0 y RPM 4.19.1.1. Se utilizó el repositorio predeterminado en una máquina virtual (VM) dedicada, y tree no estaba instalado al inicio. dnf check verifica problemas de consistencia como las dependencias de los paquetes instalados, y el hecho de que no haya salida no significa que todos los servicios o datos de los usuarios hayan sido inspeccionados.

Pistas representativas Problemas a distinguir primero
No hay coincidencia para el argumento Si el nombre, la versión y la arquitectura son correctos, y si el repositorio requerido los proporciona
Errores de metadatos, espejo o resolución de nombres Red, DNS, hora, proxy, caché y estado del repositorio
Nada proporciona, solicitudes conflictivas Dependencias requeridas, versiones actualmente instaladas, combinaciones de repositorios
Errores de clave de firma o certificado Fuente precisa y clave oficial·hora del sistema·verificación de certificado
Archivos ejecutables o documentos faltantes Estado de instalación·relaciones de propiedad del paquete·diferencias reales de archivos

Si se trata de un error de bloqueo, primero verifique si otra operación DNF·RPM o una actualización automática se está ejecutando y espere a que termine. No haga que eliminar archivos de bloqueo·base de datos RPM o terminar operaciones normales de manera arbitraria o forzada sea la primera solución.

Separe los errores de nombre y los problemas de repositorio·dependencias

En el laboratorio de origen, una consulta deliberada utilizó un nombre de paquete de práctica inexistente para reproducir el siguiente error. --assumeno impide aprobar una instalación en esta comprobación.

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

En este punto, el estado de salida era 1. Verifique el nombre real del paquete y la fuente según el error.

dnf search tree
dnf info tree
dnf provides /usr/bin/tree
dnf repoquery --requires --resolve tree
sudo dnf --assumeno install tree

En el mismo entorno, se confirmó que tree era un candidato para 2.1.0-8.el10.x86_64 en BaseOS, y había un plan de instalación. Esta comparación es una prueba para distinguir entre nombres usados incorrectamente y candidatos normales. Si el paquete requerido existe solo en un repositorio adicional, utilice la guía de repositorios y EPEL para verificar su función, estado habilitado y combinaciones compatibles. Simplemente corregir el nombre no resuelve todos los conflictos de dependencias.

Para nothing provides, identifique la biblioteca o capacidad que falta y el paquete que la requiere. Verifique la versión principal del sistema operativo, la compatibilidad del repositorio y los candidatos en conflicto. No omita dependencias usando la opción --nodeps de RPM. Tampoco desactive la comprobación de firmas ni aplique --allowerasing de DNF sin revisar todas las eliminaciones y sus consecuencias. Revise cada eliminación propuesta y los servicios afectados antes de aprobar una solución.

Aplique la limpieza de caché de acuerdo con la causa que haya identificado.

Si la lista es antigua o no se puede consultar debido a los límites de la caché, primero vuelva a verificar los metadatos del repositorio actual.

sudo dnf --refresh info tree

En el ejercicio de búsqueda de paquetes, la consulta dnf -C provides falló porque faltaban los metadatos de la lista de archivos en la caché. Al quitar -C y consultar normalmente el repositorio, se obtuvo la información necesaria. Un fallo de consulta que usa solo la caché no equivale a la ausencia del paquete en el repositorio.

La referencia oficial de DNF distingue los alcances: clean expire-cache marca los metadatos para volver a validarlos, clean metadata los elimina para descargarlos de nuevo y clean all limpia varias cachés. Borrar todo en cada fallo puede limitarse a aumentar las descargas sin resolver la causa.

Si se detecta corrupción de metadatos y es necesaria la limpieza, seleccione el rango requerido como una nueva consulta de sudo dnf clean metadata y un repositorio normal. Para la práctica en este artículo, la caché normal no se eliminó intencionalmente, ni se debilitaron las verificaciones de repositorio o certificado.

Encuentre archivos faltantes con RPM y recupérelos mediante la reinstalación.

Consultar al propietario y verificar los archivos de instalación son tareas diferentes. rpm -qf encuentra el paquete propietario, mientras que rpm -V compara los atributos registrados en la base de datos de instalación con los archivos actuales. El significado también puede confirmarse en Referencia oficial de comandos RPM , y los pasos a continuación fueron probados en RPM 4.19.1.1 en esta VM.

La siguiente reproducción se realiza únicamente en una VM dedicada sin datos de trabajo. Los archivos no se mueven deliberadamente en servidores que ya usan tree. Primero, revise el plan de instalación, instale tree y registre el ID de transacción de instalación real.

sudo dnf --assumeno install tree
sudo dnf install tree
sudo dnf history info last
rpm -qf /usr/share/doc/tree/README
rpm -V tree

El ID de instalación en esta VM para esta sesión fue 6, y se instaló el paquete tree. Los ID difieren en otras computadoras. La reproducción a continuación mueve solo un documento README perteneciente a este paquete en lugar de archivos ejecutables o configuraciones de servicio. Si no es la versión esperada, el documento, o la nueva ubicación de respaldo, deténgase antes de realizar cambios.

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 su versión es diferente o ya existe una carpeta de respaldo, las comprobaciones de condición anteriores no se eliminan para forzar un paso. Verifique nuevamente la ruta del archivo y el estado de preparación de la práctica. En esta VM, se confirmaron los siguientes resultados y el estado de salida 1.

missing   d /usr/share/doc/tree/README

missing significa que falta un archivo que el paquete tiene registrado, y d indica un archivo de documento. rpm -V solo informa el problema y no restaura el contenido de este documento. Verifique si los cambios o omisiones reales fueron intencionados, y luego lea el plan de reinstalación.

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' "$?"

En la prueba original se reinstaló la misma versión del paquete tree desde BaseOS. Los documentos recuperados eran idénticos a la copia de seguridad, cmp terminó sin ninguna diferencia, y la verificación de RPM también devolvió 0 sin salida. Para reinstalar, debe obtener el RPM de la versión exacta actualmente instalada desde la fuente. Los archivos de configuración pueden manejarse por separado según la política de reemplazo de paquetes, por lo que los comandos que siempre sobrescriben la configuración operativa con los originales no son generalizados.

Si la reinstalación falla y el documento sigue faltando, puede copiar la copia de seguridad /root/lf-course-12-before/tree-README hecha en esta práctica a la ruta original /usr/share/doc/tree/README conservando los atributos y verificar nuevamente. Incluso en este caso, primero verifique si el objetivo realmente falta para evitar sobrescribir otros cambios. Dado que la recuperación real en este caso fue exitosa, no se ejecutó la ruta para volver a copiar la copia de seguridad.

Lea las columnas de historial y los registros detallados juntos.

sudo dnf history list tree
sudo dnf history info last

Esta instalación se registró con ID 6, y la reinstalación se registró con ID 7. La(s) Acción(es) para la reinstalación fue R y Alterado fue 2, pero Reinstalar y Reinstalado en la lista detallada fueron acciones de reemplazo del mismo paquete tree. Interpretar Alterado 2 como que se instalaron dos programas diferentes conduce a una conclusión incorrecta.

Elementos a Verificar Contenido a Interpretar
ID · Línea de comando · Hora Qué comando se ejecutó en qué momento y si coincide con el cambio que actualmente se está investigando
Acción(es) Tipos de acciones realizadas como instalación, actualización, eliminación, reinstalación
Alterado · Símbolo adicional Número de acciones de cambio y pistas de estado adicionales. Comparar con la lista detallada de paquetes
Código de retorno · Paquetes alterados Estado resultante y los paquetes realmente cambiados · versión · fuente
Salida del scriptlet Orientaciones o advertencias dejadas por los scripts de paquetes ejecutados durante la instalación o eliminación

La columna * para Altered puede indicar transacciones incompletas, # indica tareas que terminaron en un estado distinto de cero, y E puede indicar finalización exitosa pero con advertencias o salidas de error. En historiales reales de instalaciones pasadas de la configuración de EPEL, la marca E también era visible, pero el Código de Retorno detallado era Éxito y se podía verificar la guía del script. No se debe concluir fallo general de la instalación o compromiso basado en un solo símbolo.

Los indicadores de estado de la base de datos como < y > también proporcionan pistas para comparar acciones previas y posteriores y el historial completo. No se limite a mirar la lista filtrada por nombre de paquete; si es necesario, revise todo el sudo dnf history list y los registros detallados para el ID relevante. No asuma que los comandos fallidos se registran en el historial de la misma manera que las transacciones exitosas; los resultados de error originales también deben conservarse.

Deshacer una transacción de instalación verificada

Este ejercicio revierte únicamente la instalación de tree en una VM donde el paquete no estaba instalado al principio. Además, cree una nota de usuario para verificar si permanece separada de la tarea del paquete. Si existe un archivo con el mismo nombre, no lo sobrescriba; utilice una ruta de práctica nueva diferente.

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

En la lista, encuentre la transacción independiente de instalación de tree para este laboratorio. Use su ID real, no el valor de ejemplo del laboratorio de origen 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

Verifique si el registro detallado muestra la instalación prevista y solo el paquete tree que se eliminará en el plan de reversión. No está aprobado si se incluyen otros programas o paquetes de configuración, o si era un paquete tree que ya se utilizaba antes de la práctica. El plan de reversión para el ID 6 de esta VM fue Remove 1 Package y tree, y se aplicó después de la revisión.

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

En el resultado real, tree volvió al estado no instalado, y la operación de reversión del ID 8 permaneció como Éxito. La nota del usuario keep my notes permaneció sin cambios. Es decir, se realizó la operación inversa de la instalación, pero los archivos creados por el usuario no se revirtieron al pasado. Después de verificar, solo las notas creadas personalmente se eliminaron con rm -- ~/history-lab-note.txt.

La prueba de fuente registrada deshizo únicamente la instalación verificada de un único paquete, tree. La configuración previa de EPEL, las actualizaciones del SO y otras transacciones no se revirtieron conjuntamente, ni se realizó una reversión completa del servidor. De hecho, se conservaron los archivos existentes del repositorio, SSH, SELinux Enforcing y el kernel más reciente en ejecución.

Distinguir el alcance y los límites de recuperación de deshacer, rehacer y reversión.

Tareas de historial Alcance y Precauciones
history undo ID Intenta la acción inversa de las operaciones incluidas en la transacción especificada.
history redo ID Reintenta las acciones de la transacción especificada en el estado actual.
history rollback ID Dado que este es el alcance de revertir múltiples transacciones después del ID especificado, su impacto es más amplio que deshacer una sola acción.

Los comandos de historial están limitados por el estado actual de la instalación y la disponibilidad de los paquetes. Si la versión en ese momento ha desaparecido del repositorio o las dependencias han cambiado, puede que no sea posible revertir. El mero hecho de que exista un ID antiguo de DNF no significa que los RPM y los datos de servicio necesarios para la restauración estén preservados.

Los cambios externos realizados por los scripts de paquetes, esquemas de bases de datos, datos de usuarios y configuraciones modificadas directamente deben manejarse mediante los procedimientos de recuperación de la aplicación y las copias de seguridad. Particularmente, antes de revertir un paquete principal del sistema operativo o una actualización a gran escala a un único número de versión, revise los métodos de recuperación soportados y los impactos potenciales. Un pequeño deshacer exitoso de un paquete en este ejercicio no garantiza la recuperación en todos los servidores.

Los criterios de finalización para la resolución de problemas no se detienen en si el mensaje de error ha desaparecido. Necesita verificar si el paquete, la versión, el archivo y el estado de las dependencias son correctos, si los servicios y datos afectados están normales, y registrar qué cambios se realizaron realmente.