Administration Sequence

InstallShield 2019

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.

Administration Sequence

InstallShield 2019 Help Library

April 2019