View source for Linux : Praktikum Audit Repositori dan Diagnosa Instalasi Paket Gagal

Artikel pagi sudah menjelaskan empat lapis: repositori menyimpan, indeks mencatat, <code>apt</code> memilih, <code>dpkg</code> memasang. Sekarang giliran membuktikan keempat lapis itu benar-benar bekerja di mesinmu.

== 🎯 Tujuan ==

Setelah menyelesaikan praktikum ini, kamu bisa:

* Menjelaskan lima lapis bukti yang harus dilewati satu paket sebelum benar-benar terpasang.
* Mengaudit sumber repositori di mesin Debian tanpa menebak-nebak.
* Membaca status paket yang tidak selesai dipasang dan memulihkannya.
* Membuat kerusakan kecil yang terkendali, lalu menemukan lapis mana yang gagal.
* Mengubah hasil audit jadi laporan singkat: apa yang salah, di lapis mana, dan perintah apa yang memperbaikinya.

== 📍 Konteks nyata ==

Bayangkan mekanik di bengkel. Artikel pagi membahas gudang spare part, katalog, dan pemasang part. Sekarang kamu jadi '''orang yang memeriksa kertas kerja bengkel''': apakah katalog yang dipakai memang edisi terbaru, apakah nomor part yang dicari memang ada di gudang, dan apakah part yang terpasang benar-benar sudah dikunci.

Di lab sekolah, pekerjaan ini yang paling sering terlewat. Komputer terlihat normal, <code>apt update</code> selesai tanpa layar merah, lalu tiba-tiba paket yang dicari "tidak ada" padahal gurunya yakin nama paketnya benar.

🔥 '''Kasus nyata:''' Lab TKJ sebuah SMK memasang aplikasi praktikum di 30 PC. Petugas lab menjalankan <code>apt update</code>, melihat proses selesai, lalu lanjut <code>apt install</code>. Dua belas PC dapat versi lama, delapan belas dapat versi baru. Saat ujian praktik, menu aplikasi berbeda antar PC dan siswa panik. Penyebabnya baru ketahuan setelah satu jam: satu baris di <code>sources.list.d</code> menunjuk repo internal yang sudah dipindah, dan <code>apt update</code> tetap selesai tanpa berhenti. Indeks lama di <code>/var/lib/apt/lists</code> dipakai diam-diam.

Tesis praktikum sore ini: '''selesai belum berarti benar'''. Perintah yang tidak berhenti dengan error belum tentu menghasilkan katalog yang sehat. Yang bisa dipercaya hanya bukti yang kamu lihat sendiri di lima titik pemeriksaan.

== 🧠 Konsep singkat ==

Satu paket harus melewati lima lapis sebelum berubah jadi baris <code>ii</code> di <code>dpkg -l</code>. Setiap lapis bisa gagal sendiri-sendiri, dan gejalanya sering mirip.

{| class="wikitable"
! Lapis !! Pertanyaan kunci !! Bukti utama
|-
| 1. Sumber || File mana yang benar-benar dibaca APT? || pesan <code>Ign</code> dan <code>Err</code>
|-
| 2. Indeks || Katalog lokal masih segar dan lengkap? || isi <code>/var/lib/apt/lists/</code>
|-
| 3. Pemilihan || Versi mana yang jadi kandidat, dari repo mana? || <code>apt-cache policy</code>
|-
| 4. Unduh dan tanda tangan || Berkasnya asli dan utuh? || pesan <code>NO_PUBKEY</code>
|-
| 5. Pemasangan || <code>dpkg</code> selesai mengonfigurasi? || status <code>ii</code>, <code>iU</code>, atau <code>iF</code>
|}

Aturan kerja yang menghemat waktu: '''berhenti di lapis pertama yang gagal'''. Kalau lapis 1 sudah salah, mengutak-atik <code>dpkg</code> hanya menambah kerusakan baru.

