Fehlerbehebung

Diese Seite behandelt Lösungen für häufige Probleme, nach Kategorie geordnet.

Verbindungsprobleme

Client kann den Server nicht finden

Symptome: Client zeigt "Server wird gesucht" oder "Kein Server gefunden".

Lösungen:

Überprüfen Sie, ob der HandyCafe Server auf dem Verwaltungs-PC läuft.
Bestätigen Sie, dass beide PCs im selben Subnetz sind (z. B. beide auf 192.168.1.x).
Prüfen Sie, ob mDNS nicht durch Ihren Netzwerk-Switch oder Router blockiert wird.
Versuchen Sie die manuelle Verbindung: Geben Sie die Server-IP-Adresse direkt in den Client-Einstellungen ein.
Überprüfen Sie, ob keine andere Software den TCP-Port des Servers verwendet (Standard: 5001).

Client verbindet sich und trennt sich sofort

Symptome: Client zeigt kurz "Verbunden" und fällt dann auf "Suche" zurück.

Lösungen:

Überprüfen Sie, ob der Verbindungsschlüssel auf Server und Client übereinstimmt. Der Schlüssel wird unter Einstellungen > Netzwerk auf dem Server festgelegt.
Prüfen Sie auf Netzwerkinstabilität (Paketverlust, Kabelprobleme).
Stellen Sie sicher, dass der Server sein Lizenz-PC-Limit nicht erreicht hat.
Prüfen Sie die Serverprotokolle auf Authentifizierungsfehlermeldungen.

Client zeigt "Offline" auf dem Server, aber der PC läuft

Symptome: Der Client-PC ist eingeschaltet und die Client-Anwendung läuft, aber der Server zeigt ihn als offline.

Lösungen:

Überprüfen Sie auf dem Client-PC, ob der HandyCafe Client tatsächlich läuft (Systemtray prüfen).
Prüfen Sie die Netzwerkverbindung auf dem Client-PC (kann er den Server anpingen?).
Überprüfen Sie Firewall-Regeln: TCP-Ports 5001-5003 müssen auf Server und Client geöffnet sein.
Starten Sie den HandyCafe Client auf dem betroffenen PC neu.
Bei Verwendung von VLANs stellen Sie sicher, dass Server- und Client-VLANs kommunizieren können.

Verbindung nach Änderung der Netzwerkeinstellungen nicht möglich

Symptome: Nach Änderung von Ports oder Verbindungsschlüssel können sich Clients nicht verbinden.

Lösungen:

Stellen Sie sicher, dass Clients mit den neuen Portnummern und dem Verbindungsschlüssel aktualisiert wurden.
Starten Sie den HandyCafe Server nach Änderung der Netzwerkeinstellungen neu.
Aktualisieren Sie Firewall-Regeln für die neuen Ports.
Alle Clients müssen mit den neuen Werten neu konfiguriert werden.

Sitzungsprobleme

Sitzung kann auf einem Client nicht gestartet werden

Symptome: Start-Schaltfläche ist deaktiviert oder Startaktion schlägt mit Fehler fehl.

Lösungen:

Prüfen Sie den Lizenzstatus. Im Nur-Lese-Modus können keine neuen Sitzungen gestartet werden.
Überprüfen Sie, ob der Client-Status "Leerlauf" ist. Sitzungen können nur auf Clients im Leerlauf gestartet werden.
Prüfen Sie die Kassierer-Berechtigungen. Die Rolle muss die AUTH_CLIENT_LOGIN-Berechtigung haben.
Stellen Sie sicher, dass die Preisgestaltung konfiguriert ist (Einstellungen > Preise muss einen gültigen Stundensatz haben).

Sitzungstimer zeigt falsche Zeit

Symptome: Die angezeigte Zeit stimmt nicht mit der tatsächlich verstrichenen Zeit überein.

Lösungen:

Prüfen Sie die Systemuhren auf Server- und Client-PCs. Sie sollten synchronisiert sein (NTP verwenden).
Wenn die Sitzung pausiert war, wird die Pausendauer nicht mitgezählt.
Bei Vorauszahlungssitzungen zeigt der Timer die verbleibende, nicht die verstrichene Zeit.

Sitzungskosten erscheinen falsch

Symptome: Der berechnete Betrag entspricht nicht den Erwartungen.

Lösungen:

Prüfen Sie den Preisplan. Wenn aktiviert, kann die Sitzung mehrere Preisslots mit unterschiedlichen Multiplikatoren durchlaufen haben.
Überprüfen Sie die Preiseinstellungen: Grundstundensatz, MwSt., Startgebühr, Rundung.
Prüfen Sie die Preissegmente der Sitzung in den Transaktionsdetails.
Überprüfen Sie die Provision und Festgebühren der Zahlungsmethode.
Bei Vorauszahlungssitzungen prüfen Sie, ob "Preis beim Kauf fixieren" oder "Live-Preisplan" aktiv ist.

Zahlungsprobleme

Zahlungsmethode fehlt im Dropdown

