License Management

In Data Refinery Workbench (DR Workbench) UI or DR Workbench API, a user can install a DR Workbench license. The purpose of the license is to regulate a client’s access for using the product. To install a license, a user must have the CONFIG_ADMIN permission which can be granted by users with the USER_ADMIN permission.

Kingland clients can sample DR Workbench in trial mode without a license. They can upgrade their product by inputting a new License Key in DR Workbench. This method offers a seamless upgrade for full access to DR Workbench. The following instructions will walk through installing, monitoring, and managing a DR Workbench License.

Table of contents

Trial Mode

DR Workbench offers a Trial Mode for users to sample DR Workbench without a license. The application may also enter Trial Mode if the installed license becomes invalid or expired. While in Trial Mode, some functionalities are limited:

  • SSO authentication is disabled
  • Resources are limited to 5 Users, 5 Entity Types, 5 Active Workflow Definitions, and 50 Active Live Data Objects.
    • For each resource type, if the amount reaches the limit, then no new resources can be created.
    • For each resource type, if the amount exceeds the limit, then they become read-only.
    • Resources can still be deleted after the limit is reached or exceeded.
    • Each resource type is limited individually.

Endpoints limited by Trial Mode:

Endpoint HTTP Method Affected By Resource Limit
/api/data POST, PUT Yes
/api/data GET No
/api/data/:dataObjectID DELETE No
/api/data/search POST No
/api/definitions/workflows POST, PUT Yes
/api/definitions/workflows GET No
/api/definitions/workflows/:definitionID DELETE No
/api/entitytypes POST, PUT Yes
/api/entitytypes GET No
/api/entitytypes/:entityTypeID/ DELETE No
/api/entitytypes/:entityTypeID/attributetypes POST, PUT Yes
/api/users POST, PUT Yes
/api/users GET No
/api/users DELETE No
/api/v2/users GET No
/api/users/:ID/password PUT No
/api/users/logout POST No

How to Install a License in Workbench

To reiterate, only a user with the CONFIG_ADMIN permission can install a license in DR Workbench. To acquire the CONFIG_ADMIN permission, a USER_ADMIN must grant the permission to the user. For more information, refer to the Permissions and Groups page.

  1. Once logged in to DR Workbench with the CONFIG_ADMIN permission, the top right corner of the screen will display a cog icon to the right of the user’s name. Click the icon.

  2. By clicking once, a box will appear below the cog and the username. Hovering the cursor over the box will underline the button “Manage Data Refinery Workbench License.” Click Manage Data Refinery Workbench License to continue.

    A new page will load displaying the License Management page. This page will display the status of the DR Workbench license currently in use.

  3. To update the license, a Kingland customer support lead should have provided the Customer ID and License Key to the assigned CONFIG_ADMIN. Type the Customer ID in the Customer ID field.

    License Management Page

    Note. The Customer ID will only contain numbers.

  4. Then, type or paste the License Key into the License Key box.

    Alternatively, the CONFIG_ADMIN has the choice of uploading the License Key as a file. A Kingland customer support lead may provide a License Key file directly to the CONFIG_ADMIN for upload. The only information in the file MUST be the License Key to install the license.

    Only one input method is allowed to enter the License Key.

  5. Select the Install License button when the fields have been completed.

    Install License Button

    Caution. Installing a new license will overwrite the existing Data Refinery license.

If the install process was successful, a green banner will appear at the top of the License Management page.

License Successful Banner

DR Workbench should refresh the license status at the top of the page to reflect that the license has been installed and pending validation. This license status should also reflect the expiration date of the DR Workbench license.

If the install process was unsuccessful, a red banner will appear at the top of the License Management page. No changes to DR workbench would have been made.

License Failure Banner

Refer to the DR Workbench API Documentation for more information on installing a license.

License Monitoring in Workbench

DR Workbench offers a few ways for UI and API users to monitor the current Licensing status.

UI Status Messages

The License Management page will display the license status at the top of the page. This status indicates to the CONFIG_ADMIN the authorization of DR workbench or if any potential action needs to be taken for authorization. Read the list of status messages below for explanations of each status.

  • Installed and Valid
    • Successful license installation, authorization approved.
  • Installed and Pending Validation
    • Successful license installation, but awaiting authorization.
  • Licensing Server Unreachable - $Days Remaining
    • DR Workbench cannot connect to the license server.
    • $Days is the number of days before entering Trial Mode.
  • Validation Failed
    • The License Key was entered incorrectly, or an old key was used.
  • Not Installed
    • The License Key or Customer ID was entered incorrectly.
  • Expired
    • The license needs to be updated to restore full access and authorization.
  • Expires Soon
    • The license needs to be updated before access becomes limited.

Regardless of the license status, the expiration of the current license will be displayed.

Application Behaviors

Depending on the license status, DR Workbench will behave differently for users. The following list explains the most common scenarios regarding DR Workbench licensing.

  • Without a license,
  • When a license has exceeded its expiration date,
    • DR Workbench will not enter Trial Mode immediately, but will notify users via UI and API that the current license is expired. Contact Kingland customer support to renew the license.
  • When a license can’t be validated,
    • After 14 days, DR Workbench will transition to Trial Mode.

Depending on the license status, the entitlements may change. The entitlements, or limit to the number of resources a customer can have in DR Workbench, is sent to the license server. For example, if DR Workbench transitions from Trial Mode to full operational status, the entitlements will most likely increase. The license server receives the following information,

  • Number of Users
  • Number of Active Workflow Definitions
  • Number of Entity Types
  • Number of Active Live Data Objects

Only the numbers of these resources are recorded and sent to the license server for tracking entitlements.

License Status API

For users of the DR Workbench API, an endpoint GET /license/status is available to query for the current license status and resource limitations. This endpoint is available to all users, and provides the following information:

  • Trial: Whether DR Workbench is in Trial Mode.
  • Status: The current licensing status.
  • IsLimited: Current resource limitation state, 0 indicates below limit, 1 indicates at limit, and 2 indicates above limit.

Example output:

{
  "Trial": false,
  "Status": "OK",
  "IsLimited": {
    "Project": 0,
    "Source": 1,
    "Task": 2
  }
}

Visit the DR Workbench API Documentation for more details.

How to Update a License in Workbench

A DR Workbench license would need to be updated if the current license was a trial or a Kingland client renewed their subscription. A CONFIG_ADMIN user would have the correct permissions to make this change.

  1. After logging in to DR Workbench, select the cog icon in the top right corner of the page. Click Manage Data Refinery Workbench License to continue.

  2. Type the Customer ID into the Customer ID field.

    License Management Page

  3. Then, type or paste the new License Key into the License Key box.

    Alternatively, upload a file containing the new License Key.

  4. Select the Install License button once the fields are complete.

    Install License Button

    Caution. Installing a new License Key will overwrite the existing DR Workbench license.

If the install process was successful, a green banner will appear at the top of the License Management page.

License Successful Banner

DR Workbench should refresh the license status at the top of the page to reflect that the new license has been installed and pending validation. This license status should also reflect the new expiration date of the DR Workbench license.

If the install process was unsuccessful, a red banner will appear at the top of the License Management page. No updates to DR Workbench would have been made.

License Failure Banner

Refer to the DR Workbench API Documentation for more information on installing a license.

Copyright © 2025 Kingland Systems LLC