0% found this document useful (0 votes)
404 views44 pages

Cloud Edition Install Guide

Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
404 views44 pages

Cloud Edition Install Guide

Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 44

Technical Documentation

SysTrack Cloud Edition 9.0 -


Installation 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.

Please read and follow the instructions carefully.

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

2.0 Supported Operating Systems


This procedure is valid for child systems having:

• Microsoft Windows 7 Service Pack 1, with latest Windows updates


• Microsoft Windows 8.1 (with Update 2919355)
• Microsoft Windows 10 (version 1507 or higher)
• Microsoft Windows Server 2008 SP2
• Microsoft Windows Server 2008 R2 SP1
• Microsoft Windows Server 2012
• Microsoft Windows Server 2012 R2 (with Update 2919355)
• Microsoft Windows Server 2016
• Microsoft Windows Server 2019 (or higher)

3.0 Setup Files

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:

1. Simple Installation (Setup.exe)

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

2. Complex Command Line Installation

Use command line to install prerequisite runtime components and SysTrack Cloud Edition
individually. Following instructions under 6.0 Complex Command Line Installation.

• (Standard) persistent desktops and regular physical workstations


• (Advanced) golden image based non-persistent “Pooled System” installation.
• (Advanced) golden image based non-persistent “Pooled User” installation.

4.0 Anti-Virus Exclusions


Important: Make sure to check that the following anti-virus settings are excluded in the anti-virus
console if the agent does not install correctly:

• Exclude all items listed under \Program Files (x86)\SysTrack\LsiAgent

5.0 Simple Installation (Setup.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”.
Important: Setup.exe is required to run in the same folder with the two (2) vcredist files and
SysTrackCloudEdition.msi.
Important: Only for (Standard) persistent desktops and regular physical workstations.
Important: Not for “Pooled System” installations. See Advanced Installation.
Important: Not for “Pooled User” installations. See Advanced Installation.
Important: Do not use information (e.g. properties) from Complex Command Line Installation to
perform a simple installation.

To install prerequisite runtime components of Visual C++ Libraries and SysTrack Cloud Edition.

5.1 No Configuration Name (command line not required)


1. Double-click or right click Setup.exe and select “Run as administrator”.

©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.

3. YOU ARE DONE.

6.0 Complex Command Line Installation


Important: All property names must be UPPERCASE on the command line.
Important: Prerequisites must be installed before SysTrack Cloud Edition.
Important: Do not use information from Simple Installation (Setup.exe) to perform a complex
installation.

6.1 Command Line Properties


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

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.

IMPORTANT: Add %SYSTEMNAME% (all caps) to prevent duplication of data across


cloned/copied systems, example: POOLDB=”K:\SysTrack\Database\%SYSTEMNAME%\”

IMPORTANT: May also use POOLDB_LOGFOLDER and POOLDB_WRITEFOLDER


properties to store log files and write files, respectively.

e.Do not use POOLDB if performing a Standard installation.


f.Do not use POOLNAME.
g.Required for Install and Reinstall or the default value is used.
h.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).
8. POOLDB_LOGFOLDER (Advanced “Pooled System” only)
a. Default is “”.
b. Optional use for a “Pooled System” installation ONLY.
c. Assign a folder path to store log files.
Note: Do not include a file name to the POOLDB_LOGFOLDER property.

Example folder paths:

©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.

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


e. Required “Pooled System” for Install and Reinstall or the default value is used.
f. Required “Pooled System” for an Upgrade if the user wishes to change the currently
installed product’s POOLDB_LOGFOLDER assigned. Will also require FORCE=1 on the
command line (see FORCE).
9. POOLDB_WRITEFOLDER (Advanced “Pooled System” only)
a. Default is “”.
b. Optional use for a “Pooled System” installation ONLY.
c. Assign a folder path to write files other than log files.
Note: Do not include a file name to the POOLDB_WRITEFOLDER property.

Example folder paths:


