CapaInstaller Utilization Index
Web Site | Document |
|---|---|
Introduction
CapaInstaller Utilization Index (CUI) is a module in CapaInstaller that uses Performance Guard (PG) technology to monitor resource utilization on all client PCs.
To use the CUI module, you must
Acquire a CapaInstaller license for the CUI module
Deploy a "PerformanceGuard" CapaInstaller software package to the clients
Read more about Getting started with Performance Guard integration to CapaInstaller
What is deployed
The software package deployed to end-user clients will run the script "PerformanceGuard.cis" which will
Install a Performance Guard agent to the client's PC
Configure the Performance Guard agent to run in standalone mode (without access to a PG server)
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 |
Configuration | ReportInterval=60 |
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 Resource 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 |
Here's an example XML file:
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 Install PerformanceGuard Agents for PG agents. This is because the agents must be configured to use a PG server.
You can roll out the CUI package when the PG agents are deployed and connected to the PG server. When using CUI in a PG environment, you may take control of the CMS parameters from the PG web console. If you go to Administration -> Agent -> Configuration and edit an agent configuration, you will see the following options:
Known Issues
Problem: There's no startup time or login time data available in CMS
Solution: A bug in PG agents before version 5.8 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) were reported to CMS in all cases where the startup measurement failed—related to the above issue.