License

At the end of this guide, the hub runs with an active license and you know how much of it each edge gateway uses.

Before you start

• Sign in with a user that has the Administrators role.
• To activate: a license key from Proxus or your distributor, issued for this installation's License ID.

What a license contains

A Proxus license sets these entitlements:

The license also has an expiry date. It is checked on the hub against a signature, so checking it needs no internet connection. To ask for a license, a larger tier or an extension, use the contact form or ask your distributor. On a network without internet access, see Install without internet access.

Activate a license

When the hub has no valid license (a new installation, an expired license), the License Activation window opens after you sign in.

1. Copy the License ID with Copy and send it to Proxus or your distributor. The key they send back works only for this ID. For a 30-day trial, take the key yourself: in the Proxus portal, sign in and select Get a trial licence. The portal keeps the key, so you can copy or download it again later.
2. Paste the key into License key.
3. Tick I have read and accept the End User License Agreement.
4. Select Activate License.

Select Sign out to leave the window without activating.

Read your entitlement and live capacity

Go to Platform > License Info. The window shows the capacity tier and the expiry date at the top.

1. License Entitlement: what the license allows. License status is V2 for a current license. An older (V1) license says so in red: from Proxus 2.1 it drops no values, it only warns when a gateway is above the rate shown, and it should be renewed as a V2 license.
2. Live Capacity (per gateway): for every running gateway, its Health, the values per second it passes on now (Observed dp/s) against the licensed rate, the burst reserve left, and how many values it accepted and rejected since it started.
3. Deactivate License removes the license from this hub.

Health is Healthy below 70 % of the sustained rate, Warning from 70 %, Critical from 90 %, and Exceeded when the gateway has rejected values. Stale means the hub has had no report from that gateway recently. Until a gateway reports, the table says it is waiting for the edge gateway heartbeat.

What happens at the limits

What counts against the rate, and how you are warned

A gateway counts each value it passes on to its data targets, once per reading, however many targets receive it. Values that only go to rules or to pipelines-only targets are not counted. The hub shows this same number everywhere: Observed dp/s here, and the ingest rate in the Operations Center, with the share of the licensed rate in use (License: … values / s · … % in use).

The burst reserve holds about three seconds of the sustained rate and refills at that rate. A short peak above the limit uses it; a rate that stays above the limit empties it, and then values are dropped.

Each gateway's capacity also raises an alarm in Monitor > Alerts, with the source System:

A gateway has one capacity alarm at a time. It never goes down while it is open, so a gateway that dropped values stays a critical alarm until it is healthy again or someone closes it. When the alarm opens or rises, everyone signed in to the hub sees a notification. A gateway that only touches a threshold for a moment does not raise and close alarms: it returns to a lower health only after a minute below it.

Deactivate a license

Deactivate a license when you retire an installation or move the license to another one.

1. Open Platform > License Info.
2. Select Deactivate License and confirm with Deactivate.

The license is removed and you are signed out. Licensed features stop until a license is activated again.

Manage company licences in the Proxus portal

Commercial licences are given to a company in the Proxus portal. Create your company there and invite your colleagues by email. The Proxus team verifies the company and defines the licences you bought.

1. In the portal, choose your company from the workspace menu at the top and select Licences.
2. Next to a licence marked Waiting to be bound, select Bind to an installation →.
3. Paste the hub's License ID, give the installation a name and select Bind and create key.
4. Copy the key or download the .lic file, and activate it on the hub as in Activate a license.

To move a licence to a new server, deactivate it on the old hub first. Then, on the licence's page in the portal, enter the new installation's License ID under Move to another installation. Three moves a year are included. Owners and admins of the company bind and move licences; members see the licences and download their keys.

When Proxus renews a licence or changes its capacity, the new key for the same installation is emailed to the company's owners and admins and shown on the licence's page in the portal. On the hub, deactivate the old license first, then activate the new key.

What's next

• Watch capacity and health over time
• Manage edge gateways