Upgrade SLC¶
Before you start¶
Goal
- Updated Altair SLC Hub configuration for upgraded Altair SLC installation.
Prerequisites
- A configured Hub server.
- A configured worker node.
- Altair SLC Hub configuration privileges for the server host and worker node.
Upgrading Altair SLC¶
To upgrade Altair SLC on the worker node, follow the installation guide in the Altair SLC installation download.
Apply an Altair SLC licence.
Update Altair SLC Hub configuration¶
Altair SLC installation path is unchanged¶
When an Altair SLC installation has been upgraded and the installation path remains the same, the Altair SLC Hub worker does not require reregistering. This can be confirmed by running the following command:
hubctl verify slc
However, you may still wish to update the version tags associated with the registered Altair SLC installation. For example, if you have upgraded Altair SLC from v2023.0.0.0 to v2023.0.0.1 you would remove the v2023.0.0.0 tag by running:
hubctl slcinstall rmtag v2023.0.0.0
Then, check the Altair SLC installation path by running:
hubctl slcinstall list
A new tag can be added by running the following command:
hubctl slcinstall addtag /opt/altair/slc/2023 v2023.0.0.1
The /opt/altair/slc/2023 installation path might need to be replaced with the installation path for the version of Altair SLC on your worker node.
hubctl slcinstall addtag "C:\Program Files\Altair\SLC\2023" v2023.0.0.1
The C:\Program Files\Altair\SLC\2023 installation path might need to be replaced with the installation path for the version of Altair SLC on your worker node.
Altair SLC installation path has changed¶
When an Altair SLC installation has been upgraded and the installation path has changed, it will be necessary to re-register the Altair SLC Hub worker. Run the following command:
hubctl verify slc
You will see a message stating that one or more Altair SLC installations could not be verified. To resolve this, remove the old SLC registration by running the following command:
hubctl slcinstall rm /opt/altair/slc/2023
The /opt/altair/slc/2023 installation path might need to be replaced with the old installation path for the version of Altair SLC on your worker node. The old installation path is displayed by running the hubctl verify slc command.
Next register the upgraded Altair SLC with Altair SLC Hub by running the following command:
hubctl slcinstall add /opt/altair/slc/2024
The /opt/altair/slc/2024 installation path might need to be replaced with the installation path for the new version of Altair SLC on your worker node.
hubctl slcinstall rm "C:\Program Files\Altair\SLC\2023"
The C:\Program Files\Altair\SLC\2023 installation path might need to be replaced with the old installation path for the version of Altair SLC on your worker node. The old installation path is displayed by running the hubctl verify slc command.
Next register the upgraded Altair SLC with Altair SLC Hub by running the following command:
hubctl slcinstall add "C:\Program Files\Altair\SLC\2024"
The "C:\Program Files\Altair\SLC\2024" installation path might need to be replaced with the installation path for the new version of Altair SLC on your worker node.
As part of the hubctl slcinstall add command, Altair SLC Hub will attempt to add some tags to the Altair SLC installation - these can be seen by running:
hubctl slcinstall list
Update execution profiles¶
Having upgraded an Altair SLC installation, it is likely that some tags have now been removed and/or updated. If you have set up execution profiles to reference specific Altair SLC version tags, you will now need to update the execution profiles, otherwise Altair SLC Hub workloads may fail to run. For more information see Execution Profiles.
Verification¶
Verify Altair SLC installations
- run the
hubctl verify slccommand - run the
hubctl slcinstall listcommand
To verify Altair SLC registration settings, use the command:
hubctl verify slc
To list the registered Altair SLC installations and view their associated version tags, use the command:
hubctl slcinstall list