Skip to content

Commit 14d85fc

Browse files
authored
Merge pull request #3081 from james-whitaker-arm/james/performix_macos_x64
Fix Performix install guide so it mentions MacOS x64 as a supported host platform
2 parents a19f06f + c29c60f commit 14d85fc

1 file changed

Lines changed: 43 additions & 38 deletions

File tree

content/install-guides/performix.md

Lines changed: 43 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -2,25 +2,25 @@
22
title: Arm Performix
33

44
additional_search_terms:
5-
- performix
6-
- performance
7-
- profiling
8-
- analysis
9-
- neoverse
10-
- optimization
11-
- perf
12-
- top-down
5+
- performix
6+
- performance
7+
- profiling
8+
- analysis
9+
- neoverse
10+
- optimization
11+
- perf
12+
- top-down
1313

1414
minutes_to_complete: 30
1515

1616
author: Pareena Verma
1717

1818
### Link to official documentation
19-
official_docs: https://developer.arm.com/documentation/110163/latest
19+
official_docs: https://developer.arm.com/documentation/110163/latest
2020

21-
weight: 1
22-
tool_install: true
23-
multi_install: false
21+
weight: 1
22+
tool_install: true
23+
multi_install: false
2424
multitool_install_part: false
2525
layout: installtoolsall
2626
---
@@ -47,8 +47,8 @@ Arm Linux target systems running Amazon Linux 2023, Ubuntu 22.04, or Ubuntu
4747

4848
Arm Performix requires different packages depending on your host platform:
4949

50-
* **Windows**: Windows 10 or later (Arm64 or x64 architecture)
51-
* **macOS**: macOS on Arm64 (Apple Silicon)
50+
* **Windows**: Windows 10 or later on Arm64 or x64 architecture
51+
* **macOS**: macOS on Arm64 (Apple Silicon) or x64 architecture (Intel)
5252
* **Linux**: Debian-based distribution on Arm64 or x64 architecture
5353