💡 '''Tips:''' selalu baca keluaran <code>apt update</code> sampai baris terakhir. Baris <code>Err</code>, <code>Ign</code>, dan <code>W:</code> adalah tempat kerusakan bersembunyi, bukan di awal output.

=== 🔹 Tiga fakta yang menyelamatkan waktu ===

* '''Status keluar bisa menipu.''' Di banyak versi APT, <code>apt-get update</code> tetap keluar dengan status 0 walau ada baris <code>E: Some index files failed to download</code>. Skrip <code>apt update &amp;&amp; apt upgrade -y</code> pun lanjut seolah tidak terjadi apa-apa.
* '''Kandidat dibaca dari katalog lokal.''' <code>apt install</code> tidak menanyakan versi ke internet saat itu juga. Kalau indeks basi, kamu memasang versi basi walau repo sudah punya versi baru.
* '''Satu paket setengah jadi menahan semuanya.''' Selama ada paket berstatus <code>iU</code> atau <code>iF</code>, APT menolak menyelesaikan instalasi lain sampai masalah itu dibereskan.

== 🧩 Istilah penting ==

{| class="wikitable"
! Istilah !! Arti sederhana
|-
| Suite || Nama edisi repo, mis. <code>bookworm</code> atau <code>trixie</code>
|-
| Component || Bagian isi repo: <code>main</code>, <code>contrib</code>, <code>non-free</code>
|-
| Indeks || Katalog hasil unduhan <code>apt update</code>, disimpan di <code>/var/lib/apt/lists</code>
|-
| Candidate || Versi yang akan dipasang kalau kamu mengetik <code>apt install</code>
|-
| Pin priority || Angka yang menentukan repo atau versi mana yang dipilih APT
|-
| Hold || Penanda agar paket tidak ikut naik versi otomatis
|-
| <code>ii</code> || Paket terpasang dan sudah dikonfigurasi, artinya sehat
|-
| <code>iU</code> || Berkas sudah dibuka, konfigurasi belum selesai
|-
| <code>iF</code> || Konfigurasi sudah jalan tetapi gagal di tengah
|-
| <code>rc</code> || Paket dihapus, file konfigurasinya masih tertinggal
|}

📊 '''Angka penting:''' indeks paket Debian 12 untuk satu arsitektur bisa mencapai 10–16 MB per suite. Itu sebabnya <code>apt update</code> butuh waktu, dan sebabnya indeks lama masih bisa "menyelamatkan" perintah yang gagal sekaligus menyesatkan.

== 🔧 Praktik: audit lima lapis dan delapan uji rusak ==

=== 🔹 Siapkan lab dan aturan main ===

Gunakan mesin virtual Debian 12 atau 13, bukan server produksi. Ambil snapshot dulu supaya kamu bisa kembali kapan saja.

# '''Snapshot dulu.''' Praktikum ini sengaja merusak konfigurasi repo.
# '''Satu perubahan, satu bukti.''' Catat perintah dan keluarannya ke folder kerja.
# '''Selalu pulihkan''' sebelum lanjut ke uji berikutnya.
# '''Jangan pakai <code>trusted=yes</code>''' hanya agar praktikum cepat selesai, karena itu mematikan pemeriksaan tanda tangan.

<syntaxhighlight lang="text">
mkdir -p ~/lab-paket
cd ~/lab-paket
</syntaxhighlight>

=== 🔹 Langkah 1: rekam kondisi awal ===

Baseline adalah foto sebelum kerusakan. Tanpa baseline, kamu tidak bisa membedakan "memang begitu dari awal" dan "baru rusak gara-gara praktikum".

<syntaxhighlight lang="text">
cat /etc/os-release
dpkg --print-architecture
grep -rhE '^(deb|Types:)' /etc/apt/sources.list /etc/apt/sources.list.d/ 2>/dev/null | sort
sudo apt-get update 2>&1 | tee baseline-update.log | tail -n 15
apt-cache policy | head -n 20
apt-get check 2>&1 | tail -n 3
dpkg --audit
apt-mark showhold
ls -lh /var/lib/apt/lists/ | head -n 10
</syntaxhighlight>

