Complex Command Line Installation

A few items to note:

  • All property names must be uppercase on the command line.

    • Systems Management Agent_x32.msi

    • MASTERNAME=<master name.fqdn>

  • Install prerequisites before installing SysTrack.

Command Line Properties

ALLUSERS

  • Default is 1 <per-machine>.  Per-machine vs Per-user installations.

  • Used with Install, Reinstall and Upgrade modes.

REBOOT

  • Default is an empty space.

  • When performing a (silent mode) install, reinstall, upgrade, or uninstall, the system automatically restarts at each ForceReboot action, for example, when attempting to install a file in use.

  • Used to suppress certain prompts and actions for restarts.

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

  • 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.  Keywords 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

  • Default install path on 32-bit operating system:

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

  • Default install path on 64-bit operating system:

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

  • Default install path on an ARM processor:

    "C:\Program Files (ARM)\SysTrack\LsiAgent"

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

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

  • Required during an intial installation if installing to a different path than the default path.

  • Required during an upgrade if upgrading to a different path than the default path.

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

MASTERNAME

  • Required for OnPrem Agent installations.

  • Default value is “”.

  • Assigns the master system name to the MASTERNAME property.

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

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

  • Only Required for an upgrade if the user needs to change the currently installed the product’s property assigned MASTERNAME. This requires FORCE=1 on the command line .

REINSTALL

  • Default is empty space.

  • Required for a reinstall installation (same version being installed).

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

  • Required to assign values to CONFIGNAME, CACHEDMODE, POOLNAME, POOLDB, POOLDB_LOGFOLDER, POOLDB_WRITEFOLDER, RUNONPARENT, PROXYCONNECTIONHUB, AUTODETECTPROXY, AUTOCONFIGSCRIPT, HTTPSPROXY, RUNONPARENT or their default values are used.

FORCE

  • Default value is 0.

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

  • If FORCE=0 or the property is not set in the command line argument because the default is 0, the upgrade process ignores CONFIGNAME, CACHEDMODE, POOLNAME, POOLDB, POOLDB_LOGFOLDER, POOLDB_WRITEFOLDER, RUNONPARENT, PROXYCONNECTIONHUB, AUTODETECTPROXY, AUTOCONFIGSCRIPT, HTTPSPROXY property values in the command line. Also, it does not change the currently installed product’s property value.  A typical upgrade will not change the property setting.

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

CONFIGNAME

  • Default value is an empty space.

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

  • Required to place double quotes around the value assigned to CONFIGNAME.

  • Required for install and reinstall or the default value is used.

  • Required for an upgrade only to change the currently installed product’s CONFIGNAME property assigned.  This also requires 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)

  • Default is 0.

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

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

  • Used for a “Cached Mode” installation only.

  • Do not use CACHEDMODE for a standard installation.

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

  • CACHEDMODE, POOLNAME and POOLDB are mutually exclusive.

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

  • Required for install and reinstall or the default value is used.

  • Required for upgrade to change the currently installed product’s CACHEDMODE assigned.  This also requires FORCE=1 on the command line (see FORCE).

POOLNAME

(Advanced Pooled User only)

  • Default value is an empty space.

  • Used for a “Pooled User” installation only.

  • Assign the pool name to the POOLNAME property.

  • Do not use POOLNAME> for a standard installation.

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

  • CACHEDMODE, POOLNAME and POOLDB are mutually exclusive.

  • Required for install and reinstall or the default value is used.

  • Required for an upgrade to change the currently installed product’s POOLNAME property assigned.  This also requires FORCE=1 on the command line (see FORCE).

POOLDB

