Apply a DataRobot license¶

This page explains how to apply a DataRobot license using either the application interface or the DataRobot API. Note that this workflow is exclusive to administrators, and requires you to be logged into DataRobot with admin permissions.

Apply a license in the DataRobot application¶

1. Access the DataRobot cluster in your browser.

2. Click the profile icon in the top-right corner of the page and select License.

   

3. On the License page, enter the license key in the field and click Validate.

   

4. After validating, DataRobot lists the features and functionality included in the subscription (blurred in the image below).

   

5. Confirm that the validated license lists the correct subscription features, then click Submit.

Seat licenses¶

Seat licenses allow you to grant users specific permissions based on the number of individual licenses purchased for your organization. To apply any seat license(s) to user accounts:

1. From the License page accessed in the previous section, click the Seat License section.

   

2. Click Allocate seats in the resulting table.

   

3. In the Allocate seats modal, enter a name for your organization and specify the number of seats to be allocated.

   

The seats are now allocated to your organization but remain unassigned. See Assign seat licenses to users.

Apply a license via the API¶

Alternatively, administrators can validate a DataRobot license using DataRobot's REST API. To do so, provide your information in the snippet below and execute a REST API call.

# Set the URI of the DataRobot App node
# Ex. https://datarobot.example.com
# Ex. http://10.2.3.4
dr_app_node="http://10.2.3.4"

# If you have a username and password, start here
# Set the initial username
admin_username=localadmin@datarobot.com

# Set the local administrator user password
admin_password=""

# Read the license
ldata=$(cat ./license.txt)

# Apply the license with the following commands

# Log in to the App Node
curl --silent -X POST \
  --cookie "/tmp/cookies.txt" \
  --cookie-jar "/tmp/cookies.txt" \
  -H "Content-Type: application/json" \
  -d '{"username":"'"${admin_username}"'","password":"'"${admin_password}"'"}' \
  ${dr_app_node}/account/login

# Get an API key
api_key=$(curl --silent -X POST \
  --cookie "/tmp/cookies.txt" \
  --cookie-jar "/tmp/cookies.txt" \
  -H "Content-Type: application/json" \
  -d '{"name":"apiKey"}' \
  ${dr_app_node}/api/v2/account/apiKeys/ | cut -d ',' -f 5 | cut -d '"' -f 4)

# Apply the license
curl --silent -w "%{http_code}\n" -X PUT \
  -H "Content-Type: application/json" \
  -H "HTTP/1.1" \
  -H "Authorization: Token ${api_key}}" \
  -d '{"licenseKey":"'"${ldata}"'"}' \
  ${dr_app_node}/api/v2/clusterLicense/

# Expected output: 200