Yang perlu kamu catat: jumlah baris sumber, suite yang dipakai, arsitektur, dan jam berkas indeks. Tiga data terakhir jadi pembanding di semua uji berikutnya.

💡 '''Tips:''' kalau keluaran <code>apt-get check</code> bersih dan <code>dpkg --audit</code> kosong, mesinmu sedang sehat. Itu titik nol yang sah untuk praktikum.

=== 🔹 Langkah 2: bukti lima lapis dalam satu putaran ===

Pasang satu paket kecil sambil memperhatikan tiap lapis. Contoh di sini <code>cowsay</code>, paket kecil yang aman dipasang dan dihapus.

<syntaxhighlight lang="text">
apt-cache policy cowsay
sudo apt-get install -y cowsay 2>&1 | tee install-cowsay.log
dpkg -l cowsay
dpkg -S /usr/games/cowsay
tail -n 5 /var/log/apt/history.log
</syntaxhighlight>

Urutan berpikirnya:

# <code>apt-cache policy</code> menunjukkan lapis 3: candidate, versi terpasang, dan repo asal.
# Baris <code>Get:</code> di log menunjukkan lapis 4: berkas diunduh dan diverifikasi.
# <code>dpkg -l</code> menunjukkan lapis 5: status harus <code>ii</code>.
# <code>dpkg -S</code> membuktikan file itu memang milik paket tersebut, bukan sisa paket lain.
# <code>/var/log/apt/history.log</code> mencatat siapa mengubah apa dan kapan.

🧪 '''Uji cepat:''' <code>dpkg -l | grep -v '^ii'</code> menampilkan semua paket yang tidak berstatus sehat. Kalau hasilnya hanya <code>rc</code> yang kamu sengaja tinggalkan, mesinmu bersih.

=== 🔹 Langkah 3: uji A, suite salah ketik ===

Ubah suite di satu file sumber dari <code>bookworm</code> menjadi <code>bookworm-lama</code>.

<syntaxhighlight lang="text">
sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
sudo sed -i 's/ bookworm / bookworm-lama /' /etc/apt/sources.list
sudo apt-get update 2>&1 | tail -n 8
apt-cache policy bash
</syntaxhighlight>

Gejala yang muncul: baris <code>E: The repository ... does not have a Release file</code> dan peringatan bahwa repo seperti itu tidak bisa dipakai dengan aman. Kandidat untuk <code>bash</code> bisa tetap ada karena repo lain masih sehat, tetapi paket yang hanya ada di repo rusak akan hilang.

Arti: kerusakan ada di lapis 1. <code>dpkg</code> sama sekali belum tersentuh. Pulihkan dengan <code>sudo cp /etc/apt/sources.list.bak /etc/apt/sources.list</code>.

=== 🔹 Langkah 4: uji B, component kurang ===

Hapus satu component dari baris repo, misalnya <code>contrib</code>, lalu cari paket yang rumahnya di sana.

<syntaxhighlight lang="text">
sudo sed -i 's/ main contrib non-free-firmware/ main non-free-firmware/' /etc/apt/sources.list
sudo apt-get update > /dev/null 2>&1
apt-cache policy cowsay
</syntaxhighlight>

Kalau paket contohmu berasal dari <code>contrib</code>, hasilnya <code>Unable to locate package</code> padahal repo-nya benar dan internetnya jalan. Ini beda penting: "tidak ditemukan" bukan berarti "tidak ada di dunia", hanya "tidak ada di katalog yang kamu muat".

⚠️ '''Hati-hati:''' jangan langsung menyimpulkan repo mati saat melihat <code>Unable to locate package</code>. Tiga penyebab paling sering: component kurang, arsitektur salah, atau indeks basi.

=== 🔹 Langkah 5: uji C, nama file sumber tidak sah ===

APT hanya membaca nama file dengan aturan tertentu: huruf, angka, garis bawah, tanda hubung, dan titik, dengan ekstensi <code>.list</code> atau <code>.sources</code>.

