Initial Linux Installation¶

Before you start¶

Goal

Correctly install the RPM file.

Prerequisites

Read the Planning section.
Administration privileges for the host.
Access to the RPM Files.

Install¶

Note

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

Altair SLC Hub is delivered as two RPMs, one for the Altair SLC Hub server, and one for the worker machines.

In production it is recommended that the server and workers are separate machines, to prevent the workers workload from affecting the hub's control plane, however both may be installed on the same machine.

Get the install files¶

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

The server file is called slchub_<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¶

Default locationCustom location

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

sudo dnf install -y slchub_<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 package using DNF. The dependencies and the packages that provide them can be listed with the following command:

sudo dnf deplist slchub_<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_<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.

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

sudo rpm -i slchub_<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_<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_<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. To be able to use this command the user will need to be added to the slchub group. For more information see Configuration Requirements. 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.

Directory Layout¶

The installation creates various directories that will be of interest after installation.

Directory	Default Location	Description
Installation root	`/opt/altair/slchub`	The root installation directory. This will be referred to as the installation root elsewhere in the documentation.
`[etc directory]`	`/opt/altair/slchub/etc`	Location of configuration files. The `etc` directory will always be located under the installation root. This directory will be referred to as the `[etc directory]` directory elsewhere in the documentation.
`[var directory]`	`/opt/altair/slchub/var`	Location of data files and log file. The `var` directory will be located under the installation root unless it's location was changed during installion. This directory will be refered to as the `[var directory]` elsewhere in the documentation.