Installing the Screenshot Storage Optimizer

ITM On-Prem can store sessions with full video recording in the file system or in the SQL database. Archiving full sessions with many screenshots takes up processor time and bandwidth.

The ITM On-Prem Screenshot Storage Optimizer is the component moving screen capture data from the ITM On-Prem Hot Storage to the Warm Storage. This component is installed on each ITM On-Prem (ObserveIT) Application Server machine, with each ITM On-Prem (ObserveIT) Application Server machine having a dedicated Hot Storage volume attached to it.

The required SSD grade for the hot storage is a fast Mixed Use (MU).

After installation, the Screenshots Storage Optimizer must be configured.

The Screenshots Storage Optimizer can be installed anywhere on the same domain as the ITM On-Prem (ObserveIT) Application server and Web Console. It must have access to the “Hot” and “Warm” storage folders. More specifically, we recommended installing it directly to the SSD-based "Hot" storage drive where the "Hot" storage folder is configured.

Installing the Screenshot Optimizer with Powershell

You can use the following PowerShell commands to install the Screenshot Optimizer. (This is the recommended procedure.) 

Optionally, you can use the manual procedure, see Installing the Screenshot Storage Optimizer (Manual).

Prerequisites:

For each ITM On-Prem (ObserveIT) Application server in your environment, do the following:

  1. Log into the ITM On-Prem (ObserveIT) Web Console and select Management Console.

  2. Select the Configuration tab.

  3. Select Settings > Service Settings. Click Download. This will download a configuration file.

  4. Copy the configuration file – settings.json – to the server that will host the Screenshot Storage Optimizer component. Place the file into c:\temp, making the full path to the file c:\temp\settings.json.

  5. Connect (with RDP) to the ITM On-Prem screen capture data store server as the Active Directory Service Account.

  6. Download the ITM On-Prem installer into c:\temp and extract the contents. (See Downloading the Latest Version.)

    (Assume the installer files are extracted to c:\temp\ObserveIT_Setup_vx.xx.y.yy path, where x.xx the major ITM On-Prem (ObserveIT) version, and y.yy is the minor version and build.)

  7. Run PowerShell as Administrator.

  8. From the table below, copy the rows from Command column, replacing the values as applicable. The Description column indicates which values you will need to replace.

    Paste the Commands into the PowerShell window.

    Command Values to Replace
    $observeitInstallerPath = "c:\temp\ObserveIT_Setup_vx.xx.y.yy" Replace the generalized path with the correct path for your ITM On-Prem installer. For example: C:\temp\ObserveIT_Setup_v7.11.0.25
    $Creds = Get-Credential  
    $WebConsoleFQDN = "<# FQDN #>" Replace the commented section with FQDN of the server hosting the ITM On-Prem (ObserveIT) Web Console component
    $AppServerFQDN = "<# FQDN #>" Replace the commented section with FQDN of the server hosting the ITM On-Prem (ObserveIT) Application Server component. If you are using more than a single Application server, specify the FQDN of the load balancer in front of the Application servers
    $WebSiteProtocol = "https"  
    $WebSitePort = "443"  
    $AppServerConnectionPort = "https"  

    $WEBCONSOLEURL = $ WebSiteProtocol + '://' + $WebConsoleFQDN + ':' + $ WebSitePort + '/ObserveIT

    		 
    $APPSERVERURL = $AppServerConnectionProtocol + '://' + $AppServerFQDN + ':' + $AppServerConnectionPort + '/ObserveitApplicationServer'  
    $PRECONFIGPATH = "c:\temp\settings.json"  
    $gmsaUser="1" Optional for gMSA account

  9. $ComponentInstallArguments = "/i", ($observeitInstallerPath + '\ScreenshotsStorageOptimizer\ScreenshotsStorageOptimizer.msi'), "/qb", "/norestart", "PRECONFIGPATH=c:\temp\settings.json", "DATABASE_LOGON_TYPE=WindowsAccount", "SERVICE_USERNAME=$($Creds.GetNetworkCredential().Domain + '\' + $Creds.GetNetworkCredential().UserName)", "SERVICE_PASSWORD=$($Creds.GetNetworkCredential().Password)","/leo", ".\ScreenshotStorageOptimizer.log"

    For gMSA user (recommended): 

    $ComponentInstallArguments = "/i", ($observeitInstallerPath + '\ScreenshotsStorageOptimizer\ScreenshotsStorageOptimizer.msi'), "/qb", "/norestart", "PRECONFIGPATH=c:\temp\settings.json", "DATABASE_LOGON_TYPE=WindowsAccount", "SERVICE_USERNAME=$($Creds.GetNetworkCredential().Domain + '\' + $Creds.GetNetworkCredential().UserName)", "GMSA_USER=$gmsaUser","/leo", ".\ScreenshotStorageOptimizer.log"

     

    Start-Process msiexec.exe -ArgumentList $ComponentInstallArguments -Wait -NoNewWindow

Installing the Screenshot Storage Optimizer (Manual)

  1. Navigate to the ITM On-Prem (ObserveIT) Web Console(from your Internet broowser), for example https:// OITsrv1/ITM On-Prem.

  2. When prompted by the ITM On-Prem Web Console, set up the password for the build-in admin user.

  3. From License File, click Choose File and select your ITM On-Prem (ObserveIT) license. Click Activate.

  4. In the ITM On-Prem Web Console, select Management Console > Configuration and select Settings > Service Settings on the left.

  5. Click the Download button for the Screenshot Storage Optimizer service.

  6. Save the file to the ITM On-Prem (ObserveIT) Console server.

  7. Connect to the Web Console machine, where you downloaded and extracted the ITM On-Prem (ObserveIT) Installer .

  8. Make sure to Run as administrator.

  9. Navigate to ObserveIT_Setup_v.xx > Screenshots Storage Optimizer folder and click ScreenshotsStorageOptimizer installer. Follow the Wizard. When prompted to provide the configuration, make sure to use the file saved in Step 6.

Related Topics:

Configuring Service Settings

Configure Screen Capture Data Storage

Custom Installation Steps