Votes:
Especially for automatic installation, what command line parameters do you provide for your setup routines, such as PRTG etc.? Which exit codes are given back from the setup files?
Created on Mar 19, 2010 3:52:57 PM by
Last change on Dec 16, 2016 1:21:24 PM by
4 Replies
Votes:
Setup programs for Paessler products accept optional command line parameters. These can be useful to system administrators, and to other programs calling the Setup program.
Please note: This article is provided for your information only and we do not officially support silent installation of PRTG. At the time we last updated the article, the information provided was valid. However, changes in the installer software or in PRTG may cause (some) options to not work as expected.
/SILENT
Instructs Setup to be silent. The wizard and the background window are not displayed, but the installation progress window is.
Everything else is normal, so for example error messages during installation are displayed and the startup prompt is (if you haven't disabled it with DisableStartupPrompt or the /SP command line option explained above).
If a restart is necessary and the /NORESTART command isn't used (see below), the Setup will display a Reboot now? message box.
/VERYSILENT
Instructs Setup to be very silent. The wizard, the background window, and the installation progress window are not displayed.
Everything else is normal, so for example error messages during installation are displayed and the startup prompt is (if you haven't disabled it with DisableStartupPrompt or the /SP command line option explained above).
If a restart is necessary and the /NORESTART command isn't used (see below), the Setup will reboot without asking.
/SUPPRESSMSGBOXES
Instructs Setup to suppress message boxes. Only has an effect when combined with /SILENT or /VERYSILENT.
If there is a choice in a suppressed message box, the default response will be:
The following 5 message boxes are not suppressible:
/LOG
This option is enabled by default. It causes Setup to create a log file in the user's TEMP directory detailing file installation and [Run] actions taken during the installation process. This can be a helpful debugging aid. For example, if you suspect a file isn't being replaced when you believe it should be (or vice versa), the log file will tell you if the file was really skipped, and why.
You will find the log file in the current user's temporary directory. In order to find this path, open a command line window and type: set temp. Log files will be stored with a file name in the format Setup Log JJJJ-MM-DD #00X.txt; they will not be overwritten or appended to existing files.
The information contained in the log file is technical in nature and therefore not intended to be understandable by end users. Nor is it designed to be machine-parseable; the format of the file is subject to change without notice.
/LOG="filename"
Same as /LOG, except it allows you to specify a fixed path/filename to use for the log file. If a file with the specified name already exists it will be overwritten. If the file cannot be created, Setup will abort with an error message.
/NOCANCEL
Prevents the user from cancelling during the installation process, by disabling the Cancel button and ignoring clicks on the close button. Useful along with /SILENT or /VERYSILENT.
/NORESTART
Instructs Setup not to reboot, even if it's necessary.
/RESTARTEXITCODE=exit code
Specifies the custom exit code that Setup is to return when a restart is needed. Useful along with /NORESTART. Also see Setup Exit Codes (below).
/licensekey="license key"
Specifies the license key for this PRTG installation.
Note: Specifying a distinct license key via a command-line parameter forces the installer to use this key and not the trial key (if available) from the file name of the installer. The trial key is delivered with the file name as of PRTG 18.4.45 if you directly download the installer .exe (unzipped) from paessler.com.
/licensekeyname="license name"
Specifies the license name for this PRTG installation.
/adminemail="email address"
Specifies the email address for the PRTG System Administrator user of this PRTG installation.
/LANG="language"
Specifies the language to use. language specifies the internal name of the language as specified in a [Languages] section entry.
Currently (PRTG 17.4.35), valid values from this [Languages] section are:
When a valid /LANG parameter is used, the 'Select Language' dialog will be suppressed.
/DIR="x:\dirname"
Overrides the default directory name. A fully qualified pathname must be specified.
/GROUP="folder name"
Overrides the default folder name displayed on the Select Start Menu Folder wizard page. If the [Setup] section directive DisableProgramGroupPage was set to yes, this command line parameter is ignored.
/NoInitialAutoDisco=1
Disables the initial auto-discovery (which is also called "smart setup").
/NOICONS
Instructs Setup to initially check the Don't create a Start Menu folder check box on the Select Start Menu Folder wizard page.
/HELP
/?
Cause the setup to display the of accepted command line parameters in a message box, exiting with exit code 0 afterwards. If the UseSetupLdr [Setup] section directive was set to no, this setting is ignored.
/PORTABLE=1
Causes the setup to not create an uninstaller nor an entry in the Add/Remove Programs Control Panel applet.
Beginning with Inno Setup 3.0.3, the Setup program may return one of the following exit codes:
| Code | Description |
|---|---|
| 0 | Setup was successfully run to completion. |
| 1 | Setup failed to initialize. |
| 2 | The user clicked Cancel in the wizard before the actual installation started, or chose "No" on the opening "This will install..." message box. |
| 3 | A fatal error occurred while preparing to move to the next installation phase (for example, from displaying the pre-installation wizard pages to the actual installation process). This should never happen except under the most unusual of circumstances, such as running out of memory or Windows resources. |
| 4 | A fatal error occurred during the actual installation process. Note: Errors that cause an Abort-Retry-Ignore box to be displayed are not fatal errors. If the user chooses Abort at such a message box, exit code 5 will be returned. |
| 5 | The user clicked Cancel during the actual installation process, or chose Abort at an Abort-Retry-Ignore box. |
| 6 | The Setup process was forcefully terminated by the debugger (Run|Terminate was used in the IDE). |
Before returning an exit code of 1, 3, or 4, usually an error message will be displayed, explaining the problem.
Created on Mar 19, 2010 4:23:22 PM by
Last change on Oct 23, 2018 6:03:47 PM by
Votes:
Created on Aug 24, 2016 9:21:08 AM by
Last change on Aug 24, 2016 9:23:52 AM by
Add comment