Troubleshooting

Server Gagal Berjalan

Jika Anda mencoba menjalankan aplikasi namun mendapati pesan error:

• Alamat/Port Sudah Digunakan: Pastikan tidak ada aplikasi lain yang menggunakan port 7080 (default). Gunakan flag --listen untuk menjalankan di port lain.

  kudashai --listen :8080

• Permission Denied: Pada beberapa OS (terutama saat mencoba binding ke port di bawah 1024 atau terkait enkripsi), Anda mungkin membutuhkan akses Administrator / Root, atau atur mode eksekusi file.

  chmod +x kudashai
  ./kudashai

Mode Platform Tidak Dapat Terhubung

Jika Anda tidak dapat mengaktifkan mode Platform melalui Kudashai Studio, periksa hal-hal berikut:

• App Key Tidak Valid: Pastikan Anda memasukkan App Key (kunci lisensi) yang benar dari AwanIO Enterprise Portal. Jika kunci Anda sudah kedaluwarsa atau dicabut, hubungi administrator atau tim dukungan AwanIO.
• Konektivitas Jaringan: Kudashai Studio melakukan handshake otomatis dengan backend AwanIO untuk menyediakan database Anda. Pastikan mesin Anda memiliki akses internet keluar dan tidak diblokir oleh firewall atau proxy.
• Timeout Handshake: Jika proses handshake memakan waktu terlalu lama atau gagal secara diam-diam, periksa log aplikasi untuk kesalahan koneksi. Restart aplikasi Kudashai dan coba aktivasi ulang.
• Data Tidak Muncul Setelah Aktivasi: Jika handshake berhasil tetapi data cluster tidak muncul, periksa log. Sistem mencoba menjalankan migrasi otomatis saat mode Platform pertama kali diaktifkan.

Masalah Kredensial Saat Memindahkan Data (Mode Standalone)

Dalam mode Standalone, kredensial cluster disimpan secara lokal dan dienkripsi secara aman menggunakan kunci rahasia (encryption key) yang dibuat otomatis oleh sistem di komputer Anda.

• Jika Anda memindahkan file data aplikasi Kudashai ke komputer lain TANPA menyertakan file kunci enkripsi (encryption key) aslinya, Kudashai di komputer baru tidak akan bisa membaca kredensial cluster tersebut.
• Solusi: Pastikan Anda mem-backup dan memigrasikan seluruh folder konfigurasi bawaan Kudashai, tidak hanya sebagian data saja.

Bantuan AI (AI Troubleshooting)

Jika Kudashai mendeteksi Pod atau layanan K8s sedang dalam keadaan error (seperti ImagePullBackOff, CrashLoopBackOff), Anda dapat menggunakan tombol integrasi "Ask AI" pada antarmuka Kudashai. Agen AI internal akan menganalisis logs dan metrics terbaru untuk mendiagnosis serta membantu penyelesaian masalah Anda, bahkan menyarankan opsi konfigurasi baru.