Skip to content

Worker Linux Installation

Before you start

Goal

  • Correctly install the worker RPM file.

Prerequisites

  • Administration privileges for the worker machine.
  • Access to the RPM Files.

Note

These steps are for a fresh installation only. If you are upgrading an existing Altair SLC Hub server, see Upgrading

Get the install files

Download the RPMs from the World Programming (an Altair Company) Customer Support download site.

The worker file is called slchub-worker_<version>-1_x86_64.rpm. This should be downloaded and copied to a suitable directory on the target machine.

Install the Altair SLC Hub software

Having placed the install file on the target machine install the slchub-worker package using DNF e.g.:

sudo dnf install -y slchub-worker_<version>-1_x86_64.rpm

The dnf command will give feedback on the installation, concluding with a Complete! message and a summary of packages that have been installed.

Note

Altair SLC Hub is installed in /opt/altair/slchub.

Having placed the install file on the target machine, the first step is to install the dependencies required by the slchub-worker package using DNF. The dependencies and the packages that provide them can be listed with the following command:

sudo dnf deplist slchub-worker_<version>-1_x86_64.rpm

Make sure all the dependencies required are installed.

Command to install all dependencies For convenience, the following command will attempt to install all the dependencies for you:

sudo dnf deplist slchub-worker_<version>-1_x86_64.rpm \
    | awk '! /slchub/ && ! /coreutils/ && /provider:.*x86_64/ {print $2}' \
    | sort -u | xargs sudo dnf install -y

When installing the Altair SLC Hub RPM you have the option to set the location that it is installed, and separately control the location of the var directory. If this is being installed onto the same machine as the Altair SLC Hub then it must be installed to the same location as well.

Installing the Altair SLC Hub to a different directory can be done using the RPM command by specifying the --relocate option, e.g.:

sudo rpm -i slchub-worker_<version>-1_x86_64.rpm --relocate /opt/altair/slchub=<install location>

To change the var directory location can be done relocating it, e.g.: 

sudo rpm -i slchub-worker_<version>-1_x86_64.rpm --relocate /opt/altair/slchub/var=<var location>

This can be combined to relocate both to different locations: 

sudo rpm -i slchub-worker_<version>-1_x86_64.rpm --relocate /opt/altair/slchub=<install location> --relocate /opt/altair/slchub/var=<var location>

Verifying

Verify use of hubctl command

  • run the hubctl command

Most configuration actions are performed using the hubctl command. This is installed into the /usr/bin directory by the Altair SLC Hub installation. Verify that this command can be used: 

hubctl
This should print out some command help. The hubctl command should work without needing to use sudo.