Command 'License Manager'

Symbol: _cds_icon_license_manager

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

Call: Menu bar: “Tools”.

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

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 must be configured correctly in order to license (“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 must be connected to the computer or device. Not all devices support dongles.
“Soft container”	"CODESYS Security Key. A corresponding soft container must be registered in the CodeMeter Control Center. The CODESYS installation provides an existing 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 choose the container type and click “Next >”.

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

Dialog 'License Manager'

“Container”

Depending on whether “Dongle” or “Soft container” was selected: Drop-down list of all CODESYS dongles or soft containers that were found on the computer or device.

“Products”

List of all installed products that are subject to licensing. A prepended symbol indicates the existence and validity of the license.

On the right side 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 dialog “Install licenses on <computer> - Select Operation”:

“Activate license”: Opens the dialog “Install licenses on <computer> - Activate License” (see more below)
“Request license”: Opens the dialog “Install licenses on <computer> - Request License” (see more below)
“Install license”: Opens the dialog “Install licenses on <computer> - Install License” (see more below)

“Additional Functions”

Opens the menu with the following actions:

“Return license”: Opens the “Return Licenses” (see more below)
“Restore license”: This function is available in the case of device licensing only. Opens the “Restore Licenses” dialog (see more below)

Table 532: “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 that you received from the software vendor. The ticket ID consists of five sets of five alphanumerical characters (for example: `‎LYSQ3-ZU93K-24LWC-XGWJ8-5AY7H‎`).
“License server”	Drop-down list of the license server that provides the license for activating the product. You receive the server URL from the software vendor.
“Select Ticket from Repository”	Opens the “License Repository” dialog.
“Next”	CODESYS connects 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 dialog “Install licenses - Select Licenses” opens with a list of these licenses (see description below).

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

Table 534: “Install Licenses on <computer> - Request License”
If the computer does not have an Internet connection, then you can generate a context file from this dialog. The 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 that provided the license for activating the product. As an alternative, you can select the software vendor from the drop-down list.
“Context file”	Location and name

Table 535: “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 path of the license update file in the input field.

Table 536: “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 that was used for licensing.
“License server”	Drop-down list for selecting the license server that provides the license for activating the product. You receive 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 given 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 537: “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.
“Ticket ID”	Field for specifying the ticket ID that was used for licensing that has already occurred.
“Restore”	If a corresponding license backup file is found, then the license is reactivated in the device.