Licenses

In order to generate a license keys, you must first obtain the unique serial number or hardware identifier of the node. This hardware identifier may be a:

• MAC Address
• Serial number
• Other unique hardware identifier

For some hardware types, the MAC address or serial number may be listed on a label on the outside of the hardware.

For the Siemens CP 343-1 ERPC module, the serial number is listed as the SVP number displayed under the front cover and on the side (under the part number) of the CP 343-1 ERPC module.

The possible hardware identifiers for a node are available from the Workbench, Node Administration tab, as described in the following steps:
It is assumed that you have started the Workbench and successfully logged on

1. From the left pane, expand the node for which you want to obtain the hardware identifier
2. Click Administration.
   
   The Administration screen appears
   
3. Select the Node Administration tab.
   
4. Next to the label MAC Address (for many node types), Serial Number (for MESInterface IT) or SVP Number (for Siemens ERPC), record one of the strings that appear.
   Some node types display several hardware identifier strings, for example: a MAC address, a serial number, an IMEI, and an ICCID. Only one of the hardware identifier strings is needed for the license generation step.
   
   You can select and then copy the characters using Ctrl-C. Later you can paste the characters using Ctrl-V.

Now that you have the hardware identifier, you will be able to generate license keys.

If you are using the deviceWISE Cloud and your organization is configured to access the Gateway licenses feature, you can generate license keys using the Management Portal.

For more information, see Gateway Licenses.

Otherwise, contact Technical Support for information on requesting and receiving license keys.

An Asset Gateway or Enterprise Gateway can automatically download licenses when it connects to the deviceWISE Cloud. This automatic downloading of licenses only takes place if the node does not currently have any licenses. For example: When the node connects over TR50 to the deviceWISE Cloud for the first time. For more information, see: Access Tokens.

You can use the Licenses tab to import a license file into the node. Follow these steps:

1. At the bottom of the Workbench Administration -> Licenses tab, select Import.
   
   The License File Location window appears.
   
   
2. Change to the location of the downloaded license file on the computer running the Workbench.
   
   
3. Select the license file you want to import, and then select Open.
   
   A message will list the license keys to be imported.
   
   Select Yes.
   
   
4. A message will tell you that the licenses were successfully added.
   
   Select OK.
   
   
5. Select Refresh.
   The license information is added to the Licenses tab.

You can use the Licenses tab to add a single a license key into the node. Follow these steps:

1. At the bottom of the Workbench Administration -> Licenses tab, select New.
   
   The New License window appears.
   
2. In the License Key box, enter the license key, and then select OK.
   You can also copy (Ctrl-C) the license key from its source and then paste (Ctrl-V) the license key into the License Key field.
   
3. A message appears indicating the new license was added to the node.
   Click OK.
   
4. Click Refresh.
   The license information is added to the Licenses tab.
   

After you have completed adding license keys to a node, the Gateway Developer's Guide and Reference sections have information on application development, configuration, and the features enabled by the licenses just added.

License keys is exported to a file by selecting the license key(s), right-clicking and selecting the Save to File option.

Part of a node's start up processing is to check the licenses that have been added to the node to see if they are valid for the node. If they are no longer valid for the node, temporary emergency licenses are created. The temporary emergency licenses allow the node to access the features that it is entitled to based on the licenses that are no longer valid.

The existence of emergency licenses is indicated by the red ribbon at the bottom of the Workbench when any of the node's windows are displayed. The details of the licenses for the node are shown on the Administration -> License tab. For example:

Emergency license considerations

• Licenses generated for a node using a specific hardware ID are only valid for that node, they cannot be used on a node with a different hardware ID.
• Licenses may or may not have an expiration date, but the expiration of a license does not create an emergency license.
• Evaluation licenses may be able to be generated without entering a hardware ID.
• If you misplace a license that you previously generated from the Management Portal, you can download a copy of the license information and import it into a node.
• If a node has a hardware problem and the hardware ID changes, for example a network interface card fails and a replacement card has a different MAC Address, a new license must be generated to match the new MAC address.
  In the interim time frame, emergency licenses should have been created to allow the node to continue to use the features it is entitled to use.
