The installation process for Onboard can be streamlined using the silent install method. The silent installation method installs or uninstalls the application without running the InstallShield wizard. This eliminates the need to choose options and settings in the dialog boxes each time the installer is run. Updates can also be installed using this method.
The silent installation involves running the Microsoft Installer Utility (msiexec.exe) along with some additional parameters. The silent install can be run from either an .msi file or a setup.exe file, however, the setup.exe file is recommended.
The desired settings can be saved to a user-defined batch (.bat) file, which can be run by double-clicking the file in Windows Explorer.
After performing a silent install of Onboard, it is then necessary to open the Onboard Viewer application to configure the license settings for Onboard. Licensing is configured using the License Setup wizard, which is launched automatically the first time Onboard Viewer is started. Refer to the CARIS Licensing Guide for information on this wizard.
The table below describes the parameters that are available for running a silent install.
Parameter | Description |
setup.exe | This parameter instructs the Microsoft Installer Utility to install the application to your computer via a setup.exe file. If the file is not in the current folder, you will need to provide the full path to the file, such as When using a batch file to run the installation, the current directory is the location of the batch file. |
/i | This parameter instructs the Microsoft Installer Utility to install the application to your computer via an .msi file. The .msi file to be used must also be specificed, enclosed in quotes. If the file is not in the current folder, you will need to provide the full path to the file. When using a batch file to run the installation, the current directory is the location of the batch file. • |
/x | This parameter instructs the utility to uninstall the application from your computer. It must be the first parameter specified in the command following the install method parameter. • • |
| This parameter tells setup.exe to run in silent mode. It must be accompanied by the • |
| This parameter is used to pass parameters to msiexec when running a silent install from a setup.exe file. This allows the msiexec parameters to be used in addition to the setup.exe parameters. The parameter(s) to be passed to msiexec should be specified in quotes after this parameter, with no spaces between the parameter, the quote or the msiexec parameter. • If using this parameter to submit msiexec parameters that require a file path, it is recommended that file paths not contain spaces. |
| The /qn parameter sets the install process to run entirely in the background with no user interface to indicate install progress. The /qb parameter sets the install process so that a minimal user interface is shown, specifically, a dialog box with a progress bar. As these are msiexec parameters, they must be enclosed in quotes with the /v parameter. • • |
| This parameter will generate a log of the operations run by the setup.exe. A file name must be provided for the resulting log file. If msiexec actions also need to be logged, the msiexec /l parameter will also be required. • |
| This parameter creates a log file that records the actions performed by msiexec during install. A file name must be provided for the resulting log file. Unless a path is specified for the log file, it is saved in the current directory. That is the directory of the batch file if a batch file is used. As this is an msiexec parameter, it must be enclosed in quotes with the /v parameter. • |
| This parameter sets the installation path on your computer for the application. The path must be enclosed in quotation marks and the parameter must be entered using upper-case letters. If the INSTALLDIR parameter is not used, then one of two possible paths is used: • The default installation path for Onboard, which is • Update installs will automatically install to the same location as the base release. As this is an msiexec parameter, it must be enclosed in quotes with the /v parameter. • • |
| Force or suppress the restarting of the computer after installation is complete. By default, the computer does not restart after installation. This parameter has two possible values: REBOOT="F" (force a restart) As this is an msiexec parameter, it must be enclosed in quotes with the /v parameter. • |
The example below would be used to perform a silent install of Onboard with the following settings:
• the setup.exe file will be used and is located in the same directory as the .bat file,
• a progress bar will be displayed for the installation process,
• the application will be installed to a custom location, and
• logging would be recorded for both the setup.exe and the msiexec.
setup.exe /s /debuglog"exe_actions.log" /v"/qb /l* msi_actions.log INSTALLDIR=D:\Applications\CARIS\Onboard\2.1" |