From ab09473be95dd632f671e866eb22a208e670f513 Mon Sep 17 00:00:00 2001 From: "Dementiev, Roman" Date: Tue, 17 Oct 2023 11:40:53 +0200 Subject: [PATCH] update windows-related documentation Change-Id: I298b3a17f3f0e03c5017b194867d97b3a6cbb5d9 --- README.md | 4 ++-- doc/WINDOWS_HOWTO.md | 10 +++++----- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index b3c3617a..76a148d4 100644 --- a/README.md +++ b/README.md @@ -87,7 +87,7 @@ Debug is default on Windows. Specify config to build Release: ``` cmake --build . --config Release ``` -On Windows and MacOs additional drivers are required. Please find instructions here: [WINDOWS_HOWTO.md](doc/WINDOWS_HOWTO.md) and [MAC_HOWTO.txt](doc/MAC_HOWTO.txt). +On Windows and MacOs additional drivers and steps are required. Please find instructions here: [WINDOWS_HOWTO.md](doc/WINDOWS_HOWTO.md) and [MAC_HOWTO.txt](doc/MAC_HOWTO.txt). FreeBSD/DragonFlyBSD-specific details can be found in [FREEBSD_HOWTO.txt](doc/FREEBSD_HOWTO.txt) @@ -103,7 +103,7 @@ Downloading Pre-Compiled PCM Tools * RHEL8.5 or later: `sudo dnf install pcm` * Fedora: `sudo yum install pcm` * RPMs and DEBs with the *latest* PCM version for RHEL/SLE/Ubuntu/Debian/openSUSE/etc distributions (binary and source) are available [here](https://software.opensuse.org/download/package?package=pcm&project=home%3Aopcm) -- Windows: download PCM binaries as [appveyor build service](https://ci.appveyor.com/project/opcm/pcm/history) artifacts and required Visual C++ Redistributable from [www.microsoft.com](https://www.microsoft.com/en-us/download/details.aspx?id=48145). Additional drivers are needed, see [WINDOWS_HOWTO.md](doc/WINDOWS_HOWTO.md). +- Windows: download PCM binaries as [appveyor build service](https://ci.appveyor.com/project/opcm/pcm/history) artifacts and required Visual C++ Redistributable from [www.microsoft.com](https://www.microsoft.com/en-us/download/details.aspx?id=48145). Additional steps and drivers are required, see [WINDOWS_HOWTO.md](doc/WINDOWS_HOWTO.md). - Docker: see [instructions on how to use pcm-sensor-server pre-compiled container from docker hub](doc/DOCKER_README.md). -------------------------------------------------------------------------------- diff --git a/doc/WINDOWS_HOWTO.md b/doc/WINDOWS_HOWTO.md index 83fe9fd5..1ac274ca 100644 --- a/doc/WINDOWS_HOWTO.md +++ b/doc/WINDOWS_HOWTO.md @@ -13,11 +13,11 @@ _For support of systems with more than _**_64_**_ logical cores you need to comp ``` 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 +3. As Administrator create PCM directory in Windows "Program Files" directory (e.g. `C:\Program Files (x86)\PCM\`) +4. As Administrator copy the msr.sys driver and pcm.exe into the PCM directory +5. Run pcm.exe utility from the PCM directory as Administrator -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: +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”. @@ -35,7 +35,7 @@ If you are getting the error `Starting MSR service failed with error 3 The syste 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 +5. Copy PCM-Service.exe, PCM-Service.exe.config, and pcm-lib.dll files into the PCM sub-directory in Windows "Program Files" directory (see above) The config file enables support for legacy security policy. Without this configuration switch, you will get an exception like this: