🔌 Hardware-Agent & Cloud-Failover¶
Im Cloud-Betrieb läuft die Kasse auf {name}.next.dikas.de — die echte Hardware (EC-Terminal,
Bondrucker) steht aber im Laden. Der Hardware-Agent schlägt diese Brücke: ein schlankes
Programm im Laden-Netz, das Zahlungen und Drucke lokal ausführt und über eine ausgehende
Verbindung zur Cloud gesteuert wird. So funktioniert die Hardware auch dann, wenn die Kasse nicht
mehr lokal, sondern in der Cloud läuft.
Wer braucht das?
Standorte, die ihre Kasse (zeitweise oder dauerhaft) in der Cloud betreiben, aber lokale Geräte nutzen. Rein lokal betriebene Kassen sprechen ihre Hardware direkt an und brauchen den Agenten nicht. Siehe auch Cloud & lokale Maschine.
Wer kann Agent sein?¶
Der Hardware-Agent steckt bereits in den DiKAS-Geräte-Apps — es muss nichts extra installiert werden:
| Host | Plattform | Rolle |
|---|---|---|
| DikasArch-Appliance | Mini-PC (Arch Linux, Electron-Kiosk) | Kasse und Hardware-Agent in einem |
| DiKAS Mobile | Android (MAUI-App) | Mobile Kasse mit Agent-Funktion |
| DiKAS Geräte-Agent | Android-Tablet | reiner Hardware-Agent (ohne Kassen-UI) |
Jedes Gerät im Laden-Netz kann Agent sein. Sind mehrere verbunden, übernimmt eines die Aufgabe; fällt eines aus, bedienen die anderen weiter.
Was läuft über den Agenten?¶
| Funktion | Über den Agenten |
|---|---|
| EC-/Kartenzahlung (ZVT) | ✓ Zahlung, Storno, Gutschrift, Kassenschnitt — am Netzwerk-Terminal |
| Bon-/Belegdruck (ESC/POS) | ✓ an Netzwerk-Bondrucker bzw. lokal angeschlossene USB-/Seriell-Drucker |
| Geräte-Suche im Netz | ✓ Terminals und Drucker im Laden-Netz finden |
| A4-Dokumentdruck (CUPS) | ✓ über die lokale Drucker-Bridge der Appliance |
| TSE-Signatur | ✗ — die TSE bleibt an die lokale Kasse gebunden (bzw. Cloud-TSE), siehe TSE |
Direkt vs. Agent — automatisch
Erreicht der Server das Gerät direkt im Netz (lokaler Betrieb), spricht DiKAS es direkt an. Ist die Kasse in der Cloud und ein Agent verbunden, läuft es automatisch über den Agenten — ohne Umschalten in der Bedienung.
Kopplung (Pairing)¶
Der Agent verbindet sich von sich aus zur Cloud (ausgehend, NAT-freundlich — keine Portfreigabe nötig). Authentifiziert wird pro Mandant über ein aus der Lizenz abgeleitetes Secret.
- DikasArch-Appliance: koppelt sich automatisch — sie kennt ihren Mandanten aus der Lizenz und
leitet Cloud-Adresse (
{name}.next.dikas.de) und Pairing-Secret selbst ab. - Tablet/Mobile: Kopplung per QR-Code aus dem Admin-Bereich (Cloud-Adresse + Secret).
Den Verbindungsstatus (verbundene Geräte) zeigt der Admin-Bereich unter Einstellungen → Hardware → Hardware-Agent.
Cloud-Failover: lokaler Server fällt aus¶
Geht der lokale Kassenserver offline (Stromausfall, Netzwerk, Defekt), muss der Betrieb weiterlaufen. DiKAS erkennt den Ausfall und bietet den Wechsel in die Cloud an:
- Die Kasse prüft regelmäßig, ob der lokale Server erreichbar ist.
- Fällt er aus und die Cloud ist erreichbar, erscheint unten ein Hinweis: „Lokaler Server nicht erreichbar — auf Cloud wechseln?"
- Nach Bestätigung lädt die Kasse die Cloud-Adresse
{name}.next.dikas.de. Die lokalen Einstellungen (Arbeitsplatz, Drucker-/Terminal-Zuordnung) werden übernommen, der Benutzername ist vorausgefüllt — nur neu anmelden. - Hardware läuft weiter: EC-Zahlung und Bondruck gehen jetzt über den Hardware-Agenten, der unabhängig vom Kassenserver weiterläuft. A4-Drucke laufen über die lokale Drucker-Bridge.
- Ist der lokale Server zurück, bietet die Kasse den Rückwechsel an.
Warum der Agent den Ausfall überlebt
Auf der DikasArch-Appliance läuft der Hardware-Agent als eigener Dienst, getrennt vom Kassenserver. Stürzt der Kassenserver ab, bleibt der Agent verbunden — die Geräte sind im Cloud-Modus weiter bedienbar.
Sofort-Weiterleitung (Relay) im Failover
Die Relay-Weiterleitung setzt den laufenden lokalen Server voraus und steht im Failover daher nicht zur Verfügung. Lokaler Druck und EC im Cloud-Modus laufen über den Hardware-Agenten (bzw. die Drucker-Bridge für A4).
Manuell online wechseln¶
Auch ohne Ausfall lässt sich aus dem lokalen Betrieb in die Cloud wechseln — z. B. um von unterwegs weiterzuarbeiten. Im Hauptmenü der Kasse erscheint dafür (auf Appliance und Mobile, sobald eine Cloud-Adresse bekannt ist) der Eintrag „Online wechseln". Er führt denselben Wechsel wie beim Failover aus.
Häufige Fragen¶
Muss ich auf der Appliance etwas installieren? Nein. Der Agent ist Teil der DikasArch-Software und koppelt sich automatisch über die Lizenz.
Funktionieren EC-Zahlung und Druck wirklich, wenn der lokale Server aus ist? Ja — über den Hardware-Agenten, sofern ein Gerät im Laden-Netz verbunden ist. Die Cloud muss die Geräte (Terminal-/Drucker-Adressen) kennen; diese werden über die Geräte-Suche gefunden und gespeichert.
Was, wenn kein Agent verbunden ist? Im Cloud-Modus meldet die Kasse dann eine klare Fehlermeldung („kein Hardware-Agent verbunden") — EC/Druck sind erst wieder möglich, wenn ein Gerät verbunden ist.
Werden Belege im Failover doppelt belastet? Nein. Geht das Ergebnis einer Zahlung verloren, meldet die Kasse einen Fehler statt automatisch zu wiederholen — eine Doppelbelastung wird so vermieden.