Troubleshoot IoT Connectivity

Symptoms:

• SystemConnection tests fail (even though credentials are correct).
• Sensor Test fails (even though sensor details are correct).
• On the Admin::Implementation page:
  • Data Connector Installation Status icon is showing ERROR in red.
  • Health Status is showing empty table or all the Status fields are show in red.
• Adding/Updating/Sensors from the webapp are not impacting the data collection process (i.e., fix a SQL table detail, but data still doesn't come in).

Solutions:

• If this is a first time install (requires access to machine hosting Data Connector):
  1. Run edge-status.ps1.
     • This will check if you have potential networking issues.
     • Look specifically in the "Verify Network Access" section for the IoT related interfaces (usually the first two).
     • Warning: The script currently does not support proxied environments (and will give misleading results).
  2. Check firewalls.
     • Check Windows Defender rules for restrictions on ports 443, 8443, 8883.
       • You can add rules to explicitly open them.
       • Note: You should only need to open the "Outbound Rules".
     • Consult your IT department for any networking specific port restrictions.
• If it was working, but stopped:
  1. Press the Deploy button on Admin::Implementation button again.
     • This fixes most intermittent IoT issues.
     • However, it sometimes takes a while before it is processed (up to 2 hours).
  2. Restart Greengrass Service.
     • Also, this fixes most intermittent IoT issues, but requires access to the machine hosting the Data Connector.