Licensing CODESYS Controller

Activating a License

This step is skipped on pre-activated RevPi devices, e. g. article no. 100337 – Connect+ 16 GB plus Codesys Multi Core.

Note: License activation locks the license to your Raspberry Pi device. Activation and reactivation are possible only on the same device.

Requirements: Your development system with CODESYS Development System has Internet access and it is connected to your Raspberry Pi device.

Let”s go:

  • Open CODESYS.
  • Create a standard project.
  • Update the device in the device tree.

The device is the type CODESYS Control for Raspberry Pi MC SL.

  • Click on “Tools”.
  • Select “License Manager”.

The License Manager dialog opens.

  • Select “Device” in the wizard.
  • Select “Dongle” or “Softcontainer” depending on the device.

The “Select device” dialog opens.

  • Select the CODESYS Control for Raspberry Pi MC SL device.

The License Manager dialog opens. “Container”shows the name of the soft container or security key on the device. There is not an entry yet for CODESYS Control for Raspberry Pi MC SL in the Products window.

  • Select the “Install licenses” action on the bottom left.

The wizard “Install licenses on <target device> <container name> – Select operation” starts.

  • Select the “Activate license” option.
  • Specify the “Ticket ID”.
  • Click on “Next”.

The license is activated.

See also CODESYS Help: Managing Packages and Licenses.

Backing up a License in CODESYS

It is important to back up the license for CODESYS Control of a RevPi device. Some events, e.g. a corrupted file system or if you want to flash a new image to the Raspberry Pi device, may require to restore the associated CODESYS Control license. Therefore, we recommend that you backup the license information to a location off the device.

Automatic Backup of the License in CODESYS V3.5 SP13 and later
A manual backup is no longer necessary. In CODESYS V3.5 SP13 and later, a license backup file *.WibuCmRaU is saved automatically on the license server and on the computer during the licensing operation. The License Manager can use this file to restore the license to the device in case the license files are lost.

Backing up the License by Explicitly Saving a License Update File *.WibuCmRaU
The following options before SP13 are retained for backing up licenses to be restored at a later time.

Prerequisite: The license is active.

Restart the Raspberry Pi device.

  • Open CODESYS.
  • Add a device.
  • Double-click the device.

The device editor opens.

  • Click on the “Files” tab.

Switch to the backup folder on the Raspberry Pi device.

  • Backup the CMLicenseNew.WibuCmRaU file on an external drive.

The backup of the license update file to an external drive is created.

  • Save the license to the 3SLicenseInfo.tar file.
  • Proceed as described above for the license update file, but create the 3SLicenseInfo.tar file from the \backup directory to an external drive.

Restoring a License in CODESYS

Note: License activation locks the license to your Raspberry Pi device. Activation and reactivation are possible only on the same device.

In the CODESYS Development System V3.5 SP13 and later, a backed up license is restored by means of the “Restore licenses” function in the License Manager. This is possible only for licenses that were activated on a soft container.

Restoring the License in the License Manager

  • Click on “Tools”.
  • Select “License Manager”.
  • Follow the wizard with the same settings that you used during the licensing operation.
  • Select “Device”.
  • Select “Soft container”.
  • After setting up the device, click on the arrow.
  • Click on “Restore license” on the bottom left of the License Manager.

The “Restore licenses” dialog opens.

  • Specify the ticket ID of the license.
  • Click on “Restore”.

The license searches for the backup file *.WibuCmRaU first on the local computer and then on the license server. When the license is found, it is reactivated. The following options before SP13 are retained for restoring licenses.

Restoring a License from the Explicitly Created License Update File CMLicenseNew.WibuCmRaU

Requirements: Your development system with CODESYS Development System has Internet access and it is connected to your Raspberry Pi device.

  • Open CODESYS.
  • Create a standard project.
  • Update the device.

The device is the type CODESYS Control for Raspberry Pi MC SL.

  • Open the License Manager.
  • Follow the wizard with the setting “Device/Soft container” or “Dongle/Selection of the target device.” until the License Manager dialog with the drop-down list for more actions (bottom left).
  • Select “Install licenses”.
  • Click the button to select the backed up license update file CMLicenseNew.WibuCmRaU in the subsequent dialog.
  • Click on “Finish”.

The license is restored.

Restoring from the 3SLicenseInfo.tarFile

Copy the previously saved file 3SLicenseInfo.tar into the \restore directory.