Tutorial Rocky Linux 10 / Mendiagnosis kesalahan paket dan menggunakan riwayat DNF

Kesalahan paket di Rocky Linux 10 harus diselesaikan setelah membedakan antara masalah dengan nama, repositori, metadata, dependensi, dan file instalasi. Riwayat DNF digunakan untuk menyelidiki apa yang telah berubah dan untuk membalikkan operasi paket tertentu, tetapi itu bukan cadangan yang mengembalikan data pengguna atau seluruh server ke keadaan sebelumnya.

Kumpulkan pesan kesalahan dan status saat ini terlebih dahulu

Ketika terjadi kesalahan, catat perintah yang awalnya dijalankan sebelum mengulanginya atau menambahkan opsi paksa, pesan kesalahan lengkap, status keluar, dan status instalasi saat ini. Jika koneksi SSH terputus di tengah jalan, pemasangan paket sebenarnya mungkin sudah selesai, jadi periksa terlebih dahulu status yang tersimpan.

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

DNF (Dandified YUM) adalah alat untuk mengelola paket dan dependensi di repositori, sedangkan RPM (RPM Package Manager) adalah alat dasar untuk mengelola informasi dan berkas paket yang terpasang. Lingkungan lab sumber yang tercatat adalah Rocky Linux 10.2, DNF 4.20.0, dan RPM 4.19.1.1. Repositori default digunakan pada mesin virtual (VM) khusus, dan tree tidak diinstal pada awalnya. dnf check memeriksa masalah konsistensi seperti dependensi dari paket yang terpasang, dan fakta bahwa tidak ada keluaran tidak berarti semua layanan atau data pengguna telah diperiksa.

Petunjuk representatif Masalah untuk dibedakan terlebih dahulu
Tidak ada kecocokan untuk argumen Apakah nama, versi, dan arsitektur sudah benar, dan apakah repositori yang diperlukan menyediakannya
Kesalahan metadata, cermin, atau resolusi nama Status jaringan, DNS, waktu, proxy, cache, dan repositori
Tidak ada yang menyediakan, permintaan yang bertentangan Dependensi yang diperlukan, versi yang saat ini terinstal, kombinasi repositori
Kesalahan kunci tanda tangan atau sertifikat Sumber yang akurat dan kunci resmi·waktu sistem·verifikasi sertifikat
File eksekusi atau dokumen yang hilang Status instalasi·hubungan kepemilikan paket·perbedaan file aktual

Jika terjadi kesalahan penguncian operasi (lock), periksa terlebih dahulu apakah ada operasi DNF·RPM lain atau pembaruan otomatis yang sedang berjalan dan tunggu hingga selesai. Jangan langsung menghapus file penguncian atau basis data RPM secara sembarangan atau memaksa menghentikan operasi normal sebagai solusi pertama.

Pisahkan kesalahan nama dan masalah repository·dependensi

Di laboratorium sumber, kueri yang disengaja menggunakan nama paket praktik yang tidak ada untuk mereproduksi kesalahan berikut. --assumeno tidak disetujui untuk instalasi.

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

Pada titik ini, status keluar adalah 1. Periksa nama paket yang sebenarnya dan sumber sesuai dengan kesalahan.

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

Dalam lingkungan yang sama, tree dikonfirmasi sebagai kandidat untuk 2.1.0-8.el10.x86_64 di BaseOS, dan ada satu rencana instalasi. Perbandingan ini adalah tes untuk membedakan antara nama yang digunakan secara salah dan kandidat normal. Jika paket yang diperlukan hanya ada di repositori tambahan, gunakan panduan repositori CRB dan EPEL untuk memeriksa perannya, status diaktifkan, dan kombinasi yang didukung. Hanya dengan memperbaiki nama tidak menyelesaikan semua konflik dependensi.

Untuk nothing provides, identifikasi pustaka atau kemampuan yang hilang dan paket yang membutuhkannya. Periksa rilis utama OS, kompatibilitas repositori, dan kandidat yang bertentangan. Jangan mengabaikan dependensi dengan opsi RPM --nodeps. Jangan nonaktifkan verifikasi tanda tangan atau menerapkan opsi DNF --allowerasing tanpa meninjau dampaknya. Tinjau setiap penghapusan yang diusulkan dan layanan yang terpengaruh sebelum menyetujui solusi.

Terapkan pembersihan cache sesuai dengan penyebab yang telah Anda identifikasi.

Jika daftar sudah lama atau tidak dapat dikueri karena batasan cache, periksa kembali metadata dari repositori saat ini terlebih dahulu.

sudo dnf --refresh info tree

Dalam latihan pencarian paket , kueri gagal karena metadata daftar file yang diperlukan dnf -C provides belum tersimpan di cache. Setelah opsi -C dihilangkan dan kueri biasa dijalankan, informasi yang dibutuhkan berhasil diperoleh. Kegagalan kueri hanya-cache berbeda dari tidak tersedianya paket di repositori.

