Accessing the Altair License from the Altair License Utility on the command line

Matthieu Pupat
Matthieu Pupat
Altair Employee
edited July 16 in Altair HyperWorks

Important:  This article is for authorizing from the command line. If you wish to authorize through ALMUtil GUI, please refer to Accessing the Altair License from the Altair License Utility.

 

1. Login to Altair One.

2. Go to the User Profile section of the Altair One Admin portal: https://admin.altairone.com/updateprofile.

3. Switch to the Authorized Machines tab:

image

4. In the top-right corner, click Generate Auth Code.

image

An authentication code will be generated.

5. Click the copy icon.

image

6. Locate the Altair License Utility.

  1. On Windows this is located in the start menu under Altair 2021.2. You can also directly start it from <ALTAIR_INSTALL_PATH>\security\bin\win64\gui\almutil.exe (usually C:\Program Files\Altair\2021.2\security\bin\win64\gui\almutil.exe).
  2. On Linux, you can directly start it from <ALTAIR_INSTALL_PATH>/altair/security/bin/linux64/almutil (by default /root/2021.2/altair/security/bin/linux64/almutil).

7. Enter the following command in a terminal (Linux) or Command Prompt (Windows)

almutil -a1auth -code <code>

image

A message will indicate that the authorization succeeded.

 

You can now start using your Altair software.

 

Machine-wide authorization

By default the authorization will be only for the current user. To get a token that works for all users on the machine, use the following command. Please note that you will need administrator rights to run it.

almutil -a1auth -code <code> -system

 

Anyhost authorization

By default the authorization tokens are linked to the machine MAC addresses and will only work on that machine. If you need a token that can work on multiple machines or a machine with changing MAC addresses (e.g. on a VDI environment), you can get a anyhost token.

Important note: Anyone who has access to this token will be able to use your licenses. You can mitigate this risk by controlling the Allowed IP Addresses from the Altair One licenses administration website.

To get a anyhost token, use the following command:

almutil -a1auth -code <code> -anyhost

image

 

From there you can either authorize other machines through an authorization file or through an environment variable

Authorizing other machines through an authorization file

Copy the authorization file located at:

  • %USERPROFILE%\AppData\Local\.altair_licensing\%COMPUTERNAME%\altair_hostedhwu.cfg (on Windows)
  • $HOME/.altair_licensing/$HOSTNAME/altair_hostedhwu.cfg (on Linux)

For user level authorization, paste it on the machine you want to authorize under

  • %USERPROFILE%\AppData\Local\.altair_licensing\%COMPUTERNAME%\altair_hostedhwu.cfg (on Windows)
  • $HOME/.altair_licensing/$HOSTNAME/altair_hostedhwu.cfg (on Linux)

For machine level authorization, paste it on the machine you want to authorize under

  • %ALLUSERSPROFILE%\altair\altair_hostedhwu.cfg (on Windows)
  • /usr/local/altair/altair_hostedhwu.cfg (on Linux)

Authorizing other machines through an environment variable

Define the following environment variable

ALM_HHWU_TOKEN=<authcode>
image
Tagged:

Categories