Cloud Edition Install Guide
Cloud Edition Install Guide
Table of Contents
1.0 Introduction ................................................................................................................................ 2
2.0 Supported Operating Systems ..................................................................................................... 3
3.0 Setup Files ................................................................................................................................... 3
4.0 Anti-Virus Exclusions ................................................................................................................... 4
5.0 Simple Installation (Setup.exe) ................................................................................................... 4
5.1 No Configuration Name (command line not required) .............................................................. 4
5.2 Assign a Configuration Name (command line required) ............................................................ 5
5.3 Result....................................................................................................................................... 5
6.0 Complex Command Line Installation ........................................................................................... 5
6.1 Command Line Properties ........................................................................................................ 5
6.2 Per-Machine versus Per-User Installations.............................................................................. 10
6.3 Determine System Restart Required....................................................................................... 10
6.4 Reinstall Information.............................................................................................................. 10
6.5 Upgrade Information.............................................................................................................. 11
6.6 Installation Order ................................................................................................................... 11
6.7 Prerequisite (32-bit and 64-bit OS): VC_redist.x86.exe .......................................................... 12
6.8 Prerequisite (64-bit OS only): VC_redist.x64.exe .................................................................... 13
6.9 SysTrackCloudEdition.msi (SysTrack Cloud Edition)................................................................. 15
6.9.1 Standard Installation: persistent desktops and physical workstations ................................. 15
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
1 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
6.9.2 Advanced Installation: golden image based non-persistent “Pooled System”...................... 20
6.9.3 Advanced Installation: golden image based non-persistent “Pooled User”.......................... 27
7.0 Successful Installation ............................................................................................................... 34
8.0 Failed Installation ...................................................................................................................... 34
9.0 Uninstall Order .......................................................................................................................... 36
10.0 Uninstalling SysTrack through SMS ........................................................................................... 36
11.0 Proxy Support for Data Uploads ................................................................................................ 39
12.0 Proxy Settings and Process ........................................................................................................ 41
Example 1 .......................................................................................................................................... 41
Example 2 .......................................................................................................................................... 42
Example 3 .......................................................................................................................................... 43
Example 4 .......................................................................................................................................... 44
13.0 Where to Go from Here ............................................................................................................. 44
1.0 Introduction
The following is a series of step-by-step set of instructions to help successfully install, reinstall, upgrade
and uninstall SysTrack Cloud Edition software to designated child systems.
Known Issues:
1. Performing silent installations may cause the system to automatically restart at the end of the
installation. You can suppress automatic and certain prompts for system restarts by setting the
REBOOT property (See Command Line Properties).
2. User may be required to change UAC settings to allow MSI installation to occur.
3. Never, under any circumstances, copy + paste command lines from this or any document into a
command prompt window. There are known issues with the characters not lining up correctly
and in almost all cases, the command line will not function correctly.
4. Microsoft Windows 7 SP1, Windows 8.1, Windows 10, Windows Server 2008 SP2, Windows
Server 2008 R2 SP1, Windows Server 2012, Windows Server 2012 R2, Windows Server 2016 and
Windows Server 2019 (or higher) users may be required to run the files logged on and run with
“Run as administrator”.
5. Prerequisites are required to be installed before installing SysTrackCloudEdition.msi or the
service will fail to start resulting in a failed installation.
a. Microsoft Visual C++ 2015-2019 Redistributable (x86)
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
2 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
i. For 32-bit and 64-bit operating systems
ii. File name: VC_redist.x86.exe
b. Microsoft Visual C++ 2015-2019 Redistributable (x64)
i. For 64-bit operating systems only
ii. File name: VC_redist.x64.exe
Important: Microsoft Windows 7 SP1, Windows 8.1, Windows 10, Windows Server 2008 SP2, Windows
Server 2008 R2 SP1, Windows Server 2012, Windows Server 2012 R2, Windows Server 2016 and
Windows Server 2019 (or higher) users may be required to run the files logged on and run with “Run as
administrator”.
There are two (2) options to install SysTrack Cloud Edition software:
Important: Only for (Standard) persistent desktops and regular physical workstations.
Important: Not for “Pooled System” installations. See Advanced Installation.
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
3 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
Important: Not for “Pooled User” installations. See Advanced Installation.
Launch Setup.exe to install prerequisite runtime components of Visual C++ Libraries and
SysTrack Cloud Edition. Follow instructions under 5.0 Simple Installation (Setup.exe).
Use command line to install prerequisite runtime components and SysTrack Cloud Edition
individually. Following instructions under 6.0 Complex Command Line Installation.
To install prerequisite runtime components of Visual C++ Libraries and SysTrack Cloud Edition.
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
4 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
5.2 Assign a Configuration Name (command line required)
1. From the child system, open a command prompt window (right-click and select Run as
administrator). Use the /c switch to assign a configuration name.
Setup.exe /c ”EnterConfigurationName”
5.3 Result
1. If Setup.exe fails, the command window will be left open until the Enter key is pressed.
2. If Setup.exe succeeds, the following 4 traces (3 on 32-bit systems) and the window will
automatically disappear when finished.
1. ALLUSERS
a. Default is 1 <per-machine>. Read Per-machine vs Per-user installations above.
b. Used with Install, Reinstall and Upgrade modes.
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
5 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
2. REBOOT
a. Default is “”.
b. 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.
c. The REBOOT property is used to suppress certain prompts and actions for restarts.
d. 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.
e. 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
3. REINSTALL
a. Default is “”.
b. Required for Reinstall installation (same version being installed).
c. Required to set REINSTALL=ALL on the command line to reinstall missing files, replace
old files, stop/start the agent and registry settings.
d. Required to assign values to CONFIGNAME, POOLDB, POOLDB_LOGFOLDER and
POOLDB_WRITEFOLDER, PROXYCONNECTIONHUB, AUTODETECTPROXY,
AUTOCONFIGSCRIPT, HTTPSPROXY and POOLNAME or their default values will be used.
4. INSTALLDIR
a. Default install path on 32-bit operating system:
“<[ProgramFilesFolder]\SysTrack\LsiAgent>” or, “C:\Program Files\SysTrack\LsiAgent”
b. Default install path on 64-bit operating system:
“<[ProgramFilesFolder]\SysTrack\LsiAgent>” or, “C:\Program Files
(x86)\SysTrack\LsiAgent”
c. Required to use double-quotes around path when assigning INSTALLDIR.
Example: INSTALLDIR=”D:\<path>\SysTrack”
d. Required during a First time if installing to a different path then Default path.
e. Required during an Upgrade if upgrading a different path then Default path.
f. Not valid during a Reinstall. The INSTALLDIR property cannot change the destination
install path during a Reinstall [REINSTALL=ALL].
5. CONFIGNAME
a. Default value is “”.
b. An entry value is required to assign a named configuration.
c. Required for Install and Reinstall or the default value is used.
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
6 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
d. Required for an Upgrade only if the user wishes to change the currently installed
product’s CONFIGNAME 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.
6. POOLNAME (Advanced “Pooled User” only)
a. Default value is “”.
b. Used for a “Pooled User” installation ONLY.
c. Assign the Pool name to the POOLNAME property.
d. Do not use POOLNAME if performing a Standard installation.
e. Do not use POOLDB, POOLDB_LOGFOLDER, POOLDB_WRITEFOLDER.
f. Required for Install and Reinstall or the default value is used.
g. 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).
7. POOLDB (Advanced “Pooled System” only)
a. Default value is “”.
b. Used for a “Pooled System” installation ONLY.
c. 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.
d. The POOLDB location may be changed.
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
7 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
POOLDB_LOGFOLDER=”D:\SysTrack\Log\”
POOLDB_LOGFOLDER=”D:\PooledDB\%SYSTEMNAME%\Log\”
Note: The folder path must already exist.
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
8 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
i. AUTODETECTPROXY=1
ii. AUTODETECTPROXY=0
f. Required during Install and Reinstall or the default value is used.
g. Required for an Upgrade if the user wishes to change the currently installed
AUTODETECTPROXY assigned. Will also require FORCE=1 on the command line (see
FORCE).
12. AUTOCONFIGSCRIPT
a. Default is “”.
b. Optional MSI parameter.
c. Preferred proxy setting: the address of a .pac file to get proxy information.
d. Example:
i. AUTOCONFIGSCRIPT=http://<server>.<domain>/test.pac
e. Required during Install and Reinstall or the default value is used.
f. Required for an Upgrade if the user wishes to change the currently installed
AUTOCONFIGSCRIPT assigned. Will also require FORCE=1 on the command line (see
FORCE).
13. HTTPSPROXY
a. Default is “”.
b. Optional MSI parameter.
c. Preferred proxy setting: the address for the preferred HTTPS proxy.
d. Example:
i. HTTPSPROXY=127.0.0.1:443
e. Required during Install and Reinstall or the default value is used.
f. Required for an Upgrade if the user wishes to change the currently installed
HTTPSPROXY assigned. Will also require FORCE=1 on the command line (see FORCE).
14. FORCE (CONFIGNAME, POOLNAME, POOLDB, POOLDB_LOGFOLDER and
POOLDB_WRITEFOLDER only)
a. Default value is 0.
b. Used during Upgrade only and to change the currently installed product’s property
values for CONFIGNAME and/or POOLNAME, POOLDB, POOLDB_LOGFOLDER,
POOLDB_WRITEFOLDER, PROXYCONNECTIONHUB, AUTODETECTPROXY,
AUTOCONFIGSCRIPT, HTTPSPROXY.
c. If FORCE=0 or the property is not set in the command line argument because the default
is 0, the Upgrade process will ignore CONFIGNAME, POOLNAME, POOLDB,
POOLDB_LOGFOLDER, POOLDB_WRITEFOLDER, 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.
d. If FORCE=1 is used on the command line argument, the Upgrade process will be forced
to use the command line properties (CONFIGNAME, POOLNAME, POOLDB,
POOLDB_LOGFOLDER, POOLDB_WRITEFOLDER, PROXYCONNECTIONHUB,
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
9 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
AUTODETECTPROXY, AUTOCONFIGSCRIPT, HTTPSPROXY) values to change the
currently installed product’s property value. Default values are used if not set.
1. Default setting for the ALLUSERS property, for SysTrackCloudEdition.msi, is equal to the number
1 <per-machine>
2. 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.
3. 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.
4. If ALLUSERS=””, the install will perform a per-user installation.
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
For Advanced “Pooled System” installation, the property POOLDB, POOLDB_LOGFOLDER and
POOLDB_WRITEFOLDER must be set or its default value will be used.
For Advanced “Pooled User” installation, the property POOLNAME must be set or its default value will
be used.
For installations having a configuration name, the CONFIGNAME property must be set or its default
value will be used.
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
10 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
Also, if the following optional properties PROXYCONNECTIONHUB, AUTODETECTPROXY,
AUTOCONFIGSCRIPT, HTTPSPROXY must be set or its default value will be used.
Important: Failure to add REINSTALL=ALL to the command line during a reinstall will result in a failed
installation. Example:
MSI (s) (BC:00) [07:43:22:056]: Product: Systems Management Agent -- The same version of this product is already installed. To
perform a reinstall (repair) will require the property REINSTALL="ALL" assigned in the command line. This program will now
exit.
The same version of this product is already installed. To perform a reinstall (repair) will require the property REINSTALL="ALL"
assigned in the command line. This program will now exit.
Action ended 7:43:22: IsReinstall. Return value 3.
The same is true for upgrades having a configuration name. A typical SysTrack Cloud Edition upgrade
does not require the user to set the CONFIGNAME property in the command line argument.
Setting the FORCE property equal to 1 will force the Upgrade process to use the POOLNAME, POOLDB,
POOLDB_LOGFOLDER, POOLDB_WRITEFOLDER, CONFIGNAME, PROXYCONNECTIONHUB,
AUTODETECTPROXY, AUTOCONFIGSCRIPT, HTTPSPROXY property values on the command line.
Installation Order:
1st: VC_redist.x86.exe (32-bit and 64-bit operating systems)
nd
2 : VC_redist.x64.exe (64-bit operating systems only)
rd
3 : SysTrackCloudEdition.msi
Important: Microsoft Windows 7 SP1, Windows 8.1, Windows 10, Windows Server 2008 SP2, Windows
Server 2008 R2 SP1, Windows Server 2012, Windows Server 2012 R2, Windows Server 2016 and
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
11 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
Windows Server 2019 (or higher) users may be required to run the files logged on and run with “Run as
administrator”.
Important: Install this prerequisite on both 32-bit and 64-bit operating systems.
From the child system, open a command prompt window (right-click and select Run as
administrator) and type the following command:
Silent First-time Install, Reinstall or Upgrade (create log, create the temp folder)
a. Switches Information:
i. /q – Quiet mode, no user input required or output shown
ii. /norestart – if the operation requires a reboot to complete, Setup should
neither prompt nor cause a reboot.
iii. /log – Location of the log file (optional). User may use this switch to create a log
file in a specific location. Required to create the directory folder.
Note: It is not required to use the /log switch. By default, vcredist
automatically creates default logs in or near %temp% with a name based on the
package, date and time, example:
dd_vcredist_x86_<date><time>.log
dd_vcredist_x86_<date><time>_<number>_vcRuntimeAdditional_x86.log
dd_vcredist_x86_<date><time>_<number>_vcRuntimeMinimum_x86.log
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
12 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
c. If you are performing a silent installation (using the /q switch), you may view the
progress in the Task Manager.
i. Should see VC_redist.x86.exe listed when running.
ii. Once the installation completes, the name will be removed.
iii. User may determine if the installation was a success or failure by reading
information near the bottom of the log. Example default log file name and
entry toward the bottom of the page:
MSI (s) (1C:30) [09:32:38:394]: Product: Microsoft Visual C++ 2019 X86 Additional Runtime -
14.24.28127 -- Installation completed successfully.
MSI (s) (1C:30) [09:32:38:394]: Product: Microsoft Visual C++ 2019 X86 Minimum Runtime -
14.24.28127 -- Installation completed successfully.
d. To determine if a system reboot is needed, search for entries that indicate a system
reboot is required. Key words to search for are: System restart and Reboot.
e. If log indicates installation failed, you may need to search for “return value 3” to help
determine why the installation failed.
From the child system, open a command prompt window (right-click and select Run as
administrator) and type the following command:
Silent First-time Install, Reinstall or Upgrade (create log, create the temp folder)
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
13 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
a. Switches Information
i. /q – Quiet mode, no user input required or output shown
ii. /norestart – if the operation requires a reboot to complete, Setup should
neither prompt nor cause a reboot.
iii. /log – Location of the log file (optional). User may use this switch to create a log
file in a specific location. Required to create the directory folder.
Note: It is not required to use the /log switch. By default, vcredist
automatically creates default logs in or near %temp% with a name based on the
package, date and time, example:
dd_vcredist_amd64_<date><time>.log
dd_vcredist_amd64_<date><time>_<number>_vcRuntimeAdditional_x64.log
dd_vcredist_amd64_<date><time>_<number>_vcRuntimeMinimum_x64.log
dd_vcredist_amd64_<date><time>.log
dd_vcredist_amd64_<date><time>_<number>_vcRuntimeAdditional_x64.log
dd_vcredist_amd64_<date><time>_<number>_vcRuntimeMinimum_x64.log
MSI (s) (1C:30) [09:32:38:394]: Product: Microsoft Visual C++ 2019 X64 Additional Runtime -
14.24.28127 -- Installation completed successfully.
MSI (s) (1C:30) [09:32:38:394]: Product: Microsoft Visual C++ 2019 X64 Minimum Runtime -
14.24.28127 -- Installation completed successfully.
d. To determine if a system reboot is needed, search for entries that indicate a system
reboot is required. Key words to search for are: System restart and Reboot.
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
14 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
MSI (s) (EC:A0) [16:38:48:595]: The Windows Installer initiated a system restart to complete or
continue the configuration of...
e. If log indicates installation failed, you may need to search for “return value 3” to help
determine why the installation failed.
Important: Microsoft Windows 7 SP1, Windows 8.1, Windows 10, Windows Server 2008 SP2, Windows
Server 2008 R2 SP1, Windows Server 2012, Windows Server 2012 R2, Windows Server 2016 and
Windows Server 2019 (or higher) users may be required to run the files logged on and run with “Run as
administrator”.
• Default values will be used if not set (read Command Line Properties).
• Add REBOOT=R to suppress automatic and certain prompts for system restarts.
• Add CONFIGNAME=”<EnterConfigurationName>” to assign a named configuration
otherwise the default value “” will be used.
• Add PROXYCONNECTIONHUB =”<EnterProxyConnectionHubSystemName>” to assign the
name of the ProxyConnectionHub system (if applicable), otherwise the default value “” will
be used. (optional)
• Add AUTODETECTPROXY =”<EnterUseAutoDetectValue>” to assign the preferred proxy
setting: whether or not to use autodetect, otherwise the default value 0 will be used. Assign
“1” if true, “0” otherwise. (optional)
• Add AUTOCONFIGSCRIPT =”<EnterAddressOfAPacFile>” to assign the preferred proxy
setting: the address of a .pac file to get proxy information, otherwise the default value “”
will be used. (optional)
• Add HTTPSPROXY =”< EnterAddressForPreferredHTTPSProxy >” to assign the preferred
proxy setting: the address for the preferred HTTPS proxy, otherwise the default value “” will
be used. (optional)
• Add INSTALLDIR if the install path is not default install path (read Command Line Properties)
• Required to place double quotes around values assigned to CONFIGNAME and INSTALLDIR.
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
15 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
CONFIGNAME=”<EnterConfigurationNameHere>” INSTALLDIR=”<enter path>\SysTrack” /L*v <enter path
to an existing temp folder>\ silentinstallclient.log (optional)
First-time Install (default install path, with logging, no configuration name, create temp folder):
First-time Install (Not default install path, with logging, no configuration name, create temp
folder):
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
16 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
• INSTALLDIR property is not valid for a Reinstall.
• Add REBOOT=R to suppress automatic and certain prompts for system restarts.
• Add CONFIGNAME=”<EnterConfigurationName>” to change the currently installed named
configuration. This will also require FORCE=1 to be added.
• Add INSTALLDIR if the install path is not default install path (read Command Line Properties)
• Add PROXYCONNECTIONHUB =”<EnterProxyConnectionHubSystemName>” to change the
currently installed named ProxyConnectionHub system name otherwise the default value “”
will be used. This will also require FORCE=1 to be added. Same as CONFIGNAME.
• Add AUTODETECTPROXY =”<EnterUseAutoDetectValue>” to change the currently installed
preferred proxy setting: whether or not to use autodetect, otherwise the default value 0 will
be used. Assign “1” if true, “0” otherwise. This will also require FORCE=1 to be added.
Same as CONFIGNAME.
• Add AUTOCONFIGSCRIPT =”<EnterAddressOfAPacFile>” to change the currently installed
preferred proxy setting: the address of a .pac file to get proxy information, otherwise the
default value “” will be used. This will also require FORCE=1 to be added. Same as
CONFIGNAME.
• Add HTTPSPROXY =”< EnterAddressForPreferredHTTPSProxy >” to change the currently
installed preferred proxy setting: the address for the preferred HTTPS proxy, otherwise the
default value “” will be used. This will also require FORCE=1 to be added. Same as
CONFIGNAME.
• Required to place double quotes around values assigned to CONFIGNAME and INSTALLDIR.
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
17 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
path>\SysTrack” /L*v <enter path to an existing temp folder>\ silentupgradeclient.log (optional)
Upgrade (Not default install path, with logging, create temp folder)
Upgrade (default install path, change configuration name, with logging, create temp folder)
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
18 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
Upgrade (Not default install path, change configuration name, with logging, create temp folder)
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
19 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
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
Important: Microsoft Windows 7 SP1, Windows 8.1, Windows 10, Windows Server 2008 SP2, Windows
Server 2008 R2 SP1, Windows Server 2012, Windows Server 2012 R2, Windows Server 2016 and
Windows Server 2019 (or higher) users may be required to run the files logged on and run with “Run as
administrator”.
Non-persistent desktops contain one or more desktops automatically created and customized by virtual
machine templates. Users are allocated any desktop currently available in the pool, which may differ
between sessions. This desktop is assigned dynamically each time the user connects.
Important: Advanced installation steps are only necessary for use of the SysTrack cloud agent under
certain circumstances, generally non-persistent pooled image based deployments.
Important: For purely non-persistent systems without associated persistent storage devices, a file share
location must be specified for storage of the SysTrack cloud agent database files. This network file share
location will require that the local computer account for each system that will use it have read/write
access for the agent to create and maintain its database on each endpoint.
Important: Install, reinstall, upgrade and uninstall must take place on the **golden image** for the
Non-persistent desktop.
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
20 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
IMPORTANT: Add %SYSTEMNAME% (all caps) to prevent duplication of data across
cloned/copied systems, example: POOLDB=”K:\SysTrack\Database\%SYSTEMNAME%\”
First-time “Pooled System” Install (default install path, no logging, no configuration name):
First-time “Pooled System” Install (Not default install path, no logging, no configuration name)
First-time “Pooled System” Install (default install path, with logging, no configuration name,
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
21 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
create temp folder):
First-time “Pooled System” Install (Not default install path, with logging, no configuration name,
create temp folder):
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
22 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
installed preferred proxy setting: the address for the preferred HTTPS proxy, otherwise the
default value “” will be used. This will also require FORCE=1 to be added. Same as
CONFIGNAME.
Reinstall “Pooled System” (no configuration name, with logging, create temp folder):
Upgrade “Pooled System” (default install path, keep current CONFIGNAME, POOLDB,
POOLDB_LOGFOLDER and POOLDB_WRITEFOLDER settings, no logging)
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
23 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
Upgrade “Pooled System” (Not default install path, keep current CONFIGNAME,
POOLDB, POOLDB_LOGFOLDER and POOLDB_WRITEFOLDER settings, no logging)
Upgrade “Pooled System” (default install path, keep current CONFIGNAME, POOLDB,
POOLDB_LOGFOLDER and POOLDB_WRITEFOLDER settings, with logging, create temp
folder)
Upgrade “Pooled System” (Not default install path, keep current CONFIGNAME,
POOLDB, POOLDB_LOGFOLDER and POOLDB_WRITEFOLDER settings, with logging,
create temp folder)
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
24 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
• Add POOLDB_WRITEFOLDER=”<enter path>” to store write files. (optional)
Note: Do not include a file name to the property.
• Add PROXYCONNECTIONHUB =”<EnterProxyConnectionHubSystemName>” to
change the currently installed named ProxyConnectionHub system name.
• Add AUTODETECTPROXY =”<EnterUseAutoDetectValue>” to change the currently
installed preferred proxy setting: whether or not to use autodetect.
• Add AUTOCONFIGSCRIPT =”<EnterAddressOfAPacFile>” to change the currently
installed preferred proxy setting: the address of a .pac file to get proxy information.
• Add HTTPSPROXY =”< EnterAddressForPreferredHTTPSProxy >” to change the
currently installed preferred proxy setting: the address for the preferred HTTPS
proxy.
• Add REBOOT=R to suppress automatic and certain prompts for system restarts.
• Add INSTALLDIR if the install path is not default path (read Command Line
Properties)
• Required to place double quotes around values assigned to INSTALLDIR,
CONFIGNAME, POOLDB, POOLDB_LOGFOLDER and POOLDB_WRITEFOLDER.
Upgrade “Pooled System”, Not default install path, change current POOLDB,
POOLDB_LOGFOLDER, POOLDB_WRITEFOLDER and CONFIGNAME, no logging
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
25 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
Upgrade “Pooled System”, Not default install path, change current POOLDB,
POOLDB_LOGFOLDER, POOLDB_WRITEFOLDER and CONFIGNAME, with logging, create
temp folder
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
26 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
xii. INSTALLDIR: Required for First-time and Upgrade installations and if not using
the default install path
1. Example: INSTALLDIR=”C:\SysTrack”
2. Default is:
a. 32-bit operating system:
“<[ProgramFilesFolder]\SysTrack\LsiAgent>”, e.g. “C:\Program
Files\SysTrack\LsiAgent”
b. 64-bit operating system:
“<[ProgramFilesFolder]\SysTrack\LsiAgent>”, e.g. “C:\Program
Files (x86)\SysTrack\LsiAgent”
b. /qn – (q)silent mode (no user interaction); (n)no user interface
c. /i – install
d. /L*v – verbose logging (optional): The L in L*v may use a small case (l).
5. Either installation type will take a few minutes to complete.
6. If you are performing a silent installation (using the /qn switch), a good way of knowing if the
installation is still running would be to look into the Task Manager. There, you should see
multiple listings of “msiexec.exe”. And, if you ran the MSI installer with logging (using the /L*v
switch), not only will the log be created, but inside toward the bottom of the information, will
display whether the installation was a success or failure.
7. To determine if a system reboot is needed, simply 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 for are: System restart and Reboot. Results:
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
Important: Microsoft Windows 7 SP1, Windows 8.1, Windows 10, Windows Server 2008 SP2, Windows
Server 2008 R2 SP1, Windows Server 2012, Windows Server 2012 R2, Windows Server 2016 and
Windows Server 2019 (or higher) users may be required to run the files logged on and run with “Run as
administrator”.
Non-persistent desktops contain one or more desktops automatically created and customized by virtual
machine templates. Users are allocated any desktop currently available in the pool, which may differ
between sessions. This desktop is assigned dynamically each time the user connects.
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
27 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
Important: Advanced installation steps are only necessary for use of the SysTrack cloud agent under
certain circumstances, generally non-persistent pooled image based deployments.
Important: For purely non-persistent systems without associated persistent storage devices, a file share
location must be specified for storage of the SysTrack cloud agent database files. This network file share
location will require that the local computer account for each system that will use it have read/write
access for the agent to create and maintain its database on each endpoint.
Important: Install, reinstall, upgrade and uninstall must take place on the **golden image** for the
Non-persistent desktop.
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
28 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
First-time “Pooled User” Install (default install path, no logging, no configuration name):
First-time “Pooled User” Install (Not default install path, no logging, no configuration name)
First-time “Pooled User” Install (default install path, with logging, no configuration name, create
temp folder):
First-time “Pooled User” Install (Not default install path, with logging, no configuration name,
create temp folder):
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
29 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
• Add HTTPSPROXY =”< EnterAddressForPreferredHTTPSProxy >” to change the currently
installed preferred proxy setting: the address for the preferred HTTPS proxy, otherwise the
default value “” will be used. This will also require FORCE=1 to be added. Same as
CONFIGNAME.
Reinstall “Pooled User” (no configuration name, with logging, create temp folder):
Upgrade “Pooled User” (default install path, keep current CONFIGNAME and
POOLNAME settings, no logging)
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
30 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
Upgrade “Pooled User” (Not default install path, keep current CONFIGNAME and
POOLNAME settings, no logging)
Upgrade “Pooled User” (default install path, keep current CONFIGNAME and
POOLNAME settings, with logging, create temp folder)
Upgrade “Pooled User” (Not default install path, keep current CONFIGNAME and
POOLNAME settings, with logging, create temp folder)
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
31 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
CONFIGNAME=”<EnterConfigurationNameHere>” POOLNAME=”<enter the Pool name here>”
INSTALLDIR=”<enter path>\SysTrack” /L*v <enter path to an existing temp folder>\
silentupgradeclient.log (optional)
Upgrade “Pooled User”, default install path, change current POOLNAME and
CONFIGNAME, no logging
Upgrade “Pooled User”, Not default install path, change current POOLNAME and
CONFIGNAME, no logging
Upgrade “Pooled User”, default install path, change current POOLNAME and
CONFIGNAME, with logging, create temp folder
Upgrade “Pooled User”, Not default install path, change current POOLNAME and
CONFIGNAME, with logging, create temp folder
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
32 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
vii. HTTPSPROXY=127.0.0.1:443: assign preferred proxy setting: the address for the
preferred HTTPS proxy <Optional>
viii. POOLNAME: Required for “Pooled User” only.
ix. FORCE: <Required for Upgrades only when command line properties
CONFIGNAME, POOLNAME, PROXYCONNECTIONHUB, AUTODETECTPROXY,
AUTOCONFIGSCRIPT, HTTPSPROXY are to be used>
1. FORCE=1: will force the Upgrade process to use both the CONFIGNAME
and POOLNAME property values to change the currently installed value.
Requires values assigned to CONFIGNAME, POOLNAME,
PROXYCONNECTIONHUB, AUTODETECTPROXY, AUTOCONFIGSCRIPT,
HTTPSPROXY or their default value “” will be used (read Command Line
Properties).
2. FORCE=0: < not required because the default is 0 >
x. INSTALLDIR: Required for First-time and Upgrade installations and if not using
the default install path
1. Example: INSTALLDIR=”C:\SysTrack”
2. Default is:
a. 32-bit operating system:
“<[ProgramFilesFolder]\SysTrack\LsiAgent>”, e.g. “C:\Program
Files\SysTrack\LsiAgent”
b. 64-bit operating system:
“<[ProgramFilesFolder]\SysTrack\LsiAgent>”, e.g. “C:\Program
Files (x86)\SysTrack\LsiAgent”
b. /qn – (q)silent mode (no user interaction); (n)no user interface
c. /i – install
d. /L*v – verbose logging (optional): The L in L*v may use a small case (l).
5. Either installation type will take a few minutes to complete.
6. If you are performing a silent installation (using the /qn switch), a good way of knowing if the
installation is still running would be to look into the Task Manager. There, you should see
multiple listings of “msiexec.exe”. And, if you ran the MSI installer with logging (using the /L*v
switch), not only will the log be created, but inside toward the bottom of the information, will
display whether the installation was a success or failure.
7. To determine if a system reboot is needed, simply 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 for are: System restart and Reboot. Results:
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'.
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
33 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
Property(S): MsiSystemRebootPending = 1
MSI (s) (F0:90) [16:34:02:888]: Product: Systems Management Agent -- Installation operation completed
successfully.
MSI (s) (F0:90) [16:34:02:888]: Windows Installer installed the product. Product Name: Systems
Management Agent. Product Version: 5.00.0054. Product Language: 1033. Installation success or error
status: 0.
MSI (s) (F0:90) [16:34:02:903]: MainEngineThread is returning 0
3. To determine if a system reboot is needed, simply 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 for are: 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
1. If the failure occurred during the installation, search for the phrase “return value 3” in the LOG
file. Each action that takes place during an installation will return a value and log it as “return
value #”. When an action fails, you should see the phrase “return value 3” and some other
information immediately before or after this line and should help pinpoint where and why the
installation failed.
2. If a failure occurs before the installation begins, the LOG file will have very few lines of
information available and the phrase “return value 3” may not exist.
a. Verify command line entered is correct including spelling of path entered to the MSI file.
b. Example 1: UAC issue
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
34 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
MSI (s) (B8:D0) [08:57:16:681]: Note: 1: 2203 2: \\server\share\msi\SysTrackCloudEdition.msi 3: -
2147023570
MSI (s) (B8:D0) [08:57:16:681]: MainEngineThread is returning 1620
MSI (c) (4C:68) [08:57:16:697]: Decrementing counter to disable shutdown. If counter >= 0, shutdown will
be denied. Counter after decrement: -1
MSI (c) (4C:68) [08:57:16:697]: MainEngineThread is returning 1620
=== Verbose logging stopped: 7/9/2019 8:57:16 ===
i. Information: User was logged on as local admin on a Vista system launching the
MSI as administrator via command prompt window.
ii. Troubleshoot: the example above shows the following return codes:
1. -2147023570 means Unknown username or bad password
2. 1620 means this installation package could not be opened.
Troubleshoot: the path used to launch the MSI file pointed to a network share
(\\server\share...).
iii. Possible Solution:
1. Change UAC settings to allow the MSI installation to occur.
2. Do not use a shared path. Copy MSI file to your local system and launch
the MSI pointing to the local path.
i. Few lines of information in an installation log also may indicate the wrong path
or incorrect syntax was entered in a command line.
ii. The example above shows the return error -2147287038 which translates to
mean %1 could not be found.
iii. In this case, an incorrect path to SysTrackCloudEdition.msi was entered in the
command line.
iv. Solution: Rewrite the command line with the correct path and restart the
installation.
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
35 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
services.
Error 1920.Service Systems Management Agent (LsiAgent) failed to start. Verify that you have sufficient
privileges to start system services.
MSI (s) (A0:64) [11:34:36:514]: User policy value 'DisableRollback' is 0
MSI (s) (A0:64) [11:34:36:514]: Machine policy value 'DisableRollback' is 0
Action ended 11:34:36: InstallFinalize. Return value 3.
i. Search for “return value 3” and read lines above where found.
ii. Information indicates the Systems Management Agent (LsiAgent) failed to start.
iii. This error does occur when SysTrackCloudEdition.msi is installed before the
prerequisite vcredist executables are installed.
iv. Possible Solution: Determine if the Visual C++ 2019 redistributables were
successfully installed and if a reboot was required from them to complete their
installations before installing SysTrackCloudEdition.msi.
Important: Microsoft Windows 7 SP1, Windows 8.1, Windows 10, Windows Server 2008 SP2, Windows
Server 2008 R2 SP1, Windows Server 2012, Windows Server 2012 R2, Windows Server 2016 and
Windows Server 2019 (or higher) users may be required to run the files logged on and run with “Run as
administrator”.
Important: Microsoft Windows 7 SP1, Windows 8.1, Windows 10, Windows Server 2008 SP2, Windows
Server 2008 R2 SP1, Windows Server 2012, Windows Server 2012 R2, Windows Server 2016 and
Windows Server 2019 (or higher) users may be required to run the files logged on and run with “Run as
administrator”.
1. Uninstallations must occur in the following order (seen in Programs and Features panel):
1st: Systems Management Agent
nd
2 : Microsoft Visual C++ 2015-2019 Redistributable (x86)
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
36 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
3rd: Microsoft Visual C++ 2015-2019 Redistributable (x64)
2. The registry has an entry defining the command needed to uninstall via other method. You’ll
have to browse through the entries in this registry location until the specific GUID that refers to
the SysTrack Cloud Edition are located. Once found, use the value of the registry value named
‘UninstallString’ to uninstall. Both Microsoft Visual C++ 2015-2019 Redistributable (x86) and
Microsoft Visual C++ 2015-2019 Redistributable (x64) are given below.
a. Search registry key to get command line to uninstall SysTrack Cloud Edition:
i. (32-bit OS) Registry
1. HKEY_LOCAL_MACHINE\SOFTWARE\Lakeside Software\Deploy
a. Registry value named ChildMsiUninstallString
-Or-
2. HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Unin
stall\{<GUID>}
a. Registry value named UninstallString
ii. (64-bit OS) Registry
1. HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Lakeside
Software\Deploy
a. Registry value named ChildMsiUninstallString
-Or-
2. HKEY_LOCAL_MACHINE\SOFTWARE\
Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\{<GUID>}
a. Registry value named UninstallString
b. Uninstall SysTrack Cloud Edition: From the child system, open a command prompt
window and enter the following command:
Registry:
Msiexec.exe /qn /x {<Registry GUID goes here>} REBOOT=R /L*v <enter path to an
existing temp folder>\silentuninstall.log (logging optional)
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
37 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
-or-
i. A successful removal log entry toward the bottom should look similar to the
following:
MSI (s) (18:14) [11:58:36:908]: Product: Systems Management Agent -- Removal completed
successfully.
c. Uninstall Microsoft Visual C++ 2015-2019 Redistributable (x86): From the child system,
bring up a command prompt window and enter the following command:
ii. A successful removal log entry toward the bottom should look like the following:
MSI (s) (0C:28) [11:13:46:133]: Product: Microsoft Visual C++ 2019 X86 Additional Runtime -
14.24.28127 -- Removal completed successfully.
MSI (s) (0C:F4) [11:13:47:428]: Product: Microsoft Visual C++ 2019 X86 Minimum Runtime -
14.24.28127 -- Removal completed successfully.
d. Uninstall Microsoft Visual C++ 2015-2019 Redistributable (x64): From the child system,
bring up a command prompt window and enter the following command:
ii. A successful removal log entry toward the bottom should look like the following:
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
38 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
Creates 3 log files:
vc2019x64_uninstall.log
vc2019x64_uninstall_000_vcRuntimeAdditional_x64.log
vc2019x64_uninstall_001_vcRuntimeMinimum_x64.log
MSI (s) (0C:28) [11:13:46:133]: Product: Microsoft Visual C++ 2019 X64 Additional Runtime -
14.24.28127 -- Removal completed successfully.
MSI (s) (0C:F4) [11:13:47:428]: Product: Microsoft Visual C++ 2019 X64 Minimum Runtime -
14.24.28127 -- Removal completed successfully.
e. Switch Information:
i. REBOOT=R: to suppress automatic and certain prompts for system restarts.
ii. /q – (q)silent mode (no user interaction); (n)no user interface
iii. /x – uninstall
iv. /L*v – verbose logging (optional): The L in L*v may use a small case (l). For
SysTrackCloudEdition.msi only.
v. /log – path to create log file ( for Visual C++ 2019 redistributables only )
f. More Information:
http://technet.microsoft.com/en-us/library/cc759262(WS.10).aspx#BKMK_Uninstall
In most cases, this should automatically be handled when the agent is installed by collecting the proxy
configuration from the Internet Explorer settings. This may not always occur, which will result in data
not being uploaded and errors related to web communication in the LsiWebCom log.
In order to fix this, confirm that there are proxy settings available in the Internet Explorer options:
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
39 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
Automatic detection, configuration scripts and explicit proxy URLs are all supported. The used proxy
must support HTTPS connections. If these settings exist and files continue to not be uploaded, confirm
that the values exist in the registry under:
Make sure the registry value named ProxyEnable is set to 1 and ProxyServerHttps has the correct URL
and port.
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
40 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
12.0 Proxy Settings and Process
Lakeside Software uses proxies like any other networking tool; the agent will connect to the proxy itself,
which will then connect to the desired endpoint. Proxy logic follows multiple steps. The agent and
supervisor will attempt each step until either a successful connection is made, or no more steps are
available, at which point the attempt cycle will begin again.
The following settings each map to standard proxy usage and operate independently of one another.
Because they are independent, multiple settings can be attempted at once without overriding one
another. The agent will iterate through these settings in the following order:
1. AutoDetect: A Boolean value that determines if the web proxy auto discovery (WPAD) protocol
will be used to collect a list of proxies to attempt.
2. AutoConfigScript: The string value of the address where a PAC file is located, which can return a
list of proxies to attempt.
3. HTTPSPROXY: The string value of the <url>:<port> of a proxy to try for HTTPS connections,
which is supported by Lakeside Software. If using an HTTPSPROXY setting, you need to specify
the port of the proxy itself. For example, if the proxy uses 8080, use the 8080 port.
When the agent requests a connection to the master shortly after startup, the following process takes
place. This process stops as soon as a valid connection is made. At any point in this process, if a proxy
connection is made, it is saved as the last successful proxy connection.
1. The agent collects a list of preferred proxy settings. This includes any or all of the above
AutoDetect, AutoConfigScript, and HTTPSPROXY settings.
2. If any preferred proxies exist, the agent iterates through them until a connection is made or
there are no more to try.
3. Next, the agent attempts a direct connection with no proxy.
4. If no connection is made yet, the agent collects the last successfully used proxy and attempts a
connection to that setting. This is a single proxy setting, but could be an
AutoDetect, AutoConfigScript, or HTTPSPROXY setting.
5. If a connection still hasn’t been made, the agent collects proxy settings from the system, which
includes any or all of the AutoDetect, AutoConfigScript, and HTTPSPROXY settings. These
collections are then saved in case they cannot be collected at some point in the future. Any time
a collection is successful, it overwrites the previous collected data.
6. If collected proxy data exists (either from a fresh collection or a previous collection), the agent
iterates through them until a connection is made or there are none left to attempt.
Example 1
A company requires all of their outbound network traffic to be routed through a specific proxy. They
don't use WPAD or have a PAC file; instead, the proxies are manually configured through group policy.
From an end-user's perspective, the following proxy is shown in the Windows Network & Internet
settings in the Proxy tab:
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
41 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
In this case, exampleproxy.company.com:8888 is the proxy that LsiAgent and LsiSupervisor should use.
In order to ensure that LsiAgent and LsiSupervisor use the proxy, the install flag HTTPSPROXY should be
used:
HTTPSPROXY="exampleproxy.company.com:8888"
Example 2
A company uses a PAC file to determine how network traffic should be routed. They also push out a
proxy through group policy in case access to the PAC file should fail.
From an end-user's perspective, the following proxy is shown in the Windows Network & Internet
settings in the Proxy tab:
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
42 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
In this case, the autoconfig script is located at http://company.com/example.pac and the backup proxy
is exampleproxy.company.com:8888.
In order to ensure that LsiAgent and LsiSupervisor use these values to find a proxy, the install flags
AUTOCONFIGSCRIPT and HTTPSPROXY should be used:
AUTOCONFIGSCRIPT=" http://company.com/example.pac"
HTTPSPROXY="exampleproxy.company.com:8888"
Example 3
A company uses WPAD to determine how network traffic should be routed.
From an end-user's perspective, the following proxy is shown in the Windows Network & Internet
settings in the Proxy tab:
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
43 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.
In order to ensure that LsiAgent and LsiSupervisor use the auto detect WPAD protocol, the install
flag AUTODETECTPROXY should be used:
AUTODETECTPROXY=1
Example 4
A customer does not require proxies to communicate outside of their network. No proxy specific
settings are required to be in the install command line.
©Lakeside Software, Inc. 1997-2020. Lakeside Software and SysTrack are registered trademarks and/or trademarks of Lakeside
44 Software, Inc. All other trademarks and registered trademarks are the property of their respective owners.