Silent Installation

This page provides information on setting up V-Ray through a silent installation and removing V-Ray through a silent uninstall.

Overview

A silent installation allows you to perform a complete V-Ray installation without any user input during the process, using either the default options (automatic installation) or, if desired, a predefined set of options (manual installation).

To use the default options, you need to run the installer file from the command prompt with the -auto argument. This option forces the installer to run without a user interface, and also automatically selects all the default options. A config file, containing the default installation options, is created at the end of the process.

To use a predefined set of options, you need to first create a configuration xml file that stores the installation parameters and then run the installer. You must use the -gui=0 argument, which indicates to the installer that no visual dialog will be shown and all interactions will occur through the console. After that, you can set each of the installation options directly in the console. Adding the -quiet=1 argument speeds this process by skipping the full output and leading you straight to the configuration options where you can set them as you prefer. When this process is finished, the config.xml file is created. The final step is to run the installer again in the command prompt with the config.xml file.

You can remove V-Ray from your machine similarly through a silent uninstall.

Steps

1. Run the installation file from a Command Prompt with the -gui=0 argument.

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray_adv_xxxxx_blenderxxx_x64.exe -gui=0 </span></code>

2. Follow the instructions of the installer and set up the installation the way you want to have it on all machines. This creates a file named config.xml in the folder of the installation file.

3. When you want to install V-Ray on a different machine with the same preset, you only need the config.xml file. Run the installation file with the -gui=0 argument again, and also add the -config=<config.xml> and -quiet=1 arguments. Here's an example of the command line:

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray_adv_xxxxx_blenderxxx_x64.exe -gui=0 -configFile="C:\config.xml" -quiet=1</span></code>

*xxx is a placeholder for the corresponding software versions

Configuration File

The config.xml file configures the automated installation. Below is an example of a config file.

Example installer config XML file: xml_file.xml

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line"><DefValues></span><span data-v-c2b1f83f="" class="line"> <Value Name="SHORTCUTS" DataType="value">1</Value></span><span data-v-c2b1f83f="" class="line"> <Value Name="TEMP_CONFIG_ROOT" DataType="value">config_not_customized</Value></span><span data-v-c2b1f83f="" class="line"> <Value Name="STDROOT" DataType="value">C:\Users\User\AppData\Roaming\Blender Foundation\Blender\4.3\scripts\addons\vray_blender</Value></span><span data-v-c2b1f83f="" class="line"> <Value Name="ZMQROOT" DataType="value">C:\Users\User\AppData\Roaming\Blender Foundation\Blender\4.3\scripts\addons\vray_blender\bin\VRayZmqServer</Value></span><span data-v-c2b1f83f="" class="line"> <Value Name="REMOTE_LICENSE" DataType="value">1</Value></span><span data-v-c2b1f83f="" class="line"> <Value Name="CONFIG_ROOT" DataType="value">C:\Users\User\AppData\Roaming\Blender Foundation\Blender\4.3\scripts\addons\vray_blender/config</Value></span><span data-v-c2b1f83f="" class="line"> <Value Name="FIREWALL_EXCEPTION" DataType="value">1</Value></span><span data-v-c2b1f83f="" class="line"> <Value Name="PERSONALIZED_TELEMETRY" DataType="value">1</Value></span><span data-v-c2b1f83f="" class="line"> <Value Name="INSTALL_TYPE" DataType="value">0</Value></span><span data-v-c2b1f83f="" class="line"> <Value Name="PROGRAMFILES" DataType="value">C:\Program Files</Value></span><span data-v-c2b1f83f="" class="line"> <Value Name="STARTMENUPROG" DataType="value">C:\ProgramData\Microsoft\Windows\Start Menu\Programs</Value></span><span data-v-c2b1f83f="" class="line"> <Value Name="ANONYMOUS_TELEMETRY" DataType="value">1</Value></span><span data-v-c2b1f83f="" class="line"> <Value Name="COMMONFILES" DataType="value">C:\Program Files\Common Files</Value></span><span data-v-c2b1f83f="" class="line"> <Value Name="OS_TYPE" DataType="value">windows</Value></span><span data-v-c2b1f83f="" class="line"> <Value Name="ESCAPED_STDROOT" DataType="value">This is invalid contents</Value></span><span data-v-c2b1f83f="" class="line"> <Value Name="CGLS_INSTALL_PATH" DataType="value">C:\Program Files\Chaos\VRLService</Value></span><span data-v-c2b1f83f="" class="line"> <LicServer></span><span data-v-c2b1f83f="" class="line"> <Host>127.0.0.1</Host></span><span data-v-c2b1f83f="" class="line"> <Port>30304</Port></span><span data-v-c2b1f83f="" class="line"> <Host1>127.0.0.1</Host1></span><span data-v-c2b1f83f="" class="line"> <Port1>30304</Port1></span><span data-v-c2b1f83f="" class="line"> <Host2>127.0.0.1</Host2></span><span data-v-c2b1f83f="" class="line"> <Port2>30304</Port2></span><span data-v-c2b1f83f="" class="line"> <User></User></span><span data-v-c2b1f83f="" class="line"> </LicServer></span><span data-v-c2b1f83f="" class="line"></DefValues></span></code>

Below is a description of the common variables that can be defined in the .xml file:

• STDROOT – The directory for the V-Ray for Blender plugin.
• ZMQROOT – The directory for the ZMQ server.
• REMOTE_LICENSE – Determines the license type:
  • 0 - Local
  • 1 - Remote
• FIREWALL_EXCEPTION – Specifies whether to add a Firewall Exception for the Chaos license server:
  • 0 - Does not add a Firewall Exception for the Chaos license server.
  • 1 - Adds a Firewall Exception for the Chaos license server.
• ANONYMOUS_TELEMETRY – Specifies whether to enable telemetry for the most used product functionality and/or parameter values. The data is not personally identifiable and is not tied to the user's individual account:
  • 0 - no
  • 1 - yes
• PERSONALIZED_TELEMETRY – Specifies whether to enable telemetry for the most used product functionality, parameter values, but also contains personally identifiable information tied to an individual user's license:
  • 0 - no
  • 1 - yes
• INSTALL_TYPE – Specifies the installation type:
  • 0 - Full
  • 1 - Standalone only

<LicServer> – This section specifies the client license settings.

• <Host>IP_Address</Host> – Primary license server's IP Address
• <Host1>IP_Address</Host1> – Alternate license server's 1 IP Address
• <Host2>IP_Address</Host2> – Alternate license server's 2 IP Address

Silent Uninstall of V-Ray

A silent uninstallation allows you to remove your V-Ray installation without the need for user input during the process using a predefined set of options.

To perform a silent uninstall, the executable of the installer should be run from a Windows Command Prompt with the following arguments:

<STDROOT>/uninstall/installer.exe -uninstall="<STDROOT>/uninstall/install.log" -uninstallApp="V-Ray for Blender xxx" -quiet=0

Where:

• <STDROOT> is the V-Ray installation directory
• xxx is the Blender version
• -quiet=0 is used to display the full output of the silent uninstall in the console and can be omitted.