Create an installer transform

Prerequisites

Before you begin, complete the following:

• To create an installer transform using New-InstallerTransform.ps1, use of the following options:

  • Internet access is available on the machine used to create the transform file, to allow the script to automatically download the WiX Toolset.

  • WiX Toolset version 3.14.1 is installed on the machine used to create the transform file. To download the installer, refer to the Wix Toolset Wix 3 Github.

  • The path to the WiX Toolset 3.14.1 binaries is specified using the WixPath parameter.

An installer transform file (.mst) is generated using the New-InstallerTransform.ps1 PowerShell script, which is included in the installation package in InstallTools\SetupClient.

The script generates a transform file at the location specified by TransformPath, based on the MSI installer provided by InstallerPath. The transform applies the configuration values supplied through the ServerHost, ServerPort, and Authentication parameters.

To create and apply a transform file is equivalent to supplying installer properties directly on the command line when running msiexec. The generated transform can be applied either directly through msiexec or by a Group Policy Object (GPO).

An installer transform is not related to a specific installer version. For example, a transform generated for installer version 10.3.3.0 is applicable to installer version 10.3.4.0, if the relevant properties are unchanged.

Parameters

The parameters are as follows:

• [string] InstallerPath (Mandatory): Specifies the path to the MSI installer file for which the transform is created. Both relative and absolute paths are supported.

• [string] TransformPath (Mandatory): Specifies the path where the transform file (.mst) is created. Both relative and absolute paths are supported.

• [string] ServerHost: Specifies the value assigned to the SERVERHOST installer property through the transform.

• [int] ServerPort: Specifies the value assigned to the SERVERPORT installer property through the transform.

• [string] Authentication: Specifies the value assigned to the AUTHENTICATION installer property through the transform. The valid values are windows and custom.

• [string] WixPath: Specifies the path to the directory containing the WiX Toolset binaries and the Microsoft.Deployment.WindowsInstaller.dll file.

Usage Example for AVEVA Enterprise Resource Management Client

.\InstallTools\SetupClient\New-InstallerTransform.ps1

-InstallerPath .\Client\Aveva.Erm.Installer.msi

-TransformPath .\Client\Aveva.Erm.Installer.mst

-ServerHost erm01 -ServerPort 9200 -Verbose

Run the command from the root directory of the installation package. A new transform file Aveva.Erm.Installer.mst is created based on the installer Aveva.Erm.Installer.msi, and overrides the default values of the SERVERHOST and SERVERPORT properties.