Mass Deployment - Default Configuration Support

The ability to provide defaults for the FileCloud Client Apps like Sync, Drive and Office Add-ins is available in FileCloud Server version 15.0 and later.

The ability to provide defaults for bandwidth limits and time active controls in FileCloud Sync is available in FileCloud Server version 18.2 and later.


As an administrator you can roll out a mass deployment of settings for all the client apps across the enterprise. 

(warning)  Notes:

  • Mass deployment requires that default configurations be added to the Windows registry.
  • These defaults are used by the apps when initially starting up and don't have any effect if they are changed after the apps are initialized.
  • Please ensure before adding a value that it is not already present in the "syncclientconfig.xml" before testing. Otherwise, the mass deployment configuration values will not be used.

The following table lists the supported default configuration parameters.



ParameterTypeNotesSyncWindows DriveMac DriveOffice Add-OnOutlook Add-On
urlString

The server URL.

example: https://files.xyz.com

YESYESYESYESYES
profileString

User name to use to login.

example: john or john@company.com

You can use the current OS user as the username by specifying ${USER}

YESYESYESYESYES
checkupdatesString'0' to disable, '1' to enableYESYESYESNONO
httpproxyenabledString'0' to disable, '1' to enableNOYESYESNONO
httpproxyhostStringProxy Hostname to use for connectionYESYESYESYESYES
httpproxyportStringProxy Port to use for connectionYESYESYESYESYES
httpproxyuserStringProxy User Authentication name to useYESYESYESYESYES
httpproxypasswordStringProxy User Authentication password to useYESYESYESYESYES
ssllevelString

Special directive to allow apps to connect to TLS-only servers.

Possible usages are CLIENT_USE, TLSV1_1_CLIENT_USE, TLSV1_2_CLIENT_USE, TLSV1_3_CLIENT_USE

YESYESYESNONO
officehelperdisabledStringFileCloud for Office (FFO)/DocIQ Office IntegrationYESNONONONO
officehelperlockoneditStringAutomatic locking in FileCloud for Office (FFO)/DocIQYESNONONONO
syncfolderlocationString

Path to use for the sync folder location.

DEFAULT - use the default location
Absolute Full Paths - e.g. c:\filecloudsync
Expanded Paths - e.g. %APPDATA%\FileCloudSync (Windows Only) or ${HOME}\FileCloudSync (Windows and Mac OSX) 


YESNONONONO
syncclientlocationString

Path to use for the sync folder data and cache location.

DEFAULT - use the default location
Absolute Full Paths - e.g. c:\filecloudsyncdata
Expanded Paths - e.g. %APPDATA%\FileCloudSyncData (Windows Only) or ${HOME}\FileCloudSyncData (Windows and Mac OSX) 


YESPasNONONONO
removeunsharedString

Directive to require sync to delete shared folders from local device if they are no longer shared for synching

"0" - Default, does not remove unshared folders

"1" - Removes shared folders from local when they are no longer shared from the server

YESNONONONO
authmodeString 

Directive to use password authentication, SSO, or device code authentication for log in to Sync.

"password" - Password authentication

"sso" - SSO authentication

"devauth" - Device code authentication

YESNONONONO
drivecachelocationString

Path to use for drive cache

DEFAULT - use the default location
Absolute Full Paths - e.g. c:\fileclouddrive
Expanded Paths - e.g. %APPDATA%\FileCloud Drive\data (Windows Only) or ${HOME}\FileCloud Drive (Windows and Mac OSX) 


NOYESNONONO
enableshortcachepathStringWhether to use a short path made up of random digits or to use "DOMAIN@USERNAME" for the folder in the cache. Use this option to avoid exceeding the maximum path length.

"0" - Default, use DOMAIN@USERNAME
"1" - Use short path made up of random digits 
NOYESYES NO NO
drivedefaultstorageingbStringThe value in GB of the default user quota settingNOYESYESNONO
drivemountpointString

