Installing WebSynchro via command line

As an administrator, you can install and configure WebSynchro directly via the command line. You'll be able to perform silent installations, prevent updates, and set a proxy or default synchronization if needed.

List of general settings

Setting name

Description

ServerHostName

Server domain name

Default for SaaS solutions: sharing.oodrive.com

Workspace

 Workspace name

Silent

 For a silent installation, with a visible user interface (ability to cancel the installation)

VerySilent

 For a silent installation, without a user interface

NeverUpdate

if NeverUpdate=true, WebSynchro will not update even if an update is available on the server.

Default: NeverUpdate=false

Log

 File name of the Installation log

Below is an example of a simple silent installation, with updates disabled:

WebSynchro.exe /VerySilent /NeverUpdate=true

Please note

It is possible to use a configuration file to pre-configure specific folder synchronizations for all users during mass deployment of the application (see Default synchronization configuration settings).

Settings for configuring a default synchronization

You can define a list of folders to be synchronized by default.

Requirements

The following requirements must be met to set up this feature:

  • The file must be in UTF-8 format, to avoid errors with special characters.

  • JSON syntax must be respected, otherwise the file cannot be read. Each object between { and } must be separated from the previous one by a comma.

  • In path names, folders must be separated by backslashes (not slashes), and these must be doubled, otherwise JSON syntax errors will occur.

  • The local access path (LocalPath) must be an absolute path (from the root of the drive, C: for example).

  • The server path (RemotePath) is relative to the Files folder at the root of the account, so do not include Files at the start of the server path.

Setting name

Description

SyncRoots

Path to a PresetSyncRoots.json configuration file

Below is an example of an installation with a list of predefined folders to be synchronized:

WebSynchroInstaller_2.7.0.exe /VERYSILENT SyncRoots="chemin\du\fichier\PresetSyncRoots.json"

Configure a default synchronization

You can configure the folders to be synchronized by creating a file named PresetSyncRoots.json, with content like this:

[

    {

         "LocalPath": "C:\\Users\\johndoe\\Document\\Contrats",

         "RemotePath": "Documents\\Contrats"

     },

     {

         "LocalPath": "C:\\Users\\johndoe\\Document\\Factures",

          "RemotePath": " Documents\\Factures"

     }

]

This file can be deployed in one of two ways:

  • First method: When installing the application from the command line ("silent installation"), specify the file path as SyncRoots="file\path\PresetSyncRoots.json". This will enable the installer to copy the file and add it to the WebSynchro application data.

  • Second method: Manually place the PresetSyncRoots.json file in the folder %PROGRAMDATA%\Oodrive\WebSynchro (usually C:\ProgramData\Oodrive\WebSynchro).

    Important : It is necessary to set the permissions of the file so that the user can read it but not modify it.

Synchronizations created through this mechanism will not be modifiable in the WebSynchro interface (they will be marked with a small padlock icon).

Attention

Si l’utilisateur a déjà configuré une synchronisation qui entre en conflit avec une synchronisation prédéfinie, elle sera supprimée et remplacée par la synchronisation prédéfinie. Cependant, les fichiers seront conservés.

Warning: If a user had already set up a synchronization that conflicts with the new predefined synchronization, the user's synchronization will be deleted and replaced by the predefined synchronization. However, the files will be kept.

Modify the deployed file

You can modify the PresetSyncRoots.json file after deploying it.

  • Changes will take effect the next time the user logs on to WebSynchro.

  • Synchronizations deleted from the PresetSyncRoots.json file will not be deleted from the user's account, but will be unlocked to allow the user to delete them manually if they wish.

Proxy configuration settings

Setting name

Description

ProxyName

Proxy name

ProxyAddress

 Proxy domain name (address without the http://)

ProxyPort

 Proxy port

ProxyAuthType

Proxy authentication type

Possible values: None, Basic, SAML, Kerberos, NTLM, Anonymous (defaut)

ProxyUserName

Login to use for connecting to the proxy

ProxyPassword

 Password to use for connecting to the proxy

ProxyDomain

 Proxy domain (for NTLM authentication)

ProxyScript

 Where applicable, address of the automatic proxy configuration script (.pac)

SysProxyInfo

System proxy credentials, in the form http://user:password@host:port/

Configuring a modifiable proxy in the application settings

This setting can be found in the Proxy section of the Connection tab.

Example of an installation that defines a proxy with Basic authentication:

WebSynchroInstaller.exe /VERYSILENT /ProxyName="basic proxy"/ProxyAddress="proxy.monentreprise.com" /ProxyPort="3128" /ProxyAuthType="Basic"/ProxyUserName="userProxy" /ProxyPassword="passwordProxy"

Example of an installation that defines a proxy using a .pac script:

WebSynchroInstaller.exe /VERYSILENT /ProxyName="pac proxy"/ProxyScript="https://proxy.monentreprise.com/proxy.pac"

Configuring the proxy system

This proxy setting does not appear in the application settings. It can be used when a system proxy is already defined in the computer's Internet options.

Example of installation with an NTLM system proxy:

WebSynchroInstaller.exe /VERYSILENT /SysProxyInfo"http://OODRIVEGROUP%5Cuser1:password1@192.168.9.152:3128"

Example of installation with a Basic authentication system proxy:

WebSynchroInstaller.exe /VERYSILENT /SysProxyInfo"http://user1:password1@192.168.9.152:3128"

Ressources