HandyCafe Docs
owner it-admin

लेगेसी क्लाइंट सेटिंग्स

HandyCafe बिना किसी रुकावट के पुराने V3 और V4 क्लाइंट इंस्टॉलेशन के साथ चलता है। लेगेसी क्लाइंट सेटिंग्स पेज दो विशिष्ट फीचर्स को नियंत्रित करता है:

  1. रनटाइम प्रोटोकॉल। नेटवर्क लिस्नर्स को सक्षम करता है जो V3 और V4 क्लाइंट्स को उनके मूल पोर्ट्स पर इस सर्वर से कनेक्ट करने देते हैं।
  2. डेटाबेस माइग्रेशन। पुराने स्थानीय इंस्टॉलेशन से नए HandyCafe डेटाबेस में सदस्यों, मूल्य निर्धारण, उत्पादों, ऑर्डर्स, लेनदेन, और लॉग्स को वैकल्पिक रूप से आयात करता है। यह केवल विंडोज़ पर उपलब्ध है।

ये दोनों फीचर्स स्वतंत्र हैं। आप डेटा माइग्रेट किए बिना रनटाइम सपोर्ट सक्षम कर सकते हैं, रनटाइम सपोर्ट सक्षम किए बिना डेटा माइग्रेट कर सकते हैं, या दोनों कर सकते हैं।

रनटाइम प्रोटोकॉल सेक्शन

लेगेसी क्लाइंट सपोर्ट सक्षम करें

सेक्शन के शीर्ष पर एक मास्टर टॉगल है। जब चालू होता है, सर्वर तीन नेटवर्क लिस्नर्स शुरू करता है:

  • कॉन्फ़िगर किए गए मल्टीकास्ट ग्रुप पर एक UDP लिस्नर।
  • UDP पोर्ट + 2 पर एक TCP कमांड लिस्नर।
  • UDP पोर्ट + 7 पर एक TCP फ़ाइल ट्रांसफर लिस्नर।

टॉगल को बंद करने से सभी तीन लिस्नर्स एक साथ बंद हो जाते हैं। आप पोर्ट नंबर या एन्कोडिंग को बंद रहते हुए समायोजित कर सकते हैं, फिर परिवर्तनों को लागू करने के लिए पुनः सक्षम कर सकते हैं।

कॉन्फ़िगरेशन फ़ील्ड्स

फ़ील्ड डिफ़ॉल्ट विवरण
ऑथ की HANDYCAFE एक साझा 10-अक्षर की कुंजी। हर इनबाउंड और आउटबाउंड फ्रेम इस स्ट्रिंग को ले जाता है। जो फ्रेम मेल नहीं खाते वे ड्रॉप हो जाते हैं। आपके सभी लेगेसी क्लाइंट्स को एक ही कुंजी का उपयोग करना चाहिए।
UDP मल्टीकास्ट IP 230.4.4.46 क्लाइंट डिस्कवरी बीकन और UDP-आधारित कमांड डिस्पैच के लिए उपयोग किया जाने वाला मल्टीकास्ट ग्रुप। अधिकांश लेगेसी क्लाइंट बिल्ड्स में हार्ड-कोडेड।
सर्वर UDP पोर्ट 710 UDP पोर्ट जिस पर सर्वर क्लाइंट बीकन और कमांड्स के लिए सुनता है। लेगेसी क्लाइंट्स इस पोर्ट पर भेजते हैं।
क्लाइंट UDP पोर्ट 711 UDP पोर्ट जिस पर लेगेसी क्लाइंट्स सुनते हैं। सर्वर खोजे गए क्लाइंट IP पर इस पोर्ट पर यूनिकास्ट प्रबंधन कमांड्स भेजता है।
एन्कोडिंग cp1254 वायर-फॉर्मेट स्ट्रिंग फ़ील्ड्स के लिए कैरेक्टर एन्कोडिंग। तुर्की इंस्टॉलेशन के लिए cp1254 का उपयोग करें, पश्चिमी यूरोपीय के लिए cp1252। अज्ञात मान सर्वर लॉग में चेतावनी के साथ cp1254 पर वापस गिरते हैं।
सर्वर संस्करण 3.4.01 हर UDP बीकन में प्रसारित संस्करण स्ट्रिंग। कुछ लेगेसी क्लाइंट्स उन संस्करणों से फ्रेम्स को अस्वीकार करते हैं जिन्हें वे नहीं पहचानते। इसे अपने मूल सर्वर के संस्करण स्ट्रिंग से मिलाने के लिए सेट करें।
प्रोटोकॉल वेरिएंट STE वायर फॉर्मेट चयन। नीचे वेरिएंट तुलना देखें।
निष्क्रियता टाइमआउट 10 सेकंड। एक प्रति-MAC वॉचडॉग। यदि इस विंडो के भीतर किसी क्लाइंट से कोई ट्रैफ़िक नहीं आता है, तो क्लाइंट ऑफ़लाइन के रूप में चिह्नित होता है। 10 सेकंड का अंतराल उन लेगेसी क्लाइंट्स के लिए उपयुक्त है जो हर 2 या 3 सेकंड में बीकन करते हैं।