Mount point to override

Can be empty or it must be a drive letter with ":" like "F:"

NOYESNONONO
sslverifyString

Directive to disable strict checking of SSL cerificates. If this key is not provied, the default is strict verification

VERIFY_NONE: disable SSL Verification checking

VERIFY_STRICT: enables strict SSL Verification checking

YESYESYESYESYES
driveloginmodeString

Directive to use password authentication or device code authentication

"0" - Password authentication

"1" - Device Code authentication

"2" - SSO authentication

NOYESYESNONO
drivelockonupdateString

Directive to lock file when opened for modification

"0" - No lock while editing

"1" - Auto Lock while editing

NOYESYESNONO
drivemutemessagesString

Show or hide automatic information messages from drive

"0" - Do not mute messages

"1" - Mute messages

NOYESYESNONO
officehelperdisabledString

Whether to disable FileCloud for Office (FFO)/DocIQ

"0" - Do not disable  FileCloud for Office (FFO)/DocIQ

"1" - Disable  FileCloud for Office (FFO)/DocIQ

NOYESYESNONO
showdashboardonstartupString

Whether to show the dashboard on startup 

"0" - Do not display dashboard on startup

"1" (default) Display dashboard on startup

NOYESYESNONO
driveopenexploreronstartupString

Automatically launch explorer on startup of drive

"0" - Do not start explorer on startup

"1" - Launch explorer on startup

NOYESYESNONO
useuniquemountlabelString

When enabled, sets mount label to a unique value (by adding the user name to the label).

"0" - (default) Do not set mount label to unique value.

"1" - Set mount label to unique value (add user name to the label)

NOYESNONONO
allowthumbsdbuploadString

Whether to upload of thumbs.db files.

"0" - (default) Do not upload of thumbs.db files.

"1" = Upload thumbs.db files

NOYESNONONO
disableautologinString

Whether to prevent Drive from remembering the password and automatically logging in.

"0" - (default) Allow auto-login

"1" - disable auto-login

NOYESYESNONO
multimountString

