This page provides information on how to silently install V-Ray.
Installation
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 follow the instructions below.
Run the installation file from the command prompt with the -gui=0 argument:
vray_adv_70001_sketchup_win.exe -gui=0
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.
Run the installer with the following command:
vray_adv_70001_sketchup_win.exe -gui=0 -configFile="xml_file.xml" -quiet=1
The -quiet=1 argument causes the installer to read the variable values from the .xml file and perform the installation without user input. It also accepts the EULA and Global Consumer Privacy Policy. If you do not specify the -quiet=1 option, the installer will ask for a confirmation of each variable before proceeding.
The part of the config.xml file between “<LicServer>” and "</LicServer>" tags specifies the V-Ray license settings. If this section exists in the config.xml file, existing license settings will be overwritten. If you already have the correct license settings in place, you can remove the <LicServer></LicServer> part from the .config.xml, so that the existing settings won't be changed.
In the terminal, navigate to the location where you have mounted the vray_adv_70001_sketchup_osx.dmg file (by double-clicking on it). The default location is /Volumes/V-Ray for SketchUp/.
Using the "cd" command to navigate inside the .app file and go to /Volumes/V-Ray for SketchUp/vray_adv_70001_sketchup_osx.app/Contents/macOS
Use the vray_adv_70001_sketchup_osx.bin file to run a command-line installation. Copy the file to a custom location where your user has “write” permissions and run it from there.
Create an .xml file with installation options. To do that, start the installation on a single machine by entering in the terminal the following:
./vray_adv_70001_sketchup_osx.bin -gui=0
You will be prompted to enter your password.
Follow the instructions of the installer and set up the installation in the way you want it to be installed on all machines. Make sure SketchUp has been run on the machine at least once prior to installing V-Ray.
A file named config.xml will be created in the same folder the .bin file is located. Please note, that if you start the installation directly from inside vray_adv_70001_sketchup_osx.app/Contents/macOS directory, no config.xml file will be written since the location is read-only.
- You can now install V-Ray on all machines by navigating to the location of vray_adv_70001_sketchup_osx.bin and running:
./vray_adv_70001_sketchup_osx -configFile="config.xml" -gui=0 -quiet=1 -ignoreErrors=1
The -quiet=1 argument will cause the installer to read the variable values from the .xml file and do the installation without user input. It will also accept the EULA and Global Consumer Privacy Policy. If you do not specify the -quiet=1 option, the installer will ask for a confirmation of each variable before proceeding.
The part of the config.xml file between “<LicServer>” and "</LicServer>" tags specifies the V-Ray license settings. If this section exists in the config.xml file, existing license settings will be overwritten. If you already have the correct license settings in place, you can remove the <LicServer></LicServer> part from the .config.xml, so that the existing settings won't be changed.
V-Ray will search for $HOME/Library/Application Support/SketchUp 20xx (where 20xx is the SketchUp version) folder that is created after the first time SketchUp is started. Since this is per user, if you use "root" user to deploy installations, copy the existing $HOME/Library/Application Support/SketchUp 20xx folder into /var/root/Library/Application Support/ before installing. Otherwise, V-Ray will not detect that a specific SketchUp version is installed.
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 or a command line one is used during installation: 0 – No Graphic User Interface is visible, installation is in command line. 1 – Installation is 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 is automatic with default settings and forces the -quiet argument. If you perform an automatic installation and using the Software , you need to accept the terms of the EULA and the Global Consumer Privacy Policy later when running the software in a GUI mode. |
| -quiet | Specifies whether the automatic installation is without user input. Defaults to 1. 0 – Installation requires user input and asks for a confirmation of each variable before proceeding. It also prints log in the console. 1 – Installation is without user input. EULA is accepted automatically. |
| -backup | Specifies whether the installer performs backup on previous installation. 0 – Previous installation is not backed up. 1 – Previous installation is backed up. |
Configuration File
The config.xml file holds configuration information about the settings of the installation. Below is an example of such a config file.
<DefValues> <Value Name="INSTALLER_LANGUAGE" DataType="value">0</Value> <Value Name="INSTALL_SKETCHUP_2024" DataType="value">0</Value> <Value Name="INSTALL_SKETCHUP_2022" DataType="value">0</Value> <Value Name="INSTALL_SKETCHUP_2021" DataType="value">0</Value> <Value Name="INSTALL_CLOUD" DataType="value">0</Value> <Value Name="ANONYMIZED_TELEMETRY" DataType="value">1</Value> <Value Name="INSTALL_GALAXY" DataType="value">0</Value> <Value Name="INSTALL_SWARM" DataType="value">0</Value> <Value Name="OPEN_CHANGELOG" DataType="value">0</Value> <Value Name="CONFIGURE_LICENSE_ONLY" DataType="value">0</Value> <Value Name="REMOTE_LICENSE" DataType="value">1</Value> <Value Name="AUTO_INSTALL" DataType="value">0</Value> <Value Name="PERSONALIZED_TELEMETRY" DataType="value">0</Value> <Value Name="INSTALL_LICENSE_SERVER" DataType="value">0</Value> <Value Name="LOGIN_LICENSE_SERVER" DataType="value">1</Value> <Value Name="INSTALL_ULA" DataType="value">0</Value> <Value Name="INSTALL_SKETCHUP_2023" DataType="value">1</Value> <LicServer> <Host>127.0.0.1</Host> <Port>30304</Port> <Host1>localhost</Host1> <Port1>30304</Port1> <Host2></Host2> <Port2>30304</Port2> <User></User> </LicServer> </DefValues>
Below is a description of the variables of the installer:
| 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 |
| 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 |
| REG_LIC_SERVER | Specifies whether to register the V-Ray license server: 0 - Does not register the V-Ray license server 1 - Registers the V-Ray license server |
| INSTALL_SKETCHUP_2024 | Specifies the installation of V-Ray for SketchUp 2024: 0 - Does not install V-Ray for SketchUp 1 - Installs V-Ray for SketchUp |
| INSTALL_LICENSE_SERVER | Specifies whether or not to install the V-Ray license server: 0 - Does not install the V-Ray license server 1 - Install the V-Ray license server |
| INSTALL_SWARM | Specifies whether or not to install V-Ray Swarm: 0 - Does not install Swarm 1 - Installs Swarm |
| ANONYMIZED_TELEMETRY | Specifies whether to enable telemetry for the most used product functionality and/or parameter values: 0 - Disables V-Ray telemetry 1 - Enables V-Ray telemetry. The data that is collected is not personally identifiable and is not tied to the user's individual account. |
| 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 - Personalized telemetry is disabled. 1 - Personalized telemetry is enabled. |
INSTALL_CLOUD | Specifies whether or not to install Chaos Cloud Client App: 0 - Does not install Chaos Cloud Client App 1 - Installs Chaos Cloud Client App |
Notes
- The V-Ray installer should not be run using administrative privilege.