Network Management

Failed to deploy Orion agent for Linux as unable to identify target machine's operating system

When attempting to remote deploy the Orion agent for Linux, you may receive the following error when testing the credentials: "Failed to validate credentials for deployment. Unable to identify target machine's operating system." You may not have a supported Linux distribution. To resolve, verify your Linux distribution is supported. If the distribution is supported, you may need to manually deploy the Orion agent for Linux using another method.

First published date

10/15/2018 4:33 PM

Last published date

2/26/2025 4:01 AM

Overview

When attempting to remote deploy the Orion agent for Linux, you may receive the following errors when testing the credentials: 
 

  • "Failed to validate credentials for deployment. Unable to identify target machine's operating system." 
  • "Failed to validate credentials for deployment. Authentication to remote host failed."
 

 

You have tested the SSH credentials via putty directly from Orion server to the Linux host you are trying to deploy the Orion Linux agent and they work just fine.

 

Please check the likely causes and resolutions section for fix/workaround.

Product section

Network Performance Monitor

Cause

Your target system may not have a supported Linux distribution. The Orion agent for Linux supports the following distributions:
 

  • Amazon Linux 2 / AMI, 64-bit
  • CentOS 6.x, 32-bit
  • CentOS 6.x, 7.x, 8.x, 64-bit
  • IBM AIX 7.x
  • Oracle Linux 6.x, 7.x, 8.x, 64-bit
  • Raspbian Jessie 8.0
  • Red Hat Enterprise Linux 5.11, 6.x, 32-bit
  • Red Hat Enterprise Linux 5.11, 6.x, 7.x, 8.x, 64-bit
  • SUSE Linux Enterprise Server 11.x - 15.x, 64-bit
  • SUSE Linux Enterprise Server 11.x, 32-bit
  • Ubuntu 14.x - 16.x, 32-bit
  • Ubuntu 14.x - 20.x, 64-bit

Resolution

  1. Check if your Linux distribution is supported. If it is not supported, you may need to upgrade the Linux distribution or install a supported Linux distribution.
  2. Ensure the SFTP service on the Linux server is enabled and the corresponding SFTP ports are open on the server in local and network firewall to receive traffic from Orion server otherwise you may see below error(s) depending on Linux distribution and SFTP server in use.
2017-11-20 11:04:26,040 [STP SmartThreadPool Thread #0] ERROR SolarWinds.AgentManagement.Jobs.LinuxRemoteInstallController - Unable to install Agent remotely to ieavu08 (). SolarWinds.AgentManagement.InstallerUtils.SshDeployment.SshRemoteClientException: SFTP Initialization failed : ChilkatLog:


Failed to receive FXP_VERSION

Failed.
--InitializeSftp
--ChilkatLog
at SolarWinds.AgentManagement.InstallerUtils.SshDeployment.SftpClient.IntializeSftp()

 

  1. If the distribution is supported but still getting authentication failed error, you should manually deploy the Orion agent for Linux . See your SAM/NPM administrator guide for instructions and check port and firewall requirements for Orion agent

 

For more detailed information of various deployment methods and configuration options possible refer to the Linux Agent Deployment Thwack post.