Articles in this section

Creating Resilio Connect Agent package with the configuration file included

Overview

The Agent installation to endpoint computer implies bringing at least 2 files: the installer or archive and the configuration file sync.conf which contains information to connect to your Management Console.

Sometimes it is preferable to package sync.conf inside the installer to get a single-file-installer which does not require any extra actions, in cases like:

  • The installation process is done by a novice user and not supervised by the Administrator
  • The administrator has several configuration files for different groups of users \ locations
  • For centrally managed deployment systems where Applications are installed without any user interaction. 

Important Note

The resulting .pkg or .msi files are unsigned. If your installation policy requires files to be signed, you'll have to sign them with your own digital certificate. 

 

Step 1

Download the script from the Resilio, Inc. public Git repository. The packaging script requires Powershell v5.0 or newer to run.

Step 2

Download the Resilio Connect Agent MSI installers from Connect download site and your sync.conf from your Management Console. Running the script depends on the shell you use:

  • If you run the script from Powershell:
    Set-ExecutionPolicy -ExecutionPolicy Bypass -Force
    attach-sync-conf-to-msi.ps1 -MSIPath <path_to_msi> -SyncConfPath <path_to_config>
  • If you run the script from the command prompt:
    powershell.exe -ExecutionPolicy Bypass -Noprofile attach-sync-conf-to-msi.ps1 -MSIPath <path_to_msi> -SyncConfPath <path_to_config>

Result

The script will exit and rename the MSI to <MSI_Name>_configured.msi. If you plan to install Resilio Connect Agents on computers with different architectures (x86 and x64), you need to run the script separately for each MSI installer.

Step 1

Downloads the script from the Resilio, Inc. public Git repository. The packaging shell script requires the pkgbuild tool to be installed (bundled with XCode tool and is often is preinstalled on your Mac). The downloaded package has a readme file with the below instructions as well. 

Step 2

Download the Resilio Connect Agent for Macs from our download page and also the sync.conf file from your Resilio Connect Management Console. You need to create a folder that has the following set of files in it (in the screenshot below we created one called script):

  • make_package.sh  (downloaded in step 1)
  • scripts (the folder containing deployment scripts, downloaded in step 1)
  • Resilio-Connect-Agent.dmg (use the version you want to deploy)
  • sync.conf (download from your management console)

Example: Screen_Shot_2021-02-11_at_4.19.21_PM.png

 

Step 3

Open Terminal and navigate to the folder containing make_package.sh. Run commands:

chmod +x make_package.sh
./make_package.sh

Result

The script will create a Resilio-Connect-Agent.pkg file in the same directory. This package uses standard OS X installation dialog and registers Agent as LaunchAgent which starts as soon as the user logs in to their OS X.

Important for MDM deployments

If you plan to centrally deploy Resilio Connect Agents 2.11 or higher via an MDM, you should also whitelist the Resilio Connect Kernel Extension. This article helps to explain how. 

 

Related articles