This page provides troubleshooting assistance for general V-Ray problems.

 

Overview


In this section you can find some common issues that may arise when working with V-Ray for Maya.

For creating dump files, please see the Creating Minidump Files page.

 

Cannot Install V-Ray


Symptoms: 

The installation file crashes when you attempt to run it.

Cause:

The installation file is not downloaded properly.

Solution:

Please re-download the installation file from the Downloads section of our website.

 

V-Ray Could Not Obtain License


Here you can find the list of symptoms and their likely cause when V-Ray could not obtain the license. Please check the resolution part at the end of this section.

Symptoms: 

When attempting to render, the Maya status line shows the message "error: Could not obtain a license (10061)" or "error: Could not obtain a license (111)" or "error: Could not obtain a license (61)"

Cause:

V-Ray could not connect to a working license server.

 

Symptoms:

When attempting to render, the Maya status line shows the message "error: Could not obtain a license (-98)".

Cause:

V-Ray connected to a working license server but there are no available licenses for the installed V-Ray version.

 

Symptoms:

When you start the IPR render server, there are no error messages in the V-Ray console, but when a job is sent to the IPR render server there is an error in the console "Could not obtain a license (10061)."

Cause:

No access to the V-Ray license server.

 

Symptoms:

When you start the IPR render server, there are no error messages in the V-Ray console, but when a job is sent to the IPR render server, the error in the console is "Could not obtain a license (-98)."

Cause:

V-Ray connected to a working license server but there are no available licenses for the installed V-Ray version.

 

Symptoms:

When you try to render with V-Ray Standalone, an error message appears in the console: “Could not obtain a license (10061).”

Cause:

No access to the V-Ray license server.

 

Symptoms:

When you try to render with V-Ray Standalone, an error message appears in the console: “Could not obtain a license (-98).”

Cause:

V-Ray connected to a working license server but there are no available licenses for the installed V-Ray version.

 

Resolution:

Please go through the checklist below:

  1. Checking the V-Ray license server:

    Please restart the machine with the V-Ray license server or dongle installed.

    If you are using a dongle, unplug the dongle and plug it again in a different USB port, preferably USB 2.0. Make sure that Windows properly recognizes the dongle and doesn't show an error message. If you receive an error message, please refer to  V-Ray License Server Can't Start in this section.


    Open the link http://localhost:30304 in a web browser on the same machine. If it looks like the screenshot below, the license server is working.



     

  2. Checking the available licenses on the license server:

    Check the available licenses. You have to have proper licenses for the installed V-Ray version, e.g. if you installed V-Ray Next for Maya, you need V-Ray Next for Maya license. You can check that by entering the respective V-Ray option on the http://localhost:30304 page. You can see all available render nodes and interface licenses, as well as check the borrowed ones.





    Please refer to Changing your License Settings page in the Set Up Your V-Ray License section for more information on the type of licenses you need to look for. 

    For dongles: If you do not see the V-Ray 3.0 licenses, this means that your dongle has to be reprogrammed as described in Dongle usage page in the Set Up Your V-Ray License section.If you don't see free licenses this means that all available licenses are in use and you can't have more concurrent users.
     

  3. Checking the connection to the license server:

    If V-Ray is on the same machine as the V-Ray license server, you can skip this step.

    To make sure that nothing is blocking the connection to the license server on the machine where you want to run V-Ray, open the link http:// <IP_address> :30304 in a web browser, where <IP_address> is the IP address of the machine with the V-Ray license server. If you get a web page like the one below, V-Ray can access the V-Ray license server from this machine. In the example screenshot below the IP address of the machine with the license server is 10.0.0.107

    If you get an error message that the web page can't be accessed then there is a network problem that prevents the connection to the V-Ray license server. If you have any firewall or antivirus software running on your machines make sure they are not blocking applications' access to the network or blocking the communication on TCP/IP port 30304. Please contact your system administrator for more information.
     

  4. Checking the V-Ray license settings:

    On the machine where you want to use V-Ray, run the V-Ray license client configuration utility from Windows Start > All Programs > Chaos Group > V-Ray for Maya 20xx for x64 > Change license settings. In the dialog that appears, make sure that the IP address in the License server field at the Primary license server tab is entered correctly and that the connection port is 30304. If you modify any of these settings, you will need to restart Maya.


    Note: If the V-Ray license server is running on the same machine as V-Ray you can use localhost or 127.0.0.1 in the License server field.

 

