Troubleshooting Files.com Agent Issues
Most of the time, Files.com Agent connection issues are caused by one of the following things:
- Firewalls or other restrictions on the remote server that require a connection from Files.com to be allowed
- Incorrect configuration of the Agent
- System that the Agent is installed on is offline or powered off
Check the network firewall configuration at the site hosting the Agent and that all firewall configuration steps described in this article have been followed correctly.
Check that the Agent's configuration file has no typos or syntax errors. The file must contain valid JSON syntax, where all values are enclosed in double-quotes.
The most common JSON syntax error is using Windows slashes instead of Linux slashes in folder paths. When setting the root value, use Linux slashes (preferred:
C:/path/to/folder) or use double Windows slashes (valid "escaped" alternative:
Ensure that the system that the Agent is installed on is powered on and online. When the system is down or offline then you may see the following effects:
If the system, and Agent, cannot be reached then any Remote Sync will fail until the Agent is accessible again. Once the Agent is accessible again, subsequent syncs will then resume and succeed.
Always run the Agent manually first, to check functionality and connectivity, prior to installing it as a system service. If the Agent works when run manually, but does not when run as a system service, then compare the permissions between the account that was used to manually run the agent and system service account.
Check the Agent status, as shown in the Remote Server entry for your Agent. When the Agent sends a heartbeat back to Files.com then this status will change from "Waiting for connection..." to "Connected." The "Connected" status confirms that the Agent has been able to "call home" but does not confirm that Files.com will be able to connect back to the Agent through your firewall. Make sure that your firewall has been configured to allow connections to the Agent from Files.com.
When the Agent is shut down normally, such as by using CTRL+C when running the Agent manually or by shutting down or rebooting the system when the Agent is running as a system Service, the Agent status will change back to "Waiting for connection...". However, if the Agent is terminated due to a system crash or outage then the Agent status will remain as "Connected." as the Agent was terminated before it could "call home" and update its status.
Get Instant Access to Files.com
The button below will take you to our Free Trial signup page. Click on the white "Start My Free Trial" button, then fill out the short form on the next page. Your account will be activated instantly. You can dive in and start yourself or let us help. The choice is yours.Start My Free Trial