Mga Setting ng Legacy Clients
Tumatakbo ang HandyCafe kasabay ng mas lumang V3 at V4 client installation nang walang abala. Kinokontrol ng pahina ng Legacy Clients settings ang dalawang magkaibang feature:
- Runtime Protocol. I-e-enable nito ang network listeners na nagpapahintulot sa V3 at V4 clients na kumonekta sa server na ito gamit ang orihinal nilang ports.
- Database Migration. Opsyonal na ini-import nito ang members, pricing, products, orders, transactions, at logs mula sa lumang local installation papunta sa bagong HandyCafe database. Windows lang ito.
Independent ang dalawang feature. Maaari kang mag-enable ng runtime support nang walang data migration, mag-migrate ng data nang walang runtime support, o gawin pareho.
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.
Seksyon ng Database Migration (Windows Only)
Available lamang ang feature na ito kapag tumatakbo ang HandyCafe sa Windows. Sa macOS at Linux, makikita ang notice na: "Database migration is supported on Windows only."
Detection
Sa pagbukas, sinusuri ng server ang system para sa legacy installation. Tinitingnan nito ang:
- Registry at karaniwang install path tulad ng
Program Files\HandyCafeatC:\HandyCafe. - Database file sa tabi ng installation.
- Configuration INI files sa installation directory.
Kapag matagumpay ang detection, ipinapakita ng page ang:
| Label | Kahulugan |
|---|---|
| Install Path | Saan matatagpuan sa disk ang legacy installation. |
| Database Path | Buong path papunta sa legacy database file. |
| Server Version | Na-parse mula sa legacy configuration. |
| INI File Count | Bilang ng configuration file na natukoy. Kapaki-pakinabang ito para masigurong kumpleto ang installation. |
Kung walang natukoy na installation, ipapakita ng page ang "No legacy installation detected." Maaari mo pa ring i-enable ang runtime support; wala lang talagang mao-import ang migration feature.
Migration Status
Mino-monitor ng page ang migration history:
| Status | Kahulugan |
|---|---|
| never | Hindi ka pa nagra-run ng migration. |
| in_progress | Kasalukuyang tumatakbo ang migration. Huwag isara ang server sa state na ito. |
| completed | Ang pinakahuling migration ay natapos nang walang warning. |
| completed_with_warnings | Natapos ang pinakahuling migration pero may ilang record na nilaktawan (halimbawa dahil sa encoding errors o malformed dates). Suriin ang mga warning bago magpatuloy. |
| undone | Na-roll back ang pinakahuling migration. |
Pagkatapos ng unang matagumpay na run, nagiging Re-run Migration ang label ng Start Migration button.
Ano ang Minamigrate
| Table | Paglalarawan |
|---|---|
| Members | Mga customer record na may pangalan, contact info, at account balance. |
| Pricing | Mga price table at hour-by-hour rate. |
| Products | Mga entry sa product catalog. |
| Orders | Kasaysayan ng order na may session reference. |
| Transactions | Ledger entry na may timestamp, halaga, at payment method. |
| Logs | Audit at warning entry mula sa legacy database. |
Ang "Files Safe" Guarantee
Nagpapakita ang page ng notice sa asul: "The original database files are not deleted. You can safely delete them once migration is confirmed." Read-only ang migration sa source. Kahit ilang beses mo pa itong patakbuhin, hindi naaantig ang orihinal na legacy database. Nagbibigay ito sa iyo ng puwang para subukan ang import, suriin ang counts, at mag-roll back nang walang panganib.
Start, Re-run, at Undo
- Start Migration. Nagbubukas ng progress modal. Ipinapakita ng modal ang kasalukuyang phase at record counts habang tumatakbo ang import. Huwag isara ang HandyCafe sa panahong ito.
- Re-run Migration. Available pagkatapos ng completed run. Inuulit nito ang import mula sa simula. Pinapalitan ng bagong import ang dating data sa HandyCafe.
- Undo Migration. Available pagkatapos ng completed run. Nagbubukas ng confirmation dialog. Kapag kinumpirma, lahat ng na-migrate na row ay dini-delete mula sa HandyCafe. Hindi nahahawakan ang legacy source. Pagkatapos ng undo, babalik ang status sa
never.
Completed with Warnings
Kung matatapos ang migration na may completed_with_warnings, may lalabas na dilaw na banner na may Details link. I-click ito para makita ang listahan ng nilaktawang record at ang dahilan. Karaniwang dahilan:
- Encoding mismatch. May mga character sa source row na hindi malinis na nade-decode sa naka-configure na encoding. Palitan ang encoding field (cp1254 o cp1252) at i-run muli ang migration.
- Malformed dates. May ilang legacy record na may invalid na time stamp. Nilalaktawan ito para ma-import pa rin ang valid na row.
- Duplicate keys. May record na may parehong identifier na umiiral na sa HandyCafe. Pinapanatili ng migration ang existing record at nilalaktawan ang duplicate.
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.