MSI Command Line Properties

The SysTrack MSI installer supports the following command line parameters.

IMPORTANT: All property names must be UPPERCASE on the command line.

IMPORTANT: Prerequisites must be installed before Systems Management Agent.

ALLUSERS

  1. The Windows Installer property ALLUSERS and the current user’s privileges determine where the configuration information such as shortcuts and registry entries are stored on the target system:  to the All Users profile or the current user’s profile.

  2. Default setting for the ALLUSERS property, for Systems Management Agent_x32.msi, is equal to the number 1 <per-machine>.

  3. If ALLUSERS=1, the installer will perform a per-machine installation.  The per-machine installation succeeds only if the user has administrative access privileges on the computer.

  4. If ALLUSERS=2, the installer first attempts a per-machine installation.  In this case, the per-machine installation succeeds only if the user has administrative access privileges on the computer, otherwise the installer does a per-user installation.

  5. If ALLUSERS=””, the install will perform a per-user installation.

  6. Used with Install, Reinstall and Upgrade modes.

REBOOT

  1. Default value is “”.

  2. When performing a (silent mode) install, reinstall, upgrade, or uninstall, the system automatically restarts at each ForceReboot action, e.g. attempt to install a file in use.

  3. The REBOOT property is used to suppress certain prompts and actions for restarts.

  4. Set the property REBOOT=R (or REBOOT=ReallySuppress) to suppress all restarts and restart prompts initiated by the ForceReboot action.  Note that the installer only evaluates the first character of the REBOOT property.

  5. To determine if a system reboot is needed, add the /L*v switch to create a log file when performing a silent mode installation and search for entries that indicate a system reboot is required.  Key words to search:  System restart and Reboot.

    Info 1903.Scheduling reboot operation: Deleting file c:\Config.Msi\3c4d50f.rbf. Must reboot to complete operation.

    MSI (s) (EC:A0) [16:38:48:595]: The Windows Installer initiated a system restart to complete or continue the configuration of 'Systems Management Agent'.

    Property(S): MsiSystemRebootPending = 1

INSTALLDIR

  1. Default install path on 32-bit operating system:

    “<[ProgramFilesFolder]\SysTrack\LsiAgent>” or, “C:\Program Files\SysTrack\LsiAgent”

  2. Default install path on 64-bit operating system:

    “<[ProgramFilesFolder]\SysTrack\LsiAgent>” or, “C:\Program Files (x86)\SysTrack\LsiAgent”

  3. Required to place double quotes around path assigned to INSTALLDIR.

    Example:  INSTALLDIR=”D:\<path>\SysTrack\LsiAgent”

  4. Required for a First time install if installing to a different path than the Default path.

  5. Required for an Upgrade if upgrading a different path then Default path.  The FORCE property is not valid for the INSTALLDIR property.

  6. Not valid during a Reinstall.  The INSTALLDIR property cannot change the destination install path during a Reinstall [REINSTALL=ALL].

REINSTALL

  1. Default value is “”.

  2. Required for Reinstall installation only (same version being installed).

  3. Required to set REINSTALL=ALL on the command line to reinstall missing files, replace old files, stop/start the agent and registry settings.

  4. Required to assign values to MASTERNAME, CONFIGNAME, CACHEDMODE, POOLNAME, POOLDB, POOLDB_LOGFOLDER, POOLDB_WRITEFOLDER, RUNONPARENT, PROXYCONNECTIONHUB, AUTODETECTPROXY, AUTOCONFIGSCRIPT, HTTPSPROXY or their default values will be used.

FORCE

  1. Default value is 0.

  2. Used during Upgrade only and to change the currently installed product’s property values for MASTERNAME and CONFIGNAME, CACHEDMODE, POOLNAME, POOLDB, POOLDB_LOGFOLDER, POOLDB_WRITEFOLDER, RUNONPARENT, PROXYCONNECTIONHUB, AUTODETECTPROXY, AUTOCONFIGSCRIPT, HTTPSPROXY.

  3. If FORCE=0 or the property is not set on the command line argument because the default is 0, the Upgrade process will ignore MASTERNAME, CONFIGNAME, CACHEDMODE, POOLNAME, POOLDB, POOLDB_LOGFOLDER, POOLDB_WRITEFOLDER, RUNONPARENT, PROXYCONNECTIONHUB, AUTODETECTPROXY, AUTOCONFIGSCRIPT, HTTPSPROXY property values in the command line and NOT change the currently installed product’s property value.  A typical Upgrade will not change the property setting.

  4. If FORCE=1 is used on the command line argument, the Upgrade process will be forced to use the command line properties (MASTERNAME, CONFIGNAME, CACHEDMODE, POOLNAME, POOLDB, POOLDB_LOGFOLDER, POOLDB_WRITEFOLDER, RUNONPARENT, PROXYCONNECTIONHUB, AUTODETECTPROXY, AUTOCONFIGSCRIPT and HTTPSPROXY) values to change the currently installed product’s property value.  Default values are used if not set.

This is useful, for example, to place a child system in a different tree by changing the property value for MASTERNAME.  You are also required to assign values to the other properties, or their Default value is used.

