Advanced MST configuration

Advanced configuration of an MST transform file to support configuration options not supported by the CDA wizard UI.

The pictures on this page may not show the latest versions of 1E products.

Client Deployment Assistant supports the following 1E products, you should review documentation for their installer properties to know what options are possible.

  • 1E Client (includes clients for Content Distribution, PXE Everywhere, Shopping/WSA, WakeUp, and 1E) (new).

  • 1E NightWatchman Agent.

The guidance here is for adding an installer property by editing the base MST transform file provided out-of-box for 1E Client, but the process also works for other MST. Editing a base MST before running the CDA wizard helps you if know you will use the modified MST more than once, for example if you are working in a lab, and want to re-use it in a production environment. This approach only works if you are adding or editing installer properties that are not affected by running the CDA wizard.

An alternative approach is to edit the updated MST transform produced by CDA after running the wizard. This is only useful if the edited MST will be used in the same environment, although you can also edit the environment-specific settings you set when running the wizard. This approach is most frequently used if you need fine-tune properties provided in the base MST and the CDA wizard is not able to configure them exactly the way you need. Refer to Installer properties

You must use UPPERCASE when specifying the name of any installer property in a mst transform file, and preferably when including them in a msiexec command-line.

Adding installer properties to the base MST transform file

To extend installer properties or change default settings for Nomad clients, you can edit their associated MST transform files by using a tool such as Orca a database table editor for creating and editing Windows Installer packages. Orca is a Microsoft tool for creating and editing Windows Installer packages (MSI) and merge modules (MST transforms). It is available from the Windows Installer Development Tools - https://docs.microsoft.com/en-us/windows/desktop/msi/orca-exe.

The following example configures StatusMsgEvents by modifying the x64 .mst file. When the wizard is run, the new transform is applied to the deployment and package, and the new value is set when Content Distribution is installed.

Status message events should be used with caution as they could impact your Configuration Manager environment when scaled up to tens of thousands of machines.

The following steps are recommended only for values unaffected by running the CDA wizard, because updated base settings may be changed when the wizard runs. Refer to Installer properties.

To edit the installer with Orca:

  1. Right-click the 1E.Client-x64.msi choosing Edit with Orca from the context menu.

  2. From the Transform menu in the Orca application, select Apply Transform....

  3. In the Open dialog, select the 1E.Client-x64-5.1.x.mst file.

  4. In the Table list on the left, scroll down and locate Property.

  5. On the right pane, scroll down to StatusMsgEvents and update its value to 0x1000000064 ( 0x0 by default).

  1. From the Transform menu, choose Generate Transform and save the file with a new name.

    For example: 1E.Client-x64-x.x.x-StatusMsgEvents.mst

  2. Edit the AppImport.xml file and update <AppSourceMST> and <PkgSourceMST> to point to the new transform file.

    The image shows the original file.