Advanced Tab

InstallShield 2015 » Upgrades View » Upgrade Windows Installer Setup

Project: This information applies to the following project types:

•

Basic MSI

•

InstallScript MSI

•

MSI Database

•

Transform

Project-specific differences are noted where appropriate.

The Advanced tab presents specific settings for major and minor upgrades in addition to some shared settings.

Advanced Settings for the Upgrade Windows Installer Setup Item in the Upgrades View

Property

Description

Upgrade Code

This setting indicates the GUID that uniquely identifies the product family to which this product belongs. The upgrade code should be consistent across different versions and languages of a family of related products so that Windows Installer can use it to search for related versions of the product that are already installed.

For more information on configuring this setting, see Setting the Upgrade Code.

For more information on how the upgrade code is used in upgrades, see Major Upgrade vs. Minor Upgrade vs. Small Update.

On Upgrade

Specify the behavior that you want to occur if Setup.exe detects that an earlier version of your product is present on a target system. Available options are:

•

Disable—If an earlier version is present, Setup.exe does not display a message box to inform end users that an upgrade will occur. In addition, Setup.exe does not set the REINSTALLMODE and REINSTALL properties; therefore, these properties must be set through other methods. Otherwise, Windows Installer uses the cached copy of the .msi database and ignores the changes that are present in the newer version.

•

Don’t prompt the user; just install the upgrade—If an earlier version is present, Setup.exe sets the REINSTALLMODE to voums and the REINSTALL property to ALL; as a result, the installation runs in upgrade mode. If an earlier version is not present, the installation behaves as a first-time installation.

•

Prompt—If an earlier version is present, Setup.exe displays a message box to inform end users that an upgrade will occur; the message box enables them to proceed with the upgrade or exit without upgrading. If an end user chooses to proceed, Setup.exe sets the REINSTALLMODE to voums and the REINSTALL property to ALL, and the installation runs in upgrade mode. This is the default value.

Style

Specify how you want your major upgrade to proceed if the installation detects that an earlier version of your product is present on a target system. Available options are:

•

Complete Uninstall Then Reinstall—This is the most reliable setting; however, it is the least efficient. This option first removes all the files, registry entries, shortcuts, and settings of the old installation. Then it applies new data from the latest version of your installation.

•

Install Then Remove Unused Files—This is the most efficient setting, but it requires that you follow certain authoring rules. This option first installs the new version; then it removes all unnecessary files, registry entries, shortcuts, and settings that are not part of the new version.

•

Install Then Remove Unused Files, with Rollback—This is the most efficient setting, but it requires that you follow certain authoring rules. This option first installs the new version; then it removes all unnecessary files, registry entries, shortcuts, and settings that are not part of the new version.

If the upgrade fails, the Rollback option returns the target system to its previous good state. This option undoes the changes that were made by the uninstallation of the earlier version and the installation of the latest version.

Caution: Note for both of the options that first install and then removed unused resources: The removal of unnecessary resources relies on component reference counts being accurate. Reference counts occur at the component level. Therefore, you should be careful when you delete a component and move the associated resource to a different component. If you have moved existing resources to different components, do not choose either of these install-then-remove options.

Advanced Tab

InstallShield 2015 Help Library

June 2015