व्युत्पन्न पोर्ट्स

फॉर्म के नीचे, पेज एक रीड-ओनली लाइन प्रदर्शित करता है जो व्युत्पन्न TCP पोर्ट्स दिखाता है:

TCP कमांड पोर्ट: 712   फ़ाइल ट्रांसफर पोर्ट: 717

ये पोर्ट्स UDP सर्वर पोर्ट से गणना किए जाते हैं। आप उन्हें अलग से कॉन्फ़िगर नहीं करते। यदि आप सर्वर UDP पोर्ट को किसी अन्य मान में बदलते हैं, तो व्युत्पन्न पोर्ट्स उसके साथ चलते हैं।

प्रोटोकॉल वेरिएंट

प्रोटोकॉल वेरिएंट फ़ील्ड सर्वर द्वारा उपयोग किए जाने वाले वायर फॉर्मेट का चयन करता है। उस वेरिएंट को चुनें जो आपके लेगेसी सर्वर के निर्माण के तरीके से मेल खाता है।

वेरिएंट उपयोग कब करें
STE (स्मार्ट/टर्बो संस्करण) आधुनिक लेगेसी कोडबेस। फ्रेम संरचना में 70-बाइट लाइसेंस-जानकारी प्रीफिक्स जोड़ता है। फ्रेम आकार 1337 बाइट्स है। इसे चुनें यदि आपके लेगेसी इंस्टॉलेशन ने स्मार्ट या टर्बो संस्करण का उपयोग किया था।
स्टैंडर्ड सादा बेसलाइन लेगेसी बिल्ड। लाइसेंस-जानकारी प्रीफिक्स के बिना फ्रेम आकार 1267 बाइट्स है। इसे केवल तभी चुनें यदि आपका लेगेसी इंस्टॉलेशन बिना लाइसेंस पंजीकरण के स्टैंडर्ड संस्करण था।

गलत वेरिएंट चुनने से फ्रेम्स ड्रॉप या गलत पढ़े जा सकते हैं। लक्षणों में शामिल हैं क्लाइंट्स ऑनलाइन दिखाई देना लेकिन हर कमांड को अनदेखा करना, या कमांड डेटा 70-बाइट ऑफ़सेट द्वारा स्थानांतरित होना।

आधुनिक क्लाइंट्स के साथ सह-अस्तित्व

लेगेसी पोर्ट्स (710, 711, 712, 717) आधुनिक HandyCafe प्रोटोकॉल पोर्ट्स (TCP 5001, 5002, 5003, UDP 5004) से पूरी तरह से अलग हैं। दोनों प्रोटोकॉल स्टैक्स बिना किसी संघर्ष के एक साथ चलते हैं। आप एक ही LAN पर पुराने और नए क्लाइंट्स को मिला सकते हैं और उन्हें एक ही एडमिन पैनल से प्रबंधित कर सकते हैं।

परिवर्तनों को लागू करना

रनटाइम प्रोटोकॉल सेक्शन में हर फ़ील्ड को पेज के नीचे स्थित वैश्विक सेव बटन के साथ सहेजा जाता है। सेव पर, सर्वर:

  1. यदि वे चल रहे थे तो तीन लेगेसी लिस्नर्स को रोकता है।
  2. ऑथ की को मान्य करता है (खाली नहीं होना चाहिए)।
  3. अद्यतन फ़ील्ड्स से नए लिस्नर कॉन्फ़िगरेशन बनाता है।
  4. लिस्नर्स को एक साथ पुनः शुरू करता है।
  5. जब सभी तीन वापस ऑनलाइन होते हैं तो एक सूचना फायर करता है।

यदि कोई पोर्ट पहले से किसी अन्य प्रक्रिया द्वारा उपयोग में है, तो सर्वर एक त्रुटि की रिपोर्ट करता है और टॉगल वापस बंद हो जाता है। अपने फ़ायरवॉल और अन्य सेवाओं की netstat के साथ जाँच करें और एक मुफ्त पोर्ट रेंज चुनें।

डेटाबेस माइग्रेशन सेक्शन (केवल विंडोज़ पर)

यह फीचर केवल तब उपलब्ध है जब HandyCafe विंडोज़ पर चलता है। macOS और Linux पर, सेक्शन एक सूचना दिखाता है: "डेटाबेस माइग्रेशन केवल विंडोज़ पर समर्थित है।"

डिटेक्शन

खुलने पर, सर्वर आपके सिस्टम को एक लेगेसी इंस्टॉलेशन के लिए स्कैन करता है। डिटेक्शन देखता है:

  • रजिस्ट्री और विशिष्ट इंस्टॉल पथ जैसे Program Files\HandyCafe और C:\HandyCafe
  • इंस्टॉलेशन के साथ डेटाबेस फ़ाइल।
  • इंस्टॉलेशन डायरेक्टरी में कॉन्फ़िगरेशन INI फाइल्स।

