Implement the First Sync Package

The First Sync Package (in short: FSP) can be used to make the first synchronization on the user devices faster.

It contains binary data for empower^® and therefore reduces the data to be synchronized to a minimum.

After creating the First Sync Package in the empower^® Admin Center, you need to distribute the package to all relevant devices.

To distribute the First Sync Package, it must be stored under an accessible path for all users. Therefore, it should be distributed via the payload folder for your empower^® Installation.

By default, empower^® searches under the following path:

%LocalAppData%\empower 

In the payload folder, the First Sync Package must be stored in the folder data.

If you have created the First Sync Package yourselves via the empower^® Admin Center, make sure to store the file accordingly.

If the payload folder is used to distribute the First Sync Package, the package is automatically stored under the above-mentioned default path during installation.

After the first synchronization, the First Sync Package is automatically deleted.

If you do not want to distribute the First Sync Package via the payload folder but place it under a custom path, you need to specify this custom path in the file RemoteServiceConfig.xml.

To specify the respective path for the synchronization, open the file RemoteServiceConfig.xml.

This file is part of the payload folder which is provided to you along with the installation package. It is stored in the folder data.

Add the following setting to the .xml file and specify the respective path:

<MachineSyncPackagePath>[PATH TO FIRST SYNC PACKAGE]</MachineSyncPackagePath>   

The following excerpt provides an example for the configuration with a specified path:

<?xml version="1.0" encoding="utf-8"?>
<ServerConfiguration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                     xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <MachineSyncPackagePath>[PATH TO FIRST SYNC PACKAGE]</MachineSyncPackagePath>
    <ActiveServerEndpoint>[ACTIVE SERVER ENDPOINT]</ActiveServerEndpoint>
    <ServerBaseUrl>[BASE URL]</ServerBaseUrl>
    <ServerEndpoint>
        <ServerName>[SERVER NAME]</ServerName>
        <ServerRoute>[SERVER ROUTE]</ServerRoute>
        <DisableAutoDiscovery>false</DisableAutoDiscovery>
    </ServerEndpoint>
</ServerConfiguration>

If the First Sync Package is stored on a network drive where users who use empower^® have writing permissions, the writing protection should be enabled for the file.

Otherwise, the First Sync Package will automatically be deleted after the first user with writing permissions has finished the synchronization.

When all users have finished their first synchronization, remove the writing protection to enable the automatic deletion.