Product Documentation
Home » Rover ERP Overview » Rover ERP Administration » Rover Installer Command-Line Options

# Rover Installer Command-Line Options

This document describes the command-line properties available when installing Rover using msiexec.

# Overview

The Rover installer supports silent and automated installations through MSI command-line properties. These properties allow administrators to pre-configure the application without user interaction.

# Basic Usage

msiexec /i "rover-installer.msi" /qn [PROPERTIES...]
1
Flag Description
/i Install the specified MSI package
/qn Quiet mode, no UI
/qb Basic UI (progress bar only)
/l*v install.log Enable verbose logging to file

# Configuration Properties

# Core Settings

Property Values Description
CLI_RESET_CONFIG "1" or "0" When "1", overwrites existing configuration file during upgrade. Default behavior preserves existing configuration.
CLI_SHOWMULTIPLE "1" or "0" When "1", enables the configuration file selector dropdown on the login form, allowing users to switch between multiple configuration files.
CLI_PROMPTMODE "1", "2", or "3" Controls visibility and editability of advanced fields. See Prompt Modes below.

# Connection Settings

Property Example Value Description
CLI_SERVER_ADDRESS "myserver.example.com" Default server address/hostname for connection
CLI_SERVER_PORT "22" Default port number (typically 22 for SSH, 23 for Telnet)
CLI_CONNECTION_TYPE "SSH" or "TELNET" Connection protocol to use
CLI_ACCOUNT "MYACCOUNT" Default account name

# Field Visibility Overrides

These properties override the CLI_PROMPTMODE setting for individual fields. Set to "1" to show, "0" to hide.

Property Description
CLI_SHOW_ADDRESS Show/hide the Server Address field
CLI_SHOW_PORT Show/hide the Port field
CLI_SHOW_CONNECTION_TYPE Show/hide the Connection Type dropdown
CLI_SHOW_ACCOUNT Show/hide the Account field

# Field Read-Only Overrides

These properties override the CLI_PROMPTMODE setting for individual fields. Set to "1" for read-only, "0" for editable.

Property Description
CLI_READONLY_ADDRESS Make Server Address read-only or editable
CLI_READONLY_PORT Make Port read-only or editable
CLI_READONLY_CONNECTION_TYPE Make Connection Type read-only or editable
CLI_READONLY_ACCOUNT Make Account read-only or editable

Note: Username and Password fields are always shown on the main form and are always editable. They cannot be made read-only or hidden.

# Prompt Modes

The CLI_PROMPTMODE property provides a simplified way to configure field visibility and editability:

Value Name Behavior
"1" Show All Prompts All fields (Server, Port, Connection Type, Account) are visible on the main login form and fully editable.
"2" Hide Editable Advanced fields are hidden from the main form but appear in a collapsible "Additional Settings" section. Fields remain editable.
"3" Hide Read-Only Advanced fields are hidden from the main form and appear in a collapsible "Additional Settings" section. Fields are read-only (users cannot modify pre-configured values).

# Login Form Layout

PROMPTMODE=1 (Show All):

┌─────────────────────────────┐
│ Server:      [____________] │
│ Port:        [____________] │
│ Connection:  [SSH      ▼ ] │
│ Username:    [____________] │
│ Password:    [____________] │
│ Account:     [____________] │
│                             │
│   [Sign On]    [Exit]       │
└─────────────────────────────┘
1
2
3
4
5
6
7
8
9
10

PROMPTMODE=2 or 3 (Hidden fields):

┌─────────────────────────────┐
│ Username:    [____________] │
│ Password:    [____________] │
│                             │
│   [Sign On]    [Exit]       │
│                             │
│ ▶ Additional Settings       │
│ ┌─────────────────────────┐ │
│ │ Server:    [__________] │ │
│ │ Port:      [__________] │ │
│ │ Connection:[SSH     ▼ ] │ │
│ │ Account:   [__________] │ │
│ └─────────────────────────┘ │
└─────────────────────────────┘
1
2
3
4
5
6
7
8
9
10
11
12
13
14

# Installation Examples

# Example 1: Basic Silent Install with Server Configuration

msiexec /i "rover-installer.msi" /qn ^
    CLI_SERVER_ADDRESS="production.example.com" ^
    CLI_SERVER_PORT="22" ^
    CLI_CONNECTION_TYPE="SSH" ^
    CLI_ACCOUNT="PROD"
1
2
3
4
5

# Example 2: Locked-Down Installation (Users Can Only Enter Credentials)

msiexec /i "rover-installer.msi" /qn ^
    CLI_PROMPTMODE="3" ^
    CLI_SERVER_ADDRESS="secure.example.com" ^
    CLI_SERVER_PORT="22" ^
    CLI_CONNECTION_TYPE="SSH" ^
    CLI_ACCOUNT="LOCKED"
