Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel6
outlinefalse
typeflat
printablefalse

Installing the Remote Agent (version >= 2.2.1)

You can download and install the remote agent on a Unix or Windows system.

...

  1. On the Settings > Advanced Settings page, click the Unix or Windows button for the remote agent. A zip file containing the remote agent software is downloaded to your local system.
  2. Unzip the file to a convenient location.

Unix

Follow the steps to install and upgrade the remote agent for Unix.

Install and Run the Agent

  1. Navigate to the directory on the Unix system that contains the unzipped remote agent package.
  2. Run the following script as root. The script sets up the remote agent as a Unix service and starts it.

sudo bash install_and_run.sh

Windows

Follow the steps to install and upgrade the remote agent for Windows.

Install and Run the Agent

  1. Navigate to the Windows folder that contains the unzipped remote agent package.
  2. Open a command window and run the following commands. The first command installs the remote agent as a Windows service, and the second starts the remote agent.

...

You can manage the remote agent as you would for any other Unix or Windows service. By default, the agent restarts automatically when the system reboots.

Verifying the Installation

After executing above step please check for the following

...

Code Block
2. The `agent.log` file should have these lines


``` {text}2022-07-19 09:47:03.878 INFO agent_win_service.py:SvcDoRun:42 [Dummy-3] - Started Logichub Remote Agent.
2022-07-19 09:47:03.878 INFO StatisticsLogger.py:start_statistics:24 [Thread-2] - scpu: 0.0, smem: 84.68997572926685, cpu: 0.0, mem: 1.947382882264047
2022-07-19 09:47:03.878 INFO socks_server.py:__init__:14 [Thread-1] - Listening to socks5 proxy on 127.0.0.1:9011
2022-07-19 09:47:03.878 INFO lh_client.py:start_websocket:64 [Thread-1] - Attempting to connect to wss://logichub-server:logichub-port/agent/connect with id: RANDOM-ID ...
2022-07-19 09:47:03.878 INFO lh_client.py:listen:107 [Thread-1] - Other event: connecting
2022-07-19 09:47:03.908 INFO lh_client.py:listen:107 [Thread-1] - Other event: connected
2022-07-19 09:47:03.924 INFO lh_client.py:listen:88 [Thread-1] - Connected to Logic hub
2022-07-19 09:47:03.924 INFO stoppable_thread.py:start:29 [Thread-1] - Starting heartbeat stoppable thread
2022-07-19 09:47:03.939 INFO lh_client.py:listen:107 [Thread-1] - Other event: poll
2022-07-19 09:47:03.939 INFO lh_client.py:listen:107 [Thread-1] - Other event: pong
2022-07-19 09:47:08.940 INFO lh_client.py:listen:107 [Thread-1] - Other event: poll
2022-07-19 09:47:08.940 INFO lh_client.py:listen:107 [Thread-1] - Other event: pong
2022-07-19 09:47:13.940 INFO lh_client.py:listen:107 [Thread-1] - Other event: poll

Configuration

  1. SUPERVISOR_FREQUENCY_IN_SECONDS

...

  1. On the Settings > Advanced Settings > Remote Agents page, click the Unix or Windows button for the remote agent. A zip file containing the remote agent software is downloaded to your local system.
  2. Unzip the file to a convenient location.

Unix

Follow the steps to install and upgrade the remote agent for Unix.

Install and Run the Agent

  1. Navigate to the directory on the Unix system that contains the unzipped remote agent package.
  2. Run the following script as root. The script sets up the remote agent as a Unix service and starts it.

sudo bash install_and_run.sh

Windows

Follow the steps to install and upgrade the remote agent for Windows.

Install and Run the Agent

  1. Navigate to the Windows folder that contains the unzipped remote agent package.
  2. Open a command window and run the following commands. The first command installs the remote agent as a Windows service, and the second starts the remote agent.

...

You can manage the remote agent as you would for any other Unix or Windows service. By default, the agent restarts automatically when the system reboots.

Upgrade Remote Agent

  1. Go to Settings > Advanced Settings > Remote Agents
  2. Download the latest remote agent (compatible with the milestone release) for your operating system.
  3. Keep the logs and agent.config file of the previous remote agent in case you need it.
  4. Remove the old remove agent directory and follow the remote agent installation guidelines.

...