Skip to end of metadata
Go to start of metadata

 Client Device configuration settings can be configured remotely by specifying the configuration XML using policies. These settings are referred to as RMC (Remote )

For the Sync client, when an Admin sets a remote client policy, a user working in the Sync app cannot modify the settings. Sync will display a message saying "Centralized Configuration is being applied. Settings cannot be changed.".

FAQs


 How do I get the configuration XML for sync apps?

The easiest way to get the configuration XML for sync apps is by configuring a Sync app as needed and then exporting the configuration.


To export Sync configuration settings:

  1. From the system tray, right-click the FileCloud icon.
  2. Select Settings.
  3. On the Settings window, select the Help bubble.
  4. Under Troubleshooting, click Export Config.


 What variables are supported?

When specifying values, variables can be used as well. The following variables are currently supported.

VariableNotes
${USER}Replaces with current logged in user name from the Operating System
${HOME}Replaces with the location of the current user's Home Path
${USERID}Replaces with the currently logged in FileCloud user account name
 What is the XML code for limiting bandwidth rates?

If your users are running the FileCloud Sync app on a slow network, when Sync transfers files it can quickly use up all the network bandwidth.

You can have your users set individual bandwidth rates by following instructions in the Users Guide:

Set Bandwidth Rate Limits for Sync

Or you can use centralized device management to limit bandwidth rates for all clients.

(warning) If Centralized Device Configuration is set, the user will not be allowed to change the settings from the User Portal. The user will see the following message:
 Centralized Configuration is being applied. Bandwidth Settings cannot be changed. Please contact your administrator for assistance.


The XML code will include the following lines:

<cloudsync>
      <globalbwforupload></globalbwforupload>
   <globalbwfordownload></globalbwfordownload>
   <altbwforupload></altbwforupload>
   <altbwfordownload></altbwfordownload>
   <altbwfromtime></altbwfromtime>
   <altbwtotime></altbwtotime>
   <altbwschedule_dayofweek></altbwschedule_dayofweek>
 </cloudsync>


XML TagValueExample
globalbwforupload

Specifies the bandwidth limit when uploading files from the client to the server in terms of KB only.

This limit can be different from the download limit.

<globalbwforupload>100</globalbwforupload>
globalbwfordownload

Specifies the bandwidth limit when downloading files from the server to the client in terms of KB only.

This limit can be different from the upload limit.

<globalbwfordownload>50</globalbwfordownload>
altbwforuploadSpecifies 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.<altbwforupload></altbwforupload>
altbwfordownloadSpecifies 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.<altbwfordownload></altbwfordownload>
altbwfromtime

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

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

<altbwfromtime>16:45:00</altbwfromtime>
altbwtotime

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

<altbwtotime>24:00:00</altbwtotime>
altbwschedule_dayofweek

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..
<altbwschedule_dayofweek>3</altbwschedule_dayofweek>

 If altbwforupload or altbwfordownload is specified but altbwfromtime and altbwtotime are missing, then the bandwidth values will not be set.

 A "Missing RMC params" message will be displayed in the log file.



 What is the XML code for Active Sync Hours?

As an administrator, you can enable or disable a client's ability to set a schedule for when the Sync app runs.

(warning) If Active Sync Hours is disabled, Sync will be active and function normally unless the user clicks the Pause button to stop it.

Use the following XML code to allow or disable the Active Sync Hours checkbox and settings.

<cloudsync>
  <timeactivecontrolsset></timeactivecontrolsset>
  <activesync_daysofweek></activesync_daysofweek>
  <activesync_timeofday></activesync_timeofday>
</cloudsync>

XML TagValueExample
timeactivecontrolsset

1 = enabled

0 = disabled

<timeactivecontrolsset>1</timeactivecontrolsset>
activesync_daysofweek

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

-1 = Everyday

0 = Sunday

1 = Monday

...etc.

<activesync_daysofweek>5</activesync_daysofweek>
activesync_timeofdayUse the format HH:MM:SS-HH:MM:SS<activesync_timeofday>8:00:00-20:00:00</activesync_timeofday>
 What XML settings allows users to modify folders?

As an administrator, you can allow Sync users to modify the following folders:

  • Selective Sync folders
  • Network folders
  • Backup folders

The XML Settings for enabling or disabling the ability to modify these folders are:

