Deployment Installation

Guardian is easily deployed to the firm’s Revit user machines by following the recommended workflow. The same .msi file that is used for manual installations will be used for the deployed installation and can be found here.

Prepare a Deployment Transform File (.mst)

A free Microsoft tool called "Orca", available from the Microsoft SDK, provides a graphical user interface for generating Microsoft transform files (.mst). The .mst file will tell the deployment how to install the .msi file.

Windows SDKComponents for Windows Installer Developers - Win32 apps | Microsoft Docs

1. After installing Orca, load the .msi file.

2. On the main menu, click New Transform.

3. On Property change the following options:

a. USEROPTION = 2 (This will make sure that files will be deployed at “ProgramData”)

b. EulaForm_Property = Yes (This will default the License Agreement to “I Agree”)

4. On CustomAction, change COMPANYID to the one provided for your organization. This will automatically deploy the company key file on the correct folder during installation.

5. Click on Transform then Generate Transform and save it on the same folder as the .msi that will be deployed.

Perform a Test Deployment

The tools for deploying Revit addins are quite diverse. Here is a sample command line that can be used in a deployment tool of choice, such as PDQ:

Sample command line:

msiexec /i "<path>\<filename>.msi" /qn TRANSFORMS="<path>\filename.mst"

Verify the Installation

Open any version of Revit and navigate to Add-Ins > Guardian > Settings > Licensing. The company name should be visible on the License Information dialog as shown below.

If assistance is needed, please reach out to our team at support@iconicbim.com

Perform Full Deployment

Once the test deployment is verified, continue to deploy to all necessary machines.

Please note that Guardian licenses are only activated once a registered project is opened on the end user’s machine. Guardian can be deployed to all machines without having to worry about using licenses.