پرانی انسٹالیشن سے منتقلی کیسے کریں

یہ گائیڈ آپ کے موجودہ ڈیٹا کو پرانے HandyCafe V3 یا V4 انسٹالیشن سے جدید HandyCafe سرور میں منتقل کرتا ہے۔ منتقلی ماخذ کو نقصان نہیں پہنچاتی: اصل فائلز میں کوئی تبدیلی یا حذف نہیں ہوتی۔

ڈیٹا بیس کی منتقلی صرف ونڈوز پر چلتی ہے۔ پرانے کلائنٹس کو اصل پروٹوکول پر کنیکٹ کرنے کے لیے رن ٹائم سپورٹ ہر پلیٹ فارم پر کام کرتی ہے (دیکھیں پرانے کلائنٹس کی سیٹنگز)۔

آپ کو کیا چاہیے ہوگا

• ایک ونڈوز مشین جس پر پرانی انسٹالیشن اور جدید HandyCafe سرور دونوں ایک ہی سسٹم پر ہوں، یا پرانے ڈیٹا بیس فائل تک رسائی ہو۔
• HandyCafe سرور تک ایڈمن رسائی۔
• پرانا سرور بند ہو۔ منتقلی کے دوران ماخذ ڈیٹا بیس کو فعال طور پر نہیں لکھا جانا چاہیے۔
• پرانے ڈیٹا بیس کے سائز کے برابر کم از کم خالی ڈسک اسپیس (نئے HandyCafe ڈیٹا بیس کاپی کے لیے)۔
• 10 سے 30 منٹ کا بلا تعطل وقت۔ بڑے ڈیٹا سیٹس پر منتقلی میں کئی منٹ لگ سکتے ہیں۔ HandyCafe کو چلتے وقت بند نہ کریں۔

مرحلہ 1: پرانا سرور بند کریں

پرانے HandyCafe سرور ایپلیکیشن کو کھولیں۔ تمام سیشنز کو بند کریں اور ایپلیکیشن سے باہر نکلیں۔ اگر پرانا سرور ونڈوز سروس کے طور پر چلتا ہے، تو services.msc سے سروس کو بند کریں۔

متوقع نتیجہ: پرانے سرور کا عمل مزید نہیں چل رہا۔ ڈیٹا بیس فائل کھلی نہیں ہے۔

مرحلہ 2: پرانے کلائنٹس کی سیٹنگز کا صفحہ کھولیں

1. HandyCafe لانچ کریں۔
2. سائیڈبار میں Settings کھولیں۔
3. Legacy Clients پر کلک کریں۔
4. Database Migration سیکشن تک سکرول کریں۔

متوقع نتیجہ: اگر سسٹم پرانی انسٹالیشن کا پتہ لگاتا ہے، تو صفحہ انسٹال پاتھ، ڈیٹا بیس پاتھ، سرور ورژن، اور INI فائل کی تعداد دکھاتا ہے۔ اگر کچھ نہیں ملتا، تو صفحہ کہتا ہے "No legacy installation detected." اس صورت میں، تصدیق کریں کہ پرانی فائلز Program Files\HandyCafe یا C:\HandyCafe جیسے معیاری مقام پر موجود ہیں۔

مرحلہ 3: معلوم شدہ انسٹالیشن کا جائزہ لیں

تصدیق کریں کہ معلوم شدہ اقدار آپ کی معلوم پرانی انسٹالیشن سے مطابقت رکھتی ہیں:

اگر کوئی فیلڈ غلط ہے، تو HandyCafe بند کریں، انسٹالیشن کو درست کریں، اور دوبارہ کھولیں۔

مرحلہ 4: انکوڈنگ فیلڈ چیک کریں

منتقلی چلانے سے پہلے، تصدیق کریں کہ Runtime Protocol سیکشن میں Encoding فیلڈ آپ کے ماخذ ڈیٹا کے لیے صحیح طور پر سیٹ ہے۔ یہ اسی سیٹنگز کے صفحے میں اوپر ہے۔

اگر آپ انکوڈنگ تبدیل کرتے ہیں، تو جاری رکھنے سے پہلے Save پر کلک کریں۔

متوقع نتیجہ: ماخذ سٹرنگز منتقلی کے دوران صاف طور پر ڈیکوڈ ہوں گی، جو completed_with_warnings کے نتیجے سے بچاتی ہے۔

مرحلہ 5: منتقلی شروع کریں

1. Start Migration پر کلک کریں۔
2. ایک پروگریس ماڈل کھلتا ہے۔ یہ موجودہ مرحلہ اور اب تک پروسیس کیے گئے قطاروں کی تعداد دکھاتا ہے۔
3. HandyCafe کو بند نہ کریں یا کمپیوٹر کو سلیپ نہ کریں۔
4. مکمل ہونے کا انتظار کریں۔ چھوٹے ڈیٹا سیٹس ایک منٹ سے کم میں مکمل ہو جاتے ہیں۔ بڑے ڈیٹا سیٹس میں 5 سے 10 منٹ لگ سکتے ہیں۔

متوقع نتیجہ: پروگریس ماڈل بند ہو جاتا ہے اور اسٹیٹس completed یا completed_with_warnings میں تبدیل ہو جاتا ہے۔ ایک نوٹیفکیشن ظاہر ہوتا ہے جو رن کی تصدیق کرتا ہے۔

