HandyCafe Docs
owner cashier it-admin

Pemecahan Masalah

Halaman ini mencakup solusi untuk masalah umum yang diatur berdasarkan kategori.

Masalah Koneksi

Klien tidak dapat menemukan server

Gejala: Klien menampilkan "Mencari server" atau "Tidak ada server ditemukan."

Solusi:

  1. Pastikan HandyCafe Server berjalan di PC manajemen.
  2. Konfirmasi kedua PC berada di subnet yang sama (misalnya, keduanya di 192.168.1.x).
  3. Periksa bahwa mDNS tidak diblokir oleh switch jaringan atau router Anda.
  4. Coba koneksi manual: masukkan alamat IP server langsung di pengaturan klien.
  5. Pastikan tidak ada perangkat lunak lain yang menggunakan port TCP server (default: 5001).

Klien terhubung lalu segera terputus

Gejala: Klien sebentar menampilkan "Terhubung" lalu kembali ke "Mencari."

Solusi:

  1. Pastikan kunci koneksi cocok di server dan klien. Kunci diatur di Settings > Network pada server.
  2. Periksa ketidakstabilan jaringan (packet loss, masalah kabel).
  3. Pastikan server belum mencapai batas lisensi PC.
  4. Tinjau log server untuk pesan kegagalan otentikasi.

Klien menunjukkan "Offline" di server tetapi PC berjalan

Gejala: PC klien menyala dan aplikasi klien berjalan tetapi server menampilkannya sebagai offline.

Solusi:

  1. Pada PC klien, pastikan HandyCafe Client benar-benar berjalan (periksa system tray).
  2. Periksa koneksi jaringan pada PC klien (dapatkah ia ping server?).
  3. Verifikasi aturan firewall: port TCP 5001-5003 harus terbuka di server dan klien.
  4. Restart HandyCafe Client pada PC yang terkena dampak.
  5. Jika menggunakan VLAN, pastikan VLAN server dan klien dapat berkomunikasi.

Tidak dapat terhubung setelah mengubah pengaturan jaringan

Gejala: Setelah mengubah port atau kunci koneksi, klien tidak dapat terhubung.

Solusi:

  1. Pastikan klien diperbarui dengan nomor port baru dan kunci koneksi.
  2. Restart HandyCafe Server setelah mengubah pengaturan jaringan.
  3. Perbarui aturan firewall untuk mengizinkan port baru.
  4. Semua klien harus dikonfigurasi ulang dengan nilai baru.

Masalah Sesi

Tidak dapat memulai sesi pada klien

Gejala: Tombol mulai dinonaktifkan atau aksi mulai gagal dengan kesalahan.

Solusi:

  1. Periksa status lisensi. Jika dalam mode read-only, sesi baru tidak dapat dimulai.
  2. Pastikan status klien adalah "Idle". Sesi hanya dapat dimulai pada klien yang idle.
  3. Periksa izin kasir. Peran harus memiliki izin AUTH_CLIENT_LOGIN.
  4. Pastikan harga dikonfigurasi (Settings > Pricing harus memiliki tarif per jam yang valid).

Timer sesi menunjukkan waktu yang salah

Gejala: Waktu yang ditampilkan tidak sesuai dengan waktu yang telah berlalu.

Solusi:

  1. Periksa jam sistem pada PC server dan klien. Mereka harus disinkronkan (gunakan NTP).
  2. Jika sesi dijeda, durasi jeda tidak dihitung.
  3. Untuk sesi prabayar, timer menunjukkan waktu yang tersisa, bukan waktu yang telah berlalu.

Biaya sesi tampak salah

Gejala: Jumlah yang dikenakan tidak sesuai dengan harapan.

Solusi:

  1. Periksa jadwal harga. Jika diaktifkan, sesi mungkin telah melewati beberapa slot harga dengan pengali berbeda.
  2. Tinjau pengaturan harga: tarif per jam dasar, PPN, biaya awal, pembulatan.
  3. Periksa segmen harga sesi dalam detail transaksi untuk rincian.
  4. Verifikasi komisi dan biaya tetap metode pembayaran.
  5. Untuk sesi prabayar, periksa apakah mode "Lock at Purchase" atau "Live Schedule" aktif.

Sesi yang dijeda tidak dapat dilanjutkan

Gejala: Aksi lanjutkan gagal atau tidak tersedia.

Solusi:

  1. Pastikan PC klien masih terhubung ke server.
  2. Periksa bahwa status klien menunjukkan "Paused" (oranye).
  3. Jika klien terputus selama jeda, mungkin perlu terhubung kembali terlebih dahulu.

Masalah Pembayaran

Metode pembayaran hilang dari dropdown

Gejala: Metode pembayaran yang diharapkan tidak muncul saat menutup sesi atau pesanan.

Solusi:

  1. Pastikan metode pembayaran ada di Management > Payment Methods.
  2. Periksa bahwa metode pembayaran aktif (tidak dihapus atau dinonaktifkan).
  3. Periksa izin kasir. PAYMENT_MANAGE harus diberikan untuk melihat semua metode.

Perhitungan komisi tampak salah

Gejala: Komisi yang dikurangkan tidak sesuai dengan tarif yang diharapkan.