Allow multiple FileCloud Drive sessions to run on the same computer (and allow mounting of different cloud locations simultaneously.
Note: When this is enabled, log-in information is not saved, and must be re-entered each time Drive is started.

"0" - (default) Do not allow multiple instances to run

"1" - Allow multiple instances to run.

NOYESNONONO
currentlanguageStringThe default language of FileCloud Drive. The value is English by default.

Supported values are English, Dutch, French, Spanish, Portuguese, German, Italian, Arabic, and Russian.
NOYESYESNONO
languageString The default language of FileCloud Sync. The value is English by default.

Supported values are English, Dutch, French, Spanish, Portuguese, German, Italian, Arabic, and Russian.

YESNONONONO
cachevalidationsecondsStringInterval in seconds between checks for changes in values stored in cache. Default, recommended value is 60.NOYESYESNONO
autolocktypesStringLists file types that are exempt from download limits.
Default types are: txt,rtf,doc,docx,xls,xlsx,ppt,pptx,indd
NOYESYESNONO
disablerecoveringString

By default, files are copied to the recovered folder before they are uploaded to Drive and deleted after upload succeeds. You may change the setting to copy the files to the recovered folder only after upload to Drive is attempted and fails.

"0" - (default) Files are copied to recovered folder before upload occurs.

"1" - Files are copied to recovered folder after upload is attempted if upload fails.

NOYESYESNONO
disableprecachingString

By default, when Drive starts up, the file/folder directory is retrieved from the server so that it is immediately available to Drive users. You may change the setting so that the file/folder directory is retrieved when the user begins navigating the folders to reduce the load on the server after startup; in this case, initially navigating the folders may be slower.

"0" – (default) File/folder directory is retrieved when Drive starts up.

"1" - File/folder directory is retrieved when a user starts navigating the folders. 

NOYESYESNONO
lockexpirationinminStringValue, in minutes, that a lock on a file is maintained before it expires. Default and minimum is 10; if value is set below 10, expiration time still occurs in 10 minutes.NOYESYESNONO
disablelockexpirationString

Whether or not to enable expiring of locks. By default, locks on files expire after 10 minutes or the time set in lockexpirationinmin.

"0" - (default) Use expiration times set for file locks.

"1" - Do not use expiration times on locks. Locks expire on files when users close them.

NOYESYESNONO
enablethumbnailpreviewString

Whether or not to display thumbnails and previews of listed files.

"0" - (default) Do not display thumbnails and previews (this reduces network traffic since files are downloaded when thumbnails and previews are generated)

"1" - Display thumbnails and previews.

NONOYESNONO
maxdownloadsizeinmbString

Default single file download limit in MB.

0 - No limit

Other options can be 10,30,50, 100

NOYESYESNONO
allowcentralmgmtString

Allow central management

0 - No Central Management

1- Allow Central Management

YESNONONONO
globalbwforuploadStringSpecifies the bandwidth limit when uploading files from the client to the server in terms of KB only.YESNONONONO
globalbwfordownloadStringSpecifies the bandwidth limit when downloading files from the server to the client in terms of KB only.YESNONONONO
altbwforuploadStringSpecifies that alternative settings should be used instead of the global bandwidth limit when uploading files from the client to the server in terms of KB only.YESNONONONO
altbwfordownloadStringSpecifies that alternative settings should be used instead of the global bandwidth limit when downloading files from the server to the client in terms of KB only.YESNONONONO
altbwfromtimeStringSpecifies the starting time when the alternative settings should be used instead of the global bandwidth limit. YESNONONONO
altbwtotimeString

Specifies the ending time when the alternative settings should be used instead of the global bandwidth limit.

Time must be expressed in the format HH:MM:SS

YESNONONONO
altbwschedule_dayofweekString

Specifies the days of the week when the alternative settings should be used instead of the global bandwidth limit.

This value can be any number such as: {-1, 0, 1, 2, 3, 4, 5, 6} where:

  • -1 means every day
  • 0 means Sunday
  • 1 means Monday
  • and so on..
YESNONONONO
timeactivecontrolsset

Enables/Disables the Active Sync Hours settings

1 = enabled

0 = disabled

<timeactivecontrolsset>1</timeactivecontrolsset>YESNONONONO
activesync_daysofweek

Specifies the days of the week when a client can run the Sync app

Any number {-1, 0, 1, 2, 3, 4, 5, 6} where:

  • -1 = Everyday
  • 0 = Sunday
  • 1 = Monday
  • and so on...
<activesync_daysofweek>5</activesync_daysofweek>YESNONONONO
activesync_timeofday

Specifies the times during the days of the week when a client can run the Sync app

Use the format HH:MM:SS-HH:MM:SS

<activesync_timeofday>8:00:00-20:00:00</activesync_timeofday>YESNONONONO

FAQs



The location of the default configuration is in the Windows Registry.

An example configuration is shown below.

Note: The registry key (HKEY_LOCAL_MACHINE\SOFTWARE\CodeLathe\FileCloud\DefaultCfg) must be created manually, including the default values.

HKEY_LOCAL_MACHINE\SOFTWARE\CodeLathe\FileCloud\DefaultCfg


HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run


The location of the default configuration is a plist file in 

~/Library/Preferences/com.codelathe.filecloud.defaultcfg.plist


Example plist


<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>url</key>
<string>https://mysite.company.com</string>
<key>profile</key>
<string>jsmith</string>
<key>maxdownloadsizeinmb</key>
<string>0</string>
<key>drivelockonupdate</key>
<string>1</string>
<key>drivemutemessages</key>
<string>1</string>
<key>driveopenexploreronstartup</key>
<string>1</string>
<key>driveloginmode</key>
<string>1</string>
<key>checkupdates</key>
<string>0</string>
</dict>
</plist>