Panduan Pemecahan Masalah

Panduan ini menjelaskan prosedur diagnostik dan langkah-langkah pemecahan masalah untuk masalah operasional umum yang mungkin terjadi pada Cockpit.

---

1. Diagnostik: Status Node Host adalah "Disconnected"

Gejala: Node hypervisor fisik yang menjalankan Vapor berstatus disconnected di konsol Cockpit, dan bagan kinerja untuk host tersebut tidak menampilkan pembaruan data.

Alur Kerja Pemecahan Masalah:

1. Verifikasi Konektivitas Jaringan: Pastikan server Cockpit dapat menjangkau host Vapor. Verifikasi bahwa port TCP 7770 (antarmuka API) dan 7770 (aliran data peristiwa) terbuka dan dapat diakses dari server Cockpit.
2. Pemeriksaan Status Daemon: Masuk ke host hypervisor yang terpengaruh dan periksa status layanan Vapor lokal:

   systemctl status vapor.service

   Jika layanan berhenti, jalankan kembali: systemctl start vapor.service.
3. Rotasi Token API: Cockpit menggunakan token API untuk mengautentikasi dengan Vapor. Jika token tidak valid atau telah kedaluwarsa, akses akan ditolak. Buat token API baru dari konfigurasi lokal Vapor dan perbarui informasi pendaftaran host di Cockpit.

---

2. Diagnostik: Kesalahan Sertifikat TLS

Gejala: Operasi gagal dengan peringatan jabat tangan (handshake) SSL/TLS, atau migrasi langsung gagal diinisialisasi antar-hypervisor.

Alur Kerja Pemecahan Masalah:

1. Verifikasi Status Virtualisasi Hypervisor: Hubungkan ke host hypervisor dan pastikan daemon virtualisasi aktif:

   systemctl status libvirtd

2. Inisialisasi Ulang Kredensial TLS: Anda dapat memaksa Cockpit untuk membuat ulang sertifikat libvirt pada node dengan memicu endpoint konfigurasi TLS:

   # Mengirimkan permintaan pembaruan ke daemon Vapor lokal
   curl -sk -X POST https://localhost:7770/api/v1/system/tls/libvirt/setup

3. Bangun Rantai Kepercayaan (Trust Chains): Pastikan kedua server host fisik aktif dan terdaftar dalam lingkup inventaris Cockpit yang sama untuk memungkinkan Cockpit mendistribusikan dan menyinkronkan sertifikat CA secara otomatis.

---

3. Diagnostik: Status Koneksi Host Tidak Stabil (Konflik Advisory Lock)

Gejala: Status koneksi host fisik di konsol Cockpit beralih dengan cepat antara connected dan disconnected.

Alur Kerja Pemecahan Masalah:

1. Identifikasi Pemegang Lock: Perilaku ini terjadi ketika beberapa instans Cockpit yang aktif mencoba mengelola host fisik yang sama secara bersamaan. Lakukan kueri ke database PostgreSQL untuk mengidentifikasi sesi advisory lock yang aktif:

   -- Kueri advisory lock transaksi yang aktif
   SELECT pid, classid, objid FROM pg_locks WHERE locktype = 'advisory';

2. Sinkronisasi Ulang Daemon Manajemen:
   • Hentikan proses layanan Cockpit pada semua instans yang aktif.
   • Jalankan layanan Cockpit di node utama (primary) dan tunggu hingga berhasil membangun koneksi ke inventaris host.
   • Jalankan layanan Cockpit pada node sekunder. Node sekunder akan mendeteksi advisory lock yang aktif dan tetap berada dalam mode standby.