Upload a License

Exasol deployments start with a license that allows you to load 10 GB of raw data for testing purposes. For larger data sizes, you must upload a license.

Prerequisites

Download a valid Exasol 8 license file to your local system.

Exasol 8 uses a new license format, which means that Exasol 7.1 licenses will not work in Exasol 8. For more information, contact support.

Procedure

This procedure can be carried out using the Administration API.

The examples in this procedure are written using Bash on a Linux terminal. You can also use other interfaces and languages to execute the curl commands.

Placeholder values are styled as Bash variables, starting with the dollar sign ($) and using UPPERCASE characters. Replace the placeholders with your own values before executing the curl command.

To upload a license, send a POST request to the /api/v1/license endpoint. For example:

curl -X 'POST' \
  -k "https://$EXASOL_IP/api/v1/license" \
  -H "accept: application/json" \
  -H "Authorization: Basic $AUTH_TOKEN" \
  -H "Content-Type: application/octet-stream" \
  --data-binary "@license_####.xml"

The license is automatically applied after a few minutes.

Verification

This procedure is carried out using ConfD.

To verify the license after it has been uploaded, use the ConfD job license_info. For example:

[root@n11 ~]# confd_client -c license_info
Contract:
  comment: Unlimited license with an expiration date.
  company_name: Exasol
  distributor: Exasol
  distributor_id: 1
  expiration_date: '2023-08-02'
  license_id: 2
Exasol_DB_license:
  schema_version: 1
Limits:
  max_db_mem_size_in_gb: Unlimited
  max_db_raw_data_size_in_gb: Unlimited
  max_nodes_per_cluster: Unlimited
  max_num_clusters: Unlimited

To verify that the currently running databases do not exceed the license limits, use the ConfD job license_run_check. For example:

[root@n11 ~]# confd_client -c license_run_check
OK