How to upgrade WPSKEY and WPSHUBKEY licenses on Linux
Altair EmployeeThese steps can be followed when your Altair SLC Hub license (on your Hub server), and your Altair SLC license (on each Hub Worker machine), are coming up for renewal.
Your Altair Sales Account Manager will arrange for you to receive email notification messages with a link to your new license key files.
You should receive a WPSHUBKEY license file for your Altair SLC Hub machine, and one or more WPSKEY license files for Altair SLC that runs on each of your SLC Hub worker nodes.
Example filename for a Altair SLC Hub license: Hub Licence Key K54321.wpshubkey
Example filename for a Altair SLC license: Licence Key K12345.wpskey
(Note that we are migrating all customers from this 'legacy' licensing system to our Altair Units licensing system over the coming years.)
DOWNTIME / ROLLBACK
These steps take only a few seconds and do not interrupt any current jobs or processes. However if a new job attempts to start during those few seconds, the job may fail to start. For this reason it is sensible to schedule a few minutes of downtime for a production system, and to notify the user community.
If any problems occur during this process, the 'wind back' steps can be followed to restore the system to its previous working state.
1. HUB License
Copy the .wpshubkey file to your linux hub server and log into the server. Let us assume that you put the file into a directory called /home/myuserid.
sudo bash
cd /opt/altair/slchub/var
mv licence.txt licence.txt_BACKUP_date
cd /home/myuserid
cp 'Hub Licence Key K54321.wpshubkey' /opt/altair/slchub/var/licence.txt
Verification step:
sudo hubctl verify license
Now check the expiry date.
If any problems, wind back as follows:
cd /opt/altair/slchub/var
mv licence.txt licence.txt_FAILED
mv licence.txt_BACKUP_date licence.txt
2. WORKER License
Copy the .wpshubkey file to your linux hub worker node and log into the node. Let us assume that you put the file into a directory called /home/myuserid.
sudo bash
cd /var/lib/altair/slc/5
mv setinit.dat setinit.dat_BACKUP_date
cd /home/myuserid
/opt/altair/slc/2024/bin/wps -setinit 'License Key K12345.wpskey'
Verification step:
/opt/altair/slc/2024/bin/wps
(This command should print several lines but no error messages if license is ok)
Final check: connect to worker via Workbench and run 'PROC SETINIT; RUN;'
-- view log to check expiry date.
If any problems, wind back as follows:
cd /var/lib/altair/slc/5
mv setinit.dat setinit.dat_FAILED
mv setint.dat_BACKUP_date setinit.dat