POOLDB_WRITEFOLDER=”D:\SysTrack\Write\”
POOLDB_WRITEFOLDER=”D:\PooledDB\%SYSTEMNAME%\Write\”
Note: The folder path must already exist.

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


e. Required “Pooled System” for Install and Reinstall or the default value is used.
f. Required “Pooled System” for an Upgrade if the user wishes to change the currently
installed product’s POOLDB_WRITEFOLDER assigned. Will also require FORCE=1 on the
command line (see FORCE).
10. PROXYCONNECTIONHUB
a. Default is “”.
b. Optional MSI parameter.
c. The name of your ProxyConnectionHub system (if applicable).
d. Example:
i. PROXYCONNECTIONHUB=<server name>.<domain name>.org
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
PROXYCONNECTIONHUB assigned. Will also require FORCE=1 on the command line (see
FORCE).
11. AUTODETECTPROXY
a. Default is 0.
b. Optional MSI parameter.
c. Preferred proxy setting: whether to use autodetect.
d. The value 1 if true, 0 otherwise.
e. Example:

©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.

6.2 Per-Machine versus Per-User Installations


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.

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.

6.3 Determine System Restart Required


Add the /L*v switch to the command line to create a log file when performing a silent mode MSI
installation and search for entries that indicate a system reboot is required. Key words to search for are:
System restart and Reboot. Examples:

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

6.4 Reinstall Information


A Reinstall (repair) requires the property REINSTALL=ALL to Reinstall missing files, replace old files,
registry entries, etc...

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.

6.5 Upgrade Information


For Advanced “Pooled System” upgrades, a typical SysTrack Cloud Edition upgrade does not require the
user to set the property POOLDB, POOLDB_LOGFOLDER and POOLDB_WRITEFOLDER in the command
line argument.
For Advanced “Pooled User” upgrades, a typical SysTrack Cloud Edition upgrade does not require the
user to set the property POOLNAME in the command line argument.

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.

However, to change the currently installed product’s POOLNAME, POOLDB, POOLDB_LOGFOLDER,


POOLDB_WRITEFOLDER, CONFIGNAME, PROXYCONNECTIONHUB, AUTODETECTPROXY,
AUTOCONFIGSCRIPT, HTTPSPROXY property value will require the property FORCE=1 and assigning a
value to the properties or their default values will be used (read Command Line Properties).

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.

6.6 Installation Order


Important: Prerequisites must be installed before SysTrack Cloud Edition.

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”.

6.7 Prerequisite (32-bit and 64-bit OS): VC_redist.x86.exe


Important: Prerequisite must be installed before SysTrack Cloud Edition.

1. First-time install, Reinstall and Upgrade

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:

VC_redist.x86.exe /q /norestart /log <enter path to an existing folder>\VC2019x86.log (log is optional)

Silent First-time Install, Reinstall or Upgrade (use default logging - %temp%):

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

b. The installation takes a few seconds to complete.

©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.

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

e. If log indicates installation failed, you may need to search for “return value 3” to help
determine why the installation failed.

6.8 Prerequisite (64-bit OS only): VC_redist.x64.exe


Important: Prerequisite must be installed before SysTrack Cloud Edition.

1. First-time install, Reinstall and Upgrade

Important: Install this prerequisite on 64-bit operating systems only.

From the child system, open a command prompt window (right-click and select Run as
administrator) and type the following command:

VC_redist.x64.exe /q /norestart /log <enter path to an existing folder>\VC2019x64.log (log is optional)

Silent First-time Install, Reinstall or Upgrade (use default logging - %temp%):

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

b. The installation takes a few seconds to complete.


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.x64.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:

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.

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


complete operation.

©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.

6.9 SysTrackCloudEdition.msi (SysTrack Cloud Edition)


• (Standard) persistent desktops and regular physical workstations
• (Advanced) golden image based non-persistent “Pooled System” installation.
• (Advanced) golden image based non-persistent “Pooled User” installation.

6.9.1 Standard Installation: persistent desktops and physical workstations


