Installshield Limited: version bumping

When you want to release a new version of your software, you often want it to replace the existing version.  In order to do this in Installshield Limited setup projects, you need to understand the following items.

There are two different codes: Product Code and Upgrade Code.

  • The Product Code is the code for this particular version of your program; you should generate a new code for every version you release.
  • The Upgrade Code is used reference the entire program not just the different releases.  It should remain the same across all version of your program.  You can find your Upgrade Code in your old MSI using the Orca program.

You also need to create an Upgrade Path.  This feature can be found under the Organize Your Setup area.  What you need to do is right-click on the Upgrade Paths entry in the left-hand tree area and create a New Upgrade Path.  It will prompt you for the msi (or setup exe if you change the type) for your previous version.  Once you select your msi it will fill in the entries to the right of the tree for you.  If you do not have your old msi handy, you can fill in the values manually:

  • Use the Upgrade Code of your current release (assuming you haven’t changed it)
  • Leave the Min Version blank – this will remove all previous versions
  • Include Min Version: Yes
  • Max Version: your new version number
  • Include Max Version: Yes
  • Language Identifiers: (you’ll need to look this up; my English language number is 1033)
  • Lang Search Criterion: Include Language Identifier(s) Specified
  • Ignore Remove Failure: No
  • Migrate Feature States: No

So you should do the following for each version bump:

  1. Change the version number in General Information
  2. Generate a new Product Code in General Information
  3. Update the Max Version in Upgrade Paths