Lihat referensi perintah resmi DNF : clean expire-cache menandai metadata cache sebagai kedaluwarsa agar divalidasi ulang, clean metadata menghapus metadata sehingga dapat diunduh lagi, dan clean all membersihkan beberapa jenis cache sekaligus. Membersihkan seluruh cache setiap saat dapat menambah unduhan tanpa menyelesaikan penyebab masalah.

Jika terdeteksi korupsi metadata dan perlu dilakukan pembersihan, pilih rentang yang diperlukan seperti re-query dari sudo dnf clean metadata dan repositori normal. Dalam latihan ini, cache normal dibiarkan utuh; verifikasi repositori dan sertifikat juga tidak dilemahkan.

Temukan file yang hilang dengan RPM dan pulihkan melalui reinstalasi.

Menanyakan pemilik dan memverifikasi file instalasi adalah tugas yang berbeda. rpm -qf menemukan paket pemilik, sementara rpm -V membandingkan atribut yang tercatat dalam basis data instalasi dengan file saat ini. Makna juga dapat dikonfirmasi di referensi perintah resmi RPM , dan langkah-langkah berikut telah diuji pada RPM 4.19.1.1 di VM ini.

Reproduksi berikut hanya dilakukan pada VM khusus tanpa data kerja. Jangan sengaja memindahkan file pada server yang sudah menggunakan tree untuk meniru kegagalan ini. Pertama, tinjau rencana instalasi, pasang tree, dan catat ID transaksi instalasi yang sebenarnya.

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

ID instalasi pada VM ini untuk sesi ini adalah 6, dan satu tree telah dipasang. ID berbeda pada komputer lain. Reproduksi di bawah ini hanya memindahkan satu dokumen README yang termasuk dalam paket ini, bukan file eksekusi atau pengaturan layanan. Jika itu bukan versi, dokumen, atau lokasi backup baru yang diharapkan, hentikan sebelum membuat perubahan.

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

Jika versi Anda berbeda atau folder cadangan sudah ada, pemeriksaan kondisi di atas tidak dihapus untuk memaksa lolos. Verifikasi jalur file dan status persiapan latihan lagi. Di VM ini, hasil berikut dan status keluar 1 telah dikonfirmasi.

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

missing berarti file yang tercatat dalam paket tidak ditemukan, dan d menunjukkan file dokumen. rpm -V hanya melaporkan masalah dan tidak mengembalikan konten dokumen ini. Periksa apakah perubahan atau penghapusan aktual dimaksudkan, lalu baca rencana penginstalan ulang.

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

Praktik ini menginstal kembali versi tree BaseOS yang sama. Dokumen yang dipulihkan identik dengan cadangan, cmp berakhir tanpa perbedaan, dan verifikasi RPM juga kembali 0 tanpa output. Untuk menginstal ulang, Anda harus mendapatkan RPM versi yang persis sama yang saat ini terinstal dari sumber. File konfigurasi dapat ditangani secara terpisah sesuai dengan kebijakan penggantian paket, sehingga perintah yang selalu menimpa pengaturan operasional dengan versi aslinya tidak digeneralisasikan.

Jika instalasi ulang gagal dan dokumen masih hilang, Anda dapat menyalin cadangan /root/lf-course-12-before/tree-README yang dibuat dalam praktik ini ke jalur asli /usr/share/doc/tree/README sambil mempertahankan atribut dan memverifikasi lagi. Bahkan dalam kasus ini, pertama-tama periksa apakah target benar-benar hilang untuk menghindari menimpa perubahan lain. Karena pemulihan aktual dalam contoh ini berhasil, jalur untuk menyalin kembali cadangan tidak dijalankan.

Baca kolom sejarah dan catatan rinci secara bersamaan.

sudo dnf history list tree
sudo dnf history info last

Instalasi ini dicatat dengan ID 6, dan pemasangan ulang dicatat dengan ID 7. Tindakan untuk pemasangan ulang adalah R dan Diubah adalah 2, tetapi Pemasangan Ulang dan Telah Dipasang Ulang dalam daftar rinci adalah tindakan penggantian dari paket tree yang sama. Menafsirkan Diubah 2 sebagai makna bahwa dua program berbeda diinstal mengarah pada kesimpulan yang salah.

Item untuk Diperiksa Konten untuk Ditafsirkan
ID · Baris perintah · Waktu Perintah mana yang dieksekusi kapan, dan apakah itu cocok dengan perubahan yang sedang diselidiki saat ini
Tindakan Jenis tindakan yang dilakukan seperti instalasi, peningkatan, penghapusan, pemasangan ulang
Diubah · Simbol Tambahan Jumlah tindakan perubahan dan petunjuk status tambahan. Bandingkan dengan daftar paket rinci
Kode-Kembali · Paket Diubah Status yang dihasilkan dan paket yang benar-benar berubah · versi · sumber
Output skrip kecil Panduan atau peringatan yang ditinggalkan oleh skrip paket yang dijalankan selama instalasi atau penghapusan

