Skip to content

Commit 99e8d22

Browse files
authored
Merge pull request #1592 from jasonrandrews/tool-installs
Update WindowsPerf install guide for version 4.0.0
2 parents d117234 + b0411ca commit 99e8d22

File tree

3 files changed

+23
-24
lines changed

3 files changed

+23
-24
lines changed

content/install-guides/windows-perf-vs-extension.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ cascade:
88

99
minutes_to_complete: 10
1010

11-
official_docs: https://github.com/arm-developer-tools/windowsperf-vs-extension
11+
official_docs: https://gitlab.com/Linaro/WindowsPerf/vs-extension
1212

1313
author: Nader Zouaoui
1414

@@ -71,11 +71,11 @@ To install the WindowsPerf Visual Studio Extension from Visual Studio:
7171

7272
![WindowsPerf install page #center](/install_guides/_images/wperf-vs-extension-install-page.png)
7373

74-
### Installation from GitHub
74+
### Installation from GitLab
7575

76-
You can also install the WindowsPerf Visual Studio Extension from GitHub.
76+
You can also install the WindowsPerf Visual Studio Extension from GitLab.
7777

78-
Download the installation file directly from the [GitHub release page](https://github.com/arm-developer-tools/windowsperf-vs-extension/releases).
78+
Download the installation file directly from the [release page](https://gitlab.com/Linaro/WindowsPerf/vs-extension/-/releases).
7979

8080
Unzip the downloaded file and double click on the `WindowsPerfGUI.vsix` file.
8181

@@ -85,7 +85,7 @@ Make sure that any previous version of the extension is uninstalled and that Vis
8585

8686
### Build from source
8787

88-
To build the source code, clone [the repository](https://github.com/arm-developer-tools/windowsperf-vs-extension) and build the `WindowsPerfGUI` solution using the default configuration in Visual Studio.
88+
To build the source code, clone [the repository](https://gitlab.com/Linaro/WindowsPerf/vs-extension.git) and build the `WindowsPerfGUI` solution using the default configuration in Visual Studio.
8989

9090
Building the source is not required, but offered as an alternative installation method if you want to customize the extension.
9191

content/install-guides/windows-perf-wpa-plugin.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Windows Performance Analyzer (WPA) plugin
33

44
minutes_to_complete: 15
55

6-
official_docs: https://github.com/arm-developer-tools/windowsperf-wpa-plugin
6+
official_docs: https://gitlab.com/Linaro/WindowsPerf/wpa-plugin
77

88
author: Alaaeddine Chakroun
99

@@ -83,14 +83,14 @@ Close Windows Performance Analyzer.
8383

8484
You are now ready to install the WPA plugin, which is a single `.dll` file.
8585

86-
Download the `.zip` file from the [Windows Perf WPA plugin GitHub releases page](https://github.com/arm-developer-tools/windowsperf-wpa-plugin/releases) on GitHub.
86+
Download the `.zip` file from the [Windows Perf WPA plugin releases page](https://gitlab.com/Linaro/WindowsPerf/wpa-plugin/-/releases).
8787

8888
Alternatively, you can download the `.zip` file from a command prompt:
8989

9090
```console
9191
mkdir wpa-plugin
9292
cd wpa-plugin
93-
curl -L -O https://github.com/arm-developer-tools/windowsperf-wpa-plugin/releases/download/1.0.3/wpa-plugin-1.0.3.zip
93+
curl -L -O https://gitlab.com/api/v4/projects/50944937/packages/generic/wperf-wpa-plugin/1.0.3/wpa-plugin-1.0.3.zip
9494
```
9595

9696
Extract the `.dll` file from the downloaded `.zip` file.
@@ -140,4 +140,3 @@ wpa -addsearchdir %USERPROFILE%\Downloads\wpa-plugin-1.0.3 -i %USERPROFILE%\Down
140140
## How do I uninstall the WPA plugin?
141141

142142
To uninstall the plugin, simply delete the `WPAPlugin.dll` file.
143-

content/install-guides/wperf.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ additional_search_terms:
1818
minutes_to_complete: 15
1919

2020
### Link to official documentation
21-
official_docs: https://github.com/arm-developer-tools/windowsperf/blob/main/INSTALL.md
21+
official_docs: https://gitlab.com/Linaro/WindowsPerf/windowsperf/blob/main/INSTALL.md
2222

2323
author: Jason Andrews
2424

@@ -30,7 +30,7 @@ multitool_install_part: false # Set to true if a sub-page of a multi-page arti
3030
layout: installtoolsall # DO NOT MODIFY. Always true for tool install articles
3131
---
3232

33-
WindowsPerf is a Linux Perf-inspired Windows on Arm performance profiling tool. Profiling is based on the Arm AArch64 PMU and its hardware counters. WindowsPerf supports the counting model for obtaining aggregate counts of occurrences of PMU events, and the sampling model for determining the frequencies of event occurrences produced by program locations at the function, basic block, and instruction levels. WindowsPerf is an open-source project hosted on [GitHub](https://github.com/arm-developer-tools/windowsperf).
33+
WindowsPerf is a Linux Perf-inspired Windows on Arm performance profiling tool. Profiling is based on the Arm AArch64 PMU and its hardware counters. WindowsPerf supports the counting model for obtaining aggregate counts of occurrences of PMU events, and the sampling model for determining the frequencies of event occurrences produced by program locations at the function, basic block, and instruction levels. WindowsPerf is an open-source project hosted on [GitLab](https://gitlab.com/Linaro/WindowsPerf/windowsperf/)
3434

3535
WindowsPerf consists of a kernel-mode driver and a user-space command-line tool. You can seamlessly integrate the WindowsPerf command line tool with both the [WindowsPerf Visual Studio Extension](#vs2022) and the [WindowsPerf VS Code Extension](#vscode). These extensions, which you can download from the Visual Studio Marketplace, enhance the functionality of WindowsPerf by providing a user-friendly interface, and additional features for performance analysis and debugging. This integration allows developers to efficiently analyze and optimize their applications directly within their preferred development environment.
3636

@@ -49,30 +49,30 @@ See also the [Visual Studio for Windows on Arm install guide](/install-guides/vs
4949

5050
## Download WindowsPerf
5151

52-
You can download the latest release package, `windowsperf-bin-<version>.zip` from the Arm GitHub repository:
52+
You can download the latest release package, `windowsperf-bin-<version>.zip` from the Linaro GitLab repository:
5353
```url
54-
https://github.com/arm-developer-tools/windowsperf/releases
54+
https://gitlab.com/Linaro/WindowsPerf/windowsperf/-/releases
5555
```
5656

5757
To download directly from command prompt, use:
5858

5959
```console
60-
mkdir windowsperf-bin-3.8.0
61-
cd windowsperf-bin-3.8.0
62-
curl -L -O https://github.com/arm-developer-tools/windowsperf/releases/download/3.8.0/windowsperf-bin-3.8.0.zip
60+
mkdir windowsperf-bin-4.0.0
61+
cd windowsperf-bin-4.0.0
62+
curl -L -O https://gitlab.com/api/v4/projects/40381146/packages/generic/windowsperf/4.0.0/windowsperf-bin-4.0.0.zip
6363
```
6464

6565
Unzip the package:
6666

6767
```console
68-
tar -xmf windowsperf-bin-3.8.0.zip
68+
tar -xmf windowsperf-bin-4.0.0.zip
6969
```
7070

7171
## Install wperf driver
7272

7373
You can install the kernel driver using the supplied `wperf-devgen` installer.
7474

75-
The [wperf-devgen](https://github.com/arm-developer-tools/windowsperf/blob/main/wperf-devgen/README.md) tool has been designated as the preferred installer and uninstaller for the WindowsPerf Kernel Driver in the latest release. This tool offers a simple process for managing the installation and removal of the driver.
75+
The [wperf-devgen](https://gitlab.com/Linaro/WindowsPerf/windowsperf/-/tree/main/wperf-devgen/README.md) tool has been designated as the preferred installer and uninstaller for the WindowsPerf Kernel Driver in the latest release. This tool offers a simple process for managing the installation and removal of the driver.
7676

7777
{{% notice Note%}}
7878
You must install the driver as `Administrator`.
@@ -83,7 +83,7 @@ Open a **Windows Command Prompt** terminal with **Run as administrator** selecte
8383
Make sure you are in the `windowsperf-bin-<version>` directory:
8484

8585
```command
86-
cd windowsperf-bin-3.8.0
86+
cd windowsperf-bin-4.0.0
8787
```
8888

8989
### Install with wperf-devgen {#devgen_install}
@@ -123,8 +123,8 @@ You see output similar to:
123123
```output
124124
Component Version GitVer FeatureString
125125
========= ======= ====== =============
126-
wperf 3.8.0 6d15ddfc +etw-app
127-
wperf-driver 3.8.0 6d15ddfc +etw-drv
126+
wperf 4.0.0 b18197bd +etw-app
127+
wperf-driver 4.0.0 b18197bd +etw-drv
128128
129129
```
130130
## Uninstall wperf driver
@@ -138,7 +138,7 @@ You must uninstall the driver as `Administrator`.
138138
### Uninstall with wperf-devgen {#devgen_uninstall}
139139

140140
```command
141-
cd windowsperf-bin-3.8.0\wperf-driver
141+
cd windowsperf-bin-4.0.0\wperf-driver
142142
wperf-devgen uninstall
143143
```
144144

@@ -162,7 +162,7 @@ Install by opening **Extensions** menu, click **Manage Extensions**, and click *
162162
In order to set the path to the `wperf.exe` executable, go to **Tools** -> **Options** -> **WindowsPerf** -> **WindowsPerf Path** and set the absolute path to the wperf.exe executable and then click on the **Validate** button.
163163
{{% /notice %}}
164164

165-
Also, visit WindowsPerf GUI project website on [GitHub](https://github.com/arm-developer-tools/windowsperf-vs-extension) for more details and latest updates.
165+
Also, visit WindowsPerf GUI project website on [GitLab](https://gitlab.com/Linaro/WindowsPerf/vs-extension) for more details and latest updates.
166166

167167
## Install WindowsPerf VS Code Extension (optional) {#vscode}
168168

@@ -180,7 +180,7 @@ If using a non-Windows on Arm host, you can import and analyze `WindowsPerf` JSO
180180
You do not need to install `wperf` on non-Windows on Arm devices.
181181
{{% /notice %}}
182182

183-
## Further reading
183+
## Read related resources
184184

185185
### WindowsPerf
186186

0 commit comments

Comments
 (0)