HyperX uses the commercial FlexNet® software to serve out HyperX licenses over a network. The license server can be installed on both Windows and Linux machines. Once the license server is installed and running, connecting and configuring client computers with Windows or Linux servers is largely the same.
Important
For both Windows and Linux installs, the server MUST be installed on a physical machine.
-
Download the FlexNet License Manager files from the HyperX website. The link is included in a download email sent to you by Collier Research.
-
Open the downloaded zip file and extract the license manager files.
-
Create a folder on the server for these files.
-
Double-click lmtools. Find the Ethernet Address on the System Settings tab and email to licensing@collieraerospace.com to request a server license file. You can also click Save HOSTID Info to a File and email this file.
Once you have your license...
-
After you have received the license file, open the file in a text editor and edit the ServerName in the license file to reflect the host name or IP address of your server. Save the license file in the same folder containing "collierx.exe".
SERVER ServerName 123456789012
VENDOR collierx
...
-
Open lmtools. On the Config Services tab, enter a Service Name and Browse the paths for "lmgrd.exe" and the license file. Create a debug log file. Check Use Services and Start Server at Power Up.
-
On the Start/Stop/Reread tab, click Start Server.
To see the status of the licenses, go to the Server Status tab and click Perform Status Enquiry.
You can also check the status or troubleshoot problems with the server by clicking View Log on the Config Services tab.
A HyperX license server can be installed on the same machine running a HyperSizer license server, but separate versions of "lmtools.exe" must be used (one for HyperSizer, one for HyperX). Additionally, the license servers must operate on different ports in order to co-exist. See below for information on configuring custom ports.
The HyperX License Server can be run on Linux machines as well.
Note
Linux license servers are only supported by HyperX version 2024.2.13 and later. Attempting to access a HyperX license on a Linux machine in an earlier version will result in a Bad handshake detected error message.
To install the HyperX License Server on Linux:
-
Ensure that you have a server license file. You can request one by emailing the server's ethernet address to licensing@collieraerospace.com
-
Ensure that the directory
/usr/tmpexists on your machine. -
Ensure that
lmgrd,lmutil, andcollierxexecutables have their executable flag set to true. You can run these commands if they are not:chmod +x lmgrd chmod +x lmutil chmod +x collierx
-
You may need to specify a port in your license file. To determine which port you should use, check the logfile that the License Server generates. You should see a line near the top of the file indicating the port to use. In my case, that was 27000:
lmgrd tcp-port 27000
-
You can add the port to your license file as seen below:
-
Ensure that the indicated port is accessible to your users. You might need to adjust your firewall rules.
Running the Server
You should have a directory with the following files:
-
Executables:
lmgrd,lmutil, andcollierx -
A license file provided by Collier Aerospace:
*YourLicenseFileName*.lic
You can start the server with the following command:
./lmgrd -c *YourLicenseFileName*.lic -l logfile.log
Check running processes with the following command:
ps -u $USER
If the server and vendor daemon are running, they should be visible in the list:
Note
Check the logfile as desired to monitor the server. If there are any errors, you should see them in this file.
When HyperX is opened, it will automatically attempt to find a license. If HyperX can't find a license, it will pop-up the Application Settings window when it's opened so the user can specify where to find the license.
To use the license server:
-
Select the "License Server" checkbox.
-
Select the checkbox corresponding to the OS of the machine running the license server.
-
Input the server's IP address (or server hostname) and port.
-
Press the "Apply" button to save.
Create a System Environment Variable called “COLLIERX_LICENSE_FILE” that points to the license server computer. To create an environment variable, search in the start menu for "Edit the system environment variables".
On the System Properties dialog, go to the Advanced tab. Click the “Environment Variables” button.
Under User Variables, click New and create a new environment variable called “COLLIERX_LICENSE_FILE”. For the variable value, enter “@<ServerName>” where <ServerName> is the specific name of the license server.
Note that in some server environments, FlexNet licenses can be setup with specific port numbers for the purpose of configuring firewalls. If this is the case, then you can specify the port number of the HyperX license server by putting the port number before the @ symbol in the environment variable. For example, “52123@ServerName” points to port 52123 on the server called ServerName.
You can also use the server IP address, such as, “52123@192.168.1.101” which points to port 52123 on the server with IP address 192.168.1.101. After saving the environment variable, close and restart HyperX to access the license server.
In some server environments, FlexNet licenses must be set up with specific port numbers for the purpose of configuring a firewall. The default port number for the HyperX floating license is 27000. If you need to specify a different port number, simply add the desired port number to the end of the SERVER line in the HyperX license file. Adding a port number will not invalidate the license.
For example, a license file with an unspecified port number might look like the following,
SERVER ServerName 0123456789AB VENDOR collierx USE_SERVER ...
To specify a port number of 7005, simply add this port number to the end of the SERVER line,
SERVER ServerName 0123456789AB 7005 VENDOR collierx USE_SERVER ...
On the client side, if using an environment variable to point to the HyperX server license, specify the port number before the @ symbol in the environment variable. In the above example, the environment variable, "7005@ServerName" would point to port number 7005 on a server called "ServerName".
You can also use the server IP address, such as, “7005@192.168.1.101” which points to port 7005 on the server with IP address 192.168.1.101. After saving the environment variable, close and restart HyperX to access the license server.
In addition to opening a port for the main license server, users should add an inbound rule that allows traffic for the "collierx.exe" daemon on all ports.
-
Open "Windows Defender Firewall with Advanced Security" with Administrator permissions.
-
Select "Inbound Rules" and click "New rule..."
-
In the "New Inbound Rule Wizard", select "Program" and click "Next".
-
On the "Program" tab, specify the path to the daemon and click next.
-
On the "Action" and "Profile" tabs, select the default options ("Allow the Connection" and all network types, respectively).
-
On the "Name" tab, name the rule, optionally describe it, and click "Finish".