This article will provide step-by-step instructions on how to set up a mass deployment of the Desktop Sync Application for Mac (version 8.1+) using Munki. These instructions can be adapted to satisfy internal IT standards within an organization.
- You must have a working Munki server and properly configured clients
- This will only work for deployments of version 8.1 or higher of our Desktop Sync app
Note: If you have never used Munki before, we recommend testing various types of .app and .pkg installations to familiarize yourself with the general deployment process. You can learn more on the project’s website: https://github.com/munki/munki/
Download Desktop Sync for Mac
Import the Installer Package into Munki
You must have the Munki Tools package installed on your machine to complete the steps in this section. The default settings gathered by the munkiimport utility will work without modification for Desktop Sync versions 8.1+.
You may customize the default settings at your discretion; however, we recommend using a consistent name when importing packages so Munki can properly identify updates to our client. If you are new to Munki, we recommend using the ‘testing’ catalog so you can test the deployment in a lab before pushing it out to all clients. For simplicity, examples in this guide will use the testing catalog.
To import the Desktop Sync Installer, run:
Customize Desktop Sync Installation
You'll need to edit the XML configuration information for the Desktop Sync package if you want to customize default settings and properly handle installation / removal of the package. On the Munki server, look in the pkgsinfo folder and open the configuration file for the Desktop Sync package (it is a .plist file if you used the default settings when importing the installer).
Installation Settings — Customizing Defaults
Upon first launch, the Desktop Sync application looks for an egnyteconfig.ini file located in /Library/Preferences or /Users/username/Library/Preferences to initialize custom defaults. The following parameters can be optionally configured in the configuration file. If you do not use a parameter, the application will use the default setting from the regular installation.
- local_root: Set the local path where you want the files to sync. (e.g. ~/Documents/Egnyte Company A)
- domain: Set the domain for the Desktop Sync clients. (e.g. enter acmeinc for acmeinc.egnyte.com)
- use_sso: If the domain parameter is set and use_sso is set to 1, users are automatically prompted to log in with SSO to the domain.
- remote_folders: Set the default set of folders to sync (e.g. /Shared or /Shared/Documents/aaa_gen)
- sync_type: Options are off, realtime, polling, period.
- poll_time: Number of seconds between polling synchronizations (e.g. 900 for 15 min). Note: We recommend using the intervals shown in the GUI on http://127.0.0.1:8806/do_sync_preferences under “Sync every.” While other sync intervals should work without a problem, they will not display properly in the UI dropdown.
- sync_all_local_folders: Boolean value. Default is false if this field is omitted.
- sync_special_char_filename: Boolean value. Default is false if this field is omitted.
Here's an example of the contents of the egnyteconfig.ini file to be placed at /Library/Preferences/egnyteconfig.ini or /Users/username/Library/Preferences/egnyteconfig.ini prior to Desktop Sync for Mac running for the first time:
Here's an example of a shell script to use as part of the Munki configuration to generate the egnyteconfig.ini file (notice the shell script that writes to the egnyteconfig.ini file):
echo "[config.db]" > /Library/Preferences/egnyteconfig.ini
echo "local_root=~/Documents/Egnyte " >> /Library/Preferences/egnyteconfig.ini
echo "domain=acmeinc" >> /Library/Preferences/egnyteconfig.ini
echo "remote_folders=/Shared,/Private" >> /Library/Preferences/egnyteconfig.ini
echo "sync_type=realtime" >> /Library/Preferences/egnyteconfig.ini
echo "sync_all_local_folders=true" >> /Library/Preferences/egnyteconfig.ini
echo "sync_special_char_filename=true" >> /Library/Preferences/egnyteconfig.ini
Remember, if you want to test this now, make sure to save your changes and rebuild your catalogs using the makecatalogs utility.
Upgrading to a New Version
As usual with Munki, you should import the new version of the Desktop Sync installer. The import utility should recognize the package and use the old installer as a template. If this is not working, make sure you are using the same name for the package as used before and ensure that the version numbers from the previous and updated installers are correct.
cp /Applications/Egnyte\ Desktop\ Sync.app/Contents/Resources/uninstall_elc.sh ~
chmod +x ~/uninstall_elc.sh<
Setting up Unattended Installation, Upgrades, and Uninstallation
Make sure your pkgsinfo file for Desktop Sync include the following keys and settings.
Disable Upgrade Notification
Administrators may choose to disable Upgrade Notification so users won’t be notified when newer versions of the Desktop Sync Software have been provided for General Availability.
- Log into Egnyte Cloud as an Administrator
- Click on the Gear icon and select Settings
- Select configuration on the left hand side
- Look for Sync
End User Configuration
Once installed, the end user will need to launch the Egnyte Desktop Sync App from the Applications folder to run it for the first time. They will be prompted to enter their username and password at this step.
You may want to share the training videos provided here with your end users. Under Storage & Sync, they can play the Desktop Sync training video.