Mga Setting ng Legacy Clients
Ang HandyCafe ay tumatakbo kasabay ng mas lumang V3 at V4 na mga pag-install ng kliyente nang walang abala. Ang settings page ng Legacy Clients ang nagko-control sa Runtime Protocol: ang mga network listener na nagpapahintulot sa mga kliyente ng V3 at V4 na kumonekta sa server na ito gamit ang kanilang orihinal na mga port.
Ang pag-import ng datos mula sa mas lumang pag-install ay isang hiwalay na gawain sa sarili nitong settings page. Tingnan ang Paglipat ng Datos. Magkahiwalay ang dalawang tampok. Gumagana ang runtime support kahit walang paglilipat ng anumang datos. Gumagana ang isang migration kahit walang runtime support. Maaari mo ring gamitin ang dalawa nang magkasama.
Seksyon ng Runtime Protocol
Enable Legacy Client Support
Master toggle ito sa itaas ng section. Kapag naka-on, nagsisimula ang server ng tatlong network listener:
- UDP listener sa naka-configure na multicast group.
- TCP command listener sa
UDP port + 2. - TCP file transfer listener sa
UDP port + 7.
Kapag in-off ang toggle, sabay-sabay na humihinto ang tatlong listener. Maaari mong ayusin ang port number o encoding habang naka-disable, pagkatapos ay i-enable muli para maisagawa ang mga pagbabago.
Mga Field ng Configuration
| Field | Default | Paglalarawan |
|---|---|---|
| Auth Key | HANDYCAFE | Shared na 10-character key. Lahat ng inbound at outbound frame ay may bitbit na string na ito. Ang mga frame na hindi tugma ay dini-drop. Kailangang pareho ang key ng lahat ng legacy client mo. |
| UDP Multicast IP | 230.4.4.46 | Ang multicast group na ginagamit para sa client discovery beacons at UDP-based command dispatch. Hard-coded ito sa karamihan ng legacy client build. |
| Server UDP Port | 710 | Ang UDP port na pinakikinggan ng server para sa client beacons at commands. Dito nagpapadala ang legacy clients. |
| Client UDP Port | 711 | Ang UDP port na pinakikinggan ng legacy clients. Nagpapadala ang server ng unicast management command sa port na ito sa natuklasang client IP. |
| Encoding | cp1254 | Character encoding para sa wire-format string fields. Gamitin ang cp1254 para sa Turkish installations, cp1252 para sa Western European. Ang hindi kilalang value ay babalik sa cp1254 na may warning sa server log. |
| Server Version | 3.4.01 | Ang version string na ibinobroadcast sa bawat UDP beacon. Ang ilang legacy client ay nagre-reject ng frame mula sa version na hindi nila nakikilala. Itakda ito para tumugma sa version string ng iyong orihinal na server. |
| Protocol Variant | STE | Wire format selection. Tingnan ang comparison ng variant sa ibaba. |
| Inactivity Timeout | 10 | Segundo. Per-MAC watchdog. Kung walang traffic mula sa isang client sa window na ito, mamamarkahan ang client bilang offline. Ang 10 segundo ay angkop para sa legacy client na nagbe-beacon kada 2 o 3 segundo. |
Mga Derivative na Port
Sa ibaba ng form, may read-only line ang page na nagpapakita ng derived TCP ports:
TCP Command Port: 712 File Transfer Port: 717
Kinukuwenta ang mga port na ito mula sa UDP server port. Hindi mo sila hiwalay na kino-configure. Kapag binago mo ang Server UDP Port sa ibang value, sabay ring lilipat ang derived ports.
Protocol Variant
Pinipili ng Protocol Variant field ang wire format na ginagamit ng server. Piliin ang variant na tumutugma sa kung paano ginawa ang legacy server mo.
| Variant | Kailan Gagamitin |
|---|---|
| STE (Smart/Turbo Edition) | Ang mas bagong legacy codebase. Nagdadagdag ito ng 70-byte license-info prefix sa frame structure. Ang frame size ay 1337 bytes. Piliin ito kung Smart o Turbo edition ang ginamit ng legacy installation mo. |
| Standard | Ang plain na baseline legacy build. Ang frame size ay 1267 bytes na walang license-info prefix. Piliin lamang ito kung Standard edition ang legacy installation mo na walang license registration. |
Kapag mali ang variant na pinili, madi-drop o mali ang basa sa mga frame. Kasama sa sintomas ang mukhang online na client pero hindi pinapansin ang kahit anong command, o command data na na-shift ng 70-byte offset.
Pagsasabay sa Modern Clients
Ganap na hiwalay ang legacy ports (710, 711, 712, 717) mula sa modern HandyCafe protocol ports (TCP 5001, 5002, 5003, UDP 5004). Sabay na tumatakbo ang parehong protocol stack nang walang conflict. Maaari mong pagsabayin ang luma at bagong client sa iisang LAN at i-manage sila mula sa iisang Admin Panel.
Paglalapat ng Mga Pagbabago
Lahat ng field sa Runtime Protocol section ay nase-save gamit ang global Save button sa ibaba ng page. Kapag nag-save, ang server:
- Humihinto sa tatlong legacy listener kung tumatakbo ang mga ito.
- Bine-validate ang auth key (hindi dapat empty).
- Gumagawa ng bagong listener configuration mula sa mga updated field.
- Muling sini-start ang mga listener nang sabay-sabay.
- Nagpapadala ng notification kapag online na ulit ang tatlo.
Kung may port nang gamit ng ibang process, magre-report ang server ng error at babalik sa off ang toggle. Suriin ang firewall at iba pang service gamit ang netstat at pumili ng libreng port range.
Database Migration
Ang pag-import ng data mula sa isang HandyCafe 3.x o 4.x na pag-install ay hindi na ginagawa sa pahinang ito. Ito ay matatagpuan sa pahina ng settings na Paglipat ng Datos sa ilalim ng HandyCafe Legacy na source, kasama ng EveryCafe at Pancafe importers.
Tinalakay ng pahinang iyon ang pagtukoy ng lumang pag-install, kung anu-ano ang na-import, ang read-only na garantiya sa mga source file, muling pagpapagana ng isang import, at pagbabalik ng isa. Para sa step-by-step na pag-walkthrough, tingnan ang Paano Mag-migrate mula sa Legacy Installation.
Mga Tip
- I-stop ang legacy server bago magpatakbo ng migration. Kung nagsusulat pa ang legacy system sa database nito, maaaring makakita ang import ng luma o putol na data.
- Itugma ang Encoding field sa iyong legacy locale bago ang unang migration. Kapag binago mo ito pagkatapos ma-import ang data, hindi na nito maaayos ang mga sirang pangalan na naitala na.
- Palaging magpatakbo muna ng test migration. Suriin ang record counts sa ilalim ng "Last Counts" at i-spot-check ang ilang member at transaction row bago ipagamit sa staff ang bagong system.
- I-enable ang runtime support at panatilihing konektado ang iyong legacy clients sa transition period. Makakatulong ito para ma-verify na pareho ang serbisyo ng bagong server bago tuluyang i-retire ang luma.
- Kapag binago mo ang Server UDP Port, tandaan na kasabay ding lilipat ang derived command at file transfer ports. Kailangang i-update ang firewall rules ayon dito.