• Emergency license have an expiration date as indicated on the Licenses tab in the Expiration column. The emergency licenses have the term "Emergency" in the Features description and have a red background.
• The license(s) that caused the emergency license to be created will indicate Hardware ID Mismatch in the Status column.
• Beginning with release 16.1.9, the generation of an emergency license takes into account the presence of a valid license for a feature set. If there is a valid license for a feature set, then an invalid license for the same feature set will no longer cause an emergency license to be generated.  Some configurations may include a set of licenses for multiple hardware IDs. For example: one set of licenses for MAC address "A" and a second set of licenses for MAC address "B", where only one of the MAC addresses would be valid depending on the system's current operating environment (cluster and High Availability environments).
• License keys can be exported to a file by selecting the license key(s), right-clicking and selecting the Save to File option.
• License keys can be deleted by selecting the license key(s) and then selecting the Delete button.
• Contact Technical Support for any questions related to emergency licenses.

There are license.XXX System Variables that can be monitored by a trigger for notification purposes. The System Variable Get trigger action can be used to retrieve specific system variable values and then, for example, forwarded to the appropriate personnel using the E-mail action.

Licenses for four concurrent sessions are available with the base runtime installation. Licenses for concurrent sessions beyond the provided four licenses must be acquired through a HTTP API Server license. If there are any question regarding the availability of licenses, contact your support representative.

Each user session to the HTTP Server acquires a license. The license remains in use as long as the session remains active. When the session ends, the license is no longer in use and is available for another user session.

A license key for the Device Manager Product contains the number of active devices that are supported on the node. If there multiple Device Manager license keys, then the number of active devices from all Device Manager keys are summed together for the total number supported on the node. For licensing purposes, an Active Device includes:

• A device that is in the Started state.
  • Aliases devices, Global Variables devices, and Property devices in the Started state are not included in the active device license usage counts. The Sysmon device is not included in the active device license usage counts. Local I/O drivers associated with hardware on specific gateways (e.g. Advantech Uno, Artila PAC5070, B&B Spectre, CalAmp, Gatetel, Moxa, Multitech, Netcomm, Systech Syslink) do not count toward the active device license usage counts.
• A current connection initiated from a client to a Started server or listener type device. The server or listener type devices that require an active device license for a connection includes:
  • Modbus Server device
  • TCP Listener device
  • Rockwell Listener device
  • Siemens Listener device
  • Mistubishi Listener device
  • Omron CIP Listener device
  • Omron device

There are device.XXX System Variables that display count information related to started devices and active device license usage.

A system generated Alert will be displayed when the number of active device licenses in use exceeds a threshold percentage of the total active device licenses for the node. The Alert is cleared when the usage drops below the threshold percentage. For example:

The system is currently using 90% of the available 200 device licenses.

The default is 90%. This default value can be modified by including a properties file entry. For example:

• device.license.threshold=75

For information on adding properties, see Properties file management.

With Listener devices, the number of devices starting are counted, plus the thing that connects to the listener. Each thing that connects to a listener uses a license. So If a person have an active TCP LIstener that connects to 4 things, 5 licenses are being used, seeing that the Listener needs to be taken into account.

The same applies if it's a passive TCP Listener. The Passive TCP Listener opens a port and listens, that counts as one connection. If three things connect to the listener it will consume 4 licenses. Those licenses are used as long as those things are connected to the listener.

To ensure that you receive Telit Support services and future updates of deviceWISE software, a Technical Support License (TSL) must be installed. Beginning with the deviceWISE v22.01 release, customers will see messages in the Workbench if a TSL is missing, expired, or approaching expiration. Please see this page for more information:

https://www.telit.com/dw-tech-support-license