Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Floatingpagetoc

 

 

...

MultiExcerptNamereprogramOverview

Dongle Reprogramming


Overview

...

To

...

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

...

You can download the latest version of the License Server from our web site.

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

  • Creating a .wbc file – you

...

  • need to create and send to Chaos

...

  • a remote programming context file, which contains information identifying your specific dongle.

  • Updating the contents of the dongle – Chaos

...

  • sends you a file called

...

  • .

...

  • rtu file which can be used to update the licenses on your dongle.

...


...

MultiExcerptNamecreateWBC

Creating a .wbc File

...

The remote programing context file (

...

.

...

wbc) file

...

identifies your specific dongle and is needed to update it contents. 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

...

  1. version of the License Server. You can download it from here.

  2. Make sure your dongle is plugged in.

  3. Оpen the License Server's interface in a web browser. You can do this by or typing the following link directly in the browser: http://

...

  1. 127.0.0.1:30304

    UI Text Box
    typeinfo

...

  1. Please note that in order to update your dongle using

...

  1. version 5.0 or later of the License Server it is necessary to access it from the same machine where the dongle is plugged in.

...

  1. UI Text Box
    typeinfo

...

  1. Please keep in mind that by default

...

  1. the latest version of the License Server uses online licenses. It can also run with a dongle, but the dongle

...

  1. subsystem of the License Server has to

...

  1. be active at: http://

...

  1. 127.0.0.1:30304 ( click here for more information on enabling the dongle service ). The .wbc file generator cannot be accessed unless your dongle subsystem is

...

  1. active.

...

  1. From the Dongle menu, choose Upgrade.

    Image Added


  2. Follow the instructions on the DONGLE REPROGRAMMING page. Click Create .wbc file now.

    Image Added

  3. Wait until the

...

  1. .wbc file is

...

  1. generated. A confirmation screen will appear to notify you when the operation is complete. Click Download .wbc file and save the file on your machine.

    Image Added

  2. Email this file to Chaos Support using the form along with your

...

  1. company and order information.

...



...

MultiExcerptNameupdatingDongleIntro

Updating the Contents of the Dongle

...

The support team at Chaos

...

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.

...

MultiExcerptNameupdatingDongleWin
UI Text Box
typewarning

Do not plug more than one dongle at a time while updating the contents of the dongle! 


Windows

...

  1. When you receive the “.rtu” file, save it on

...

  1. 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 dongle from the

...

  1. Dongle menu.

...


  1. Image Added

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

  3. Re-enable the dongle from the License Server by selecting

...

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

...

MultiExcerptNameupdatingDongleOSX

Mac OS X

  1. ENABLE DONGLE.


macOS

...

  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

...

  1. WkConfig. The utility requires Java Runtime version 6 or higher

...

  1. to be installed. You will be prompted to install it if it is not already available on the system:

    Image Modified

...


  1. Go to the Update tab

...

  1. in the WkConfig

...

  1. window, chose Execute Update and select the .rtu file that you have received:


    Image Modified
  2. The license will be upgraded shortly – you can

...

  1. monitor the progress status in the

...

  1. License Server's web interface at http://

...

  1. 127.0.0.1:30304 in a browser.

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


    Code Block
    languagebash
    $ wku REMOTE USB SET FROM

...

  1.  <full_path_to_the_.rtu

...

  1. _file>


    The <full_path_to_the_.rtu_file> is the name and

...

  1. location of the .rtu file that you received from Chaos

...

  1. . For example: /Users/<userName>/Desktop/myFIle.rtu


...

MultiExcerptNameupdatingDongleLinux

Linux

...

  1. When you receive the “.rtu” file, save it on

...

  1. 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 dongle from the

...

  1. Dongle menu.

...


  1. Image Added

  2. From a terminal window, enter the command:


    Code Block
    languagebash
    $ wku REMOTE USB SET

...

  1.  FROM <full_path_to_the_.rtu

...

  1. _file>


    The <full_path_to_the_.rtu_file> is the name and location of the .rtu file that you have received from Chaos

...

  1. . For example: /home/<userName>/Desktop/myFIle.rtu


  2. Open the License Server's interface at http://127.0.0.1:30304 in a browser and re

...

  1. -enable the dongle

...

  1. subsystem by selecting

...

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


...

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.  on the HOME page of the License Server interface.