<syntaxhighlight lang="text">
sudo cp /etc/apt/sources.list /etc/apt/sources.list.d/backup-2026.list.bak
sudo apt-get update 2>&1 | grep -i ignoring
</syntaxhighlight>

Muncul pemberitahuan bahwa file diabaikan karena ekstensinya tidak sah. File itu ada di disk, isinya benar, tetapi tidak pernah dibaca.

📊 '''Angka penting:''' aturan nama file di <code>sources.list.d/</code> hanya mengizinkan <code>a-z</code>, <code>A-Z</code>, <code>0-9</code>, <code>_</code>, <code>-</code>, dan <code>.</code> Nama seperti <code>repo baru.list</code> atau <code>repo.list.save</code> akan dilewati.

=== 🔹 Langkah 6: uji D, sukses palsu ===

Ini uji paling penting untuk dunia kerja: tambahkan satu repo yang tidak bisa dijangkau, lalu periksa status keluarnya.

<syntaxhighlight lang="text">
echo 'deb http://repo-internal.lab.local/debian bookworm main' | sudo tee /etc/apt/sources.list.d/internal.list
sudo apt-get update 2>&1 | tail -n 6
echo "status keluar: $?"
ls -l --time-style=long-iso /var/lib/apt/lists/ | head -n 5
</syntaxhighlight>

Yang sering terjadi: ada baris <code>E: Some index files failed to download. They have been ignored, or old ones used instead.</code> tetapi status keluar tetap 0. Indeks lama tetap dipakai, dan jam berkas di <code>/var/lib/apt/lists</code> untuk repo sehat ikut diperbarui sementara repo rusak tidak.

Akibat nyata: skrip otomatis menganggap pembaruan berhasil, padahal satu sumber tidak pernah tersentuh. Kalau kamu ingin perintah berhenti saat ada yang gagal, pakai mode galat yang tegas:

<syntaxhighlight lang="text">
sudo apt-get update -o APT::Update::Error-Mode=any
echo "status keluar: $?"
</syntaxhighlight>

🔥 '''Kasus nyata:''' Sebuah kantor punya skrip harian <code>apt update &amp;&amp; apt upgrade -y</code> di 12 server. Repo internal mereka mati setelah pindah ruang server, dan tidak ada satu pun alarm berbunyi selama tiga minggu karena skrip selalu "sukses". Temuan datang dari audit rutin: tanggal berkas indeks di satu server tidak berubah selama 20 hari. Perbaikan yang diambil bukan monitoring rumit, tetapi mengganti perintah menjadi mode galat tegas plus pemeriksaan umur indeks.

=== 🔹 Langkah 7: uji E, tanda tangan tidak bisa diverifikasi ===

Buat entri repo yang menunjuk berkas kunci yang tidak ada.

<syntaxhighlight lang="text">
echo 'deb [signed-by=/etc/apt/keyrings/lab.asc] http://deb.debian.org/debian bookworm main' | sudo tee /etc/apt/sources.list.d/lab-key.list
sudo apt-get update 2>&1 | tail -n 8
sudo apt-get install -y --reinstall bash 2>&1 | tail -n 5
</syntaxhighlight>

APT menolak repo itu karena tanda tangannya tidak bisa dipastikan. Kata kuncinya bisa berupa <code>NO_PUBKEY</code>, <code>is not signed</code>, atau pesan sejenis, karena bunyi persisnya berbeda antar versi APT. Artinya tetap satu: lapis 4 menolak.

Yang perlu dipahami: ini bukan gangguan, ini justru pengaman. Kalau repositori bisa dipakai tanpa kunci, siapa pun yang bisa membajak jalur jaringan bisa mengirim paket palsu yang dipasang sebagai root.

⚠️ '''Hati-hati:''' jangan menyelesaikan pesan kunci hilang dengan <code>trusted=yes</code> atau <code>apt-key adv</code>. Cara yang benar: unduh kunci dari sumber resmi, periksa fingerprint-nya, simpan di <code>/usr/share/keyrings/</code>, lalu rujuk lewat <code>signed-by=</code>.

