Synergy .NET Requirements

This topic lists basic requirements for developing and deploying Synergy .NET assemblies. It includes the following sections:

Development system requirements

To develop with Synergy .NET, you will need a Windows development machine with Visual Studio, Synergy/DE, and Synergy DBL Integration for Visual Studio (SDI). For details on these and other System requirements, see www.synergex.com/synergy-dbl-integration.

Application requirements

A Visual Studio solution that includes one or more Synergy projects must have a reference to Synergy runtime libraries and must use Synergy licensing. These requirements are discussed below. For framework-specific requirements and development information, see the following topics:

Synergy runtime and build libraries

Every Visual Studio solution that has a Synergy .NET project must have a reference to Synergy runtime libraries, either the synrnt library distributed with Synergy/DE or the Synergex.SynergyDE.synrnt NuGet package. Synergy project templates automatically include this reference.

The Synergex.SynergyDE.synrnt and Synergex.SynergyDE.Build NuGet packages are downloaded to a local NuGet repository when SDI is installed. These packages are used for new projects created from .NET Core and .NET Standard templates. Visual Studio checks the NuGet site for updates, and when a package on the NuGet site is updated, you can use the NuGet Package Manager to update the package for a project.

Licensing .NET assemblies

Synergy .NET assemblies (executables and class libraries) require either traditional Synergy licensing or Synergy device licensing (which uses a cloud service for licensing).

To use device licensing, your application must have a device licensing implementation. See Device Licensing.

If your application uses traditional Synergy licensing and the target machine has not been configured for local Synergy licensing, you must specify a license server in the App.config file or with the SynergyLicenseServer environment variable. (See Runtime Settings page of Visual Studio project properties (Synergy .NET) and SynergyLicenseServer.) For example, if you deploy a .NET Core assembly to a machine that doesn't have Synergy/DE, you will need to set SynergyLicenseServer in the environment — e.g., in the launch configuration file for the .NET Core application — because App.config files are not used for .NET Core.

Tip

You can implement a cloud version of traditional Synergy licensing by running a Synergy license server machine on an Azure virtual network (VNet). (The machine doesn't need to be powerful; it can have very little RAM, a small CPU, etc.) Then, on every machine that needs Synergy licensing, set the SynergyLicenseServer environment variable to the Synergy license server. With this setup, you can support a scalable, flexible licensing environment that can work with a large number of license client machines or with varying numbers of machines that need varying numbers of licenses. For example, you can use this kind of setup to support Docker services.

Deployment system requirements

To deploy a Windows .NET Framework application, the target Windows system must have the following (see www.synergex.com/synergy-dbl-integration for information on required versions of these products):

With ClickOnce deployment, it is possible to deploy a .NET Framework application to Windows machines that do not have Synergy/DE, but this is not supported. See ClickOnce Deployment for Synergy .NET for more information.

To deploy a .NET Core application, either the target Windows system must have .NET Core, or the deployment must be self-contained. If the target system for a self-contained deployment has a version of Windows prior to Windows 10 or Server 2016, make sure Windows is up to date and includes the Update for Universal C Runtime in Windows. For more information on .NET Core deployments, see Microsoft documentation (e.g., .NET Core application deployment).

To deploy to a Linux application, the target system must have Mono.

To deploy a UWP application with a Synergy .NET Standard library, the target system must have a Windows 10 operating system (e.g., Windows 10 Mobile).

Using synrnt on Linux systems

On Linux systems, you must manually add the synrnt runtime library (located in dbl/bin) to the global assembly cache or make sure it is in the same folder as your application binaries. To add synrnt to the global assembly cache, use the following command:

sudo GACUTIL -i synrnt.dll