Network Management

Linux Agent Installation and Connection Issues

Linux Agent not connecting. Cannot provision the agent. Reprovision agent fails. Failed: Error in SSL handshake : Connection reset by peer. Connection closed by foreign host. Agent not showing up in the Manage Agents page after installing.

First published date

10/13/2020 3:15 PM

Last published date

5/6/2025 2:14 PM

Overview

Utilize this article for troubleshooting Orion Linux Agent issues.

New agent cannot connect
Agent cannot be contacted
Unable to connect to agent
Reprovision message shows: Failed: Error in SSL handshake : Connection reset by peer

Product section

Orion Platform

Cause

Typically port issues

Resolution

Check the current status of the agent under the Manage Agents menu (Settings > All Settings > Manage Agents).

Resolution 1

If the agent is not displayed it is not finished with installation or has not completed the reprovision step.

SSH to the agent machine.
Reprovision the agent with this command:
```
swiagentd init
```
Enter proper information (polling engine, administrator user and password). Then use option 7 to provision.

If you receive a connection message. Verify the port is open with this command if agent-initiated (default):

/* Scripts are not supported under any SolarWinds support program or service. Scripts are provided AS IS without warranty of any kind. SolarWinds further disclaims all warranties including, without limitation, any implied warranties, of merchantability or of fitness for a particular purpose. The risk arising out of the use or performance of the scripts and documentation stays with you. In no event shall SolarWinds or anyone else involved in the creation, production, or delivery of the scripts be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the scripts or documentation. */

curl -k https://<OrionServer>:17778/solarwinds/agentmanagement/api/TestConnection

Or verify the port is open with this command if server-initiated (you will need to perform from the Orion poller with PowerShell):

Test-NetConnection -ComputerName LinuxServer -port 17790

If the port test fails then the port is not accessible. Work with your network team to open the port.

Resolution 2

Restart the poller.

Disclaimer: Please note, any content posted herein is provided as a suggestion or recommendation to you for your internal use. This is not part of the SolarWinds software or documentation that you purchased from SolarWinds, and the information set forth herein may come from third parties. Your organization should internally review and assess to what extent, if any, such custom scripts or recommendations will be incorporated into your environment. You elect to use third-party content at your own risk, and you will be solely responsible for the incorporation of the same if any.