Skip to content

Hostnames and Routing

Before you start

Goal

  • Ensure Hostnames are correct and a server and worker may communicate correctly.

Prerequisites

  • A configured Hub server.
  • A configured worker node.
  • Administration privileges for the server host and worker node if running Windows.

Altair SLC Hub server preparation

Before installing software on the Altair SLC Hub worker nodes, some configuration is required on the main Altair SLC Hub server host.

The host name for the main Hub server used in HTTPS certificates for internal Hub communications is specified in the casvc.hostname configuration property. By default this will be set to the main Altair SLC Hub ingress hostname. Review this setting using the command:

hubctl config print casvc.hostname

The default value for this configuration setting is in the hub configuration file [etc directory]/config.d/casvc.yaml.

If Altair SLC Hub worker nodes are not able to communicate with the main Altair SLC Hub server using that host name, the host name can be changed to a more appropriate one.

Do not edit the installation-supplied configuration files directly. Instead, create a new file in the same directory with a lexicographically greater name such as casvc_hostname.yaml and use that to override the configuration setting.

For example, to use the host name "mainhub" create a file called casvc_hostname.yaml and set the contents to:

casvc:
  hostname: mainhub

If the host name is changed and the Altair SLC Hub CA service is installed, it is necessary to restart the Altair SLC Hub CA service:

hubctl service restart casvc

Worker registration preparation

Having installed the Altair SLC Hub worker node software, the worker needs to be registered with the Hub. Before this process can be performed it is necessary to verify that the correct hostname will be used during the registration. The value of the casvc.hostname configuration property on the worker node needs to be the fully-qualified hostname by which the Hub server can contact the worker node. An initial value of this configuration property is set during the installation process. The value can be viewed using the following command (run on the worker node):

hubctl config print casvc.hostname

The default value for this configuration setting is in the Hub configuration file [etc directory]/config.d/casvc.yaml file. If the main Altair SLC Hub server host is not able to communicate with the Altair SLC Hub worker node using that host name, the host name can be changed to a more appropriate one.

Do not edit the installation-supplied configuration files directly. Instead, create a new file in the same directory, with a lexicographically greater name such as casvc_hostname.yaml and use that to override the configuration setting.

For example, to use the host name "hubworker" create a file called [etc directory]/config.d/casvc_hostname.yaml and set the contents to:

casvc:
  hostname: hubworker

There is nothing to restart on a worker node when this is done. The change will be detected when the hubctl worker register command is executed.

Verification

Altair SLC Hub comes with a utility that can be used to verify the network communication between the Hub host and the worker host, and to identify any firewall issues or other network routing issues that might exist.

First, ensure the Altair SLC Hub services are not active by running the following command on the worker node:

hubctl service stop

You will need to know the hostname of the worker node. On the worker node, to find this out, run:

hubctl config print internalnetwork.hostname

Next, run the following command on the worker node host:

hubctl portcheck worker

This command will start and then wait for communication. Once the test has completed successfully it will exit automatically.

Then run the following command on the hub server host:

hubctl portcheck server <worker-host-name>

Where <worker-host-name> is the host name of the worker node.

The command run on the Hub server host will perform various tests of communication between the Hub server and the worker node.

Once the test is complete, you can now start the slchub.nomad service on the worker node by running:

hubctl service start nomad