விற்பனையாளர்களுக்கு

ஏஜென்ட்டை இன்ஸ்டால் செய்து இயக்குதல்

ஏஜென்ட்டை டவுன்லோடு செய்து, என்ரோல்மென்ட் குறியீட்டால் இணைத்து, இயங்க வைத்து, வழக்கமான சிக்கல்களைச் சரிசெய்யுங்கள்.

ஏஜென்ட் ஒரே ஒரு சிறிய கோப்பு. இன்ஸ்டால் செய்ய எதுவுமில்லை, டேட்டாபேஸ் இல்லை, அட்மினிஸ்ட்ரேட்டர் கணக்கும் தேவையில்லை. அது உங்கள் ஒர்க்‌ஷாப்பிலிருந்து வெளியே மட்டுமே இணைப்புகளை ஏற்படுத்துகிறது, அதனால் உங்கள் ரூட்டரில் எந்த போர்ட்டையும் திறக்க வேண்டாம்.

இன்னும் படிக்கவில்லை என்றால், ஏஜென்ட் என்ன செய்கிறது, பேரிங்கும் பைண்டிங்கும் எப்படி வேறுபடுகின்றன என்பதை உங்கள் மெஷின்களை இணைத்தல் விளக்குகிறது. இந்த வழிகாட்டி கம்ப்யூட்டரைப் பற்றியது.

  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-இல் அட்மினிஸ்ட்ரேட்டர் உரிமைகள் இல்லாமலேயே யூசர் சர்வீஸாக நீங்களே அமைக்கலாம். இதை ~/.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 ரூட்டர் இதைத் தடுக்கும்.
  • அது திரும்பத் திரும்ப மீண்டும் இணைகிறது. லாக் வரியைப் படியுங்கள். அதில் காரணம் இருக்கும். இரண்டு பொதுவான காரணங்கள்: கம்ப்யூட்டர் கடிகாரம் மிகவும் தவறாக இருப்பது, மற்றும் நிறுவனத்தின் ப்ராக்ஸி நேரடி இணைப்புகளைத் தடுப்பது.

சுருக்கமாக

ஏஜென்ட்டைச் சேர்த்து, கோப்பை டவுன்லோடு செய்து, ஒருமுறை என்ரோல் செய்து, இயக்கி, பிறகு உங்கள் மெஷின்களை பேர் செய்யுங்கள். வேலை செய்யும் வரை என்ரோல்மென்ட் குறியீட்டைப் பத்திரமாக வைத்திருங்கள். உங்கள் மெஷின்களை இணைத்தல் பக்கத்திற்குத் திரும்பு.