Articles in this section

Updating your Agents using Distribution Job

Having a lot of agents in your environment you can use Connect's Distribution job to update them. Follow the steps:

  • Ensure that your target OSes meet the prerequisites (specific for each OS, see below)
  • Create Distribution job.
  • Source path should contain at least 2 files for each OS you plan to update: a script and a binary. See particular OS below, files section.
  • Ensure to enable one of triggers "Run script when agent completes download" or "Run script when all agents complete download".
  • Get the OS-specific command and put it into relevant OS script box.
  • Ensure that job only runs manually
  • Run the job once ready.

Test your update

It is strongly recommended to test your update on a small group of computers first

 

Prerequisites

Ensure your Agents on windows run as "SYSTEM" or user account with admin privileges. If they run under "Local Service" account, automatic update is not possible due to security subsystem limitations.

Files

These files must be delivered to your Windows destination (download here scripts and xml. Binaries should be downloaded from Resilio Connect download site):

Resilio-Connect-Agent_x64.exe
Resilio Connect-Agent.exe
verify_upgrade.ps1
agent_upgrade.ps1
ResilioUpgrade.xml

Job Path

Set the job destination path to "C:\ResilioUpgrade"

Update path

In case you'd like to use some other path for destination agent make sure you change it in the bottom of ResilioUpgrade.xml too.

Command

Only x64 system is used

Add -NoX86exeCheck as parameter of verify_upgrade.ps1 in job's trigger to skip x86 exe check

Use this command in the "Windows" section of the "After agent completes downloading" trigger):

powershell.exe -NoProfile -ExecutionPolicy Bypass -File verify_upgrade.ps1 > verify.log 2>&1

set ERR=%ERRORLEVEL%

if %ERR%==1 (
echo No need to upgrade, same version detected
type verify.log
exit /b 0
)

if %ERR% GEQ 2 (
type verify.log
exit /b %ERR%
)

echo %APPDATA%\Resilio Connect Agent Service>oldstorage.path
schtasks /create /TN ResilioUpgrade /XML ResilioUpgrade.xml /F
schtasks /run /tn ResilioUpgrade

Output

Agent will be updated and reconnect to Console. Fetch the script logs from job details dialog to see if anything went wrong.

As Agent runs under rslagent or local user account, update cannot be triggered by Agent itself due to Linux security model.

Use your Linux packet manager to update your packages. When installed via Resilio official repository Agent will update automatically only to latest minor version with next system update. If you are ready to update your Resilio Agent for Linux to latest major version, please add new major version repository as mentions in this instruction.

Remote updating of NAS is not possible. For NAS devices use new NAS packages to update Agents.

Prerequisites

Resilio Connect Agent app must be installed in system's global "/Applications" folder. Please ensure that user with admin privileges logged in during the update. The script will prompt for admin password during update to actually replace application bundles.

Files

These files must be delivered to your OS X destination:

Command

Use this commands in "OS X" section of the "After agent completes downloading" trigger to load and execute the "agent_update_mac" script

chmod +x agent_update_mac
nohup ./agent_update_mac &

Output

The script will show system notifications once starting update and once done. Also, script will ask for admin password, so minor user interaction required. Output log file "update-<date>.log" will spawn in each Agent's storage folder. Use it to debug any issues that arise during update.

Related articles