Connect an agent controller to the IoTHub

The agent controller is a program running at an edge node, where agents should be running. It allows to install, start, stop and observe agents at this node from the IoTHub.

Step-by-step guide

1. Navigate to the agents page

Agents page

2. Open the main menu and click Add Agent Controller

Add Controller

3. Copy the token with the icon or make a note of it to transfer it to the edge node, where the agent controller will be started

Copy Token

4. Download the latest agent controller for the target system

System
Linux x86
Linux amd64
Linux arm
Linux arm64
Windows x86
Windows amd64
Darwin

5. Unpack the file into the wished folder and start it for the first time with:

agents-controller --agency ${url} --name ${name} --token ${token}

• url: URL to the IoTHub with the agency port
• name: Name of the controller instance, should be unique in the domain
• token: The token from step 3.

TIP

At linux system it is possible, that super user rights are needed. So start the call with sudo ./agents-controller.

6. After successfully connected for the first time, the agent controller can be started without the token parameter