जब डिटेक्शन सफल होता है, पेज प्रदर्शित करता है:

लेबल अर्थ
इंस्टॉल पथ जहां लेगेसी इंस्टॉलेशन डिस्क पर स्थित है।
डेटाबेस पथ लेगेसी डेटाबेस फ़ाइल का पूरा पथ।
सर्वर संस्करण लेगेसी कॉन्फ़िगरेशन से पार्स किया गया।
INI फ़ाइल गिनती पता की गई कॉन्फ़िगरेशन फाइल्स की संख्या। यह सुनिश्चित करने के लिए उपयोगी है कि इंस्टॉलेशन पूरा है।

यदि कोई इंस्टॉलेशन नहीं पाया जाता है, तो पेज "कोई लेगेसी इंस्टॉलेशन नहीं पाया गया।" प्रदर्शित करता है। आप अभी भी रनटाइम सपोर्ट सक्षम कर सकते हैं; माइग्रेशन फीचर के पास आयात करने के लिए कुछ नहीं है।

माइग्रेशन स्थिति

पेज माइग्रेशन इतिहास को ट्रैक करता है:

स्थिति अर्थ
कभी नहीं आपने अभी तक कोई माइग्रेशन नहीं चलाया है।
प्रगति में एक माइग्रेशन वर्तमान में चल रहा है। इस स्थिति के दौरान सर्वर को बंद न करें।
पूरा हुआ सबसे हालिया माइग्रेशन बिना किसी चेतावनी के समाप्त हुआ।
चेतावनियों के साथ पूरा हुआ सबसे हालिया माइग्रेशन समाप्त हुआ लेकिन कुछ रिकॉर्ड्स को छोड़ दिया गया (उदाहरण के लिए एन्कोडिंग त्रुटियों या खराब तारीखों के कारण)। आगे बढ़ने से पहले चेतावनियों की समीक्षा करें।
पूर्ववत सबसे हालिया माइग्रेशन को वापस ले लिया गया।

पहली सफल रन के बाद, स्टार्ट माइग्रेशन बटन का नाम बदलकर रीरन माइग्रेशन कर दिया जाता है।

क्या माइग्रेट होता है

तालिका विवरण
सदस्य नाम, संपर्क जानकारी, और खाता शेष के साथ ग्राहक रिकॉर्ड्स।
मूल्य निर्धारण मूल्य तालिकाएँ और घंटे-दर-घंटे दरें।
उत्पाद उत्पाद कैटलॉग प्रविष्टियाँ।
ऑर्डर्स सत्र संदर्भों के साथ ऑर्डर इतिहास।
लेनदेन टाइमस्टैम्प्स, राशियों, और भुगतान विधियों के साथ लेजर प्रविष्टियाँ।
लॉग्स लेगेसी डेटाबेस से ऑडिट और चेतावनी प्रविष्टियाँ।

"फाइल्स सुरक्षित" गारंटी

पेज नीले रंग में एक सूचना प्रदर्शित करता है: "मूल डेटाबेस फाइल्स को हटाया नहीं जाता है। आप माइग्रेशन की पुष्टि होने के बाद उन्हें सुरक्षित रूप से हटा सकते हैं।" माइग्रेशन स्रोत पर केवल-पढ़ने के लिए है। भले ही आप माइग्रेशन को कई बार चलाएं, मूल लेगेसी डेटाबेस अप्रभावित रहता है। यह आपको आयात के साथ प्रयोग करने, गिनती की समीक्षा करने, और बिना जोखिम के वापस रोल करने की अनुमति देता है।

प्रारंभ, पुनः चलाएँ, और पूर्ववत करें

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

चेतावनियों के साथ पूरा हुआ

यदि माइग्रेशन चेतावनियों के साथ पूरा हुआ के साथ समाप्त होता है, तो एक पीला बैनर एक विवरण लिंक के साथ दिखाई देता है। छोड़े गए रिकॉर्ड्स की सूची के साथ कारण का विस्तार करने के लिए क्लिक करें। सामान्य कारण:

  • एन्कोडिंग बेमेल। स्रोत पंक्ति में ऐसे कैरेक्टर होते हैं जो कॉन्फ़िगर की गई एन्कोडिंग में साफ़ रूप से डिकोड नहीं होते। एन्कोडिंग फ़ील्ड (cp1254 या cp1252) बदलें और माइग्रेशन को पुनः चलाएँ।
  • खराब तारीखें। कुछ लेगेसी रिकॉर्ड्स में अमान्य टाइमस्टैम्प्स होते हैं। इन्हें छोड़ दिया जाता है ताकि वैध पंक्तियाँ अभी भी आयात हो सकें।
  • डुप्लिकेट कुंजियाँ। एक ही पहचानकर्ता वाला रिकॉर्ड पहले से ही HandyCafe में मौजूद है। माइग्रेशन मौजूदा रिकॉर्ड को संरक्षित करता है और डुप्लिकेट को छोड़ देता है।

सुझाव

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