Client Entitlements
For the purposes of licensing entitlements, a client is computer that connects to an ICONICS Suite server for data or visualization. A license may include one or more client entitlements.
Client Types
There are three types of clients. Each client requires a different set of entitlements.
-
Desktop Client - The full GraphWorX64 application.
-
Standard Client - A web browser or the runtime-only GraphWorX64 application.
-
Mobile Client - The iOS or Android apps for MobileHMI or KPIWorX.
When you purchase a client, you will be given enough entitlements to run either that client or any client of a lower tier. For example, when you purchase a license for a desktop client you will be given the entitlements required to run either a desktop client, a standard client, or a mobile client. If you purchase a license for a standard client, you will be given entitlements required to run a standard client or a mobile client.
Read-Only or Write Clients
Clients can run in either read-only or write mode.
If the logged-in security user has been granted write license permissions, the client will attempt to run in write mode. It will attempt to use an available write client entitlement. If the write client entitlement is available, the client will run in write mode, otherwise it will run in read-only mode.
When a client is in read-only mode, it cannot write to external tags, such as OPC UA, database, or BACnet tags. These tags will appear with a status of read only.
A client in read-only mode can write to local variables and it can acknowledge alarms.
Multiple Applications on the Same Client Computer
If multiple copies of a client application are run on the same client computer in the same Windows session, they should only count as one client and use only one set of entitlements for that client type.
There are some conditions where a single computer may count as multiple clients:
-
Remote desktop- Remote desktop and similar technologies create new Widows sessions. These will be considered separate clients.
-
Multiple browser sessions- Different browsers, such as Chrome and Firefox, will count as separate clients. Different browser sessions, such as running the same Chrome browser under different profiles or using private mode, will also count as separate clients.
Here are some examples to illustrate how many client entitlements are required in certain situations:
| Example Situation | Client Entitlements Required |
|---|---|
| 3 copies of the GraphWorX64 application, running in the same Windows session. | 1 desktop client |
| 3 separate users with 3 separate remote desktop sessions, each running the GraphWorX64 application. | 3 desktop clients |
| 3 tabs in Edge under a single browser session | 1 standard client |
| 1 tab in Edge, 1 tab in Chrome | 2 standard clients |
| 1 normal tab in Edge, 1 private tab in Edge | 2 standard clients |
Client Entitlements
The entitlements shown in the license monitor do not exactly match up to the three client types. This table lists the different client entitlements as listed in the license monitor and which client types will use those entitlements.
| Entitlement as Listed in License Monitor | Desktop Client | Standard Client | Mobile Client |
|---|---|---|---|
| Advanced Client Stations | ✓ | ||
| Client Stations | ✓ | ✓ | |
| MobileHMI Client Stations | ✓ | ||
| Write Clients | possible | possible | possible |
Possible - These clients may consume a write client depending on the logged-in user and whether a write client entitlement is available. See Read-Only or Write Clients.
For example, if you have 1 GraphWorX64application and 3 web clients connected to your server, your license monitor will show 1 advanced client station in use and 4 client stations. The GraphWorX64 application will use both an advanced client station and a client station, while the 3 web clients will use one 1 station each. If they are being used by a user with write license permissions, they will use up to 4 write clients as well. If you had fewer than 4 write clients available, some of the clients will operate in read-only mode.
Client Feature Entitlements
Once a client is running, it may require feature entitlements to use certain features such as the alarm viewer. See Client Feature Entitlements.