You can silently deploy the Syncplicity Windows and Mac desktop clients to a wide group of users instantly. This should minimize user errors and support calls, as well as eliminate extra steps for your end users.
This article describes the command line arguments and provides examples. See the end of the article for additional information if using Single Sign-On (SSO).
Requirement: If installing Syncplicity software via policy on a Windows system, .NET 4.6.2 must be installed on the client system as a prerequisite.
Command line parameters
You can use the tool of your choice to deploy the Syncplicity desktop client installer to the user's desktop, and then run a command to install it. Command line options for completing this silent installation are as follows:
All parameters can be used with the Windows desktop client installation, but only the /S, USESSO, and NOAPPLAUNCH parameters can be used with the Mac.
NOTE: For previous Syncplicity versions, the INSTALLLOCATION, SYNCPDIR, UPLOADMAX & DOWNLOADMAX, and EXCLUDEFILETYPES parameters are no longer used. Instead, use the desktop policies to manage these settings.
IMPORTANT: For Mac desktop clients, if the /S parameter is used, it must be in the command line first. All other parameters are optional and can be specified in any order.
|
SILENT MODE INSTALL (/S) |
Use this parameter if using silent installation. It also suppresses the end user license page. If used to silently install the client on a Mac system, it must be the first parameter. |
|
NOAPPLAUNCH |
Set to 1 (or any nonzero value) to prevent the application from launching at the end of installation. Set to 0 to enable application launch at the end of the installation. This must be set to 1 if you are configuring Syncplicity software deployment via policy. |
|
USEHOSTNAME* |
Set to 1 to have the computer host name display as the default computer name in the installation wizard. Use any other value to have the users enter a system name in the installation wizard. NOTE: The desktop silent onboard policy can be set to prevent the user from seeing the dialog. |
|
USESSO* |
Set to 1 if using SSO. The desktop client will fetch the Email Id and credentials from NT and attempt to login. If the attempt fails, the user is shown the login screen. If set to any other value, the user is prompted to log in to the Syncplicity account during installation. |
*USEHOSTNAME and USESSO have no impact when upgrading the desktop client.
NOTE: There are two additional settings that you can set remotely, FoldersToMap and AllowUserToUnmap. They are not part of the installation; although, they can be set at the same time. See Mapping Syncplicity folders silently.
Windows Examples
This example does not display the installation wizard to the user or launch the Syncplicity client:
Syncplicity_Setup.exe /S USEHOSTNAME=1 USESSO=1 NOAPPLAUNCH=1
This example does not display the installation wizard to the user but it does launch the Syncplicity client:
Syncplicity_Setup.exe /S USEHOSTNAME=1 USESSO=1
This example displays the installation wizard to the user but it does not launch the Syncplicity client:
Syncplicity_Setup.exe USEHOSTNAME=1 USESSO=1 NOAPPLAUNCH=1
This example displays the installation wizard to the user and launches the Syncplicity client at the end of the installation:
Syncplicity_Setup.exe USEHOSTNAME=1 USESSO=1
Mac Examples
If using the command without any arguments, the user sees the installation wizard, the system name appears in the Computer Name field, and the client launches after the end of the installation.
./silentInstall.sh 'Syncplicity 3.5.3.0.dmg'
This example displays the installation wizard to the user and forces SSO authentication mode:
./silentInstall.sh 'Syncplicity 3.5.3.0.dmg' USESSO=1
This example displays the installation wizard to the user but does not force SSO authentication mode:
./silentInstall.sh 'Syncplicity 3.5.3.0.dmg' USESSO=0
This example displays the installation wizard to the user but it does not launch the Syncplicity client:
./silentInstall.sh 'Syncplicity 3.5.3.0.dmg' NOAPPLAUNCH=1
This example displays the installation wizard to the user and launches the Syncplicity client:
./silentInstall.sh 'Syncplicity 3.5.3.0.dmg' NOAPPLAUNCH=0
This example does not display the installation wizard to the user or launch the Syncplicity client:
./silentInstall.sh 'Syncplicity 3.5.3.0.dmg' /S
This example does not display the installation wizard to the user or launch the Syncplicity client, but it does force SSO authentication mode:
./silentInstall.sh /S NOAPPLAUNCH=1 USESSO=1 'Syncplicity 3.5.3.0.dmg'
This example does not display the installation wizard to the user but it does launch the Syncplicity client:
./silentInstall.sh /S NOAPPLAUNCH=0 USESSO=0 'Syncplicity 3.5.3.0.dmg'
NOTE: If you need the silentInstall script for Mac, contact Syncplicity Support.
SSO Information
For SSO accounts, you have the option to suppress the Welcome email sent to users. Enabling this option makes it possible to use an application management tool or policy engine to install the Syncplicity desktop client on user's desktops without requiring user action. Also, users receive no notification that an account has been created for them, and their accounts are auto-activated when the administrator creates them.
To configure a silent login for SSO accounts, set USESSO=1 and make sure the users' IDP integration with Active Directory allows silent login from a browser (to access My Syncplicity on the web) and from the desktop (when using the desktop client).
For more information, see Configuring single sign-on.