Installing the private License Server in Windows OS for Axxon PSIM

Installation

To install the private License Server in Windows OS, do the following:

1. Create an activation request. To do this, you must collect the computer's HIDs using the LS_tool utility by running it in the command line:
   

   C:\Program Files\Common Files\VMS\VMS License Server>LS_tool.exe --collect-hwinfo

   Attention!

   The key binds to the License Server, not to Axxon PSIM. When using the Guardant key, make sure that the USB key is connected to the server where you install the License Server.

   
   
2. Contact an AxxonSoft technical support specialist to get the necessary License-server_InstallerWix.zip package and the keyfile.zip license key package for the private License Server.
   The keyfile.zip key package contains:
   1. Certificate: ngp.licserver.crt
   2. Private key: ngp.licserver.key
   3. Server key: server.license.key
   4. Client key: license.key
3. Run the License-server.msi file from the package received from an AxxonSoft manager. The installation is performed in the C:\Program Files\Common Files\VMS\VMS License Server directory.
   Once installed, the following is added:
   
   1. The VMS License Server program is added to Programs and Features.
   2. The VMS_License_Service is added to Services. It starts immediately after the installation. After restarting the server, the service starts automatically. In Task Manager in Processes, the process of the running service is called license_service.exe. After completing the process, a new process starts in one minute.
4. Add the server.license.key to the C:\Program Files\Common Files\VMS\VMS License Server\keys folder.
   

   Note

   When installing, make sure that the UI folder is unzipped from the license-server-ui.zip archive.

5. Rename the ngp.licserver.key private key to private.key and the ngp.licserver.crt certificate to keyfile.crt and add them to the C:\Program Files\Common Files\VMS\VMS License Server folder. Confirm the file replacement.
6. Create a .bat file with the following contents (port 443 must be open):
   

   set Path_to_server=C:\Program Files\Common Files\VMS\VMS License Server
   
   SET LEASE_ACCOUNTER_LSTOOL_PATH=%Path_to_server%\LS_tool.exe
   SET LEASE_ACCOUNTER_PUBLIC_KEY=%Path_to_server%\public.pem
   SET LEASE_ACCOUNTER_TLS_CERTIFICATE=%Path_to_server%\keyfile.crt
   SET LEASE_ACCOUNTER_TLS_CERTIFICATE_KEY=%Path_to_server%\private.key 
   SET LEASE_ACCOUNTER_TLS_AUTH_ENABLED=true
   SET LEASE_ACCOUNTER_LOG_DIR=%Path_to_server%\logs\
   SET LEASE_ACCOUNTER_BADGER_DIR=%Path_to_server%\badger
   SET LEASE_ACCOUNTER_LICENSE_FILES_DIR=%Path_to_server%\keys
   SET LEASE_ACCOUNTER_PORT=443
   SET LEASE_ACCOUNTER_HTTP_PORT=86
   
   license-server.exe

7. Run the created .bat file.
8. Wait for the full download and close the window.
9. In the C:\Program Files\Common Files\VMS\VMS License Server\keys folder, delete the server.license.key. Only the key named as the system ID must remain in the folder.
10. Re-run the .bat file again.

Installing the private License Server in Windows OS is complete. The License Server web interface is available at https://127.0.0.1:444/ (see Logging in to the License Server web interface).

Possible issues

Connection error

Axxon PSIM can fail to establish a connection with the License Server. This is due to the network-level connection blocking.

In this case, we recommend disabling the firewall on both the Axxon PSIM computer and the License Server computer.

Make sure that port 443 isn't occupied by another process.

Windows Server Error

It is possible that the Windows Server cannot work together with the IIS (Internet Information Services) process. In this case, we recommend stopping the process before running the License Server:

iisreset -stop

HTTP and HTTPS protocols

HTTP

To use the HTTP protocol on another port instead of port 80, do the following:

1. Contact an AxxonSoft manager and get the new keyfile.zip keys package that must contain:

   • Certificate: ngp.licserver.crt

   • Private key: ngp.licserver.key

   • Server key: server.license.key

   • Client key: license.key

2. Replace the keys and generate a new .bat file in the C:\Program Files\Common Files\VMS\VMS License Server\keys folder.

HTTPS

To use the HTTPS protocol on another port instead of port 443, do the following:

1. Contact an AxxonSoft manager and get the new keyfile.zip keys package that must contain:

   • Certificate: ngp.licserver.crt

   • Private key: ngp.licserver.key

   • Server key: server.license.key

   • Client key: license.key

2. Replace the keys and generate a new .bat file in the C:\Program Files\Common Files\VMS\VMS License Server\keys folder.