Skip to content

Management Console's Agent

Overview

Resilio Active Everywhere allows installing and running an Agent instance along the Management Console to ease the deployment of the Resilio Platform.

Info

In Resilio 4.2 and newer, the Agent installation is optional. In older versions, the Agent installs automatically.

This Agent instance appears on the list of Agents on the corresponding tab and it's named Management Console %name%, where %name% - is the hostname as configured in system settings.

Screen_Shot_2020-04-06_at_14.37.35.png

Common Use cases

This Agent was implemented to ease Resilio deployment. In most cases admins need to have an Agent on the same computer where they configure the Management Console, and they have to install it and connect it to the Management Console manually. So the Management Console Agent's initial goal is to do this task automatically: it gets installed and connects without any extra work by admin.

Info

The Management Console Agent starts and stops together with the Management Console process.

Once it's running, it acts equally with all other agents and can participate in all of the jobs. It follows the path macros and stores the files there on the local computer.

Updating Management Console Agent

The Management Console Agent also automatically updates its Agent configuration. On each restart, the Management Console checks its Agent's configuration. If it has changed, a new one is generated. So even if the Management Console's parameters change (for example, the bootstrap token), the configuration is regenerated and the Management Console Agent will be reconnected seamlessly. If you want to customize your Management Console Agent, edit the sync.conf.template file in the Storage Folder.

The Agent does not register itself as service on Windows. On Linux it runs as rslagent process with the same user as Management Console.

How to rename The Management Console Agent?

Find sync.conf.template file, then add "device_name":"ABC", parameter. This agent's config is a json, syntax must be preserved. Config file is located here:

  • Windows
    C:\ProgramData\Resilio\Connect Server\sync.conf.template

  • Linux
    {resilio-connect-server}/var/sync.conf.template

How to Stop The Management Console Agent?

It is set up to restart automatically on fail. So even if the process is stopped, it will be relaunched.
You can completely remove this agent from your setup though. For that you need to:

  1. Stop Management Console.

  2. Delete agent's config:

    • Windows
      C:\ProgramData\Resilio\Connect Server\sync.conf
      Linux
      {resilio-connect-server}/var/sync.conf

  3. Delete its storage (settings):

    • Windows
      C:\ProgramData\Resilio\Connect Server\agent
      Linux
      {resilio-connect-server}/agent/.agent/

  4. Remove executable binary from its location:

    • Windows
      C:\Program Files\Resilio Connect Server\agent\Resilio Connect Agent.exe
      Linux
      {resilio-connect-server}/agent/rslagent

  5. Start Management Console. After that the Agent will show up as "Not Connected " in Console. Select it and click "Remove ".