(Advanced Pooled System only)

  • Default value is an empty space.

  • Used for a “Pooled System” installation only.

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

  • The POOLDB location may be changed.

    IMPORTANT: Add %SYSTEMNAME% (all caps) to prevent duplication of data across cloned/copied systems,

    For example:

    POOLDB=”K:\SysTrack\Database\%SYSTEMNAME%\”

    In this example, K: is an example drive letter.

    Use POOLDB_LOGFOLDER and POOLDB_WRITEFOLDER properties to store log files and write files.  Also use RUNONPARENT to exit or run on the parent image.

    IMPORTANT: After a successful “Pooled System” installation on the Golden Image, delete the Settings registry key for better results on virtual systems before cloning.

    (32-bit OS)

    HKEY_LOCAL_MACHINE\SOFTWARE\Lakeside Software\LsiAgent\Settings

    (64-bit OS)

    HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Lakeside Software\LsiAgent\Settings

  • Do not use POOLDB for a standard installation.

  • Do not use CACHEDMODE or POOLNAME.

  • CACHEDMODE, POOLNAME and POOLDB are mutually exclusive.

  • Required for install and reinstall or the default value is used.

  • Required for an upgrade to change the currently installed product’s POOLDB property assigned.  This also requires FORCE=1 on the command line (see FORCE).

POOLDB_LOGFOLDER

(Advanced “Pooled System” only)

  • Default is an empty space.

  • Optional use for a “Pooled System” installation only.

  • Assign a folder path to store log files.

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

    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.

  • Do not assign a value to CACHEDMODE and POOLNAME.

  • Required “Pooled System” for install and reinstall or the default value is used.

  • Required “Pooled System” for an upgrade to change the currently installed product’s POOLDB_LOGFOLDER assigned.  This also requires FORCE=1 on the command line (see FORCE).

POOLDB_WRITEFOLDER

(Advanced Pooled System only)

  • Default is an empty space.

  • Optional use for a “Pooled System” installation only.

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

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

    The folder path must already exist.

    Example folder paths:

    POOLDB_WRITEFOLDER=”D:\SysTrack\Write\”

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

  • Do not assign a value to POOLDB_WRITEFOLDER if performing a standard installation.

  • Do not assign a value to CACHEDMODE and POOLNAME.

  • Required “Pooled System” for install and reinstall or the default value is used.

  • Required “Pooled System” for an upgrade to change the currently installed product’s POOLDB_WRITEFOLDER assigned.  This also requires FORCE=1 on the command line (see FORCE).

RUNONPARENT

(Advanced Pooled System and Advanced Cached Mode only)

  • Default is 0.

  • Example:

    1. RUNONPARENT=0 means the agent exits on the parent image.

    2. RUNONPARENT=1 means the agent runs on the parent image.

  • Do not assign a value to RUNONPARENT if performing a standard installation.

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

  • Optional use for a “Pooled System” or “Cached Mode” installation only.

  • Required “Pooled System” or “Cached Mode” for install and reinstall or the default value is used.

  • Required “Pooled System” or “Cached Mode” for an upgrade to change the currently installed product’s RUNONPARENT assigned.  This also requires FORCE=1 on the command line (see FORCE).

LANGUAGE

  • Default value is EN.

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

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

  • Current available languages:

Language Language Code
Arabic AR
Chinese ZH
English (default) EN
French FR
German DE
Japanese JA
Portuguese PT
Spanish ES

PROXYCONNECTIONHUB

  • Default is empty space.

  • Optional MSI parameter.

  • Name of your ProxyConnectionHub system (if applicable).

  • Example:

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

  • Required during install and reinstall or the default value is used.

  • Required for an upgrade to change the currently installed PROXYCONNECTIONHUB assigned.  This also requires FORCE=1 on the command line (see FORCE).

AUTODETECTPROXY

  • Default is 0.

  • Optional MSI parameter.

  • Preferred proxy setting: whether to use autodetect.

  • The value 1 if true, 0 false.

  • Example:

AUTODETECTPROXY=1

AUTODETECTPROXY=0

  • Required during install and reinstall or the default value is used.

  • Required for an upgrade to change the currently installed AUTODETECTPROXY assigned.  This will also require FORCE=1 on the command line (see FORCE).

AUTOCONFIGSCRIPT

  • Default is an empty space.

  • Optional MSI parameter.

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

  • Example:

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

  • Required during install and reinstall or the default value is used.

  • 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

  • Default is an empty space.

  • Optional MSI parameter.

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

  • Example:

HTTPSPROXY=127.0.0.1:443

  • 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).