पुरानी इंस्टॉलेशन से माइग्रेट कैसे करें

यह गाइड आपके मौजूदा डेटा को पुराने HandyCafe V3 या V4 इंस्टॉलेशन से आधुनिक HandyCafe सर्वर में आयात करता है। माइग्रेशन स्रोत के लिए गैर-विनाशकारी है: मूल फाइलें संशोधित या हटाई नहीं जाती हैं।

डेटाबेस माइग्रेशन केवल Windows पर चलता है। मूल प्रोटोकॉल पर कनेक्ट करने के लिए पुराने क्लाइंट्स के लिए रनटाइम समर्थन हर प्लेटफॉर्म पर काम करता है (देखें पुराने क्लाइंट्स की सेटिंग्स)।

आपको क्या चाहिए होगा

• एक Windows मशीन जिसमें एक ही सिस्टम पर पुरानी इंस्टॉलेशन और आधुनिक HandyCafe सर्वर हो, या पुराने डेटाबेस फाइल तक पहुंच हो।
• HandyCafe सर्वर के लिए एडमिन एक्सेस।
• पुराना सर्वर बंद हो। माइग्रेशन के दौरान स्रोत डेटाबेस को सक्रिय रूप से लिखा नहीं जाना चाहिए।
• पुराने डेटाबेस के आकार के बराबर खाली डिस्क स्थान (नए HandyCafe डेटाबेस कॉपी के लिए)।
• 10 से 30 मिनट का निर्बाध समय। बड़े डेटा सेट पर माइग्रेशन में कई मिनट लग सकते हैं। रन के दौरान HandyCafe को बंद न करें।

चरण 1: पुराने सर्वर को बंद करें

पुराने HandyCafe सर्वर एप्लिकेशन को खोलें। सभी सत्रों को बंद करें और एप्लिकेशन से बाहर निकलें। यदि पुराना सर्वर Windows सेवा के रूप में चलता है, तो services.msc से सेवा को बंद करें।

अपेक्षित परिणाम: पुराना सर्वर प्रक्रिया अब नहीं चल रही है। डेटाबेस फाइल खुली नहीं है।

चरण 2: पुराने क्लाइंट्स की सेटिंग्स पेज खोलें

1. HandyCafe लॉन्च करें।
2. साइडबार में सेटिंग्स खोलें।
3. पुराने क्लाइंट्स पर क्लिक करें।
4. डेटाबेस माइग्रेशन सेक्शन तक स्क्रॉल करें।

अपेक्षित परिणाम: यदि सिस्टम एक पुरानी इंस्टॉलेशन का पता लगाता है, तो पेज इंस्टॉल पथ, डेटाबेस पथ, सर्वर संस्करण, और INI फाइल की संख्या प्रदर्शित करता है। यदि कुछ भी नहीं पाया जाता है, तो पेज कहता है "कोई पुरानी इंस्टॉलेशन नहीं मिली।" इस स्थिति में, सुनिश्चित करें कि पुरानी फाइलें Program Files\HandyCafe या C:\HandyCafe जैसे मानक स्थान में मौजूद हैं।

चरण 3: पता लगी इंस्टॉलेशन की समीक्षा करें

सुनिश्चित करें कि पता लगे हुए मान आपके ज्ञात पुराने इंस्टॉलेशन से मेल खाते हैं:

यदि कोई फील्ड गलत है, तो HandyCafe बंद करें, इंस्टॉलेशन को ठीक करें, और फिर से खोलें।

चरण 4: एन्कोडिंग फील्ड की जांच करें

माइग्रेशन चलाने से पहले, सुनिश्चित करें कि रनटाइम प्रोटोकॉल सेक्शन में एन्कोडिंग फील्ड आपके स्रोत डेटा के लिए सही सेट है। यह उसी सेटिंग्स पेज में, ऊपर की ओर है।

यदि आप एन्कोडिंग बदलते हैं, तो जारी रखने से पहले सहेजें पर क्लिक करें।

अपेक्षित परिणाम: स्रोत स्ट्रिंग्स माइग्रेशन के दौरान साफ-सुथरे तरीके से डिकोड हो जाएंगी, जिससे completed_with_warnings परिणाम से बचा जा सकेगा।

