Configuring the Enable Maintenance Setting

InstallShield 2016

Project • This information applies to InstallScript MSI projects.

Use the Enable Maintenance setting in the General Information view to indicate whether you want to display the full maintenance user interface (UI) or the uninstallation UI when end users rerun the installation on a system on which the product is already present.

The following table shows the available options for the Enable Maintenance setting.

Enable Maintenance Setting Options

Option

Description

Yes

Unless the /removeonly command-line parameter is passed to Setup.exe, the system variable REMOVEONLY is set to FALSE when an end user reruns the installation, and the standard maintenance UI is displayed.

No

The system variable REMOVEONLY is set to TRUE when an end user reruns the installation, and the uninstallation UI is displayed.

Note • Selecting No for the Enable Maintenance setting does not cause the OnUninstall event handler to be called. If you want the OnUninstall event handler to be called, you must use the /uninst command-line parameter for Setup.exe. Note that this is applicable only if the InstallScript UI style is the traditional style, which uses the InstallScript engine as an external UI handler. The /uninst command-line parameter is not supported if the InstallScript UI style is the new style (which uses the InstallScript engine as an embedded UI handler). To learn more, see Using the InstallScript Engine as an External vs. Embedded UI Handler for InstallScript MSI Installations.

Note • InstallScript MSI installations show separate Change and Remove buttons in Add or Remove Programs in the Control Panel by default. Clicking the Change button always displays the maintenance UI, and clicking the Remove button always displays the uninstallation UI.

The Enable Maintenance setting has no effect on the behavior that occurs if end users initiate maintenance for your product by clicking the Change button for your product’s entry in Add or Remove Programs.

If you want to prevent end users from being able to run maintenance from within Add or Remove Programs, select Yes for the Disable Change Button setting in the General Information view.

See Also