Important: Prerequisites must be installed before SysTrack Cloud Edition.

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. First-time (Standard) installation – SysTrackCloudEdition.msi

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

Msiexec.exe /qn /i “<enter path>\SysTrackCloudEdition.msi” REBOOT=R

©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, no logging, no configuration name):

First-time Install (Not default install path, no logging, no configuration name)

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):

2. Reinstall (Standard) – SysTrackCloudEdition.msi

• Add REINSTALL=ALL to the command line.


• 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)
• Required to place double quotes around value assigned to CONFIGNAME.

©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.

Msiexec.exe /qn /i “<enter path>\SysTrackCloudEdition.msi” REINSTALL=ALL REBOOT=R


CONFIGNAME=”<EnterConfigurationNameHere>” /L*v <enter path to an existing temp
folder>\silentreinstallclient.log (optional)

Reinstall (no configuration name, no logging):

Reinstall (no configuration name, with logging, create temp folder):

3. Upgrade (Standard) – SysTrackCloudEdition.msi

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

To not change currently installed Configuration Name:

Msiexec.exe /qn /i “<enter path>\SysTrackCloudEdition.msi” REBOOT=R INSTALLDIR=”<enter

©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 (default install path, no logging)

Upgrade (Not default install path, no logging)

Upgrade (default install path, with logging, create temp folder)

Upgrade (Not default install path, with logging, create temp folder)

To change currently installed Configuration Name, PROXYCONNECTIONHUB,


AUTODETECTPROXY, AUTOCONFIGSCRIPT, HTTPSPROXY requires FORCE=1:

Msiexec.exe /qn /i “<enter path>\SysTrackCloudEdition.msi” REBOOT=R INSTALLDIR=”<enter


path>\SysTrack” FORCE=1 CONFIGNAME=”<EnterConfigurationNameHere>” /L*v <enter path to an
existing temp folder>\ silentupgradeclient.log (optional)

Upgrade (default install path, no logging, change configuration name)

Upgrade (Not default install path, no logging, change configuration name)

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)

4. Parameter Information: Read Command Line Properties


a. All Property names must be UPPERCASE:
i. REBOOT=R: to suppress automatic and certain prompts for system restarts.
ii. REINSTALL=ALL: Required for Reinstall only.
iii. CONFIGNAME=”<EnterConfigurationName>”: to assign a named configuration.
iv. PROXYCONNECTIONHUB =”<EnterProxyConnectionHubSystemName>” to assign
the name of the ProxyConnectionHub system (if applicable).
v. AUTODETECTPROXY =”<EnterUseAutoDetectValue>” to assign the preferred
proxy setting: whether or not to use autodetect.
vi. AUTOCONFIGSCRIPT =”<EnterAddressOfAPacFile>” to assign the preferred
proxy setting: the address of a .pac file to get proxy information.
vii. HTTPSPROXY =”< EnterAddressForPreferredHTTPSProxy >” to assign the
preferred proxy setting: the address for the preferred HTTPS proxy.
viii. 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:

©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

6.9.2 Advanced Installation: golden image based non-persistent “Pooled


System”
Important: Prerequisites must be installed before SysTrack Cloud Edition.

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.

1. First-time (Advanced “Pooled System”) installation – SysTrackCloudEdition.msi


• 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 INSTALLDIR if the install path is not default install path (read Command Line Properties)
• Add CONFIGNAME=”<EnterConfigurationName>” to assign a named configuration
otherwise the default value “” will be used.
• Add POOLDB=”<enter path>” to the persistent storage location/directory where the
database will be stored.
Note: Do not include a file name to the POOLDB property.

©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%\”

• Add POOLDB_LOGFOLDER=”<enter path>” to store log files. (optional)


Note: Do not include a file name to the property.
• Add POOLDB_WRITEFOLDER=”<enter path>” to store write files. (optional)
Note: Do not include a file name to the property.
• Required to place double quotes around values assigned to INSTALLDIR, CONFIGNAME,
POOLDB, POOLDB_LOGFOLDER and POOLDB_WRITEFOLDER.
• 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.

