Skip to content

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 --nogetcafromserver hubhost.domain.local:9093

Note

The command line must be run as Administrator.

TLS Certificate Installation (Windows only)

Some worker applications, such as 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:

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 enable

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.