Download der Unterstützung des PmNetKey

PmNetKey Lizenzserver - für PROMOTIC version Pm8.2.0 - 8.3.32. It allows to provide the PROMOTIC licence to applications via networks.
Der Inhalt ist durch Programminstallierung für Nachführung und für Zuordnung von PROMOTIC-Netzlizenzen gebildet. Das Programm ist nicht nötig zu installieren, wenn es für PROMOTIC-Applikation normale verfügbare Weise von Applikationslizenzierung gibt (Hardware (USB) Lizenzschlüssel, Die Lizenzdatei SWK extending the content licence carrier oder Software Lizenzschlüssel (.swk) bound to specific components of the Windows OS).
Laden Sie das Download-File z.B. PmNetKey10700.msi. Dieses sollte auf dem PC, der dem Netzserver von PROMOTIC-Lizenzen wird, gestartet werden. Die Installierung führt die Programminstallierung für Netzlizenzen auf dem Server durch. Siehe: PmLicServer Lizenzserver.

PmNetKey PmNetKey Lizenzserver - für PROMOTIC version Pm8.2.0 - 8.3.32 19.10.2017 22 MB

PmNetKey allows to provide the licence to PROMOTIC applications via networks. This way, it is not needed to have licence in own HW-Schlüssel for each individual PROMOTIC application. This licencing procedure can also solve problems of the PROMOTIC application running in virtualized environment, where the PROMOTIC application cannot access the physical HW-Schlüssel connected to USB port. PmNetKey is protected by its own HW-Schlüssel. PmNetKey is usually automatically launched on computer boot as Windows service.

In order to assure correct functionality it is necessary, that the computers with the PROMOTIC application (licence clients) have network connectivity via the HTTP oder HTTPS protocol to the computer with the PmNetKey program. The communication between PROMOTIC application and the Lizenzserver happens not only when the application is launching, but also after that, periodically (the period is around 1 minute oder or slightly longer). The network connection with the licence server must be functional during the whole time the PROMOTIC application is running.

The licence on the licence server are so-called "floating": The PROMOTIC applications can be launched on any PC (im Netz) but the number of simultaneously running applications can not exceed the number of runtime licence present on the licence server. Wenn, For example, there are 2 runtime licences present on the licence server, then it is possible to run 2 applications simultaneously. Additional Applikation (third) can not be launched. Wenn one of the running applications is stopped and thus does not communicate with the licence server for 10 Minuten, then its licence is released on the Lizenzserver and available to be used by another application. Now it is possible to run the other Applikation - it will use this released licence.

The PROMOTIC application network licence für PmNetKey are provided in der Form of the licence file (siehe Network Lizenzschlüssel). The licence file is functional only with the corresponding Lizenzserver, it was generated for. It will not function with another Lizenzserver.

Installation, uninstallation of the licence server and service configuration

The program has its own installation file, because it is often installed on a computer, where das PROMOTIC System is not present. The installation program can be downloaded from (z.B. PmNetKey XXYYZZ.msi). The program is to be installed on the computer that is going to act as a Lizenzserver. During the installation, the program is configured as Windows service with automatic launch on system boot. The PmNetKey service can be configured, stopped and launched by using the standard OS Windows resources (services.msc service manager).
PmNetKey is protected by its own HW-Schlüssel. The program is not functional without the HW-Schlüssel. The HW-Schlüssel must be generated especially for this purpose, normal PROMOTIC application HW-Schlüssel cannot be used in such case. The HW-Schlüssel must be permanently present in the USB port of the computer that is running the PmNetKey.

The program (service) can also be controlled from the command line by entering parameters. The command line window must be launched with the Administrator rights. The commands are relevant in some special cases z.B. in OS Windows *.bat files. Usually it is not necessary to use such commands because the OS Windows service is configured during the program installation process and it is removed when the program is uninstalled. The konfiguration, stopping and launching is provided by using the standard OS Windows resources. Individual commands:
PmNetKey -i - Adds the OS Windows service für the PmNetKey program. The service will be configured in order to launch automatically on system boot. It is done automatically during the program installation.
PmNetKey -u - Removes the OS Windows service of the PmNetKey program. It is done automatically during the program uninstallation.
PmNetKey -s - Launches the OS Windows service of the PmNetKey program.
PmNetKey -k - Stopps the OS Windows service of the PmNetKey program.
PmNetKey - Launches the PmNetKey program as a normal Applikation, not as Windows service. Applikation icon appears in the OS Windows Sys Tray among icons on the right. This can be handy for testing purposes.

Lizenzserver konfiguration