1
2
3
4
5
6

# Example 3: Flexible Installation (Hidden but Editable Settings)

msiexec /i "rover-installer.msi" /qn ^
    CLI_PROMPTMODE="2" ^
    CLI_SERVER_ADDRESS="default.example.com" ^
    CLI_SERVER_PORT="22" ^
    CLI_CONNECTION_TYPE="SSH" ^
    CLI_ACCOUNT="DEFAULT"
1
2
3
4
5
6

# Example 4: Upgrade with Configuration Reset

msiexec /i "rover-installer.msi" /qn ^
    CLI_RESET_CONFIG="1" ^
    CLI_SERVER_ADDRESS="newserver.example.com" ^
    CLI_SERVER_PORT="22" ^
    CLI_CONNECTION_TYPE="SSH" ^
    CLI_ACCOUNT="NEWACCT"
1
2
3
4
5
6

# Example 5: Enable Multiple Configuration Files

msiexec /i "rover-installer.msi" /qn ^
    CLI_SHOWMULTIPLE="1" ^
    CLI_PROMPTMODE="1" ^
    CLI_SERVER_ADDRESS="server1.example.com" ^
    CLI_SERVER_PORT="22" ^
    CLI_CONNECTION_TYPE="SSH" ^
    CLI_ACCOUNT="ACCT1"
1
2
3
4
5
6
7

# Example 6: Custom Field Visibility (Override PROMPTMODE)

Show all fields except Account, make Port read-only:

msiexec /i "rover-installer.msi" /qn ^
    CLI_PROMPTMODE="1" ^
    CLI_SHOW_ACCOUNT="0" ^
    CLI_READONLY_PORT="1" ^
    CLI_SERVER_ADDRESS="server.example.com" ^
    CLI_SERVER_PORT="22" ^
    CLI_CONNECTION_TYPE="SSH" ^
    CLI_ACCOUNT="HIDDEN"
1
2
3
4
5
6
7
8

# Example 7: Silent Install with Logging

msiexec /i "rover-installer.msi" /qn /l*v "C:\Logs\rover_install.log" ^
    CLI_SERVER_ADDRESS="server.example.com" ^
    CLI_SERVER_PORT="22" ^
    CLI_CONNECTION_TYPE="SSH" ^
    CLI_ACCOUNT="MYACCT"
1
2
3
4
5

# Upgrade Behavior

By default, the installer preserves existing configuration files during upgrades:

Scenario CLI_RESET_CONFIG Result
Fresh install N/A New configuration created from template with specified values
Upgrade, config exists "0" or not set Existing configuration preserved (CLI values ignored)
Upgrade, config exists "1" Existing configuration overwritten with new values

# Configuration Files

The installer writes to two configuration files:

  1. configuration.json - Located in %APPDATA%\Zumasys\Rover\

    • Contains connection settings, field visibility, and read-only states

  2. settings.json - Located in %APPDATA%\Zumasys\Rover\

    • Contains the AllowMultipleConfigs setting

# Troubleshooting

# Verify Installation Properties

Enable verbose logging to verify properties are being passed correctly:

msiexec /i "rover-installer.msi" /l*v "install.log" CLI_SERVER_ADDRESS="test"
1

Then search install.log for CustomActionData to see the values received by the installer.

# Common Issues

Issue Cause Solution
Settings not applied Existing config preserved Use CLI_RESET_CONFIG="1"
Fields still editable Wrong PROMPTMODE Use CLI_PROMPTMODE="3" for read-only
Fields not hidden Individual override Check for conflicting CLI_SHOW_* properties

# Property Reference Summary

msiexec /i "rover-installer.msi" /qn ^
    CLI_RESET_CONFIG="0|1" ^
    CLI_SHOWMULTIPLE="0|1" ^
    CLI_PROMPTMODE="1|2|3" ^
    CLI_SERVER_ADDRESS="hostname" ^
    CLI_SERVER_PORT="port" ^
    CLI_CONNECTION_TYPE="SSH|TELNET" ^
    CLI_ACCOUNT="account" ^
    CLI_SHOW_ADDRESS="0|1" ^
    CLI_SHOW_PORT="0|1" ^
    CLI_SHOW_CONNECTION_TYPE="0|1" ^
    CLI_SHOW_ACCOUNT="0|1" ^
    CLI_READONLY_ADDRESS="0|1" ^
    CLI_READONLY_PORT="0|1" ^
    CLI_READONLY_CONNECTION_TYPE="0|1" ^
    CLI_READONLY_ACCOUNT="0|1"
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16