Windows Installer Properties
  
Windows Installer Properties
This appendix describes the Windows installer properties.
•  Windows Installer Properties Overview
Windows Installer Properties Overview
The Mobile Controller Windows installer supports many Microsoft Windows Installer (MSI) properties that you can modify to control installation features. You can specify these properties from the Windows command-line by passing them to MSI executable file (msiexec.exe).
Command-line Properties
When you run the Mobile Controller installer from the command line, the properties can be passed to msiexec.exe using this syntax:
msiexec /i SteelheadMobile.msi <property-name>=<value> [/qn]
For example, you can specify the location of the installer and data store, the size of the data store, and disabled the desktop icon for the SteelHead Mobile using the following syntax:
msiexec /i SteelheadMobile.msi RVBD_INSTALLDIR="E:\Riverbed" RVBD_DATASTOREDIR="E:\Datastore" RVBD_DATASTORESIZEMB=512 RVBD_DESKTOPICON=0 /qn
Precedence Rules
Properties can be set by multiple sources. A single property can be set from the command line, the installer user interface, or the value set by the administrator on the Mobile Controller when creating the package.
The installer uses the following precedence rules (from highest to lowest) to choose the values it will use during installation:
1. Modified value from the installer UI. If a value is not modified in the installer dialog boxes, then the property's final value is set based on rest of the rules.
2. Value passed on the Windows command line. If both INSTALLDIR and RVBD_INSTALLDIR are set on the command line, the value of INSTALLDIR takes precedence.
3. Value set by the administrator on the Mobile Controller when creating the package.
The following table describes the Windows installer properties and their values.
Property
Supported Values
Description
INSTALLDIR
Absolute directory paths. Valid paths with embedded environment variables are also supported. For example:
INSTALLDIR="C:\Riverbed"
INSTALLDIR="%SYSTEMDRIVE%\Riverbed"
Determines the install directory path. Consider setting RVBD_INSTALLDIR instead of setting this property. If both INSTALLDIR and RVBD_INSTALLDIR are set, the value of INSTALLDIR takes precedence.
RVBD_CONTROLLERS
A string containing one or more controllers delimited by a semicolon (;). Controller port, if specified, must be delimited by a colon (:). Ports default to 7870 if they are not specified.
For example: RVBD_CONTROLLERS="1.2.3.4:7870;mv-gw1;mv-gw2.nbttech.com:8080"
Determines the controllers to which the client connects.
RVBD_DATASTOREDIR
Absolute directory paths. Valid paths with embedded environment variables are also supported. For example:
RVBD_DATASTOREDIR="C:\Datastore"
RVBD_DATASTOREDIR="%SYSTEMDRIVE%\Datastore"
Determines the location of the SteelHead Mobile data store.
RVBD_DATASTORESIZEMB
256, 512, 1024, 2048, 5120, 10240, 15360, and 20480.
For example: RVBD_DATASTORESIZEMB=512
Determines the size of SteelHead Mobile data store.
RVBD_DESKTOPICON
0 - Do not create a desktop shortcut.
1 - Create a SHM desktop shortcut.
For example: RVBD_DESKTOPICON=0
Determines whether or not to create a Windows desktop shortcut.
RVBD_INSTALLDIR
Absolute directory paths. Valid paths with embedded environment variables are also supported. For example:
RVBD_INSTALLDIR="C:\Riverbed"
RVBD_INSTALLDIR="%SYSTEMDRIVE%\Riverbed"
Determines the install directory path. It is recommended that you use RVBD_INSTALLDIR over INSTALLDIR, as the installer performs additional error checks when RVBD_INSTALLDIR is set. If both INSTALLDIR and RVBD_INSTALLDIR are set, the value of INSTALLDIR takes precedence.
RVBD_RANDOMIZECONTROLLERS
0 - Do not select controllers at random.
1 - Select a controller at random.
For example: RVBD_RANDOMIZECONTROLLERS=0
Determines whether the client should choose a controller at random from the specified list of controllers and connect to it.
RVBD_SHOWUI
0 - Suppress the installer UI.
1 - Display the installer UI.
For example: RVBD_SHOWUI=0
Determines whether to show the installer UI dialogs during the installation.
RVBD_STARTMENUICON
0 - Do not create a shortcut in the Start menu folder.
1 - Create a shortcut in the Start menu folder.
For example: RVBD_STARTMENUICON=0
Determines whether or not to create a start menu shortcut.