What is this?

This knowledgebase contains questions and answers about PRTG Network Monitor and network monitoring in general.

Learn more

PRTG Network Monitor

Intuitive to Use. Easy to manage.
More than 500,000 users rely on Paessler PRTG every day. Find out how you can reduce cost, increase QoS and ease planning, as well.

Free Download

Top Tags


View all Tags

What command line codes and exit codes can I use with Paessler setups?

Votes:

0

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?

command command-line install installation installer parameter setup software

Created on Mar 19, 2010 3:52:57 PM by  Daniel Zobel [Product Manager]

Last change on Dec 16, 2016 1:21:24 PM by  Luciano Lingnau [Paessler]



4 Replies

Accepted Answer

Votes:

0

Command Line Parameters and Exit Codes for Paessler Setups

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.

Possible command line codes

/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:

  • Yes in a Keep newer file? situation.
  • No in a File exists, confirm overwrite? situation.
  • Abort in Abort/Retry situations.
  • Cancel in Retry/Cancel situations.
  • Yes (= Continue) in a DiskSpaceWarning/DirExists/DirDoesntExist/NoUninstallWarning/ExitSetupMessage/ConfirmUninstall situation.
  • Yes (= Restart) in a FinishedRestartMessage/UninstalledAndNeedsRestart situation.

The following 5 message boxes are not suppressible:

  • The About Setup message box.
  • The Exit Setup? message box.
  • The FileNotInDir2 message box displayed when Setup requires a new disk to be inserted and the disk was not found.
  • Any (error) message box displayed before Setup (or Uninstall) could read the command line parameters.
  • Any message box displayed by [Code] support function MsgBox.

/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:

  • English
  • Deutsch
  • Espanol
  • Francais
  • Japanese
  • Chinese
  • Dutch
  • Brazilian

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.

Setup Exit Codes

Beginning with Inno Setup 3.0.3, the Setup program may return one of the following exit codes:

CodeDescription
0Setup was successfully run to completion.
1Setup failed to initialize.
2The user clicked Cancel in the wizard before the actual installation started, or chose "No" on the opening "This will install..." message box.
3A 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.
4A 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.
5The user clicked Cancel during the actual installation process, or chose Abort at an Abort-Retry-Ignore box.
6The 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  Daniel Zobel [Product Manager]

Last change on Oct 23, 2018 6:03:47 PM by  Gerald Schoch [Paessler Support]



Votes:

0

Hello,

can you please add the available parameters to silently answer the asked for parameters during installation: License key, Email, etc. to pass them automatically with an installation?

Thanks!

Created on Jun 20, 2016 8:29:15 AM



Votes:

0

I tried using the /SILENT option and nothing comes up for 10+ minutes. Nothing is installed either. Help.

Created on Aug 23, 2016 3:26:33 PM



Votes:

0

Hi kusumah,

I posted something about this in the other thread you already opened.

Kind regards.

Created on Aug 24, 2016 9:21:08 AM by  Erhard Mikulik [Paessler Support]

Last change on Aug 24, 2016 9:23:52 AM by  Erhard Mikulik [Paessler Support]




Disclaimer: The information in the Paessler Knowledge Base comes without warranty of any kind. Use at your own risk. Before applying any instructions please exercise proper system administrator housekeeping. You must make sure that a proper backup of all your data is available.