The program is configured via the PmNetKey.ini configuration file. This file is created automatically during the installation and is located in the same folder as PmNetKey.exe (usually in the folder: C:\Program Files\Promotic oder C:\Program Files (x86)\Promotic).
Beschreibung of the keys in the [Config] section:
WebServer - The key allows to modify the port and protokoll (HTTP oder HTTPS) that will be used for listening by the internal Web-server of the PmNetKey program.
If not set, then the default value http://+:81/ is used, it means that the HTTP protokoll and port 81 are used.
The ";" character at the beginning of the line changes it to a comment. Such line is not taken into account.
Beispiel of the PmNetKey.ini configuration file (HTTP protokoll and port 83):
Beispiel of the PmNetKey.ini configuration file (HTTPS protokoll and standard port 443):
LogDir - This key allows change of the default foder where the Log file will be located.
If not set, then the Log file is located in the same folder as the PmNetKey.exe program. Be informed that the default installation directory may be nur für lesen.
Beispiel of the PmNetKey.ini configuration file for placing the Log file into the "C:\Windows\Temp" folder:
LogRefresh - This key specifies whether the information regarding client licence refersh is written into the Log file. The 1 value enables writing, The 0 value disables writing. The default logging period is 1 minute for each client.
This may be useful for debugging problems with network licences but from long term point of view, periodically logging this information may overwrite other important logs from the circular log file(s).
If not set, then the logging of the licence client refresh into the Log file is disabled (the 0 value).
Beispiel of the PmNetKey.ini configuration file that enables logging of periodical client licence refresh into the Log file:
Medium - This key allows to define the specific HW-Schlüssel that is used for runtime protection of the PmNetKey Lizenzserver.
It may contain a list of HW Keys (separated by comma) that is being evalueated starting from the first entry until the first connected HW-Schlüssel is found (z.B. hwkey:k1234,hwkey:k1111).
If not set, then the default value "hwkey" is used, meaning any HW-Schlüssel.
If the list is not defined and while multiple HW Keys are connected to the computer then after the computer is rebooted the Lizenzserver may get paired with another HW-Schlüssel.
Beispiel of the PmNetKey.ini configuration file that defines the specific HW-Schlüssel with licence number 1234 for the protection of the licence server:

Commissioning the HTTPS protocol of the licence server:

The implementation of the licence server (Web-server) is provided by the OS Windows "HTTP service". The konfiguration of HTTPS protocol is done axactly the same way, as for the HTTPS protocol in the PmaWeb object, d.h. by the utility PmHttpConfig.exe (it is necessary to set the rights, Import the certificate of the server and connect it with the corresponding Web-server).

Monitoring the Lizenzserver functionality

The program allows to monitor the current status of provided network licences and also the history of network licence clients logins and logouts. The monitoring is provided via the Web interface. PmNetKey contains an internal Web-server, that offers the info.html und log.html pages on it s IP address, protocol and port. For example http://localhost:81/info.html und http://localhost:81/log.html.

Behavior of the PROMOTIC application when the connection with the licence server is lost

Wenn the periodic communication with the licence server is permanently failing, then the running PROMOTIC application goes through the following states:
1) information - first, the error message about the failed communication with the licence server is displayed in global errors. This state is reached after the first failure of the periodical communication. This state lasts around 10 Minuten.
2) warning - after that, the warning window is displayed (repeatedly wenn the user closes it) and in the global errors the communication failure message is displayed. This state lasts around 48 Stunden.
3) error - finally, the situation is evaluated as fatal error, the application is stopped and licence error message is displayed in the global errors.
The states 1) and 2) are immediately terminated after first successfull periodical communication with the licence server. Wenn the communication with the licence server fails permanently, then the application is stopped after 48 hours. The method Pm.LicenceInfo(10) for detection of time that has passed since the last successfull communication with the licence server can be used.
If the connection with the licence server is not functional, the PROMOTIC application cannot be launched. The time interval protection of the application before it is stopped, because of the Lizenzserver communication failure is applied only for Applikation that are allready running.

Commissioning the SWK licence files on the licence server and the licence client

a) Lizenzserver - The licence file it is necessary to copy into the "C:\Program Files\Promotic" folder oder C:\Program Files (x86)\Promotic folder.
b) Licence client - In the application INI file (for runtime - PmRt), oder in PROMOTIC INI file (for the development environment - PmDev und PmDevSchool) (ab Version Pm8.3.0) it is necessary to create the section [Licence] and in this section to create the key Medium as described below (reference to a PmNetKey and to a specific Network Lizenzschlüssel):
wo the netkey indicates the network licence, http oder https specifies the protokoll, followed by the IP address oder computer name, internal Web-server port and the licence SWK file Name.

Logged-in Windows user must have the permissions for writing into following files:
- app.ini files of the PROMOTIC application bound to PmLicServer Lizenzserver
© MICROSYS, spol. s r.o.