Skip to content

Legacy Licensing

Before you start

Goal

  • License the Altair SLC Hub.

Prerequisites

  • Follow the initial install instructions.
  • Altair SLC Hub configuration privileges for the host.
  • Access to a license file.

Install the Altair SLC Hub licence key

By default, the Altair SLC Hub licence key is read from the file [var directory]\licence.txt. The location from which the licence key is read is controlled by the licence.keyfile configuration property and can be changed if required. For details on the operation of the configuration process and how configuration files are read, see Configuration.

The license key is delivered as a text string. Edit the licence key file and paste the licence key text into it.

The permissions on the [var directory] directory require that this file be edited by a user that is part of the slchub group. For example, to edit the file with vi, type the following command:

vi [var directory]/licence.txt

Once the file is created and saved, ensure that the correct ownership and permissions are set. The file should be owned by the install user, with the group set to slchub. The permissions should be set to read/write for the owner and group, not accessible to others, that is 0660, or --rw-rw----. These settings ensure that only the Hub service processes can read the licence file, while any workloads that Hub may run cannot.

Gaining access to the file

The [var directory] directory is not accessible by default in Windows Explorer. Grant yourself access to the folder by directly using Windows Explorer.

Once the file is created and saved, ensure the correct access controls are set to prevent normal users accessing and reading then file. The file access control should be set so that the 'Administrators' and 'Local Service' principals have full control, but the 'Users' principal has no access.
You can check the Effective Access of the file using Windows Explorer in the Advanced Security Settings accessed from the Security tab of the file properties.

Verification

Verify licence

  • run the hubctl verify licence command

Before continuing it is necessary to verify that the licence has been installed correctly This can be done using the hubctl commands, as follows:

hubctl verify licence