Summary

Synopsis

This article discusses how to perform a major upgrade with a Basic MSI project when the previous releases used InstallScript MSI projects.

Discussion

If a major upgrade item is used in a Basic MSI to upgrade an old release that was InstallScript MSI, the Add/Remove Programs entry and any resources installed by InstallScript will be left on the machine. Normally, when an InstallScript MSI upgrades a previous InstallScript MSI, special code in the InstallScript engine runs to clean up these resources. However, if a Basic MSI is used to perform the upgrade, this code is not run and therefore the resources will be left on the machine. However, it is possible to perform a manual major upgrade using an EXE type custom action.

1. Add a major upgrade item in the Upgrades view that references the old installation's Upgrade Code.
2. On the Advanced tab on the major upgrade item settings, set the Detect Only setting to Yes. Make a note of the Detect Property name.
3. Add a new EXE->Path referencing a directory action in the Custom Actions view. Name the custom action as needed.
4. In the Working Directory field in the custom action, select TempFolder or SystemFolder from the drop-down box.
5. In the Filename and Command line field, add one of the following command lines based on which version of InstallShield the InstallScript MSI project was built with:

   InstallShield 12 and newer:
   "[ProgramFilesFolder]InstallShield Installation Information\{Old ProductCode}\setup.exe" /uninst
   
   InstallShield 11.5 and older:
   "[CommonFilesFolder]InstallShield\Driver\<IS Version>\Intel 32\idriver.exe" /M{Old ProductCode} /uninst

6. Sequence the custom action at any point after CostFinalize in the Install UI Sequence.
7. In the Install UI Condition field, enter a condition such as the following (using the Detect Property as noted in step 2 above):

   Not Installed AND DETECT_PROPERTY_NAME

8. Build and test the project.

Additional Information

More information on upgrades can be found in the help library article Major Upgrades.