Automate client computer configuration for softkey and Red USB key network installations (Zemax legacy)

This article describes how an Opticstudio or Lensmechanix network license administrator can edit a file on the client machines. This allows you to configure multiple client computers to reach the correct license server without having each user enter the server name manually. This article does not apply to those using Ansys licenses. 

Authored By Alissa Wilczynski


As the network administrator installing OpticStudio, OpticsViewer or OpticsBuilder on several client machines, you may find that the clients do not automatically locate the network license server. This can be resolved by entering the server name or IP address into the Sentinel Admin Control Center as described in Configuring Zemax applications to access a Zemax network license.

Follow the instructions in this article to automate this process.

Before continuing this article, please read! 



This article applies to software licensed via legacy Zemax licenses. Legacy Zemax licenses include all USB-based licenses, licenses with 5-digit numeric serial numbers (e.g. 22000), and 6-digit alpha-numeric serial numbers beginning with "L" or "T" (e.g. L100000). You can identify your license type using the guide located here: How to identify your legacy Zemax license. 

If you are using Ansys-licensed versions of Zemax software, see Ansys Zemax licensing overview and guides to see if there is an article on configuring machines with a file. 

Setting up the license configuration file.

Step 1: Move to a client computer where OpticStudio has already been installed and is working.

Step 2: Verify the settings are correct by opening the Sentinel Admin Control Center "Access to Remote License Managers" section - normally located at this address: http://localhost:1947/_int_/config_to.html. The following screen should appear. Verify the correct server name is in the "Place.IP.Address.Here" section, and that both "Broadcast Search" and  "Allow Access to remote licenses" is checked.

Step 3: Navigate to C:\Program Files (x86)\Common Files\Aladdin Shared\HASP folder. 

Step 4: Find the file called hasplm.ini. The file contains all the settings for the Admin Control Center including the server name you verified in step 2. OpticStudio will use these settings when launched. 

Step 5: It can now be copied into the same folder directory on any client machine. Note that you will need Administrator rights on the client machine you copy the file to. 

Important: After copying the file to the client machine, you will need to either restart the computer, or the Sentinel LDK Licensing Service for changes to take effect.

To restart just the service, you may either:

  • Open the Start menu, and search for services.msc
  • Open Control Panel...System and Security...Administrative Tools...Services 

Next, right-click on Sentinel LDK License Manager (also called HASPLMS) and select Restart.

Step 5: Verify that OpticStudio launches successfully.

Changing settings in the file

If you would like to change the server name or other settings, you can also edit the HASPLM.INI file and re-deploy it to the client machines rather than getting a new file from the client machines. 

Open the hasplm.ini configuration file in Notepad or another text editor. The [REMOTE] section shown below covers the same settings as found on the "Access to Remote Licenses" section of the Admin Control Center. Note the serveraddr field can be either the server's network name OR an IP address. 


Was this article helpful?
0 out of 0 found this helpful



Article is closed for comments.