Node troubleshooting

जब node status में visible हो लेकिन node tools fail हों तो इस पृष्ठ का उपयोग करें।

Command ladder

bash
mayros status
mayros gateway status
mayros logs --follow
mayros doctor
mayros channels status --probe

फिर node specific checks चलाएं:

bash
mayros nodes status
mayros nodes describe --node <idOrNameOrIp>
mayros approvals get --node <idOrNameOrIp>

स्वस्थ signals:

  • Node role node के लिए connected और paired है।
  • nodes describe में वह capability शामिल है जिसे आप call कर रहे हैं।
  • Exec approvals expected mode/allowlist दिखाते हैं।

Foreground requirements

canvas.*, camera.* और screen.* iOS/Android nodes पर केवल foreground हैं।

Quick check और fix:

bash
mayros nodes describe --node <idOrNameOrIp>
mayros nodes canvas snapshot --node <idOrNameOrIp>
mayros logs --follow

यदि आप NODE_BACKGROUND_UNAVAILABLE देखते हैं, तो node app को foreground में लाएं और retry करें।

Permissions matrix

CapabilityiOSAndroidmacOS node appTypical failure code
camera.snap, camera.clipCamera (+ clip audio के लिए mic)Camera (+ clip audio के लिए mic)Camera (+ clip audio के लिए mic)*_PERMISSION_REQUIRED
screen.recordScreen Recording (+ वैकल्पिक mic)Screen capture prompt (+ वैकल्पिक mic)Screen Recording*_PERMISSION_REQUIRED
location.getWhile Using या Always (mode पर निर्भर)Mode के आधार पर Foreground/Background locationLocation permissionLOCATION_PERMISSION_REQUIRED
system.runn/a (node host path)n/a (node host path)Exec approvals आवश्यकSYSTEM_RUN_DENIED

Pairing बनाम approvals

ये अलग gates हैं:

  1. Device pairing: क्या यह node gateway से connect हो सकता है?
  2. Exec approvals: क्या यह node एक specific shell command चला सकता है?

Quick checks:

bash
mayros devices list
mayros nodes status
mayros approvals get --node <idOrNameOrIp>
mayros approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"

यदि pairing missing है, तो पहले node device को approve करें। यदि pairing ठीक है लेकिन system.run fail होता है, तो exec approvals/allowlist fix करें।

सामान्य node error codes

  • NODE_BACKGROUND_UNAVAILABLE → app backgrounded है; इसे foreground में लाएं।
  • CAMERA_DISABLED → node settings में camera toggle disabled।
  • *_PERMISSION_REQUIRED → OS permission missing/denied।
  • LOCATION_DISABLED → location mode off है।
  • LOCATION_PERMISSION_REQUIRED → requested location mode granted नहीं।
  • LOCATION_BACKGROUND_UNAVAILABLE → app backgrounded है लेकिन केवल While Using permission exists।
  • SYSTEM_RUN_DENIED: approval required → exec request को explicit approval की आवश्यकता।
  • SYSTEM_RUN_DENIED: allowlist miss → allowlist mode द्वारा command blocked।

संबंधित