This page provides information on setting up V-Ray for Unreal through a silent installation and removing V-Ray through a silent uninstallation.
Overview
A silent installation allows you to complete V-Ray installation without user input during the process using a predefined set of options. To set up a silent installation, you need to perform two steps: creating an .xml file and running the installer.
You can remove V-Ray from your machine similarly through a silent uninstall.
Installer Arguments
You can run the installation file from command prompt with the following arguments:
-help | Prints available arguments for the installer executable. |
-configFile | Specifies path to an installation configuration file. |
-gui | Specifies if a Graphic User Interface will be used or a command line one during installation: 0 – No Graphic User Interface will be visible, installation will be in command line 1 – installation will be with a Graphic User Interface |
-debug | Specifies the level of debug logging by the installer. Defaults to 0 and assumes a value of 1 if argument is provided with no value. |
-auto | Specifies if the installation will be automatic with default settings and forces the -quiet argument |
-quiet | Specifies whether the automatic installation will be without user input. Defaults to 1 0 – installation will require user input and will ask for a confirmation of each variable before proceeding. It will also print log in the console. 1 – installation will be without user input. EULA will be accepted automatically. |
-backup | Specifies whether the installer will perform backup on previous installation. 0 – previous installation will not be backed up 1 – previous installation will be backed up |
Creating the .xml file
Run the installation file from the command prompt with the -gui=0 argument.
vray_adv_43021_unreal_x64.exe -gui=0
Follow the instructions of the install and set-up the installation the way you want to have it on all machines. This will create a file named config.xml in the folder of the installation file.
Running the installer
In the second step you run the installer with the following command:
vray_adv_43021_unreal_x64.exe -gui= 0 -configFile= "xml_file.xml" -quiet= 1 -auto |
Configuration File
The config.xml file holds configuration information about the settings of the installation. Below is an example of such a config file.
Example installer config XML file: VRayForUnrealSilentInstall.xml
<DefValues> <Value Name="INSTALL_TYPE" DataType="value">0</Value> <Value Name="SHOULDUNINSTALL" DataType="value">1</Value> <Value Name="INSTALL_VRAY_UE_4_24" DataType="value">1</Value> <Value Name="UE_4_24_PLUGINS_ROOT" DataType="value">E:/PROGRAMS/Epic Games/UE_4.24/Engine/Plugins</Value> <Value Name="INSTALL_VRAY_UE_4_23" DataType="value">1</Value> <Value Name="UE_4_23_PLUGINS_ROOT" DataType="value">E:/PROGRAMS/Epic Games/UE_4.23/Engine/Plugins</Value> <Value Name="INSTALL_VRAY_UE_4_22" DataType="value">1</Value> <Value Name="UE_4_22_PLUGINS_ROOT" DataType="value">C:/Program Files/Epic Games/UE_4.22/Engine/Plugins</Value> <Value Name="INSTALL_LICENSE_SERVER" DataType="value">0</Value> <Value Name="REMOTE_LICENSE" DataType="value">0</Value> <Value Name="STDROOT" DataType="value">$PROGRAMFILES/Chaos Group/V-Ray/Unreal</Value> <Value Name="SEND_USER_FEEDBACK" DataType="value">1</Value> <Value Name="OPEN_CHANGELOG" DataType="value">1</Value> <Value Name="OPEN_FORUM" DataType="value">0</Value> <Value Name="OPEN_SUPPORT_SITE" DataType="value">0</Value> <LicServer> <Host>127.0.0.1</Host> <Port>30304</Port> <Host1></Host1> <Port1>30304</Port1> <Host2></Host2> <Port2>30304</Port2> <User></User> </LicServer> </DefValues>
Below is a description of the common variables that can be defined in the .xml file:
INSTALL_TYPE | Specifies the installation type: 0 – Workstation 1 – Standalone render server |
SHOULDUNINSTALL | Specifies whether or not the installation will uninstall previous version: 0 – skips the uninstallation of previous version 1 – uninstalls previous version |
INSTALL_VRAY_UE_4_xx | Specifies whether or not to install V-Ray for specified version of Unreal engine: 0 – skips installation for this version 1 – install for this version |
UE_4_xx_PLUGINS_ROOT | Specifies the plugins folder for selected Unreal engine version. |
INSTALL_LICENSE_SERVER | Specifies whether or not to install the License server: 0 – skips installation of License server 1 – install License server |
REMOTE_LICENSE | Specifies whether the V-Ray license server runs locally or on another machine: 0 – the license server runs locally on the same machine. 1 – the server is on a different machine in the network. |
STDROOT | Specifies the destination folder for V-Ray additional files (tools, documents, samples, libraries and uninstall information). Default location is C:\Program Files\Chaos Group\V-Ray\Unreal\uninstall |
SEND_USER_FEEDBACK | Controls whether the user feedback system will be used: 0 – disables user feedback system. 1 – enables user feedback system. |
OPEN_CHANGELOG | Specifies whether or not to open the Change Log once the installation is complete: 0 – does not open the Change Log. 1 – opens the Change Log. |
OPEN_FORUM | Specifies whether or not to open the Chaos Forum page for V-Ray for Unreal once the installation is complete: 0 – does not open forum page 1 – opens the forum page |
OPEN_SUPPORT_SITE | Specifies whether or not to open the Chaos Documentation page for V-Ray for Unreal once the installation is complete: 0 – does not open Documentation page 1 – opens the Documentation page |
<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 |
<Host1>IP_Address</Host2> | Alternate license server's 2 IP Address |
Silent Uninstall of V-Ray
A silent uninstall allows you to remove your V-Ray installation without the need for user input during the process. The silent uninstall uses a predefined set of options.
V-Ray for Unreal can be silently uninstalled from a console with the following command line:
<STDROOT>\uninstall>installer.exe -uninstall="<STDROOT>\uninstall\install.log" -uninstallApp="V-Ray for Unreal" -auto -quiet=0
Where <STDROOT> is the destination folder for V-Ray for Unreal additional files.
e.g.:
C:\Program Files\Chaos Group\V-Ray\Unreal\uninstall>installer.exe -uninstall="C:\Program Files\Chaos Group\V-Ray\Unreal\uninstall\install.log" -uninstallApp="V-Ray for Unreal" -auto -quiet=0