Msiexec.exe /qn /i “<enter path>\SysTrackCloudEdition.msi” REBOOT=R INSTALLDIR=”<enter


path>\SysTrack” CONFIGNAME=”<EnterConfigurationNameHere>” POOLDB=”<enter path to database
here>” POOLDB_LOGFOLDER=”enter path” POOLDB_WRITEFOLDER=”<enter path>” /L*v <enter path to
an existing temp folder>\ silentinstallclient.log (optional)

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):

2. Reinstall (Advanced “Pooled System”) – SysTrackCloudEdition.msi


• Add REINSTALL=ALL to the command line.
• Add REBOOT=R to suppress automatic and certain prompts for system restarts.
• Default values will be used if not set (read Command Line Properties).
• INSTALLDIR property is not valid for a Reinstall.
• Add CONFIGNAME=”<EnterConfigurationName>” to assign a named configuration
otherwise the default value “” will be used.
• Add POOLDB=”<enter path>” to the persistent storage location/directory where the
database will be stored. Do not include a file name to the POOLDB property.

IMPORTANT: Add %SYSTEMNAME% (all caps) to prevent duplication of data across


cloned/copied systems, example: POOLDB=”K:\SysTrack\Database\%SYSTEMNAME%\”

• Add POOLDB_LOGFOLDER=”<enter path>” to store log files. (optional)


Note: Do not include a file name to the property.
• 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 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

©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.

Msiexec.exe /qn /i “<enter path>\SysTrackCloudEdition.msi” REINSTALL=ALL REBOOT=R


CONFIGNAME=”<EnterConfigurationNameHere>” POOLDB=”<enter path to database here>”
POOLDB_LOGFOLDER=”enter path” POOLDB_WRITEFOLDER=”<enter path>” /L*v <enter path to an
existing temp folder>\silentreinstallclient.log (optional)

Reinstall “Pooled System” (no configuration name, no logging):

Reinstall “Pooled System” (no configuration name, with logging, create temp folder):

3. Upgrade (Advanced “Pooled System”) – SysTrackCloudEdition.msi


a. Keep currently installed property settings (CONFIGNAME, POOLDB,
POOLDB_LOGFOLDER, POOLDB_WRITEFOLDER, PROXYCONNECTIONHUB,
AUTODETECTPROXY, AUTOCONFIGSCRIPT, HTTPSPROXY)
• FORCE property is not required.
• CONFIGNAME is not required.
• POOLDB property is not required.
• POOLDB_LOGFOLDER property is not required.
• POOLDB_WRITEFOLDER property is not required.
• PROXYCONNECTIONHUB property is not required.
• AUTODETECTPROXY property is not required.
• AUTOCONFIGSCRIPT property is not required.
• HTTPSPROXY property is not required.
• 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).

Msiexec.exe /qn /i “<enter path>\SysTrackCloudEdition.msi” REBOOT=R INSTALLDIR=”<enter


path>\SysTrack” /L*v <enter path to an existing temp folder>\ silentupgradeclient.log (optional)

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)

b. Change currently installed property settings (CONFIGNAME and/or POOLDB,


POOLDB_LOGFOLDER, POOLDB_WRITEFOLDER, PROXYCONNECTIONHUB,
AUTODETECTPROXY, AUTOCONFIGSCRIPT, HTTPSPROXY)
• Add FORCE=1 to force the installer to use values assigned to CONFIGNAME,
POOLDB, POOLDB_LOGFOLDER, POOLDB_WRITEFOLDER,
PROXYCONNECTIONHUB, AUTODETECTPROXY, AUTOCONFIGSCRIPT, HTTPSPROXY
properties. Requires values assigned to properties or their default value “” will be
used (read Command Line Properties).
• Add CONFIGNAME=”<EnterConfigurationName>” to assign a named configuration.
• Add POOLDB=”<enter path>” to the persistent storage location/directory where the
database will be stored. Do not include a file name to the POOLDB property.

