پرانے کلائنٹس کی ترتیبات

HandyCafe بغیر کسی رکاوٹ کے پرانے V3 اور V4 کلائنٹس کے ساتھ چلتا ہے۔ پرانے کلائنٹس کی ترتیبات کے صفحے پر دو مختلف خصوصیات کو کنٹرول کیا جاتا ہے:

1. رن ٹائم پروٹوکول۔ نیٹ ورک لسٹنرز کو فعال کرتا ہے جو V3 اور V4 کلائنٹس کو ان کے اصل پورٹس پر اس سرور سے جڑنے دیتا ہے۔
2. ڈیٹا بیس مائیگریشن۔ اختیاری طور پر ممبرز، قیمتیں، پروڈکٹس، آرڈرز، ٹرانزیکشنز، اور لاگز کو پرانی مقامی انسٹالیشن سے نئے HandyCafe ڈیٹا بیس میں درآمد کرتا ہے۔ یہ صرف ونڈوز پر دستیاب ہے۔

یہ دونوں خصوصیات آزاد ہیں۔ آپ رن ٹائم سپورٹ کو فعال کر سکتے ہیں بغیر ڈیٹا مائیگریٹ کیے، ڈیٹا مائیگریٹ کر سکتے ہیں بغیر رن ٹائم سپورٹ فعال کیے، یا دونوں کام کر سکتے ہیں۔

رن ٹائم پروٹوکول سیکشن

پرانے کلائنٹ سپورٹ کو فعال کریں

سیکشن کے اوپر ایک ماسٹر ٹوگل ہے۔ جب یہ آن ہوتا ہے، تو سرور تین نیٹ ورک لسٹنرز شروع کرتا ہے:

• کنفیگرڈ ملٹی کاسٹ گروپ پر ایک UDP لسٹنر۔
• UDP port + 2 پر ایک TCP کمانڈ لسٹنر۔
• UDP port + 7 پر ایک TCP فائل ٹرانسفر لسٹنر۔

ٹوگل کو آف کرنے سے تینوں لسٹنرز ایک ساتھ بند ہو جاتے ہیں۔ آپ پورٹ نمبرز یا انکوڈنگ کو غیر فعال حالت میں ایڈجسٹ کر سکتے ہیں، پھر تبدیلیوں کو لاگو کرنے کے لیے دوبارہ فعال کریں۔

کنفیگریشن فیلڈز

ڈیروائیوڈ پورٹس

فارم کے نیچے، صفحہ ایک ریڈ اونلی لائن دکھاتا ہے جو ڈیروائیوڈ TCP پورٹس کو ظاہر کرتا ہے:

TCP Command Port: 712   File Transfer Port: 717

یہ پورٹس UDP سرور پورٹ سے حساب کیے جاتے ہیں۔ آپ انہیں الگ سے کنفیگر نہیں کرتے۔ اگر آپ Server UDP Port کو کسی مختلف ویلیو پر تبدیل کرتے ہیں، تو ڈیروائیوڈ پورٹس اس کے ساتھ منتقل ہو جاتے ہیں۔

پروٹوکول ویریئنٹ

پروٹوکول ویریئنٹ فیلڈ سرور کے ذریعے استعمال ہونے والے وائر فارمیٹ کو منتخب کرتا ہے۔ اس ویریئنٹ کو منتخب کریں جو آپ کے پرانے سرور کے بلڈ کے مطابق ہو۔

غلط ویریئنٹ کا انتخاب کرنے سے فریمز ڈراپ یا غلط پڑھے جاتے ہیں۔ علامات میں شامل ہیں کلائنٹس آن لائن نظر آتے ہیں لیکن ہر کمانڈ کو نظرانداز کرتے ہیں، یا کمانڈ ڈیٹا 70 بائٹ آفسیٹ کے ذریعے منتقل ہوتا ہے۔

جدید کلائنٹس کے ساتھ ہم آہنگی

پرانے پورٹس (710, 711, 712, 717) جدید HandyCafe پروٹوکول پورٹس (TCP 5001, 5002, 5003, UDP 5004) سے مکمل طور پر الگ ہیں۔ دونوں پروٹوکول اسٹیکس بیک وقت بغیر کسی تنازع کے چلتے ہیں۔ آپ ایک ہی LAN پر پرانے اور نئے کلائنٹس کو ملا سکتے ہیں اور انہیں ایک ہی ایڈمن پینل سے مینج کر سکتے ہیں۔

