सेलर्ससाठी

एजंट इन्स्टॉल करणे आणि चालवणे

एजंट डाउनलोड करा, नोंदणी कोडने कनेक्ट करा, तो चालू ठेवा आणि नेहमीच्या अडचणी सोडवा.

एजंट ही एकच छोटी फाइल आहे. काहीही इन्स्टॉल करायचे नाही, डेटाबेस नाही आणि अॅडमिनिस्ट्रेटर खाते लागत नाही. तो फक्त तुमच्या वर्कशॉपमधून बाहेरच्या दिशेने कनेक्शन करतो, त्यामुळे तुमच्या राउटरवर कोणताही पोर्ट उघडावा लागत नाही.

तुम्ही अजून वाचले नसेल, तर तुमची मशिन्स कनेक्ट करणे मध्ये एजंट काय करतो आणि पेअरिंग व बाइंडिंगमध्ये काय फरक आहे ते सांगितले आहे. हे गाइड कॉम्प्युटरबद्दल आहे.

  1. तुमच्या डॅशबोर्डमध्ये एजंट जोडा

    Agents मध्ये जा आणि एक जोडा. तुम्हाला एकदाच वापरता येणारा नोंदणी कोड मिळेल.

    एजंट अजून कनेक्ट झालेला नाही असा दिसतो, आणि तुमच्याकडे कॉपी करण्यासाठी कोड आहे.

  2. एजंट डाउनलोड करा

    जो कॉम्प्युटर तो चालवणार आहे त्यावर एजंट डाउनलोड पेज उघडा. त्या कॉम्प्युटरला जुळणारी बिल्ड पेज सुचवते. Raspberry Pi साठी Linux ARM बिल्डपैकी एक लागते. फाइल हवी तिथे ठेवा.

    तुमच्याकडे yantra-agent नावाची फाइल आहे (Windows वर yantra-agent.exe).

  3. नोंदणी कोडने ते कनेक्ट करा

    फाइल असलेल्या फोल्डरमध्ये टर्मिनल उघडा आणि हे एकदा चालवा. --name हा भाग ऐच्छिक आहे.

    ./yantra-agent enrol --code YOUR-CODE-HERE --name "Shed 2 bench"

    एजंट स्वतःचा id दाखवतो आणि स्वतःचे गुपित या कॉम्प्युटरवर सेव्ह करतो.

  4. तो सुरू करा

    ./yantra-agent run

    तो चालू राहू द्या. थांबवण्यासाठी Ctrl आणि C दाबा. तो आधी चालू असलेले काम पूर्ण करतो, त्यामुळे थांबवणे सुरक्षित आहे. आधीच प्रिंट होत असलेला जॉब प्रिंट होत राहतो.

    एजंट तुमच्या डॅशबोर्डमध्ये कनेक्ट झालेला दिसतो, आणि तुमच्या शॉप नेटवर्कवर प्रिंटर्स शोधू लागतो.

  5. तुमची मशिन्स पेअर करा

    Agents मध्ये Pair printers निवडा. तुमच्या फ्लीटमधील प्रत्येक मशीन आणि एजंटला सापडलेले प्रिंटर्स यादीत दिसतात. कोणते कोणते ते सांगा. एजंट कधीही अंदाज लावत नाही, कारण चुकीच्या मशीनशी पेअर केलेला प्रिंटर चुकीचा पार्ट छापतो.

    पेअर केलेली मशिन्स 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" }
    }
  ]
}

प्रत्येक एंट्रीमध्ये तीच तीन की असतात. 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 चालवा. नाव, मशिन्स आणि इतिहास सोबत येतात. कोड जारी करताच जुना कॉम्प्युटर काम करणे थांबवतो.
  • कॉम्प्युटर कायमचा बंद करणे: डॅशबोर्डमध्ये एजंट रद्द (revoke) करा. त्याने केलेल्या कामाची नोंद तशीच राहते.
  • चुकून तयार झालेला एजंट काढून टाकणे: डॅशबोर्डमध्ये तो डिलीट करा. त्याचा इतिहासही पुसला जातो.

./yantra-agent reset फक्त कॉम्प्युटरवर साठवलेली माहिती पुसते. ते एजंटचा प्रवेश रद्द करत नाही. ते फक्त डॅशबोर्डवरून होते.

जेव्हा काही काम करत नसेल

  • नोंदणी करताना कोड अवैध किंवा कालबाह्य असल्याचे सांगितले जाते. कोड एकदाच चालतो आणि लवकर कालबाह्य होतो. डॅशबोर्डमध्ये नवीन कोड तयार करा.
  • नोंदणी करताना एजंट आधीच नोंदणीकृत असल्याचे सांगितले जाते. तुम्हाला खरोखर पुन्हा नोंदणी करायची असेल तर आधी ./yantra-agent reset चालवा, मग नवीन कोड वापरा.
  • नोंदणी करताना 403 त्रुटी येते. ही अडचण तुमच्या कॉम्प्युटरची नाही, आमच्या बाजूची आहे. पार्टनर सपोर्टशी संपर्क साधा, मग नवीन कोडने पुन्हा प्रयत्न करा.
  • एजंट सांगतो की त्याची क्रेडेन्शियल्स फाइल इतर वापरकर्ते वाचू शकतात. इतरांना वाचता येईल अशा गुपितावर तो चालण्यास नकार देतो. Linux वर credentials.json वर chmod 600 चालवा.
  • एजंट चालू आहे पण एखादे मशीन ऑफलाइन दिसते. ऑफलाइन म्हणजे मशीनशी संपर्क होत नाही, एजंटशी नाही. agent.json मधील पत्ता तपासा, आणि हा कॉम्प्युटर प्रिंटरपर्यंत पोहोचू शकतो का ते पाहा.
  • पेअरिंगमध्ये एजंटने कोणतीही डिव्हाइसेस कळवली नसल्याचे दिसते. तो सुरू होताना आणि त्यानंतर दर काही मिनिटांनी माहिती कळवतो. ./yantra-agent status ने तो चालू आहे का ते तपासा. त्याच्या स्वतःच्या नेटवर्कवर पोहोचता येईल तेवढेच त्याला दिसते.
  • discover ला काहीच सापडत नाही. आधी जास्त वेळ थांबून पाहा: ./yantra-agent discover --timeout 15s. तरीही काही सापडले नाही, तर कॉम्प्युटर आणि प्रिंटर बहुधा एकाच नेटवर्कवर नाहीत. VPN, गेस्ट नेटवर्क किंवा डिव्हाइसेस एकमेकांपासून वेगळी ठेवणारा Wi-Fi राउटर यामुळे हे अडू शकते.
  • तो वारंवार पुन्हा कनेक्ट होत राहतो. लॉगमधील ओळ वाचा. त्यात कारण दिलेले असते. दोन सामान्य कारणे म्हणजे कॉम्प्युटरचे घड्याळ खूप चुकीचे असणे, आणि कंपनीचा प्रॉक्सी लाइव्ह कनेक्शन अडवणे.

थोडक्यात

एजंट जोडा, फाइल डाउनलोड करा, एकदा नोंदणी करा, चालवा, मग तुमची मशिन्स पेअर करा. कोड नीट काम करेपर्यंत नोंदणी कोड सुरक्षित ठेवा. परत तुमची मशिन्स कनेक्ट करणे कडे.