© Bertrand Benoit

Table of Contents

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.


By using the Chaos installer for automatic installation with the respective options for that (-auto or -quiet=1), or otherwise installing a Chaos product, you accept the Chaos End User License Agreement and the Chaos Global Consumer Privacy Policy.


Installer Arguments


You can run the installation file from command prompt with the following arguments:

-helpPrints 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

-debugSpecifies 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.

If you perform an automatic installation and use the Software, the EULA and the Privacy Policy are accepted automatically during the installation.

-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. You can also add the -auto flag to make the installation automatic with default settings. Note that this accepts both the EULA and the Privacy Policy.

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


When you want to run the same installation, you only need the generated config.xml file. Run the installer with the following command:


vray_adv_43021_unreal_x64.exe -gui=0 -configFile="xml_file.xml" -quiet=1



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_ROOTSpecifies 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.

STDROOTSpecifies 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" -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" -quiet=0


Was this helpful?