Skip to main content

Troubleshooting

Overview​

If you are experiencing issues with the Upwind Sensor on Windows, follow the steps below to troubleshoot.

Check the Service Status​

  1. Check the status of the Upwind Sensor service by running the following command in an elevated PowerShell prompt:
Get-Service -Name "UpwindSensor"

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:
Start-Service -Name "UpwindSensor"

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​

The installer writes logs to the following locations:

  • Installer log: $env:TEMP\upwind-sensor-installer.log
  • MSI log: $env:TEMP\upwind-msi.log

To view installer events in the Windows Event Log, run the following command in an elevated PowerShell prompt:

Get-WinEvent -FilterHashtable @{ LogName = 'Application'; ProviderName = 'UpwindInstaller' }

To view only the most recent events:

Get-WinEvent -FilterHashtable @{ LogName = 'Application'; ProviderName = 'UpwindInstaller' } -MaxEvents 100

Check Firewall and Networking​

  1. Ensure that the host where the Upwind Sensor is installed has network connectivity to the Upwind API endpoint and that the necessary ports are open. By default, the Upwind Sensor uses port 443 (HTTPS) to communicate with the Upwind API. The API endpoint depends on the UPWIND_REGION configured during installation (us, eu, me; defaults to us). If you are using Windows Firewall or a security group, ensure that outbound traffic on 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.

Upgrading the Upwind Sensor​

To upgrade the Upwind Sensor, run the installation script with the upgrade subcommand.

$installer = (Invoke-WebRequest `
  -Uri https://get.upwind.io/sensor.ps1 `
  -UseBasicParsing).Content

& ([ScriptBlock]::Create($installer)) upgrade `

To upgrade to a specific version, add the -UPWIND_SENSOR_VERSION parameter:

& ([ScriptBlock]::Create($installer)) upgrade `
  -UPWIND_REGION "us" `
  -UPWIND_SENSOR_VERSION "1.2.3"

If you need to refresh the credentials during an upgrade, pass -UPWIND_CLIENT_ID and -UPWIND_CLIENT_SECRET explicitly.

Uninstalling the Upwind Sensor​

To uninstall the Upwind Sensor, run the installation script with the uninstall subcommand:

$installer = (Invoke-WebRequest `
  -Uri https://get.upwind.io/sensor.ps1 `
  -UseBasicParsing).Content

& ([ScriptBlock]::Create($installer)) uninstall

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

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.