IMPORTANT: Add %SYSTEMNAME% (all caps) to prevent duplication of data across


cloned/copied systems, example:
POOLDB=”K:\SysTrack\Database\%SYSTEMNAME%\”

• Add POOLDB_LOGFOLDER=”<enter path>” to store log files. (optional)


Note: Do not include a file name to the property.

©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.

Msiexec.exe /qn /i “<enter path>\SysTrackCloudEdition.msi” FORCE=1 REBOOT=R


CONFIGNAME=”<EnterConfigurationNameHere>” POOLDB=”<enter path to database here>”
POOLDB_LOGFOLDER=”enter path” POOLDB_WRITEFOLDER=”<enter path>”
INSTALLDIR=”<enter path>\SysTrack” /L*v <enter path to an existing temp folder>\
silentupgradeclient.log (optional)

Upgrade “Pooled System”, default install path, change current POOLDB,


POOLDB_LOGFOLDER, POOLDB_WRITEFOLDER and CONFIGNAME, no logging

Upgrade “Pooled System”, Not default install path, change current POOLDB,
POOLDB_LOGFOLDER, POOLDB_WRITEFOLDER and CONFIGNAME, no logging

Upgrade “Pooled System”, 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
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

4. Parameter Information: Read Command Line Properties


a. All Property names must be UPPERCASE:
i. REBOOT=R: to suppress automatic and certain prompts for system restarts.
ii. REINSTALL=ALL: Required for Reinstall only.
iii. CONFIGNAME=”<EnterConfigurationName>”: to assign a named configuration.
iv. PROXYCONNECTIONHUB=<servername>.<domain>.org : assign name of the
ProxyConnectionHub system (if applicable) <Optional>
v. AUTODETECTPROXY=1 or 0 (default is 0): assign preferred proxy setting:
whether to use autodetect <Optional>
vi. AUTOCONFIGSCRIPT=http://<server>.<domain>.org/test.pac : assign preferred
proxy setting: the address of a *.pac file to get proxy information from
<Optional>
vii. HTTPSPROXY=127.0.0.1:443: assign preferred proxy setting: the address for the
preferred HTTPS proxy <Optional>
viii. POOLDB: Required for “Pooled System” only.
ix. POOLDB_LOGFOLDER: Optional for “Pooled System” only.
x. POOLDB_WRITEFOLDER: Optional for “Pooled System” only.
xi. FORCE: <Required for Upgrades only when command line properties
CONFIGNAME, POOLDB, PROXYCONNECTIONHUB, AUTODETECTPROXY,
AUTOCONFIGSCRIPT, HTTPSPROXY are to be used>
1. FORCE=1: will force the Upgrade process to use both the CONFIGNAME,
POOLDB, POOLDB_LOGFOLDER and POOLDB_WRITEFOLDER property
values to change the currently installed value. Requires values assigned
to CONFIGNAME, POOLDB, POOLDB_LOGFOLDER,
POOLDB_WRITEFOLDER, 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 >

©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

6.9.3 Advanced Installation: golden image based non-persistent “Pooled User”


Important: Prerequisites must be installed before SysTrack Cloud Edition.

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.

1. First-time (Advanced “Pooled User”) installation – SysTrackCloudEdition.msi


• 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 INSTALLDIR if the install path is not default install path (read Command Line Properties)
• Add CONFIGNAME=”<EnterConfigurationName>” to assign a named configuration
otherwise the default value “” will be used.
• Add POOLNAME=”<enter the Pool name>” to assign the Pool name.
• Required to place double quotes around values assigned to INSTALLDIR, CONFIGNAME and
POOLNAME.
• 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.

Msiexec.exe /qn /i “<enter path>\SysTrackCloudEdition.msi” REBOOT=R INSTALLDIR=”<enter


path>\SysTrack” CONFIGNAME=”<EnterConfigurationNameHere>” POOLNAME=”<enter the Pool name
here>” /L*v <enter path to an existing temp folder>\ silentinstallclient.log (optional)

