Skip to content
Documentation

Agent OEM Versions

CapaSystems develops and maintains the installation program for all OEM agents. Each time a new version of the agent is released, a matching installation program is automatically created, and as a post-build step, the installation program is then transformed into its corresponding OEM version.

It’s possible to transform an existing agent installation program into an OEM installation program, provided that the original installation program is version 3.5 or later. Only CapaSystems is capable of performing this transformation.

The OEM agent installation program delivered by CapaSystems is a Windows Installer (MSI) package.

A number of features distinguishes an OEM version of the agent from the regular one. The icons that can appear in the system tray may be different. The installation controls this by placing new icons in the same folder as the agent executable. Three icon files are required for a full “makeover:”

Icon File Replaces
small.ico Normal mode tray icon, older agent versions (or Normal mode tray icon in newer agent versions)
small_slash.ico No connection tray icon, older agent versions (or No connection tray icon in newer agent versions)
small_exclamation.ico Error tray icon, older agent versions (or Error tray icon in newer agent versions)

Window titles, prompts and about boxes are also changed to show that the agent is an OEM version.

In order to see if a specific instance of the agent is an OEM version, the about box can be inspected, or the name of the executable can be checked using Task Manager or the tasklist command line tool.

The following table sums up important differences between the regular agent and OEM agents:

Value Regular Agent Example: Acme OEM Version
Agent executable GuardAgent.exe Acme_GuardAgent.exe
System tray executable GuardAgentTray.exe Acme_Tray.exe
Agent home directory <PROGRAMFILES>\PerformanceGuard\Agent Defined by the OEM installation program
Windows service name pga Acmepga
Windows service display name PerformanceGuard Agent Acme PerformanceGuard Agent
Agent registry key HKLM\SOFTWARE\PremiTech\E2EAgent HKLM\SOFTWARE\PremiTech\Acme_E2EAgent
Browser helper object IEAgent.dll Acme_IEAgent.dll
IEAgent prompt URI about:ieagent:settings about:Acme-ieagent:settings
IEAgent COM ProgID IEAgent.PGObject Acme_IEAgent.AcmePG_Object
IEAgent COM description CapaSystems PerformanceGuard Helper Acme PerformanceGuard Helper
IEAgent COM UUID {5386FD5D-1D32-4EBD-BB57-867D6E74931B} The Browser Helper Object is a COM component. For OEM versions the unique identifier (GUID) is changed. When the agent is installed a new GUID is generated, this GUID is then stored in the value IEAgentUUID on the OEM agent’s key.