Upload a License

This article explains how to upload a license to an Exasol database.

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

Prerequisites

  • Exasol 8 must be installed.

  • You must have a valid Exasol 8 license file.

Exasol 7.1 licenses are not valid in Exasol 8 because of differences in the license format. For information about how to obtain a valid license for Exasol 8, create a support case.

Procedure - ConfD

The following examples use ConfD through the command-line tool confd_client, which is available on all database nodes. You can also access ConfD through XML-RPC in your own Python programs. For more information, see ConfD.

  1. Download the license file to a directory on your local machine.

  2. To upload the contents of the license file to COS, use the cat Linux command and the ConfD job license_upload. 

    cat <license_name>.exasol_license | c4 connect -s cos -i <play_id> -- confd_client license_upload license: '\""{< -}\""'

    Replace <license_name> with the name of the license file and <play_id> with the ID of the deployment. To find the ID of the deployment, use c4 ps.

    Example:
    cat 1234567890.exasol_license | c4 connect -s cos -i c3275f84 -- confd_client license_upload license: '\""{< -}\""'

When the license has been successfully uploaded to COS it is automatically applied after a few minutes.

The server may in some cases respond with an error message even if the upload was successful. To verify that the license was correctly uploaded, use the ConfD job license_info. For more information, see Check License.

Procedure - Administration API

The following examples use curl in a Linux terminal to send REST calls to endpoints in the Administration API. You can also use other interfaces and languages to interact with the API. For more information, see Administration API.

Placeholder values are styled as Bash variables, for example: $NODE_IP. Replace the placeholders with your own values.

  1. Open a Linux terminal in the directory where you have downloaded your Exasol 8 license file.

  2. To upload the license to the database, send a POST request to the /api/v1/license endpoint on one of the database nodes in the cluster: 

    curl -X 'POST' --insecure "https://$NODE_IP:4444/api/v1/license" \
      -H "accept: application/json" \
      -H "Authorization: Basic $AUTH_TOKEN" \
      -H "Content-Type: application/octet-stream" \
      --data-binary "@$FILENAME"
    Parameter/placeholder Description
    $NODE_IP The external IP address of one of the nodes in the cluster.
    $AUTH_TOKEN

    Authentication token generated from the username and password of a user in the exaadm group.

    For information about how to generate authentication tokens from a user and password, see Authentication.

    $FILENAME

    The filename of the license file, for example 1234567890.exasol_license

    The @ before the license filename is required since it tells curl to upload the contents of the license file, not the actual binary.

    The option --insecure or -k tells curl to bypass the TLS certificate check. This option allows you to connect to a HTTPS server that does not have a valid certificate. Only use this option if certificate verification is not possible and you trust the server.

    Uploading a license overwrites the existing license. This means that if you install and activate a temporary license you cannot keep the old license file inactive on the system and then reactivate it, you must upload the old license again.

    Example:
    curl -X 'POST' --insecure "https://203.0.113.11:4444/api/v1/license" \
      -H "accept: application/json" \
      -H "Authorization: Basic YWRtaW46ZXhhc29s" \
      -H "Content-Type: application/octet-stream" \
      --data-binary "@1234567890.exasol_license"

    The uploaded license is automatically applied after a few minutes.

The server may in some cases respond with an error message even if the upload was successful. To verify that the license was correctly uploaded, use the ConfD job license_info. For more information, see Check License.