©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):

2. Reinstall (Advanced “Pooled User”) – SysTrackCloudEdition.msi


• Add REINSTALL=ALL to the command line.
• Add REBOOT=R to suppress automatic and certain prompts for system restarts.
• Default values will be used if not set (read Command Line Properties).
• INSTALLDIR property is not valid for a Reinstall.
• Add CONFIGNAME=”<EnterConfigurationName>” to assign a named configuration
otherwise the default value “” will be used.
• Add POOLNAME=”<enter the Pool name>” to assign the Pool name.
• 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.

©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.

Msiexec.exe /qn /i “<enter path>\SysTrackCloudEdition.msi” REINSTALL=ALL REBOOT=R


CONFIGNAME=”<EnterConfigurationNameHere>” POOLNAME=”<enter the Pool name here>” /L*v
<enter path to an existing temp folder>\silentreinstallclient.log (optional)

Reinstall “Pooled User” (no configuration name, no logging):

Reinstall “Pooled User” (no configuration name, with logging, create temp folder):

3. Upgrade (Advanced “Pooled User”) – SysTrackCloudEdition.msi


a. Keep currently installed property settings (CONFIGNAME, POOLNAME,
PROXYCONNECTIONHUB, AUTODETECTPROXY, AUTOCONFIGSCRIPT, HTTPSPROXY)
• FORCE property is not required.
• CONFIGNAME is not required.
• POOLNAME property is not required.
• PROXYCONNECTIONHUB property is not required.
• AUTODETECTPROXY property is not required.
• AUTOCONFIGSCRIPT property is not required.
• HTTPSPROXY property is not required.
• 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).

Msiexec.exe /qn /i “<enter path>\SysTrackCloudEdition.msi” REBOOT=R INSTALLDIR=”<enter


path>\SysTrack” /L*v <enter path to an existing temp folder>\ silentupgradeclient.log (optional)

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)

b. Change currently installed property settings (CONFIGNAME and/or POOLNAME,


PROXYCONNECTIONHUB, AUTODETECTPROXY, AUTOCONFIGSCRIPT, HTTPSPROXY)
• Add FORCE=1 to force the installer to use values assigned to CONFIGNAME,
POOLNAME, PROXYCONNECTIONHUB, AUTODETECTPROXY, AUTOCONFIGSCRIPT,
HTTPSPROXY properties. Requires values assigned to properties or their default
value “” will be used (read Command Line Properties).
• Add CONFIGNAME=”<EnterConfigurationName>” to assign a named configuration.
• Add POOLNAME=”<enter the Pool name>” to assign the Pool name.
• 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, POOLNAME.

Msiexec.exe /qn /i “<enter path>\SysTrackCloudEdition.msi” FORCE=1 REBOOT=R

©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

4. Parameter Information: Read Command Line Properties


a. All Property names must be UPPERCASE:
i. REBOOT=R: to suppress automatic and certain prompts for system restarts.
ii. REINSTALL=ALL: Required for Reinstall only.
iii. CONFIGNAME=”<EnterConfigurationName>”: to assign a named configuration.
iv. PROXYCONNECTIONHUB=<servername>.<domain>.org : assign name of the
ProxyConnectionHub system (if applicable) <Optional>
v. AUTODETECTPROXY=1 or 0 (default is 0): assign preferred proxy setting:
whether to use autodetect <Optional>
vi. AUTOCONFIGSCRIPT=http://<server>.<domain>.org/test.pac : assign preferred
proxy setting: the address of a *.pac file to get proxy information from
<Optional>

©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

7.0 Successful Installation


1. The process will display in Task Manager:
a. LsiAgent.exe (for 32-bit operating systems)
b. LsiAgent.exe*32 (for 64-bit operating systems)
Note: Once listed, the agent is running and collecting data.
2. If you launched the MSI with logging, the LOG file should show something similar to the
following (toward the end):

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

8.0 Failed Installation


