Skip to content

VisualApplets Licensing#

To run VisualApplets, you need to:

  • Install the software on your computer
  • Use a dongle holding the VisualApplets license(s) you have purchased.

For VisualApplets licenses, you need to use a CmStick Basic Dongle (Wibu Systems AG).

CmStick Basic Dongle (Wibu Systems AG)

You can either use a CmStick dongle you order together with your VisualApplets license, or a CmStick dongle you already have and also use for other licenses. If you use a CmStick dongle you already use, or if you have purchased additional licenses for your VisualApplets installation, you have to add the appropriate license file to the CmStick dongle (see Adding or Updating Licenses).

You use always one license file for VisualApplets. If you purchase VisualApplets extensions, you are provided with a new license file that contains the original VisualApplets license and the licenses for the extensions you purchased. See Adding or Updating Licenses for instructions for flashing your CmStick dongle with the new license file.

Info

Without access to a dongle with the VisualApplets IDE Software License, your VisualApplets installation works in demo mode only.

You can order the CmStick Basic Dongle via the Basler website.

Available Licenses#

VisualApplets IDE Software License#

For using VisualApplets, you need the VisualApplets IDE Software License. This license contains the features VA Core and VA Gui. VisualApplets 4 IDE Software License also contains all available extension modules except the VisualApplets Embedder. Visual Applets 3 IDE Software license doesn't contain the extension modules. For a detailed description of changes between VisualApplets 3 IDE Software License and VisualApplets4 IDE License, see the Product Change Notification "Simplified licensing model of VisualApplets".

Extension Modules for VisualApplets#

In addition to the VisualApplets 3 IDE Software License, various extension modules are available which you can purchase separately. In the VisualApplets 4 license, all extension modules are already included except the VisualApplets Embedder.

When you purchase an extension, you receive a new license file for your individual dongle. The new license file includes not only the license for VisualApplets, but also the license(s) for the extension(s) you have purchased. You need to update your dongle with the new license file to use the extensions you purchased. See Adding or Updating Licenses for more details.

The following extension modules are available:

  • VisualApplets Embedder
  • VisualApplets 3 Expert, containing
    • Debugging Module (Debugging library)
    • Parameters Translation Module (Parameters library)
    • Custom Operators Feature
    • Protecting user library elements
    • TCL Scripting Feature (automatization of design creation and simulation)
  • Debugging Module (Debugging library): individual library license
  • Parameters Translation Module (Parameters library): individual library license
  • Segmentation and Classification Library (Blob): individual library license
  • JPEG Compression library: individual library license

VisualApplets License Manager with Components

For further information about VisualApplets licenses, contact Basler Support.

Mode of Use#

There are two ways of licensing your software:

Using the Stand-Alone License#

Requirements:

  • Dongle: Make sure you have a CmStick (Wibu Systems AG) available that contains your VisualApplets license.
  • Installation: VisualApplets is installed on the PC.

To use VisualApplets with a local license:

  1. Put the CmStick dongle containing your VisualApplets license into a free USB slot of your PC.
  2. You don't need to restart your PC. Just (re)start VisualApplets. Without any additional entries you are able to start working with VisualApplets.

How to update your dongle with a new (extended) license, containing, for example, additional libraries or VisualApplets Embedder, see Adding or Updating Licenses.

Using the Floating License#

Requirements:

  • Dongle: Make sure you have a CmStick (Wibu Systems AG) available that contains your VisualApplets license.
  • License File: Make sure you have the VisualApplets license also available in *.txt format.
  • Installation: VisualApplets is installed on the PCs on which it is intended to be used.

To use VisualApplets with floating license:

  1. Put the CmStick dongle that contains your VisualApplets floating license into a free USB slot of your network server.
  2. Install the CmStick User Runtime software to this network server. You can download the software from www.wibu.com.
  3. Save the license file *.txt to a place that is available from the local VisualApplets installation. (Save it either to a network server, or to the file system of each local machine.)

  4. On each local machine, set the following environment variables:

    VA_LICENSE_SERVER: Specify here the name of you network server.

    VA_LICENSE_FILE: Specify here the path to and the name of the license file *.txt.

Now, you can use the floating licenses on all local machines on which you have set the environment variables and that have access to the network server and to the license file *.txt.

If you want to enlarge the number of users contained in your floating license, or if you want to upgrade from a local (node-locked) license to a floating license, contact Basler Support.

How to update your dongle with a new (extended) license, containing, for example, additional libraries or VisualApplets Embedder, see Adding or Updating Licenses.

Adding or Updating Licenses#

If you have purchased VisualApplets Extensions, or if you come from VisualApplets 2 and want to use VisualApplets 3, you need to update your VisualApplets license on the dongle hardware.

To update your license, proceed the following steps:

  1. Request your license file from Basler. Communicate your dongle number in your request message. Also communicate if you have purchased any VisualApplets Extensions.
  2. Store your individual license file on your file system.
  3. Insert the VisualApplets dongle into a free USB slot on your PC.

  4. Open VisualApplets 3 (in demo mode) and from the Tools menu, select menu item License Manager.

    Open License Manager

  5. The License Manager window opens:

    VisualApplets License Manager The components of the license stored on your dongle are displayed.

  6. Option: You may want to save a backup file of the license currently active on your dongle. To do so, use the Backup Dongle License button.

  7. Select the number of the dongle that is used for the VisualApplets license (the number of the dongle you find directly on the dongle hardware item).

  8. Select the new License file from your file system.

    Selecting License File for VisualApplets

  9. Use option Show features of this license file. Now, the components which are part of the new license are displayed. You can switch between the two radio buttons to compare the new license with the license that is currently active on your dongle.

  10. If you are satisfied with the contents of the new license file, click button Flash License to Dongle.