Start Services¶
Before you start¶
Goal
- Start Altair SLC Hub services
- Verify services are running
- Confirm the portal is accessible
Prerequisites
- Complete the initial Altair SLC Hub install (Linux) or initial Altair SLC Hub install (Windows)
- Complete Configure licence
- Complete Generate external certificates
- Complete Configure ingress and enable HTTPS
- Complete Perform initial data bootstrap
- Altair SLC Hub configuration privileges for the host
Next step: Create admin user
After starting services, you must create an admin user before you can log in to the portal. See Create admin user for instructions.
Start and enable services¶
The installation process installs the software and installs systemd unit files to the
/usr/lib/systemd/system directory.
The installation process installs the software as Windows services.
The installation process does not start or enable the Altair SLC Hub services, these need to be started manually using hubctl. The hubctl interface enables control of the various services that make up the Altair SLC Hub software.
Start the services¶
To start the Altair SLC Hub services:
hubctl service start
Verify services are running¶
To check that the services are running, run the following command:
hubctl service status
This command produces a table showing all services and their status. You should see output similar to:
Services Installed Active Autostart Failed
slchub.auth Installed Active False No
slchub.casvc Installed Active False No
slchub.data-access Installed Active False No
slchub.execution-profiles Installed Active False No
slchub.ingress Installed Active False No
slchub.ingressctrl Installed Active False No
slchub.internaldb Installed Active False No
slchub.jobsapi Installed Active False No
slchub.jobsctrl Installed Active False No
slchub.keycloak Installed Active False No
slchub.license Installed Active False No
slchub.linkgateway Installed Active False No
slchub.linksrv Installed Active False No
slchub.managementapi Installed Active False No
slchub.namespaces Installed Active False No
slchub.nats Installed Active False No
slchub.nginx Installed Active False No
slchub.nomad Installed Active False No
slchub.objstore Installed Active False No
slchub.ondmdapi Installed Active False No
slchub.pipelinesapi Installed Active False No
slchub.rbac Installed Active False No
slchub.secret Installed Active False No
slchub.vault Installed Active False No
slchub.webdav Installed Active False No
All services must be active
If any service shows inactive, troubleshoot before proceeding.
Services may take a few moments to start. Wait 10-15 seconds and run hubctl service status again.
If services still show inactive, check logs or run hubctl service start again.
Configure auto-start on boot (optional)¶
To configure the Altair SLC Hub services to start automatically on boot, use the following command:
hubctl service config --autostart=true
Verify the setting was applied by running hubctl service status and checking that Autostart shows True for all services.
Verify the portal is accessible¶
Verify ingress connectivity¶
Check that the portal is reachable from the local machine:
hubctl verify ingress
You should see output similar to:
Verifying HTTP(S) ingress point
OK
Ingress verification failed
If this command fails, check:
- All services are running:
hubctl service status - Firewall allows port 443 (HTTPS) or 9090 (HTTP)
- On Windows: hostname is in the hosts file (
C:\Windows\System32\drivers\etc\hosts) - Network connectivity to the machine
Acces the portal URL¶
To verify that the installation was successful and that Altair SLC Hub is running, use a supported web browser and navigate to the Altair SLC Hub address defined. This URL can be retrieved using the command:
hubctl config print ingress.url
For example, navigate to http://machine.domain.local
You should see the Altair SLC Hub login page.
Certificate warning on first access
On first access, your browser may show a security warning about the certificate. This is normal and expected. You can safely proceed. The warning should not appear on subsequent visits.
Next step: Create an admin user¶
Required before login
Before you can log in to the Altair SLC Hub portal, you must create an admin user. This is a required step.
Proceed to Create admin user to create your first administrator account.
Troubleshooting¶
Certificate conflicts¶
Symptom: Browser displays certificate errors or "too many times" warnings.
Solution:
- Open Certificate Manager (Press
Win + R, typecertmgr.mscon Windows). - Run Certificate Manager as an Administrator.
- Navigate to Trusted Root Certification Authorities > Certificates.
- Sort by Issued By.
- Delete all
RootCAcertificates. - Close Certificate Manager.
- Re-import certificates.
- Run bootstrap again:
hubctl bootstrap. - Access portal again at
https://<hostname>/.