Tetapan Klien Legasi
HandyCafe boleh berjalan bersama pemasangan klien V3 dan V4 yang lebih lama tanpa gangguan. Halaman Tetapan Klien Legasi mengawal dua ciri yang berbeza:
- Protokol Masa Jalan. Mengaktifkan pendengar rangkaian yang membolehkan klien V3 dan V4 bersambung ke pelayan ini pada port asal mereka.
- Migrasi Pangkalan Data. Secara pilihan mengimport ahli, harga, produk, pesanan, transaksi dan log daripada pemasangan tempatan lama ke dalam pangkalan data HandyCafe yang baharu. Ini hanya untuk Windows.
Kedua-dua ciri ini adalah bebas. Anda boleh mengaktifkan sokongan masa jalan tanpa memindahkan data, memindahkan data tanpa mengaktifkan sokongan masa jalan, atau melakukan kedua-duanya.
Bahagian Protokol Masa Jalan
Aktifkan Sokongan Klien Legasi
Togol utama di bahagian atas seksyen. Apabila dihidupkan, pelayan akan memulakan tiga pendengar rangkaian:
- Pendengar UDP pada kumpulan multicast yang dikonfigurasikan.
- Pendengar arahan TCP pada
port UDP + 2. - Pendengar pemindahan fail TCP pada
port UDP + 7.
Mematikan togol akan menghentikan ketiga-tiga pendengar secara atomik. Anda boleh melaras nombor port atau pengekodan semasa ia dimatikan, kemudian hidupkan semula untuk mengaplikasikan perubahan.
Medan Konfigurasi
| Medan | Lalai | Penerangan |
|---|---|---|
| Auth Key | HANDYCAFE | Kunci berkongsi 10 aksara. Setiap bingkai masuk dan keluar membawa rentetan ini. Bingkai yang tidak sepadan akan digugurkan. Semua klien legasi anda mesti menggunakan kunci yang sama. |
| UDP Multicast IP | 230.4.4.46 | Kumpulan multicast yang digunakan untuk suar penemuan klien dan penghantaran arahan berasaskan UDP. Dikod keras dalam kebanyakan binaan klien legasi. |
| Server UDP Port | 710 | Port UDP yang didengar oleh pelayan untuk suar dan arahan klien. Klien legasi menghantar ke port ini. |
| Client UDP Port | 711 | Port UDP yang didengar oleh klien legasi. Pelayan menghantar arahan pengurusan unicast ke port ini pada IP klien yang ditemui. |
| Encoding | cp1254 | Pengekodan aksara untuk medan rentetan format wayar. Gunakan cp1254 untuk pemasangan Turki, cp1252 untuk Eropah Barat. Nilai yang tidak dikenali akan kembali ke cp1254 dengan amaran dalam log pelayan. |
| Server Version | 3.4.01 | Rentetan versi yang disiarkan dalam setiap suar UDP. Sesetengah klien legasi menolak bingkai daripada versi yang tidak mereka kenali. Tetapkan ini agar sepadan dengan rentetan versi pelayan asal anda. |
| Protocol Variant | STE | Pilihan format wayar. Lihat perbandingan varian di bawah. |
| Inactivity Timeout | 10 | Saat. Pemantau per-MAC. Jika tiada trafik tiba daripada klien dalam tetingkap ini, klien ditandakan luar talian. Jurang 10 saat sesuai untuk klien legasi yang menghantar suar setiap 2 atau 3 saat. |
Port Terbitan
Di bawah borang, halaman memaparkan baris baca sahaja yang menunjukkan port TCP terbitan:
TCP Command Port: 712 File Transfer Port: 717
Port ini dikira daripada port UDP pelayan. Anda tidak mengkonfigurasikannya secara berasingan. Jika anda menukar Server UDP Port kepada nilai lain, port terbitan akan berubah bersama-sama dengannya.
Varian Protokol
Medan Protocol Variant memilih format wayar yang digunakan oleh pelayan. Pilih varian yang sepadan dengan cara pelayan legasi anda dibina.
| Varian | Bila Digunakan |
|---|---|
| STE (Smart/Turbo Edition) | Pangkalan kod legasi moden. Menambah awalan maklumat lesen 70 bait pada struktur bingkai. Saiz bingkai ialah 1337 bait. Pilih ini jika pemasangan legasi anda menggunakan edisi Smart atau Turbo. |
| Standard | Binaan legasi asas biasa. Saiz bingkai ialah 1267 bait tanpa awalan maklumat lesen. Pilih ini hanya jika pemasangan legasi anda ialah edisi Standard tanpa pendaftaran lesen. |
Memilih varian yang salah akan menyebabkan bingkai digugurkan atau dibaca salah. Gejalanya termasuk klien kelihatan dalam talian tetapi mengabaikan setiap arahan, atau data arahan beralih sebanyak offset 70 bait.
Keberadaan Bersama Klien Moden
Port legasi (710, 711, 712, 717) sepenuhnya berasingan daripada port protokol HandyCafe moden (TCP 5001, 5002, 5003, UDP 5004). Kedua-dua susunan protokol berjalan serentak tanpa konflik. Anda boleh mencampurkan klien lama dan baharu pada LAN yang sama dan menguruskannya dari Panel Pentadbir yang sama.
Mengaplikasikan Perubahan
Setiap medan dalam bahagian Protokol Masa Jalan disimpan dengan butang Simpan global di bahagian bawah halaman. Semasa simpanan, pelayan:
- Menghentikan tiga pendengar legasi jika ia sedang berjalan.
- Mengesahkan kunci auth (tidak boleh kosong).
- Membina konfigurasi pendengar baharu daripada medan yang dikemas kini.
- Memulakan semula pendengar serentak.
- Mencetuskan notifikasi apabila ketiga-tiganya kembali dalam talian.
Jika sesuatu port sudah digunakan oleh proses lain, pelayan akan melaporkan ralat dan togol akan kembali ke keadaan mati. Semak firewall dan servis lain anda dengan netstat dan pilih julat port yang kosong.
Bahagian Migrasi Pangkalan Data (Windows Sahaja)
Ciri ini hanya tersedia apabila HandyCafe berjalan pada Windows. Pada macOS dan Linux, bahagian ini memaparkan notis: "Migrasi pangkalan data hanya disokong pada Windows."
Pengesanan
Apabila dibuka, pelayan mengimbas sistem anda untuk pemasangan legasi. Pengesanan mencari di:
- Registry dan laluan pemasangan biasa seperti
Program Files\HandyCafedanC:\HandyCafe. - Fail pangkalan data di samping pemasangan.
- Fail konfigurasi INI dalam direktori pemasangan.
Apabila pengesanan berjaya, halaman memaparkan:
| Label | Maksud |
|---|---|
| Install Path | Lokasi pemasangan legasi pada cakera. |
| Database Path | Laluan penuh ke fail pangkalan data legasi. |
| Server Version | Versi yang dihuraikan daripada konfigurasi legasi. |
| INI File Count | Bilangan fail konfigurasi yang dikesan. Berguna untuk menyemak secara ringkas bahawa pemasangan lengkap. |
Jika tiada pemasangan dikesan, halaman memaparkan "Tiada pemasangan legasi dikesan." Anda masih boleh mengaktifkan sokongan masa jalan; ciri migrasi cuma tidak mempunyai apa-apa untuk diimport.
Status Migrasi
Halaman menjejak sejarah migrasi:
| Status | Maksud |
|---|---|
| never | Anda belum menjalankan migrasi lagi. |
| in_progress | Migrasi sedang berjalan. Jangan tutup pelayan semasa keadaan ini. |
| completed | Migrasi paling terkini selesai tanpa amaran. |
| completed_with_warnings | Migrasi paling terkini selesai tetapi beberapa rekod dilangkau (contohnya disebabkan ralat pengekodan atau tarikh yang rosak). Semak amaran sebelum meneruskan. |
| undone | Migrasi paling terkini telah dibatalkan semula. |
Selepas larian berjaya yang pertama, butang Mula Migrasi akan bertukar label kepada Migrasi Semula.
Apa Yang Dipindahkan
| Jadual | Penerangan |
|---|---|
| Members | Rekod pelanggan dengan nama, maklumat hubungan dan baki akaun. |
| Pricing | Jadual harga dan kadar mengikut jam. |
| Products | Entri katalog produk. |
| Orders | Sejarah pesanan dengan rujukan sesi. |
| Transactions | Entri lejar dengan cap masa, jumlah dan kaedah pembayaran. |
| Logs | Entri audit dan amaran daripada pangkalan data legasi. |
Jaminan "Files Safe"
Halaman memaparkan notis berwarna biru: "Fail pangkalan data asal tidak dipadamkan. Anda boleh memadamkannya dengan selamat sebaik sahaja migrasi disahkan." Migrasi bersifat baca sahaja pada sumber. Walaupun anda menjalankan migrasi beberapa kali, pangkalan data legasi asal tetap tidak disentuh. Ini membolehkan anda mencuba import, menyemak kiraan dan membuat rollback tanpa risiko.
Mula, Migrasi Semula dan Batal
- Mula Migrasi. Membuka modal kemajuan. Modal memaparkan fasa semasa dan kiraan rekod ketika import berjalan. Jangan tutup HandyCafe pada masa ini.
- Migrasi Semula. Tersedia selepas larian yang selesai. Menjalankan semula import dari awal. Import baharu menggantikan data sebelumnya dalam HandyCafe.
- Batal Migrasi. Tersedia selepas larian yang selesai. Membuka dialog pengesahan. Apabila disahkan, setiap baris yang dimigrasikan dipadamkan daripada HandyCafe. Sumber legasi tidak disentuh. Selepas batal, status kembali kepada
never.
Selesai Dengan Amaran
Jika migrasi selesai dengan completed_with_warnings, sepanduk kuning akan muncul dengan pautan Butiran. Klik untuk mengembangkan senarai rekod yang dilangkau bersama sebabnya. Sebab biasa:
- Ketidakpadanan pengekodan. Baris sumber mengandungi aksara yang tidak dapat dinyahkod dengan bersih dalam pengekodan yang dikonfigurasikan. Tukar medan pengekodan (cp1254 atau cp1252) dan jalankan semula migrasi.
- Tarikh tidak sah. Sesetengah rekod legasi mempunyai cap masa yang tidak sah. Ini dilangkau supaya baris yang sah masih boleh diimport.
- Kunci pendua. Rekod dengan pengecam yang sama sudah wujud dalam HandyCafe. Migrasi mengekalkan rekod sedia ada dan melangkau pendua.
Petua
- Hentikan pelayan legasi sebelum menjalankan migrasi. Jika sistem legasi masih menulis ke pangkalan datanya, import mungkin melihat data lama atau separa.
- Padankan medan Encoding dengan lokal legasi anda sebelum migrasi pertama. Menukarnya selepas data diimport tidak akan membetulkan nama yang sudah rosak.
- Sentiasa jalankan migrasi ujian dahulu. Semak kiraan rekod di bawah "Last Counts" dan semak beberapa baris ahli dan transaksi sebelum menyerahkan staf kepada sistem baharu.
- Aktifkan sokongan masa jalan dan kekalkan klien legasi anda bersambung untuk tempoh peralihan. Ini membolehkan anda mengesahkan bahawa pelayan baharu melayan mereka secara identik sebelum anda menamatkan pelayan lama.
- Jika anda menukar Server UDP Port, ingat bahawa port arahan dan pemindahan fail terbitan akan berubah bersama-sama dengannya. Peraturan firewall perlu dikemas kini sewajarnya.