How to verify license entitlements and related errors

Related to Copied

Bootstrap License expired, Licence has expired, Licence limit breached, Licence expiration status unknown, license manager, licenced

Problem Copied

ITRS Analytics includes a temporary bootstrap licence during initial installation. Users are advised to update the license file within the grace period. This article provides the procedure to verify the ITRS Analytics licenses and related errors.

Possible Causes Copied

• Root Cause 1:

License key has not been applied within the grace period after initial installation. User may see this error message on ITRS Analytics web console.

Bootstrap License expired

• Root Cause 2:

The license key has not been renewed before license expiry. User may see this error message on ITRS Analytics web console.

Licence has expired

• Root Cause 3:

User may have exceeded the limit of their ITRS Analytics license entitlements. User may see this error message on ITRS Analytics web console.

Licence limit for <component> breached

• Root Cause 4:

ITRS Analytics components may have encountered errors when connecting “licenced” process. User may see this error message on ITRS Analytics web console.

Licence expiration status unknown

In certain cases, it may fall back to the default and return this error.

Bootstrap License expired

Possible Solutions Copied

• Solution Root Cause 1 to 3:

Please follow the below steps to verify a valid license file has been applied to ITRS Analytics.

1. Logon to the ITRS Analytics web console as a user with admin permissions.

2. The Admin button should appear near the bottom left of the toolbar.

3. Select the Licence tab

4. The license expiry and entitlements should appear on this page.

5. If user needs changes to the license expiry or entitlements, please contact your ITRS account manager or raise a support request. Please provide the displayed instance name (which should usually be the hostname or DNS name) so we can verify or update our records.

6. When user obtains the license file, select the Upload Licence button near the top right corner to apply it.

• Solution Root Cause 4:

1. User can check if the “licenced” pod is up and running.

kubectl get deployment licenced -n kotsadm

2. Obtain the exact name of licenced pod, then retrieve the logs.

kubectl get pods -n kotsadm | grep licenced
kubectl logs licenced-<id-string> -n kotsadm

3. If the log shows errors or looks stale (the log is expected to update regularly every hour), please submit a support request providing a support bundle. User may want to restart the “licenced” or related pods using “kubectl” commands.

Related Articles Copied

• ITRS Analytics - Admin Settings
• ITRS Analytics - Support Bundles