Dongles


The following issues might occur with dongle usage only.

V-Ray License Server Can't Start


 

Symptoms:  

When you start the V-Ray license server it pops a dialog box like the one shown below:

 

 

Cause:  

This error message appears when the V-Ray license server cannot find a dongle attached to the machine.

Resolution:

Before you start, make sure the dongle is NOT plugged-in.

  1. Uninstall the WIBU-KEY driver from Windows Control Panel .

  2. Update your USB drivers to the latest version.

  3. Restart your machine.

  4. Download and install the latest WIBU-KEY drivers from http://wibu.com/download_user.php.

  5. Attach the dongle to a different USB port, preferably to USB 2.0. Make sure that Windows recognizes the dongle and doesn't show error messages. To verify that dongle is properly installed please go to the Windows Control Panel > System applet. Choose the Hardware tab and then click on the Device manager button. Expand the Universal serial bus controllers list and check for a WIBU-BOX/RU entry there:

     

 

Dongle Disconnects Periodically


Symptoms:  

The dongle is working for extended periods of time but periodically disappears for no apparent reason and is no longer detected by Windows as a USB device. This could cause the V-Ray license server to fail or V-Ray licenses to be refused.

Cause:  

There can be a number of reasons related to the hardware configuration and Windows settings like the Power options.

Resolution:  

Please check your Windows Power Options, make sure that your USB devices are not powered off.

Try to plug the dongle into a different USB port on the same machine, preferably USB 2.0, and restart the V-Ray license server. If you still experience problems, try to install it on a different machine.

 

IPR GPU is Crashing


Symptoms:  

When rendering with IPR on CUDA, it crashes without showing a specific error message.

Cause:

The scene you are trying to render is too large and the Graphics card memory is insufficient.

Resolution:

You can try to reduce the scene size by reducing the polygon count or by using lower resolution textures. IPR has an option called “Resize textures for GPU” that you can use to automatically resize textures during rendering on the GPU.

Alternately you can upgrade your graphics device with one containing more memory.

 

V-Ray Environment Variables Issues


Symptoms:  

Right after an apparently successful installation, the V-Ray for Maya plugin loads in Maya, but V-Ray does not appear in the list of available renderers. The script editor shows a number of errors “Could not read V-Ray environment variable VRAY_FOR_MAYA2018_MAIN_x64. Please re-install” or similar.

Cause: V-Ray for Maya uses several environment variables to find out where various components are installed. The above errors appear when V-Ray for Maya cannot find these variables.

Resolution: Try to log out and log in to your machine again – sometimes the environment changes are not propagated immediately throughout the system.

 

 

V-Ray Could not Obtain License


Here you can find the list of symptoms and their likely cause when V-Ray could not obtain the license. Please check the resolution part at the end of this section.

Symptoms: 

When attempting to render, the Maya status line shows the message "error: Could not obtain a license (10061)" or "error: Could not obtain a license (111)" or "error: Could not obtain a license (61)"

Cause:

V-Ray could not connect to a working license server.

 

Symptoms:

When attempting to render, the Maya status line shows the message "error: Could not obtain a license (-98)".

Cause:

V-Ray connected to a working license server but there are no available licenses for the installed V-Ray version.

 

Symptoms:

When you start the IPR render server, there are no error messages in the V-Ray console, but when a job is sent to the IPR render server there is an error in the console "Could not obtain a license (10061)."

Cause:

No access to the V-Ray license server.

 

Symptoms:

When you start the IPR render server, there are no error messages in the V-Ray console, but when a job is sent to the IPR render server, the error in the console is "Could not obtain a license (-98)."

Cause:

V-Ray connected to a working license server but there are no available licenses for the installed V-Ray version.

 

Symptoms:

When you try to render with V-Ray Standalone, an error message appears in the console: “Could not obtain a license (10061).”

Cause:

No access to the V-Ray license server.

 

Symptoms:

When you try to render with V-Ray Standalone, an error message appears in the console: “Could not obtain a license (-98).”

Cause:

V-Ray connected to a working license server but there are no available licenses for the installed V-Ray version.

 

Resolution:  