مرحلہ 6: منتقل شدہ تعداد کا جائزہ لیں

مکمل ہونے کے بعد، صفحہ منتقل شدہ ریکارڈ کی تعداد دکھاتا ہے:

تفصیلات کے ایکسپینڈر پر کلک کریں تاکہ مکمل تفصیل دیکھ سکیں۔ تصدیق کریں کہ تعداد آپ کی توقعات کے مطابق نظر آتی ہیں۔

متوقع نتیجہ: تمام چار زمروں (ممبرز، مصنوعات، آرڈرز، ٹرانزیکشنز) میں غیر صفر تعداد دکھائی دیتی ہے اگر آپ کے ماخذ میں ان جدولوں میں ڈیٹا موجود تھا۔

مرحلہ 7: وارننگز کا حل کریں (اگر کوئی ہو)

اگر اسٹیٹس completed_with_warnings ہے، تو وارننگز کی فہرست کو بڑھائیں اور چھوڑے گئے ریکارڈز کا جائزہ لیں۔

عام وارننگز اور ان کے حل:

متوقع نتیجہ: آپ یا تو وارننگز کو معلوم-قابل قبول نقصانات کے طور پر قبول کرتے ہیں یا بنیادی مسئلہ کو حل کرتے ہیں اور دوبارہ چلائیں۔

مرحلہ 8: درآمد شدہ ڈیٹا کا نمونہ چیک کریں

پرانے سرور کو ریٹائر کرنے سے پہلے، ہر ریکارڈ کی قسم کا نمونہ دستی طور پر تصدیق کریں۔

1. سائیڈبار میں Members کھولیں۔ کسی ایسے ممبر کو تلاش کریں جسے آپ پرانے سسٹم سے جانتے ہوں۔ نام، بیلنس، اور رابطہ معلومات کی تصدیق کریں۔
2. Settings > Pricing کھولیں۔ تصدیق کریں کہ گھنٹہ وار نرخ پرانے شیڈول سے مطابقت رکھتے ہیں۔
3. Products کھولیں۔ مصنوعات کے نام اور قیمتوں کی تصدیق کریں۔
4. حالیہ تاریخی دن کے لیے Cash Report کھولیں۔ تصدیق کریں کہ کل پرانے سسٹم سے آپ کی توقعات کے مطابق ہیں۔

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

مرحلہ 9: پرانے کلائنٹ رن ٹائم سپورٹ کو فعال کریں (اختیاری)

اگر آپ چاہتے ہیں کہ آپ کے موجودہ V3 یا V4 کلائنٹ مشینیں منتقلی کے دوران کنیکٹ رہیں، تو اب رن ٹائم پروٹوکول کو فعال کریں۔

1. پرانے کلائنٹس کی سیٹنگز کے صفحے کے اوپر سکرول کریں۔
2. Enable Legacy Client Support کو آن کریں۔
3. تصدیق کریں کہ سننے والے پورٹس (UDP 710, TCP 712, فائل ٹرانسفر 717) آپ کے نیٹ ورک پر کسی اور چیز کے ساتھ متصادم نہیں ہیں۔
4. Save پر کلک کریں۔

متوقع نتیجہ: LAN پر پرانے کلائنٹس 5 سے 10 سیکنڈ کے اندر ایڈمن پینل میں ظاہر ہوتے ہیں۔ انہیں پینل سے کیسے منظم کریں، دیکھیں پرانے کلائنٹس۔

منتقلی کو کیسے کالعدم کریں

اگر منتقلی نے غیر متوقع نتائج پیدا کیے، تو آپ اسے مکمل طور پر واپس لے سکتے ہیں۔ اصل پرانا ڈیٹا بیس غیر متاثر رہتا ہے۔

1. Settings > Legacy Clients کھولیں۔
2. ڈیٹا بیس منتقلی سیکشن تک سکرول کریں۔
3. Undo Migration پر کلک کریں۔
4. ڈائیلاگ میں تصدیق کریں۔

ہر منتقل شدہ قطار HandyCafe سے حذف ہو جاتی ہے۔ اسٹیٹس never پر واپس آ جاتا ہے۔ آپ پھر بنیادی مسئلہ (انکوڈنگ، ماخذ ڈیٹا کی صفائی وغیرہ) کو درست کر سکتے ہیں اور Start Migration دوبارہ چلا سکتے ہیں۔

منتقلی کو دوبارہ کیسے چلائیں

دوبارہ چلانے سے منتقل شدہ ڈیٹا کو ماخذ سے تازہ ڈیٹا کے ساتھ تبدیل کر دیا جاتا ہے۔

1. Settings > Legacy Clients کھولیں۔
2. Re-run Migration پر کلک کریں (پہلی مکمل رن کے بعد بٹن Start Migration سے relabel ہوتا ہے)۔
3. فلو ابتدائی رن کی طرح ہی ہے۔

دوبارہ چلانا جتنی بار آپ کو ضرورت ہو محفوظ ہے۔ یہ ڈیٹا کو نقل نہیں کرتا کیونکہ یہ موجودہ منتقلی کے نتائج کو تبدیل کرتا ہے۔

عام غلطیوں سے بچنے کے لیے

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