تنظیمات کلاینتهای قدیمی
HandyCafe در کنار نصبهای قدیمیتر مشتریان V3 و V4 بدون اختلال اجرا میشود. صفحه تنظیمات Legacy Clients کنترل Runtime Protocol را دارد: شنوندههای شبکه که به مشتریان V3 و V4 اجازه میدهند تا به این سرور در پورتهای اصلی خود متصل شوند.
وارد کردن دادهها از یک نصب قدیمیتر کاری جداگانه در صفحه تنظیمات مخصوص به خود است. به مهاجرت داده مراجعه کنید. این دو قابلیت مستقل از یکدیگر هستند. پشتیبانی زمان اجرا بدون انتقال هیچ دادهای کار میکند. یک مهاجرت بدون پشتیبانی زمان اجرا کار میکند. شما همچنین میتوانید از هر دو با هم استفاده کنید.
بخش Runtime Protocol
Enable Legacy Client Support
یک سوییچ اصلی در بالای بخش. وقتی روشن باشد، سرور سه listener شبکه را شروع میکند:
- یک listener UDP روی multicast group پیکربندیشده.
- یک listener فرمان TCP روی
UDP port + 2. - یک listener انتقال فایل TCP روی
UDP port + 7.
خاموش کردن این سوییچ هر سه listener را بهصورت atomic متوقف میکند. میتوانید وقتی غیرفعال است شماره پورتها یا encoding را تغییر دهید و بعد دوباره آن را روشن کنید تا تغییرات اعمال شوند.
فیلدهای پیکربندی
| فیلد | مقدار پیشفرض | توضیح |
|---|---|---|
| Auth Key | HANDYCAFE | یک کلید مشترک ۱۰کاراکتری. هر frame ورودی و خروجی این رشته را حمل میکند. frameهایی که مطابقت نداشته باشند رد میشوند. همه کلاینتهای قدیمی شما باید از همین کلید استفاده کنند. |
| UDP Multicast IP | 230.4.4.46 | گروه multicast برای beaconهای کشف کلاینت و برای dispatch فرمانهای مبتنی بر UDP. در بیشتر buildهای کلاینت قدیمی hard-coded شده است. |
| Server UDP Port | 710 | پورتی که سرور روی آن برای beaconها و فرمانهای کلاینت گوش میدهد. کلاینتهای قدیمی به این پورت میفرستند. |
| Client UDP Port | 711 | پورتی که کلاینتهای قدیمی روی آن گوش میدهند. سرور فرمانهای مدیریتی unicast را به این پورت و به IP کلاینت کشفشده میفرستد. |
| Encoding | cp1254 | encoding کاراکتر برای فیلدهای رشتهای wire-format. برای نصبهای ترکیهای از cp1254 و برای اروپای غربی از cp1252 استفاده کنید. مقادیر ناشناخته با هشدار در لاگ سرور به cp1254 برمیگردند. |
| Server Version | 3.4.01 | رشته نسخهای که در هر beacon UDP broadcast میشود. بعضی کلاینتهای قدیمی frameهای نسخههای ناشناس را رد میکنند. این مقدار را با رشته نسخه سرور اصلی خود هماهنگ کنید. |
| Protocol Variant | STE | انتخاب wire format. جدول مقایسه نسخهها را ببینید. |
| Inactivity Timeout | 10 | ثانیه. یک watchdog بر اساس MAC. اگر در این بازه هیچ ترافیکی از یک کلاینت نرسد، آن کلاینت offline علامت میخورد. فاصله ۱۰ ثانیه برای کلاینتهای قدیمی که هر ۲ یا ۳ ثانیه beacon میفرستند مناسب است. |
پورتهای مشتقشده
زیر فرم، صفحه یک خط فقطخواندنی نمایش میدهد که پورتهای TCP مشتقشده را نشان میدهد:
TCP Command Port: 712 File Transfer Port: 717
این پورتها از پورت UDP سرور محاسبه میشوند. آنها را جداگانه پیکربندی نمیکنید. اگر Server UDP Port را به مقدار دیگری تغییر دهید، پورتهای مشتقشده هم همراه آن جابهجا میشوند.
گونه پروتکل
فیلد Protocol Variant قالب wire format استفادهشده توسط سرور را انتخاب میکند. گونهای را انتخاب کنید که با نحوه ساخت سرور قدیمی شما مطابقت دارد.
| گونه | زمان استفاده |
|---|---|
| STE (Smart/Turbo Edition) | کدبیس قدیمی مدرن. یک prefix اطلاعات مجوز 70 بایتی به ساختار frame اضافه میکند. اندازه frame برابر 1337 بایت است. اگر نصب قدیمی شما از نسخه Smart یا Turbo استفاده میکرد، این گزینه را انتخاب کنید. |
| Standard | build پایه و ساده قدیمی. اندازه frame برابر 1267 بایت و بدون prefix اطلاعات مجوز است. این گزینه را فقط وقتی انتخاب کنید که نصب قدیمی شما نسخه Standard بدون ثبت مجوز بوده است. |
انتخاب گونه اشتباه باعث میشود frameها رد شوند یا اشتباه خوانده شوند. نشانهها شامل این است که کلاینت آنلاین به نظر میرسد اما به هیچ فرمانی پاسخ نمیدهد، یا داده فرمان با offset 70 بایتی جابهجا میشود.
همزیستی با کلاینتهای مدرن
پورتهای قدیمی (710، 711، 712، 717) کاملاً جدا از پورتهای پروتکل مدرن HandyCafe هستند (TCP 5001، 5002، 5003، UDP 5004). هر دو stack پروتکل همزمان و بدون تداخل اجرا میشوند. میتوانید کلاینتهای قدیمی و جدید را روی یک LAN ترکیب کنید و از همان Admin Panel مدیریتشان کنید.
اعمال تغییرات
همه فیلدهای بخش Runtime Protocol با دکمه جهانی Save در پایین صفحه ذخیره میشوند. هنگام ذخیره، سرور:
- اگر سه listener قدیمی در حال اجرا بودند آنها را متوقف میکند.
- Auth key را اعتبارسنجی میکند (نباید خالی باشد).
- بر اساس فیلدهای بهروزشده پیکربندی listenerهای جدید میسازد.
- Listenerها را بهصورت همزمان restart میکند.
- وقتی هر سه دوباره online شدند اعلان میفرستد.
اگر پورتی توسط فرایند دیگری استفاده شده باشد، سرور خطا میدهد و toggle دوباره خاموش میشود. firewall و سرویسهای دیگر را با netstat بررسی کنید و یک بازه پورت آزاد انتخاب کنید.
Database Migration
وارد کردن دادهها از نصب HandyCafe 3.x یا 4.x دیگر در این صفحه انجام نمیشود. این فرآیند در صفحه تنظیمات مهاجرت داده تحت منبع HandyCafe Legacy، در کنار واردکنندههای EveryCafe و Pancafe انجام میشود.
آن صفحه شامل تشخیص نصب قدیمی، آنچه وارد میشود، ضمانت فقط خواندنی روی فایلهای منبع، اجرای مجدد یک وارد کردن و لغو آن است. برای راهنمای گامبهگام، نحوه مهاجرت از نصب قدیمی را ببینید.
نکتهها
- قبل از اجرای migration، سرور قدیمی را متوقف کنید. اگر سیستم قدیمی هنوز در حال نوشتن در پایگاهداده باشد، import ممکن است دادههای قدیمی یا ناقص ببیند.
- قبل از اولین migration، فیلد Encoding را با locale قدیمی خود هماهنگ کنید. تغییر آن بعد از import، نامهایی را که از قبل خراب شدهاند بهطور جادویی درست نمیکند.
- همیشه اول یک migration آزمایشی اجرا کنید. شمارش رکوردها را زیر "Last Counts" بررسی کنید و چند ردیف عضو و تراکنش را spot-check کنید تا قبل از واگذاری سیستم به کارکنان مطمئن شوید.
- پشتیبانی زمان اجرا را فعال کنید و برای یک دوره گذار، کلاینتهای قدیمی را متصل نگه دارید. این کار به شما اجازه میدهد قبل از کنار گذاشتن سرور قدیمی، مطمئن شوید سرور جدید همان رفتار را ارائه میدهد.
- اگر Server UDP Port را تغییر دادید، یادتان باشد پورتهای مشتقشده فرمان و انتقال فایل هم همراه آن جابهجا میشوند. قانونهای firewall هم باید متناسب با آن بهروزرسانی شوند.