Run product clients

This section describes how to configure the Linaro Forge license files.

Before you begin

  • A floating license consists of two files: Server license (Licence.xxxx), and Client license (Licence).

  • Server license file names must begin with License, or the variant spelling Licence.

  • License file names are not case-sensitive.

  • You can append unique identifiers to license file names for storing multiple licenses in the same directory.

    For example, add the server license serial number, license.server.1234, or include client in the client license name, license.client.5678.

Procedure

  1. For each floating license, copy the corresponding client license file to the relevant licences subdirectory in the product installation directory, <product_installation_directory>/licences. For example, copy the Linaro Forge client license to /opt/linaro/forge/<version>/licences.

  2. Edit hostname in the client license file to include the hostname or IP address of the machine on which the Linaro Forge Licence Server runs.

  3. If your licenses directory is not in the product installation directory, you can specify the directory path to point to the location of the product licenses using the environment variable FORGE_LICENSE_DIR.

Notes:

  • If you include a specific license file name in the FORGE_LICENSE_DIR path, the Linaro Forge Licence Server always attempts to serve that specific license.

  • You can set the environment variable in a module file for the product. For example:

    export FORGE_LICENSE_DIR=${HOME}/SomeOtherLicenceDir
forge

The fields in the client license file are:

Name

Required

Description

hostname

Yes

The hostname, or IP address of the license server

ports

No

A comma separated list of ports to be tried locally for GUI-backend communication. Defaults to 4242,4243,4244,4244,4245

serial_number

Yes

The serial number of the server license to be used

serverport

Yes

The port the server listens on

type

Yes

Must have value 2—this indicates that the license requires a server to run correctly

Note

The serial number of the server license is specified as this enables a user to be tied to a particular license.