Skip to content

Configure SLC

Before you start

Goal

  • Add an Altair SLC Installation to a worker node.

Prerequisites

  • A configured Hub server.
  • A configured worker node.
  • Altair SLC Hub configuration privileges for the server host and worker node.

Installing Altair SLC

To install Altair SLC on the worker node, follow the installation guide in the Altair SLC installation download.

The minimum required version is 2023.1. See Altair SLC Compatibility for more information about compatible versions of Altair SLC.

Apply an Altair SLC licence. If Altair Unit licensing model is used then the environment variable WPS_USE_ALM should be set to true and at least one of the ALTAIR_LICENSE_PATH, ALM_HHWU_TOKEN, ALM_HHWU_CONFIG environment variables should be set. These environment variables can be configured at the OS level or can be set before running the hubctl slcinstall add command. These should also be configured as environment variables in any execution profiles that will be used.

Registering an Altair SLC installation with Hub Agent

The hub software on the worker node requires the location of the Altair SLC installation registered with it.

To register a location run the following command: 

hubctl slcinstall add /opt/altair/slc/2023

The /opt/altair/slc/2023 installation path might need to be replaced with the installation path for the version of Altair SLC on your worker node.

If using Altair Unit license, then the environment variables should be provided when running the command: 

WPS_USE_ALM=TRUE [email protected] hubctl slcinstall add /opt/altair/slc/2023

To register a location run the following command: 

hubctl slcinstall add "C:\Program Files\Altair\SLC\2023"

The C:\Program Files\Altair\SLC\2023 installation path might need to be replaced with the installation path for the version of Altair SLC on your worker node.

If using Altair Unit license, then the environment variables can be provided when running the command or specified, for example they can be set globally or just before running the command: 

set WPS_USE_ALM=TRUE
set [email protected]
hubctl slcinstall add /opt/altair/slc/2023

Note

The Altair SLC licence must be applied before this process is performed. It is important that this licence be applied to the whole machine and not just to the current user. On Linux this means applying the licence by running Altair SLC under sudo.

Having modified the list of registered Altair SLC installations using the hubctl slcinstall command, you may need to wait for up to 30 seconds before the installation is registered with Hub server and, for example, run workloads on the worker node that require that specific version of Altair SLC.

The process enables different versions of Altair SLC to be registered and worker machine version tags configured to reflect the version of Altair SLC installed on a given worker. For example, one version of Altair SLC could be installed on one set of worker machines and a different version of Altair SLC installed on a different set of machines. Altair Analytics Workbench could then request a specific version of Altair SLC and the workload would be run on one of the appropriate worker nodes.

For more information on this functionality, contact Altair support.

Verification

Verify Altair SLC installations

  • run the hubctl verify slc command
  • run the hubctl slcinstall list command

To verify Altair SLC registration settings, use the command: 

hubctl verify slc

To list the registered Altair SLC installations and view their associated version tags, use the command: 

hubctl slcinstall list