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¶
Having placed the install file on the target machine install the slchub
package through 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
.
This installation directory is fixed and cannot be changed.
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:
sudo hubctl
hubctl
command should be run using sudo
or other equivalent mechanism. The command invocations in the rest of the documentation are designed to be relevant to all platforms and so do not explicitly include the sudo
command.
Directory Layout¶
The installation creates various directories that will be of interest after installation.
Directory | Description |
---|---|
/opt/altair/slchub |
The root installation directory. This will be referred to as the installation root elsewhere in the documentation. |
/opt/altair/slchub/etc |
Location of configuration files. This directory will be referred to as the [etc directory] directory elsewhere in the documentation |
/opt/altair/slchub/var |
Location of data files and log file. This directory will be refered to as the [var directory] elsewhere in the documentation |