Network Management

Configuration Wizard stalls at 98.9% during Agent deployment (5%) while downloading SolarWinds-Agent.zip

This article explains how to resolve the Configuration Wizard stuck at 98.9% - Agent deployment 5.0% - Downloading SolarWinds-Agent.zip

First published date

12/31/2025 9:39 PM

Last published date

6/26/2026 8:19 PM

Overview

When running the Configuration Wizard, the progress may appear to hang at 98.9%, while the Agent deployment phase does not advance beyond 5%. This typically occurs during the step where the installer attempts to download the SolarWinds Agent package.

The Configuration Wizard logs are showing the following errors:

2022-04-12 01:32:12,972 [112] DEBUG OrionWebClient - Authentication attempt to URL: https://<SolarWindsPlatform>:443/api/AgentManagementDownloadAgent/DownloadWindowsOfflineInstaller?requestJson=%7B%22Hostname%22:%22<Hostname>%22,%22IpAddress%22:%22<IP address>,%22IsActiveAgent%22:true%7D failed

2022-04-12 01:32:12,972 [112] DEBUG AgentDeployment - Attempt 3. Downloading agent installer from https://<SolarWindsPlatform>:443/api/AgentManagementDownloadAgent/DownloadWindowsOfflineInstaller?requestJson=%7B%22Hostname%22:%22<Hostname>%22,%22IpAddress%22:%22<IP address>%22,%22IsActiveAgent%22:true%7D.
2022-04-12 01:32:12,988 [112] DEBUG OrionWebClient - Request timeout set to 600000 ms

Product section

Network Performance Monitor

Cause

The Configuration Wizard logs show repeated failures when attempting to download the SolarWinds Agent installer, indicating that Agent AutoDeploy is enabled for an engine that cannot successfully retrieve the agent package.

 

Resolution

Agent AutoDeploy needs to be unchecked in the OrionServers Table.

1. RDP to the SolarWinds Platform Server.
2. Open the Database Manager.
3. Click "Add Orion Server".
4. Expand the server.
5. Scroll down and look for the SolarWindsOrion Database and expand it.
6. Scroll down and look for OrionServers.
7. Double click and select "Execute query".
8. Look for the ENGINE that has issues and make sure that it has no check on "AgentAutoDeploy".

1.JPG
9. Select "Enable table editing" once more.
10. Click on "Execute query" to double-check the changes.
11. Rerun the Configuration Wizard and it should be completed.