Install the Desktop Sampler

You need to install the Desktop Sampler on each computer that is to be sampled. This can be a desktop, but also a Terminal Server.
The Desktop Sampler installation file is included in the package that can be downloaded for every release version of Workspace Control.

Installation

  • When you install the Desktop Sampler, it will be installed in the following directory:
    • %ProgramFiles%\Ivanti Workspace Control Desktop Sampler (32-bit)
    • %ProgramFiles(x86)%\Ivanti Workspace Control Desktop Sampler (64-bit)
  • Additionally, a DTSampler key will be added to the following registry key:
    • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run (32-bit)
    • HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Run (64-bit)
  • No shortcuts will be added to the user's Start menu.

Command line

You can install the Desktop Sampler by double-clicking the MSI file or by using a command line. If you use a command line, you can apply the following parameters to the MSI file:

Parameter

Description

SAMPLEPATH=

Specifies the location of the sampled data. This location can also be set in the registry at HKEY_LOCAL_MACHINE\SOFTWARE\RES\Desktop Sampler. If you do not supply a location, the sampled data will be stored in the installation folder of the Desktop Sampler.

EXPIREDAYS=

Specifies the number of days the Desktop Sampler needs to remain installed. After the specified number of days, the Desktop Sampler will uninstall itself. If this parameter is not used, the Desktop Sampler will continue to run until it is manually uninstalled.

DELAY=

Specifies the number in seconds the desktop sampler should wait after a user logs on before it starts sampling data. This is useful when logon procedures take a long time. Specify a number in seconds. By default, the desktop sampler waits for 30 seconds.

NOICONS

Specifies that no icons will be saved to the desktop sampler files.

ALLICONS

Specifies that 256-color and 16-color icons will be saved to the desktop sampler files.

256ICONS

Specifies that only 256-color icons will be saved to the desktop sampler files.

Example: msiexec.exe /i "C:\INSTALL\Ivanti Workspace Control Desktop Sampler [version].msi" SAMPLEPATH=\\fileserver\SampleData EXPIREDAYS=30 DELAY=120 /q

Command-line parameters are case insensitive.

After installation, the Desktop Sampler will sample which applications, printers and data are used by which users at which locations, irrespective of the way in which these settings are managed (manually, scripting, Workspace Control, etc.). It stores this information as a Workspace Control sample file (.dts). The Workspace Designer uses these files to analyze the sampled information.

All command-line parameters can also be used directly when invoking dtsampler.exe. For example, after the Desktop Sampler is installed it is also possible to start dtsampler.exe with the /SAMPLEPATH parameter specifying the path of the generated sample files. This allows the Desktop Sampler also to be distributed as a Custom Resource. This /SAMPLEPATH parameter overrules a possible SAMPLEPATH parameter used when installing the MSI.

Example:

C:\Program Files\Ivanti Workspace Control Desktop Sampler\dtsampler.exe /SAMPLEPATH="C:\Temp"