Installing Sync Framework

Sync Framework enables you to install components for development by using the SDK installation package. The package name is SyncSDK-v2.1-x86-ENU.msi for the English version for x86 platforms; the names for other versions will differ. Download the installation package from the Microsoft Download Center, and follow the installation instructions from that site. Sync Framework 2.1 supports side-by-side install with Sync Framework 2.0 and Sync Framework 1.0. Redistributable components are provided in a set of separate packages. This lets you tailor the installation to application requirements. For more information about redistribution, see Redistributing Sync Framework.

On an x86 platform, the x86 installation package installs the following components into Program Files\Microsoft SDKs\Microsoft Sync Framework\2.1, and adds managed DLLs to the global assembly cache (GAC). On an x64 platform, both the x86 and the x64 installation package install into Program Files (x86)\Microsoft SDKs\Microsoft Sync Framework\2.1. Other combinations of platform and installation package may yield slight variations on the installation path.

Component

Description

Install Location

Microsoft.Synchronization.Data.dll, Microsoft.Synchronization.Data.Server.dll, Microsoft.Synchronization.Data.SqlServer.dll, and Microsoft.Synchronization.Data.SqlServerCe.dll (see version note below this table)

Managed API for database synchronization providers (also requires Microsoft.Synchronization.dll). For more information, see Synchronizing Databases.

\Runtime\ADO.NET\V3.1\x86

\Runtime\ADO.NET\V3.1\x64

Microsoft.Synchronization.dll, Synchronization21.dll, and FeedSync21.dll

Managed and native API for the synchronization runtime, core components, and Web synchronization components. For more information, see Synchronizing Data Stores by Using Custom Providers and Synchronizing Web Feeds.

\Runtime\x86

\Runtime\x64

Microsoft.Synchronization.MetadataStorage.dll and MetaStore21.dll; and Msfdb.dll, Msfdbqp.dll, and Msfdbse.dll

Managed and native API for the metadata storage service; and DLLs for the lightweight database that the service uses. For more information, see Sync Framework Metadata Storage Service.

\Runtime\x86

\Runtime\x64

Microsoft.Synchronization.SimpleProviders.dll and SimpleProviders21.dll

Managed and native API for simple custom providers. For more information, see Implementing a Simple Custom Provider.

\Runtime\x86

\Runtime\x64

Microsoft.Synchronization.Files.dll and FileSyncProvider21.dll

Managed and native API for the file synchronization provider. For more information, see Synchronizing Files.

\Runtime\x86

\Runtime\x64

*.pdb files

Symbols to use during debugging.

\Symbols\x86

\Symbols\x64

*.h files

Header files that contain declarations needed for writing unmanaged code.

\include

*.lib files

Import libraries for compiling unmanaged code.

\lib\x86

\lib\x64

SyncSDK_v21.chm

Documentation for all Sync Framework components.

\Documentation\<LCID>

Sample files

Samples that demonstrate Sync Framework functionality.

\Samples

SyncSDKEula.rtf

License agreement for using Sync Framework.

\License Agreements

Note

The database provider classes in the Microsoft.Synchronization.Data.SqlServerCe namespace require SQL Server Compact 3.5 SP2.

Component Versions and Folder Locations

The database provider assemblies have a different version number than the version number of the Sync Framework release. This is because Microsoft.Synchronization.Data.SqlServerCe.dll was originally released before Sync Framework 1.0, as part of SQL Server Compact. In that release, Microsoft.Synchronization.Data.SqlServerCe.dll had a version number of 3.5 to match the SQL Server Compact version. When the database providers were first released as part of Sync Framework, they were given a version of 2.0 to show that they had been released previously. The following table lists the released versions of Sync Framework along with the version numbers of the major components and the processor architectures supported for each release.

Product name

Core components version

Provider services version

Database providers version

Supported architectures

Sync Framework 1.0

1.0

1.0

2.0

x86, x64, ia64

Sync Framework 2.0

2.0

2.0

3.0

x86, x64, ia64

Sync Framework 2.1

2.1

2.1

3.1

x86, x64

All of the components listed in the previous table are installed when the Sync Framework SDK is installed. The default root location for SDK installs is: Program Files\Microsoft SDKs\Microsoft Sync Framework on x86 platforms and Program Files (x86)\Microsoft SDKs\Microsoft Sync Framework on x64 platforms.

