сервер лицензий - для PROMOTIC версия Pm8.2.0
. It allows to provide the PROMOTIC licence to applications via networks.
Пакет содержит установку присвоения лицензий Promotic и программы мониторинга. Нет необходимости использовать эту программу, если доступна стандартная лицензия для применения Promotic (Hardware (USB) licence key
, Файл лицензии SWK extending the content of licence key
или Software licence key (.swk) bound to specific components of the WINDOWS operating system
Скачайте файл напр. PmNetKey10700.msi и запустите его на компьютере, который будет работать в качестве сервера лицензий PROMOTIC. Этот пакет установки установит сервер сетевых лицензий на этом компьютере.
См.: PmLicServer сервер лицензий
|PmNetKey ||PmNetKey сервер лицензий - для PROMOTIC версия Pm8.2.0 - 8.3.32 ||19.10. 2017 ||22 MB || |
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 PROMOTIC applications 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 typicaly automatically
launched on computer boot as a service
of the ОС Windows
In order to assure correct functionality it is necessary, that the computers with PROMOTIC applications (licence clients) have network connectivity via the HTTP
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 with the сервер лицензий must be functional during the whole time the PROMOTIC application is running.
The licence on the сервер лицензий are so-called "floating"
: The PROMOTIC applications can be launched on any PC (connected to the network) but the number of simultaneously running applications can not exceed the number of runtime licence present on the сервер лицензий. Если, For example, there are 2 runtime licence present on the сервер лицензий, then it is possible to run 2 applications simultaneously. Additional application (third) can not be launched. Если one of the running applications is stopped and thus does not communicate with the сервер лицензий for 10 минут, 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 in the form of a licence file (см. Network licence key
). The licence file is functional only with the corresponding сервер лицензий, it was generated for. It will not function with another сервер лицензий.
Установка, uninstallation of the сервер лицензий and service configuration
The program has its own installation file, because it is often installed on a computer, where the PROMOTIC system 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 сервер лицензий. While being installed, the program is configured as service ОС Windows
with automatic launch on system boot. The PmNetKey
service can be configured, stopped and launched by using the standard ОС Windows
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 например in ОС Windows
*.bat files. Usually it is not necessary to use such commands, because the ОС Windows
service is configured during the program installation 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 for 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 ОС 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 a 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
(the typical location is: C:\Program Files\Promotic
или C:\Program Files (x86)\Promotic
Описание of the keys in the [Config] section:
- The key allows to modify the port and протокол (HTTP
) 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
protocol 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.
Example of the PmNetKey.ini configuration file for the HTTP protocol and port 83
Example of the PmNetKey.ini configuration file for the HTTPS protocol and default port 443
- 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 read-only.
Example of PmNetKey.ini configuration file for
- This key defines whether the information regarding client licence refersh is written into the Log
file. Значение 1
) enables writing, значение 0
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 licence client refresh into the Log
file is disabled (значение 0
Example of the PmNetKey.ini configuration file that enables logging of periodical client licence refresh into the Log file
- This key allows to define the specific HARDWARE key
that is used for runtime protection of the PmNetKey
licence server. It may contain a list of HARDWARE keys
(entries separated by commas) that is being evalueated starting from the first entry until the first connected HARDWARE key
is found (напр. hwkey:k1234,hwkey:k1111
). If not set, then the default value "hwkey"
is used, meaning any HARDWARE key
. If the list is not defined and while multiple HARDWARE keys
are connected to the computer then after the computer is rebooted the licence server may get paired with another HARDWARE key
Example of the PmNetKey.ini configuration file that defines the specific HARDWARE key with number 1234 for the protection of licence server.
Commissioning the HTTPS protocol of the сервер лицензий:
The implementation of the сервер лицензий (Web server) is provided by the ОС Windows
HTTP service. The configuration of HTTPS protocol is done axactly the same way, as for the HTTPS protocol of 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 server).
Monitoring the сервер лицензий functionality
The program allows to monitor the current status of provided network licence 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
pages on it s IP address, protocol and port. For example http://localhost:81/info.html
Behavior of the PROMOTIC application when the connection with the сервер лицензий is lostЕсли the periodic communication with the сервер лицензий 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 сервер лицензий is displayed in global errors. Dhis state is reached after the first failure of the periodical communication. This state lasts around 10 минут.
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 часов.
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 сервер лицензий. Если the communication with the сервер лицензий 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 to the сервер лицензий is not functional, the PROMOTIC application cannot be launched.
The time interval protection of the application 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 сервер лицензий and the licence client
a) Licence server - The licence file it is necessary to copy into the C:\Program Files\Promotic или C:\Program Files (x86)\Promotic folder.
где the netkey
indicates the network licence, http
specifies the протокол, followed by the IP address или computer название, internal Web server port and the licence SWK file название.
user must have the permissions for writing into following files: