License configuration

Custom license file¶

To load you custom license you need to pass the v2c file to the container via a volume and set HASP_LICENSE_FILE environment variable:

$ docker run \
    -v local_dir_with_v2c_file:/license \
    -e HASP_LICENSE_FILE=/license/license.v2c \
    ...

Disabling RTE¶

By default license requires a licensing run-time engine (RTE for short). RTE is started as a separate process in the container. It provides web-interface available at http://container-url:1947. RTE can be disabled by setting the HASP_ENABLE_RTE environment variable to anything but 1 or true (case-insensitive) :

$ docker run \
    -e HASP_ENABLE_RTE=false \
    ...

Note

Before the 3.13.1 version, RTE could be disabled by setting the HASP_DISABLE_RTE environment variable to any value:

$ docker run \
  -e HASP_DISABLE_RTE=true \
  ...

Note

Note that if you're using Microsoft Azure you should not disable RTE. Currently non-RTE licenses are not supported in Azure.

The trial license bundled with the image is available in both non-RTE and RTE variants.

Network licenses¶

To connect IDVoice Server to the network licensing server set the HASP_NETWORK_LICENSE_SERVER environment variable. Only provide server’s name, without port or protocol. Note that this will explicitly enable RTE and disable the use of license files:

$ docker run \
    -e HASP_NETWORK_LICENSE_SERVER=license_server_address \
    ...

Troubleshooting¶

If you often see "License Manager is not running" error on container start, you can increase the RTE startup timeout (in seconds) :

$ docker run -e HASP_RTE_STARTUP_TIMEOUT=10 ...