Generally Resilio Agents have a few ways to discover new or updated files:
- Receive a notification from the file system
- Perform periodic full folder rescans (by default on pre-2.8 versions, it's done every 10 minutes, on 2.8 version - every 24 hours)
- Perform periodic smart hot folder scan (by default every hour; available from 4.1.0)
Sometimes System Notifications don't work and a periodic scan is either scheduled for a lot later or takes a long time on a big data set. That scenario is not ideal, when there're some new or updated files that need to be synced as soon as possible. To avoid this problem, starting with version 2.8 Agents can be told to forcibly rescan specified subdirectory or the whole sync share and find new files right now.
It works for Synchronization, File Caching, Hybrid work jobs.
Go to a Sync Job Run -> Agents -> select the Agent -> Activity.
This page gives two Options:
- RESCAN. This will force an Agent to scan the whole job folder again. Basically it's the same as a scheduled periodic scan, the main difference is that it can be manually started at any moment the Administrator needs it.
- RESCAN SUBFOLDER. A folder picker will open and the Administrator will be able to select a certain subdirectory. Agent will only scan this subdirectory with the Agent's highest internal scan priority.
The table shows two types of forced folder scan - forced full scan and forced subfolder scan respectively - and their statuses.
Any of these can be started an any time, even several times in row if necessary. These instructions will be queued and performed by the Agent one-by-one. Mind the following important notes in this regard:
Manual rescan effect
The forcibly rescanned files are queued for transfer in the common internal Agent's queue, i.e they are not forcibly synced!The "Files found" and "Folders found" counters includes all the processed files and folders, including empty files, Ignored files, symbolic links. It can differ from the files count on a job run itself.
If force full scan is started while another full scan (either forced or scheduled) is running, the latter will be aborted. The next scheduled periodic scan will shift in time and start after the configured period (24 hours by default).
If a force full scan is started while a subfolder scan is running, it will wait until the subfolder scan is complete.
If a subfolder scan is launched while a full scan (either forced or scheduled) is running, the latter is suspended. It will resume after the subfolder scan is complete. The next scheduled periodic scan will shift in time accordingly.
| If it's started.... | |||
| Forced full scan | Scheduled full scan | Forces subfolder scan | |
| ...while this runs | |||
| Forced full scan | aborts | waits for completion runs per rescan interval | aborts |
| Scheduled full scan | aborts | runs per rescan interval | aborts and starts right away |
| Forces subfolder scan | waits till it's complete | waits for completion runs per rescan interval | waits till it's complete |
Restart of the Agent interrupts all the running scans.