సెల్లర్ల కోసం

ఏజెంట్‌ను ఇన్‌స్టాల్ చేసి నడపడం

ఏజెంట్‌ను డౌన్‌లోడ్ చేయండి, ఎన్‌రోల్‌మెంట్ కోడ్‌తో కనెక్ట్ చేయండి, నడుస్తూ ఉంచండి, సాధారణ సమస్యలను సరిచేయండి.

ఏజెంట్ ఒక చిన్న ఫైల్. ఇన్‌స్టాల్ చేయడానికి ఏమీ లేదు, డేటాబేస్ గానీ అడ్మినిస్ట్రేటర్ ఖాతా గానీ అవసరం లేదు. ఇది మీ వర్క్‌షాప్ నుండి బయటకు మాత్రమే కనెక్షన్లు చేస్తుంది, కాబట్టి మీ రూటర్‌లో ఏ పోర్ట్ తెరవాల్సిన అవసరం లేదు.

ఇంకా చదవకపోతే, ఏజెంట్ ఏం చేస్తుందో, పెయిరింగ్ బైండింగ్ కంటే ఎలా వేరో మీ మెషిన్లను కనెక్ట్ చేయడం లో ఉంది. ఈ గైడ్ కంప్యూటర్ గురించి వివరిస్తుంది.

  1. మీ డాష్‌బోర్డ్‌లో ఏజెంట్‌ను జోడించండి

    ఏజెంట్లు కు వెళ్లి ఒకదాన్ని జోడించండి. మీకు ఒక్కసారి వాడే ఎన్‌రోల్‌మెంట్ కోడ్ వస్తుంది.

    ఏజెంట్ ఇంకా కనెక్ట్ కాలేదని జాబితాలో ఉంటుంది, మీ దగ్గర కాపీ చేయడానికి కోడ్ ఉంటుంది.

  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. మీ మెషిన్లను పెయిర్ చేయండి

    ఏజెంట్లు లో ప్రింటర్లను పెయిర్ చేయండి ఎంచుకోండి. మీ ఫ్లీట్‌లోని ప్రతి మెషిన్, ఏజెంట్ కనుగొన్న ప్రింటర్లతో పాటు జాబితాలో కనిపిస్తుంది. ఏది ఏదో మీరే చెప్పండి. ఏజెంట్ ఎప్పుడూ ఊహించదు, ఎందుకంటే తప్పు మెషిన్‌తో పెయిర్ అయిన ప్రింటర్ తప్పు పార్ట్‌ను ప్రింట్ చేస్తుంది.

    పెయిర్ అయిన మెషిన్లు 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 లో అడ్మినిస్ట్రేటర్ హక్కులు లేకుండానే యూజర్ సర్వీస్‌గా మీరే సెటప్ చేసుకోవచ్చు. దీన్ని ~/.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 ఎర్రర్ వస్తోంది. సమస్య మా వైపు ఉంది, మీ కంప్యూటర్‌లో కాదు. పార్ట్నర్ సపోర్ట్ను సంప్రదించి, కొత్త కోడ్‌తో మళ్లీ ప్రయత్నించండి.
  • క్రెడెన్షియల్స్ ఫైల్‌ను ఇతర యూజర్లు చదవగలరని ఏజెంట్ చెబుతోంది. ఇతరులు చదవగల రహస్యంతో అది నడవదు. Linux లో credentials.json పై chmod 600 నడపండి.
  • ఏజెంట్ నడుస్తోంది కానీ మెషిన్ ఆఫ్‌లైన్ అని చూపుతోంది. ఆఫ్‌లైన్ అంటే మెషిన్ చేరుకోలేకపోవడం, ఏజెంట్ కాదు. agent.json లో చిరునామాను, మరియు ఈ కంప్యూటర్ ప్రింటర్‌ను చేరుకోగలదో లేదో చూడండి.
  • ఏజెంట్ ఏ పరికరాలనూ నివేదించలేదని పెయిరింగ్ చెబుతోంది. ఏజెంట్ స్టార్ట్ అయినప్పుడు, ఆ తర్వాత ప్రతి కొన్ని నిమిషాలకు నివేదిస్తుంది. ./yantra-agent status తో అది నడుస్తోందో చూడండి. తన నెట్‌వర్క్ చేరుకోగలిగినవి మాత్రమే దానికి కనిపిస్తాయి.
  • discover ఏమీ కనుగొనలేదు. ముందు ఎక్కువ సమయం వేచి చూడండి: ./yantra-agent discover --timeout 15s. అయినా ఏమీ దొరకకపోతే, కంప్యూటర్ మరియు ప్రింటర్ ఒకే నెట్‌వర్క్‌లో లేకపోవచ్చు. VPN, గెస్ట్ నెట్‌వర్క్, లేదా పరికరాలను వేరుగా ఉంచే Wi-Fi రూటర్ దీన్ని అడ్డుకుంటాయి.
  • అది మళ్లీ మళ్లీ రీకనెక్ట్ అవుతోంది. లాగ్ లైన్ చదవండి, అందులో కారణం ఉంటుంది. సాధారణ కారణాలు రెండు: కంప్యూటర్ గడియారం చాలా తప్పుగా ఉండటం, లేదా కంపెనీ ప్రాక్సీ లైవ్ కనెక్షన్లను అడ్డుకోవడం.

క్లుప్తంగా

ఏజెంట్‌ను జోడించండి, ఫైల్ డౌన్‌లోడ్ చేయండి, ఒకసారి ఎన్‌రోల్ చేయండి, నడపండి, తర్వాత మీ మెషిన్లను పెయిర్ చేయండి. పని చేసే వరకు ఎన్‌రోల్‌మెంట్ కోడ్‌ను భద్రంగా ఉంచండి. తిరిగి మీ మెషిన్లను కనెక్ట్ చేయడం కు వెళ్లండి.