Using Managed Altair Units License via Altair One

Using the Altair Units licensing will support simplifying the license management by removing all manual aspects of emailing license files, extending evaluation periods, among others.

In addition, Altair Units licensing will help small to medium deployment customers who do not want to host on-premise license server.

Before using Altair Units, it is required to configure the following properties in the Panopticon.properties file located in the AppData folder or /etc/panopticon/appdata:


Property	Licensing
Attribute	license.hwu.hosted
Description	Boolean stating if you wish to use Managed or Local Altair Units licensing. Set to true if you wish to use managed licensing.
Default Value	false
Property	Licensing
Attribute	license.hwu.hosted.authorization.username
Description	Username to the Altair One account.
Default Value
Property	Licensing
Attribute	license.hwu.hosted.authorization.password
Description	Password to the Altair One account.
Default Value
Property	Licensing
Attribute	license.hwu.hosted.authorization.authcode
Description	An authorization code (Auth Code) generated through the Altair One admin portal. The authorization code is redeemed by Panopticon for permanent units license authorization token from the managed license servers. The token is then stored internally and used for checking out license units.
Default Value
Property	Licensing
Attribute	license.hwu.hosted.authorization.almutiltoken
Description	A units license authorization token generated manually using the Altair License Manager command line tool (Altair License Utility or ALMutil), based on an authorization code (Auth Code) from Altair One Admin Portal. This gives you the option to create a token which is valid for any host and not limited to a specific MAC address and that is useful when using Panopticon in Docker containers where the MAC address will change after container rebuild. When set, this property takes precedence over the property license.hwu.hosted.authorization.authcode. While the Auth Code is valid for just 15 minutes, a token is valid until it is destroyed in the Altair One Admin Portal.
Default Value

NOTE:

To use the managed Altair Units licensing, set the following properties:
license.hwu.hosted=true
license.mode=HWU
Add the Panopticon application to your Altair One account.
When using Managed Altair Units via Altair One, you do not need to configure the license.hwu.uri attribute. This is because, the URL or host where the Managed Altair Units servers are running is already set internally in the Altair License JDK and any value entered by the product user will be ignored.

To authorize the machine against the managed Altair Units system, you have three options.

Option 1

Use an authorization code generated through Altair One:

Log on to Altair One (https://admin.altairone.com) then navigate to User Profile and select Authorized Machines.
Click .
The page displays the auth code and a timer indicating the code’s expiration.

Click Copy to Clipboard to copy the generated auth code.
Paste the generated code into the license.hwu.hosted.authorization.authcode property in the Panopticon.properties file.
Start the server.

Option 2

Directly use your Altair One credentials in Panopticon.properties:

Enter your Altair One credentials into the license.hwu.hosted.authorization.username and license.hwu.hosted.authorization.password properties in the Panopticon.properties file.
Start the server.

Option 3

Manually create a license authorization token using the ALMutil command line tool.

Install Altair License Manager on any machine and use ALMutil to manually create an authorization token from the Auth Code obtained from the Altair One Admin Portal. The created token is valid for any MAC address by specifying the -anyhost argument as follows:
- Windows (run as administrator)
  almutil -a1auth -anyhost -code NNNNN
- Linux
  sudo ./almutil -a1auth -anyhost -code NNNNN
  
  Where NNNNN is the Auth Code obtained from Altair One.
  
  A token will be generated. The token is long-lived and since it’s for anyhost, it can be generated on one machine and used on another one. However, note that the managed license units will be checked out on behalf of the machine on which the token was created.
Copy the token created and set it as the value of the property license.hwu.hosted.authorization.almutiltoken in the Panopticon.properties file.
Restart the server.
NOTE:
- The three different options for setting properties of the type license.hwu.hosted.authorization will be applied in the following order of priority, in case more than one option is configured at the same time:
  - license.hwu.hosted.authorization.almutiltoken
  - license.hwu.hosted.authorization.authcode
  - license.hwu.hosted.authorization.password and license.hwu.hosted.authorization.username
- The Auth Code generated on Altair One Admin Portal is valid for only 15 minutes and within that time frame, you must use it as described for Option 1 or Option 3, or otherwise the Auth Code will expire and no longer be valid for redeeming a long-lived token.
- In Option 2, Altair One credentials are only required at first restart of the server to generate the auth token and should be removed from the Panopticon.properties file going forward to avoid exposing these credentials.
- A working Internet connection is required to use Altair Units licensing.
- If your company uses proxy, you might need to add exception in your proxy to allow access to the Managed Altair Licenses.
  Please refer to these links for more information:
  - https://community.altair.com/discussion/39723/resolve-managed-license-ssl-issue-ssl-tls-handshake-failed
  - https://community.altair.com/discussion/39792/resolve-managed-license-http-error
  Or see Managed Altair Units License SSL Error section.
- If you don’t have an Altair One account, you can sign up for a free trial that will allow you to test the product for 14 days.

Intellectual Property Rights Notice | Technical Support