चरण 5: माइग्रेशन शुरू करें

1. माइग्रेशन शुरू करें पर क्लिक करें।
2. एक प्रगति मोडल खुलता है। यह वर्तमान चरण और अब तक संसाधित पंक्तियों की संख्या प्रदर्शित करता है।
3. HandyCafe को बंद न करें या कंप्यूटर को स्लीप में न डालें।
4. पूर्णता की प्रतीक्षा करें। छोटे डेटा सेट एक मिनट से कम समय में समाप्त हो जाते हैं। बड़े डेटा सेट में 5 से 10 मिनट लग सकते हैं।

अपेक्षित परिणाम: प्रगति मोडल बंद हो जाता है और स्थिति completed या completed_with_warnings में बदल जाती है। एक अधिसूचना दिखाई देती है जो रन की पुष्टि करती है।

चरण 6: माइग्रेटेड काउंट्स की समीक्षा करें

पूर्णता के बाद, पेज माइग्रेटेड रिकॉर्ड काउंट्स प्रदर्शित करता है:

पूर्ण विवरण देखने के लिए विवरण विस्तारक पर क्लिक करें। सुनिश्चित करें कि काउंट्स आपकी अपेक्षाओं के अनुसार उचित दिखते हैं।

अपेक्षित परिणाम: सभी चार श्रेणियां (सदस्य, उत्पाद, ऑर्डर, लेनदेन) गैर-शून्य काउंट्स दिखाती हैं यदि आपके स्रोत में उन तालिकाओं में डेटा था।

चरण 7: चेतावनियों को संभालें (यदि कोई हो)

यदि स्थिति completed_with_warnings है, तो चेतावनी सूची का विस्तार करें और छोड़े गए रिकॉर्ड की समीक्षा करें।

सामान्य चेतावनियाँ और उनके समाधान:

अपेक्षित परिणाम: आप या तो चेतावनियों को ज्ञात-स्वीकार्य नुकसान के रूप में स्वीकार करते हैं या अंतर्निहित समस्या को ठीक करते हैं और फिर से चलाते हैं।

चरण 8: आयातित डेटा की स्पॉट-जांच करें

पुराने सर्वर को रिटायर करने से पहले, प्रत्येक रिकॉर्ड प्रकार के नमूने को मैन्युअल रूप से सत्यापित करें।

1. साइडबार में सदस्य खोलें। पुराने सिस्टम से किसी ज्ञात सदस्य की खोज करें। नाम, बैलेंस, और संपर्क जानकारी की पुष्टि करें।
2. सेटिंग्स > मूल्य निर्धारण खोलें। सुनिश्चित करें कि प्रति घंटा दरें पुराने शेड्यूल से मेल खाती हैं।
3. उत्पाद खोलें। उत्पाद नाम और कीमतों की पुष्टि करें।
4. हाल के ऐतिहासिक दिन के लिए कैश रिपोर्ट खोलें। सुनिश्चित करें कि कुल मिलाकर पुराने सिस्टम से मेल खाते हैं।

अपेक्षित परिणाम: रैंडम नमूने पुराने स्रोत से मेल खाते हैं। यदि कोई विशेष रिकॉर्ड गलत है, तो समस्या को नोट करें। मामूली स्वरूपण अंतर सामान्य हैं। प्रमुख मूल्य विसंगतियाँ लाइव जाने से पहले जांच के लायक एन्कोडिंग या डेटा अखंडता समस्या का सुझाव देती हैं।

चरण 9: पुराने क्लाइंट रनटाइम समर्थन को सक्षम करें (वैकल्पिक)

यदि आप चाहते हैं कि आपके मौजूदा V3 या V4 क्लाइंट मशीनें कनेक्ट होती रहें जबकि आप संक्रमण कर रहे हैं, तो अब रनटाइम प्रोटोकॉल को सक्षम करें।

1. पुराने क्लाइंट्स की सेटिंग्स पेज के शीर्ष पर स्क्रॉल करें।
2. पुराने क्लाइंट समर्थन सक्षम करें पर टॉगल करें।
3. सुनिश्चित करें कि लिसनर पोर्ट्स (UDP 710, TCP 712, फाइल ट्रांसफर 717) आपके नेटवर्क पर किसी अन्य चीज़ के साथ संघर्ष नहीं करते हैं।
4. सहेजें पर क्लिक करें।