MASTERNAME

  1. Default value is “”.

  2. Assign the master system name to the MASTERNAME property.

    IMPORTANT: The Master server must have a static IP or a DNS reservation.

  3. Required for Install and Reinstall or the default value is used.

  4. Required for an Upgrade only if the user wishes to change the currently installed product’s MASTERNAME property assigned.  This will also require FORCE=1 on the command line (see FORCE).

CONFIGNAME

  1. Default value is “”.

  2. An entry value is required to assign a named configuration.

  3. Required to place double quotes around value assigned to CONFIGNAME.

  4. Required for Install and Reinstall or the default value is used.

  5. Required for an Upgrade only if the user wishes to change the currently installed product’s MASTERNAME property assigned.  This will also require FORCE=1 on the command line (see FORCE).  Used the same way as POOLDB but not limited to Advanced “Pooled System” installations.  Used the same way as POOLNAME but not limited to Advanced “Pooled User” installations.  Used the same way as CACHEDMODE but not limited to Advanced “Cached Mode” installations.

CACHEDMODE (Advanced “Cached Mode” only)

  1. Default value is 0.

  2. Set to 1 to toggle agent behavior to periodically cache the child database on the master and to cache at device shutdown.

  3. When the device is started, the cached database will be fetched from the associated master and agent collection will begin with or without an associated user session.

  4. Used for a “Cached Mode” installation ONLY.

  5. Do not use CACHEDMODE if performing a Standard installation.

  6. Do not use POOLNAME, POOLDB, POOLDB_LOGFOLDER and POOLDB_WRITEFOLDER, if CACHEDMODE=1.

  7. CACHEDMODE, POOLNAME and POOLDB are mutually exclusive.

  8. May use RUNONPARENT to exit or run on the parent image.

  9. Required for Install and Reinstall or the default value is used.

  10. Required for Upgrade if the user wishes to change the currently installed product’s CACHEDMODE property assigned.  This will also require FORCE=1 on the command line (see FORCE).

POOLNAME (Advanced “Pooled User” only)

  1. Default value is “”.

  2. Used for a “Pooled User” installation ONLY.

  3. Assign the Pool name to the POOLNAME property.

  4. Do not use POOLNAME if performing a Standard installation.

  5. Do not use CACHEDMODE, POOLDB, POOLDB_LOGFOLDER, POOLDB_WRITEFOLDER, RUNONPARENT.

  6. CACHEDMODE, POOLNAME and POOLDB are mutually exclusive.

  7. Required for Install and Reinstall or the default value is used.

  8. Required for an Upgrade only if the user wishes to change the currently installed product’s POOLNAME property assigned.  This will also require FORCE=1 on the command line (see FORCE).

POOLDB (Advanced “Pooled System” only)

  1. Default value is “”.

  2. Used for a “Pooled System” installation ONLY.

  3. Assign a path to the persistent storage location/directory where the database will be stored.  Do not include a file name to the POOLDB property.

  4. The POOLDB location may be changed.

    NOTE: Add %SYSTEMNAME% (all caps) to prevent duplication of data across cloned/copied systems, as in the following example:

    Jet only:  (LOCALDB=0)
    POOLDB="K:\SysTrack\Database\%SYSTEMNAME%\"
    Terminal Server only:  (LOCALDB=1)
    POOLDB="LocalDB:K:\SysTrack\Database\%SYSTEMNAME%\"

    Note that "K:" is an example drive letter only.

    May also use POOLDB_LOGFOLDER and POOLDB_WRITEFOLDER properties to store log files and write files, respectively.

    Also, may use RUNONPARENT to exit or run on the parent image.

    IMPORTANT: After a successful Pooled System installation on the Golden Image, please delete the Settings registry key (if it exists) for potentially better results on virtual systems before cloning:

    For 32-bit OS, the key is here:  HKEY_LOCAL_MACHINE\SOFTWARE\Lakeside Software\LsiAgent\Settings
    For 64-bit OS, the key is here:  HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Lakeside Software\LsiAgent\Settings

    After you delete that registry key, it is important that you add back the following piece (so that the agent can connect to the Cloud):

    \HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Lakeside Software\LsiAgent\Settings\LsiWebCom->APIURL

    Do not use POOLDB if performing a Standard installation.

  5. Do not use CACHEDMODE or POOLNAME.

  6. CACHEDMODE, POOLNAME and POOLDB are mutually exclusive.

  7. Required for Install and Reinstall or the default value is used.

  8. Required for an Upgrade only if the user wishes to change the currently installed product’s POOLDB property assigned.  This will also require FORCE=1 on the command line (see FORCE).

