સેલર્સ માટે

એજન્ટ ઇન્સ્ટોલ કરવું અને ચલાવવું

એજન્ટ ડાઉનલોડ કરો, એનરોલમેન્ટ કોડથી તેને કનેક્ટ કરો, તેને ચાલુ રાખો, અને સામાન્ય સમસ્યાઓ ઉકેલો.

એજન્ટ એક નાની ફાઇલ છે. ઇન્સ્ટોલ કરવા જેવું કંઈ નથી, કોઈ ડેટાબેઝ નથી અને એડમિનિસ્ટ્રેટર એકાઉન્ટની જરૂર નથી. તે ફક્ત તમારી વર્કશોપમાંથી બહાર તરફ કનેક્શન બનાવે છે, તેથી તમારા રાઉટર પર કોઈ પોર્ટ ખોલવાની જરૂર નથી.

જો તમે હજી વાંચ્યું ન હોય, તો તમારા મશીનો કનેક્ટ કરવા માં સમજાવ્યું છે કે એજન્ટ શું કરે છે અને પેરિંગ અને બાઇન્ડિંગમાં શું ફરક છે. આ ગાઇડ કમ્પ્યુટર વિશે છે.

  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 (ડ્રાઇવર: centauri)

  • mainboardId (જરૂરી): પ્રિન્ટરનો id. પેરિંગ અથવા ./yantra-agent discover તમને તે આપે છે.
  • host (વૈકલ્પિક): પ્રિન્ટરનું IP સરનામું. શક્ય હોય તો તેને છોડી દો. તેના વગર એજન્ટ પ્રિન્ટરને તેના id થી શોધે છે, જે તમારું રાઉટર નવું સરનામું આપે તો પણ ચાલતું રહે છે.
  • uploadPort (વૈકલ્પિક, ડિફોલ્ટ 80): ફાઇલો મોકલવા માટે વપરાતો વેબ પોર્ટ.
  • printPlatformType (વૈકલ્પિક, ડિફોલ્ટ 0): બિલ્ડ પ્લેટના પ્રકારનો કોડ.
  • calibrationSwitch (વૈકલ્પિક, ડિફોલ્ટ 0): દરેક જોબ પહેલાં પ્રિન્ટર કેલિબ્રેટ કરે તે માટે 1 સેટ કરો.

Klipper (ડ્રાઇવર: 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 પર તમે એડમિનિસ્ટ્રેટર અધિકારો વગર યુઝર service તરીકે જાતે સેટ કરી શકો છો. આને ~/.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 આવે છે. સમસ્યા અમારી બાજુની છે, તમારા કમ્પ્યુટરની નથી. પાર્ટનર સપોર્ટ નો સંપર્ક કરો, પછી નવા કોડ સાથે ફરી પ્રયત્ન કરો.
  • એજન્ટ કહે છે કે તેની credentials ફાઇલ બીજા યુઝર્સ વાંચી શકે છે. બીજા વાંચી શકે એવી ગુપ્ત ફાઇલ સાથે તે ચાલવાનો ઇનકાર કરે છે. Linux પર credentials.json પર chmod 600 ચલાવો.
  • એજન્ટ ચાલે છે પણ કોઈ મશીન ઑફલાઇન દેખાય છે. ઑફલાઇન એટલે મશીન સુધી પહોંચી શકાતું નથી, એજન્ટ નહીં. agent.json માં સરનામું તપાસો, અને એ પણ કે આ કમ્પ્યુટર પ્રિન્ટર સુધી પહોંચી શકે છે.
  • પેરિંગમાં કહે છે કે એજન્ટે કોઈ ડિવાઇસ જણાવ્યું નથી. તે શરૂ થાય ત્યારે અને પછી દર થોડી મિનિટે જણાવે છે. ./yantra-agent status થી તપાસો કે તે ચાલુ છે. તે માત્ર પોતાના નેટવર્ક પર પહોંચી શકાય તે જ જુએ છે.
  • discover કશું શોધતું નથી. પહેલાં વધુ રાહ જોવાનો સમય આપી જુઓ: ./yantra-agent discover --timeout 15s. તો પણ કશું ન મળે, તો કમ્પ્યુટર અને પ્રિન્ટર કદાચ એક જ નેટવર્ક પર નથી. VPN, ગેસ્ટ નેટવર્ક અથવા ડિવાઇસને એકબીજાથી અલગ રાખતું Wi-Fi રાઉટર તેને અટકાવે છે.
  • તે વારંવાર ફરી કનેક્ટ થાય છે. લોગની લાઇન વાંચો. તેમાં કારણ લખેલું હોય છે. બે સામાન્ય કારણો: કમ્પ્યુટરની ઘડિયાળ ઘણી ખોટી હોવી, અને કંપનીનું પ્રોક્સી જે લાઇવ કનેક્શન અટકાવે છે.

ટૂંકમાં

એજન્ટ ઉમેરો, ફાઇલ ડાઉનલોડ કરો, એક વાર એનરોલ કરો, તેને ચલાવો, પછી તમારા મશીનો પેર કરો. કોડ કામ ન કરે ત્યાં સુધી એનરોલમેન્ટ કોડ સાચવીને રાખો. પાછા તમારા મશીનો કનેક્ટ કરવા પર જાઓ.