Please go through the checklist below:

  1. Checking the V-Ray license server:

    Please restart the machine with the V-Ray license server or dongle installed.

    If you are using a dongle,unplug the dongle and plug it in again in a different USB port, preferably USB 2.0. Make sure that the operating system properly recognizes the dongle.Make sure that the V-Ray license service is running, if you have issues refer to V-Ray License Server Can't Start in this section.  

     

    Open the link http://localhost:30304 in a web browser on the same machine. If it looks like the screenshot below, the license server is working.


     

  2. Checking the available licenses on the license server: 

    Check the available licenses. You have to have proper licenses for the installed V-Ray version, e.g. if you installed V-Ray Next for Maya, you need V-Ray Next for Maya license. You can check that by entering the respective V-Ray option on the http://localhost:30304 page. You can see all available render nodes and interface licenses, as well as check the borrowed ones.



    Please refer to Changing your License Settings page in the Set Up Your V-Ray License section for more information on the type of licenses you need to look for.

    For dongles: If you do not see the V-Ray 3.0 licenses, this means that your dongle has to be reprogrammed as described on the Dongle usage page in the Set Up Your V-Ray License section. If you don't see free licenses this means that all available licenses are in use and you can't have more concurrent users.


  3. Checking the connection to the license server: 

    If V-Ray is on the same machine as the V-Ray license server,  you can skip this step. To make sure that nothing is blocking the connection to the license server on the machine where you want to run V-Ray, open the link http://<IP_address> :30304 in a web browser, where <IP_address> is the IP address of the machine with the V-Ray license server. If you get a web page like the one below, V-Ray can access the V-Ray license server from this machine. In the example screenshot below the IP address of the machine with the license server is 10.0.3.104



    If you get an error message that the web page can't be accessed then there is a network problem that prevents the connection to the V-Ray license server. If you have any firewall or antivirus software running on your machines make sure they are not blocking applications' access to the network or blocking the communication on TCP/IP port 30304. Please contact your system administrator for more information. 



     

  4. Checking that the license server settings are correct. In the Terminal run 

    /Applications/Autodesk/maya20xx/vray/bin/setvrlservice -dump

    where 20xx is the particular version of Maya you are using (2018 etc). This will show you the IP address or the name of the computer that V-Ray is trying to connect to; If it's incorrect, refer to V-Ray license settings change in V-Ray Configuration section.

 

Dongles


The following issues might occur with dongle usage only.

V-Ray License Server Can't Start


Symptoms:  

When you start the V-Ray license server it pops up and closes

Cause:  

This error message appears when the V-Ray license server cannot find a dongle attached to the machine.

Resolution:

Before you start, make sure that the dongle is plugged in directly to the machine and try again. If it is still not working

  1. Make sure the dongle is NOT plugged in.

  2. Uninstall the WIBU-KEY driver

  3. Restart your machine.

  4. Download and install the WIBU-KEY drivers corresponding to your OS from http://wibu.com/download_user.php.

  5. Attach the dongle to a USB port DIRECTLY on your machine, preferably a USB 2.0. Make sure that the operating system recognizes the dongle and doesn't show error messages. To verify that dongle is properly installed please go to the

    /Applications/WIBUKEY/WkConfig.app


 

V-Ray Warning: Loading Shaders Failed


Symptoms:

Right after an apparently successful installation, the V-Ray for Maya plugin loads in Maya, but V-Ray does not appear in the list of available renderers. The script editor shows a number of errors “V-Ray warning: Loading shaders failed: no <*.txt> files in ” or similar.

Cause:  

V-Ray for Maya uses several environment variables to find out where various components are installed. The above errors appear when V-Ray for Maya cannot find these variables.

Resolution:

Try to log out and log in to your machine again – sometimes the environment changes are not propagated immediately throughout the system.

 

 

V-Ray Could not Obtain License


Here you can find the list of symptoms and their likely cause when V-Ray could not obtain the license. Please check the resolution part at the end of this section.

Symptoms: 

When attempting to render, the Maya status line shows the message "error: Could not obtain a license (10061)" or "error: Could not obtain a license (111)" or "error: Could not obtain a license (61)"

Cause:

V-Ray could not connect to a working license server.

 

Symptoms:

When attempting to render, the Maya status line shows the message "error: Could not obtain a license (-98)".

Cause:

V-Ray connected to a working license server but there are no licenses.

 

Symptoms:

When you start the IPR render server, there are no error messages in the V-Ray console, but when a job is sent to the IPR render server there is an error in the console "Could not obtain a license (10061)."

Cause: 

No access to the V-Ray license server.

 

