Administration Sequence

InstallShield 2015

Project: This information applies to the following project types:

Basic MSI
InstallScript MSI
MSI Database
Transform

The Administration sequence is the list of actions that execute when a user launches your setup program with the /a command-line option. The built-in actions and dialogs for this sequence are defined in the tables below.

User Interface

The User Interface sequence contains all of the actions and dialogs needed to support a full user interface. This sequence is skipped if an installation is run in silent mode.

Project: The User Interface actions described below are those for a Basic MSI project. For an InstallScript MSI project, your InstallScript code performs the user interface of the installation.

For complete technical details about each standard action, see the Standard Actions Reference in the Windows Installer Help Library.

User-Interface Actions in the Administration Sequence

Action Name

Type of Event

Description

SetupCompleteError

Dialog

This dialog is displayed at the end of an installation if it was terminated because of a fatal error.

SetupInterrupted

Dialog

This dialog is displayed at the end of an installation that was ended by the end user.

SetupCompleteSuccess

Dialog

This dialog is displayed at the end of a successful installation.

SetupInitialization

Dialog

This dialog is displayed while the installation is preparing to begin. The default text for this dialog is “Preparing to install...”

CostInitialize

Standard action

This action is the first step in determining how much disk space is required by the current configuration of the installation.

FileCost

Standard action

This action determines how much disk space will be required by the current configuration of the installation. This action checks to see if any files will be overwritten with newer versions, and it calculates how overwriting those files will affect disk space.

CostFinalize

Standard action

The CostFinalize action determines the total amount of disk space required by the installation in its current configuration. This action also verifies that all target directories are writable.

AdminWelcome

Dialog

This is the first dialog displayed during the Administration sequence.

SetupProgress

Dialog

This dialog displays the progress of the installation.

ExecuteAction

Standard action

This action runs the Administration Execute sequence.

Execute

The Execute sequence contains all the actions that do not rely upon the user interface in order to function properly. These actions include file transfer, publishing components and features, and registering COM servers.

Execute Actions and Dialogs in the Administration Sequence

Action Name

Type of Event

Description

CostInitialize

Standard action

This action is the first step in determining how much disk space is required by the current installation configuration.

FileCost

Standard action

This action determines how much disk space will be required by the current installation configuration. This action checks to see if any files will be overwritten with newer versions and calculates how overwriting those files will affect disk space.

CostFinalize

Standard action

The CostFinalize action determines the total amount of disk space required by the installation in its current configuration. This action also verifies that all target directories are writable.

InstallValidate

Standard action

The InstallValidate action determines if there is enough disk space available for the current setup configuration.

InstallInitialize

Standard action

The InstallInitialize action marks the beginning of the actions that make changes to the end user’s system.

InstallAdminPackage

Standard action

This action copies the installation database to the administrative installation point.

InstallFiles

Standard action

The InstallFiles action copies all of the files to the target machine if the feature that those files belong to is slated for installation. Only files that are associated with components that are to be installed locally will be copied to the target machine.

InstallFinalize

Standard action

This action is the final step of the installation or uninstallation.

See Also