XML TagValueExample
allowuserconfigforlimitsync

0 = cannot modify the Selective Sync folder and any limitfolder setting, if present, is applied

1 = can modify the folder and overrules any limitfolder setting

<allowuserconfigforlimitsync>1<allowuserconfigforlimitsync>
allowuserconfigfornwfolders

0 = cannot modify the Network folder and any offlinefolder setting configured for Network folders, if present, is applied

1 = can modify the folder and overrules any offlinefolder setting configured for Network folders

<allowuserconfigfornwfolders>1<allowuserconfigfornwfolders>
allowuserconfigforbackup

0 = cannot modify the Backup folder and any offlinefolder setting configured for Backup folders, if present, is applied

1 = can modify the folder and overrules any offlinefolder setting configured for Backup folders

<allowuserconfigforbackup>1</allowuserconfigforbackup>


Scenarios

The XML attribute to allow users to modify one of these folders works in combination with other Device Management settings.


Controlling modifications to selective sync folders

limit folders

allowuserconfigforlimitsync

Sync User's Access
/john/folder1|/john/folder21

Although limit folders are present, because allowuserconfigforlimitsync is set to allow modifications:

  • limitfolder settings will NOT be applied
  • Users CAN modify their selective sync folders
/john/folder1|/john/folder20

Because limit folders are present, AND allowuserconfigforlimitsync is set to disable modifications:

  • limitfolder settings will BE applied
  • Users CANNOT modify their selective sync folders
None set1

Because allowuserconfigforlimitsync is set to allow modifications:

  • Users CAN modify their selective sync folders, irrespective of any other settings in the config
None set0

Because allowuserconfigforlimitsync is set to disable modifications:

  • Users CANNOT modify their selective sync folders

Controlling modifications to selective backup folders

light-on (on) These scenarios can also apply to network folders

offline foldersallowuserconfigforbackupSync User's Access
C:\data\local1

Because offline folders (configured for backup) are present, AND allowuserconfigforbackup is set to enable modifications:

  • offlinefolder setting configured for Backup folders, will NOT be applied
  • Sync users CAN modify backup folders
C:\data\local0

Because offline folders (configured for backup) are present AND allowuserconfigforbackup is set to disable modifications:

  • offlinefolder setting configured for Backup folders, will BE applied
  • Sync users CANNOT modify backup folders
None set1

Because allowuserconfigforbackup is set to enable modifications:

  • Sync users CAN modify backup folders, irrespective of any other settings in the config.
None set0

Because allowuserconfigforbackup is set to disable modifications:

  • Sync users CANNOT modify backup folders


To set a device configuration for a policy:

  1. Launch FileCloud Sync by right-clicking on the icon in your system tray, and then selecting Settings.
  2. To open the list of policies, select the Policy tab.
  3. Open the Policy that you want to edit
  4. Select the Device Configuration tab.
  5. In Client Configuration, paste or type in the following remote device configuration XML. 

    <xml>
         <cloudsync>
            <!-- XML for Sync App -->
         </cloudsync>
    </xml>
  6. Replace the <!-- XML for Sync App --> line with the parameters that you need using the descriptions in Table 1. 

Table 1. Supported XML Tags for Sync


XML TagValueExample
limitfolders'|' separated list of folders for selective sync. If Limitfolders is not specified, then there are no folders for selective sync.<limitfolders>/john/folder1|/john/folder2</limitfolders>
offline_folder_countNumber of offline folders to sync. If key is not specified, then there are no offline folders.<offline_folder_count>0</offline_folder_count>

offline_folder_1

offline_folder_2

offline_folder_3

...

Depending upon the number of offline folders specified in the offline_folder_count, you will need to have the appropriate number of entries.

The folder value is specified using 6 parameters using the following format
<LOCAL FOLDER>|<REMOTE FOLDER>|<SYNCTYPE>|<SCHEDULE>|<RECURSE INTO DIRECTORIES>|<ALLOW REMOTE DELETION>|<SENDEMAIL>