Solusi:

  1. Verifikasi tarif komisi metode pembayaran (sebagai persentase) dan biaya tetap.
  2. Rumus komisi: komisi = (jumlah yang dikenakan * tarif komisi / 100) + biaya tetap.
  3. Periksa apakah kasir menerapkan override manual pada jumlah yang dikenakan.

Masalah Tampilan Klien

Layar idle klien kosong

Gejala: Layar idle tidak menampilkan apa pun selain slideshow yang dikonfigurasi.

Solusi:

  1. Pastikan layar idle diaktifkan di Settings > Clients > Idle Screen.
  2. Periksa bahwa setidaknya satu item media (gambar atau video) telah ditambahkan.
  3. Verifikasi file media valid dan tidak rusak.
  4. Lakukan sinkronisasi untuk mendorong pengaturan terbaru ke klien.

Menu klien tidak menampilkan aplikasi

Gejala: Peluncur aplikasi kosong atau kategori hilang.

Solusi:

  1. Pastikan aplikasi dan kategori dikonfigurasi di Settings > Clients > Content.
  2. Periksa bahwa kategori dan aplikasi telah diaktifkan visibilitasnya.
  3. Verifikasi klien telah menerima data menu terbaru (perubahan otomatis didorong melalui TCP).
  4. Restart aplikasi klien jika sinkronisasi real-time tidak diterapkan.

Tema tampilan klien tidak diterapkan

Gejala: Klien menampilkan tampilan default alih-alih tema yang dikonfigurasi.

Solusi:

  1. Pastikan pengaturan tema disimpan di Settings > Clients > Appearance.
  2. Lakukan push pengaturan ke klien.
  3. Restart aplikasi klien.

Masalah Desktop Jarak Jauh

Desktop jarak jauh lambat atau terputus-putus

Gejala: Umpan video tertunda, tersendat, atau memiliki frame rate rendah.

Solusi:

  1. Turunkan bitrate (coba 1000-2000 kbps untuk penggunaan LAN standar).
  2. Kurangi pengaturan FPS.
  3. Gunakan Ethernet kabel alih-alih WiFi.
  4. Periksa kemacetan jaringan atau penggunaan bandwidth tinggi dari aplikasi lain.
  5. Pastikan port UDP 5004 tidak diblokir atau dibatasi.

Desktop jarak jauh menampilkan layar hitam

Gejala: Jendela desktop jarak jauh terbuka tetapi hanya menampilkan hitam.

Solusi:

  1. Pastikan klien online dan responsif (coba ambil screenshot terlebih dahulu).
  2. Periksa port UDP 5004 terbuka dua arah.
  3. Driver grafis klien mungkin perlu diperbarui.
  4. Coba minta refresh keyframe.

Tidak dapat mengontrol mouse atau keyboard dari jarak jauh

Gejala: Anda dapat melihat layar jarak jauh tetapi klik dan penekanan tombol tidak berpengaruh.

Solusi:

  1. Verifikasi port manajemen jarak jauh (TCP 5003) terbuka.
  2. Periksa bahwa aplikasi klien memiliki izin sistem yang sesuai.
  3. Beberapa game fullscreen mungkin memblokir input jarak jauh.

Masalah Lisensi

Lisensi menunjukkan "offline_grace"

Gejala: Status lisensi menunjukkan offline_grace dengan hitungan mundur.

Solusi:

  1. Pulihkan konektivitas internet pada PC server.
  2. Periksa resolusi DNS. Server harus mencapai server lisensi.
  3. Periksa apakah proxy atau firewall memblokir koneksi HTTPS keluar.
  4. Anda memiliki waktu 72 jam untuk memulihkan konektivitas sebelum server terkunci.

Lisensi menunjukkan "over_limit"

Gejala: Lebih banyak klien terhubung daripada yang diizinkan lisensi.

Solusi:

  1. Putuskan klien idle yang tidak digunakan.
  2. Periksa jumlah klien saat ini vs batas lisensi Anda.
  3. Tingkatkan lisensi Anda untuk kapasitas PC lebih banyak.
  4. Catatan: konsol dihitung terhadap batas total PC.

Lisensi menunjukkan "expired" atau "revoked"

Gejala: Server memasuki mode terbatas.

Solusi:

  1. Periksa tanggal kedaluwarsa lisensi Anda.
  2. Perbarui lisensi Anda melalui situs web HandyCafe.
  3. Untuk lisensi yang dicabut, hubungi dukungan HandyCafe.

Masalah Umum

Perubahan pengaturan tidak disimpan

Gejala: Perubahan kembali setelah meninggalkan pengaturan.

Solusi:

  1. Pastikan untuk mengklik tombol Simpan setelah melakukan perubahan.
  2. Periksa kesalahan validasi (bidang yang disorot dengan pesan kesalahan).
  3. Verifikasi Anda memiliki izin admin.

Log audit tidak memiliki entri

Gejala: Tindakan yang diharapkan tidak muncul di halaman Logs.

Solusi:

  1. Periksa filter log. Pastikan kategori dan rentang tanggal yang benar dipilih.
  2. Verifikasi izin LOG_DISPLAY_FULL diberikan (jika tidak, hanya log hari ini yang ditampilkan).
  3. Cari menggunakan bidang pencarian teks untuk tindakan spesifik.