Skip to content

Upgrade from 2025.0 process

Server and Worker node installed on the same Linux machine

This only applies to installations of Altair SLC Hub 2025.0.1 and 2025.0.2 on Linux. This does not apply to Windows. For other scenarios follow the relevant upgrade guides, Upgrading the Server and Upgrading Worker Nodes separately.

Before you start

Prerequisites

  • Administrator access to the Altair SLC Hub server machine.
  • Completed the Upgrading Guide.

Upgrade

The relevant releases of Altair SLC Hub have an issue with the RPMs that only occurs during an upgrade from them to a later version, e.g. when upgrading from 2025.0.1 to 2025.0.2 or from either 2025.0 release to 2025.1. To work around this the old version must be uninstalled and then new version can be installed instead of doing the usual upgrade.

Server

The first step is to uninstall the server RPM: 

sudo dnf remove -y slchub
Then install the new Altair SLC Hub server RPM.

Download the Altair SLC Hub server RPM from the World Programming (an Altair Company) Customer Support download site and copy the new RPM to the target machine. Install the slchub package using the following DNF command: 

sudo dnf install -y slchub_<version>-1_x86_64.rpm
The DNF command will give feedback on the install, concluding with a Complete! message and a summary of packages that have been installed.

If Altair SLC Hub was installed in a custom location or with a custom [var directory] then during install the custom locations need to be specified again.

Download the Altair SLC Hub server RPM from the World Programming (an Altair Company) Customer Support download site and copy the new RPM to the target machine.

Updating the slchub package is done with the RPM command. Optionally specify --relocate /opt/altair/slchub=<install location> if the installation root had been changed, and --relocate /opt/altair/slchub/var=<var location> if the [var directory] location had been changed. 

sudo rpm -i slchub_<version>-1_x86_64.rpm

Make sure the database is running, then use the hubctl command to perform the database migrations and bootstrapping. Then start the updated Altair SLC Hub services: 

hubctl bootstrap
hubctl service start

Verification

Verify all Altair SLC Hub services are running on the server

hubctl service status

Worker

The first step is to uninstall the worker RPM: 

sudo dnf remove -y slchub
Then install the new Altair SLC Hub worker RPM.

To update the Worker Node, copy the new RPM onto the target machine and install slchub-worker using the following DNF command: 

sudo dnf install -y slchub-worker_<version>-1_x86_64.rpm
The DNF command will give feedback on the install, concluding with a Complete! message and a summary of packages that have been installed.

Use the hubctl command to start the updated Altair SLC Hub services: 

hubctl service start

If slchub-worker package was installed in a custom location or with a custom [var directory] then during upgrade the custom locations need to be specified again.

To update the Worker Node, start by copying the new RPM onto the target machine.

Updating the slchub package is done with the RPM command. Optionally specify --relocate /opt/altair/slchub=<install location> if the installation root had been changed, and --relocate /opt/altair/slchub/var=<var location> if the [var directory] location had been changed. 

sudo rpm -i slchub-worker_<version>-1_x86_64.rpm

Verification

Verify all Altair SLC Hub services are running on the worker

hubctl service status

Reactivating Deployment Endpoints and Libraries

After completing the upgrade follow instructions to reactiavte Deployment API endpoints and Published Libraries, follow instructions here.