PmNetKey сервер лицензий - для PROMOTIC версия
Pm8.2.0 -
8.3.32. It allows to provide the PROMOTIC licence to applications via networks.
Пакет содержит установку присвоения лицензий PROMOTIC и программы мониторинга. Нет необходимости использовать эту программу, если доступна стандартная лицензия для применения PROMOTIC (
Hardware (USB) лицензионный ключ,
Файл лицензии SWK extending the content of licence key или
Software лицензионный ключ (.swk) bound to specific components of the Windows OS).
Скачайте файл напр.
PmNetKey10700.msi и запустите его на компьютере, который будет работать в качестве сервера лицензий PROMOTIC. Этот пакет установки установит сервер сетевых лицензий на этом компьютере. См.:
PmLicServer сервер лицензий.
PmNetKey |
PmNetKey сервер лицензий - для PROMOTIC версия Pm8.2.0 - 8.3.32 |
19.10.2017 |
22 MB |
Download |
PmNetKey allows to
provide the licence to PROMOTIC applications
via networks. This way, it is not needed to have licence in own ключ HW 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 connected to USB port.
PmNetKey is protected by its own ключ HW.
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 или
HTTPS protocol to the computer with the
PmNetKey program. The communication between PROMOTIC application and the сервер лицензий happens not only when the application is launching, but also after that, periodically (the period is around 1 minute или or slightly longer).
The network connection с сервером лицензий 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 (в сети) but the number of simultaneously running applications can not exceed the number of runtime licence present on the licence server. Если, For example, there are 2 runtime licences present on the licence server, then it is possible to run 2 приложения simultaneously. Additional application (third) can not be launched. Если one of the running applications is stopped and thus does not communicate с сервером лицензий for
10 minutes, then its licence is released on the сервер лицензий and available to be used by another application. Now it is possible to run the other application - it will use this released licence.
The PROMOTIC application network licence для
PmNetKey are provided в форме of the licence file (см.
Network лицензионный ключ). The licence file is functional only with the corresponding сервер лицензий, it was generated for. It will not function with another сервер лицензий.
Установка, uninstallation of the licence server and service configuration
The program has its own installation file, because it is often installed on a computer, where система PROMOTIC is not present. The installation program can be downloaded from
https://www.promotic.eu/ru/promotic/download/download.htm (напр.
PmNetKey XXYYZZ.msi). The program is to be installed on the computer that is going to act as a сервер лицензий. 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
ОС Windows resources (
services.msc service manager).
PmNetKey is protected by its own ключ HW. The program is not functional without the ключ HW. The ключ HW must be generated especially for this purpose, normal PROMOTIC application ключ HW cannot be used in such case.
The ключ HW 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 например в
ОС Windows *.bat files. Usually it is not necessary to use such commands because the
ОС Windows service is configured during the program установка process and it is removed when the program is uninstalled. The configuration, stopping and launching is provided by using the standard
ОС Windows resources. Individual commands:
PmNetKey -i - Adds the ОС Windows service для the PmNetKey program. The service will be configured in order to launch automatically on system boot. It is done automatically during the program установка.
PmNetKey -u - Removes the ОС Windows service of the PmNetKey program. It is done automatically during the program uninstallation.
PmNetKey -s - Launches the ОС Windows service of the PmNetKey program.
PmNetKey -k - Stopps the ОС Windows service of the PmNetKey program.
PmNetKey - Launches the PmNetKey program as a normal application, not as Windows service. Application icon appears in the ОС Windows Sys Tray among icons on the right. This can be handy for testing purposes.
Licence server configuration
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 или
C:\Program Files (x86)\Promotic).
Описание of the keys in the
[Config] section:
WebServer - The key allows to modify the port and протокол (
HTTP или
HTTPS) that will be used for listening by the internal Web-сервер of the
PmNetKey program.
If not set, then the default value
http://+:81/ is used, it means that the
HTTP протокол 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.
Example1:
Example of the PmNetKey.ini configuration file (HTTP протокол and port 83):
[Config]
WebServer=http://+:83/
Example2:
Example of the PmNetKey.ini configuration file (HTTPS протокол and standard port 443):
[Config]
WebServer=https://+:443/
LogDir - This key allows change of the default foder where the
Log файл will be located.
If not set, then the
Log файл is located in the same folder as the
PmNetKey.exe program. Be informed that the default installation directory may be read only.
Example:
Example of the PmNetKey.ini configuration file for placing the Log file into the "C:\Windows\Temp" folder:
[Config]
LogDir=C:\Windows\Temp
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).
Example:
Example of the PmNetKey.ini configuration file that enables logging of periodical client licence refresh into the Log file:
[Config]
LogRefresh=1
Medium - This key allows to define the specific ключ HW that is used for runtime protection of the
PmNetKey сервер лицензий.
It may contain a list of HW Keys (separated by comma) that is being evalueated starting from first entry until the first connected ключ HW is found (напр.
hwkey:k1234,hwkey:k1111).
If not set, then the default value
"hwkey" is used, meaning any Ключ HW.
If the list is not defined and while multiple HW Keys are connected to the computer then after the computer is rebooted the сервер лицензий may get paired with another ключ HW.
Example:
Example of the PmNetKey.ini configuration file that defines the specific ключ HW with licence number 1234 for the protection of the licence server:
[Config]
Medium=hwkey:k1234
Commissioning the HTTPS протокол of the licence server:
The implementation of the licence server (Web-сервер) is provided by the
ОС Windows "HTTP service". The configuration of HTTPS протокол is done axactly the same way, as for the HTTPS protocol in the
PmaWeb object, то есть by the utility
PmHttpConfig.exe (it is necessary to set the rights, импорт the certificate of the server and connect it with the corresponding Web-сервер).
Monitoring the сервер лицензий functionality
The program allows to monitor the current state of provided network licences and also the history of network licence clients logins and logouts. The monitoring is provided via the Web interface.
PmNetKey содержит an internal Web-сервер, that offers the
info.html и
log.html pages on it s IP address, протокол and port. For example
http://localhost:81/info.html и
http://localhost:81/log.html.
Behavior of the PROMOTIC application when the connection с сервером лицензий is lost
Если the periodic communication с сервером лицензий is permanently failing, then the
running PROMOTIC application goes through the following states:
1) information - first, the error message about the failed communication с сервером лицензий is displayed in global errors. This state is reached after the first failure of the periodical communication. This state lasts around 10 minutes.
2) warning - after that, the warning window is displayed (repeatedly если the user closes it) and in the global errors the communication failure message is displayed. This state lasts around 48 hours.
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 с сервером лицензий. Если the communication с сервером лицензий 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 с сервером лицензий can be used.
If the connection с сервером лицензий is not functional, the PROMOTIC application cannot be launched. The time interval protection приложения before it is stopped, because of the сервер лицензий communication failure is applied only for application that are allready running.
Commissioning the SWK licence files on the licence server and the licence client
a) Licence server - The licence file it is necessary to copy into the "C:\Program Files\Promotic" folder или C:\Program Files (x86)\Promotic folder.
[Licence]
Medium=netkey:http://192.168.1.99:81/Pm1234.swk
где the
netkey indicates the network licence,
http или
https specifies the протокол, followed by the IP address или computer name, internal Web-сервер port and the licence
SWK file название.
Caution:
Logged-in
Windows user must have the permissions for writing into following files: