Egnyte Help Desk

Mac Egnyte Drive Mass deploy and configure with Munki

Overview

This guide will provide step-by-step instructions on how to setup a mass deployment Egnyte Drive for Mac (version 1.5 or higher) using Munki.  The instructions provided assume you have a working Munki server and properly configured clients.  These instructions can be adapted to satisfy internal IT standards within an organization.
 

Getting Started with Munki

If you have never used Munki before, we recommend testing the deployment of 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 Egnyte Drive for Mac

 

Download Egnyte Drive Package Installer

 

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 have been tested and should work without modification for Egnyte Drive 1.6 for Mac.  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:
/path/to/munkitools/munkiimport /path/to/EgnyteDrive_1.6.0_170285.pkg

 

Customize Egnyte Drive Installation

You will need to edit the XML configuration information for the Egnyte Drive 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 Egnyte Drive package (it is a .plist file if you used the default settings when importing the installer).

 

Installation Settings – Customizing Defaults

Upon first launch, Egnyte Drive looks for “~/Library/Application Support/Egnyte Drive/initial_setup.config” in each user directory 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.

Sample initial_setup.config file syntax:

# Config text file format syntax.
# First line char is a line type marker:
# - hash char marks line ignored as a comment
# - square open bracket prefix is a optional section begin with id inside, for example: [section]
# - empty whitespaced line is ignored
# - other lines should be key=value pairs, one for each line

[proxy]
isProxyEnabled=YES
proxyServer=google.com
proxyServerPort=80
proxyType=HTTP
isProxyAuthenticated=YES
proxyUserName=proxyuser
proxyPassword=proxypass

[drive_1]
userDomainUrl=acmeinc
setupAuthType=egnyte
driveLabel=acmeinc
userName=admin
[drive_2]
userDomainUrl=westcoastlens
setupAuthType=SSO
driveLabel=westcostlens
userName=jsmith

 

 

Drive setting parameters:

Drive Settings

Settings

Description

Sample values

Required

userDomainUrl

Egnyte domain name

acmeinc

Yes

setupAuthType

Authentication type Egnyte or Single Sign-On

Egnyte | SSO

Yes

driveLabel

Drive name or label

MyDrive1

Yes

username

Username for authenticating to Egnyte

jsmith

Optional. User will be prompted for username during when drive first mounts

Proxy setting parameters (OPTIONAL):

Web Proxy

Settings

Description

Sample values

Required

isProxyEnabled

Enable or disable proxy usage

YES | NO

No. Default will be “No” if not specified.

proxyServer

Proxy server URL

proxy.mycompany.com

Yes, if “isProxyEnabled” is enabled

proxyServerPort

Proxy server port number

80

Yes, if “isProxyEnabled” is enabled

proxyType

Proxy server type

HTTP | HTTPS | SOCKS

Yes, bled

isProxyAuthenticated

Enable if proxy requires authentication

YES | NO

No. Default will be “No” if not specified.

proxyUserName

Username for proxy server

jsmith

No

proxyPassword

Password for proxy server

MyPassword123!@#

No

 

Sample script:  This will create and preconfigure a drive for all user accounts on a the target Mac.

<key>preinstall_script</key>
<string>#!/bin/sh

configFile=/tmp/initial_setup.config

echo "[drive_1]" > $configFile
echo " userDomainUrl=acmeinc" >> $configFile
echo " setupAuthType=egnyte" >> $configFile
echo " driveLabel=acmeinc" >> $configFile
echo " userName=admin" >> $configFile

localUsers=$( dscl . list /Users UniqueID | awk '$2 >= 501 {print $1}')

for userName in $localUsers; do
     mkdir "/Users/$userName/Library/Application Support/Egnyte Drive"
     chown $userName "/Users/$userName/Library/Application Support/Egnyte Drive"
     chmod 755 "/Users/$userName/Library/Application Support/Egnyte Drive"
     cp "/tmp/initial_setup.config" "/Users/$userName/Library/Application Support/Egnyte Drive/initial_setup.config"
done

</string>

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 Egnyte Drive 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.

Customize Egnyte Drive Uninstallation

Uninstaller App

Removing the software involves running the “Egnyte Drive Uninstaller.app” that is located in “~/Library/Application Support/Egnyte Drive”. 

Example:

<key>uninstall_method</key>

<string>uninstall_script</string>

<key>uninstall_script</key>

<string>#!/bin/sh

open ~/Library/Application\ Support/Egnyte\ Drive/Egnyte \Drive\ Uninstaller.app

</string>

Setting up Unattended Installation, Upgrades, and Uninstallation

Make sure your pkgsinfo files Egnyte Drive include the following keys and settings.

<key>unattended_install</key>

<true/>

<key>unattended_uninstall</key>

<true/>

<key>uninstallable</key>

<true/>

Additional Tips

End User Configuration

Once installed, the end user will need to launch Egnyte Drive from the Applications folder to run it for the first time.  They will be prompted to enter their username (if not specified) and password at this step.

You may want to share the training videos provided at the link below to your end users.  Under Cloud Collaboration, they can play the Egnyte Drive training video.

http://www.egnyte.com/file-server/videos.html

 

Egnyte Community

Egnyte Community

Want to connect with other Egnyte users and our Egnyte team? Share ideas and ask questions in our Community.