Starting with Resilio Connect version 2.12 users can choose the location for a job themselves.
For that, Management Console admin shall select path macro "Folder storage" and enable option "Ask user". It's available for Synchronisation, Distribution and Consolidation jobs. Supported in API.
The option is not available for Agents installed on a Linux OS or NAS, and also the Management Console Agent.
User, who operates the agent, will be notified and prompted to select the location for the job.
If the folder is not empty, files in the selected folder will be synced with other agents.
Until user chooses a directory, the agent reports "path not selected" status in the job run.
The chosen path will be reported in the job run in the Agent's details on Management Console. Also, it's visually distinguished from other shares in Agent UI on mouse hover.
User can change the selected path. Synced files will not be moved to the new location! The job will simply switch to the new directory and start syncing whatever is located there, download files from remote agent to the new directory. If the path is changed for destination in transfer job, agent will start downloading the files again from source, from count 0.
Files will remains in the initial folder location even though Profile parameter "Data retention" parameter in Agent profile might say to delete files. Also, files will remain in Archive directory.
Disconnecting the folder
Option to "Disconnect" the folder is not equal to removing agent from the job. The agent remains in the job, but will stop syncing until the new path is selected. Thus parameter "Data retention" from Agent Profile does not apply here.
If user disconnects the folder, data remains on disk even though data retention policy says to delete the files.
Admin can 'disconnect' the folder remotely in one case only - if the option to "Ask user" was enabled later for an already created and saved job. The folder will disconnect from the agent (Synchronization job) and user will be asked to choose path on next job run for Distribution and Consolidation jobs.
The user's chosen directory will be preserved and re-used if:
- admin removes the agent from job and later adds it back to the same job;
- admin restarts job run on the agent. New job run will be created for Distribution/Consolidation job.