Panduan Pemecahan Masalah (Troubleshooting)

Panduan ini menjelaskan masalah umum yang mungkin Anda temui saat menjalankan Cockpit dan memberikan petunjuk langkah-demi-langkah yang mudah untuk memperbaikinya.

---

1. Masalah: Server Berstatus "Disconnected" (Terputus) 🛑

Gejala: Server fisik yang menjalankan Vapor tampak abu-abu (terputus) di dashboard Cockpit, dan grafik kinerjanya berhenti diperbarui.

• 💡 Analogi: Smart TV Kehilangan Koneksi Pikirkan ini seperti Smart TV di rumah Anda yang kehilangan koneksi. Apakah TV tersebut dicabut dari colokan? Apakah router internet rumah mati? Atau apakah akun Anda keluar secara otomatis?

Cara Memperbaikinya (Langkah-demi-Langkah):

1. Periksa Jalur Jaringan: Pastikan server Cockpit dapat menjangkau host Vapor. Buka terminal di server Cockpit Anda dan verifikasi bahwa Anda dapat berkomunikasi dengan server Vapor pada port jaringan 7770 (digunakan untuk perintah standar) dan port 7770 (digunakan untuk live update).
2. Pastikan Layanan Vapor Berjalan: Masuk ke server yang terputus secara langsung dan jalankan perintah ini untuk melihat apakah program Vapor aktif:

   systemctl status vapor.service

   • Jika statusnya berhenti (stopped), nyalakan kembali: systemctl start vapor.service.
3. Verifikasi Token Login Anda: Cockpit menggunakan token keamanan untuk berbicara dengan Vapor. Jika token ini kedaluwarsa, Cockpit akan ditolak masuk. Masuk ke UI server Vapor, buat token API baru, dan perbarui detail host di dashboard Cockpit Anda.

---

2. Masalah: Kesalahan Sertifikat Keamanan (SSL/TLS) 🔒

Gejala: Anda melihat peringatan keamanan SSL/TLS, atau Anda mendapatkan pesan kesalahan saat mencoba memindahkan VM (migrasi langsung) antar server.

• 💡 Analogi: Tanda Pengenal (ID Badge) Kedaluwarsa Saat Server A mencoba memindahkan VM ke Server B, Server B meminta tanda pengenal Server A (sertifikat TLS-nya). Jika tanda pengenal tersebut kedaluwarsa atau dikeluarkan oleh pihak yang tidak dikenal, Server B akan menolak pemindahan VM tersebut.

Cara Memperbaikinya (Langkah-demi-Langkah):

1. Periksa Layanan Virtualisasi: Masuk ke server fisik dan pastikan layanan virtualisasi (libvirtd) berjalan:

   systemctl status libvirtd

2. Buat Sertifikat Baru: Anda dapat memaksa Cockpit/Vapor untuk membuat ulang kredensial keamanan baru di kedua server dengan menjalankan perintah ini pada server fisik:

   # Meminta server untuk memperbarui sertifikat keamanan virtualisasinya
   curl -sk -X POST https://localhost:7770/api/v1/system/tls/libvirt/setup

3. Bangun Hubungan Kepercayaan: Pastikan kedua server fisik terdaftar di Cockpit secara benar agar Cockpit dapat membagikan sertifikat tepercaya di antara mereka secara otomatis.

---

3. Masalah: Konflik "Split-Brain" Server (Konflik Kunci Pengaman) 🤯

Gejala: Server fisik Anda terus berganti status antara terhubung (connected) dan terputus (disconnected) setiap beberapa detik di dashboard.

• 💡 Analogi: Dua Orang Memperebutkan Gagang Telepon yang Sama Jika Anda menjalankan dua server manajemen Cockpit secara bersamaan untuk cadangan, keduanya mungkin mencoba mengelola server fisik yang sama pada waktu yang bersamaan. Mereka terus merebut koneksi satu sama lain, menyebabkan putus-sambung berulang kali.

Cara Memperbaikinya (Langkah-demi-Langkah):

1. Cari Tahu Siapa yang Mengunci: Periksa database untuk melihat instans Cockpit mana yang saat ini memegang hak kontrol host dengan menjalankan query database berikut:

   -- Melihat siapa yang memegang kunci pengaman (checkout card) aktif
   SELECT pid, classid, objid FROM pg_locks WHERE locktype = 'advisory';

2. Reset Koneksi:
   • Hentikan program Cockpit di kedua server manajemen.
   • Jalankan Server #1 terlebih dahulu, tunggu beberapa detik agar server ini berhasil mengklaim host Vapor dengan bersih.
   • Jalankan Server #2. Server ini akan mendeteksi bahwa Server #1 sedang aktif dan akan menunggu dengan tenang sebagai server cadangan (standby).