Belajar Restic - Troubleshooting & Recovery

#Pendahuluan

Semua episode sejauh ini membangun sistem yang berjalan mulus. Episode 16 membahas saat segalanya tidak berjalan mulus — karena dalam operasi nyata, itu pasti terjadi. Backup gagal jam 3 pagi, restore tidak menemukan file, atau repository "terkunci".

Kuncinya: diagnosis metodis dan latihan yang sudah dilakukan sebelumnya, bukan kepanikan saat kejadian.

#Debugging: RESTIC_DEBUG dan --verbose

#Verbose: Melihat Detail

Tingkat verbosity menaik dari -v sampai -vvvv:

restic backup /data -vv

-vv menampilkan tiap file yang diproses dan kecepatan — berguna memastikan backup benar-benar bekerja atau menemukan pola path yang salah.

#RESTIC_DEBUG: Log Internal

Untuk masalah yang butuh detail internal (HTTP request, chunking, kunci):

RESTIC_DEBUG=1 restic backup /data

Debug log menampilkan jejak internal termasuk URL backend dan status HTTP. Jangan dijalankan permanen — hanya saat menyelidiki; outputnya bisa sangat besar.

#Kasus Umum dan Solusinya

#1. Repository Locked

Error khas

unable to create lock in backend: repository is already locked by ...

Ada proses backup/prune lain yang belum selesai. Solusi: tunggu prosesnya, atau jika jelas macet (misal koneksi putus), hapus lock secara sadar:

restic list locks
restic unlock

restic unlock menghapus lock yang sudah tidak valid. Berhati-hatilah: jangan unlock ketika proses lain benar-benar masih berjalan — bisa merusak repository.

#2. S3 Timeout / Access Denied

Error khas S3

unable to open repository at s3:...
request failed: AccessDenied

Periksa berurutan: credential (AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY), nama bucket, region, dan versi endpoint. Tambahkan timeout via opsi khusus backend:

restic -o s3.list-objects-v1=true -o s3.connections=8 backup /data

#3. Password Salah

Error khas password

wrong password or no key found

Biasanya typo atau env tidak ter-export. Cek dengan restic cat config yang membutuhkan password:

restic cat config && echo "password OK"

Jika benar-benar lupa, tidak ada jalan pulang — itulah mengapa episode 3 dan 13 menekankan backup passphrase.

#Simulasi Bencana: Latihan Restore

Recovery hanya andal jika sudah dilatih. Simulasi penuh:

rm -rf /home/user/Documents
restic snapshots
restic restore latest --target /tmp/restore \
  --path /home/user/Documents
mv /tmp/restore/home/user/Documents /home/user/Documents
diff -r /home/user/Documents /tmp/restore/home/user/Documents

Kuncinya: jalankan secara berkala di lingkungan uji, catat durasinya (RTO kalian!), dan simulasikan juga backend off-site (restore dari S3/rest-server) — bukan hanya dari repo lokal.

#Recovery dari Repository Corrupt

Ketika restic check melaporkan blob hilang atau hash mismatch (episode 11):

1. Identifikasi cakupan: restic check dan catat file/snapshot yang terdampak.
2. Pulihkan dari sumber lain: kalau ada repo kedua / lokasi off-site, restore file dari sana.
3. Backup ulang data yang masih ada: chunk yang hilang dihasilkan ulang dari file sumber yang masih tersedia.
4. Perbaikan manual hanya untuk kasus spesifik: restic repair index untuk memperbaiki index, atau restic check --read-data-subset untuk menemukan blob korup spesifik.

restic repair index

#Penutup

• -vv untuk detail backup; RESTIC_DEBUG=1 untuk log internal.
• Repo lock: restic list locks → restic unlock hanya saat yakin proses mati.
• S3 error: cek credential, bucket, region, lalu tuning opsi S3.
• Password salah: uji dengan restic cat config — dan jangan sampai lupa.
• Simulasi bencana rutin: hapus file → restore → verifikasi → ukur durasi.
• Repository corrupt: backup ulang dari sumber; perbaikan manual hanya untuk kasus spesifik.
• Strategi backend ganda adalah asuransi terakhir terhadap repo corrupt.

Di episode 17 selanjutnya kita menyegarkan pengetahuan versi: restic 0.19.x & fitur terbaru — apa saja yang dibawa 0.19.1 (Jul 2026) dan 0.19.0 (Jun 2026), perjalanan dari 0.17 (2024) dan 0.18 (2025) seperti kompresi zstd dan lock-free index, serta cara upgrade yang aman.