Skip to main content

Troubleshooting

Overview​

If you are experiencing issues with the Upwind Sensor, follow the steps below to troubleshoot:

Check the Service Status​

  1. Check the status of the Upwind Sensor service by running the following command:
systemctl status upwind-agent.service

This will display information about the service, including whether it is currently running or not.

  1. If the service is not running, you can start it by running the following command:
systemctl start upwind-agent.service

If the service fails to start, check the logs (as described below) for error messages that may indicate the cause of the issue.

Check the Logs​

  1. To view the Upwind Sensor logs, run the following command:
journalctl -u upwind-agent.service

This will display the logs for the Upwind Sensor service, including any error messages that may be related to the issue you are experiencing.

  1. If you need to view only the most recent logs, you can run the following command:
journalctl -u upwind-agent.service -n 100

This will display the 100 most recent log entries.

Update Client Credentials​

  1. To update the client credentials, edit the /etc/upwind/agent.yaml file and modify the auth-client-id and auth-client-secret variables:
[...]
auth-client-id: <CLIENT_ID>
auth-client-secret: <CLIENT_SECRET>
[...]

Then, restart the appropriate Upwind Sensor services by running:

systemctl restart upwind-agent-hostconfig.service

and

systemctl restart upwind-agent.service

Check Firewall and Networking​

  1. Ensure that the host where the Upwind Sensor is installed has network connectivity to the Upwind API endpoint (api.upwind.io) and that the necessary ports are open. By default, the Upwind Sensor uses port 443 (HTTPS) to communicate with the Upwind API. If you are using a firewall or security group, ensure that traffic to and from port 443 is allowed.

  2. If the host where the Upwind Sensor is installed is running behind a NAT gateway, ensure that the gateway is correctly configured to forward traffic to the host on port 443.

Contact Support​

If you are still having issues with the Upwind Sensor, you can contact Upwind support via email at support@upwind.io or through the Chat button in the Upwind Management Console.

Provide as much detail as possible about the issue you are experiencing, including any relevant logs or error messages. Upwind support will work with you to diagnose and resolve the issue as quickly as possible.

Uninstalling the Upwind Agent​

If you need to uninstall the Upwind Agent for any reason, follow the steps below:

  1. Run the following command to uninstall the Upwind Agent:
curl -s https://get.upwind.io/agent.sh | bash -s uninstall

This command will remove the Upwind Agent from your system. If you encounter any issues during the uninstallation process, please contact Upwind support for assistance.