Symptome: Erwartete Zahlungsmethode erscheint nicht beim Abschluss einer Sitzung oder Bestellung.

Lösungen:

Überprüfen Sie, ob die Zahlungsmethode unter Verwaltung > Zahlungsmethoden existiert.
Prüfen Sie, ob die Zahlungsmethode aktiv ist (nicht gelöscht oder deaktiviert).
Prüfen Sie die Kassierer-Berechtigungen. PAYMENT_MANAGE muss gewährt sein, um alle Methoden zu sehen.

Client-Anzeigeprobleme

Client-Leerlaufbildschirm ist leer

Symptome: Der Leerlaufbildschirm zeigt nichts statt der konfigurierten Diashow.

Lösungen:

Überprüfen Sie, ob der Leerlaufbildschirm unter Einstellungen > Clients > Leerlaufbildschirm aktiviert ist.
Prüfen Sie, ob mindestens ein Medienelement (Bild oder Video) hinzugefügt wurde.
Überprüfen Sie, ob die Mediendateien gültig und nicht beschädigt sind.
Lösen Sie eine Synchronisierung aus, um die neuesten Einstellungen an den Client zu übertragen.

Client-Menü zeigt keine Apps

Symptome: Der App-Launcher ist leer oder Kategorien fehlen.

Lösungen:

Überprüfen Sie, ob Apps und Kategorien unter Einstellungen > Clients > Inhalt konfiguriert sind.
Prüfen Sie, ob Kategorien und Apps die Sichtbarkeit aktiviert haben.
Überprüfen Sie, ob der Client die neuesten Menüdaten erhalten hat (Änderungen werden automatisch per TCP übertragen).
Starten Sie den Client neu, falls die Echtzeitsynchronisierung nicht gegriffen hat.

Remote-Desktop-Probleme

Remote-Desktop ist verzögert oder ruckelt

Symptome: Das Videobild ist verzögert, stottert oder hat eine niedrige Bildrate.

Lösungen:

Senken Sie die Bitrate (versuchen Sie 1000-2000 kbps für Standard-LAN-Nutzung).
Reduzieren Sie die FPS-Einstellung.
Verwenden Sie kabelgebundenes Ethernet anstelle von WLAN.
Prüfen Sie auf Netzwerküberlastung oder hohen Bandbreitenverbrauch durch andere Anwendungen.
Stellen Sie sicher, dass UDP-Port 5004 nicht blockiert oder ratenbegrenzt ist.

Remote-Desktop zeigt schwarzen Bildschirm

Symptome: Das Remote-Desktop-Fenster öffnet sich, zeigt aber nur schwarz.

Lösungen:

Überprüfen Sie, ob der Client online und reaktionsfähig ist (versuchen Sie zuerst einen Screenshot).
Prüfen Sie, ob UDP-Port 5004 bidirektional geöffnet ist.
Der Grafiktreiber des Clients muss möglicherweise aktualisiert werden.
Versuchen Sie, eine Schlüsselbild-Aktualisierung anzufordern.

Lizenzprobleme

Lizenz zeigt "offline_grace"

Symptome: Lizenzstatus zeigt offline_grace mit einem Countdown.

Lösungen:

Stellen Sie die Internetverbindung auf dem Server-PC wieder her.
Prüfen Sie die DNS-Auflösung. Der Server muss den Lizenzierungsserver erreichen.
Prüfen Sie auf Proxy oder Firewall, die ausgehende HTTPS-Verbindungen blockieren.
Sie haben 72 Stunden zur Wiederherstellung der Verbindung, bevor der Server gesperrt wird.

Lizenz zeigt "over_limit"

Symptome: Mehr Clients sind verbunden, als die Lizenz erlaubt.

Lösungen:

Trennen Sie ungenutzte Clients, die nicht in Gebrauch sind.
Prüfen Sie die aktuelle Client-Anzahl gegenüber Ihrem Lizenzlimit.
Erweitern Sie Ihre Lizenz für mehr PC-Kapazität.
Beachten Sie: Konsolen zählen zum Gesamt-PC-Limit.

Allgemeine Probleme

Einstellungsänderungen werden nicht gespeichert

Symptome: Änderungen werden nach dem Verlassen der Einstellungen zurückgesetzt.

Lösungen:

Stellen Sie sicher, dass Sie die Speichern-Schaltfläche nach Änderungen anklicken.
Prüfen Sie auf Validierungsfehler (hervorgehobene Felder mit Fehlermeldungen).
Überprüfen Sie Ihre Admin-Berechtigungen.

Audit-Protokolle fehlen Einträge

Symptome: Erwartete Aktionen erscheinen nicht auf der Protokollseite.

Lösungen:

Prüfen Sie die Protokollfilter. Stellen Sie sicher, dass die richtige Kategorie und der richtige Zeitraum ausgewählt sind.
Überprüfen Sie, ob die LOG_DISPLAY_FULL-Berechtigung gewährt ist (andernfalls werden nur heutige Protokolle angezeigt).
Verwenden Sie die Textsuchfunktion für die spezifische Aktion.