Common questions
Do I need separate agents for different on-premise applications in the same machine?
No. You just need one agent to connect any number of on-premise applications on a single machine.
What happens if my system crashes and is recovered later? Will it affect my flows?
If you're able to recover your system after the crash, and the agent's files are intact in your system, you can start the agent again. If you're unable to recover your system, you must unregister the agent from Settings > Agents > View Details which will permanently disconnect the agent. After unregistering, reinstall the agent using the Installation Key available in Settings > Agents > View Details. You won't have to reconfigure existing flows if you have successfully reinstalled the agent.
I deleted my agent from Zoho Flow's settings page. Can I undo this?
No. You will need to create a new agent, then install it on your machine with the newly generated installation key.
Do I need to start the agent manually after system reboot?
Yes.
In Windows:
In Windows, you can start the agent by executing startagent.bat script available in the directory you've installed the agent ({installed location}\FlowAgent\bin) using the command prompt.
In Mac and Linux:
In Mac and Linux, you can start the agent by executing startagent.sh script available in the directory you've installed the agent ({installed location}/FlowAgent/bin) using terminal and run sh startagent.sh
Can I link multiple agents to the same Zoho account and the same machine?
Yes. You can link multiple agents to the same Zoho account, but different agents should be in different machines.
How do I manage all the agents I have created?
You can manage your agents by navigating to Settings > Agents.
Here you can perform actions such as rename, update, delete, enable/disable, and ping.
Why is my agent's status shown as inactive?
Your agent's status will be shown as in-active when it is unable to connect to Zoho Flow's servers. You can try the following steps to troubleshoot:
- Check your internet connectivity.
- Check whether the server or machine where the agent is installed is running properly.
- Restart the agent on your machine and try pinging it from agent settings.
- If none of these solves the issue, please contact Zoho Flow support.
Can I modify the proxy settings I've configured during the installation at a later time?
Yes. You'll need to navigate to the directory you've installed the agent and open the file named agent.properties (<installed location>/conf/agent/agent.properties). You can then modify the values in this file. Once you've configured your new proxy settings, restart the agent.
How do I prevent the agent from becoming inactive after I close the terminal in Linux /MAC?
You can overcome this by using nohup to start the agent as shown below. This prevents the agent from getting killed after closing the terminal.
nohup sh startagent.sh
How do I uninstall the agent and remove its files completely from my machine?
You can delete the files from the directory you've installed the agent, and the agent will be fully removed. The agent installation doesn't create any entries in the registry or leave leftover files in your system.
How do I solve the "The installation key is corrupted" error?
This error message means you might have entered the key incorrectly. You need to return to Zoho Flow, then copy the installation from the agent configuration window.
Next, you'll need to navigate to the directory on your machine where you've installed the agent, and open the file named install.txt from <installed location>/FlowAgent/conf/agent/. You can then enter the correct installation key against the AUTHTOKEN field in this file.
Why do I get the error 'SSL Exception occurred' while trying to connect an On-Prem app with Zoho Flow?
In Zoho Flow, importing an SSL certificate into the flow agent is necessary to establish a secure connection between Zoho Flow and the On-Prem app. Failing to do so will result in the following error:
Steps to import the SSL certificate:
Navigate to your On-Prem app's home page and click the View site information icon on the left side of the browser's address bar.
Click Connection is secure, then click the Show certificate icon.
In the certificate details page that appears, navigate to the Details tab.
Click the Export button at the bottom-right corner and save the certificate.
User Certificates
Starting from version 1.0.16, you can add the custom SSL certificates directly to the agent without using command-line tools. This simplifies connecting securely to external services.
For version 1.0.16 and later, follow the steps below to connect to your service.
- Navigate to <FLOW_AGENT_HOME>/user/certificates.
- Add your certificate files into this folder.
Note: Supported Certificate Formats The following file types are supported: .cert, .crt, .pem, .pfx, .p12, .cer
For users upgrading from earlier versions:
If you've previously added certificates using the KEYTOOL command:
- Your existing certificates will be migrated automatically.
- A file named: migratedCertificates.crt will be generated inside <FLOW_AGENT_HOME>/user/certificates and no additional action is required unless you want to add new certificates.
7. After restarting the agent, try connecting the On-Prem app with Zoho Flow.