Skip to content

Changing parameters in Profiles that require an action

Starting with Resilio Management Console v3.0.0, Resilio Admin is notified that a change in a Profile parameter might require restarting the Agent or recreating a job for the change to take effect.

There are not that many of such parameters, however, the Administrator needs to know a required action when making the change. profiles1.png

profiles2.png

The profile mentions which exactly action is required, but does it only once - if the profile is closed and opened again, the 'Acton required" column will be empty.
If the parameter is changed forth and back to what is was before, without saving the Profile in between, no action will be required for it.

Warning

Deleting a custom parameter from profile might also require an action, even though profile won't be able to show this.

Restarting the Agent

It's one of the two actions required. Additionally to it being mentioned in the Profile itself, the Agents that need to be restarted will also show status "Restart required" in the table of agents.

Warning

  • While the Restart required status is active, the Agent won't display the Error status. To see the Agent's errors, open the Agent's details.
  • Restarting an Agent may take a while especially if the Agent has jobs large volume of files.

restartrequired.png

To restart the Agent open its details, go to tab "Configure" and restart from there. See here for more details.

Recreating the job

Certain parameters can be applied only for newly created jobs, i.e. changing them for already running job does not take effect. See the list of such parameters below. Recreating a job implies deleting it from the Management Console and creating again.

Warning

It's highly advisable to recreate the job. If left as is, further behavior will be undefined and may break the job. Restarting an Agent in such a job run (for this one of these settings is changed, but job itself is not reconfigured anew) shall be avoided.

To learn which jobs need to be recreated, click on the list of jobs that use this Profile

jobprofile.png

Warning

Resilio administrator won't be notified about an active job requiring to be recreated if the job's profile was changed while the job was being edited.

If such a change was made to an Agent profile, click on the list of groups that use this profile. Open the mentioned groups' details to see the jobs they are in:
agentprofile.png

With default Agent profile it's more tricky. The only way to check if the Default Agent profile is used for a job is to check the groups list for column Profile.
groups.png

Parameters that require recreating a job include but are not limited to:

Ignore symlinks (ignore_symlinks)
Number of disk I/O threads (disk_worker_pool_size)
Max size of torrent block (torrent_max_piece_size)
Min size of torrent block (torrent_min_piece_size)
Synchronize extended file attributes (sync_extended_attributes)
Synchronize Posix permissions (posix_fs_acl_mode)
Synchronize NTFS permissions (windows_fs_acl_mode)