Skip to content

Latest commit

 

History

History
71 lines (45 loc) · 4.99 KB

WINDOWS_HOWTO.md

File metadata and controls

71 lines (45 loc) · 4.99 KB

COMPILATION AND INSTALLATION OF UTILITIES

For support of systems with more than 64 logical cores you need to compile all binaries below in “x64” platform mode (not the default “Win32” mode).

Command-line utility:

  1. Compile the windows MSR driver (msr.sys) with Windows DDK Kit (see the sources in the WinMSRDriver directory). For Windows 7 and later versions you have to sign the msr.sys driver additionally (http://msdn.microsoft.com/en-us/library/ms537361(VS.85).aspx). To enable loading test signed drivers on the system: in administrator cmd console run bcdedit /set testsigning on and reboot).

  2. Build the pcm.exe utility:

    cmake -B build
    cmake --build build --config Release --parallel
    

    alternatively you can perform cmake -B build, open PCM.sln form build folder in and build required project in Visual Studio. .exe and .dll files will be located in build\bin\Release folder

  3. Copy the msr.sys driver and pcm.exe into a single directory

  4. Run pcm.exe utility from this directory

For Windows 7 and Windows Server 2008 R2 the PCM utilities need to be run as administrator:

Alternatively you can achieve the same using the “Properties” Windows menu of the executable (“Privilege level” setting in the “Compatibility” tab): Right mouse click -> Properties -> Compatibility -> Privilege level -> Set “Run this program as an administrator”.

Screenshot

If you are getting the error Starting MSR service failed with error 3 The system cannot find the path specified. try to uninstall the driver by running pcm --uninstallDriver and optionally reboot the system.

Graphical Perfmon front end:

  1. Compile the windows MSR driver (msr.sys) with Windows DDK Kit (see the sources in the WinMSRDriver directory). For Windows 7 and later versions you have to sign the msr.sys driver additionally (http://msdn.microsoft.com/en-us/library/ms537361(VS.85).aspx).

  2. Copy msr.sys into the c:\windows\system32 directory

  3. Build pcm-lib.dll using Microsoft Visual Studio or cmake

  4. Build 'PCM-Service.exe' using Microsoft Visual Studio or cmake

  5. Copy PCM-Service.exe, PCM-Service.exe.config, and pcm-lib.dll files into a single directory

The config file enables support for legacy security policy. Without this configuration switch, you will get an exception like this:

Unhandled Exception: System.NotSupportedException: This method implicitly uses CAS policy, which has been obsoleted by the .NET Framework.

  1. With administrator rights execute '"PCM-Service.exe" -Install' from this directory

  2. With administrator rights execute 'net start pcmservice'

  3. Start perfmon and find new PCM* counters

If you do not want or cannot compile the msr.sys driver you might use a third-party open source WinRing0 driver instead. Instructions:

  1. Download the free RealTemp utility package from http://www.techpowerup.com/realtemp/ or any other free utility that uses the open-source WinRing0 driver (like OpenHardwareMonitor http://code.google.com/p/open-hardware-monitor/downloads/list).
  2. Copy WinRing0.dll, WinRing0.sys, WinRing0x64.dll, WinRing0x64.sys files from there into the PCM.exe binary location, into the PCM-Service.exe location and into c:\windows\system32
  3. Run the PCM.exe tool and/or go to step 6 (perfmon utility).

Known limitations:

Running PCM.exe under Cygwin shell is possible, but due to incompatibilities of signals/events handling between Windows and Cygwin, the PCM may not cleanup PMU configuration after Ctrl+C or Ctrl+Break pressed. The subsequent run of PCM will require to do PMU configuration reset, so adding -r command line option to PCM will be required.

PCM-Service FAQ: Q: Help my service wont start, what can I do to diagnose the problem? A: Please check in the Windows Application "Event Viewer" under "Windows Logs" and then under "Application". PCM-Service writes its messages here, just look for errors. If you can't figure it out how to fix it, create a bug report and make sure to paste the text from the Event Viewer in the bug report so we can diagnose the issue.

Q: I see a message in the Events Viewer that PCM-Service does not start because the "custom counter file view is out of memory", how do I fix this? A: Despite that PCM-Service is reserving more memory than the standard 512kB this error can still occur if there is another application that uses performance counters is initialized before PCM. There are two options:

  1. identify the application or service that starts before PCM-Service and stop or disable it and consequently reboot and try again
  2. find your machine.config file and add `<system.diagnostics>
` to that file