CapaInstaller Utilization Index

Owned by Former user (Deleted)
Sept 07, 2020
3 min read

Web Site

Document

www.performanceguard.dk

CUI PG Agent Reference Manual

Introduction

CapaInstaller Utilization Index (CUI) is a module in CapaInstaller that uses Performance Guard (PG) technology to monitor the resource utilization on all client PC's.

To use the CUI module you must

  1. Acquire a CapaInstaller license for the CUI module
  2. Deploy a "PerformanceGuard" CapaInstaller software package to the clients

What is deployed

The software package deployed to end-user clients will run the script "PerformanceGuard.cis" which will

  1. Install a Performance Guard agent to client PC
  2. Configure the Performance Guard agent to run in standalone mode (without access to a PG server)
  3. Start the Performance Guard Agent

What is configured

The PG agent configuration is located in the Windows registry at the following location:

OS Type

Registry Key Name

32-bit

HKEY_LOCAL_MACHINE\SOFTWARE\Premitech\E2EAgent

64-bit

HKEY_LOCAL_MACHINE\SOFTWARE\Premitech\E2EAgent

The following registry parameter values are set explicitly by the CUI installation script:

Parameter

Value

CMSInterface

CMSMaxFiles=1120
CMSDir=CMS
CMSReportTime=180

Configuration

ReportInterval=60
DynamicMachineReport=true
DiskIOReport=true
ProcessStatInterval=5
ContextSwitchPerProcess=false
ServerMetrics=true
CollectOSStart=true
DoFullStartupReport=false
StartupTimeoutSecs=300
StartupCondition=<PROCESS; Winlogon; started> and <SERVICE; GUARDagent; started; "Performance Guard Agent">
LoginStartCondition=<SESSION; logon>
LoginEndCondition=<PROCESS; GUARDagent; started> and <PROCESS; explorer; started> and <CPU; explorer; below; 10>
CMSEnabled=true
CMSForced=false
GUIMode=NoIcon
UDPReport=false
TCPReport=false
AllowWFICATest=false

ConfigurationId

0

What is measured

The Performance Guard agent will measure information about

  • PC Startup Time (Time of Boot and Duration of Boot Sequence)
  • User Login Time (Time of Login and Duration of Login)
  • Startup Report Ressource usage report for all processes started during the PC boot sequence
  • Utilization Index (a value from 0% to 100%) representing the percentual utilization of CPU, Disk, Network, and Memory resources

Where is the data located

The measured information will be stored in XML-files on the local disk. The file is named PFDatannnnnnnnn.xml where nnnnnnnnn is a timestamp.

The files are being placed here by default:

Client Operation System

Data File Location

Windows XP

C:\Documents and Settings\All Users\Application Data\CMS

Windows Vista

C:\ProgramData\CMS

Windows 7

C:\ProgramData\CMS

Hers's an example XML file: PFData1304352120.xml

Using CUI in a PG environment

When using CUI in a mixed CapaInstaller and PG environment, the PG agents must first be deployed using the /wiki/spaces/pgdoc/pages/8539433518for PG agents. This is because the agents must be configured to use a PG server.

When the PG agents are deployed and connected to the PG server you can roll out the CUI package. When using CUI in a PG environment you may take control over the CMS parameters from the PG web console. If you go to Administration -> Agent -> Configuration and edit an agent configuration you will the following options:




Known Issues

Problem: There's no startup time or login time data available in CMS
Solution: In PG agents prior to version 5.8 there was a bug that caused some clients to fail to measure startup and login. Make sure to upgrade to a CUI package with a newer version of the PG agent.

Problem: Even when using a new PG agent there's still no startup time available in CMS.
Solution: Due to a bug in the CUI installation script you must upgrade to the CUI package available from CMS Service Update 2 - 2011. More specifically the startup condition was never met because the agent was configured to monitor the wrong service name for the PG agent service.

Problem: Startup time shows as 300 seconds in CMS
Solution: Due to a bug in the CUI installation script you must upgrade to the CUI package available from CMS Service Update 2 - 2011. More specifically startup times of 300 seconds (the timeout value) was reported to CMS in all cases where the startup measurement failed. Related to the above issue.