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.
If the ServiceControl Management application was not retained when installing instances, a new version can be downloaded to manage license files.
The designated license file will be imported into the file system at %ProgramData%\ 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:
- Start PowerShell from the start menu, ensure ServiceControl PowerShell Module is loaded
- Execute the following cmdlet with the path to the license file.
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/ application setting to the ServiceControl. configuration file.
The easiest way to find the configuration file is by launching the Service Control Management Utility (SCMU), navigate to the relavant instance and open its deployment paths.
<add key="NServiceBus/LicensePath" value="d:\NServiceBus\License\License.xml" />
This is the same setting to configure a license path for an NServiceBus 5 endpoint.
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. file to a license directory under the installation path of the instance.
Instance Licensing is deprecated in Version 1.18 and above. Use ServiceControl Management or the ServiceControl PowerShell module to install the license file to the registry.
Troubleshooting
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.