Starting with version 2.6.0, Resilio Connect Agent allows opening a user-interface on local computer to monitor syncing activity. It's supported for Windows and OS X operating systems.
Enabling The User-Interface
To enable agent user-interface, agent config must have
"use_gui":true inserted. There's a special script to edit agent's config file.
This can be done:
- For already installed and running agents - via a Script job
- When performing Agent update - in combination with Update distribution job.
- For newly installed agents - manually when creating sync.conf for it. In the end config should look like this at minimum:
For new installation on Windows:
- put agent’s config beside msi and run the msi. On step select option to create shortcut for user-interface and add it to autostart.
- Agent will install and run as Windows Service. It will also create shortcut on desktop that will launch user-interface. Agent icon will also appear in tray.
- On Windows, The user-interface is just an additional feature to the Windows Service. It cannot run if the service not running. On the other hand, the service is not dependent on user-interface module. Even if you quit user-interface, Agent service will continue working and syncing files.
About The User-Interface Design
Agent user-interface is html based. It has two tabs: Folders and History. Folders tab lists the sync shares and shows their status. History is the list of events for this agent, it’s a good source to trace the syncing activity for the last 30 days..
Folders tab has the following columns:
Name of sync folder. Agent shows only Sync jobs folders. Click on the folder name opens the folder in file browser. Right-click on the folder name gives option to open its Archive. Shared with Selective Sync enabled don’t have background filling.
All these reflect status toward priority_peers if these are set in Job profile (Synced, Progress, Paused, Error, No peers, Connecting to peers)
total size of the share.
- Sending / Receiving
The current upload and download speed respectively. Clicking on it opens the list of file that are being uploaded or downloaded. Only 10 currently active files are shown in the queue.
Full path to the directory on the workstation.
- Local Size
The size of files present on this agent. For shares with Selective Sync enabled, it usually differs from total Size.
- Upload files / Download files
The number of files pending in upload/download queue. The list of files is to be viewed in Sending / Receiving columns.
- Files / Local Files
The count of files in the share, total vs present on the agent. For Selective Sync shares the count may differ even if status is ‘Synced’.
- Date added
Time when the job was created for this agent and appeared here.
- Date synced
The date when agent verified and confirmed that it’s synced up. Agent does it periodically every 10 minutes and upon restart. If status is ‘Synced’, it’s also duplicated at the bottom of user-interface and in tray icon menu.
- Last transferred
Date when file bits were actually transferred. Unlike “Date synced”, it only shows actual data transfer time. Thus it may be behind “Date Synced” if nothing has been actually transferred since then.
At the bottom of user-interface
There’s option to pause agent. To allow a user to pause agent, MC admin shall add custom parameter allow_pause_from_ui:true to Agent’s profile.
If user pauses agent in user-interface, pause tooltip says ‘Paused by user’. If agent is paused by Scheduled in MC, tooltip says “Paused by admin”. These two pauses interlap.
Center field shows either Last Synced time or a core error:
- Bind port busy
- No connection to tracker server
- No network connection
- No connection to Management Console
- Failed to connect to Management Console: invalid certificate fingerprint
Info shows current version of the Agent and status of connection to MC. There’s also checkbox to enable/disable system notifications.
Utilizing The User-Interface
- Empty if synced, if nothing to download/upload;
- Up/down arrows, if there is an active download process (for selective sync too) or active upload to specific host
- Red dot if there is error or agent disconnected from MC
- Paused if agent paused
- syncing: up/down speed and number of files up/down, ETA;
- synced: last synced time and files synced.
- error: status may be syncing or failed, error indicator (can we link it to error in user-interface?). Cannot connect to MC
- Low disk space (agent is running out of space on the drive where sync share’s located)
- Too Large File Detected (file size exceeds file system limitations, e.g. 4+GB on FAT32)
- File is locked (agent does not have access to the file right now)
- Excessive time difference (UTC time difference between agents is more than 600 seconds)
- Not enough permissions to access "file/folder" (the agent does not have read-write permissions to the mentioned file/folders)
- Service files are not correct or missed (the identifier file .sync/ID of the share was deleted or got corrupt)
- Wrong location or folder was deleted (the folder itself was deleted from the drive)
- Finished uploading files to "Server" (if priority peer is set in MC)
- File editing conflict (if notify_file_edit_conflict_time_diff is set in MC)
File Edit conflict
To enable notification add custom parameter notify_file_edit_conflict_time_diff with value to Agent profile. Value is in seconds and it’s the maximum difference between “date modified” of files for them to be considered conflicting. It works only if local file was updated and then on remote agent file was updated within that time. In other word: if userA updates local file, then userB updates file as well, file is moved to Archive on A’s computer and A is notified about this. Notification won’t appear if B just changes mtime of file (with ‘touch’ for example)