File Syncing For Mac

Applicable Products

• ShareFile

Information

As you know, there is no built-in option to transfer data between macOS and Android. SyncMate fills this gap and becomes the only Android file transfer Mac app you need to keep data in sync Mac and Android. As for syncing with iOS - SyncMate doesn't limit the quantity of iOS devices you can connect and sync with Mac.

ShareFile Sync users are able to seamlessly switch over to Citrix Files for Mac; keeping Synced data available for ‘offline' use and retaining sharing settings.

• FreeFileSync is a folder comparison and synchronization software that creates and manages backup copies of all your important files. Instead of copying every file every time, FreeFileSync determines the differences between a source and a target folder and transfers only the minimum amount of data needed.
• Sync Gateway for Mac. Want to synchronize your Mac data with a PC? Install Sync Gateway to your Mac and set up a sync with it using Allway Sync in a few clicks! Strong SSL encryption, multiple connections and even no need to know the IP address. Free for personal use. Learn more about Sync Gateway » Download; Buy Pro.

By Migrating your ShareFile Sync Data, all of the folders that you have made available offline in ShareFile Sync will become available offline in Citrix Files and you will not need to re-download any data. NOTE:
Citrix Files for Mac must be installed before you can migrate your data. See Install and Use Citrix Files for Mac for more information.
The following steps cover two methods in transferring your data from ShareFile Sync to Citrix Files for Mac.

Sync Folders Pro Mac

1. Click the menu bar icon for Citrix Files.
2. Select the '...' then click Help menu.
3. From the Help menu select Migrate ShareFile Sync Data.

Migrating options

There are two ways to transfer data from ShareFile Sync to Citrix Files for Mac.

• Migrate - Data in your ShareFile Sync folder is moved over to Citrix Files for Mac. ShareFile Sync is uninstalled from your Mac automatically once this is completed.
• Copy - Data from your ShareFile Sync folder is copied over to Citrix Files for Mac, but not removed. The ShareFile Sync application is removed. It may be reinstalled and will not need to be reconfigured.

NOTE:
In ShareFile Sync, the ShareFile folder can be selected in the preferences. In Citrix Files for Mac, this data folder can also be configured in the preferences.

Managing your data

Making additional folders available offline

1. Go to Preferences.
2. Select Manage under Offline Sync. Another option is to right click on the files or folders and mark them as offline.

1. Select the folder for storage.

• The cache folder is named 'SFDriveMapper'. Please use the preferences menu to free up or remove data instead of deleting content directly.
• Choose a location that will always be available (an external hard drive is not recommended) -When you switch locations, the app will move data already in the cache to your new location.

Why would I use Citrix Files for Mac instead of Sync?

Access to all files
While you have an internet connection, you may see and open all files in your account. You are not limited to files that are available offline. Files you don't need offline access to are downloaded on-demand and kept temporarily to save space.
Network share & connector support
You may now access content stored in connectors such as Google Drive, OneDrive, etc. and Network Shares.
Sync individual files
You may right click on a file and make it available offline. Previously only folders could be marked as offline.
Approvals/Workflows
Right click on a file and initiate an approval.
Favorites
Right click on files to add or remove from Favorites.
Access file versions and file notes
Right click on a file and select View Details. From this menu you may access different versions of a file and add notes.

Migration FAQ

If I migrate/copy data does it have to be redownloaded?

No. Data is either copied or transferred directly from your sync folder.
What happens if there are files in my ShareFile sync folder that haven't been uploaded?
These files remain in your Sync Folder and are not deleted.
What happens if I quit Citrix Files for Mac while the migration is running?
Upon relaunch Citrix Files for Mac will attempt to restart the process.

No. Data is either copied or transferred directly from your sync folder.
What happens if there are files in my ShareFile sync folder that haven't been uploaded?
These files remain in your Sync Folder and are not deleted.
What happens if I quit Citrix Files for Mac while the migration is running?
Upon relaunch Citrix Files for Mac will attempt to restart the process.
Why is my migration is taking longer than expected?
Citrix Files needs to update account and file status in its databases in addition to copying/migrating data.
Can I reinstall ShareFile Sync after copying or migrating the data?
This depends on the option you have selected:

• Migrate - You must reconfigured ShareFile Sync and select a new folder location.
• Copy - Reinstall sync and it will continue to work as before.

File Syncing Software For Mac

-->

There are two basic ways that you, as an admin, can deploy the OneDrive sync app to Mac users in your organization:

• Have users install and set up the OneDrive sync app themselves by following the instructions in Sync files with OneDrive on Mac OS X. To install the OneDrive sync app for Mac, a user has to be administrator on the Mac or know an administrator account name and password.

