How troubleshoot custom licenses used by a Spotfire® extension

Introduction

In some cases even if a custom license is disabled in the Administration Manager, the user can still access the extension.

This article will describe a number of different reasons behind issues with custom licenses and their solutions.

The custom license is not initialized correctly in the code

There are two ways a license can be added. In the ends this depends on the extension type.

Using the AddIn registrar

   registrar.Register(MyTypeIdentifiers.MyDataSourceIdentifier, Licenses.Functions.MyDataSourceLicense); 

In the class constructor

Note: See NavigateToPage example in the Spotfire® SDK examples

   public NavigateToPageTool() : base(NavigateToPageResource, DeveloperLicense.Functions.NavigateToPage) 

Extension is not deployed to the Spotfire server

Licenses only work when the extension is deployed on the Spotfire Server. That means that this cannot be tested when running the extension locally (debugging mode). The license itself also needs to be set on the groups that the logged in is a member of and have the relevant license set. One confusing thing is that the license will still be visible from the Administration Manager and can be enabled/disabled but will have no effect until the extension is deployed on the server.

The license is not enabled for the correct user and/or group

How to set the custom license:

References

1. Open "Administration Manager".
2. Search for the user on the first tab.
3. Select the user on the list and click on the "Licenses" tab on the right side.
4. Expand the "Spotfire Extensions" item.
5. Examine "Set for Group" to see where the user gets the license from if needed.
6. Change the license on all groups that appear in step 5.
7. Restart Spotfire.

• Wiki: Licensing
• API Reference: CustomLicense Class