Add Worker (On Hub Server)¶
Before you start¶
Goal
- Add Workers to a configured Altair SLC Hub server.
Prerequisites
- The address of the machine hosting the worker and the hub.
- A configured hub server.
- Altair SLC Hub configuration privileges for the host.
Worker Registration¶
By default the Altair SLC Hub secures its communications with TLS by means of a self-signed Certificate Authority. This is detailed in the Internal TLS Reference.
You may prefer to secure these communications using a different Certificate Authority, for example a public Root Certificate Authority or a Subordinate Certificate Authority. If this is the case, please follow the alternative worker registration process Alternate Internal Certificate Authority)
hubctl worker register hubhost.domain.local:9093
Note
The command line must be run as Administrator on Windows.
TLS Certificate Installation¶
Note
This step is not required if installing on Linux and using version 2023.8 or later of Altair SLC.
Some worker applications, such as Altair SLC Hub package pipeline nodes, require that a TLS CA certificate is installed on the operating system.
If internal communications are being secured by the Altair SLC Hub CA Service, a certificate can be installed from the command line as follows:
sudo cp [var directory]/ca/public/CA.cert.pem /etc/pki/ca-trust/source/anchors
sudo update-ca-trust force-enable
sudo update-ca-trust extract
Note
This example is for RHEL version 8 and equivalent distributions. For other distributions or versions please consult the documentation for your distribution to determine the corresponding commands.
certutil -addstore Root [var directory]\ca\public\CA.cert.pem
Note
The command shell, cmd, must be run as Administrator.
If internal communications are being secured by an external Certificate Authority, the CA certificate should have been installed in the operating system when preparing the worker node for registration.
Enable Services¶
The installation process installs the software and installs systemd unit files to the
/usr/lib/systemd/system directory for Linux installations and service files to C:\Program Files\Altair\SLC Hub\services for Windows installations. However, the installation process does not start or enable any services.
The hubctl command can be used to control services that
make up the Altair SLC Hub software.
To start the Altair SLC Hub worker node service:
hubctl service start
Check that it is running:
hubctl service status
To configure the Altair SLC Hub service so that it will be started automatically on boot:
hubctl service config --autostart=true
Verification¶
The Altair SLC Hub portal contains a page that gives details of the registered workers.
Open the Hub Administration application in the portal, and from the navigation panel select Cluster Nodes. Verify that the registered worker is included in the list of known cluster nodes.