Floating Cloud Licenses

From TouchDesigner Documentation
Jump to: navigation, search

TouchDesigner offers Floating Cloud Licenses using Wibu/CodeMeter's CmCloud licensing technology.

Usage Cases[edit]

TouchDesigner in the Cloud[edit]

A great usage case for floating cloud licenses is to easily license TouchDesigner and TouchPlayer for cloud OS instances that don't have consistent system codes. This may be because a new instance is spun-up every time the cloud OS instance is launched, or it just may be because the way the cloud hosting service works causes the system code to change often. Dongle-based solutions also don't work since it's rare that access to the hardware is possible for cloud servers.

Local Machines Licensed from a Global Pool[edit]

Additionally, the floating cloud licenses offer a solution for organizations looking to have a pool of licenses available to any of their staff, world-wide. This is different from the Dongle based floating licensing, since that solution requires the Dongle and the user machines to be on the same LAN.

Using Floating Cloud Licenses[edit]

A single user account can have any number of licenses assigned to be floating in the cloud and any type of license can be used ie. Educational - Commercial - Pro. This service is accessed using a credential file which is a .wbc file that Derivative will give to you. On any machine where you want to acquire a license from the cloud, this .wbc needs to be loaded into the CodeMeter Control Center. When TouchDesigner or TouchPlayer launches, if a .wbc file is installed on the system, it will attempt to acquire a license available from the cloud service. If any local licenses that are installed are higher (ie. Pro is higher than Commercial), those will be used as well ontop of the cloud license. If you don't want to use a cloud license anymore on a machine, you can simply remove the credentials from the CodeMeter Control center by clicking the 'Remove' button in the UI.

Only one .wbc credential file is used for all users in an organization that will be using the cloud licenses. The file does not contain any licenses itself. It only contains credentials that are used to contact the cloud server to acquire licenses. If for any reason the credential file becomes compromised (e.g given out to someone that shouldn't have access), then Derivative will need to issue your account a new credential file. All users of the account will need to install that new credential file, as the old one will stop working.

Unlike hardware Dongle licenses, which are checked for the appearance/disappearance of licenses every 20 seconds, floating cloud licenses are only checked once on startup. This is due to limits on how many requests we can do to the CodeMeter servers. Because of this limit if your account does not have any available licenses when TouchDesigner start, you will need to restart TouchDesigner to acquire a license when one becomes available.

Removing Floating Cloud Licenses[edit]

Currently removing a CmCloud license from a machine takes a few steps. We are hoping CodeMeter will release a better solution soon. In the meantime the CmCloud license can be removed using one of two ways.

Via Command Line[edit]

Navigate to the CodeMeter runtime directory, usually: C:\Program Files (x86)\CodeMeter\Runtime\bin Execute the command:

 cmu32.exe --delete-cmcloud-credentials --serial <Serial number of CmCloud license>

On macOS the command is simply called cmu.

Enable the 'Remove' button in the CodeMeter Control Panel UI[edit]

Please proceed as follows: 1. Open registry editor by clicking the Windows symbols and type: regedit 2. Create a new DWORD(32-bit) Value at HKEY_CURRENT_USER/SOFTWARE/WIBU-SYSTEMS/CodeMeterCC with the name "AllowCmActDelete" and set entry to a value of 1. 3. Restart the machine. In order to deactivate the button follow step 1 and set "AllowCmActDelete" to a value of 0 or delete the complete string entry.

A custom interactive control panel built within TouchDesigner. Panels are created using Panel Components whose look is created entirely with TOPs.