تبدیلیوں کا اطلاق

رن ٹائم پروٹوکول سیکشن میں ہر فیلڈ کو صفحے کے نیچے موجود گلوبل Save بٹن کے ساتھ محفوظ کیا جاتا ہے۔ محفوظ کرنے پر، سرور:

1. تینوں پرانے لسٹنرز کو بند کر دیتا ہے اگر وہ چل رہے ہوں۔
2. Auth Key کی تصدیق کرتا ہے (خالی نہیں ہونا چاہیے)۔
3. اپ ڈیٹ شدہ فیلڈز سے نئے لسٹنر کنفیگریشنز بناتا ہے۔
4. لسٹنرز کو بیک وقت دوبارہ شروع کرتا ہے۔
5. جب تینوں دوبارہ آن لائن ہوں تو نوٹیفکیشن بھیجتا ہے۔

اگر کوئی پورٹ پہلے سے کسی دوسرے عمل کے ذریعے استعمال ہو رہی ہے، تو سرور ایک ایرر رپورٹ کرتا ہے اور ٹوگل واپس آف ہو جاتا ہے۔ اپنے فائر وال اور دیگر سروسز کو netstat کے ساتھ چیک کریں اور ایک فری پورٹ رینج منتخب کریں۔

ڈیٹا بیس مائیگریشن سیکشن (صرف ونڈوز پر)

یہ خصوصیت صرف اس وقت دستیاب ہے جب HandyCafe ونڈوز پر چل رہا ہو۔ macOS اور Linux پر، سیکشن ایک نوٹس دکھاتا ہے: "ڈیٹا بیس مائیگریشن صرف ونڈوز پر سپورٹڈ ہے۔"

ڈیٹیکشن

کھولنے پر، سرور آپ کے سسٹم میں پرانی انسٹالیشن کے لیے اسکین کرتا ہے۔ ڈیٹیکشن دیکھتا ہے:

• رجسٹری اور عام انسٹال پاتھ جیسے Program Files\HandyCafe اور C:\HandyCafe۔
• انسٹالیشن کے ساتھ موجود ڈیٹا بیس فائل۔
• انسٹالیشن ڈائریکٹری میں کنفیگریشن INI فائلز۔

جب ڈیٹیکشن کامیاب ہوتا ہے، تو صفحہ دکھاتا ہے:

اگر کوئی انسٹالیشن ڈیٹیکٹ نہیں ہوتی، تو صفحہ "کوئی پرانی انسٹالیشن ڈیٹیکٹ نہیں ہوئی" دکھاتا ہے۔ آپ پھر بھی رن ٹائم سپورٹ کو فعال کر سکتے ہیں؛ مائیگریشن فیچر کے پاس درآمد کرنے کے لیے کچھ نہیں ہے۔

مائیگریشن کی حیثیت

صفحہ مائیگریشن کی تاریخ کو ٹریک کرتا ہے:

پہلی کامیاب رن کے بعد، Start Migration بٹن کا لیبل Re-run Migration میں تبدیل ہو جاتا ہے۔

کیا مائیگریٹ ہوتا ہے

"فائلز سیف" گارنٹی

صفحہ نیلے رنگ میں ایک نوٹس دکھاتا ہے: "اصل ڈیٹا بیس فائلز کو حذف نہیں کیا جاتا۔ آپ انہیں محفوظ طریقے سے حذف کر سکتے ہیں جب مائیگریشن کی تصدیق ہو جائے۔" مائیگریشن سورس پر صرف پڑھنے کے لیے ہے۔ یہاں تک کہ اگر آپ مائیگریشن کو متعدد بار چلاتے ہیں، تو اصل پرانی ڈیٹا بیس غیر متاثر رہتی ہے۔ یہ آپ کو درآمد کے ساتھ تجربہ کرنے، گنتی کا جائزہ لینے، اور بغیر کسی خطرے کے واپس جانے کی اجازت دیتا ہے۔

شروع کریں، دوبارہ چلائیں، اور واپس لیں

