Behavior
The license is read at startup, and every 8 hours thereafter to detect license updates.
Expired license
If the license has expired (or is corrupted), existing ServiceControl instances will continue to function and can be started and stopped normally. Functionality in ServicePulse will be limited to functionality that supports license renewal.
License management
In general, ServiceControl instances support all of the license management options that NServiceBus supports, except for code-first configuration and the Windows Registry.
When using the user specific license location ensure that the account under which the ServiceControl instance is running has permissions to access the user folder.
In addition, ServiceControl provides additional license management techniques:
ServiceControl Management Utility (SCMU)
ServiceControl has a license user interface accessible in ServiceControl Management, which is a Windows only management utility.
If the ServiceControl Management Utility was not retained after instance installation, a new version can be downloaded to manage license files. The Management Utility itself is not installed; it exists as a standalone application for managing ServiceControl instances.
The selected license file will be stored in the machine-wide license file location, so it is available to all instances of ServiceControl regardless of the service account used.
ServiceControl PowerShell
To import a license using PowerShell:
- Start PowerShell
- Ensure ServiceControl PowerShell Module is installed.
- 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 any location in the file system by configuring the NServiceBus/ setting. This allows the license to be loaded from, for example, a central network share instead of the registry.
The easiest way to find the configuration file, on Windows, is to launch the Service Control Management Utility (SCMU), navigate to the relevant 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 7 or lower endpoint. This license configuration option is no longer supported in NServiceBus 8 or later endpoints.