Installing SysTrack Agent for CachedMode

    Wednesday, August 2, 2023In: How To Print
    Agent Install MethodUse Case
    PooledUserStateless VDI with no persistent storage
    PoolDBPersistent system name and storage, e.g. Citrix XenApp server with D: drive
    CachedModeSingle or Multiuser Windows 10/11 with no persistent storage, e.g. AVD multi-session


    BEFORE BEGINNING THE STEPS BELOW make sure all the pre-requisites are in place and best practise advise has been followed from Lakeside. The correct agent installation method and best practise guidelines are critical for the successful deployment of SysTrack into an environment.

    This document does NOT cover the fourth ‘standard’ installation method that is typically used for physical desktops and laptops, persistent VDI and general servers. Please follow the appropriate documentation for that process.

    Installation Process

    1. Copy the following to the golden image, from the cloud tenant agent download:  
    • SysTrackCloudEdition.msi   
    • vcredist_x86.exe and vcredist_x64.exe  
    1. Install the following pre-requisites via command prompt (they can also be installed manually by double clicking):  
    • vcredist_x86.exe /q /norestart /log c:\temp\VCx86.log  
    • vcredist_x64.exe /q /norestart /log c:\temp\VCx64.log  
    1. For the SysTrackCloudEdition.msi, run the following command through the command prompt or batch file.  
    **NOTE: Make sure you edit the pathname of the .msi & language to match your environment. Also, do not copy and paste the string as special characters, such as double quotes, cannot be copied over and distort some commands.  
    Agent Install MethodInstallation Command Line Examples
    (Please adjust according to the environment)
    PooledUser
    • **NOTE: Make sure you edit the pathname of the .msi and VDI POOLNAME to match your environment.
    • Msiexec.exe /qn /i "<enter path>\SysTrackCloudEdition.msi" REBOOT=R POOLNAME="<enter the Pool name here>"
    PoolDB
    • Assumptions:
    • Persistent cache drive on D:\   (can be adjusted accordingly)
    • Local OS on C:\
    • **NOTE: The POOLDB command is the path to the persistent drive location where you want the database to be stored. This is critical as incorrect mapping of this command could lead to agent or data instability (Keep the %SYSTEMNAME% variable as it is to avoid duplication)
    • Msiexec.exe /qn /i "<enter path>\SysTrackCloudEdition.msi" ALLUSERS=1 REBOOT=R POOLDB="D:\SysTrackDB\%SYSTEMNAME%\"
    CachedMode
    • Msiexec.exe /qn /i "<enter path>\SysTrackCloudEdition.msi" REBOOT=R LANGUAGE=EN CACHEDMODE=1  
    1. Once installed, verify the following is set correctly in the registry:
    • PoolDB OR PoolName entries only exists for their respective install methods
    • CachedMode is set to 1 only exists for CachedMode method
    • PooledParentSystem is FQDN of the golden image system name 
    • v9.9+; RunOnParent is 0  
    1. Clean up the Golden Image:  
    • Stop the Systems Management Agent service  
    • Delete existing log files in all of the folders: 
      • C:\Program Files (x86)\SysTrack\LsiAgent\*.log  
      • C:\Program Files\SysTrack\LsiAgent\*.log  
    • Delete existing database files in all/any of the folders:  
      • 64bit: C:\Program Files (x86)\SysTrack\LsiAgent\MDB\collect.*  
      • 32bit: C:\Program Files\SysTrack\LsiAgent\MDB\collect.*  
      • D:\SysTrackDB\%SYSTEMNAME%\    (for PoolDB method delete the entire folder %SYSTEMNAME% and contents)
    • Browse to HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Lakeside Software\Deploy and ensure the SystemName string value is empty. (If not, remove the data but keep the value so it is blank.)  
    • Browse to HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Lakeside Software\Deploy and ensure the PooledParentSystem value matches the name of the golden image system used to install the agent.  
    • Delete all values inside of the “Lakeside Software\LsiAgent\Settings” Key. 
      • 64bit:  HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Lakeside Software\LsiAgent\Settings\ 
      • 32bit:  HKEY_LOCAL_MACHINE\SOFTWARE\Lakeside Software\LsiAgent\Settings\ 
    • If installing on an on-prem SysTrack environment:  Delete all Sub-Keys located inside of the Settings Registry key at: 
      • 64bit:  HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Lakeside Software\LsiAgent\Settings\ 
      • 32bit:  HKEY_LOCAL_MACHINE\SOFTWARE\Lakeside Software\LsiAgent\Settings\ 
    • If installing on a cloud SysTrack environment:  Delete all Sub-Keys located inside of the Settings Registry key except for the LsiWebCom Sub-Key. 
      • 64bit:  HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Lakeside Software\LsiAgent\Settings\ 
      • 32bit:  HKEY_LOCAL_MACHINE\SOFTWARE\\Lakeside Software\LsiAgent\Settings\ 
    • Ensure the Systems Management Agent service & Systems Management Supervisor service are both STOPPED and NOT running  

    6.  The image may be re-sealed and used to provision new systems

    Change Log

    DateInitialsDocument
    Version    		Change
    18th July 2023SDS0.2Removed LocalDB installation as all installations replaced with SQLite as the default local agent database
    18th July 2023SDS0.2Consolidated all three virtual system agent installation methods into one document, now that all use SQLite the process is much more similar


    « Previous ArticleNext Article »


    4.0 (5)



    Looking for Something?
    Tags
    PLEASE LOG IN TO ACCESS SUPPORT CASES AND CERTIFICATIONS

    Contact your Lakeside Customer Success Team or customergateway@lakesidesoftware.com to request an account

    HomeSolutionsEducationProduct LibraryResourcesClassroomSupport
    Privacy & Security StatementTerms & Conditions
    Copyright © 2023 by Lakeside Software, LLC - All rights reserved.