Upgrades View

InstallAnywhere 2018 » Advanced Designer » Project

Use the Upgrades view on the Project page to configure settings for creation of an upgrade installer that uninstalls earlier versions of your product—if they are present—before installing the new version.

The settings in the Upgrades view are organized into the following areas:

• Upgrades
• Upgrade Configuration
• Upgrade Behavior

Upgrades

Use the Upgrades area in the Upgrades view to specify whether you want to include upgrade support in your installers. This area also shows the upgrade code of the project.

Upgrades Settings

Control

Description

Upgrade Code

Enter a GUID that uniquely identifies a product family. In order to include upgrade support, the upgrade code should be consistent across different versions and languages of a family of related products.

To have InstallAnywhere generate a different GUID for you, click the Generate Upgrade Code button ({...}) in this setting.

The GUID must be in the format that is displayed.

At run time, the installer writes the upgrade code in the InstallAnywhere registry, regardless of whether upgrade support is enabled.

Enable Upgrade Support

Specify whether you want to create installers that have support for upgrading earlier versions of your product that are present on target systems before installing the new version. If upgrade support is not enabled, the installer does not check target systems at run time to verify whether an earlier version of the product needs to be uninstalled before installing the new version.

The default value is No.

For background information on requirements for including upgrade support, see Requirements for Upgrade Support.

Upgrade Configuration

Use the Upgrade Configuration area in the Upgrades view to define information about the earlier versions of your product that you want to be able to upgrade with installers that are built out of the current project. When you click the Manage Upgrade Configurations button in this area, the Manage Upgrade Configurations dialog box opens. To learn more, see Manage Upgrade Configurations Dialog Box.

Upgrade Behavior

Use the Upgrade Behaviors area in the Upgrades view to configure details about the upgrade that you are creating in the current project.

Upgrade Behavior Settings

Control

Description

Abort Installation of New Version If Removal of Earlier Version Fails

Indicate whether you want to avoid installing the new version of the product if an earlier version of the product was detected on the target system but it could not be successfully removed. Available options are:

• Yes—Skip the installation of the new version on the target system.
• No—Install the new version on the target system.

If Multiple Earlier Versions Meet the Upgrade Configuration Conditions

Select the behavior that you want to occur if multiple earlier versions of the product are detected to be present on the target system—that is, if multiple earlier versions of the product meet the upgrade configuration conditions that are configured in the Upgrade Configuration area in the Upgrades view. Available options are:

• Automatically Remove All of Them and Install the New Version—All of the detected earlier versions are silently removed from the target system, and then a single instance of the new version is installed.
• Prompt the End User to Select Which One to Remove—At run time, enable end users to either select one of the existing instances that they want to upgrade or optionally cancel the upgrade. If the installer is running in GUI mode, the installer displays a dialog box to enable end users to select the appropriate option. If the installer is running in console mode, the Command Prompt window displays equivalent prompts to enable end users to select the appropriate option.

If the end user selects an existing instance, that instance is silently removed from the target system, and then a single instance of the new version is installed.

If the installer is running silently, the first instance that the installer finds in the InstallAnywhere registry is removed.

Allow User Install Directory to Be Customized at Upgrade

Indicate whether you want end users to be able to specify a new location for the new version that the upgrade is installing. Available options are:

• Yes—The upgrade installer displays the Chose Install Folder panel, or the equivalent console, to enable the end user to choose where to install the new version that the upgrade is installing.
• No—The upgrade installer installs the new version in the same location where the earlier version was detected on the target system.

Retain Feature Preferences During Upgrade

Indicate whether you want end users’ feature preferences for the earlier version of the product to be retained for the new version that the upgrade is installing. Available options are:

• Yes—The resulting behavior depends on the display option that you select for the Choose Install Sets panel or console action:
• Choose Install Sets [only]—The install sets that were selected for the earlier version of the product are selected by default in the upgrade.
• Choose Product Features [only]—The features that were selected for the earlier version of the product are selected by default in the upgrade.
• Choose Install Sets [followed by] Choose Product Features—The install sets and features that were selected for the earlier version are selected by default in the upgrade.

The Yes option may be useful if the feature tree does not change significantly between the earlier version and the new version.

• No—The upgrade installs the default install set and its features.

See Also

Updating Applications

InstallAnywhere 2018 Help Library

March 2018

 Copyright Information | Flexera

Open topic with navigation