A failed installation can occur. If it does, you should find the LOG file helpful in troubleshooting the
problem.

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.

c. Example 2: This is all the information displayed in the log

MSI (s) (78:A0) [09:29:34:328]: Note: 1: 2203 2: c:\sms464\SysTrackCloudEdition.msi 3: -2147287038


MSI (s) (78:A0) [09:29:34:328]: MainEngineThread is returning 2
MSI (c) (A8:DC) [09:29:34:328]: Decrementing counter to disable shutdown. If counter >= 0, shutdown will
be denied. Counter after decrement: -1
MSI (c) (A8:DC) [09:29:34:328]: MainEngineThread is returning 2
=== Verbose logging stopped: 7/9/2019 9:29:34 ===

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.

d. Example 3: Did not install prerequisites before installing SysTrackCloudEdition.msi

MSI (s) (A0:64) [11:34:06:483]: Executing op: ServiceControl(,Name=LsiAgent,Action=1,Wait=1,)


MSI (s) (A0:64) [11:34:36:514]: Product: Systems Management Agent -- Error 1920.Service Systems
Management Agent (LsiAgent) failed to start. Verify that you have sufficient privileges to start system

©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.

9.0 Uninstall Order


Important: Uninstall order is reverse of the Install Order. SysTrack Cloud Edition must be uninstalled
before uninstalling the Microsoft Visual C++ 2015-2019 Redistributable (x86 and x64).

Uninstall Order: (Opposite of the Installation Order)


1st: SysTrackCloudEdition.msi
nd
2 : VC_redist.x86.exe - 32-bit and 64-bit operating systems
rd
3 : VC_redist.x64.exe - 64-bit operating systems only

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”.

10.0 Uninstalling SysTrack through SMS

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)

Uninstall (no logging):

Uninstall (with logging, create temp folder)

©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-

Point to the MSI file, if available:

Msiexec.exe /x “<enter path>\SysTrackCloudEdition.msi” REBOOT=R

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:

i. From registry example:

"C:\ProgramData\Package Cache\{Registry GUID goes here>}\VC_redist.x86.exe" /uninstall /quiet /log


%temp%\vc2019x86_uninstall.log

ii. A successful removal log entry toward the bottom should look like the following:

Creates 3 log files:


vc2019x86_uninstall.log
vc2019x86_uninstall_000_vcRuntimeAdditional_x86.log
vc2019x86_uninstall_001_vcRuntimeMinimum_x86.log

[0C28:03F0][2020-02-20T11:13:47]i007: Exit code: 0x0, restarting: No

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:

i. From registry example:

"C:\ProgramData\Package Cache\{Registry GUID goes here>}\VC_redist.x64.exe" /uninstall /quiet /log


%temp%\vc2019x64_uninstall.log

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

[0C28:03F0][2020-02-20T11:13:47]i007: Exit code: 0x0, restarting: No

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

11.0 Proxy Support for Data Uploads


For any system that will be uploading directly to Cloud Edition servers from a network that requires a
web proxy for external communication, Lakeside Software supports proxies that do not require login
credentials.

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:

(For 64-bit computers):


HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Lakeside Software\LsiAgent\Settings\LanSettings

(For 32-bit computers):


HKEY_LOCAL_MACHINE\SOFTWARE\Lakeside Software\LsiAgent\Settings\LanSettings

Make sure the registry value named ProxyEnable is set to 1 and ProxyServerHttps has the correct URL
and port.

If communication problems persist, or a credentialed proxy is required, please contact support.

©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.

13.0 Where to Go from Here


Technical assistance is available by contacting the Lakeside Software SysTrack Cloud Edition
support email alias at [email protected].

Lakeside Software, Inc.


40950 Woodward Avenue
Bloomfield Hills, Michigan 48304
www.LakesideSoftware.com
+1 248 686 1702 (Americas)
+55 800 878 1210 (Brazil/Latin America)
+44 (0) 1753 260081 (EMEA)
+61 (2) 8413 0944 (ANZ)

©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.

You might also like