Einstellungen für Legacy-Clients
HandyCafe läuft parallel zu älteren V3- und V4-Client-Installationen ohne Unterbrechung. Die Einstellungsseite der Legacy Clients steuert das Runtime Protocol: die Netzwerk-Listener, die es V3- und V4-Clients ermöglichen, sich mit diesem Server über ihre ursprünglichen Ports zu verbinden.
Das Importieren von Daten aus einer älteren Installation ist ein separater Vorgang auf seiner eigenen Einstellungsseite. Siehe Datenmigration. Die beiden Funktionen sind unabhängig voneinander. Die Laufzeitunterstützung funktioniert ohne Datenmigration. Eine Migration funktioniert ohne Laufzeitunterstützung. Sie können auch beide Funktionen zusammen verwenden.
Bereich Laufzeitprotokoll
Unterstützung für Legacy-Clients Aktivieren
Ein Hauptschalter oben im Bereich. Wenn er aktiviert ist, startet der Server drei Netzwerk-Listener:
- Ein UDP-Listener auf der konfigurierten Multicast-Gruppe.
- Ein TCP-Befehls-Listener auf
UDP port + 2. - Ein TCP-Dateiübertragungs-Listener auf
UDP port + 7.
Wenn Sie den Schalter deaktivieren, werden alle drei Listener atomar gestoppt. Sie können Portnummern oder Kodierung im deaktivierten Zustand anpassen und anschließend wieder aktivieren, um die Änderungen anzuwenden.
Konfigurationsfelder
| Feld | Standard | Beschreibung |
|---|---|---|
| Auth-Schlüssel | HANDYCAFE | Ein gemeinsamer 10-stelliger Schlüssel. Jeder eingehende und ausgehende Frame trägt diesen String. Frames, die nicht übereinstimmen, werden verworfen. Alle Legacy-Clients müssen denselben Schlüssel verwenden. |
| UDP-Multicast-IP | 230.4.4.46 | Die Multicast-Gruppe für Client-Erkennungsbeacons und UDP-basierte Befehlsauslieferung. In den meisten Legacy-Client-Builds fest verdrahtet. |
| Server-UDP-Port | 710 | Der UDP-Port, auf dem der Server auf Client-Beacons und Befehle hört. Legacy-Clients senden an diesen Port. |
| Client-UDP-Port | 711 | Der UDP-Port, auf dem Legacy-Clients lauschen. Der Server sendet unicast Management-Befehle an diesen Port auf der entdeckten Client-IP. |
| Kodierung | cp1254 | Zeichencodierung für String-Felder im Wire-Format. Verwenden Sie cp1254 für türkische Installationen, cp1252 für westeuropäische. Unbekannte Werte fallen mit einer Warnung im Server-Log auf cp1254 zurück. |
| Serverversion | 3.4.01 | Die Versionszeichenfolge, die in jedem UDP-Beacon ausgesendet wird. Einige Legacy-Clients verwerfen Frames von Versionen, die sie nicht erkennen. Passen Sie sie an die Versionszeichenfolge Ihres ursprünglichen Servers an. |
| Protokollvariante | STE | Auswahl des Wire-Formats. Siehe den Variantenvergleich unten. |
| Inaktivitäts-Timeout | 10 | Sekunden. Ein Watchdog pro MAC. Wenn innerhalb dieses Fensters kein Verkehr von einem Client eingeht, wird der Client offline markiert. Ein Abstand von 10 Sekunden ist für Legacy-Clients geeignet, die alle 2 oder 3 Sekunden Beacons senden. |
Abgeleitete Ports
Unter dem Formular zeigt die Seite eine schreibgeschützte Zeile mit den abgeleiteten TCP-Ports:
TCP Command Port: 712 File Transfer Port: 717
Diese Ports werden aus dem UDP-Serverport berechnet. Sie werden nicht separat konfiguriert. Wenn Sie den Server-UDP-Port ändern, verschieben sich die abgeleiteten Ports automatisch mit.
Protokollvariante
Das Feld Protokollvariante wählt das vom Server verwendete Wire-Format. Wählen Sie die Variante, die dazu passt, wie Ihr Legacy-Server gebaut wurde.
| Variante | Wann verwenden |
|---|---|
| STE (Smart/Turbo Edition) | Die moderne Legacy-Codebasis. Fügt der Frame-Struktur ein 70-Byte-Lizenzinfo-Präfix hinzu. Framegröße: 1337 Bytes. Wählen Sie dies, wenn Ihre Legacy-Installation die Smart- oder Turbo-Edition verwendete. |
| Standard | Der einfache Legacy-Standardbuild. Framegröße: 1267 Bytes ohne Lizenzinfo-Präfix. Wählen Sie dies nur, wenn Ihre Legacy-Installation eine Standard-Edition ohne Lizenzregistrierung war. |
Die falsche Variante führt dazu, dass Frames verworfen oder falsch gelesen werden. Symptome sind Clients, die online erscheinen, aber jeden Befehl ignorieren, oder Befehlsdaten, die um den 70-Byte-Offset verschoben sind.
Parallelbetrieb Mit Modernen Clients
Die Legacy-Ports (710, 711, 712, 717) sind vollständig von den modernen HandyCafe-Protokollports (TCP 5001, 5002, 5003, UDP 5004) getrennt. Beide Protokollstapel laufen gleichzeitig ohne Konflikte. Sie können alte und neue Clients im selben LAN mischen und über dasselbe Admin-Panel verwalten.
Änderungen Anwenden
Jedes Feld im Bereich Laufzeitprotokoll wird mit der globalen Speichern-Schaltfläche am unteren Rand der Seite gesichert. Beim Speichern:
- stoppt der Server die drei Legacy-Listener, falls sie liefen.
- validiert er den Auth-Schlüssel (er darf nicht leer sein).
- erstellt er aus den aktualisierten Feldern neue Listener-Konfigurationen.
- startet er die Listener parallel neu.
- löst er eine Benachrichtigung aus, wenn alle drei wieder online sind.
Wenn ein Port bereits von einem anderen Prozess belegt ist, meldet der Server einen Fehler und der Schalter springt wieder aus. Prüfen Sie Ihre Firewall und andere Dienste mit netstat und wählen Sie einen freien Portbereich.
Datenbankmigration
Der Import von Daten aus einer HandyCafe 3.x- oder 4.x-Installation erfolgt nicht mehr auf dieser Seite. Er befindet sich auf der Datenmigration-Einstellungsseite unter der HandyCafe Legacy-Quelle, zusammen mit den EveryCafe- und Pancafe-Importern.
Diese Seite behandelt die Erkennung der alten Installation, was importiert wird, die Schreibschutzgarantie für die Quelldateien, das erneute Ausführen eines Imports und das Rückgängigmachen eines Imports. Für eine Schritt-für-Schritt-Anleitung siehe Wie man von einer älteren Installation migriert.
Tipps
- Stoppen Sie den Legacy-Server vor einer Migration. Wenn das Legacy-System noch in seine Datenbank schreibt, kann der Import veraltete oder unvollständige Daten sehen.
- Passen Sie das Kodierungsfeld vor der ersten Migration an Ihre Legacy-Locale an. Wenn Sie es nach dem Import ändern, werden bereits beschädigte Namen nicht rückwirkend repariert.
- Führen Sie immer zuerst eine Testmigration aus. Prüfen Sie die Datensatzanzahlen unter "Letzte Zählwerte" und kontrollieren Sie stichprobenartig einige Mitglieder- und Transaktionszeilen, bevor Sie das Personal auf das neue System umstellen.
- Aktivieren Sie die Laufzeitunterstützung und lassen Sie Ihre Legacy-Clients während einer Übergangszeit verbunden. So können Sie prüfen, ob der neue Server sie identisch bedient, bevor Sie den alten Server außer Betrieb nehmen.
- Wenn Sie den Server-UDP-Port ändern, denken Sie daran, dass sich die abgeleiteten Befehls- und Dateiübertragungsports mit verschieben. Firewall-Regeln müssen entsprechend aktualisiert werden.