अपेक्षित परिणाम: LAN पर पुराने क्लाइंट्स 5 से 10 सेकंड के भीतर एडमिन पैनल में दिखाई देते हैं। उन्हें पैनल से प्रबंधित करने के तरीके के लिए पुराने क्लाइंट्स देखें।

माइग्रेशन को कैसे पूर्ववत करें

यदि माइग्रेशन ने अप्रत्याशित परिणाम उत्पन्न किए हैं, तो आप इसे पूरी तरह से वापस रोल कर सकते हैं। मूल पुराना डेटाबेस अप्रभावित रहता है।

1. सेटिंग्स > पुराने क्लाइंट्स खोलें।
2. डेटाबेस माइग्रेशन सेक्शन तक स्क्रॉल करें।
3. माइग्रेशन पूर्ववत करें पर क्लिक करें।
4. डायलॉग में पुष्टि करें।

प्रत्येक माइग्रेटेड पंक्ति HandyCafe से हटा दी जाती है। स्थिति कभी नहीं पर वापस आ जाती है। फिर आप अंतर्निहित समस्या (एन्कोडिंग, स्रोत डेटा सफाई, आदि) को ठीक कर सकते हैं और माइग्रेशन फिर से शुरू कर सकते हैं।

माइग्रेशन को फिर से कैसे चलाएं

फिर से चलाने से स्रोत से ताजा डेटा के साथ माइग्रेटेड डेटा बदल जाता है।

1. सेटिंग्स > पुराने क्लाइंट्स खोलें।
2. माइग्रेशन फिर से चलाएं पर क्लिक करें (पहली पूर्ण रन के बाद बटन का लेबल बदल जाता है)।
3. प्रवाह प्रारंभिक रन के समान है।

फिर से चलाना जितनी बार आपको आवश्यकता हो सुरक्षित है। यह डेटा को डुप्लिकेट नहीं करता क्योंकि यह मौजूदा माइग्रेशन आउटपुट को बदल देता है।

सामान्य गलतियों से बचें

• जब पुराना सर्वर सक्रिय हो तब माइग्रेशन चलाना। स्रोत डेटाबेस लॉक हो सकता है या आंशिक लेखन हो सकता है। हमेशा पहले पुराने सर्वर को बंद करें।
• एन्कोडिंग फील्ड को नजरअंदाज करना। गलत एन्कोडिंग के साथ चलाने से सदस्य नाम और लॉग संदेश भ्रष्ट हो जाते हैं। इसके बाद इसे ठीक करने के लिए Undo और फिर से चलाना आवश्यक है।
• माइग्रेशन के दौरान HandyCafe को बंद करना। रन बाधित हो जाता है और आंशिक डेटा लिखा जाता है। पुनर्प्राप्ति के लिए Undo की आवश्यकता होती है। हमेशा प्रगति मोडल को पूरा होने दें।
• स्पॉट-जांच चरण को छोड़ना। रिकॉर्ड काउंट्स पर भरोसा करना बिना नमूना डेटा को सत्यापित किए सूक्ष्म मुद्दों को याद करता है जैसे कि लोकेल बेमेल या राउंडिंग त्रुटियाँ।
• पुरानी इंस्टॉलेशन को बहुत जल्दी हटाना। माइग्रेशन के बाद कम से कम एक पूर्ण भुगतान चक्र के लिए स्रोत फाइलें रखें। यदि मासिक रिपोर्ट पर कोई विसंगति सामने आती है, तो आप मूल रिकॉर्ड का संदर्भ दे सकते हैं।
• बैकअप के बिना माइग्रेट करना। पहले माइग्रेशन से पहले पुराने इंस्टॉलेशन फ़ोल्डर की कॉपी करें। जबकि स्रोत को माइग्रेशन द्वारा संशोधित नहीं किया जाता है, डिस्क मुद्दे या दुर्घटनाएं हो सकती हैं। एक बैकअप सस्ती बीमा है।