Deploy to Multiple Machines

This page provides information on how to deploy Chaos License Server on multiple machines.

For Enscape Versions 4.1 Onwards

To deploy a license across multiple machines, install the Chaos License Server on a centralized machine on your office network that is accessible to all users. Authenticate it with your Chaos Account that holds your floating licenses.

Enscape users (or your IT administrator) on your network need to configure their copy of Enscape to connect to the License Server, either during installation or using an external utility installed alongside Enscape.

To perform a silent installation, follow the instructions on the Installer Program Options page.

For Enscape Version 4.0

To deploy a license automatically and eliminate the need for manual code entry during the first launch of Enscape, follow these steps:

1. Open an Administrator command prompt.

2. Run the installation file with the specified arguments to install for all users on the machine.

3. To install for the current user only, run the installation file from a standard non-Administrator command prompt.

<code><span class="line"><span>PATHtoENSCAPEexe -gui=0 -acceptEULA</span></span></code>

The -acceptEULA argument accepts the EULA. If the -acceptEULA option is not specified, the installer terminates because the EULA is not accepted.

Follow the installation instructions and configure the setup as needed across all machines. The installer creates a file named config.xml in the folder of the installation file. Save this config.xml file, as it is required to install Enscape on other machines.

To install Enscape via a deployment script and add the Enscape license key to the Windows Registry, use a script like the following:

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">reg query HKEY_LOCAL_MACHINE\SOFTWARE\Enscape /v LicenseKey >nul</span><span data-v-c2b1f83f="" class="line">if %errorlevel% equ 1 (</span><span data-v-c2b1f83f="" class="line">reg add HKEY_LOCAL_MACHINE\SOFTWARE\Enscape /reg:64 /v LicenseKey /t REG_SZ /d your_Enscape_license_code</span><span data-v-c2b1f83f="" class="line">)</span><span data-v-c2b1f83f="" class="line">PATHtoENSCAPEexe -gui=0 -acceptEULA -configFile=”config.xml” -quiet=1</span></code>

If problems occur during the command line installation, add the -debug=3 argument at the end of the command line. This creates an installer log file named, for example, installer_debug_XXX.log (where XXX is the timestamp) in the current TEMP directory. Send this file along with any other relevant information when submitting a support ticket.

For Enscape Versions 2.8 to 3.5

To deploy a license automatically and eliminate the need for manual code entry during the first launch of Enscape, follow these steps:

1. Create a string registry key called “LicenseKey” under HKEY_LOCAL_MACHINE\SOFTWARE\Enscape.
2. Set your License Key as the value of the created registry key.

On startup of the CAD software, the license code in the registry key is applied automatically.

Here’s a very simple deployment script which you can adapt to your needs:

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">reg query HKEY_LOCAL_MACHINE\SOFTWARE\Enscape /v LicenseKey >nul</span><span data-v-c2b1f83f="" class="line">if %errorlevel% equ 1 (</span><span data-v-c2b1f83f="" class="line"> reg add HKEY_LOCAL_MACHINE\SOFTWARE\Enscape /reg:64 /v LicenseKey /t REG_SZ /d your_Enscape_license_code </span><span data-v-c2b1f83f="" class="line">)</span><span data-v-c2b1f83f="" class="line">start /w msiexec.exe /i Enscape.msi /quiet ACCEPTEULA=1</span></code>

For information on all the available switches, refer to the Installer Program Options page. To read the Enscape version automatically (prior to 4.0), refer to the Read the Version Automatically page.

For Enscape Versions Prior to 2.8

To deploy a license automatically and eliminate the need for manual code entry during the first launch of Enscape, follow these steps:

1. Create a file called “License.txt” containing your license code.
2. Create the directory “%ProgramData%\Enscape” on the computer on which you want to deploy Enscape.
3. Place the License.txt in that freshly created directory.

On startup of the CAD software, the license code in the file is applied automatically. After a successful deployment, the file is deleted.

Here’s a very simple deployment script that you can adapt to your needs:

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">if not exist "%ProgramData%\Enscape" md "%ProgramData%\Enscape"</span><span data-v-c2b1f83f="" class="line">echo your_license_code > "%ProgramData%\Enscape\License.txt"</span><span data-v-c2b1f83f="" class="line">start /w msiexec.exe /i Enscape.msi /quiet ACCEPTEULA=1</span></code>

Suppress Taskbar Icon Grouping

For versions 4.2 onwards, the Suppress Taskbar Icon Grouping setting can be enabled. All Enscape windows will then appear as a separate group of windows in the taskbar. To suppress grouping, you can run the following command as an Administrator:

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">REG ADD “HKEY_LOCAL_MACHINE\SOFTWARE\Enscape” /v SuppressTaskbarIconGrouping /t REG_SZ /d 1 /f</span></code>

