एजेंट को इंस्टॉल करना और चलाना
एजेंट डाउनलोड करें, एनरोलमेंट कोड से उसे जोड़ें, उसे चालू रखें, और आम समस्याएं ठीक करें।
एजेंट सिर्फ एक छोटी फ़ाइल है। कुछ इंस्टॉल नहीं करना, कोई डेटाबेस नहीं, और कोई एडमिन अकाउंट नहीं चाहिए। यह सिर्फ आपकी वर्कशॉप से बाहर की ओर कनेक्शन बनाता है, इसलिए आपको राउटर पर कोई पोर्ट खोलने की ज़रूरत नहीं।
अगर आपने अभी तक नहीं पढ़ा है, तो अपनी मशीनें जोड़ना बताता है कि एजेंट क्या करता है और पेयरिंग बाइंडिंग से कैसे अलग है। यह गाइड खुद कंप्यूटर के बारे में है।
अपने डैशबोर्ड में एजेंट जोड़ें
एजेंट में जाकर एक जोड़ें। आपको एक बार चलने वाला एनरोलमेंट कोड मिलेगा।एजेंट अभी जुड़ा हुआ नहीं दिख रहा है, और आपके पास कॉपी करने के लिए एक कोड है।
एजेंट डाउनलोड करें
जिस कंप्यूटर पर इसे चलाना है, उस पर एजेंट डाउनलोड पेज खोलें। पेज उस कंप्यूटर के लिए सही बिल्ड सुझाता है। Raspberry Pi के लिए Linux ARM बिल्ड में से कोई एक चाहिए। फ़ाइल को कहीं भी रख सकते हैं।आपके पास
yantra-agentनाम की एक फ़ाइल है (Windows परyantra-agent.exe)।एनरोलमेंट कोड से इसे जोड़ें
फ़ाइल वाले फ़ोल्डर में टर्मिनल खोलें और इसे एक बार चलाएं।
--nameवाला हिस्सा वैकल्पिक है।./yantra-agent enrol --code YOUR-CODE-HERE --name "Shed 2 bench"एजेंट अपनी id प्रिंट करता है और अपना गुप्त डेटा इसी कंप्यूटर पर सेव कर लेता है।
इसे चालू करें
./yantra-agent runइसे चलता रहने दें। रोकने के लिए Ctrl और C दबाएं। यह पहले अपना चल रहा काम पूरा करता है, इसलिए रोकना सुरक्षित है। जो जॉब पहले से प्रिंट हो रहा है, वह प्रिंट होता रहता है।
आपके डैशबोर्ड में एजेंट जुड़ा हुआ दिखता है, और आपके शॉप नेटवर्क पर प्रिंटर ढूंढना शुरू कर देता है।
अपनी मशीनें पेयर करें
एजेंट में प्रिंटर पेयर करें चुनें। आपके फ्लीट की हर मशीन उन प्रिंटरों के साथ दिखती है जो एजेंट को मिले। आप बताएं कि कौन सा कौन सा है। एजेंट कभी अंदाज़ा नहीं लगाता, क्योंकि गलत मशीन से पेयर किया गया प्रिंटर गलत पार्ट प्रिंट करेगा।पेयर की गई मशीनों का लाइव स्टेटस Production Floor पर दिखता है।
डाउनलोड की जांच करें
डाउनलोड पेज हर फ़ाइल के पास SHA-256 चेकसम दिखाता है। अपनी फ़ाइल जांचने के लिए अपने सिस्टम वाली लाइन चलाएं और नतीजे की तुलना करें।
sha256sum yantra-agent # Linux
shasum -a 256 yantra-agent # macOS
Get-FileHash yantra-agent.exe # Windows PowerShellएजेंट अपनी फ़ाइलें कहां रखता है
सब कुछ एक ही फ़ोल्डर में रहता है:
- Linux:
~/.config/yantra-agent - macOS:
~/Library/Application Support/yantra-agent - Windows:
%ProgramData%\yantra-agent
दूसरा फ़ोल्डर इस्तेमाल करने के लिए YANTRA_AGENT_HOME सेट करें। एक कंप्यूटर पर दो एजेंट चलाने का तरीका भी यही है। फ़ोल्डर के अंदर:
agent.jsonमें वे मशीनें लिखी होती हैं जिन्हें यह कंप्यूटर चलाता है। इसे शेयर करना सुरक्षित है, जैसे सपोर्ट रिक्वेस्ट में।credentials.jsonइस कंप्यूटर का अपना गुप्त डेटा है। इसे कभी शेयर न करें। अगर कंप्यूटर के दूसरे लोग इसे पढ़ सकते हैं, तो एजेंट चालू होने से मना कर देता है।dataमें एजेंट का सेव किया हुआ काम और जॉब फ़ाइलों की उसकी कॉपियां रहती हैं।
agent.json बदलना
ज़्यादातर प्रिंटरों के लिए आपको यह फ़ाइल कभी बदलनी नहीं पड़ती। पेयरिंग के बाद ./yantra-agent sync चलाएं, यह आपके लिए एंट्री लिख देगा। नया प्रिंटर जोड़ने पर इसे फिर चलाएं। जो आपने हाथ से लिखा है, उसे यह नहीं छूता।
कुछ मशीनें, जैसे Klipper प्रिंटर, हाथ से जोड़ी जाती हैं। अपने डैशबोर्ड में मशीन बनाएं, उसे एजेंट से पेयर करें, फिर एक एंट्री जोड़ें। हर एंट्री आपके फ्लीट की एक मशीन को एक ड्राइवर से जोड़ती है:
{
"cloudUrl": "https://yantrabhavan.com/seller",
"machines": [
{
"machineInstanceId": "<the machine's id>",
"driver": "moonraker",
"config": { "baseUrl": "http://mainsail.local" }
}
]
}हर एंट्री में वही तीन की (key) होती हैं। machineInstanceId आपके फ्लीट की मशीन है, driver बताता है कि एजेंट उससे कैसे बात करे, और config में उस ड्राइवर की सेटिंग्स होती हैं। नीचे वही ड्राइवर हैं जिन्हें यह गाइड कवर करती है।
Elegoo Centauri Carbon (driver: centauri)
mainboardId(ज़रूरी): प्रिंटर की id। पेयरिंग या./yantra-agent discoverसे यह मिल जाती है।host(वैकल्पिक): प्रिंटर का IP एड्रेस। हो सके तो इसे खाली छोड़ दें। इसके बिना एजेंट प्रिंटर को उसकी id से ढूंढता है, जो तब भी चलता रहता है जब आपका राउटर नया एड्रेस दे दे।uploadPort(वैकल्पिक, डिफ़ॉल्ट 80): फ़ाइलें भेजने के लिए इस्तेमाल होने वाला वेब पोर्ट।printPlatformType(वैकल्पिक, डिफ़ॉल्ट 0): बिल्ड प्लेट के प्रकार का कोड।calibrationSwitch(वैकल्पिक, डिफ़ॉल्ट 0): हर जॉब से पहले प्रिंटर को कैलिब्रेट कराने के लिए इसे 1 रखें।
Klipper (driver: moonraker)
baseUrl(ज़रूरी): आपके Moonraker का पता, जैसेhttp://mainsail.localयाhttp://192.168.1.50:7125।apiKey(वैकल्पिक): सिर्फ तब जब आपका Moonraker इसे मांगे।
इसे चालू रखना
सेटअप करते समय एजेंट को टर्मिनल में ./yantra-agent run से चलाएं और देखते रहें। लॉग में ज़्यादा जानकारी के लिए -v जोड़ें। दूसरे टर्मिनल में ./yantra-agent status दिखाता है कि एजेंट अपने बारे में क्या जानता है।
एजेंट को किसी भी समय रोका जा सकता है। जो जॉब उसे मिल चुके हैं वे पहले सेव हो जाते हैं, और रीस्टार्ट के बाद आपकी मशीन जो भी असल में कर रही होती है, एजेंट वहीं से आगे संभाल लेता है।
रीस्टार्ट के बाद इसे अपने आप शुरू करने के लिए, yantra-agent service install आने वाले वर्ज़न में यह आपके लिए कर देगा। अभी यह उपलब्ध नहीं है। Linux पर आप एडमिन अधिकार के बिना इसे यूज़र सर्विस के रूप में खुद सेट कर सकते हैं। इसे ~/.config/systemd/user/yantra-agent.service में सेव करें:
[Unit]
Description=Yantra shop-floor agent
After=network-online.target
[Service]
Type=simple
ExecStart=%h/bin/yantra-agent run
Restart=always
RestartSec=5
[Install]
WantedBy=default.targetफिर इसे चालू करें:
systemctl --user daemon-reload
systemctl --user enable --now yantra-agent
systemctl --user status yantra-agentकिसी के लॉग इन न होने पर भी इसे चालू रखने के लिए, एडमिनिस्ट्रेटर आपके अकाउंट के लिए एक बार loginctl enable-linger चलाता है।
दोबारा शुरू करना या दूसरे कंप्यूटर पर जाना
- नए कंप्यूटर पर जाना: उसी एजेंट के लिए नया एनरोलमेंट कोड जारी करें और नए कंप्यूटर पर
enrolचलाएं। नाम, मशीनें और इतिहास साथ आ जाते हैं। कोड जारी करते ही पुराना कंप्यूटर काम करना बंद कर देता है। - किसी कंप्यूटर को हमेशा के लिए बंद करना: डैशबोर्ड में एजेंट को रिवोक करें। उसने जो किया उसका रिकॉर्ड बना रहता है।
- गलती से बना एजेंट हटाना: उसे डैशबोर्ड में डिलीट करें। उसका इतिहास भी मिट जाता है।
./yantra-agent reset सिर्फ इसी कंप्यूटर पर सेव की गई जानकारी हटाता है। इससे एजेंट की पहुंच रद्द नहीं होती। वह सिर्फ डैशबोर्ड से होती है।
जब कुछ काम न कर रहा हो
- एनरोल करते समय लिखा आ रहा है कि कोड गलत है या एक्सपायर हो गया है। कोड सिर्फ एक बार चलते हैं और जल्दी एक्सपायर हो जाते हैं। डैशबोर्ड में नया कोड बनाएं।
- एनरोल करते समय लिखा आ रहा है कि एजेंट पहले से एनरोल है। अगर आप सच में दोबारा एनरोल करना चाहते हैं, तो पहले
./yantra-agent resetचलाएं, फिर नया कोड इस्तेमाल करें। - एनरोल करते समय 403 आ रहा है। समस्या हमारी तरफ है, आपके कंप्यूटर में नहीं। पार्टनर सपोर्ट से संपर्क करें, फिर नया कोड लेकर दोबारा कोशिश करें।
- एजेंट कहता है कि उसकी credentials फ़ाइल दूसरे यूज़र पढ़ सकते हैं। जिस गुप्त फ़ाइल को दूसरे पढ़ सकें, उस पर वह चलने से मना कर देता है। Linux पर
credentials.jsonपरchmod 600चलाएं। - एजेंट चल रहा है पर कोई मशीन ऑफलाइन दिख रही है। ऑफलाइन का मतलब है कि मशीन तक पहुंचा नहीं जा सकता, एजेंट के साथ समस्या नहीं है।
agent.jsonमें दिया पता जांचें, और यह भी कि यह कंप्यूटर प्रिंटर तक पहुंच पा रहा है। - पेयरिंग में लिखा है कि एजेंट ने कोई डिवाइस रिपोर्ट नहीं किया। यह शुरू होते समय और उसके बाद हर कुछ मिनट में रिपोर्ट करता है।
./yantra-agent statusसे देखें कि वह चल रहा है। यह सिर्फ वही देख पाता है जहां तक उसका अपना नेटवर्क पहुंचता है। discoverको कुछ नहीं मिल रहा। पहले ज़्यादा देर तक इंतज़ार करके देखें:./yantra-agent discover --timeout 15s। फिर भी कुछ न मिले, तो शायद कंप्यूटर और प्रिंटर एक ही नेटवर्क पर नहीं हैं। VPN, गेस्ट नेटवर्क, या ऐसा वाई-फाई राउटर जो डिवाइसों को एक-दूसरे से अलग रखता है, इसे रोक देगा।- यह बार-बार दोबारा कनेक्ट हो रहा है। लॉग की लाइन पढ़ें। उसमें वजह लिखी होती है। दो आम वजहें हैं: कंप्यूटर की घड़ी बहुत गलत समय पर होना, और कंपनी का प्रॉक्सी जो लाइव कनेक्शन रोकता है।
संक्षेप में
एजेंट जोड़ें, फ़ाइल डाउनलोड करें, एक बार एनरोल करें, उसे चलाएं, फिर अपनी मशीनों को पेयर करें। एनरोलमेंट कोड तब तक संभालकर रखें जब तक वह काम न कर जाए। वापस अपनी मशीनें जोड़ना पर जाएं।
आगे पढ़ें
Ready to set up your shop?