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>

  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 <out request file> on offline machine. This will generate configuration file.

  3. Copy request file to online machine.

  4. Run ZibraLicenseServer query <in license key> <out license list file> on online machine. This generates file with 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 <in request file> <in license list file> <out license file> on online machine. This will checkout licenses to offline machine and generate 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 generated license file to offline machine.

  8. Run ZibraLicenseServer run <in license file> <in config file> on offline machine using license file. If you don't have a config file yet, specify the path where you want to create the default config file.

Returning License

  1. Run ZibraLicenseServer release <in license file> <out return file> on offline machine. This will invalidate checked out license and generate license return file.
  2. Copy license return file to online machine.
  3. Run ZibraLicenseServer return <in 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

Accessing Instructions Offline

You can find access instructions for License Server Usage by running the binary of the license server

Run ZibraLicenseServer help <command> to see help for a specific command.

Run ZibraLicenseServer help firewall to list remote servers this app may connect to.