Egnyte Connect Desktop App for Windows Mass Deployment Guide

Introduction

Mass deployment tools allow organizations to install and update software for multiple users at once. Common examples of tools include Microsoft SCCM (System Center Configuration Manager) or deployments through the use of Group Policy Objects (GPO). For larger customers, mass deployment tools can allow admins to control deployments of software and updates.

Overview

This guide will provide step by step instructions on how to setup a Mass Deployment of the Egnyte Connect Desktop App on Windows.

Mass deployment of the desktop app is split into two phases:

  1. Installation / Upgrade - where the app is installed on the machine using an account with admin privileges. If you're only setting up a single drive per user, you can specify command-line options during installation to specify details like the domain being connected to, the drive letter and label to use, and whether SSO is being used for signing the user in.
  2. (Recommended) Restarting the explorer.exe process - this is best achieved by restarting the machine or adding the /forcerestart install parameter (more information here).
  3. Configuration - where drives are configured on behalf of users after installation by using a new command-line tool that is shipped with the product. If configuring more than one drive per user, you must use the command-line tool.

 

Prerequisites

Download Egnyte Connect for Windows.

Please be sure to review the System Requirements.

 

Installation / Upgrade

To install or upgrade, ensure you run the installation in the context of a user with admin privileges on the machine when using your tool. When upgrading, we recommend you use the same command-line parameters that were used at install or omit all command-line parameters.

Examples of command-line installation calls that can be used:

  • Standard installation if you want to prompt users to add their own drives:
    msiexec /i EgnyteConnect_v2.x.x.msi /qn /forcerestart

  • Standard silent installation for when you will be adding drives on behalf of users (see 'Configuration' section below):
    msiexec /i EgnyteConnect_v2.x.x.msi ED_SILENT=1 /qn /forcerestart

  • Silent installation where auto-updates are disabled:
    msiexec /i EgnyteConnect_v2.x.x.msi ED_SILENT=1 ED_AUTOUPDATE_DISABLED=1 /qn /forcerestart

  • Silent installation using a non-standard installation directory
    msiexec /i EgnyteConnect_v2.x.x.msi ED_SILENT=1 INSTALLDIR='C:\ProgramData\Egnyte Drive' /qn /forcerestart

  • Silent installation using the standard install directory where you want to add one drive for each user and force SSO login to the 'acme.egnyte.com' domain (note if you want to add multiple drives for each user, use the command-line tool detailed in the Configuration section of this article).
    msiexec /i EgnyteConnect_v2.x.x.msi ED_SILENT=1 ED_DRIVE_DOMAIN=acme ED_DRIVE_LABEL=acme ED_DRIVE_SSO=1 ED_DRIVE_LETTER=Z: /forcerestart

Any combination of the following command-line parameters can be used at install:

Property

Values

INSTALLDIR

Installation directory
Default :
32bit Windows - C:\Program Files\ Egnyte Drive\
64bit Windows – C:\Program Files (x86)\ Egnyte Drive\

Silent Installation

ED_SILENT

Defines whether login prompts should be suppressed when the application is started without drives (set to 1 to suppress prompts).

Must be set to 1 if the command-line tool is being used to configure drives on behalf of users.

Value: 0 or 1

Default: 0

Proxy settings

ED_PROXY_SERVER

By default proxy settings are not used. To configure proxy settings by mass configuration proxy server must be defined.

ED_PROXY_PORT

Defines proxy port for connection settings (will be only applied if ED_PROXY_SERVER is defined)

Value: between 0 and 65535

Default: 0

ED_PROXY_PASSWORD_REQUIRED

Proxy setting required password (will be only applied if ED_PROXY_SERVER is defined)

Value: 0 or 1

Default: 0

Disable autoupdate

ED_AUTOUPDATE_DISABLED

Defines if auto update should be enabled or disabled

Value: 0 or 1

Default: 0

Drive settings
Note - these options can be used if you're only adding a single drive for each user - for adding multiple drives for the same user, use the command-line tool detailed in the Configuration section of this article.

ED_DRIVE_DOMAIN

Default account domain

ED_DRIVE_LABEL

Label that will be show at mounted drive

Forbidden characters: ? < > / , * + = | \ [ ] ”

Maximal characters length: 30

ED_DRIVE_LETTER

Drive letter at which default account drive should be mounted

