V-Ray Licensing System Overview


The V-Ray licensing system is an independent licensing routine (the V-Ray floating license server, tied to a hardware locking device) and the V-Ray renderer itself. The communication between the two is based on the HTTP protocol, even if the license server and the V-Ray renderer are on the same computer. This means that in order for the licensing to work, the computer must have TCP/IP installed properly. Please note, however, that currently IPv6 is not supported.

In order to run, the V-Ray license server requires that a USB hardware lock (dongle) is attached to the computer where it is running. The dongle contains information about the number of available licenses for V-Ray. You can attach more than one dongle to the same machine to increase the number of available licenses. Before using the dongle, you must install a driver for accessing it.

Installation


For more detailed installation and trouble-shooting instructions, please check the Windows Installation PDF guide and the OSX Installation PDF guide.

Installing the V-Ray License Server

The V-Ray floating license server consists of a single executable file that has to be run prior to launching the V-Ray renderer. The V-Ray installer creates a shortcut to the license server in the Start menu. The installer can also optionally register the V-Ray license server as a Windows service that is started automatically by Windows. Note that the license server requires that a dongle is attached to the machine in order to run, as well as installed WIBU-key dongle driver. By default, the V-Ray installer automatically installs the required WIBU-key drivers.

Securing the V-Ray License Server

Please keep in mind that it is up to you and/or your system administrator to keep the machine running the V-Ray license server secure from unauthorized access and usage of your V-Ray licenses, especially if the V-Ray license server is running on a machine that can be accessed from the Internet.

Configuring the V-Ray Renderer on a Workstation

After you install V-Ray on the workstation, you must tell it where to look for the V-Ray license server. If you are running the V-Ray license server on your workstation most of this setup is done for you and you can begin working once your dongle is plugged in the vrlservice is running. If you are accessing a dedicated license server or you need to reset your license server you can use a small external program which is accessible from the start menu (Start menu > Programs > Chaos Group > V-Ray for SketchUp > Licensing > Administration > Change V-Ray client license settings).

Configuring the V-Ray Renderer on Render Servers for Distributed Rendering

When using distributed rendering V-Ray does require access to the V-Ray license server. After you install V-Ray on the render server, you must tell it where to look for the V-Ray license server. You can use a small external program which is accessible from the start menu (Start menu > Programs > Chaos Group > V-Ray for SketchUp > Licensing > Administration > Change V-Ray client license settings).

Examples


Typical Single-Computer Licensing

After installing V-Ray, plug your V-Ray dongle into a free USB port on your computer, if you have not done so. Start the V-Ray license server (Start Menu > Programs > Chaos Group > V-Ray for SketchUp > Licensing > Launch V-Ray license server). It may take a few seconds for the license server to start completely. Afterwards run SketchUp and render a simple scene. V-Ray should be running fine, provided that no other V-Ray copy is connected to your computer. If you wish to start the license server automatically, use the shortcut from the start menu to register the V-Ray license service (Start Menu > Programs > Chaos Group > V-Ray for 3dsmax > Licensing > Administration > Register V-Ray license service).

Sharing a License Across your Network of Computers

Install the V-Ray license server and the WIBU-key driver on a suitable machine in your network (typically this would be a server machine). Plug the dongle into a free USB port on that machine and start the V-Ray license server. Now, you can use a small external program which is accessible from the start menu (Start menu > Programs > Chaos Group > V-Ray for SketchUp > Licensing > Administration > Change V-Ray client license settings). Enter the IP address or the name of the computer where you have the license server installed. Save and close the license settings dialog and open SketchUp. Now V-Ray should be running fine, provided that the total number of running V-Ray copies does not exceed the number of granted licenses for the licensing server.

Using the V-Ray License Server


When the V-Ray license server starts, it appears as an icon in the tray area of the Windows taskbar. Double-click that icon to bring up a window that allows you to close the V-Ray license server (simply close the window if you do not wish to terminate the license server):

V-ray license server icon in the Windows taskbar

 

Clicking the icon opens a window to terminate the license server


Additionally, you can monitor the work of the V-Ray license server (number of available licenses, currently connected machines etc) via a Web-based interface. For this purpose, you access the V-Ray license server via the HTTP protocol on the port that you have specified for it (the default is 30304). For example, if you are running the V-Ray license server on your local machine, open your web browser and in the Address field enter http://localhost:30304

Clicking on the first link opens a page with the V-Ray license server information:

Troubleshooting


Please check the Windows Installation PDF guide and the OSX Installation PDF guide for more detailed information and trouble-shooting instructions. Send us an email to vray@chaosgroup.com if you need assistance.