How to install nTop with Command Prompt

Objective:

This article explains how to install the nTop MSI using the Command Prompt, including silent installs. Command prompt installs are useful to organizations requiring IT professionals or system administrators to deploy software. They can also enable logging, which may be useful for troubleshooting.

Applies to:

  • nTop
  • Windows 10 and Windows 11
  • Command Prompt

Procedure:

  1. Create a directory to save the MSI and log files. For this example, C:\nTop
  2. Save a copy of the MSI to C:\nTop. For this example, nTop-<version>.msi (replace <version> with the version you downloaded, for example 6.2.2).
  3. Click the Windows Start button and select Windows System > Command Prompt. To install for all users, right-click it and choose Run as administrator.
  4. At the prompt type:
msiexec /i "C:\nTop\nTop-<version>.msi" /L*V "C:\nTop\mylog.log"

An example of installing nTop using the command prompt.

  1. The /L*V option enables verbose logging and creates the log file mylog.log.
  2. Complete the installation by following the prompts.

Silent installation:

To install without any prompts, for example when deploying to many computers, add the display and restart options and the installer properties described below. Put the whole command on one line, or end each line except the last with ^ as shown in the example.

Standard Windows Installer options

These come from the Microsoft Standard Installer command-line options (Link).

  • /qn: Quiet display. The installer runs without displaying a user interface. No prompts, messages, or dialog boxes are displayed to the user.
  • /passive: Passive display. The installer shows a progress bar but requires no user input. Use either /qn or /passive, not both.
  • /norestart: Never restart. The installer never restarts the computer after the installation.
  • /L*V "<path>": Verbose log file, as in the procedure above.

nTop installer properties

Add these to the command as NAME=value. Property names are case sensitive.

Property Values Description
WIXUI_LOCATION_LISTBOX "Country, CC", for example "Germany, DE" The country the software is installed in, in the same format as the installer's location drop-down. If omitted, the default is "United States, US".
WIXUI_TOOLKIT_ADDITIVE_MANUFACTURING_CHECKBOX 1 Shows the Additive Manufacturing toolkit in the ribbon.
WIXUI_TOOLKIT_ARCHITECTED_MATERIALS_CHECKBOX 1 Shows the Architected Materials toolkit in the ribbon.
WIXUI_TOOLKIT_DESIGN_ANALYSIS_CHECKBOX 1 Shows the Design Analysis toolkit in the ribbon.
WIXUI_TOOLKIT_LIGHTWEIGHTING_CHECKBOX 1 Shows the Lightweighting toolkit in the ribbon.
DATAUPLOAD 1 or 0 Required anonymous usage data and crash reports. 0 turns them off. See Usage data below.
PERSONALIZEDUPLOAD 1 or 0 Optional personalized usage data (name and email added to the usage data). 0 turns it off. See Usage data below.

Note: The toolkit properties only control which toolkits are visible in the ribbon. Toolkits ship with nTop, so this does not install or uninstall anything. You can change the visibility later in File > Settings > Ribbon. On an upgrade, toolkits that are already visible stay selected.

Usage data

The installer's data screen asks about usage data, and the required-data option cannot be turned off in the interface. For a silent install you control it with the properties above:

  • If you do not pass DATAUPLOAD and PERSONALIZEDUPLOAD, a new silent install turns both on.
  • DATAUPLOAD=0 turns off the required anonymous usage data and crash reports. PERSONALIZEDUPLOAD=0 turns off the optional personalized data.
  • The properties work for every location, including EU countries.
  • When upgrading, if you leave out a property the installer keeps your previous setting. Passing it overrides the previous setting.
  • Use only the values 1 or 0. Any other value stops the installation with an error.

To block these connections in your firewall as well, see the nTop allowlisting guide. Blocking updater.ntop.com also disables the "Software Update Available" notice. Do not block app.ntop.com, which is needed for license authentication and the dashboard.

Example

This command installs for a user in Germany, shows all four toolkits in the ribbon, turns off usage data and crash reports and personalized data, installs silently, and writes a log:

msiexec /i "C:\nTop\nTop-<version>.msi" ^
WIXUI_TOOLKIT_ADDITIVE_MANUFACTURING_CHECKBOX=1 ^
WIXUI_TOOLKIT_ARCHITECTED_MATERIALS_CHECKBOX=1 ^
WIXUI_TOOLKIT_DESIGN_ANALYSIS_CHECKBOX=1 ^
WIXUI_TOOLKIT_LIGHTWEIGHTING_CHECKBOX=1 ^
WIXUI_LOCATION_LISTBOX="Germany, DE" ^
DATAUPLOAD=0 PERSONALIZEDUPLOAD=0 ^
/qn /norestart /L*V "C:\nTop\mylog.log"

The same command on a single line:

msiexec /i "C:\nTop\nTop-<version>.msi" WIXUI_TOOLKIT_ADDITIVE_MANUFACTURING_CHECKBOX=1 WIXUI_TOOLKIT_ARCHITECTED_MATERIALS_CHECKBOX=1 WIXUI_TOOLKIT_DESIGN_ANALYSIS_CHECKBOX=1 WIXUI_TOOLKIT_LIGHTWEIGHTING_CHECKBOX=1 WIXUI_LOCATION_LISTBOX="Germany, DE" DATAUPLOAD=0 PERSONALIZEDUPLOAD=0 /qn /norestart /L*V "C:\nTop\mylog.log"

To keep the usage data on, use DATAUPLOAD=1 PERSONALIZEDUPLOAD=1 instead, or leave both out.

Checking the result

  • The command returns immediately in a silent install. To see the result, check the exit code with echo %errorlevel% right after the command finishes (or use start /wait in a script).
  • 0 means success.
  • 3010 means success, but Windows needs a restart to finish.
  • 1603 is a fatal error. Open the log and search for Return value 3 to find the cause. If you need help reading it, attach the log when you contact support.

Are you still having issues? Contact the support team, and we’ll be happy to help!

More on this topic:

Was this article helpful?