• Download the installer package file to your local network, and then use your software distribution tools to deploy the app to your users. By using a software distribution tool, you have more control over the deployment, including which users get the sync app and when. The OneDrive sync app for Mac uses the Apple Installer technology for installation. This means you can use the software distribution tools that you normally use to deploy software to Mac users. You can use Microsoft Intune. Other common tools are Jamf Pro, Munki, and AutoPkg. You can also use Apple Remote Desktop and AppleScript.

File Syncing Software Mac

Manage OneDrive settings on macOS using property list (Plist) files

After the OneDrive sync app for Mac is installed, users can configure settings for the app. These settings are called preferences. As an admin, you might want to provide users in your organization with a standard set of preferences. Preferences for the OneDrive sync app for Mac are stored in preference files. These files are often referred to as .plist files.

Standalone	Mac App Store
PList Location	~/Library/Preferences/com.microsoft.OneDrive.plist	~/Library/Containers/com.microsoft.OneDrive-mac/Data/Library/Preferences/com.microsoft.OneDrive-mac.plist
Domain	com.microsoft.OneDrive	com.microsoft.OneDrive-mac

Configure sync app settings

Configure the settings on macOS in the typical way:

1. Quit the OneDrive application.

2. Define the settings you want to change by creating a Plist with the values, or use a script to set the default values.

3. Deploy the settings onto the local computer.

4. Refresh the preferences cache.

   On the next start of OneDrive, the new settings will be picked up.

Overview of settings

File Synchronize Mac

Use the following keys to preconfigure or change settings for your users. The keys are the same whether you run the standalone or Mac App Store edition of the sync app, but the property list file name and domain name will be different. When you apply the settings, make sure to target the appropriate domain depending on the edition of the sync app.

