Remote Agent Troubleshooting (version < 2.2.1)
- Jonas Gonzalez
If you see an error on the Remote Agents page, the suggestions in this topic can help you determine how to address the problem.
Determine Whether the Remote Agent is Currently Running
Unix
Run this command:
systemctl | grep running | grep logichub-remote-agent
If the command doesn't generate any output, it means that the remote agent isn't running. To start the remote agent again, run this command:
./install_and_run.sh
Windows
Open Services.
Find Logichub Remote Agent.
Check whether the status is 'Running'.
If the agent isn't running, start it. Open Windows PowerShell, go to the folder where the remote agent was downloaded, and restart the agent using the following commands.
cd <download location>
./remote-agent --startup=auto install
./remote-agent start
Remote agent not set up to start on reboot
Unix
Run this command:
systemctl list-unit-files | grep enabled | grep logichub-remote-agent
If no output is generated, it means that the remote agent is not enabled.
To re-enable the agent run the following command. Include the --now if the remote agent service is not currently running.
systemctl enable --now logichub-remote-agent.service
Windows
Open Services.
Find Logichub Remote Agent.
Check whether the startup type is Automatic.
If the startup type isn't Automatic, open Windows PowerShell, go to the folder where the remote agent was downloaded, and set the startup option to
auto install.
cd <download location>
./remote-agent_latest --startup=auto install
If the agent isn't already started, run the following command.
./remote-agent_latest start
Remote Agent Isn't Able to Connect
Do the following for Unix and Windows,
Start a terminal or PowerShell session.
Go to the location where the remote agent is installed.
Use the following command to examine the logs for messages similar to 'Lost connection to LogicHub'.
tail -f logs/agent.log
If you see messages of this type, there could be an error on the LogicHub server, or a misconfiguration in agent.config. If you edited the agent.config file manually, try to revert the changes made and restart the agent. If that doesn't work, try downloading the latest version of the remote agent from the Settings > Remote Agents page.
If you still see connection errors, send a message to support@logichub.com. Attach the agent.config file and agent.log file. Include the version of the remote agent as shown on the Settings > Remote Agents page and any other relevant information.