InstallShield 2015 » Upgrades View » Major Upgrade Item
Project: This information applies to the following project types:
| • | Basic MSI |
| • | InstallScript MSI |
| • | MSI Database |
| • | Transform |
A major upgrade is required when the product code for an installation differs from the product code of the installation that it needs to upgrade. For help in determining whether you need to change the product code, see Major Upgrade vs. Minor Upgrade vs. Small Update.
At run time, a major upgrade effectively uninstalls the previous version of your application before installing the newest version of your application.
The Common tab contains the most frequently used settings of a major upgrade item. For more detailed settings, use the Advanced tab.
Major Upgrade
Major upgrades use an upgrade code to detect previous versions of an application. The upgrade code for an installation groups that installation into a specific product family. If you want to target specific installations within that product family, you can configure the product version attribute of this upgrade item.
|
Option |
Description |
|
Products Sharing My Upgrade Code |
If you select this option for your major upgrade item, InstallShield sets the value of this setting on the Advanced tab to the placeholder value of {00000000-0000-0000-0000-000000000000}. InstallShield uses the appropriate upgrade code value instead of the placeholder value in the .msi package that it generates at build time. |
|
Products Having Another Upgrade Code |
If you select this option for your major upgrade item, you can either specify the upgrade code of the base package that this major upgrade item will target, or you can click the ellipsis button (...) to browse to the package. If you browse to the package, InstallShield identifies the upgrade code of the package that you select and uses it in this setting. |
Product Version
Choose a particular product version to target or define a range. You can choose from the following selections:
|
Option |
Description |
|
Any earlier version |
To update the product on target systems if its version number is earlier than the product version of the currently open project, select this option. If you select this option for your major upgrade item, InstallShield sets the value of the Maximum Version setting on the Advanced tab to the placeholder value of ***ALL_VERSIONS***. InstallShield uses the product version of the currently open project instead of the placeholder value in the .msi package that it generates at build time. |
|
Within a specific range of versions (Minimum Version - Maximum Version) |
To specify a range of product versions that you want the upgrade to target, select this option. Then, specify the minimum version in the left box, and the maximum version in the right box. The Version Range Inclusive check box lets you optionally include or exclude the specified version numbers in the range of target versions. For example, a minimum version of 1.00 and a maximum version of 4.00 results in an installation that upgrades any existing installation in the specified product family that has a version number between 1.00 and 4.00. If you select the Version Range Inclusive check box, the version search also checks for version 1.00 and version 4.00, and upgrades those versions if they are present. |
|
Version Range Inclusive |
To include both the minimum and maximum version numbers in the range of versions that the upgrade targets (instead of just the version numbers within the specified minimum-to-maximum range), select this check box. For example, a minimum version of 1.00 and a maximum version of 4.00 results in an installation that upgrades any existing installation in the specified product family that has a version number between 1.00 and 4.00. If you select the Version Range Inclusive check box, the version search also checks for version 1.00 and version 4.00, and upgrades those versions if they are present. To include only the minimum version number or only the maximum version number, but not both, use the Include Minimum Version setting or the Include Maximum Version setting on the Advanced tab. This check box is available if the Within a specific range of versions option is selected. |
|
With a specific version |
To target only a single previous version of the product, select this option, and then enter the appropriate version number. |
See Also
Determining the Best Upgrade Solution
Packaging Options for Upgrades
Preventing the Current Installation from Overwriting a Future Major Version of the Same Product
InstallShield 2015 Help LibraryJune 2015 |
Copyright Information | Contact Us |