Paano Mag-migrate mula sa Legacy Installation
Ang gabay na ito ay nag-i-import ng iyong kasalukuyang data mula sa mas lumang HandyCafe V3 o V4 installation papunta sa modernong HandyCafe server. Ang migration ay hindi nakakasira sa pinagmulan: ang mga orihinal na file ay hindi binabago o binubura.
Ang database migration ay tumatakbo lamang sa Windows. Ang runtime support para sa legacy clients na kumonekta gamit ang orihinal na protocol ay gumagana sa bawat platform (tingnan ang Legacy Clients Settings).
Ano ang Kailangan Mo
- Isang Windows machine na may parehong legacy installation at modernong HandyCafe server sa parehong sistema, o access sa legacy database file.
- Admin access sa HandyCafe Server.
- Ang legacy server ay nakahinto. Ang source database ay hindi dapat aktibong sinusulatan habang nagmi-migrate.
- Libreng disk space na katumbas ng laki ng legacy database (para sa bagong kopya ng HandyCafe database).
- 10 hanggang 30 minuto ng tuloy-tuloy na oras. Ang migration sa malalaking dataset ay maaaring tumagal ng ilang minuto. Huwag isara ang HandyCafe habang tumatakbo.
Hakbang 1: Ihinto ang Legacy Server
Buksan ang legacy HandyCafe server application. Ihinto ang lahat ng session at lumabas sa application. Kung ang legacy server ay tumatakbo bilang Windows service, ihinto ang serbisyo mula sa services.msc.
Inaasahang resulta: Ang proseso ng legacy server ay hindi na tumatakbo. Ang database file ay hindi hawak na bukas.
Hakbang 2: Buksan ang Legacy Clients Settings Page
- Ilunsad ang HandyCafe.
- Buksan ang Settings sa sidebar.
- I-click ang Legacy Clients.
- Mag-scroll sa seksyong Database Migration.
Inaasahang resulta: Kung ang sistema ay nakakita ng legacy installation, ang pahina ay magpapakita ng install path, database path, server version, at bilang ng INI file. Kung walang nakita, ang pahina ay magsasabi ng "No legacy installation detected." Sa kasong iyon, tiyakin na ang mga legacy file ay umiiral sa karaniwang lokasyon tulad ng Program Files\HandyCafe o C:\HandyCafe.
Hakbang 3: Suriin ang Natukoy na Installation
Tiyakin na ang mga natukoy na halaga ay tumutugma sa iyong kilalang legacy installation:
| Field | Ano ang Suriin |
|---|---|
| Install Path | Tumuturo sa tamang HandyCafe folder. |
| Database Path | Tumuturo sa legacy database file sa loob ng install folder. |
| Server Version | Tumutugma sa bersyon ng iyong legacy server (halimbawa 3.4.01 o 4.0.10). |
| INI File Count | Hindi zero. Ang isang maayos na installation ay may maraming INI files para sa iba't ibang configuration. |
Kung may mali sa anumang field, isara ang HandyCafe, ayusin ang installation, at muling buksan.
Hakbang 4: Suriin ang Encoding Field
Bago magpatakbo ng migration, tiyakin na ang Encoding field sa Runtime Protocol section ay nakatakda nang tama para sa iyong source data. Ito ay nasa parehong settings page, mas mataas.
| Source Locale | Inirerekomendang Encoding |
|---|---|
| Turkish | cp1254 |
| Western European (English, French, German, Spanish, Italian, Portuguese) | cp1252 |
| Iba pa | cp1254 (tinatanggap ito ng server bilang default fallback) |
Kung babaguhin mo ang encoding, i-click ang Save bago magpatuloy.
Inaasahang resulta: Ang mga source string ay magde-decode nang maayos sa panahon ng migration, na iiwasan ang completed_with_warnings na resulta.
Hakbang 5: Simulan ang Migration
- I-click ang Start Migration.
- Isang progress modal ang magbubukas. Ipinapakita nito ang kasalukuyang yugto at ang bilang ng mga row na naproseso na.
- Huwag isara ang HandyCafe o ilagay ang computer sa sleep mode.
- Maghintay para sa pagkumpleto. Ang maliliit na dataset ay natatapos sa loob ng isang minuto. Ang mas malalaking dataset ay maaaring tumagal ng 5 hanggang 10 minuto.
Inaasahang resulta: Ang progress modal ay magsasara at ang status ay magbabago sa completed o completed_with_warnings. Isang notification ang lalabas na nagkukumpirma ng run.
Hakbang 6: Suriin ang Migrated Counts
Pagkatapos ng pagkumpleto, ang pahina ay magpapakita ng mga migrated record counts:
| Count | Kahulugan |
|---|---|
| Members | Mga customer record na na-import. |
| Pricing | Mga pricing table at schedule entry na na-import. |
| Products | Mga entry sa product catalog na na-import. |
| Orders | Mga historical order na na-import. |
| Transactions | Mga entry sa ledger na na-import. |
| Logs | Mga audit at warning log na na-import. |
| Warnings | Mga record na na-skip sa panahon ng import. Lumalabas lamang kapag ang status ay completed_with_warnings. |
I-click ang Details expander para makita ang buong detalye. Tiyakin na ang mga bilang ay mukhang makatwiran laban sa iyong inaasahan.
Inaasahang resulta: Ang lahat ng apat na kategorya (members, products, orders, transactions) ay nagpapakita ng hindi zero na bilang kung ang iyong source ay may data sa mga table na iyon.
Hakbang 7: Tugunan ang Mga Babala (Kung Meron)
Kung ang status ay completed_with_warnings, palawakin ang listahan ng mga babala at suriin ang mga na-skip na record.
Karaniwang mga babala at ang kanilang mga solusyon:
| Warning | Sanhi | Solusyon |
|---|---|---|
| Encoding decode error | Ang source text ay naglalaman ng mga byte na hindi ma-decode sa nakatakdang encoding. | Patakbuhin ang Undo, baguhin ang Encoding field upang tumugma sa source locale, at muling patakbuhin ang migration. |
| Malformed date | Ang isang legacy record ay may invalid na time stamp (halimbawa 0000-00-00). |
Ang mga ito ay ligtas na na-skip. Walang kailangang gawin. |
| Duplicate key | Isang record na may parehong identifier ay umiiral na sa HandyCafe. | Kung ito ay hindi sinasadyang pangalawang migration, patakbuhin ang Undo at Re-run. Kung ikaw ay nagme-merge ng mga database, tanggapin ang skip. |
Inaasahang resulta: Tinatanggap mo ang mga babala bilang kilalang katanggap-tanggap na pagkawala o ayusin ang pinagbabatayang isyu at muling patakbuhin.
Hakbang 8: Spot-Check ng Na-import na Data
Bago i-retire ang legacy server, manu-manong suriin ang sample ng bawat uri ng record.
- Buksan ang Members sa sidebar. Hanapin ang isang miyembro na kilala mo mula sa legacy system. Kumpirmahin ang pangalan, balanse, at contact info.
- Buksan ang Settings > Pricing. Kumpirmahin na ang hourly rates ay tumutugma sa legacy schedule.
- Buksan ang Products. Kumpirmahin ang mga pangalan ng produkto at presyo.
- Buksan ang Cash Report para sa isang kamakailang historical na araw. Kumpirmahin na ang mga total ay tumutugma sa inaasahan mo mula sa legacy system.
Inaasahang resulta: Ang mga random na sample ay tumutugma sa legacy source. Kung ang isang partikular na record ay mali, tandaan ang isyu. Ang mga menor de edad na pagkakaiba sa format ay normal. Ang mga pangunahing pagkakaiba sa halaga ay nagmumungkahi ng isang encoding o problema sa integridad ng data na dapat imbestigahan bago mag-live.
Hakbang 9: I-enable ang Legacy Client Runtime Support (Opsyonal)
Kung nais mong ang iyong kasalukuyang V3 o V4 client machines ay patuloy na kumonekta habang ikaw ay nagta-transition, i-enable ang runtime protocol ngayon.
- Mag-scroll sa itaas ng Legacy Clients settings page.
- I-toggle ang Enable Legacy Client Support.
- Kumpirmahin na ang listener ports (UDP 710, TCP 712, file transfer 717) ay hindi nagko-conflict sa anumang iba pa sa iyong network.
- I-click ang Save.
Inaasahang resulta: Ang mga legacy client sa LAN ay lilitaw sa Admin Panel sa loob ng 5 hanggang 10 segundo. Tingnan ang Legacy Clients para sa kung paano pamahalaan ang mga ito mula sa panel.
Paano I-undo ang Migration
Kung ang migration ay nagresulta sa hindi inaasahang resulta, maaari mong i-roll back ito nang buo. Ang orihinal na legacy database ay hindi nagalaw.
- Buksan ang Settings > Legacy Clients.
- Mag-scroll sa seksyong Database Migration.
- I-click ang Undo Migration.
- Kumpirmahin sa dialog.
Ang bawat migrated row ay mabubura mula sa HandyCafe. Ang status ay babalik sa never. Maaari mo nang ayusin ang pinagbabatayang isyu (encoding, source data cleanup, atbp.) at patakbuhin muli ang Start Migration.
Paano Muling Patakbuhin ang Migration
Ang muling pagpapatakbo ay pumapalit sa migrated data ng sariwang data mula sa source.
- Buksan ang Settings > Legacy Clients.
- I-click ang Re-run Migration (ang button ay nagre-relabel mula sa Start Migration pagkatapos ng unang kumpletong run).
- Ang daloy ay kapareho ng paunang run.
Ang Re-run ay ligtas gamitin nang maraming beses hangga't kailangan mo. Hindi ito nagdodoble ng data dahil pinapalitan nito ang umiiral na migration output.
Karaniwang Pagkakamali na Iiwasan
- Pagpapatakbo ng migration habang ang legacy server ay aktibo. Ang source database ay maaaring naka-lock o maaaring naglalaman ng partial writes. Palaging ihinto muna ang legacy server.
- Pagwawalang-bahala sa Encoding field. Ang pagpapatakbo gamit ang maling encoding ay nagkokorrupt sa mga pangalan ng miyembro at mga mensahe ng log. Ang pag-aayos nito pagkatapos ng katotohanan ay nangangailangan ng Undo at Re-run.
- Pagsasara ng HandyCafe sa panahon ng migration. Ang run ay napuputol at ang partial data ay naisusulat. Ang pagbawi ay nangangailangan ng Undo. Palaging hayaan ang progress modal na makumpleto.
- Pag-skip sa spot-check step. Ang pagtitiwala sa mga bilang ng record nang hindi sinusuri ang sample data ay nakakaligtaan ang mga banayad na isyu tulad ng mga hindi pagkakatugma sa locale o mga error sa pag-round.
- Pagbubura ng legacy installation nang masyadong maaga. Panatilihin ang mga source file nang hindi bababa sa isang buong pay cycle pagkatapos ng migration. Kung may lumitaw na discrepancy sa isang buwanang ulat, maaari mong i-refer ang mga orihinal na record.
- Pag-migrate nang walang backup. Kopyahin ang legacy installation folder bago ang unang migration. Habang ang source ay hindi binabago ng migration, maaaring mangyari ang mga isyu sa disk o aksidente. Ang backup ay murang insurance.