Behavior Tab

InstallShield 2019 » InstallShield Prerequisite Editor

The Behavior tab of the InstallShield Prerequisite Editor is where you specify what should occur in certain scenarios.

Settings on the Behavior Tab

Setting

Description

The prerequisite requires administrative privileges

Select this check box if administrative privileges are required to install the InstallShield prerequisite or if the InstallShield prerequisite must be installed per machine. This check box is selected by default.

Note • InstallShield prerequisites that require administrative privileges may require that end users provide credentials or consent before installation can occur on Windows Vista and later systems. For more information, see Minimizing the Number of User Account Control Prompts During Installation.

The prerequisite may be optionally skipped by the user

If the installation should display a message box that enables end users to choose whether to install the InstallShield prerequisite, select this check box.

If end users should not be able to choose whether to install the InstallShield prerequisite, clear this check box.

The prerequisite should be hidden from the installation list

If a target system needs one or more setup prerequisites to be installed, the setup prerequisite dialog is displayed at run time before the main installation runs. When an end user clicks the Install button on this dialog, the setup prerequisites are installed.

If you want to include the current setup prerequisite in the list of setup prerequisites that are displayed in that dialog, clear this check box.

If you do not want to include the current setup prerequisite in the list, select this check box. The setup prerequisite is hidden from the list of setup prerequisites, but it is still installed on the target system if needed.

Note • Feature prerequisites are never listed in the setup prerequisite dialog at run time, regardless of whether the The prerequisite should be hidden from the installation list check box is selected or cleared. That is, if you add an InstallShield prerequisite to your project and associate it with a feature, that feature prerequisite is not listed in the setup prerequisite dialog that is displayed at run time before the main installation runs.

Note that if a setup prerequisite or a feature prerequisite is marked as hidden, it is launched with its silent command-line parameters—not its standard command-line parameters. To learn more, see Specifying Command-Line Parameters for an InstallShield Prerequisite.

Progress should be shown in the prerequisites window (raw MSI file only)

If you want the progress of the installation for the current InstallShield prerequisite to be displayed at run time, select this check box. The progress can be shown only if the InstallShield prerequisite installation is an .msi file; it cannot be shown if the file that the InstallShield prerequisite installation launches is a Setup.exe file. In addition, the installation that contains the prerequisite must be a Basic MSI or InstallScript MSI installation.

If your InstallShield prerequisite installation is a Setup.exe file, this setting is ignored. In addition if the installation that contains the InstallShield prerequisite is an InstallScript installation, this setting is ignored.

Note • If you select this check box so that progress can be shown, only some command-line parameters are supported. Command-line parameters are specified on the Application to Run tab of the InstallShield Prerequisite Editor. For more information, see Specifying Command-Line Parameters for an InstallShield Prerequisite.

Also note that if you specify that the progress should be shown for a prerequisite that is an .msi package, the user interface of the prerequisite’s .msi package is not displayed by default. If you want to override this behavior, you can specify /qf as a command-line parameter on the Application to Run tab.

If, after installing the prerequisite, the conditions still indicate it is required

If the conditions still indicate that the InstallShield prerequisite needs to be installed after the InstallShield prerequisite installation has been run, either of the following may be true:

•

The InstallShield prerequisite was not successfully installed.

•

The conditions that were specified for the InstallShield prerequisite were not accurate.

For example, a condition may indicate that the InstallShield prerequisite needs to be installed if a particular file does not exist on the target machine. If the file is still missing even after the InstallShield prerequisite is installed, it is possible that the condition should not have been created.

Specify the behavior that should occur if the conditions still indicate that the InstallShield prerequisite needs to be installed. The available options are:

•

Abort the setup—If your application should not be installed, select this option.

•

Ask whether to continue the setup—If the installation should display a message box that prompts the end user to specify whether the main installation should continue, select this option.

•

Continue the setup—If the installation should essentially ignore the InstallShield prerequisite’s unmet condition and proceed to the next InstallShield prerequisite installation (if one is required) or the main installation, select this option.

If the prerequisite requires a reboot

Installing an InstallShield prerequisite may require that the target machine be restarted, as described in Restarting a Target Machine for InstallShield Prerequisite Installations.

Specify the behavior that should occur if the InstallShield prerequisite requires that a target machine be restarted.

•

Exit and resume on reboot—To end the InstallShield prerequisite installation, allow the InstallShield prerequisite to restart the target machine, and then continue the installation, select this option.

•

Note it, fail to resume if the machine is rebooted, and reboot after the installation—To note that the target machine should be restarted if it is required, to schedule the restart for the end of the main installation, but to exit if the target machine restarts after the InstallShield prerequisite installation, select this option. Thus, if it appears that a restart is required but you want to postpone it until the end of the main installation (or until a subsequent InstallShield prerequisite triggers a restart), select this option.

At run time, the value of the Windows Installer property ISSCHEDULEREBOOT is set to 1 in the main installation when a restart is still pending.

•

Ignore it, and fail to resume if machine is rebooted—To continue the installation but end it if the target machine is restarted, select this option. Thus, if it appears that a restart is required but you want to try to skip it, select this option.

•

Prompt the user only if no reboot is detected, but always reboot the machine and resume on reboot—To prompt the end user to restart the target machine only if it appears that the target machine does not need to be restarted, select this option. The target machine is restarted if the end user agrees to allow it, and then the installation continues.

•

Prompt the user to reboot the machine even if nothing is detected, and resume on reboot—To prompt the end user to restart the target machine even if it appears that the target machine does not need to be restarted, select this option. The target machine is restarted if the end user agrees to allow it, and then the installation continues.

•

Reboot the machine and resume on reboot—To restart the target machine and then continue the installation, select this option.

Behavior Tab

InstallShield 2019 Help Library

April 2019