7.1 Create or Modify a Transform

Setup customization files are standard MSI transform files (*.mst). Transforms can be used with any installation that starts with setup.exe or with command-line installs (used by many deployment tools).

You can use transforms to:

  • Specify which features are installed.

  • Customize start menu shortcuts.

  • Run additional programs (such as companion installation packages) automatically before or after Setup.exe.

To create a transform with the Installation Customization Tool

  1. From your administrative installation point, open the Installation Customization Tool from a shortcut or by typing the following command line:

    <path_to_setup> \setup.exe /admin

  2. In the Select Customization dialog box, select Create a new Setup customization file for the following product or Open an existing Setup customization file.

  3. Select items from the list in the left panel to open configuration panels on the right, and then make your customizations.

  4. Save your transform as an .mst file.

    NOTE:Micro Focus recommends that you save transform files in the same folder as the InfoConnect base installation package .msi file.

7.1.1 Create a Transform that Specifies which Features to Install

You can specify which features are installed to your end users by using the Installation Customization Tool to create a transform file that modifies the installation. In addition, you can choose from three options for not installing an item; advertising it, not installing it, and permanently blocking it so that users can not install it later.

To select features, components, and languages to install

  1. From your administrative installation point, open the Installation Customization Tool from a desktop shortcut or by typing the following command line:

    path_to_setup\setup.exe /admin

  2. Select Create a new Setup customization file for the following product.

  3. Under Features, choose Set Feature Installation States.

  4. Use the feature tree to configure each feature's installation state as follows:

    Choose

    To do this

    Feature will be installed on local hard drive

    Add a feature to the installation.

    Feature will be installed when required

    Advertise a feature.

    Feature will be unavailable

    Leave a feature uninstalled. End users will still be able to select the item and install it from Windows Programs and Features or Add/Remove Programs.

    Feature will be hidden from view

    Leave a feature uninstalled and hidden. End users will not be able to install the item, and it will not be visible in the Windows Programs and Features or Add/Remove Programs.

  5. Click File > Save As.

    Your changes are saved to a transform (*.mst) file.

  6. Apply the transform to your installation.

7.1.2 Modify Setup Properties

You can modify existing InfoConnect setup properties, such as setting the default application folder, or add your own properties to the install. An example of an installer property is ARPHELPLINK, which sets the URL used by the support link in Windows Programs and Features. For a list of installer properties, see InfoConnect MSI Properties.

Yu can modify installer properties in both transforms (.mst) and companion installers (.msi). The procedure below describes creates modifications in a transform file.

CAUTION:

  • InfoConnect uses two properties to configure the user data location. If you configure a non-default user data location, you must set both USERDATALOC_CUSTOM_PATH and WRQ_USERDIR to the same path.

  • Do not overwrite existing properties unless you fully understand how the changes affect your install. Setting properties to improper values can break the install.

To modify installation properties

  1. From your administrative installation point, open the Installation Customization Tool from a desktop shortcut or by typing the following command line:

    path_to_setup\setup.exe /admin

  2. Select Create a new Setup customization file for the following product.

  3. On the Installation Customization Tool navigation pane, select Modify setup properties.

  4. In the Namebox, use the drop-down list to select commonly-used public properties that are standard to the Windows Installer. Select an item in the list to see a brief description of the selected property. For additional information about Windows Installer properties, see Microsoft's Windows Installer Guide. Some Micro Focus products.

    InfoConnect supports. additional properties that do not appear in the drop-down list. You can configure these properties by manually entering the property name. See InfoConnect MSI Properties.

  5. From the File menu, choose Save As.

  6. Apply the transform to your installation.

7.1.3 Create a Chain Installation to Run Additional Programs

Use this procedure to set up a chain install that automatically runs companion install packages (*.msi) before or after the primary installation, or that launches other scripts or programs.

To chain installations and programs

  1. From your administrative installation point, open the Installation Customization Tool from a desktop shortcut or by typing the following command line:

    path_to_setup\setup.exe /admin

  2. Select Create a new Setup customization file for the following product.

  3. From the Installation Customization Tool navigation pane, choose User Interface, then select Use this customization with interface installs using setup.exe.

  4. From the Installation Customization Tool navigation pane, choose Add installations and run programs.

  5. Click Add.

    The Add/Modify Program Entry dialog box opens.

  6. In the Targetlist, enter or select the folder where the program .exe file or the .msi file resides, and then enter the executable to run; for example:

    msiexec.exe
  7. Under Arguments, enter the command-line arguments to execute; for example:

    /i My_installation.msi
  8. Choose one of the following options to specify when to run the program.

    • Run this program after the base product has been installed.

    • Run this program before the base product has been installed.

      NOTE:For most cases, select Run this program after the base product has been installed. If you select this option before the base product has been installed and the program fails, INFOConnect is not installed.

  9. Repeat these steps to add other programs or .msi files.

  10. To change the execution sequence, use the arrows next to Move (at the bottom left area of the pane. To remove a program from the list, select it in the list and click Remove.

  11. Save your transform and apply this transform to your installation.