Command: License Manager

Symbol:

Function: The command opens the wizard for configuring the licenses for CODESYS add-on products. The wizard starts with the “License Manager – Select Target” dialog.

Call: “Tools” menu

The License Manager can handle licenses for CODESYS add-on products on the local computer, as well as licenses for runtime add-on products on devices. It supports both the installation in a soft container and on a dongle.

The license update for product subscriptions is done automatically. You see the current license status in the ⮫ License Manager.

Dialog: License Manager – Select Target

This is the start dialog of the License Manager wizard. Here you decide where the license will be installed.

“Workstation”

Local computer

“Device”

Controller

The connection to this device has to be configured correctly in order to perform the licensing operation (“Communication Settings” tab of the device editor).

After clicking “Next”, you decide the container where you want to manage the licenses.

Dialog: License Manager – Select Container

“Dongle”

A corresponding dongle has to be connected to the computer or device. Not all devices support dongles.

“Soft container”

CODESYS Security Key

A corresponding soft container has to be registered in the CodeMeter Control Center. The CODESYS installation provides a soft container.

If you are installing a product on your local computer (“Workstation”), then the “License Manager” opens immediately for the specific selection of the dongle or soft container, and the next actions. This happens after you select the container type and click “Next”.

If you are licensing the add-on product for a controller, then the dialog opens first for selecting the device in the network after you click “Next”. The dialog corresponds to the classic view of the “Communication Settings” tab of the device editor.

Dialog: License Manager – Overview

“Licenses”

List of all installed CODESYS products which are subject to licensing and are found on the computer or device. When the licenses are provided from containers, the containers are displayed as nodes in the license list.

A prepended symbol indicates whether the license exists on the computer and is valid.

To the right of the window, the following information is displayed for the selected product and corresponding licenses:

“Name”

“Company”

“Unit counter”

“License quantity”

“Usage period”

“Feature map”

“Activation time”

“Expiration time”

“Firm code”

“Product code”

“Description”

“Install Licenses”

Opens the “Install Licenses on <computer> – Select Operation” dialog:

“Activate License”: Opens the “Install Licenses on <computer> – Activate License” dialog (see more below)
“Request License”: Opens the “Install Licenses on <computer> – Request License” dialog (see more below)
“Install License”: Opens the “Install Licenses on <computer> – Install License” dialog (see more below)

“Additional Functions”

Opens the menu with the following actions:

“Wink”: The respective license dongle on the computer blinks.
“Return License”: Opens the “Return Licenses” (see more below)
“Restore License”: This function is available only in the case of device licensing. Opens the “Restore Licenses” dialog (see more below)
“Update Container”: The list box with all detected containers is created again.

Table 682: “Install Licenses on <computer> – Activate License”
This is the recommended way to activate a license available via the License Server when you have an Internet connection. Requirement: The computer has an Internet connection.
“Ticket ID”	Input field for the ticket ID which you have received from the software vendor A ticket ID consists of 5 blocks, each containing 5 alphanumeric characters. Example: `‎LYSQ3-ZU93K-24LWC-XGWJ8-5AY7H‎`
“License server”	List box of the license server which provides the license for activating the product You get the server URL from the software vendor.
“Container”	List box for the container or dongle where the license should be installed.
“Select Ticket from Repository”	Opens the “License Repository” dialog
“Next”	CODESYS establishes a connection to the license server. If the specified ticket contains only one license, then a dialog opens to confirm the successful activation after completion of the server action. If the specified ticket contains multiple licenses, then the “Install Licenses – Select Licenses” dialog opens with a list of these licenses (see description below).

Table 683: “Install Licenses – Select Licenses”
Selection of the licenses to be activated for the ticket which you have specified in the “Install Licenses – Activate License” dialog
“Name”	Product name
“Available”	Number of available licenses
“Used”	Number of used licenses
Total	Sum of all used and available licenses
Next	CODESYS establishes a connection to the license server. After successful completion of the server action, a dialog opens with the confirmation of the activation.

Table 684: “Install Licenses on <computer> – Request License”
If the computer does not have an Internet connection, then you can use this dialog to generate a context file. This file (WibuCmRaC) is then transmitted to the license server via an Internet-enabled computer. When activation is complete, a license update file (WibuCmRaU) is provided for download.
“Software vendor”	Input field for firm codes from the software vendor which provided the license for activating the product Alternatively, you could also select the software vendor from the list box.
“Container”	List box for the container or dongle for which the context file should be generated.
“Context file”	Location and name

Table 685: “Install Licenses on <computer> – Install License”
If you downloaded a license update file from the Internet during software activation, then you can use this dialog to install the license on your dongle. To do this, specify the desired container or dongle for “Container” and specify the path of the license update file in the input field for “File”.

Table 686: “Return License”
If the license permits, you can "return" it in order to reactivate it later on another computer.
“Ticket ID”	Field for specifying the ticket ID which was used for licensing
“License server”	List box for selecting the license server which provides the license for activating the product You get the server URL from the software vendor.
“Load License(s)”	Button for showing all current licenses installed for the given ticket ID on the server in the “Licenses” window
“Licenses”	List of licenses available on the server for the specified ticket ID The following information for the selected license is displayed next to the window on the right: “Name” “Number of activations” “Return allowed” “Activation type” “Activation date” “Firm code” “Comment”
“Return License(s)”	Button for returning the selected license(s) These can be reactivated later on another system.

Table 687: “Install Licenses – Restore Licenses”
When activated, device licenses are saved to a file (`‎*.WibuCmRau‎`) on the local computer and in the "CODESYS Central License Server". If lost, they can be restored from this file to the identical device. This procedure only works for licenses which start with 128... and use CodeMeter Embedded: CODESYS Control for BeagleBone CODESYS Control for emPC-A/iMX6 CODESYS Control for IOT2000 CODESYS Control for PFC100 CODESYS Control for PFC200 CODESYS Control for PLCnext CODESYS Control for Raspberry Pi CODESYS Control for WAGO Touch Panel 600
“Ticket ID”	Field for specifying the ticket ID which was used for the licensing which has already been performed
“Restore”	If a corresponding license backup file is found, then the license is reactivated in the device.

For more information, see: and ⮫ “Command: License Repository ”