This page provides information on setting up V-Ray Swarm through a silent installation and removing V-Ray Swarm through a silent uninstallation.
Overview
A silent installation allows you to complete V-Ray Swarm 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.
Installation
There are two options to install V-Ray Swarm. You can either use the default settings or make a custom setup by adjusting some of the values.
Windows
Default
Run the installer: swarm-installer-windows-2.0.17.exe -gui=0 -auto
Custom
Prepare the config.xml file.
Run the installer with the following command: swarm-installer-windows-2.0.17.exe -gui=0 -configFile="config.xml" -quiet=1
Linux
Set the executable permissions of swarm-installer-linux-2.0.17.bin: chmod +x ./swarm-installer-linux-2.0.17.bin
Run the installer without sudo - your password will be asked.
Default
./swarm-installer-linux-2.0.17.bin -gui=0 -auto
Custom
Prepare the config.xml file.
Run the installer with the following command: ./swarm-installer-linux-2.0.17.bin -gui=0 -configFile="config.xml" -quiet=1
macOS
Mount swarm-installer-mac-universal-2.0.17.dmg:
To mount it, double click on the dmg file.
Alternatively, mount with the command hdiutil attach swarm-installer-mac-universal-2.0.17.dmg
Run the installer without sudo - your password will be asked.
Default
/Volumes/V-Ray\ Swarm\ Installer/Swarm\ Installer.app/Contents/MacOS/swarm-installer-mac -gui=0 -auto
Custom
Prepare the config.xml file.
Run the installer with the following command: /Volumes/V-Ray\ Swarm\ Installer/Swarm\ Installer.app/Contents/MacOS/swarm-installer-mac -gui=0 -configFile="config.xml" -quiet=1
To unmount the .dmg file after installation, run hdiutil detach '/Volumes/V-Ray Swarm Installer'
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 use the Software, the EULA and the Privacy Policy are automatically accepted during the installation. |
-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. |
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="SWARM_BIN_DIR" DataType="value">/usr/Chaos/V-Ray/Swarm2</Value> <Value Name="SWARM_WEBPORT" DataType="value">1113</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 variables of the installer:
SWARM_BIN_DIR | Defines the path where Swarm itself is installed. Default for each OS:
|
SWARM_WEBPORT | Determines the port for the Web UI (Admin Panel). Default: 1113 |
Silent uninstallation
You can use a command to perform a silent uninstall. In order to do that you need to know the full path of the folder containing V-Ray additional files and the exact name of the product, you want to uninstall. Then you can execute the following command:
<SWARM_BIN_DIR>\uninstall\installer.exe" -uninstall="<SWARM_BIN_DIR>\uninstall\install.log" -uninstallApp="<PRODUCT_NAME>" -gui=0 -quiet=1
where <SWARM_BIN_DIR> is the destination folder and <PRODUCT_NAME> is the product name i.e. “V-Ray Swarm 2”
For example, the following command will uninstall V-Ray Swarm:
C:\Program Files\Chaos\V-Ray\Swarm 2\uninstall\installer.exe" -uninstall="C:\Program Files\Chaos\V-Ray\Swarm 2\uninstall\install.log" -uninstallApp="V-Ray Swarm 2" -gui=0 -quiet=1