=== 🔹 Langkah 8: uji F, paket lepas dengan dependensi kurang ===

Sekarang kerusakan yang menyentuh lapis 5. Buat paket latihan yang bergantung pada paket yang belum terpasang.

<syntaxhighlight lang="text">
mkdir -p latihan/DEBIAN
printf 'Package: paket-latihan\nVersion: 1.0\nArchitecture: all\nMaintainer: Lab TKJ <lab@example.org>\nDepends: cowsay\nDescription: Paket latihan untuk uji dpkg\n\n' | sudo tee latihan/DEBIAN/control
dpkg-deb --build latihan paket-latihan_1.0_all.deb
sudo apt-get remove -y cowsay
sudo dpkg -i paket-latihan_1.0_all.deb 2>&1 | tail -n 8
dpkg -l paket-latihan
dpkg --audit
</syntaxhighlight>

Hasil yang diharapkan: <code>dpkg</code> memasang berkas, lalu berhenti karena dependensi belum terpenuhi. Statusnya <code>iU</code>, dan <code>dpkg --audit</code> melaporkan ada paket setengah terpasang. Selama kondisi ini bertahan, instalasi paket lain juga bisa ikut tertahan.

Pulihkan dengan membiarkan APT menyelesaikan pekerjaan yang tadi dipaksa:

<syntaxhighlight lang="text">
sudo apt --fix-broken install
dpkg -l paket-latihan
dpkg --audit
</syntaxhighlight>

Status harus berubah menjadi <code>ii</code> dan <code>dpkg --audit</code> kembali kosong. Perhatikan bedanya: <code>dpkg -i</code> hanya memasang berkas, sedangkan <code>apt install ./paket-latihan_1.0_all.deb</code> memasang sekaligus menyelesaikan dependensi.

🔥 '''Kasus nyata:''' Sebuah klinik memasang aplikasi kasir dari berkas <code>.deb</code> pemberian vendor memakai <code>dpkg -i</code>. Dependensi satu paket pustaka tertinggal, status jadi <code>iU</code>, aplikasi tidak mau jalan. Keesokan harinya petugas mencoba memasang paket lain untuk memperbaiki, dan semua perintah <code>apt install</code> ikut gagal dengan pesan <em>unmet dependencies</em>. Kesimpulan staf saat itu: "server rusak, perlu diinstal ulang". Padahal satu perintah <code>apt --fix-broken install</code> menyelesaikannya dalam hitungan detik.

📊 '''Angka penting:''' pemeriksaan <code>dpkg --audit</code> per paket tersedia sejak dpkg 1.17.10. Perintah ini mencari paket yang hanya terpasang sebagian, data kontrol yang hilang, atau berkas yang tidak sesuai catatan.

=== 🔹 Langkah 9: uji G, hold menahan versi ===

<syntaxhighlight lang="text">
apt-cache policy cowsay
sudo apt-mark hold cowsay
apt-mark showhold
sudo apt-get upgrade --dry-run 2>&1 | grep -iE 'kept back|held'
sudo apt-mark unhold cowsay
</syntaxhighlight>

Paket yang di-hold tidak ikut naik versi otomatis. Pesan <code>kept back</code> bisa muncul karena hold, bisa juga karena dependensi yang belum siap. Cara membedakannya hanya satu: <code>apt-mark showhold</code>.

💡 '''Tips:''' biasakan <code>apt-get upgrade --dry-run</code> sebelum upgrade sungguhan. Kamu melihat daftar paket yang akan berubah tanpa menyentuh sistem.

=== 🔹 Langkah 10: uji H, pin menahan versi tertentu ===

Pin adalah cara resmi menahan satu paket tanpa mengunci seluruh sistem.

