Installer Program Options

This page provides information on how to silently install Enscape.

Overview

A silent installation allows you to complete Enscape installation without user input during the process using a predefined set of options.

Windows

In order for a System Administrator to install Enscape on multiple machines, a config.xml file containing all settings must be first prepared, that will later be used when deploying Enscape on users’ machines.

To learn more about deploying your license to multiple machines, go to this page.

To set up a silent installation and generate a config.xml file, follow the instructions below.

Run the installation file with the following arguments:

Enscape-4.1.0.exe -gui=0

Follow the instructions of the installation and set up the installation the way you want to have it on all machines. Alternatively, if you are creating a basic installation, you can add the -auto tag to automate the installation with all the default options. This will create a file named config.xml in the folder of the installation executable file. Save this config.xml file as you will need it to install Enscape on other machines.

To install Enscape on users’ machines, run the installation file from an Administrator command prompt with the following arguments:

Enscape-4.1.0.exe -gui=0 -configFile=.\config.xml -quiet=1

The example above assumes that config.xml is located in the current working directory, that is, the directory the command is executed from. If this is not the case, the correct path (relative or absolute) to config.xml should be specified instead.

Also, make sure that if you are using double quotes to surround paths containing spaces, you are using the standard vertical Quotation mark character  and not some of the other left/right double quotation mark characters. The path to config.xml must be a valid relative or absolute path. Web URLs, i.e. paths starting with http are not supported for specifying the config.xml location.

The -quiet=1 argument will cause the installer to read the variable values from the config.xml file and do the installation without user input. If you do not specify the -quiet=1 option, the installer will ask for a confirmation of each variable before proceeding.

Silently Uninstall Enscape

To silently uninstall Enscape 4.0 and higher, run the installation file from an Administrator command prompt with the following arguments:

Enscape-4.0.0.exe -gui=0 -auto -uninstallApp="Enscape" -uninstall="C:\Program Files\Enscape\uninstall\install.log"

The path to install.log may vary depending on the location where Enscape was installed. Change “Enscape-4.0.0.exe” to the version you want to uninstall.

To silently uninstall Enscape 3.5 and lower, use the msiexec command from an Administrator command prompt with the following arguments:

start /w msiexec.exe /x "C:\Enscape-3.5.6+204048.msi" /quiet /L* "C:\Enscape_uninstall.log"

Change the path and name for the *.msi and *.log according to your installed version and needs.

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="LOCALE" DataType="value">en-US</Value>
 <Value Name="STDROOT" DataType="value">C:\Program Files\Enscape</Value>
 <Value Name="INSTALL_ARCHICAD" DataType="value">1</Value>
 <Value Name="INSTALL_REVIT" DataType="value">1</Value>
 <Value Name="INSTALL_RHINO" DataType="value">1</Value>
 <Value Name="INSTALL_SKETCHUP" DataType="value">1</Value>
 <Value Name="INSTALL_VECTORWORKS" DataType="value">1</Value>
 <Value Name="REMOTE_LICENSE" DataType="value">0</Value>
 <Value Name="ANONYMIZED_TELEMETRY" DataType="value">1</Value>
 <Value Name="PERSONALIZED_TELEMETRY" DataType="value">0</Value>
 <LicServer>
  <Host>localhost</Host>
  <Port>30304</Port>
  <Host1></Host1>
  <Port1>30304</Port1>
  <Host2></Host2>
  <Port2>30304</Port2>
  <User></User>
 </LicServer>
 </DefValues>

Description of the Variables for the Installer

macOS

Install Enscape on Other Machines

To install Enscape on multiple machines, prepare a config.xml file with the following content and adjust it as needed.

<DefValues>
<Value Name="LOCALE" DataType="value">en-US</Value>
<Value Name="STDROOT" DataType="value">/Library/Chaos/Enscape</Value>
<Value Name="INSTALL_ARCHICAD" DataType="value">1</Value>
<Value Name="INSTALL_RHINO" DataType="value">1</Value>
<Value Name="INSTALL_SKETCHUP" DataType="value">1</Value>
<Value Name="INSTALL_VECTORWORKS" DataType="value">1</Value>
<Value Name="REMOTE_LICENSE" DataType="value">0</Value>
<Value Name="ANONYMIZED_TELEMETRY" DataType="value">1</Value>
<Value Name="PERSONALIZED_TELEMETRY" DataType="value">0</Value>
<LicServer>
<Host>localhost</Host>
<Port>30304</Port>
<Host1></Host1>
<Port1>30304</Port1>
<Host2></Host2>
<Port2>30304</Port2>
<User></User>
</LicServer>
</DefValues>

Mount the installation .dmg file to a directory of your choice from the command prompt with the following commands:

hdiutil attach Enscape-4.1.0.dmg -mountpoint ./enscape_mountpoint

Run the installation file from the command prompt with the following arguments:

./enscape_mountpoint/Enscape\ Installer.app/Contents/MacOS/Enscape.Installer -gui=0 -configFile=./config.xml -quiet=1

The example above assumes that config.xml is located in the current working directory, that is, the directory the command is executed from. If this is not the case, the correct path (relative or absolute) to config.xml should be specified instead. Also, make sure that if you are using double quotes to surround paths containing spaces, you are using the standard vertical Quotation mark character and not some of the other left/right double quotation mark characters. The path to config.xml must be a valid relative or absolute path. Web URLs, i.e. paths starting with http are not supported for specifying the config.xml location.

The -quiet=1 argument will cause the installer to read the variable values from the config.xml file and do the installation without user input. If you do not specify the -quiet=1 option, the installer will ask for a confirmation of each variable before proceeding.

Silently Uninstall Enscape

To silently uninstall Enscape, run the installation file from the command prompt with the following arguments:

./enscape_mountpoint/Enscape\ Installer.app/Contents/MacOS/Enscape.Installer -gui=0 -auto -uninstallApp="Enscape" -log="/Library/Chaos/Enscape/uninstall/install.log"

Once you are done with the installation/uninstallation, unmount the drive:

hdiutil detach ./enscape_mountpoint

Description of Variables for the Installer