- Standard (EXE or MSI) Installers
-
There are two methods for running OnBase installers: Interactive and silent. An interactive installation requires user interaction with dialog boxes during the installation process. A silent installation does not require user interaction during the installation process.
OnBase installers may consist of both an executable file (.exe) and a Windows Installer Package file (.msi). When performing an interactive installation, and both an executable file and MSI are available, use the executable file to ensure a complete installation. The executable validates that all prerequisites are met before proceeding with the installation. If any missing prerequisites are identified, the installer alerts the user. Most missing prerequisites can be installed directly from the installer before continuing the installation process.
The Microsoft .NET Framework prerequisite must always be installed separately before running either the EXE or MSI installer. Refer to the Licensing for more information.
When performing a silent installation, and both an executable file and MSI are available, use the MSI. Since the MSI package does not validate prerequisites, you must ensure that Windows Installer 3.0 or greater is installed on each workstation and that all other prerequisites are met before running the MSI. If any prerequisites are not met, a silent installation from the MSI will fail without alerting the user.
For more information about configuring a silent installation, see http://msdn.microsoft.com/en-us/library/aa367988.aspx.
- User Account Control (UAC)
-
If Windows User Account Control (UAC) is enabled, the installer must be run with elevated administrator privileges, even if an administrator is currently logged on. This can be accomplished by right clicking on the installer executable and selecting Run as Administrator from the right-click menu. MSI files cannot be run using the Run as Administrator option. Instead, you must launch the MSI package using the command line. For more information on installing files through the command line, refer to your Microsoft support information or see http://technet.microsoft.com/en-us/library/cc759262(WS.10).aspx.
- Silent Installation Using setup.exe
-
If you are running setup.exe silently from the command line you must use the /q switch and the /CompleteCommandArgs switch, followed by the required command-line arguments.
The q switch specifies quiet mode and is required to suppress the GUI. The CompleteCommandArgs switch must be followed by the command-line parameters required to configure and install the desired components.
The complete string of command-line parameters must be included in double quotes after the CompleteCommandArgs switch. If a parameter in the string also requires double quotes, those quotes must be escaped using \. For example: setup.exe /q /CompleteCommandArgs "INSTALL_PROPERTY=\"my value\" INSTALL_PROPERTY_2=\"my value 2\"".
You should check the return value of the setup.exe process. A return value of 0(zero) indicates success. Any other value returned may indicate that an error was encountered and the installation failed.