Licensing example

This section shows an example of how the Linaro Forge Licence Server is set up with details of the license file content.

For detailed instructions about how to set up the Linaro Forge Licence Server, see Run Linaro Forge Licence Server.

In this example, a dedicated Linux server machine is running the Linaro Forge Licence Server. It is installed in /opt/linaro/licenceserver/<version> and the server license files are stored in /opt/linaro/licenceserver/<version>/licences.

The Linaro Forge Licence Server program runs as the dedicated allinea user, and serves all licenses in /opt/linaro/licenceserver/<version>/licences. Linaro Forge Licence Server logs events to the /var/log/linaro/allinea.log.

These commands were run to set up the Linaro Forge Licence Server to:

  • create the allinea user.

  • specify the location of licenses and logs.

  • link to the systemd init configuration.

  • run the Linaro Forge Licence Server and check its status.

% useradd --system --user-group --no-create-home \
          --home-dir /opt/linaro/licenceserver/<version> allinea
% mkdir /var/log/linaro
% chown allinea: /var/log/linaro
% ln -s /opt/linaro/licenceserver/<version>/lib/systemd/system/allinea-licenceserver.service \
        /etc/systemd/system/
% systemctl enable allinea-licenceserver
% systemctl start allinea-licenceserver
% systemctl status allinea-licenceserver

The example server license file is /opt/linaro/licenceserver/<version>/licences/Licence.server.physics and is served by server.physics.acme.edu on port 4252.

It contains:

type=3
serial_number=1014
max_processes=48
expires=2004-04-01 00:00:00
support_expires=2004-04-01 00:00:00
mac=00:E0:81:03:6C:DB
interface=eth0
debuggers=gdb
serverport=4252
max_users=2
beat=60
retry_limit=4
hash2=c18101680ae9f8863266d4aa7544de58562ea858

The example client license is stored at /opt/linaro/forge/<version>/licences/Licence.client.physics.

It contains:

type=2
serial_number=1014
hostname=server.physics.acme.edu
serverport=4252

Note

The client file hostname parameter is manually edited to reference the Linaro Forge Licence Server.