Skip to content

License manager

The License page under ADMIN shows the licence state of an instance, its fingerprint, and which features and component groups are licensed and available. Select ADMIN in the side menu, then License. A user needs the Security administration permission to view or change this page.

The page shows:

  • State: Valid, Trial, Expiring, Expired, Invalid, WrongInstance, UnsupportedVersion, or Missing. A licence file whose expiry is 30 days or less away is reported as Expiring instead of Valid or Trial.
  • Type: Commercial, Trial, or LocalTrial (the automatic in-product trial).
  • Edition: the commercial edition name, shown for information only, because availability follows the individual features and components in the licence.
  • Customer: the customer name or ID recorded on the licence.
  • Expires: the expiry date and, where applicable, the number of days remaining.
  • Fingerprint: the unique identifier for this installation, with a button to copy it.
  • Licensed features: a table of every product feature. It shows whether the feature is licensed, whether it is currently available (licensed and not blocked by configuration), and, if unavailable, what is blocking it.
  • Licensed component groups: the same status for licensed component groups, such as protocol or hardware-integration bundles.

On a server, each of these states leaves Profinity running in restricted mode. Install a licence that matches this server and this release. The page shows the raw state name, and the banner gives the reason:

  • Missing: no licence file is installed. A file that is present but cannot be read is treated the same way. Banner: "No licence is installed."
  • Invalid: the token does not verify, the start date is still in the future, the licence type is not a known type, or the file holds a local trial. A local trial lives in trial.state. Banner: "The licence is not valid."
  • WrongInstance: the licence names a server and this server's fingerprint is different. Banner: "The licence is for a different server." The check is skipped when the licence names no server, or this server has no fingerprint yet.
  • UnsupportedVersion: this release is newer than the licence's maximum product version, or the maximum is not a version. A maximum of 2.3 still allows every 2.3.x release. Banner: "The licence version is not supported by this release." The check is skipped when the maximum is blank.

The banner then says: "Profinity is running in restricted mode. Install a licence to restore access."

The License page showing licence state, edition, expiry date, fingerprint, and the tables of licensed features and component groups

The License page under ADMIN, showing status, entitlements and fingerprint

A feature can be licensed but still unavailable, for example when it has been turned off in site configuration. The Licensed column always reflects the licence file. The Available column reflects the actual runtime state and names what blocks the feature when it is unavailable.

Component groups are licensed separately from product features. For example, the BACnet, EtherNet/IP, Modbus, Open Platform Communications Unified Architecture (OPC UA), and S7 industrial protocol plugins all need the Industrial Protocols component group. Tag Relays need the Data Relay feature. The components need the matching entitlement; otherwise they show as unavailable, even when the plugin is installed.

To change the licence, refer to Apply a licence. For what each edition includes, the 14-day local trial, and the machine fingerprint, refer to Licensing.