Installation manual

MSI Return Code
An application event log entry is recorded in the SysMgmt.log file. The following table shows some of the error codes
returned by the msiexec.exe Windows Installer Engine.
Table 8. Windows Installer Return Codes
Error Code Value Description
ERROR_SUCCESS
0 The action is completed successfully.
ERROR_INVALID_PARAMETER
87 One of the parameters was invalid.
ERROR_INSTALL_USEREXIT
1602 The user canceled the installation.
ERROR_SUCCESS_REBOOT_REQUI
RED
3010 A restart is required to complete the installation. This
message is indicative of a successful installation.
NOTE: For more information on all the error codes returned by the msiexec.exe and InstMsi.exe Windows Installer
functions, see support.microsoft.com.
Managed System Software Installation Using Third Party Deployment Software
Use third-party deployment software, such as Altiris Deployment Solution, to install managed systems software on
supported Dell systems. To distribute and install Server Administrator using Altiris, start the Altiris application and import
OpenManage_Jobs.bin located at SYSMGMT\srvadmin\support\Altiris on the Dell Systems Management Tools and
Documentation DVD. Specify a job folder to import OpenManage_Jobs.bin. Modify the Run Script and Copy File tasks to
match the deployment environment. When complete, schedule the job to run on the supported Dell systems that are
managed from the Altiris Deployment Solution.
System Recovery on Failed Installation
The Microsoft Software Installer (MSI) provides the ability to return a system to its fully working condition after a failed
installation. MSI does this by maintaining an undo operation for every standard action it performs during an install,
upgrade, or uninstall. This operation includes restoration of deleted or overwritten files, registry keys, and other
resources. Windows temporarily saves all files that it deletes or overwrites during the course of an installation or
removal, so that they can be restored if necessary, which is a type of rollback. After a successful installation, Windows
deletes all of the temporary backup files.
In addition to the rollback of MSI Standard Actions, the Dell OpenManage library also has the ability to undo commands
listed in the INI file for each application if a rollback occurs. All files that are modified by the Dell OpenManage
installation actions are restored to their original state if a rollback occurs.
When the MSI engine is going through the installation sequence, it ignores all actions that are scheduled as rollback
actions. If a Custom Action, MSI Standard Action, or a Dell OpenManage installation action fails, then a rollback starts.
You cannot roll back an installation once it is completed; transacted installation is only intended as a safety net that
protects the system during an installation session. If you want to remove an installed application, you should uninstall
that application.
NOTE: Driver installation and removal is not executed as part of the installation transaction and therefore cannot
be rolled back if a fatal error occurs during execution.
NOTE: Installations, uninstallations, and upgrades that you cancel during installer cleanup, or after the installation
transaction is completed, are not rolled back.
Failed Updates
Apply the MSI patches and updates provided by vendors to the original vendor MSI packages provided. If you
intentionally or accidentally repackage an MSI package, or make changes to it directly, patches and updates may fail.
36