POOLDB_LOGFOLDER (Advanced “Pooled System” only)

  1. Default value is “”.

  2. Optional use for a “Pooled System” installation ONLY.

  3. Assign a folder path to store log files.

    IMPORTANT: Do not include a file name to the POOLDB_LOGFOLDER property.

    IMPORTANT: Required to use double-quotes around path.

    IMPORTANT: The folder path must already exist.

    Example folder paths:

    POOLDB_LOGFOLDER=”D:\SysTrack\Log\”

    POOLDB_LOGFOLDER=”D:\PooledDB\%SYSTEMNAME%\Log\”

    Do not assign a value to POOLDB_LOGFOLDER if performing a Standard installation.

  4. Do not assign a value to CACHEDMODE and POOLNAME.

  5. Required “Pooled System” for Install and Reinstall or the default value is used.

  6. Required “Pooled System” for an Upgrade if the user wishes to change the currently installed product’s POOLDB_LOGFOLDER assigned.  This will also require FORCE=1 on the command line (see FORCE).

POOLDB_WRITEFOLDER (Advanced “Pooled System” only)

  1. Default value is “”.

  2. Optional use for a “Pooled System” installation ONLY.

  3. Assign a folder path to write files other than log files.

    IMPORTANT: Do not include a file name to the POOLDB_WRITEFOLDER property.

    IMPORTANT: Required to use double-quotes around path.

    IMPORTANT: The folder path must already exist.

Example folder paths

POOLDB_WRITEFOLDER=”D:\SysTrack\Write\”

POOLDB_WRITEFOLDER=”D:\PooledDB\%SYSTEMNAME%\Write\”

  1. Do not assign a value to POOLDB_WRITEFOLDER if performing a Standard installation.

  2. Do not assign a value to CACHEDMODE and POOLNAME.

  3. Required “Pooled System” for Install and Reinstall or the default value is used.

  4. Required “Pooled System” for an Upgrade if the user wishes to change the currently installed product’s POOLDB_WRITEFOLDER assigned.  This will also require FORCE=1 on the command line (see FORCE).

  5. RUNONPARENT (Advanced “Pooled System” and Advanced “Cached Mode” only)

    1. Default is 0.

    2. Example:

      • RUNONPARENT=0 means the agent will exit on the parent image.

      • RUNONPARENT=1 means the agent will run on the parent image.

    1. Do not assign a value to RUNONPARENT if performing a Standard installation.

    1. Do not assign a value to RUNONPARENT if performing an Advanced “Pooled User” installation.

    2. Optional use for a “Pooled System” or “Cached Mode” installation ONLY.

    1. Required “Pooled System” or “Cached Mode” for Install and Reinstall or the default value is used.

    2. Required “Pooled System” or “Cached Mode” for an Upgrade if the user wishes to change the currently installed product’s RUNONPARENT assigned.  This will also require FORCE=1 on the command line (see FORCE).

LANGUAGE

  1. Default value is EN.

  2. Used to select a language to view the Client Tray App.

  3. Required to assign the LANGUAGE property with an UPPERCASE language code.

  4. Current available languages:

    • Arabic:            LANGUAGE=AR

    • Chinese:        LANGUAGE=ZH

    • English (default):    LANGUAGE=EN

    • French:            LANGUAGE=FR

    • German:        LANGUAGE=DE

    • Japanese:        LANGUAGE=JA

    • Portuguese:        LANGUAGE=PT

    • Spanish:        LANGUAGE=ES

LOCALDB

  1. Default value is 0.

  2. Example:

    • LOCALDB=0 means to use Jet database.

    • LOCALDB=1 means to use LocalDB database.  Recommended for large load-balanced Terminal Server environments.  See LocalDB Database.

PROXYCONNECTIONHUB

  1. Default value is “”.

  2. Optional MSI parameter.

  3. The name of your ProxyConnectionHub system (if applicable).

  4. Example:

PROXYCONNECTIONHUB=<server name>.<domain name>.org

  1. Required during Install and Reinstall or the default value is used.

  2. Required for an Upgrade if the user wishes to change the currently installed PROXYCONNECTIONHUB assigned.  This will also require FORCE=1 on the command line (see FORCE).

AUTODETECTPROXY

  1. Default value is 0.

  2. Optional MSI parameter.

  3. Preferred proxy setting: whether to use autodetect.

  4. The value 1 if true, 0 otherwise.

  5. Example:

    • AUTODETECTPROXY=1

    • AUTODETECTPROXY=0

  6. Required during Install and Reinstall or the default value is used.

  7. Required for an Upgrade if the user wishes to change the currently installed AUTODETECTPROXY assigned.  This will also require FORCE=1 on the command line (see FORCE).

AUTOCONFIGSCRIPT

  1. Default value is “”.

  2. Optional MSI parameter.

  3. Preferred proxy setting: the address of a .pac file to get proxy information.

  4. Example:

AUTOCONFIGSCRIPT=http://<server>.<domain>/test.pac

  1. Required during Install and Reinstall or the default value is used.

  2. Required for an Upgrade if the user wishes to change the currently installed AUTOCONFIGSCRIPT assigned.  This will also require FORCE=1 on the command line (see FORCE).

HTTPSPROXY

  1. Default value is “”.

  2. Optional MSI parameter.

  3. Preferred proxy setting: the address for the preferred HTTPS proxy.

  4. Example:

HTTPSPROXY=127.0.0.1:443

  1. Required during Install and Reinstall or the default value is used.

Required for an Upgrade if the user wishes to change the currently installed HTTPSPROXY assigned.  This will also require FORCE=1 on the command line (see FORCE).