Table of Contents

Setup Installer Command Line Options

Silent installation

The setup installer will automatically install the pre-requisites appropriate for the target operating system.

Note

If the Microsoft SQL Server is on a remote machine, Windows Management Instrumentation (WMI) must be enabled for remote communication through the firewall.

Warning

If the Microsoft SQL Server Filestream feature is not enabled on the selected instance, it will be enabled automatically during installation. In order for the change to take effect, the SQL Server service will also be restarted automatically.

Command Line Arguments

/? or /help
Display a help screen.

/ConfigFile [path]
Optional configuration file name and location, defaults to configuration.xml in the same location as the dotNetInstaller executable.

/i
Install components (default).

/x
Uninstall components.

/q
Forces silent UI mode, overriding the configuration's ui_mode attribute.

/qb
Forces basic UI mode, overriding the configuration's ui_mode attribute. A basic UI mode shows progress dialogs but does not require any user interaction.

/nq
Forces full UI mode, overriding the configuration's ui_mode attribute.

/nosplash
Do not display splash screen.

/noreboot
Do not actually reboot Windows even if a reboot was required by a component or the user chooses to reboot when prompted.

/noRunOnReboot
Do not actually write the RunOnReboot registry key if a reboot is required by a component or the user chooses to reboot when prompted.

/CompleteCommandArgs
Specify additional arguments for the complete_command. For example, if your complete command is an MSI this lets you pass additional parameters.

/Log
Creates a log file during installation with information and errors useful for debugging.
You can find this file in the user temporary directory with the name dotNetInstallerLog.txt
(eg. C:\Documents and Settings\YOUR_NAME\Local Settings\Temp\dotNetInstallerLog.txt).
Its location and name can be specified with /LogFile.

/LogFile [path]
Optional log file name and location.

/ExtractCab
If this package contains an embedded CABs, extract all contents under a new folder called SupportFiles in the current directory.
When specified, all other options are ignored and no installations are run.

/DisplayCab
If this package contains an embedded CAB, display its contents.

/DisplayConfig
Display the complete list of configurations and components without checking processor architecture or lcid.

/ComponentArgs "*|id|display_name":"value"
Additional component parameters.
This enables passing additional command-line arguments to all (*) or specific components by their id and/or display_name, in this order.
The value is appended to both non-silent and silent command lines of msi and cmd type components.
The component id or display_name must match exactly the one in the configuration.xml.

Note

To insert values with spaces use a double-quote.
Quotation marks should be escaped when inserting them on the command line.

/ControlArgs "id":"value"
Additional user-defined control parameters.
This enables overriding user control values.

Note

Note that if multiple user controls are declared with the same id the parameter applies to all.
Control arguments applied to user controls that don't exist are ignored.

Exit Codes

Code Description
0 Success.
-1 Any non-specific error.
-2 User pressed Cancel in the main dialog.
3010 A reboot was required.
Any other non-zero value Error code of a failed component. This is the msiexec return code for msi components and process exit code for cmd components.

UI Tricks

Holding the keyboard Control key and double-clicking on a bootstrapper component in the components list will install it, regardless of whether the component is selected or not.

Holding the keyboard Shift key and double-clicking on a bootstrapper component in the components list will toggle it's selected state, regardless of whether the component is required or not.

Setup installer components

  • Windows Server 2012 R2 Update (KB2919442) (x64)
  • Windows Server 2012 R2 Update (KB2919355) (x64)
  • Microsoft .NET Framework 4.7.2
  • Microsoft ASP.NET Core 8.0.0 - Windows Hosting Bundle
  • Microsoft Visual C++ 2015 - 2022 Runtime (x86)
  • Microsoft Visual C++ 2015 - 2022 Runtime (x64)
  • Management_Server

MSI properties

Property Name Values
SQL_SERVER_PROVIDER System.Data.SQLite (Default)
System.Data.SqlClient
SQL_SERVER_USER
SQL_SERVER_PASSWORD
SQL_SERVER_DOMAIN
SQL_USER
SQL_PASSWORD
SQL_SERVER
SQL_DB_NAME ManagementServer (Default)
SQL_WINDOWS_AUTH True (Default)
False
IIS_SERVER
IIS_VIRTUAL_DIRECTORY ManagementServer (Default)
IIS_SERVER_WEB_SITE
IIS_SERVER_PORT
IIS_SERVER_HEADER
IIS_APP_POOL ManagementServer (Default)
IIS_APP_POOL_IDENTITY networkService (Default)
localService
localSystem
other
IIS_APP_POOL_USERNAME
IIS_APP_POOL_DOMAIN
IIS_APP_POOL_PASSWORD
INSTALLLOCATION
MANAGEMENT_SERVER_PUBLIC_SERVER_ADDRESS
MANAGEMENT_SERVER_PORT 4502 (Default)
WEB_SERVER_PORT 80 (Default)
STANDALONE_WEB_SERVER_STARTMODE Automatic (Default)
Manual
Disabled
WEB_SERVER_PROVIDER XSP (Default)
IIS
Manual
CROSS_DOMAIN_SUPPORT RequireOutOfBrowser (Default)
EnablePolicyServer
UseIIS
ENABLE_DATABASE_VERBOSE_LOGGING False (Default)
True
LICENSE_NAME
LICENSE_COMPANY_NAME
LICENSE_EMAIL_ADDRESS
LICENSE_KEY K34XS-NWECL-ECF5TM-3KASY-5P8JD (Default)
SERIAL_NUMBER
LICENSE_TYPE Evaluation
IHaveALicenseKey (Default)
OFFLINE_ACTIVATION False (Default)
True
LICENSE_OFFLINE_ACTIVATION_KEY
ENFORCE_HTTPS false (Default)
true

Examples

Create a log of the msi setup installer

"Setup Installer.exe" /ComponentArgs "Management_Server":"/l*v c:\setuplog.txt"

In this case, the msi log file will be created as c:\setuplog.txt.

Silently install CMon using the standalone web server and an SQLite database

"Setup Installer.exe" /ComponentArgs "Management_Server":"/q /l*v c:\setuplog.txt LICENSE_NAME=Name LICENSE_COMPANY_NAME=CompanyName LICENSE_EMAIL_ADDRESS=noreply@novabackup.com MANAGEMENT_SERVER_PUBLIC_SERVER_ADDRESS=192.168.0.2 WEB_SERVER_PROVIDER=XSP WEB_SERVER_PORT=81 SQL_SERVER_PROVIDER=System.Data.SQLite"

Silently install CMon using IIS web server and a Microsoft SQL Server database

"Setup Installer.exe" /ComponentArgs "Management_Server":"/q /l*v c:\setuplog.txt LICENSE_NAME=Name LICENSE_COMPANY_NAME=CompanyName LICENSE_EMAIL_ADDRESS=noreply@novabackup.com MANAGEMENT_SERVER_PUBLIC_SERVER_ADDRESS=192.168.0.2 WEB_SERVER_PROVIDER=IIS IIS_SERVER=\"Default Web Site\" SQL_SERVER_PROVIDER=System.Data.SqlClient SQL_SERVER=.\sqlServerInstanceName SQL_SERVER_USER=Administrator SQL_SERVER_PASSWORD=AdministratorPassword SQL_USER=sa SQL_PASSWORD=saPassword"

After installation, manually start the "Management Server" service: net start "Management Server"

When using the standalone web server, manually start the Management Web Server service: net start "Management Web Server"

Notes:

After installation, run Start > All Programs > Management Server > Management Server