Management Console's Agent

Overview

Resilio Connect v 2.x automatically installs another Agent on the same computer where Management Console runs. This agent appears in the list of agents on the corresponding tab and is named Management Console Desktop, where "Desktop" - is computer's name as per system settings.

Common Use cases

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

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

Updating Management Console Agent 

Management Agent also automatically updates its agent config. On each restart Management Console check this agent's config. If it has changed, new one is generated. So even if Console's parameters change (bootstrap token, for example), the config is regenerated and Management Server will be reconnected silently. If you want to add some custom changes to Console's agent, edit file sync.conf.template instead.

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".