Setări pentru clienți legacy
HandyCafe funcționează alături de vechile instalări de clienți V3 și V4 fără întreruperi. Pagina de setări a Clienților Legacy controlează Protocolul de Rulare: listener-ii de rețea care permit clienților V3 și V4 să se conecteze la acest server pe porturile lor originale.
Importul datelor dintr-o instalare mai veche este o sarcină separată pe propria sa pagină de setări. Vezi Migrarea Datelor. Cele două funcții sunt independente. Suportul de rulare funcționează fără a migra vreun fel de date. O migrare funcționează fără suport de rulare. De asemenea, le poți utiliza împreună.
Secțiunea Runtime Protocol
Enable Legacy Client Support
Un comutator principal în partea de sus a secțiunii. Când este activ, serverul pornește trei ascultători de rețea:
- Un ascultător UDP pe grupul multicast configurat.
- Un ascultător TCP de comenzi pe
UDP port + 2. - Un ascultător TCP pentru transfer de fișiere pe
UDP port + 7.
Dezactivarea comutatorului oprește atomic toți cei trei ascultători. Puteți ajusta porturile sau codarea cât timp funcția este dezactivată, apoi o activați din nou pentru a aplica modificările.
Câmpuri de configurare
| Câmp | Implicit | Descriere |
|---|---|---|
| Auth Key | HANDYCAFE | O cheie comună de 10 caractere. Fiecare cadru de intrare și ieșire poartă acest șir. Cadrele care nu se potrivesc sunt eliminate. Toți clienții legacy trebuie să folosească aceeași cheie. |
| UDP Multicast IP | 230.4.4.46 | Grupul multicast folosit pentru beaconi de descoperire și pentru trimiterea comenzilor prin UDP. Codificat direct în majoritatea build-urilor legacy. |
| Server UDP Port | 710 | Portul UDP pe care serverul ascultă pentru beaconi și comenzi de la clienți. Clienții legacy trimit către acest port. |
| Client UDP Port | 711 | Portul UDP pe care ascultă clienții legacy. Serverul trimite comenzi de administrare unicast către acest port pe IP-ul clientului descoperit. |
| Encoding | cp1254 | Codarea caracterelor pentru câmpurile text din wire format. Folosiți cp1254 pentru instalările turcești, cp1252 pentru Europa de Vest. Valorile necunoscute revin la cp1254 cu un avertisment în jurnalul serverului. |
| Server Version | 3.4.01 | Șirul de versiune difuzat în fiecare beacon UDP. Unele clienți legacy resping cadrele venite de la versiuni pe care nu le recunosc. Setați această valoare astfel încât să corespundă versiunii serverului original. |
| Protocol Variant | STE | Selectarea formatului wire. Vedeți comparația variantelor de mai jos. |
| Inactivity Timeout | 10 | Secunde. Un watchdog per MAC. Dacă nu ajunge trafic de la un client în acest interval, clientul este marcat offline. Un interval de 10 secunde este potrivit pentru clienții legacy care trimit beacon la fiecare 2 sau 3 secunde. |
Porturi derivate
Sub formular, pagina afișează o linie doar pentru citire care arată porturile TCP derivate:
TCP Command Port: 712 File Transfer Port: 717
Aceste porturi sunt calculate pornind de la portul UDP al serverului. Nu le configurați separat. Dacă schimbați Server UDP Port cu o altă valoare, porturile derivate se modifică automat odată cu el.
Varianta de protocol
Câmpul Protocol Variant selectează formatul wire folosit de server. Alegeți varianta care corespunde modului în care a fost construit serverul legacy.
| Varianta | Când se folosește |
|---|---|
| STE (Smart/Turbo Edition) | Codul legacy modern. Adaugă un prefix de 70 de bytes cu informații despre licență la structura cadrului. Dimensiunea cadrului este 1337 bytes. Alegeți această variantă dacă instalarea legacy folosea ediția Smart sau Turbo. |
| Standard | Build-ul legacy de bază, simplu. Dimensiunea cadrului este 1267 bytes, fără prefixul cu informații despre licență. Alegeți această variantă doar dacă instalarea dvs. legacy era o ediție Standard fără înregistrarea licenței. |
Alegerea variantei greșite duce la aruncarea sau interpretarea greșită a cadrelor. Simptomele includ clienți care apar online, dar ignoră orice comandă, sau datele de comandă deplasate cu offset-ul de 70 de bytes.
Coexistența cu clienții moderni
Porturile legacy (710, 711, 712, 717) sunt complet separate de porturile moderne ale protocolului HandyCafe (TCP 5001, 5002, 5003, UDP 5004). Ambele stive de protocol rulează simultan fără conflict. Puteți combina clienți vechi și noi în aceeași rețea LAN și îi puteți administra din același Admin Panel.
Aplicarea modificărilor
Fiecare câmp din secțiunea Runtime Protocol este salvat cu butonul global Save din partea de jos a paginii. La salvare, serverul:
- Oprește cei trei ascultători legacy dacă rulau deja.
- Validează cheia de autentificare (nu trebuie să fie goală).
- Construieste noile configurații de ascultare din câmpurile actualizate.
- Repornește ascultătorii în paralel.
- Afișează o notificare când toți trei sunt din nou online.
Dacă un port este deja folosit de alt proces, serverul raportează o eroare și comutatorul revine pe off. Verificați firewall-ul și celelalte servicii cu netstat și alegeți un interval de porturi liber.
Migrarea bazei de date
Importul de date dintr-o instalare HandyCafe 3.x sau 4.x nu mai are loc pe această pagină. Acum se găsește pe pagina de setări Migrarea Datelor sub sursa HandyCafe Legacy, alături de importatorii EveryCafe și Pancafe.
Acea pagină acoperă detectarea vechii instalări, ce se importă, garanția de doar citire asupra fișierelor sursă, reluarea unui import și anularea unuia. Pentru un ghid pas cu pas, consultați Cum migrați dintr-o instalare legacy.
Sfaturi
- Opriți serverul legacy înainte de a rula o migrare. Dacă sistemul vechi încă scrie în baza lui de date, importul poate vedea date vechi sau parțiale.
- Potriviți câmpul Encoding cu locale-ul legacy înainte de prima migrare. Schimbarea lui după ce datele au fost importate nu repară retroactiv numele deja corupte.
- Rulați întotdeauna mai întâi o migrare de test. Verificați numărul de înregistrări în "Last Counts" și verificați manual câteva rânduri de membri și tranzacții înainte să faceți tranziția personalului pe noul sistem.
- Activați suportul runtime și păstrați clienții legacy conectați o perioadă de tranziție. Asta vă permite să verificați că noul server îi servește identic înainte să îl retrageți pe cel vechi.
- Dacă schimbați Server UDP Port, nu uitați că porturile derivate pentru comenzi și transfer de fișiere se mută odată cu el. Regulile de firewall trebuie actualizate corespunzător.