Cara Berpindah daripada Pemasangan Legasi
Panduan ini mengimport data sedia ada anda daripada pemasangan HandyCafe V3 atau V4 yang lama ke dalam pelayan HandyCafe moden. Migrasi ini tidak merosakkan sumber: fail asal tidak diubah atau dipadamkan.
Migrasi pangkalan data dijalankan pada Windows sahaja. Sokongan masa jalan untuk klien legasi bersambung melalui protokol asal berfungsi pada setiap platform (lihat Tetapan Klien Legasi).
Apa Yang Anda Perlukan
- Mesin Windows yang mempunyai pemasangan legasi dan pelayan HandyCafe moden pada sistem yang sama, atau akses kepada fail pangkalan data legasi.
- Akses pentadbir kepada HandyCafe Server.
- Pelayan legasi dihentikan. Pangkalan data sumber tidak sepatutnya ditulis secara aktif semasa migrasi.
- Ruang cakera kosong sekurang-kurangnya sama dengan saiz pangkalan data legasi (untuk salinan pangkalan data HandyCafe baharu).
- 10 hingga 30 minit masa tanpa gangguan. Migrasi pada set data besar boleh mengambil beberapa minit. Jangan tutup HandyCafe semasa proses berjalan.
Langkah 1: Hentikan Pelayan Legasi
Buka aplikasi pelayan HandyCafe legasi. Hentikan semua sesi dan keluar daripada aplikasi. Jika pelayan legasi berjalan sebagai servis Windows, hentikan servis itu dari services.msc.
Hasil yang dijangka: Proses pelayan legasi tidak lagi berjalan. Fail pangkalan data tidak lagi dipegang terbuka.
Langkah 2: Buka Halaman Tetapan Klien Legasi
- Lancarkan HandyCafe.
- Buka Tetapan di bar sisi.
- Klik Klien Legasi.
- Tatal ke bahagian Migrasi Pangkalan Data.
Hasil yang dijangka: Jika sistem mengesan pemasangan legasi, halaman memaparkan laluan pemasangan, laluan pangkalan data, versi pelayan dan kiraan fail INI. Jika tiada apa yang dikesan, halaman akan menyatakan "Tiada pemasangan legasi dikesan." Dalam kes itu, sahkan bahawa fail legasi wujud di lokasi standard seperti Program Files\HandyCafe atau C:\HandyCafe.
Langkah 3: Semak Pemasangan Yang Dikesan
Sahkan nilai yang dikesan sepadan dengan pemasangan legasi yang anda kenal:
| Medan | Perkara Yang Perlu Disemak |
|---|---|
| Install Path | Menunjuk ke folder HandyCafe yang betul. |
| Database Path | Menunjuk ke fail pangkalan data legasi di dalam folder pemasangan. |
| Server Version | Sepadan dengan versi pelayan legasi anda (contohnya 3.4.01 atau 4.0.10). |
| INI File Count | Bukan sifar. Pemasangan yang sihat mempunyai beberapa fail INI untuk konfigurasi yang berbeza. |
Jika mana-mana medan salah, tutup HandyCafe, betulkan pemasangan dan buka semula.
Langkah 4: Semak Medan Pengekodan
Sebelum menjalankan migrasi, sahkan medan Encoding dalam bahagian Protokol Masa Jalan ditetapkan dengan betul untuk data sumber anda. Ini berada pada halaman tetapan yang sama, sedikit ke atas.
| Lokal Sumber | Pengekodan Disyorkan |
|---|---|
| Turki | cp1254 |
| Eropah Barat (Inggeris, Perancis, Jerman, Sepanyol, Itali, Portugis) | cp1252 |
| Lain-lain | cp1254 (pelayan menerimanya sebagai lalai sandaran) |
Jika anda menukar pengekodan, klik Simpan sebelum meneruskan.
Hasil yang dijangka: Rentetan sumber akan dinyahkod dengan bersih semasa migrasi, yang mengelakkan hasil completed_with_warnings.
Langkah 5: Mula Migrasi
- Klik Mula Migrasi.
- Modal kemajuan akan terbuka. Ia memaparkan fasa semasa dan bilangan baris yang telah diproses setakat ini.
- Jangan tutup HandyCafe atau biarkan komputer tidur.
- Tunggu sehingga selesai. Set data kecil selesai dalam masa kurang daripada satu minit. Set data yang lebih besar boleh mengambil 5 hingga 10 minit.
Hasil yang dijangka: Modal kemajuan ditutup dan status berubah kepada completed atau completed_with_warnings. Notifikasi muncul mengesahkan larian tersebut.
Langkah 6: Semak Kiraan Yang Dimigrasikan
Selepas selesai, halaman memaparkan kiraan rekod yang dimigrasikan:
| Kiraan | Maksud |
|---|---|
| Members | Rekod pelanggan yang diimport. |
| Pricing | Jadual harga dan entri jadual yang diimport. |
| Products | Entri katalog produk yang diimport. |
| Orders | Pesanan sejarah yang diimport. |
| Transactions | Entri lejar yang diimport. |
| Logs | Log audit dan amaran yang diimport. |
| Warnings | Rekod yang dilangkau semasa import. Hanya muncul apabila status ialah completed_with_warnings. |
Klik pembuka Butiran untuk melihat pecahan penuh. Sahkan bahawa kiraan kelihatan munasabah berbanding jangkaan anda.
Hasil yang dijangka: Semua empat kategori (ahli, produk, pesanan, transaksi) menunjukkan kiraan bukan sifar jika sumber anda mempunyai data dalam jadual tersebut.
Langkah 7: Kendalikan Amaran Jika Ada
Jika status ialah completed_with_warnings, kembangkan senarai amaran dan semak rekod yang dilangkau.
Amaran biasa dan pembetulannya:
| Amaran | Punca | Pembetulan |
|---|---|---|
| Ralat nyahkod pengekodan | Teks sumber mengandungi bait yang tidak boleh dinyahkod dengan pengekodan yang dikonfigurasikan. | Jalankan Batal, tukar medan Encoding agar sepadan dengan lokal sumber, dan jalankan semula migrasi. |
| Tarikh rosak | Rekod legasi mempunyai cap masa yang tidak sah (contohnya 0000-00-00). |
Ini dilangkau dengan selamat. Tiada tindakan diperlukan. |
| Kunci pendua | Rekod dengan pengecam yang sama sudah wujud dalam HandyCafe. | Jika ini ialah migrasi kedua yang tidak disengajakan, jalankan Batal dan Migrasi Semula. Jika anda sedang menggabungkan pangkalan data, terima langkauan itu. |
Hasil yang dijangka: Anda sama ada menerima amaran sebagai kehilangan yang boleh diterima atau membetulkan isu asas dan menjalankan semula.
Langkah 8: Semak Data Yang Diimport Secara Rawak
Sebelum menamatkan pelayan legasi, sahkan secara manual sampel bagi setiap jenis rekod.
- Buka Ahli di bar sisi. Cari ahli yang anda kenali daripada sistem legasi. Sahkan nama, baki dan maklumat hubungan.
- Buka Tetapan > Harga. Sahkan kadar sejam sepadan dengan jadual legasi.
- Buka Produk. Sahkan nama dan harga produk.
- Buka Laporan Tunai untuk hari sejarah yang baru-baru ini. Sahkan jumlah sepadan dengan apa yang anda jangka daripada sistem legasi.
Hasil yang dijangka: Sampel rawak sepadan dengan sumber legasi. Jika rekod tertentu salah, catatkan isu itu. Perbezaan pemformatan kecil adalah normal. Ketidakpadanan nilai besar menunjukkan masalah pengekodan atau integriti data yang wajar disiasat sebelum dilancarkan.
Langkah 9: Aktifkan Sokongan Masa Jalan Klien Legasi (Pilihan)
Jika anda mahu mesin klien V3 atau V4 sedia ada terus bersambung semasa anda beralih, aktifkan protokol masa jalan sekarang.
- Tatal ke bahagian atas halaman Tetapan Klien Legasi.
- Togol Aktifkan Sokongan Klien Legasi kepada hidup.
- Sahkan port pendengar (UDP 710, TCP 712, pemindahan fail 717) tidak bercanggah dengan apa-apa yang lain pada rangkaian anda.
- Klik Simpan.
Hasil yang dijangka: Klien legasi pada LAN muncul dalam Panel Pentadbir dalam masa 5 hingga 10 saat. Lihat Klien Legasi untuk cara menguruskannya dari panel.
Cara Membatalkan Migrasi
Jika migrasi menghasilkan keputusan yang tidak dijangka, anda boleh membuat rollback sepenuhnya. Pangkalan data legasi asal tidak disentuh.
- Buka Tetapan > Klien Legasi.
- Tatal ke bahagian Migrasi Pangkalan Data.
- Klik Batal Migrasi.
- Sahkan dalam dialog.
Setiap baris yang dimigrasikan akan dipadamkan daripada HandyCafe. Status kembali kepada never. Anda kemudian boleh membetulkan isu asas (pengekodan, pembersihan data sumber, dan sebagainya) dan menjalankan Mula Migrasi sekali lagi.
Cara Menjalankan Semula Migrasi
Menjalankan semula menggantikan data yang dimigrasikan dengan data baharu daripada sumber.
- Buka Tetapan > Klien Legasi.
- Klik Migrasi Semula (butang akan bertukar daripada Mula Migrasi selepas larian pertama selesai).
- Alirannya sama seperti larian awal.
Migrasi Semula selamat digunakan seberapa kali yang anda perlukan. Ia tidak menggandakan data kerana ia menggantikan output migrasi yang sedia ada.
Kesilapan Lazim Yang Perlu Dielakkan
- Menjalankan migrasi semasa pelayan legasi masih aktif. Pangkalan data sumber mungkin terkunci atau mungkin mengandungi tulisan separa. Sentiasa hentikan pelayan legasi dahulu.
- Mengabaikan medan Encoding. Menjalankan dengan pengekodan yang salah akan merosakkan nama ahli dan mesej log. Membetulkannya selepas itu memerlukan Batal dan Migrasi Semula.
- Menutup HandyCafe semasa migrasi. Larian akan terganggu dan data separa akan ditulis. Pemulihan memerlukan Batal. Sentiasa biarkan modal kemajuan selesai.
- Melangkau langkah semak rawak. Hanya bergantung pada kiraan rekod tanpa mengesahkan data sampel akan terlepas isu halus seperti ketidakpadanan lokal atau ralat pembundaran.
- Memadam pemasangan legasi terlalu awal. Kekalkan fail sumber sekurang-kurangnya satu kitaran gaji penuh selepas migrasi. Jika ketidaktepatan muncul pada laporan bulanan, anda boleh merujuk kepada rekod asal.
- Bermigrasi tanpa sandaran. Salin folder pemasangan legasi sebelum migrasi pertama. Walaupun sumber tidak diubah oleh migrasi, isu cakera atau kemalangan boleh berlaku. Sandaran ialah insurans yang murah.