• Start Migration. ایک پروگریس ماڈل کھولتا ہے۔ ماڈل موجودہ مرحلے اور ریکارڈ کی گنتی کو ظاہر کرتا ہے جب درآمد چل رہی ہوتی ہے۔ اس وقت کے دوران HandyCafe کو بند نہ کریں۔
• Re-run Migration. مکمل رن کے بعد دستیاب ہے۔ درآمد کو شروع سے دوبارہ چلاتا ہے۔ نیا درآمد HandyCafe میں پچھلے ڈیٹا کی جگہ لے لیتا ہے۔
• Undo Migration. مکمل رن کے بعد دستیاب ہے۔ ایک تصدیقی ڈائیلاگ کھولتا ہے۔ تصدیق پر، ہر مائیگریٹ شدہ قطار HandyCafe سے حذف ہو جاتی ہے۔ پرانی سورس کو نہیں چھوا جاتا۔ واپسی کے بعد، حیثیت never پر واپس آ جاتی ہے۔

وارننگز کے ساتھ مکمل ہوا

اگر مائیگریشن completed_with_warnings کے ساتھ ختم ہوتی ہے، تو ایک پیلا بینر ایک Details لنک کے ساتھ ظاہر ہوتا ہے۔ چھوڑے گئے ریکارڈز کی فہرست کو وجہ کے ساتھ دیکھنے کے لیے کلک کریں۔ عام وجوہات:

• انکوڈنگ کا عدم مطابقت۔ سورس قطار میں ایسے کریکٹرز ہوتے ہیں جو کنفیگرڈ انکوڈنگ میں صاف طور پر ڈیکوڈ نہیں ہوتے۔ انکوڈنگ فیلڈ (cp1254 یا cp1252) کو تبدیل کریں اور مائیگریشن کو دوبارہ چلائیں۔
• خراب تاریخیں۔ کچھ پرانے ریکارڈز میں غلط ٹائم اسٹیمپس ہوتے ہیں۔ ان کو چھوڑ دیا جاتا ہے تاکہ درست قطاریں اب بھی درآمد ہو سکیں۔
• ڈپلیکیٹ کیز۔ HandyCafe میں پہلے سے موجود شناخت کنندہ کے ساتھ ایک ریکارڈ۔ مائیگریشن موجودہ ریکارڈ کو محفوظ رکھتا ہے اور ڈپلیکیٹ کو چھوڑ دیتا ہے۔

تجاویز

• مائیگریشن چلانے سے پہلے پرانے سرور کو بند کریں۔ اگر پرانا سسٹم ابھی بھی اپنے ڈیٹا بیس میں لکھ رہا ہے، تو درآمد کو پرانا یا جزوی ڈیٹا نظر آ سکتا ہے۔
• پہلی مائیگریشن سے پہلے انکوڈنگ فیلڈ کو اپنے پرانے لوکیل سے ملائیں۔ ڈیٹا درآمد ہونے کے بعد اسے تبدیل کرنے سے پہلے سے خراب شدہ ناموں کو درست نہیں کیا جا سکے گا۔
• ہمیشہ پہلے ایک ٹیسٹ مائیگریشن چلائیں۔ "آخری گنتی" کے تحت ریکارڈ کی گنتی چیک کریں اور نئے سسٹم کے لیے عملے کو متعین کرنے سے پہلے کچھ ممبر اور ٹرانزیکشن قطاروں کو چیک کریں۔
• رن ٹائم سپورٹ کو فعال کریں اور اپنے پرانے کلائنٹس کو ایک عبوری مدت کے لیے منسلک رکھیں۔ یہ آپ کو تصدیق کرنے دیتا ہے کہ نیا سرور انہیں یکساں طور پر سروس فراہم کرتا ہے اس سے پہلے کہ آپ پرانے سرور کو ریٹائر کریں۔
• اگر آپ Server UDP Port کو تبدیل کرتے ہیں، تو یاد رکھیں کہ ڈیروائیوڈ کمانڈ اور فائل ٹرانسفر پورٹس اس کے ساتھ منتقل ہو جاتے ہیں۔ فائر وال رولز کو اسی کے مطابق اپ ڈیٹ کرنے کی ضرورت ہے۔