<syntaxhighlight lang="text">
printf 'Package: bash\nPin: version *\nPin-Priority: 1001\n' | sudo tee /etc/apt/preferences.d/lab-pin
apt-cache policy bash
sudo apt-get upgrade --dry-run 2>&1 | grep -i bash
sudo rm /etc/apt/preferences.d/lab-pin
</syntaxhighlight>

Perhatikan kolom <code>Pin-Priority</code> berubah menjadi 1001 dan kandidat tetap di versi sekarang. Ini mekanisme yang dipakai administrator untuk mencegah satu paket ikut naik saat repo baru ditambahkan.

⚠️ '''Hati-hati:''' pin yang terlalu luas bisa membuat paket keamanan tidak pernah naik. Selalu batasi pin ke satu paket atau satu repo yang benar-benar kamu pahami.

=== 🔹 Langkah 11: pulihkan dan baca riwayat ===

Setelah delapan uji, bersihkan semua jejak dan buktikan pemulihannya.

<syntaxhighlight lang="text">
sudo rm -f /etc/apt/sources.list.d/internal.list /etc/apt/sources.list.d/lab-key.list /etc/apt/sources.list.d/backup-2026.list.bak
sudo apt-get update -o APT::Update::Error-Mode=any
sudo apt --fix-broken install
sudo dpkg --configure -a
sudo apt-get check
dpkg --audit
dpkg -l | grep -v '^ii'
sudo apt-get clean
</syntaxhighlight>

Lalu buka catatan sejarah sistem. Dua berkas ini menjawab "siapa mengubah apa" saat kamu menerima server warisan.

<syntaxhighlight lang="text">
tail -n 30 /var/log/apt/history.log
tail -n 30 /var/log/dpkg.log
zgrep -h ' install ' /var/log/dpkg.log.*.gz 2>/dev/null | tail -n 10
</syntaxhighlight>

=== 🔹 Langkah 12: jadikan satu skrip audit ===

Daripada mengulang sebelas langkah tiap kali, simpan pemeriksaan intinya dalam satu berkas.

<syntaxhighlight lang="bash">
#!/bin/bash
set -u
echo "== identitas =="
. /etc/os-release
echo "$PRETTY_NAME ($(dpkg --print-architecture))"

echo "== sumber aktif =="
grep -rhE '^(deb|Types:)' /etc/apt/sources.list /etc/apt/sources.list.d/ 2>/dev/null | sed 's/#.*//' | grep -v '^$'

echo "== umur indeks =="
find /var/lib/apt/lists -name 'Packages*' -printf '%TY-%Tm-%Td %p\n' 2>/dev/null | sort | tail -n 3

echo "== konsistensi =="
apt-get check 2>&1 | tail -n 2
dpkg --audit

echo "== status tidak sehat =="
dpkg -l | awk '$1 != "ii" && NR > 5'

echo "== hold =="
apt-mark showhold

echo "== cache =="
du -sh /var/cache/apt/archives 2>/dev/null
</syntaxhighlight>

🧪 '''Uji cepat:''' jalankan skrip ini di setiap server sebelum dan sesudah perubahan repo. Bila keluarannya sama, perubahanmu tidak meninggalkan kerusakan.

== 🏭 Dipakai di dunia kerja ==

* '''Sekolah dan lab komputer:''' satu ruang praktik butuh versi paket yang sama di semua PC. Audit indeks adalah cara termurah memastikan tidak ada siswa yang dapat versi berbeda saat ujian berbasis komputer.
* '''Kantor dan tim IT support:''' server warisan sering punya tambahan repo dari vendor lama. Audit sumber menjawab kenapa satu server berperilaku beda dari sembilan server lain yang katanya "settingnya sama".
* '''Rumah sakit dan layanan publik:''' pembaruan keamanan tidak boleh diam-diam berhenti. Memeriksa umur indeks adalah alarm sederhana yang menangkap repo mati sebelum jadi insiden.
* '''ISP dan penyedia layanan:''' armada server besar butuh pembaruan yang bisa diaudit. Status keluar perintah dan jam indeks adalah bukti yang bisa dilampirkan ke laporan perubahan.
* '''Industri dan jaringan OT:''' mesin produksi sering tidak boleh berubah tiba-tiba. Hold dan pin dipakai agar paket pendukung tetap di versi yang sudah diuji.
* '''Cloud dan tim platform:''' template mesin baru harus bisa dibangun ulang dengan hasil sama. Audit repositori memastikan semua mesin memakai sumber resmi yang konsisten.

