Docs Image

[EUC Score Toolset Documentation Start Page]

EUC Score Toolset Installation

Download the ZIP archives that include the EUC Score installer packages from the EUC Score download page and store them in a local folder. Please note that the download page is password-protected.

Base Installation Package

The initial EUC Score Toolset deployment sequence starts with extracting the base installation package from Install-EUCScoreBase.zip. By double-click in Windows Explorer or from the command line, run the Install-EUCScoreBase.exe installation wizard on each target system. The installation package contains simple primary Simloads, simple Personas, all score Simloads, the Simload Runner, data files, scripts, and supplementary tools. Only this base installation wizard shows a text input field for selecting the local installation path.

Installation steps in the wizard:

  1. Select install mode: For the current user only or for all users. Only the second option requires administrative privileges. Depending on the selection, EUC Score configuration settings are stored in HKEY_CURRENT_USER (= HKCU) or HKEY_LOCAL MACHINE (= HKLM) in the Windows registry.
  2. Accept the EUC Score Subscription Agreement.
  3. Select destination location in the local file system. The default path is C:\EUCScore.
  4. Select the components you want to install or clear the components you do not want to install.
  5. Review your selections and click the Install button to continue.
  6. Installation - extracting and copying files...
  7. Click the Finish button to exit setup. Optionally read the EUC Score readme file.
  8. Launch Simload Runner and run a Simload.

Enterprise Installation Package

After the base package was installed, the next optional step is the deployment of the enterprise installation package. By double-click in Windows Explorer or from the command line, run the Install-EUCScoreEnterprise.exe installation wizard on each target system. The most important installation step is the selection of the components you want to install.

This installer checks if the registry value Software\EUCScore\Folders\InstallPath exists in HKLM or HKCU, and aborts if it does not. If the value exists, it holds the target root folder where EUC Score files and folders are copied to during the installation.

IMPORTANT: All Simloads included in the enterprise package require a valid maintenance license (= a properly sealed Tools\Registration.ini file that is not expired).

Files and Folders

After a successfull installation of the EUC Score Toolset, the following files and folders were created in the local file system of the target system:

  • Readme files and release notes are in the installation destination root folder, typically C:\EUCScore.
  • The Tools subfolder includes EUC Score tools, such as Simload Runner and Avatar including Telemetry Collector. Additional tools are described in the Supplementary Tools page.
  • The Simloads subfolder includes all Simload executables and the associated .ini files to overwrite each Simload's default settings. A Simload.ini file contains all Simload settings.
  • The Data subfolder includes different types of data files opened by Simloads - documents, HTML files, images and videos. This is the common data path.
  • The Results subfolder is the destination where all log and result files go when running a Simload or a script.
  • The Scripts subfolder includes PowerShell and CMD scripts you can run from the command line or from the Avatar Console.
  • The SyncPlayer subfolder includes the Sync Player templates, libraries, examples, and build automation PowerShell scripts.

Simload Registration

Each Simload that was deployed by an EUC Score installer package is registered in the Windows registry. The registry key HKCU\Software\EUCScore\Simloads or HKLM\Software\EUCScore\Simloads contains a REG_SZ value with the full executable path for each Simload. The location in the registry is defined by the installation mode which can be per user (= HKCU) or per machine (= HKLM), where the later requires administrative privileges. This registration mechanism allows any script or tool to launch a Simload from the correct folder.

The registry key HKCU\Software\EUCScore (per user installation) or HKLM\Software\EUCScore (per machine installation) contains a range of subkeys with settings. For details, see the table below.

Subkey Value Name Description
Folders
InstallPath [SZ] EUC Score root installation path (default: C:\EUCScore).
Data [SZ] Folder that contains the common data subfolders for documents, HTML files, images and videos.
Results [SZ] Target folder for results and log files.
SimLoads [SZ] Folder that contains the subfolders with each simload executable and .ini file.
Tools [SZ] Folder that contains EUC Score tools
Simloads
SL0-... [SZ] Registered Type 0 Simload = System / Test / Prototype.
SL1-... [SZ] Registered Type 1 Simload = Single Application.
SL2-... [SZ] Registered Type 2 Simload = Multiple Apps / Persona.
SL3-... [SZ] Registered Type 3 Simload = Score.
Settings
iCountdownScreen [DWORD] Sets the initial number of seconds in the countdown screen. The default value is 1, but when recording the Simload screen output with a frame grabber, there may be situations when it's better to change this value.
bLogVerbose [DWORD] If set to 1, INFO and WARNING messages are added the log file located in the Results folder. NOTE: Verbose mode may influence the runtime behavior of a Simload. Do not use it during real test runs.
bDebug [DWORD] If set to 1, DEBUG messages are added to the log file located in the Results folder. NOTE: Debug mode may influence the runtime behavior of a Simload. Do not use it during real test runs.
bShowControl [DWORD] If set to 1, Simload controls are displayed on the screen (such as the type 2 Simload exit button).

 

NOTE: A Simload can also be launched when it is not registered. In this case, it tries to find the necessary global configuration settings (such as folder locations or countdown settings) in the registry under HKCU\Software\EUCScore. If this fails, it reads the required values from the side-by-side .ini file that must have the same name as the Simload .exe file. This allows a copy-and-paste deployment into a user session in cases where the required privileges for deploying an installer package are not available.

Log Files

Each Simload writes into a log file named Simload_<ComputerName>_<UserName>.log, located in the Results folder (typically C:\EUCScore\Results). With default settings, only system and error messages are sent to the log file. By setting the bLogVerbose registry value in Software\EUCScore\Settings in HKCU or HKLM to 1, also warning and info messages go to the log file. By setting the bDebug registry value in Software\EUCScore\Settings to 1, also debug messages go to the log file.