Getting Started

Licensing ServiceControl

Component: ServiceControl
Version: 4.x

There are a few options to add a license to ServiceControl.

ServiceControl Management tool

ServiceControl has a license user interface which can be accessed in ServiceControl Management.

ServiceControl Management is installed together with ServiceControl and can be found in the Windows Start Menu.

The designated license file will be imported into the file system at %ProgramData%\ParticularSoftware\license.xml so it is available to all instances of ServiceControl regardless of the service account used.

A copy of the imported license will be added to the HKEY_LOCAL_MACHINE registry hive for backward compatibility with older instances of ServiceControl.

ServiceControl PowerShell

To import a license using PowerShell:

Import-ServiceControlLicense License.xml

License from file system

It is also possible to load the license from the file system but this must be done manually. This allows the license to be loaded from (for example) a central network share instead of the registry.

Add the NServiceBus/LicensePath application setting to the ServiceControl.exe.config configuration file.

<add key="NServiceBus/LicensePath" value="d:\NServiceBus\License\License.xml" />

Using other platform tools

See the ServiceInsight licensing page for more information.

Instance licensing

In Versions 1.17 and below, a license can be applied to an individual instance rather than using a license installed in the registry. To do this, copy the license.xml file to a license directory under the installation path of the instance.


ServiceControl license was updated, but ServicePulse reports the license has expired

License information is read at service startup and cached for 8 hours. Therefore, either wait for the cache to expire or restart the ServiceControl instance manually to have ServicePulse reflect the new license.