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. Pass your client credentials and the same region you installed with:

$CLIENT_ID = "{CLIENT_ID}"
$CLIENT_SECRET = "{CLIENT_SECRET}"

$installer = (Invoke-WebRequest `
  -Uri https://get.upwind.io/sensor.ps1 `
  -UseBasicParsing).Content
& ([ScriptBlock]::Create($installer)) upgrade `
  -UPWIND_CLIENT_ID $CLIENT_ID `
  -UPWIND_CLIENT_SECRET $CLIENT_SECRET `
  -UPWIND_REGION "us"

Replace {CLIENT_ID} and {CLIENT_SECRET} with your client credentials, and set -UPWIND_REGION to your Upwind region. The upgrade doesn't read the region from the existing installation. If you omit -UPWIND_REGION, the script uses us and rewrites the sensor configuration to the US endpoints. If you installed with -UPWIND_API_HOST and -UPWIND_AUTH_ENDPOINT, pass them again instead of -UPWIND_REGION. If you set a custom -UPWIND_HOST_SCAN_INTERVAL or -UPWIND_AUTO_UPDATE_INTERVAL at installation, pass it again, otherwise the upgrade resets it to 60.

To upgrade to a specific version, add -UPWIND_SENSOR_VERSION "1.2.3".

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.

Disabling the Scanner​

If you want to disable the scanner after installing, you can do so either by running the install script with the -UPWIND_ENABLE_HOST_SCAN '0' parameter or by deleting the scheduled task that runs the scanner.

Unregister-ScheduledTask -TaskName "UpwindHostScan" -TaskPath "\Upwind\" -Confirm:$false

Checking Automatic Updates​

When automatic updating is enabled, the scheduled task \Upwind\UpwindAutoUpdate runs the installation script every UPWIND_AUTO_UPDATE_INTERVAL minutes and installs the latest stable Sensor. To see when it last ran and its result:

Get-ScheduledTask -TaskPath "\Upwind\" -TaskName "UpwindAutoUpdate" | Get-ScheduledTaskInfo

To turn automatic updating off, run the upgrade command with -UPWIND_AUTO_UPDATE "0" added. The installer removes the task.

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.