Licenses
Licenses are requested from the program itself and verified on the computer, without an Internet connection.
Try it without a license
Without a license, each program can be used for 10 minutes in total on each computer: in the License window, MasterGateway offers Demo mode (10 min) and the standalone programs offer Free trial (10 min). The time runs only while the program is open and adds up from one start to the next.
- During the trial you can connect, explore, read and monitor, but not save, export or copy data (CSV, Download logs…, saving frames, copying values or tables, Ctrl+C). Copy code, Copy request, Write e-mail… and Copy information remain available, as they are needed to request the license or support.
- When the trial ends, a license is required; without a license the program closes (profiles and lists are saved).
- Uninstalling and reinstalling does not restart the trial: the record that prevents it stays on the computer (see Privacy).
- MasterGateway Diagnostica is free and needs no license.
Two types of license
| MasterGateway | Standalone programs | |
|---|---|---|
| Bound to | The computer name and the PC code (system, motherboard and disk) | The PC code, different for each program |
| Specifies | Enabled protocols, maximum number of variables for each one, duration and maximum version | Duration |
| Hardware changes, copies and restores | If a single part (disk or motherboard) changes, it remains valid; if two change, or it is used on another PC, a new license is needed | Reinstalling the system or changing the PC or the motherboard changes the PC code: a new license is needed |
| Valid for | The window and masterkontact-cli | A single program |
Licenses for the standalone programs are not valid for MasterGateway, and the license of one standalone program is not valid for the others.
MasterGateway license
- Computer name (on Linux, the hostname), without the domain and not case-sensitive.
- PC code: three components (system, motherboard and disk), in six groups of six characters. The license remains valid if only one of the three changes.
- Enabled protocols and maximum number of variables for each one, for example Modbus 500 and DLMS 300. A protocol that is not included stays visible but does not connect; variables beyond the limit stay in the list but are not read. Browsing, searching and viewing the detail of the data does not count as a variable.
- Duration: perpetual or until an expiry date.
- Maximum version of the program: for example, a license up to 1.9 is valid for versions 1.0 to 1.9.
| Protocol | Identifier | A variable is |
|---|---|---|
| BACnet | bacnet | A property of an object in the watch list |
| SNMP | snmp | An OID in the monitored list |
| Modbus | modbus | A tag |
| OPC UA | opcua | A node in the watch list |
| OPC DA (Windows only) | opcda | An item in the watch list |
| IEC 60870-5-104 | iec104 | A monitored information object (IOA) |
| DLMS/COSEM | dlms | A monitored COSEM attribute (class + OBIS + attribute) |
| PROFINET DCP | pndcp | A monitored attribute of a device |
| PROFINET IO | pnio | A monitored field of a record |
| PROFINET RT | pnrt | A monitored item of a cyclic frame, or the data status |
The Hardware page is not a protocol and does not count towards the license.
How to request it
- Open MasterGateway. Without a license, the License window opens; otherwise, click License at the bottom right.
- Under 1. License request you will see the Machine name and the PC code. Under Requested protocols and variables, state the protocols and the number of variables for each one.
- Press Write e-mail… (opens the e-mail program with the request ready) or Copy request and paste the text into an e-mail addressed to us (Contact).
How to activate it
- In the reply e-mail, copy the whole block from
-----BEGIN MASTERKONTACT LICENSE-----to-----END MASTERKONTACT LICENSE-----. - Under 2. License key, press Paste (or Load .lic file… and choose the attached file) and then Activate license.
From the terminal, for example on a server without a desktop:
masterkontact-cli licenza richiesta --protocollo modbus=500 --protocollo dlms=300
masterkontact-cli licenza installa licencia.lic
masterkontact-cli licenza
The first command shows the request text to send to us; the second installs the license you received; the third shows the computer name, the PC code and the license status.
In the terminal, masterkontact-cli does not accept passwords or SNMP communities as command-line arguments: they are passed with --segreti-stdin, with the environment variables MASTERKONTACT_SNMP_COMMUNITY, MASTERKONTACT_SNMP_AUTH_PASSWORD and MASTERKONTACT_SNMP_PRIV_PASSWORD, from the saved profile, or by answering the prompt with hidden text.
A new license is needed if the computer name changes, if two parts of the PC change (or it moves to another PC), if you want another protocol or more variables, if you install a version higher than the maximum version, or when the license expires. MasterGateway licenses issued before 11/11/2026 (with the computer name only) are no longer valid: request a new one with the PC code.
License for the standalone programs
Master Protocols (BACnet), Master Protocols (SNMP), Master Protocols (Modbus), Master Protocols (OPC UA), Master Protocols (OPC DA), Master Protocols (IEC 60870-5-104), Master Protocols (DLMS/COSEM), Master Protocols (PROFINET DCP), Master Protocols (PROFINET IO) and Master Protocols (PROFINET RT) each have their own license, bound to the PC code. To use several programs you need a license for each one.
- In the License window (it opens by itself on the first start, or with a click on License: … at the bottom right) you will see 1. This PC's code, for example
AA09-FAE4-CE26-8DF1. - Press Write e-mail… or Copy request (or just Copy code) and send us the request.
- In the reply e-mail, copy the license block; under 2. License key, press Paste (or Load .lic file…) and then Activate license.
Ready-made license (without a PC code)
If you do not yet know which PC the program (MasterGateway or a standalone program) will be used on, we can issue a ready-made license, without a PC code. It is bound to the first PC on which it is activated and must be activated within the period stated in the e-mail (we set it when issuing the license, between 1 hour and 30 days; normally 24 hours); after that it works only on that PC and, once the period has passed, the original key can no longer be activated. The normal license remains the one issued with the PC code.
Verification without Internet
The programs verify the license on the computer itself, at startup and every hour: they need no Internet connection or license server and send no data to MasterKontact. That is why they also work in installations without an Internet connection.
Events for monitoring systems (MasterGateway)
When the license is not valid or expires (at startup or in the hourly check) and when the demo mode ends, MasterGateway (the window and masterkontact-cli) writes an event with a fixed ID for each reason, the computer name, the license ID and the program version. The event text is in Italian.
- Windows: Event Viewer, Application log, source
MasterKontact. When installing for all users, the installer registers the source so that the Event Viewer shows the full text. - Linux: syslog, identifier
MasterKontact; each line starts with[MKand the ID, for example[MK1008].
| ID | Reason |
|---|---|
| 1000 | License valid again after a problem |
| 1001 | License missing (file removed while the program was open) |
| 1002 | License unreadable or incomplete |
| 1003 | Invalid signature |
| 1004 | License for another product |
| 1005 | License format newer than the program |
| 1006 | License for another computer |
| 1007 | Program version not covered |
| 1008 | License expired |
| 1009 | Computer date earlier than the license issue date |
| 1010 | Demo mode ended without a license |
| 1011 | License with an expiry date and computer date earlier than the last use (clock set back) |
| 1012 | License of the old format (computer name only) |
| 1013 | Same computer name, but another PC (different code) |
| 1014 | Ready-made license not activated within the period |
| 1015 | Ready-made license already activated on another PC |
Prices and terms
Prices on request: write to us from the Contact page stating the program and, for MasterGateway, the protocols and the number of variables. Before any payment we send you a written offer with the total price, taxes, payment method and conditions; the license is also governed by the Terms of use.