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


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.
-autoSpecifies 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_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" -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