This page covers the process for reprogramming the USB license dongle.

 

Page Contents

 

Dongle Reprogramming


In order to reprogram your dongle you need to have the dongle plugged in, the WIBU-KEY drivers installed and the V-Ray License Server installed and running.

Important note: If your dongle serial number starts with 13 please download the latest V-Ray license server from our web site.

If you do not have the necessary V-Ray licenses on your dongle, it will have to be reprogrammed. Reprogramming a dongle is a two-part process:

  • Creating a . wbc file – you will need to create and send to Chaos Group a remote programming context file, which contains information identifying your specific dongle.

  • Updating the contents of the dongle – Chaos Group will send you file called “.rtu” file which can be used to update the licenses on your dongle.

 

 

Creating a .wbc File


Here we describe how to create a remote programing context file (“.wbc”) file, which identifies your specific dongle. If there are more dongles attached on the machine, the steps below will create one “.wbc” file containing information for all dongles. You need to have JavaScript enabled on your web browser.

Note: this information is only relevant to using License Server 4.x.

  1. Make sure you are running the latest V-Ray license server. You can download it from here.

  2. Make sure your dongle is plugged in.

  3. Оpen the link http://localhost:30314/upgrade in a web browser.

    Important dongle update notice

    Please note that in order to update your dongle using the 4.x License Server it is necessary to access it from the same machine the dongle is plugged in.

    Making sure your dongle is activated

    Please keep in mind that by default V-Ray's latest license server utilizes online licenses. It can also run with a dongle but the dongle's license has to first be activated from within the license server at: http://localhost:30304 (click here for more information on enabling the dongle service). The .wbc file generator cannot be accessed unless your dongle is activated.

  4. A web-based wizard will appear. Click on the link shown on the screenshot:

  5. Wait until the remote context file is created.




  6. When the Success! page appears, save the remote context file by right-clicking on the link and using Save Link As.../Save Target As...




  7. Email this file to sales@chaosgroup.com along with company and order information.

 

 

Updating the Contents of the Dongle


The support team at Chaos Group will use your “.wbc” file to generate one or more “.rtu” files and send them back to you. Each “.rtu” file is named with the serial number of the dongle that it is intended for. You can find the dongle serial number on its sticker.

 

 

Windows


  1. When you receive the “.rtu” file, save it on the machine where the dongle with the same serial number is plugged-in.

  2. You need to make sure your dongle is disabled. To disable it from within the License Server, select Disable from the Dongle menu.



  3. Double-click the saved “.rtu” file. You will be asked to confirm the transfer on the dongle. Click Yes to update your dongle.

  4. Re-enable the dongle from the License Server by selecting Enable Dongle.

Note: this information is only relevant to using License Server 4.x.


Mac OS X


  1. When you receive the .rtu file, save it on the machine where the dongle with the same serial number is plugged-in.
  2. Then open Finder and navigate to /Applications/WIBUKEY/ folder and start the WkConfig. The utility requires Java Runtime 6 or higher version to be installed. You will be prompted to install it if it is not already available on the system:



  3. Afterwards please go to the Update tab of the WkConfig then chose Execute Update and select the .rtu file that you have received:



  4. The license will be upgraded shortly – you can check the status in the V-Ray License Server web interface at http://localhost:30304

    In case you experience difficulties with the Java installation or the upgrade through the WkConfig utility you can use the following command in Terminal to upgrade the licenses on the dongle:

    $ wku REMOTE USB SET FROM full path to the .rtu

    Where full path to the .rtu is the name and path of the .rtu file you received from Chaos Group. 
 

 

Linux


  1. When you receive the “.rtu” file, save it on the machine where the dongle with the same serial number is plugged in.

  2. You need to make sure your dongle is disabled. To disable it from within the License Server, select Disable from the Dongle menu.



  3. From a terminal window, enter the command:

    $ wku REMOTE USB SET FROM somefile.rtu  

    where somefile.rtu is the name of the .rtu file you received from Chaos Group.Start the V-Ray license server again.

  4. Re-enable the dongle from the License Server by selecting Enable Dongle.


Note: this information is only relevant to using License Server 4.x.
 

After the dongle is reprogrammed, you can check if the new licenses have been added successfully as described in V-Ray license server status at the beginning of this section.