Deploy to Multiple Machines

Deploy to Multiple Machines

If you’d like to deploy your license automatically so that the Enscape user doesn’t have to enter the code manually when starting Enscape for the first time, simply 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

Upon startup of your used CAD software, the license code in the file will automatically be applied. If successful, the file will be deleted.

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

if not exist "%ProgramData%\Enscape" md "%ProgramData%\Enscape"
echo your_license_code > "%ProgramData%\Enscape\License.txt"
start /w msiexec.exe /i Enscape.msi /quiet ACCEPTEULA=1

Note: If you want your license to be deployed on each start up (for each user) without being deleted, name it “License-Persistent.txt”, and place it into “%ProgramData%\Enscape”.

Deploying Enscape for ArchiCAD for all users

Selecting the “all users” option from the installer will only install it for users who have already logged onto the local system at least once. In order to ensure the installation for every user, you have the following options:

  • [Requires Admin Privileges] Run a script on any user’s first log on, from there, call the Plugin installer located in {EnscapeInstallationPath}\Installer\Output like this (Make sure to replace “0|1” by “0” or “1”, depending on whether you wish Enscape to be installed for the corresponding App.)

msiexec.exe /i Enscape.msi REINSTALL=ArchiCAD

To suppress Update Notifications, Graphics Card Driver warnings, and the First Steps window you can set the following registry keys:

  • [HKEY_LOCAL_MACHINE\Software\Enscape] “SuppressFirstStepsWindow”=”1”
  • [HKEY_LOCAL_MACHINE\Software\Enscape] “SuppressGraphicsDriverWarning”=”1”
  • [HKEY_LOCAL_MACHINE\Software\Enscape] “SuppressUpdateNotifications”=”1”

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

NOTE: the implementation for suppressing these popup notifications is currently subject to change.

  • [Does not require Admin Privileges] Run a script on any user’s first log on and write the following keys to the registry, replacing any expression in curly braces as explained further below:
    • [HKEY_CURRENT_USER\Software\GRAPHISOFT\ARCHICAD-64\ARCHICAD-64 {Signature}\Add-On Manager] “Use Default Location”=dword:1
      “Default Location”=%DEFAULT%
      [HKEY_CURRENT_USER\Software\GRAPHISOFT\ARCHICAD-64\ARCHICAD-64 {Signature}\Add-On Manager\Include] “Include Number”=”{Index}”
      “#{Index}.”=”lan.flat:///{EnscapeInstallationPath_ForwardSlashes}/Bin64/Enscape.Archicad.Plugin.Host.apx”

      • {Signature}: Is of the form “{Version} {Locale} {Revision}”. Example: “21.0.0 USA R1” To look it up, open ‘regedit’ and navigate to [HKEY_CURRENT_USER\Software\GRAPHISOFT\ARCHICAD-64]
      • {Index}: Look up [HKEY_CURRENT_USER\Software\GRAPHISOFT\ARCHICAD-64\ARCHICAD-64 {Signature}\Add-On Manager\Include\Include Number] and increase that number by 1. If this key doesn’t exist, use 1.
      • {EnscapeInstallationPath}: The absolute path of your Enscape location
      • {EnscapeInstallationPath_ForwardSlashes}: The absolute path of your Enscape location. Make sure to use forward slashes.

Uninstalling Enscape versions prior to 2.6 via Command Line

It is worth noting that 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)

So, an automatic approach would be to read these registry values and execute the commands, if they exist.

NOTE: this only needs to be performed once.

If you need further assistance, please send an email to our support.


Was this article helpful ?

YesNo

Give us a short feedback: (required)


Start typing and press Enter to search