Skip to main content

Command: License Manager

Symbol: _cds_icon_license_manager.png

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.

Note

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 112. 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 113. 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 114. 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 115. 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 116. 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 117. 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.

Important

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​

For newer, UFC-based licenses which start with 130..., see: Backing up and restoring Wibu SL licenses

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: License Repository