5454
You also need access to an Arm Linux target system for profiling.
@@ -64,12 +64,12 @@ Download the Windows installer package for your architecture from the [Arm Perfo
6464
Alternatively, download using PowerShell. These commands require PowerShell and do not work in the Windows Command Prompt (CMD):
6565

6666
{{< tabpane code=true >}}
67-
{{< tab header="Arm64" >}}
67+
{{< tab header="Arm64" >}}
6868
curl -o ArmPerformix-windows-arm64.exe https://artifacts.tools.arm.com/arm-performix/app/latest/windows/arm64/ArmPerformix-windows-arm64.exe
69-
{{< /tab >}}
70-
{{< tab header="x64" >}}
69+
{{< /tab >}}
70+
{{< tab header="x64" >}}
7171
curl -o ArmPerformix-windows-x64.exe https://artifacts.tools.arm.com/arm-performix/app/latest/windows/x64/ArmPerformix-windows-x64.exe
72-
{{< /tab >}}
72+
{{< /tab >}}
7373
{{< /tabpane >}}
7474

7575
After downloading the `.exe` file, locate it in your Downloads folder and double-click it to start the installation wizard.
@@ -93,12 +93,12 @@ Download the Linux installer package for your architecture from the [Arm Perform
9393
Alternatively, download using `wget`:
9494

9595
{{< tabpane code=true >}}
96-
{{< tab header="Arm64" >}}
97-
wget -P $HOME https://artifacts.tools.arm.com/arm-performix/app/latest/linux/arm64/ArmPerformix-linux-arm64.deb
98-
{{< /tab >}}
99-
{{< tab header="x64" >}}
100-
wget -P $HOME https://artifacts.tools.arm.com/arm-performix/app/latest/linux/x64/ArmPerformix-linux-amd64.deb
101-
{{< /tab >}}
96+
{{< tab header="Arm64" >}}
97+
wget -P $HOME https://artifacts.tools.arm.com/arm-performix/app/latest/linux/arm64/ArmPerformix-linux-arm64.deb
98+
{{< /tab >}}
99+
{{< tab header="x64" >}}
100+
wget -P $HOME https://artifacts.tools.arm.com/arm-performix/app/latest/linux/x64/ArmPerformix-linux-amd64.deb
101+
{{< /tab >}}
102102
{{< /tabpane >}}
103103

104104
After downloading the `.deb` file, navigate to the directory where you downloaded it:
@@ -147,13 +147,18 @@ Arm Performix daemon version: 1.0.0
147147

148148
### How do I install Arm Performix on macOS?
149149

150-
Download the macOS installer package from the [Arm Performix download page](https://developer.arm.com/servers-and-cloud-computing/arm-performix).
150+
Download the macOS installer package for your architecture from the [Arm Performix download page](https://developer.arm.com/servers-and-cloud-computing/arm-performix).
151151

152152
Alternatively, download using `curl`:
153153

154-
```bash
154+
{{< tabpane code=true >}}
155+
{{< tab header="Arm64" >}}
155156
curl -Lo ArmPerformix-darwin-arm64.pkg https://artifacts.tools.arm.com/arm-performix/app/latest/darwin/arm64/ArmPerformix-darwin-arm64.pkg
156-
```
157+
{{< /tab >}}
158+
{{< tab header="x64" >}}
159+
curl -Lo ArmPerformix-darwin-arm64.pkg https://artifacts.tools.arm.com/arm-performix/app/latest/darwin/x64/ArmPerformix-darwin-x64.pkg
160+
{{< /tab >}}
161+
{{< /tabpane >}}
157162

158163
After downloading the `.pkg` file, navigate to the directory where you downloaded it and double-click the file to start the installer.
159164

@@ -250,9 +255,9 @@ In the **Configure Target** form, provide the following details:
250255
* **Port**: the SSH port number (default is 22)
251256
* **User**: the username for SSH connection
252257
* **SSH Private Key**: choose **Automatically Detect Key** or **Select Key Manually**
253-
* For manual selection, enter the path to your private key (usually `~/.ssh/id_rsa` or `~/.ssh/id_ed25519`)
258+
* For manual selection, enter the path to your private key (usually `~/.ssh/id_rsa` or `~/.ssh/id_ed25519`)
254259
* **Host Key Verification**: Choose **Strict** (recommended) or **Ignore**
255-
* Strict mode verifies the server identity using your `~/.ssh/known_hosts` file
260+
* Strict mode verifies the server identity using your `~/.ssh/known_hosts` file
256261

257262
![Arm Performix target configuration form displaying input fields including Host with IP address 192.168.1.10, Name field for descriptive target identifier, Port field set to 22, User field for SSH username, SSH Private Key section with radio buttons for Automatically Detect Key and Select Key Manually options, and Host Key Verification dropdown menu set to Strict mode with explanation text about verifying server identity using known_hosts file alt-txt#center](/install-guides/_images/atp-target-config.png "Configure Target form with connection settings")
258263

@@ -361,32 +366,32 @@ apx target add '{
361366
Choose one of the following methods to authenticate with your target:
362367

363368
* **Use an existing SSH key in a non-default location:**
364-
369+
365370
If your private key is not in `~/.ssh/id_rsa` or `~/.ssh/id_ed25519`, specify its path in the target command:
366371
```bash
367372
apx target add user@host:22:/path/to/private_ssh_key
368373
```
369374

370375
* **Automatically detect an existing SSH key:**
371-
376+
372377
Arm Performix searches common locations (`~/.ssh/id_rsa`, `~/.ssh/id_ed25519`, etc.) for a usable key:
373378
```bash
374379
apx target add user@host --find-keys
375380
```
376381

377382
* **Generate and configure a new SSH key pair using password authentication:**
378-
383+
379384
If your target supports password-based SSH login, Performix can generate a new key pair and configure it automatically:
380385
```bash
381386
apx target add user@host --password
382387
```
383388
This option:
384-
- Generates an RSA 4096-bit key pair on your host (without a passphrase)
385-
- Authenticates to the target using the password you provide
386-
- Adds the public key to the target's `~/.ssh/authorized_keys` file
387-
- Records the target's host key in the known hosts list
388-
- Stores the private key securely for future connections
389-
- Discards the password immediately after use (not stored)
389+
- Generates an RSA 4096-bit key pair on your host (without a passphrase)
390+
- Authenticates to the target using the password you provide
391+
- Adds the public key to the target's `~/.ssh/authorized_keys` file
392+
- Records the target's host key in the known hosts list
393+
- Stores the private key securely for future connections
394+
- Discards the password immediately after use (not stored)
390395

391396
**Host key verification:**
392397

0 commit comments

Comments
 (0)