Each of the major component groups can also be installed or redistributed separately. The default root location for redistributable installs is: Program Files\Microsoft Sync Framework on x86 platforms. For more information about redistributing Sync Framework assemblies, see Redistributing Sync Framework.

The following tables list the assemblies contained in each redistributable package, and the version and installation path (relative to the root installation path) for each package. The parameter <arch> is used in place of a particular processor architecture, such as x86. The parameter <lang> is used in place of a three-character language identifier, such as ENU for English.

Core components package

Redistributable package name

Redistributable package filename

Package version

Assembly names

Assembly version

Installation path

Microsoft Sync Framework Runtime v1.0

Synchronization.msi

1.0

Microsoft.Synchronization.dll

Synchronization.dll

FeedSync.dll

1.0.0.0

v1.0\Runtime\<arch>

Microsoft Sync Framework 2.0 Core Components

Synchronization-v2.0-<arch>-<lang>.msi

2.0

Microsoft.Synchronization.dll

Synchronization2.dll

FeedSync2.dll

2.0.0.0

2.0\Runtime\<arch>

Microsoft Sync Framework 2.1 Core Components

Synchronization-v2.1-<arch>-<lang>.msi

2.1

Microsoft.Synchronization.dll

Synchronization21.dll

FeedSync21.dll

2.1.0.0

2.1\Runtime\<arch>

Provider services package

Redistributable package name

Redistributable package filename

Package version

Assembly names

Assembly version

Installation path

Microsoft Sync Framework Services v1.0

ProviderServices.msi

1.0

Microsoft.Synchronization.MetadataStorage.dll

Microsoft.Synchronization.Files.dll

Metastore.dll

Msfdb.dll

Msfdbqp.dll

Msfdbse.dll

FileSyncProvider.dll

1.0.0.0

v1.0 Runtime\<arch>

Microsoft Sync Framework 2.0 Provider Services

ProviderServices-v2.0-<arch>-<lang>.msi

2.0

Microsoft.Synchronization.MetadataStorage.dll

Microsoft.Synchronization.Files.dll

Microsoft.Synchronization.SimpleProviders.dll

Metastore2.dll

Msfdb.dll

Msfdbqp.dll

Msfdbse.dll

SimpleProviders2.dll

FileSyncProvider2.dll

2.0.0.0

2.0\Runtime\<arch>

Microsoft Sync Framework 2.1 Provider Services

ProviderServices-v2.1-<arch>-<lang>.msi

2.1

Microsoft.Synchronization.MetadataStorage.dll

Microsoft.Synchronization.Files.dll

Microsoft.Synchronization.SimpleProviders.dll

Metastore21.dll

Msfdb.dll

Msfdbqp.dll

Msfdbse.dll

SimpleProviders21.dll

FileSyncProvider21.dll

2.1.0.0

2.1\Runtime\<arch>

Database providers package

Redistributable package name

Redistributable package filename

Package version

Assembly names

Assembly version

Installation path

Microsoft Sync Services for ADO.NET v2.0

SyncServicesADO.msi

2.0

Microsoft.Synchronization.Data.dll

Microsoft.Synchronization.Data.Server.dll

Microsoft.Synchronization.Data.SqlServerCe.dll

2.0.0.0

v1.0\Runtime\ADO.NET\V2.0\<arch>

Microsoft Sync Framework 2.0 Database Providers

DatabaseProviders-v3.0-<arch>-<lang>.msi

3.0

Microsoft.Synchronization.Data.dll

Microsoft.Synchronization.Data.Server.dll

Microsoft.Synchronization.Data.SqlServer.dll

Microsoft.Synchronization.Data.SqlServerCe.dll

3.0.0.0

2.0\Runtime\ADO.NET\V3.0\<arch>

Microsoft Sync Framework 2.1 Database Providers

DatabaseProviders-v3.1-<arch>-<lang>.msi

3.1

Microsoft.Synchronization.Data.dll

Microsoft.Synchronization.Data.Server.dll

Microsoft.Synchronization.Data.SqlServer.dll

Microsoft.Synchronization.Data.SqlServerCe.dll

3.1.0.0

2.1\Runtime\ADO.NET\V3.1\<arch>

See Also

Concepts

Installation, Redistribution, and Version Compatibility