# Installing agents

Installing and starting an agent is a simple task! Just follow the next guidelines.

# Agents controller

You can easily control the installation of your agents via our Agents Controller. This resource was designed for handling all agent process from a single instance. For more details about this resource plase visit the Agents Controller Documentation.

# Binaries

For installing an agent via binary files follow these steps:

  1. Download the respective agent binary from the link below.

Download

You can download the agents binaries from our ELCO Download Server (opens new window).

  1. Decompress the downloaded file.

Note

For the following steps. Please, remember to replace agent with the corect agent's binary! (for instance, in Windows, agents have a .exe extension).

  1. Go to your terminal and navigate to the folder where you have decompressed the agent.
cd Downloads/agent/
  1. Confirm that you downloaded the correct binary for your system by executing the following command.
./agent --version

The output should contain information about the agent's version, target operating system, architecture, among other information. If an error occurred while executing the previous command, then the downloaded agent might be incompatible with your system environment. Just double check that you downloaded the correct agent binary.

# Docker images

You can also execute the agents by using Docker (opens new window). For this, you need to first pull the respective agent's Docker image which will allow you to execute the agent in a Docker container as follows:

Note

In the commands below, you can replace agent by the respective techonology name, version by the exact version you want to pull, and arch for arm or amd depending on your system architecture. You can find the respective technology names and versions in each menu of the sidebar.

docker pull registry.elco-automation.de/agents/agent:version-arch

In the command above, you can replace agent by the respective techonology name and arch for arm or amd depending on your system architecture.

To confirm that you downloaded the correct Docker image for your system, you can execute:

docker run --rm registry.elco-automation.de/agents/agent:version-arch --version

As described above, the output should contain information about the agent's version, target operating system, architecture, among other information. If an error occurred while executing the previous command, then the downloaded Docker image might be incompatible with your system environment. Just double check that you pull the correct Docker image.

Last Updated: 12/9/2021, 2:10:21 PM