Remote Agent Troubleshooting (version < 2.2.1)

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

1. Open Services.
2. Find Logichub Remote Agent.
3. Check whether the status is 'Running'.
4. 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

1. Open Services.
2. Find Logichub Remote Agent.
3. Check whether the startup type is Automatic.
4. 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,

1. Start a terminal or PowerShell session.
2. Go to the location where the remote agent is installed.
3. 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 [email protected]. 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.