Platform and tools licensing
=================================

Huxelerate SDV performance plarform requires a license to be used.
The license is necessary to access the web platform, and to use the on-premise tools.
To require a license, please contact your representative at Huxelerate, or write to info@huxelerate.it.

License for on-premise tools
---------------------------------
On-premise tools requires a license to be used on a local workstation, or on a server (i.e. CI/CD).
The tool performs a license check that requires communication with the Huxelerate license server, and is directly linked with a specific
user account.

License validation can be performed in two ways:
1. via **token**
2. via **license file**

Token-based license validation
---------------------------------

Token-based license validation requires the user to:

* generate a token from the Huxelerate web platform (ref: :ref:`Settings`)
* provide the token in command line when running the tool or using the HUXELERATE_LICENSE_TOKEN environment variable

here's an example of running the Network Unpacker tool with a token:

.. code-block:: bash

    hux-network-unpacker.exe -b input.blf --license-token <your-token>

The flags for license token and file are consistant across different tools. Here's another example for Huxelerate Autosar utility:

.. code-block:: bash

    hux-autosar-sil.exe --license-token <your-token> [other options...]


License file-based validation
---------------------------------
License file-based validation requires the user to:

* download the license file from the Huxelerate web platform (ref: :ref:`Settings`)
* place the license file in the ~/.huxelerate directory (Linux) or in the %USERPROFILE%\\.huxelerate directory (Windows)
* run the tool without providing any license information

Alternatively, it is possible to place the license file in a custom directory and provide the path to the directory in command line when running the tool, or using the HUXELERATE_LICENSE_PATH environment variable.