Kolom * untuk Altered mungkin menunjukkan transaksi yang tidak lengkap, # menunjukkan tugas yang berakhir dalam keadaan non-zero, dan E mungkin menunjukkan penyelesaian yang berhasil tetapi dengan peringatan atau output kesalahan. Dalam sejarah instalasi EPEL yang nyata sebelumnya, tanda E juga terlihat, tetapi Return-Code rinci adalah Sukses dan panduan skrip dapat diperiksa. Jangan menyimpulkan kegagalan instalasi secara keseluruhan atau kompromi hanya berdasarkan satu simbol.

Indikator status database seperti < dan > juga memberikan petunjuk untuk membandingkan tindakan sebelumnya dan selanjutnya serta riwayat lengkap. Jangan hanya melihat daftar yang difilter berdasarkan nama paket; jika perlu, periksa seluruh sudo dnf history list dan catatan rinci untuk ID yang relevan. Jangan beranggapan bahwa perintah yang gagal dicatat dalam sejarah dengan cara yang sama seperti transaksi yang berhasil; keluaran kesalahan asli juga harus disimpan.

Batalkan satu transaksi instalasi yang telah diverifikasi

Latihan ini membatalkan instalasi dari satu tree yang dilakukan pada VM yang awalnya tidak memiliki tree. Juga, buat satu catatan pengguna untuk memeriksa apakah tetap terpisah dari tugas paket. Jika ada file dengan nama yang sama, jangan menimpanya; gunakan jalur praktik baru yang berbeda.

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

Dalam daftar, temukan transaksi pemasangan tree mandiri untuk lab ini. Gunakan ID sebenarnya, bukan nilai contoh lab sumber 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

Periksa apakah catatan rinci menunjukkan pemasangan yang dimaksud dan hanya tree yang akan dihapus dalam rencana rollback. Tidak disetujui jika program lain atau paket konfigurasi disertakan, atau jika itu adalah tree yang sudah digunakan sebelum latihan. Rencana rollback untuk ID 6 dari VM ini adalah Remove 1 Package dan tree, dan itu diterapkan setelah ditinjau.

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

Dalam hasil sebenarnya, tree kembali ke keadaan tidak terinstal, dan operasi rollback dari ID 8 tetap Berhasil. Catatan pengguna keep my notes tetap tidak berubah. Artinya, operasi balik dari pemasangan dilakukan, tetapi file yang dibuat pengguna tidak dikembalikan ke masa lalu. Setelah diperiksa, hanya catatan yang dibuat secara pribadi yang disusun sebagai rm -- ~/history-lab-note.txt.

Tes sumber yang tercatat hanya membatalkan instalasi tree paket tunggal yang telah diverifikasi. Pengaturan EPEL sebelumnya, pembaruan OS, dan transaksi lainnya tidak dikembalikan bersama, juga tidak dilakukan rollback server penuh. Faktanya, file repository yang ada, SSH, SELinux Enforcing, dan kernel terbaru yang berjalan tetap dipertahankan.

Bedakan lingkup dan batas pemulihan dari undo, redo, dan rollback.

Tugas sejarah Ruang lingkup dan tindakan pencegahan
history undo ID Mencoba tindakan kebalikan dari operasi yang termasuk dalam transaksi yang ditentukan.
history redo ID Mencoba kembali tindakan dari transaksi yang ditentukan dalam keadaan saat ini.
history rollback ID Karena ini adalah ruang lingkup untuk mengembalikan beberapa transaksi setelah ID yang ditentukan, dampaknya lebih luas daripada membatalkan satu tindakan saja.

Perintah histori dibatasi oleh kondisi instalasi saat ini dan ketersediaan paket. Jika versi pada saat itu telah hilang dari repositori atau dependensi telah berubah, mungkin tidak memungkinkan untuk mengembalikannya. Fakta bahwa ID DNF lama ada tidak berarti bahwa RPM dan data layanan yang dibutuhkan untuk pemulihan tetap terjaga.

Perubahan eksternal yang dibuat oleh skrip paket, skema database, data pengguna, dan konfigurasi yang dimodifikasi secara langsung harus ditangani melalui prosedur pemulihan aplikasi dan cadangan. Secara khusus, sebelum mengembalikan paket inti OS atau pembaruan skala besar ke satu nomor versi, tinjau metode pemulihan yang didukung dan potensi dampaknya. Undo paket kecil yang berhasil dalam latihan ini tidak menjamin pemulihan di semua server.

Kriteria penyelesaian untuk pemecahan masalah tidak berhenti pada apakah pesan kesalahan telah hilang. Anda perlu memeriksa apakah paket, versi, file, dan status ketergantungan yang dimaksud sudah benar, apakah layanan dan data yang terdampak normal, dan mencatat perubahan apa saja yang benar-benar dilakukan.