Value: A:, B:, … X: (if letter is already in use available letter will be used

Default: none

ED_DRIVE_MOUNT

Mounting point for default drive i.e. “/Shared/”

ED_DRIVE_SSO

Defines if SSO authentication should be used (will be only used if one of ED_DRIVE_DOMAIN, ED_DRIVE_LABEL, ED_DRIVE_LETTER, ED_DRIVE_MOUNT is defined)

Value: 0 or 1

Default: 0

 

Configuration

The Desktop App includes a command-line tool that is run from the installation directory. The command-line tool can be used in the second phase of deployment to automatically add and configure drives on behalf of users. If the command-line tool is being used after a mass installation, you must use the ED_SILENT=1 flag to suppress the Desktop App prompting users to log in.

Any calls to the command-line tool should be run in the context of the user for whom drives are being configured. This allows different deployment strategies for different types of users on the same machine. For example a marketing user might be used to seeing an 'M:' drive that is mapped directly to the /Shared/Marketing folder in your organization while an employee from HR might be used to seeing a 'H:' drive that shows all content in the domain.

Documentation

To see more information about what is possible with the command-line tool, run the following command in the installation directory of Egnyte:

  • EgnyteDrive.exe --help

Note that all cloud paths are case sensitive (for example, you must use '/Shared' instead of '/shared').

Best practices

Egnyte's recommendation is to use mass deployment tools and strategies that allow scripts to run against the command-line tool on user login. Note that multiple commands to the command-line tool must appear on separate lines in configuration scripts.

To ensure that the app is running at the time of using the tool, we recommend running the following command at the start of any configuration script to force the Desktop app to start before any commands are sent (the example below assumes you are using the default install directory for 64-bit systems at 'C:\Program Files (x86)\Egnyte Connect' - if not, replace the full path to EgnyteClient.exe accordingly):

  • start "Egnyte Connect" "C:\Program Files (x86)\Egnyte Connect\EgnyteClient.exe" --auto-silent

Examples of commands for adding and configuring drives

  • Add a single drive (M:) for the ‘acme’ domain via SSO but don't connect the drive immediately (will prompt the user to log in using their SSO account) - note that running this command twice in a row will only add one drive as a single user cannot have two drives with the same label (this is a good way to ensure that a login script that runs on every login will avoid adding the same drive every time a user logs in):
    EgnyteClient.exe -command add -l “Acme Drive” -d “acme” -sso use-sso -t M

  • Add a single drive (M:) for the ‘acme’ domain via SSO and connect the drive immediately (will prompt the user to log in using their SSO account)
    EgnyteClient.exe -command add -l “Acme Drive” -d “acme” -sso use-sso -t M -c connect_immediately

  • Add a single drive (E:) for the ‘acme’ domain which will use Egnyte or AD authentication and connect the drive immediately (will prompt the user to log in using their Egnyte or AD credentials)
    EgnyteClient.exe -command add -l “Acme Drive” -d “acme” -t E -c connect_immediately

  • Add two drives (M: and E:) connected to the Marketing and Engineering folders in the ‘acme’ domain via SSO and connect both automatically (will prompt the user to login using their SSO account for each drive added this way)
    EgnyteClient.exe -command add -l “Marketing” -d “acme” -sso use-sso -t M -m “/Shared/Marketing” -c connect_immediately
    EgnyteClient.exe -command add -l “Engineering” -d “acme” -sso use-sso -t E -m “/Shared/Engineering” -c connect_immediately

  • Disconnect an existing ‘Marketing’ drive and reconnect for remote troubleshooting after installation
    EgnyteClient.exe -command disconnect -l “Marketing”
    EgnyteClient.exe -command connect -l “Marketing”

  • Remove an existing drive labelled 'Acme Drive'
    EgnyteClient.exe -command remove -l “Acme Drive”

  • Modify a drive labelled 'Acme Drive' to use the 'M:' drive letter
    EgnyteClient.exe -command update -l "Acme Drive" -t M

  • Force silent mode during drive configuration for drive labelled 'Acme Drive'
    EgnyteClient.exe -command connect -l "Acme Drive" --auto-silent

Note that the command-line tool can be used at any time that the desktop app is running on the machine. 

Also note that it's important to standardize on a drive label across your organization as the drive label is used as the identifier for all commands.

 

Uninstallation

To uninstall, simply run the same command that was run for upgrade or install but use /x instead of /i.

For example:
msiexec /x EgnyteConnect_v2.x.x.msi /qn /forcerestart

 

Egnyte Community

Egnyte Community

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