== ✅ Verifikasi ==

{| class="wikitable"
! Perintah !! Yang harus terlihat !! Artinya
|-
| <code>apt-get update -o APT::Update::Error-Mode=any</code> || status 0, tanpa baris <code>E:</code> || semua sumber terbaca
|-
| <code>ls -l /var/lib/apt/lists/</code> || jam berkas baru || indeks benar-benar diperbarui
|-
| <code>apt-cache policy &lt;paket&gt;</code> || Candidate dan baris repo 500 || lapis 3 sehat
|-
| <code>apt-get check</code> || selesai tanpa error || dependensi konsisten
|-
| <code>dpkg --audit</code> || kosong || tidak ada paket setengah jadi
|-
| <code>dpkg -l &lt;paket&gt;</code> || <code>ii</code> || terpasang dan terkonfigurasi
|-
| <code>apt-mark showhold</code> || hanya paket yang sengaja ditahan || tidak ada hold warisan
|-
| <code>apt-get upgrade --dry-run</code> || daftar perubahan wajar || tidak ada kejutan saat upgrade
|-
| <code>tail -n 20 /var/log/apt/history.log</code> || perubahanmu tercatat || jejak audit tersedia
|}

Langkah verifikasi terakhir: ulangi seluruh praktikum dari snapshot bersih. Kalau hasil setiap uji sama, prosedurmu sudah layak diajarkan ke kelas lain.

== ⚠️ Kesalahan umum & troubleshooting ==

{| class="wikitable"
! Gejala !! Penyebab paling sering !! Langkah pertama
|-
| <code>Unable to locate package</code> || component kurang, arsitektur beda, indeks basi || <code>apt-cache policy &lt;paket&gt;</code>
|-
| <code>does not have a Release file</code> || suite atau URI salah ketik || baca baris <code>Err</code> dan <code>Ign</code>
|-
| <code>NO_PUBKEY</code> atau <code>is not signed</code> || kunci hilang atau salah tempat || periksa fingerprint, pasang di <code>/usr/share/keyrings</code>
|-
| <code>Hash Sum mismatch</code> || mirror setengah sinkron atau cache proxy || <code>apt-get clean</code> lalu ulangi
|-
| <code>kept back</code> saat upgrade || hold atau dependensi belum siap || <code>apt-mark showhold</code>
|-
| <code>unmet dependencies</code> setelah <code>dpkg -i</code> || dependensi tidak ikut dipasang || <code>apt --fix-broken install</code>
|-
| <code>dpkg was interrupted</code> || proses sebelumnya terputus || <code>dpkg --configure -a</code>
|-
| paket <code>iF</code> berulang || skrip <code>postinst</code> gagal || baca <code>/var/log/dpkg.log</code>
|-
| <code>No space left on device</code> || cache dan indeks memenuhi partisi || <code>df -h</code> lalu <code>apt-get clean</code>
|-
| "sudah versi terbaru" padahal beda || pin atau prioritas repo lain || <code>apt-cache policy &lt;paket&gt;</code>
|}

Beberapa kebiasaan yang mencegah empat puluh menit kebingungan:

* Salin keluaran perintah ke berkas sebelum mengubah apa pun. Terminal bisa ditutup, bukti tidak boleh hilang.
* Ubah satu file sumber per percobaan, lalu jalankan <code>apt-get update</code>. Perubahan bertumpuk membuat penyebab tidak bisa dibedakan.
* Jangan memperbaiki <code>dpkg</code> sebelum lapis 1 sampai 3 terbukti sehat.
* Kalau ragu, <code>--dry-run</code> dulu. Tidak ada cerita buruk yang dimulai dari simulasi.