Suppress Notifications

To suppress Enscape Update Notifications, Graphics Card Driver warnings, and the First Steps window, use the following commands:

• REG ADD “HKEY_LOCAL_MACHINE\SOFTWARE\Enscape” /v SuppressUpdateNotifications /t REG_SZ /d 1 /f
• REG ADD “HKEY_LOCAL_MACHINE\SOFTWARE\Enscape” /v SuppressGraphicsDriverWarning /t REG_SZ /d 1 /f
• REG ADD “HKEY_LOCAL_MACHINE\SOFTWARE\Enscape” /v SuppressFirstStepsWindow /t REG_SZ /d 1 /f

To perform this for the current user, just replace the HKEY_LOCAL_MACHINE with HKEY_CURRENT_USER.

Deploying Enscape for ArchiCAD for All Users - 4.0

Selecting All Users from the installer's options only installs Enscape for users who have already started ArchiCAD at least once. To ensure installation for every new user on the machine, do the following:

• Run a script on any user’s first log on using CMD, run as an administrator:

“C:\Program Files\Enscape\ egistration\Enscape.Installer.Runtime.exe” install -archicad -all-users “C:\Program Files\Enscape”

• This command registers Enscape for ArchiCAD for All Users again and output a log file of this in this location:

%LOCALAPPDATA%/Enscape/Logs/Enscape.Installer

Deploying Enscape for ArchiCAD for All Users - Prior to 4.0

Selecting “all users” from the installer's options only installs it for users who have already started ArchiCAD at least once.

In order to ensure installation for every new user of a machine, you can do the following:

• Run a script on any user’s first log on, and from there, call the Plugin installer like this:

msiexec.exe /q /i Enscape.msi REINSTALL=ArchiCAD

NOTE: the /q option for the command to perform a quiet installation.

• Add the registry base key of your ArchiCAD version to the Default User created in the previous step. (This removes the requirement of starting ArchiCAD before installing Enscape.)

Here are some example commands for different ArchiCAD versions:

REG ADD “HKEY_USERS\Test\Software\GRAPHISOFT\ARCHICAD-64\ARCHICAD-64 21.0.0 USA R1”
REG ADD “HKEY_USERS\Test\Software\GRAPHISOFT\ARCHICAD-64\ARCHICAD-64 22.0.0 INT R1”
REG ADD “HKEY_USERS\Test\Software\GRAPHISOFT\ARCHICAD\ARCHICAD 23.0.0 USA R1”
REG ADD “HKEY_USERS\Test\Software\GRAPHISOFT\ARCHICAD\ARCHICAD 24.0.0 INT R1”

In the commands “Test” refers to the loaded Hive (see step 7).
The last two parts of the base key depend on your ArchiCAD version, you can look them up at HKEY_CURRENT_USER\Software\GRAPHISOFT for any user that has already started ArchiCAD.

Uninstalling Enscape versions prior to 2.6 via Command Line

Uninstalling previous versions of Enscape prior to version 2.6 cannot be done by the MSI installer directly.

Instead, the commands to uninstall Enscape 2.5 can be found in the following registry entries:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\Enscape → UninstallString (if Enscape 2.5 was installed for all users)
HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\Enscape → UninstallString (if Enscape 2.5 was installed for the current user)

An automatic approach is to read these registry values and execute the commands if they exist.

NOTE: This only needs to be performed once. Furthermore, although there is no way to silently uninstall Enscape versions prior to 2.6, you could use a PowerShell script to check for installed versions earlier than 2.6, then open the .msi installer UI to uninstall manually.

Converting Settings Presets for Deployment

The only way to deploy the old Settings Presets from versions of Enscape prior to version 2.6 to multiple machines is to install a VM (Virtual Machine) or to install 2.6 on a test machine, run the file conversion, save the new .json formatted files, then redeploy.

Settings Deployment

It is possible to deploy settings. Currently available options to deploy are Customization and offline asset and material locations.

To achieve this, you need to create settings on a device that has Enscape installed. Perform the desired changes and close Enscape.
These settings will be now saved in the settings.json found in: C:\Users\%username%\Documents\Enscape\Settings

To implement Enscape Customization follow the steps listed in the Customize Enscape page.

Find how to use Enscape assets offline on the Cosmos Asset Library page.

Once these actions have been performed, the “settings.json” is ready to be deployed alongside Enscape.

To implement it, after the installation steps in your script, copy this file to the “Settings” folder listed above.

If you need further assistance, please send a message to our support.