Setting	Description	Parameters	Example Plist Entry
Disable personal accounts	Blocks users from signing in and syncing files in personal OneDrive accounts. If this key is set after a user has set up sync with a personal account, the user will be signed out.	DisablePersonalSync (Bool): When set to true, this parameter prevents users from adding or syncing personal accounts.	DisablePersonalSync <(Bool)/>
Default folder location	Specifies the default location of the OneDrive folder for each organization	TenantID (String): TenantID determines which accounts the default folder location setting should apply to. Find your Microsoft 365 tenant ID DefaultFolderPath (String): DefaultFolder specifies the default folder location. Mac App Store: The path must already exist when users set up the sync app. Standalone: The path will be created on users' computers if it doesn't already exist. Only with the Standalone sync app can you prevent users from changing the location.	DefaultFolder Path (DefaultFolderPath) TenantId (TenantID)
Automatic upload bandwidth percentage	Enables the sync app to automatically set the amount of bandwidth used based on available bandwidth for uploading files	AutomaticUploadBandwidthPercentage (int): This parameter determines the percentage of local upload bandwidth that the sync app can use. Accepted values are from 1 through 99.	AutomaticUploadBandwidthPercentage (Bandwidth)
Set maximum upload throughput	Sets the maximum upload throughput rate in kilobytes (KB)/sec for computers running the OneDrive sync app	UploadBandwidthLimited (int): This parameter determines the upload throughput in KB/sec that the sync app can use. The minimum rate is 50 KB/sec and the maximum rate is 100,000 KB/sec.	UploadBandwidthLimited (Upload Throughput Rate in KB/sec)
Set maximum download throughput	Sets the maximum download throughput rate in kilobytes (KB)/sec for computers running the OneDrive sync app	DownloadBandwidthLimited (int): This parameter determines the download throughput in KB/sec that the sync app can use. The minimum rate is 50 KB/sec and the maximum rate is 100,000 KB/sec.	DownloadBandwidthLimited (Download Throughput Rate in KB/sec)
Dock icon	Specifies whether a dock icon for OneDrive is shown	HideDockIcon (Bool): When set to true, this parameter hides the OneDrive dock icon even when the application is running.	HideDockIcon <(Bool)/>
Open at login	Specifies whether OneDrive starts automatically when the user logs in	OpenAtLogin (Bool): When set to true, OneDrive will start automatically when the user logs in on the Mac.	OpenAtLogin <(Bool)/>
Enable Files On-Demand	Specifies whether Files On-Demand is enabled. If you don't set this setting, Files On-Demand will be enabled automatically as we roll out the feature, and users can turn the setting on or off	FilesOnDemandEnabled (Bool): When set to true, new users who set up the sync app will download online-only files by default. When set to false, Files On-Demand will be disabled and users won't be able to turn it on.	FilesOnDemandEnabled <(Bool)/>
Disable download toasts	Prevents toasts from appearing when applications cause file contents to be downloaded	DisableHydrationToast (Bool): When set to true, toasts will not appear when applications trigger the download of file contents.	DisableHydrationToast <(Bool)/>
Block apps from downloading online-only files	Prevents applications from automatically downloading online-only files. You can use this setting to lock down applications that don't work correctly with your deployment of Files On-Demand.	HydrationDisallowedApps (String): Json in the following format [{'ApplicationId':'appId','MaxBundleVersion':'1.1','MaxBuildVersion':'1.0'}] 'AppID' can be either the BSD process name or the bundle display name. MaxBuildVersion denotes the maximum build version of the application that will be blocked. MaxBundleVersion denotes the maximum bundle version of the application that will be blocked	HydrationDisallowedApps [{'ApplicationId':'appId','MaxBundleVersion':'1.1','MaxBuildVersion':'1.0'}, {'ApplicationId':'appId2','MaxBundleVersion':'3.2','MaxBuildVersion':'2.0'}] <(Bool)/>
SharePoint Server Front Door URL	Specifies the SharePoint Server 2019 on-premises URL that the OneDrive sync app should try to authenticate and sync against	SharePointOnPremFrontDoorUrl (string): The URL of the on-premises SharePoint Server.	SharePointOnPremFrontDoorUrl https://Contoso.SharePoint.com
SharePoint Server Tenant Name	Specifies the name of the folder created for syncing the SharePoint Server 2019 files specified in the Front Door URL.	SharePointOnPremTenantName (string): The name that will be used when creating a folder to sync the on-premises SharePoint Server files. If specified, the folder names will take the form of: OneDrive – TenantName TenantName If not specified, the folder names will use the first segment of the FrontDoorURL as the Tenant Name. Example - https://Contoso.SharePoint.com will use Contoso as the Tenant Name	SharePointOnPremTenantName Contoso
SharePoint OnPrem Prioritization	For hybrid scenarios where the email is the same for both SharePoint Server on-premises and SharePoint in Microsoft 365, determines whether or not the client should set up sync for SharePoint Server or SharePoint in Microsoft 365 first during the first-run scenario.	SharePointOnPremPrioritizationPolicy (int): This parameter determines which service to attempt to authenticate against for setting up sync. 1 indicates OneDrive should set up SharePoint Server on-premises first, followed by SharePoint in Microsoft 365.	SharePointOnPremPrioritizationPolicy (0 or 1)
Allow syncing OneDrive accounts for only specific organizations	This setting lets you prevent users from easily uploading files to other organizations by specifying a list of allowed tenant IDs. If you enable this setting, users get an error if they attempt to add an account from an organization that is not allowed. If a user has already added the account, the files stop syncing. This setting takes priority over Block syncing OneDrive accounts for specific organizations. Do not enable both settings at the same time.	TenantID (String): TenantID determines which tenants the allow tenants list setting should apply to. Set the bool to True to allow the tenant to sync. Find your Microsoft 365 tenant ID	AllowTenantList TenantId1 True TenantId2 True
Block External Sync	Prevents the sync app from syncing libraries and folders shared from other organizations.	BlockExternalSync (Bool): Set to true to prevent syncing OneDrive and SharePoint libraries and folders from organizations other than the user's own organization. Set to false or do not include the setting to allow. Learn about OneDrive B2B Sync.	BlockExternalSync <(Bool)/>
Disable the tutorial that appears at the end of OneDrive Setup	This setting lets you prevent the tutorial from showing at the end of OneDrive Setup.	DisableTutorial (Bool): When set to true, users will not see the tutorial after they complete OneDrive Setup.	DisableTutorial <(Bool)/>
Block syncing OneDrive accounts for specific organizations	This setting lets you prevent users from uploading files to another organization by specifying a list of blocked tenant IDs. If you enable this setting, users get an error if they attempt to add an account from an organization that is blocked. If a user has already added the account, the files stop syncing. This setting does NOT work if you have Allow syncing OneDrive accounts for only specific organizations enabled. Do not enable both settings at the same time.	TenantID (String): TenantID determines which tenants the block tenants list setting should apply to. Set the bool to True to disable the tenant from syncing. Find your Microsoft 365 tenant ID	BlockTenantList TenantId1 True TenantId2 True

You can also configure the OneDrive Standalone sync app to receive delayed updates.

PList Location	~/Library/Preferences/com.microsoft.OneDriveUpdater.plist
Domain	com.microsoft.OneDriveUpdater

Setting	Description	Parameters	Example Plist Entry
Tier	Defines the update ring for the computer	UpdateRing (String): This parameter has two different values. Production - The default update ring for OneDrive updates. Insiders - This update ring receives updates that are 'pre-production' and will allow you to play with features before they are released. Note that builds from this ring may be less stable. Enterprise - This update ring (now called 'Deferred') receives updates after they have rolled out through the Production ring. It also lets you control the deployment of updates. For more info about the update rings and how the sync app checks for updates, see The OneDrive sync app update process.	Tier (UpdateRing)