== 🔐 Catatan keamanan & etika ==

* '''Repo adalah hak root bagi pemiliknya.''' Menambah sumber berarti mempercayakan eksekusi skrip pemasangan sebagai root kepada pemilik repo itu.
* '''Jangan pakai <code>trusted=yes</code>''' untuk melewati pemeriksaan tanda tangan. Kalau kunci bermasalah, perbaiki kuncinya, jangan matikan pengamannya.
* '''Verifikasi fingerprint kunci''' sebelum dipasang. Kunci yang salah sama saja dengan memberi kunci gudang kepada orang asing.
* '''<code>dpkg -i</code> dari berkas tak dikenal''' menjalankan skrip <code>postinst</code> sebagai root. Periksa asal berkas dan checksum-nya.
* '''Pin dan hold adalah alat produksi.''' Uji di VM dulu, karena pin yang salah bisa menahan pembaruan keamanan berbulan-bulan tanpa ada yang sadar.
* '''Etika laboratorium:''' praktik merusak repo hanya di mesin milikmu atau VM lab. Jangan pernah menguji di server sekolah, kantor, atau mesin orang lain tanpa izin.

🧪 '''Uji cepat:''' <code>apt-get indextargets --format '$(SITE) $(RELEASE)'</code> menampilkan daftar sumber yang benar-benar dipahami APT. Cocokkan dengan file yang kamu tulis sendiri.

== 📌 Kesimpulan ==

Paket yang gagal terpasang hampir selalu bisa dilacak ke satu dari lima lapis: sumber, indeks, pemilihan, unduhan bertanda tangan, atau pemasangan. Auditor yang baik tidak menebak; ia berhenti di lapis pertama yang gagal dan memperbaiki hanya lapis itu.

Langkah berikutnya: ambil satu server nyata di labmu, jalankan skrip audit dari Langkah 12, dan simpan keluarannya sebagai baseline. Minggu depan jalankan lagi dan bandingkan, karena selisihnya adalah cerita tentang apa yang berubah di mesin itu.

== 🔗 Materi terkait ==

* [[Linux : Manajemen Paket dan Repositori Debian]] — artikel konsep pasangan praktikum ini: lapis repositori, indeks, <code>apt</code>, dan <code>dpkg</code>.
* [[Menambahkan Repositori Debian Linux]] — cara menulis baris sumber dan memilih suite yang tepat.
* [[Linux : Perintah Dasar Linux]] — dasar membaca berkas, menyalin, dan memeriksa isi direktori.
* [[Linux : Cek Penggunaan Disk]] — menelusuri partisi penuh yang membuat pemasangan paket gagal.
* [[Linux : Cara Membaca Penyebab Service Gagal Start dengan systemctl status dan journalctl]] — lanjutan setelah paket terpasang tetapi layanannya tidak mau jalan.

== 📚 Referensi ==

* Debian Manpages, <code>apt-get(8)</code> — https://manpages.debian.org/bookworm/apt/apt-get.8.en.html (arti <code>update</code>, <code>install</code>, dan <code>--fix-broken</code>).
* Debian Manpages, <code>sources.list(5)</code> — https://manpages.debian.org/bookworm/apt/sources.list.5.en.html (format one-line dan deb822, aturan nama berkas, arti suite dan component).
* Debian Manpages, <code>dpkg(1)</code> — https://manpages.debian.org/bookworm/dpkg/dpkg.1.en.html (daftar status paket dan pemeriksaan <code>--audit</code>).
* Debian Manpages, <code>apt-mark(8)</code> — https://manpages.debian.org/bookworm/apt/apt-mark.8.en.html (arti <code>hold</code> dan <code>showhold</code>).
* Debian Manpages, <code>apt_preferences(5)</code> — https://manpages.debian.org/bookworm/apt/apt_preferences.5.en.html (pin priority dan pemilihan versi).

[[Category:TKJ]]
[[Category:Linux]]
[[Category:Server]]
[[Category:Debian]]