Initial Setup

<aside> ⚠️

On Linux and macOS you need to make file executable before running License Server

Linux - chmod +x ZibraLicenseServer

macOS - chmod +x ZibraLicenseServer.app/Contents/MacOS/ZibraLicenseServer

</aside>

<aside> ⚠️

On macOS you need to run binary inside of .app package, instead of .app itself

ZibraLicenseServer.app/Contents/MacOS/ZibraLicenseServer <command>

</aside>

<aside> ⚠️

On Windows you need to install latest version of “Microsoft Visual C++ Redistributable v14 x64” before running ZibraLicenseServer - https://aka.ms/vc14/vc_redist.x64.exe

</aside>

In this guide <... file> refers to either full file path, or path relative to current working directory. When particular file mentioned for the first time, this means that command will create said file. Each mention after first one will expect existing file generated in one of the previous steps.

  1. Prepare machine on which you are going to run local license server (offline machine) and machine with an internet connection (online machine). After setup, license will be locked to the machine where you ran ZibraLicenseServer request. You may use a single machine for both, in which case it will need internet connection during setup.

  2. Run ZibraLicenseServer request <request file> on offline machine. This will create the request file.

  3. Copy request file to online machine.

  4. Run ZibraLicenseServer query <license key> <license list file> on online machine. This will create license list file. This file contains list of licenses to checkout.

  5. (optional) Modify hardware_ids_limit in the license list file to specify number of licenses to checkout. If this step is skipped, all available licenses will be checked out.

  6. Run ZibraLicenseServer checkout <request file> <license list file> <license file> on online machine. This will checkout licenses to offline machine and create license file.

    <aside> ℹ️

    Note that you can only use request file once. If you need to checkout licenses again, you must return license first, and then setup the license from the beginning.

    </aside>

  7. Copy license file to offline machine.

  8. Run ZibraLicenseServer run <license file> <config file> on offline machine using license file. This will create config file.

  9. (optional) Modify config file to specify parameters like server port or IP allow list. If this step is skipped, server will run on port 19178 and allow any IP to use licenses.

  10. Run ZibraLicenseServer run <license file> <config file> on offline machine again. This starts license server which will continue running until you terminate it. You can terminate it with Ctrl+C. It is recommended to set it up as a service.

Returning License

  1. Run ZibraLicenseServer release <license file> <return file> on offline machine. This will invalidate checked out license and create return file.
  2. Copy return file to online machine.
  3. Run ZibraLicenseServer return <return file> on online machine using license return file. This will return previously checked out licenses.

You can also access this guide by running ZibraLicenseServer help