Upgrade Path Settings
InstallShield 2022 Express Edition
By specifying upgrade path settings, you indicate how you want to affect an end user’s system if a previously released version of your product that uses Windows Installer is installed—and that installed version has a different product code and a different version number than your current release. Each upgrade entry setting is described below:
|
Setting |
Description |
|||||||||
|
Upgrade Code |
This setting contains as its value the upgrade code GUID of the product version that you want this version of your application to replace. When the installation of your current version begins, the Windows Installer engine searches the target system for the upgrade code specified. Upon finding a matching upgrade code—along with other matching upgrade properties—the Windows Installer upgrades the target system by installing the new version. If you added an upgrade entry to the Upgrade Paths tree by browsing for and selecting an .msi file on your system, the upgrade code of that .msi file automatically populates the Upgrade Code setting. If the .msi file for the product version that you want to upgrade is not on your system, you can type the upgrade code in this setting. You can also use the ellipsis (...) button to navigate to an .msi file (or a Setup.exe file that contains an .msi file) on your system and populate the Upgrade Code setting. Caution:The upgrade code must be the same as that of the previous version of your product that was installed using Windows Installer technology. |
|||||||||
|
Min Version |
The Min Version setting further defines the Windows Installer’s search for installed versions to upgrade. The previously installed version’s upgrade code must first match the value specified in the Upgrade Code setting. Once a matching upgrade code match is detected, the search can be narrowed by the minimum and/or maximum version specified and whether the versions are included or excluded (indicated in the Include Min Version and Include Max Version settings). This setting contains the minimum version number of the product that you want your current version to update. The setting can be populated in one of the following ways:
Caution:You must specify a value for at least one of the version settings: Min Version, Max Version, or both. |
|||||||||
|
Include Min Version |
Specify whether you want to include the minimum version—specified in the Min Version setting—in the upgrade. If you want the Windows Installer to include the minimum version in the search for previously installed versions of your product on the target system, select Yes. |
|||||||||
|
Max Version |
The Max Version setting further defines the Windows Installer’s search for installed versions to upgrade. The previously installed version’s upgrade code must first match the value specified in the Upgrade Code setting. Once a matching upgrade code match is detected, the search can be narrowed by the minimum and/or maximum version specified and whether the versions are included or excluded (indicated in the Include Min Version and Include Max Version settings). This setting contains the maximum version number of the product that you want your current version to update. The setting can be populated in one of the following ways:
Caution:You must specify a value for at least one of the version settings: Min Version, Max Version, or both. |
|||||||||
|
Include Max Version |
Specify whether you want to include the maximum version—specified in the Max Version setting—in the upgrade. If you want the Windows Installer to include the maximum version in the search for previously installed versions of your product on the target system, select Yes. |
|||||||||
|
Language Identifiers |
The Language Identifiers setting further defines the Windows Installer’s search for installed versions to upgrade. The previously installed version’s upgrade code must first match the value specified in the Upgrade Code setting. Once a matching upgrade code match is detected, the search can be narrowed by the languages specified and included or excluded (indicated in the Lang Search Criterion setting). This setting identifies the decimal language identifier or identifiers for the product version that you want to upgrade. To provide the decimal language identifier or identifiers for the product version that you want to upgrade:
As an alternative, you can also type the decimal value or values for this setting. To indicate more than one language, separate the language identifiers with a comma (,). Note:If you added an upgrade entry to the Upgrade Paths explorer by browsing for and selecting an .msi file on your system, InstallShield automatically uses the decimal language value for that .msi file by default for the Language Identifiers setting. |
|||||||||
|
Lang Search Criterion |
Specify whether you want to include the language identifiers that are specified in the Language Identifiers setting in the Windows Installer’s search for product versions previously installed on the target system. Leave this setting blank to include all languages. |
|||||||||
|
Ignore Remove Failure |
Specify whether you want the Windows Installer to continue installation of the current version if it fails to remove a previous version of your product that exists on the target system. If you select No, the Windows Installer aborts the installation of the current version if it fails to remove a previous version of your product that exists on the target system. |
|||||||||
|
Migrate Feature States |
Specify whether you want the upgrade to attempt to migrate the feature-selection states from an installed product version to the newer version. When installing the previous version of your product, an end user may have selected to install certain features, and not install others. During the upgrade to a new version of your product, these original selections can be retained as the default selections by selecting Yes for the Migrate Feature States setting. For example, if your original product contained Feature1, Feature2, and Feature3, and an end user installed only Feature1 and Feature3, by default Feature1 and Feature3 will be selected for installation when your upgraded setup is run. Feature2 will, by default, remain unselected. |
See Also
Updating the Package Code, the Product Version, and the Product Code