Workato · On-prem agent
SFTP UnknownHostException through the on-prem agent
Short answer
This error means the Hostname field of the Workato SFTP connection contains extra whitespace, so the on-prem agent cannot resolve the host. Remove the extra spaces from the Hostname and reconnect.
VerifiedLast verified
01Error text
Error processing SFTP request java.lang.RuntimeException: com.jcraft.jsch.JSchException: java.net.UnknownHostException: XX.XX.XX.XX02Likely causes
- There is extra whitespace in the Hostname field of the Workato connection.
- The agent log shows more than one space between the colon and the IP address. SFTP works from the command line on the same machine.
- The agent log can also show
"status":401with"status_message":"Unauthorized".
03How to fix it
- Open the SFTP connection in Workato.
- Remove any leading, trailing or extra whitespace from the Hostname field.
- Reconnect and rerun the job.
04Official documentation
→Related errors
- SFTP error 2 : no such file"SFTP error 2 : no such file" on the New/updated file in directory trigger means the file was gone or unreadable when Workato tried to download it. Keep files in the monitored directory until they are downloaded and make sure uploads are complete.
- No profile found (Kafka on-prem)"No profile found" means the on-prem agent cannot locate the Kafka profile named in the connection when the job runs. It is usually a config.yml mismatch, so check the kafka block, the profile name and the indentation.
- AgentNonRecoverableException: Error connecting to the gatewayThis on-prem agent error means the agent cannot complete a trusted HTTPS connection to the Workato gateway. The usual cause is SSL inspection, a proxy or a firewall intercepting the connection, so create an exception for the Workato gateways or configure the proxy in config.yml.
Test every fix in a non-production environment before you apply it to production. See how entries are verified.
More for Workato work:Open Workato jobsWorkato rates and salariesHire a senior Workato developer