CapaInstaller Utilization Index
Web Site | Document |
|---|---|
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
- Acquire a CapaInstaller license for the CUI module
- 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
- Install a Performance Guard agent to client 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 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.