Jitterbit · Private agents
Agent Not Running or Unreachable
Short answer
This Jitterbit Studio message means the private agent services are not running or the agent host cannot reach the Harmony cloud. If the services are not running, start them. If a start fails, check the agent logs.
VerifiedLast verified
01Error text
Agent Not Running or Unreachable02Likely causes
- The Jitterbit services are not running.
- The services run but the agent host cannot reach the Harmony cloud.
- A corporate proxy blocks the agent's connection.
- The agent's connection or process is interrupted between heartbeats.
03How to fix it
- If the services are not running, start them. If a start fails, check the agent logs.
- If the services run but cannot reach Harmony, verify internet connectivity, check
jitterbit-agent.logfor cloud connectivity errors, and confirm the agent can reach Harmony on port 443. - If the agent uses a corporate proxy, verify the proxy configuration.
- If the agent flips between states, try reducing
agent.heart.beat.intervaland check for OutOfMemoryError or crash files.
04Official documentation
→Related errors
- Agent is incapable to process this messageThis Jitterbit ProcessEngine.log message means the agent has no free capacity, because every worker thread is in use or a capability metric reached its threshold. Review ProcessEngine.log for repeated capability status changes.
- Failed to find file in the local file storeThis Jitterbit transformation error means deployment metadata for a file did not fully sync from Harmony to the agent, which is usually transient. Re-run the operation. On agent 11.38 and later the metadata is restored on the next environment sync.
- Error 1720 or 1722 on Windows installationError 1720 or 1722 when installing the Jitterbit private agent on Windows usually comes from the bundled PostgreSQL, a missing Visual C++ Redistributable or leftovers from a previous agent. Install the 64-bit Microsoft Visual C++ Redistributable before the agent, and keep it installed.
Test every fix in a non-production environment before you apply it to production. See how entries are verified.
More for Jitterbit work:Open Jitterbit jobsJitterbit rates and salaries