MSI Upgrade Condition Settings

InstallShield 2019

Project • This information applies to the following project types:

•

Advanced UI

•

Suite/Advanced UI

Edition • The Advanced UI project type is available in the Professional edition of InstallShield. The Suite/Advanced UI project type is available in the Premier edition of InstallShield. For information about the differences between these two project types, see Advanced UI Projects vs. Suite/Advanced UI Projects.

When you are building a conditional statement for an exit, detection, eligibility, or feature condition in an Advanced UI or Suite/Advanced UI project, or for an action condition in a Suite/Advanced UI project, you can create an MSI Upgrade condition.

The MSI Upgrade setting shows the condition that is configured for checking target systems for the presence of a version of a product that you want to update, or for the presence of future versions of a product that you do not want to downgrade. In either case, the product whose presence is being checked is installed by an .msi package. To define this type of condition, configure the subsettings under the MSI Upgrade setting as needed.

The following subsettings are available for this condition.

MSI Upgrade Condition Settings
Setting	Description
Upgrade Code	To create a conditional statement that checks for the presence of a product that was installed by an .msi package with a particular upgrade code, click the ellipsis button (...) in this setting to browse to the package and have InstallShield enter the upgrade code for you. As an alternative, you can manually enter the upgrade code. A sample entry is {5D607F6A-AF48-4003-AFA8-69E019A4496F}. Tip • You can use an asterisk (*) as a placeholder for the current package’s upgrade code and either the minimum or maximum version number when you are defining eligibility and detection MSI upgrade conditions, as long as the package that you are configuring is an .msi package.
Minimum Version	Enter the minimum product version that the conditional statement should evaluate when determining whether to run the upgrade package, or click the ellipsis button (...) in this setting to browse to the package and have InstallShield enter the minimum version. Version numbers should be in the format xxxx.xxxx.xxxx. Tip • You can use an asterisk (*) as a placeholder for the current package’s upgrade code and either the minimum or maximum version number when you are defining eligibility and detection MSI upgrade conditions, as long as the package that you are configuring is an .msi package.
Include Minimum Version	Indicate whether you want to include the minimum version value in the range of product versions that you want to include in the conditional statement. This setting helps you specify whether you are using the lower bounds for a range of product versions that your upgrade package will or will not support.
Maximum Version	Enter the maximum product version that the conditional statement should evaluate when determining whether to run the upgrade package, or click the ellipsis button (...) in this setting to browse to the package and have InstallShield enter the maximum version. Version numbers should be in the format xxxx.xxxx.xxxx. Tip • You can use an asterisk as a placeholder for the current package’s upgrade code and either the minimum or maximum version number when you are defining eligibility and detection MSI upgrade conditions, as long as the package that you are configuring is an .msi package.
Include Maximum Version	Indicate whether you want to include the maximum version value in the range of product versions that you want to include in the conditional statement. This setting helps you specify whether you are using the upper bounds for a range of product versions that your upgrade package will or will not support.

MSI Upgrade Condition Settings

InstallShield 2019 Help Library

April 2019