<LOCAL FOLDER> = E.g: C:\data\localfolder
<REMOTE FOLDER> = E.g.: /john/folder1
<SYNC TYPE> = 0 - 2 Way Sync, 1 - Backup from Local to Remote, 2 - Read only copy of remote files to local
<SCHEDULE>=  1h (every 1 hour), 2h (every 2 hours), 4h (every 4 hours), 8h (every 8 hours), 24h (every 24 hours), 30m (every 30 minutes), manual (Manual), realtime (Real-time syncing)
<RECURSE INTO DIRECTORIES> = 1 - Recurse (top level and sub folders are synced), 0 - Not Recurse (only top level folder is synced) 
<ALLOW REMOTE DELETION> = 1- Allowed (Local deletes are not propagated to server) , 0-Disallowed (Local deletes are not propagated to server)
<SENDEMAIL> = 1 - Send Email after backups, 0-No Email

<offline_folder_1>C:\data\local|/john/folder1|0|30m|1|0|0</offline_folder_1>
disablenotifications0/1 - Enable or Disable sync notifications<disablenotifications>1</disablenotifications>
showlocks0/1 - Enable or Disable if lock information is shown in icon overlay<showlocks>1</showlocks>
syncfrequency

number - Number in seconds to sync to the server (default is 120 seconds)

<syncfrequency>100</syncfrequency>
checkmodtime0/1 - Advanced: check modification time in addition to size when checking for changes. Default is disabled.<checkmodtime>1</checkmodtime>
checkcrc0/1 - Advanced: check CRC in addition to size when checking for changes. Default is disabled.<checkcrc>1</checkcrc>
removeunshared0/1 - Delete locally synced folders that are unshared. Default is disabled<removeunshared>1</removeunshared>
deleteapprovalpctNumber from 0 to 100, which indicates what % of files requires change approval. Default is 10.<deleteapprovalpct>20</deleteapprovalpct>
skipdeleteapproval0/1 - Whether approvals are needed for bulk sync changes. Default is disabled.<skipdeleteapproval>1</skipdeleteapproval>
currentlanguageAllows changing the current language of the Sync app<currentlanguage>dutch</currentlanguage>
globalbwforupload

Specifies the bandwidth limit when uploading files from the client to the server in terms of KB only.

This limit can be different from the download limit.

<globalbwforupload>100</globalbwforupload>
globalbwfordownload

Specifies the bandwidth limit when downloading files from the server to the client in terms of KB only.

This limit can be different from the upload limit.

<globalbwfordownload>50</globalbwfordownload>
altbwforupload

Specifies 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.

(warning) If altbwforupload or altbwfordownload is specified but altbwfromtime and altbwtotime are missing, then the bandwidth values will not be set.

<altbwforupload></altbwforupload>
altbwfordownload

Specifies 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.

(warning) If altbwforupload or altbwfordownload is specified but altbwfromtime and altbwtotime are missing, then the bandwidth values will not be set.

<altbwfordownload></altbwfordownload>
altbwfromtime

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

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

(warning) If altbwforupload or altbwfordownload is specified but altbwfromtime and altbwtotime are missing, then the bandwidth values will not be set.

<altbwfromtime>16:45:00</altbwfromtime>
altbwtotime

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

(warning) If altbwforupload or altbwfordownload is specified but altbwfromtime and altbwtotime are missing, then the bandwidth values will not be set.

<altbwtotime>24:00:00</altbwtotime>
altbwschedule_dayofweek

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...
<altbwschedule_dayofweek>3</altbwschedule_dayofweek>
timeactivecontrolsset

Enables/Disables the Active Sync Hours settings

1 = enabled

0 = disabled

<timeactivecontrolsset>1</timeactivecontrolsset>
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>
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>
allowuserconfigforlimitsync

0 = cannot modify the folder and any limitfolder setting is applied

1 = can modify the folder and overrules any limitfolder setting

This value works in combination with:

  • limitfolders
<allowuserconfigforlimitsync>1<allowuserconfigforlimitsync>
allowuserconfigfornwfolders

0 = cannot modify the folder and any offlinefolder setting is applied

1 = can modify the folder and overrules any offlinefolder setting

This value works in combination with:

  • offlinefolders
<allowuserconfigfornwfolders>1<allowuserconfigfornwfolders>
allowuserconfigforbackup

0 = cannot modify the folder and any offlinefolder setting is applied

1 = can modify the folder and overrules any offlinefolder setting

This value works in combination with:

  • offlinefolders  
<allowuserconfigforbackup>1</allowuserconfigforbackup>


  • No labels