Cài đặt Máy khách Cũ
HandyCafe hoạt động song song với các cài đặt khách hàng V3 và V4 cũ mà không bị gián đoạn. Trang cài đặt Clients Cũ kiểm soát Runtime Protocol: các bộ lắng nghe mạng cho phép khách hàng V3 và V4 kết nối với máy chủ này qua các cổng ban đầu của họ.
Nhập dữ liệu từ một cài đặt cũ là một công việc riêng biệt trên trang cài đặt của nó. Xem Di chuyển dữ liệu. Hai tính năng này là độc lập. Hỗ trợ chạy thời gian hoạt động mà không cần di chuyển bất kỳ dữ liệu nào. Một cuộc di chuyển hoạt động mà không cần hỗ trợ chạy thời gian. Bạn cũng có thể sử dụng cả hai cùng nhau.
Phần Runtime Protocol
Enable Legacy Client Support
Một công tắc tổng ở đầu phần này. Khi bật, máy chủ sẽ khởi động ba bộ lắng nghe mạng:
- Một bộ lắng nghe UDP trên nhóm multicast đã cấu hình.
- Một bộ lắng nghe lệnh TCP trên
UDP port + 2. - Một bộ lắng nghe truyền file TCP trên
UDP port + 7.
Tắt công tắc sẽ dừng cả ba bộ lắng nghe theo nguyên tử. Bạn có thể chỉnh số cổng hoặc mã hóa khi đang tắt, rồi bật lại để áp dụng thay đổi.
Các trường Cấu hình
| Trường | Mặc định | Mô tả |
|---|---|---|
| Auth Key | HANDYCAFE | Khóa dùng chung gồm 10 ký tự. Mọi frame đi vào và đi ra đều mang chuỗi này. Những frame không khớp sẽ bị loại bỏ. Tất cả máy khách cũ của bạn phải dùng cùng khóa. |
| UDP Multicast IP | 230.4.4.46 | Nhóm multicast dùng cho beacon phát hiện máy khách và cho việc phát lệnh qua UDP. Được hard-code trong hầu hết bản build máy khách cũ. |
| Server UDP Port | 710 | Cổng UDP mà máy chủ lắng nghe beacon và lệnh từ máy khách. Máy khách cũ sẽ gửi tới cổng này. |
| Client UDP Port | 711 | Cổng UDP mà máy khách cũ lắng nghe. Máy chủ gửi lệnh quản lý unicast tới cổng này trên IP máy khách đã phát hiện. |
| Encoding | cp1254 | Bộ mã ký tự cho các trường chuỗi trong wire-format. Dùng cp1254 cho cài đặt Thổ Nhĩ Kỳ, cp1252 cho Tây Âu. Giá trị lạ sẽ quay về cp1254 kèm cảnh báo trong log máy chủ. |
| Server Version | 3.4.01 | Chuỗi phiên bản được broadcast trong mọi beacon UDP. Một số máy khách cũ sẽ từ chối frame từ các phiên bản không nhận ra. Hãy đặt khớp với chuỗi phiên bản của máy chủ gốc. |
| Protocol Variant | STE | Lựa chọn wire format. Xem phần so sánh biến thể bên dưới. |
| Inactivity Timeout | 10 | Giây. Bộ giám sát theo MAC. Nếu không có traffic từ máy khách trong khoảng này, máy khách sẽ bị đánh dấu ngoại tuyến. Mức 10 giây phù hợp cho các máy khách cũ phát beacon mỗi 2 hoặc 3 giây. |
Các cổng được suy ra
Bên dưới biểu mẫu, trang sẽ hiển thị một dòng chỉ đọc cho các cổng TCP suy ra:
TCP Command Port: 712 File Transfer Port: 717
Các cổng này được tính từ cổng UDP của máy chủ. Bạn không cấu hình riêng chúng. Nếu đổi Server UDP Port sang giá trị khác, các cổng suy ra sẽ thay đổi theo.
Protocol Variant
Trường Protocol Variant chọn wire format mà máy chủ sẽ dùng. Hãy chọn biến thể khớp với cách máy chủ cũ của bạn được xây dựng.
| Biến thể | Khi nào dùng |
|---|---|
| STE (Smart/Turbo Edition) | Cơ sở mã legacy hiện đại. Thêm prefix thông tin giấy phép dài 70 byte vào cấu trúc frame. Kích thước frame là 1337 byte. Chọn nếu bản cài đặt cũ dùng bản Smart hoặc Turbo Edition. |
| Standard | Bản legacy nền tảng thuần túy. Kích thước frame là 1267 byte, không có prefix thông tin giấy phép. Chỉ chọn nếu bản cài đặt cũ là Standard edition không có đăng ký giấy phép. |
Chọn sai biến thể sẽ làm frame bị bỏ hoặc đọc sai. Triệu chứng có thể là máy khách vẫn online nhưng bỏ qua mọi lệnh, hoặc dữ liệu lệnh bị lệch 70 byte.
Chạy song song với máy khách hiện đại
Các cổng legacy (710, 711, 712, 717) hoàn toàn tách biệt với các cổng giao thức HandyCafe hiện đại (TCP 5001, 5002, 5003, UDP 5004). Hai ngăn xếp giao thức chạy đồng thời mà không xung đột. Bạn có thể trộn máy khách cũ và mới trên cùng một LAN và quản lý chúng từ cùng Bảng Quản trị.
Áp dụng thay đổi
Mọi trường trong phần Runtime Protocol được lưu bằng nút Save toàn cục ở cuối trang. Khi lưu, máy chủ sẽ:
- Dừng ba bộ lắng nghe legacy nếu chúng đang chạy.
- Xác thực Auth Key (không được rỗng).
- Xây dựng cấu hình bộ lắng nghe mới từ các trường đã cập nhật.
- Khởi động lại các bộ lắng nghe đồng thời.
- Gửi thông báo khi cả ba đã online trở lại.
Nếu một cổng đã bị tiến trình khác sử dụng, máy chủ sẽ báo lỗi và công tắc sẽ bật lại thành tắt. Hãy kiểm tra firewall và các dịch vụ khác bằng netstat và chọn một dải cổng còn trống.
Di chuyển Cơ sở Dữ liệu
Việc nhập dữ liệu từ một cài đặt HandyCafe 3.x hoặc 4.x không còn thực hiện trên trang này nữa. Nó được đặt tại trang cài đặt Di chuyển dữ liệu dưới nguồn HandyCafe Legacy, cùng với các trình nhập EveryCafe và Pancafe.
Trang đó bao gồm việc phát hiện cài đặt cũ, những gì được nhập, đảm bảo chỉ đọc trên các tập tin nguồn, chạy lại một lần nhập và hoàn tác. Để xem hướng dẫn từng bước, hãy xem Cách Di chuyển từ Bản Cài đặt Cũ.
Mẹo
- Hãy dừng máy chủ legacy trước khi chạy di chuyển. Nếu hệ thống cũ vẫn đang ghi vào cơ sở dữ liệu, quá trình nhập có thể thấy dữ liệu cũ hoặc ghi dở dang.
- Khớp trường Encoding với locale cũ của bạn trước lần di chuyển đầu tiên. Đổi nó sau khi dữ liệu đã được nhập sẽ không sửa ngược lại những tên đã bị hỏng.
- Luôn chạy một lần di chuyển thử trước. Kiểm tra số lượng bản ghi trong "Last Counts" và xem nhanh vài dòng hội viên và giao dịch trước khi chuyển nhân viên sang hệ thống mới.
- Bật hỗ trợ thời gian chạy và giữ các máy khách cũ kết nối trong một giai đoạn chuyển tiếp. Điều này giúp bạn xác minh rằng máy chủ mới phục vụ chúng giống hệt trước khi loại bỏ máy chủ cũ.
- Nếu đổi Server UDP Port, hãy nhớ rằng các cổng lệnh và truyền file suy ra cũng đổi theo. Quy tắc firewall cần được cập nhật tương ứng.