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 "Server tidak ditemukan."

Solusi:

  1. Verifikasi 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 atau router jaringan Anda.
  4. Coba koneksi manual: masukkan alamat IP server langsung di pengaturan klien.
  5. Verifikasi tidak ada perangkat lunak lain yang menggunakan port TCP server (default: 5001).

Klien terhubung kemudian langsung terputus

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

Solusi:

  1. Verifikasi kunci koneksi cocok di server dan klien. Kunci diatur di Pengaturan > Jaringan pada server.
  2. Periksa ketidakstabilan jaringan (kehilangan paket, masalah kabel).
  3. Pastikan server belum mencapai batas PC lisensinya.
  4. Tinjau log server untuk pesan kegagalan autentikasi.

Klien menampilkan "Offline" di server tetapi PC menyala

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

Solusi:

  1. Di PC klien, verifikasi HandyCafe Client benar-benar berjalan (periksa system tray).
  2. Periksa koneksi jaringan di PC klien (bisakah melakukan ping ke server?).
  3. Verifikasi aturan firewall: port TCP 5001-5003 harus terbuka di server dan klien.
  4. Mulai ulang HandyCafe Client di PC yang terpengaruh.
  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. Mulai ulang 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 di klien

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

Solusi:

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

Penghitung waktu sesi menampilkan waktu yang salah

Gejala: Waktu yang ditampilkan tidak cocok dengan waktu yang sebenarnya berlalu.

Solusi:

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

Biaya sesi tampaknya salah

Gejala: Jumlah yang dibebankan 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 "Kunci saat Pembelian" atau "Jadwal Langsung" yang aktif.

Masalah Pembayaran

Metode pembayaran tidak ada di dropdown

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

Solusi:

  1. Verifikasi metode pembayaran ada di Manajemen > Metode Pembayaran.
  2. Periksa bahwa metode pembayaran aktif (tidak dihapus atau dinonaktifkan).
  3. Periksa izin kasir. PAYMENT_MANAGE harus diberikan untuk melihat semua metode.

Masalah Tampilan Klien

Layar idle klien kosong

Gejala: Layar idle tidak menampilkan apa-apa alih-alih slideshow yang dikonfigurasi.

Solusi:

  1. Verifikasi bahwa layar idle diaktifkan di Pengaturan > Klien > Layar Idle.
  2. Periksa bahwa minimal satu item media (gambar atau video) telah ditambahkan.
  3. Verifikasi file media valid dan tidak rusak.
  4. Picu sinkronisasi untuk mengirimkan pengaturan terbaru ke klien.

Menu klien tidak menampilkan aplikasi

Gejala: Peluncur aplikasi kosong atau kategori hilang.

Solusi:

  1. Verifikasi aplikasi dan kategori dikonfigurasi di Pengaturan > Klien > Konten.
  2. Periksa bahwa kategori dan aplikasi memiliki visibilitas yang diaktifkan.
  3. Verifikasi klien telah menerima data menu terbaru (perubahan dikirimkan otomatis melalui TCP).
  4. Mulai ulang klien jika sinkronisasi real-time tidak diterapkan.

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 laju.

Desktop jarak jauh menampilkan layar hitam

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

Solusi:

  1. Verifikasi klien online dan responsif (coba ambil tangkapan layar terlebih dahulu).
  2. Periksa port UDP 5004 terbuka secara dua arah.
  3. Driver grafis klien mungkin perlu diperbarui.
  4. Coba minta penyegaran keyframe.

Masalah Lisensi

Lisensi menampilkan "offline_grace"

Gejala: Status lisensi menampilkan offline_grace dengan hitungan mundur.

Solusi:

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

Lisensi menampilkan "over_limit"

Gejala: Lebih banyak klien yang terhubung dari yang diizinkan lisensi.

Solusi:

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

Masalah Umum

Perubahan pengaturan tidak disimpan

Gejala: Perubahan kembali setelah menavigasi dari pengaturan.

Solusi:

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

Entri log audit hilang

Gejala: Tindakan yang diharapkan tidak muncul di halaman Log.

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 kolom pencarian teks untuk aksi tertentu.