Symptoms:

When you start the IPR render server, there are no error messages in the V-Ray console, but when a job is sent to the IPR render server, the error in the console is "Could not obtain a license (-98)."

Cause:

No available license on the V-Ray license server.

 

Symptoms:

When you try to render with V-Ray Standalone, an error message appears in the console: “Could not obtain a license (10061).”

Cause:

No access to the V-Ray license server.

 

Symptoms:

When you try to render with V-Ray Standalone, an error message appears in the console: “Could not obtain a license (-98).”

Cause:

No available license for the installed V-Ray version.

 

Resolution:

Please go through the checklist below:

  1. Checking the V-Ray license server:

    Please restart the machine with the V-Ray license server or dongle installed.

    If you are using a dongle, unplug the dongle and plug it in again in a different USB port, preferably USB 2.0. Make sure that the operating system properly recognizes the dongle.Make sure that the V-Ray license service is running.

    Open the link http://localhost:30304 in a web browser on the same machine. If it looks like the screenshot below, the license server is working.

     

  2. Checking the available licenses on the license server: 

    Check the available licenses. You have to have proper licenses for the installed V-Ray version, e.g. if you installed V-Ray Next for Maya, you need V-Ray Next for Maya license. You can check that by entering the respective V-Ray option on the http://localhost:30304 page. You can see all available render nodes and interface licenses, as well as check the borrowed ones.



    Please refer to Changing your License Settings page in the Set Up Your V-Ray License section for more information on the type of licenses you need to look for.

    For dongles: If you do not see the V-Ray 3.0 licenses, this means that your dongle has to be reprogrammed as described on the Dongle usage page in the Set Up Your V-Ray License section. If you don't see free licenses this means that all available licenses are in use and you can't have more concurrent users.


  3. Checking the connection to the license server:

    If V-Ray is on the same machine as the V-Ray license server, you can skip this step.
    To make sure that nothing is blocking the connection to the license server on the machine where you want to run V-Ray, open the link http:// <IP_address> :30304 in a web browser, where <IP_address> is the IP address of the machine with the V-Ray license server. If you get a web page like the one below, V-Ray can access the V-Ray license server from this machine. In the example screenshot below the IP address of the machine with the license server is 10.0.3.104



    If you get an error message that the web page can't be accessed then there is a network problem that prevents the connection to the V-Ray license server. If you have any firewall or antivirus software running on your machines make sure they are not blocking the applications' access to the network or blocking the communication on TCP/IP port 30304. Please contact your system administrator for more information.


  4. Checking that the license server settings are correct.

    In the Terminal run /usr/autodesk/maya20XX-x64/vray/bin /setvrlservice -dump

    where 20xx is the particular version of Maya you are using (2018 etc). This will show you the IP address or the name of the computer that V-Ray is trying to connect to; If it's incorrect, refer to V-Ray license settings change in V-Ray Configuration section.


Dongles


The following issues might occur with dongle usage only.

V-Ray License Server Can't Start


Symptoms:  

When you start the V-Ray license server it pops up and closes

Cause:  

This error message appears when the V-Ray license server cannot find a dongle attached to the machine.

Resolution:

Before you start, make sure that the dongle is plugged in directly to the machine and try again. If it is still not working

  1. Make sure the dongle is NOT plugged in.

  2. Uninstall the WIBU-KEY driver.

  3. Restart your machine.

  4. Download and install the WIBU-KEY drivers corresponding to your OS from http://wibu.com/download_user.php.

  5. Attach the dongle to a USB port on your machine, preferably a USB 2.0. Make sure that the operating system recognizes the dongle and doesn't show error messages. To verify that dongle is properly installed please use the WibuKey WkConfig application.





    In the WibuBox field you must see the serial number of your dongle If you do not find this entry, try plugging the dongle into a different USB port.

 

V-Ray Warning: Loading Shaders Failed


Symptoms:

Right after an apparently successful installation, the V-Ray for Maya plugin loads in Maya, but V-Ray does not appear in the list of available renderers. The script editor shows a number of errors “V-Ray warning: Loading shaders failed: no <*.txt> files in ” or similar.

Cause:  

V-Ray for Maya uses several environment variables to find out where various components are installed. The above errors appear when V-Ray for Maya cannot find these variables.

Resolution:

Try to log out and log in to your machine again – sometimes the environment changes are not propagated immediately throughout the system.