Remove user guide duplication and tweak structure

jai-adam-schrem · jai-adam-schrem · commit a4011050e781 · 2026-06-29T11:29:32.000+01:00
diff --git a/content/install-guides/performix.md b/content/install-guides/performix.md
@@ -26,37 +26,33 @@ multitool_install_part: false
 layout: installtoolsall
 ---
 
-Arm Performix is a desktop application that provides performance
-analysis and profiling for Arm-based Linux systems. Arm Performix connects to remote Arm
-Linux targets via SSH and provides a graphical interface for capturing and
-analyzing performance data using hardware performance counters and the top-down
-methodology.
+## What is Arm Performix?
 
-Arm Performix provides capabilities for:
+Arm Performix is a desktop application that simplifies hardware-specific optimization by offering curated analysis pathways for performance-critical factors in applications, libraries, runtimes, and source code. Its capabilities include:
 
 * Performance profiling using hardware performance monitoring counters
 * Top-down methodology analysis for identifying performance bottlenecks
 * System-wide and per-process profiling
-* Command-line interface (CLI) included with the GUI installation
-* SSH-based remote target connections with optional jump node support
+* SSH-based remote target connections with optional support for jump nodes (also known as bastions)
 
-Arm Performix is available for Windows, macOS, and Linux host machines, and connects to
-Arm Linux target systems running Amazon Linux 2023, Ubuntu 22.04, or Ubuntu
-24.04.
+## Which host and target platforms does Arm Performix support?
 
-## What should I do before installing Arm Performix?
-
-Arm Performix requires different packages depending on your host platform:
+The Arm Performix desktop application supports the following host platforms:
 
 * **Windows**: Windows 10 or later on Arm64 or x64 architecture
 * **macOS**: macOS on Arm64 (Apple Silicon) or x64 architecture
 * **Linux**: Debian-based distribution on Arm64 or x64 architecture
 
-You also need access to an Arm Linux target system for profiling.
+You also need a target system on which to profile your application or workload. The following target platforms are supported:
+
+* **Linux with Arm64 architecture**: Arm Linux target systems running Amazon Linux 2023, Ubuntu 22.04, or Ubuntu 24.04. TODO finalise this
+* **Windows with Arm64 architecture**: TODO???
+* **Linux with x64 architecture**: TODO???
 
 ## How do I download and install Arm Performix?
 
-Arm Performix is distributed as platform-specific installer packages. The installation includes both the GUI and the CLI tool (`apx`).
+Arm Performix is distributed as platform-specific installer packages.
+The installation includes the GUI, the CLI tool (`apx`) and an MCP server.
 
 ### How do I install Arm Performix on Windows?
 
@@ -178,297 +174,9 @@ Wait while the installer copies the files.
 
 When the installation finishes, select **Close** to exit the installer.
 
-## How do I prepare my target for Arm Performix connections?
-
-Before connecting to an Arm Linux target, ensure SSH key-based authentication is configured and that passwordless sudo access is enabled. If you already manage your target system via SSH, you likely have most of this setup complete.
-
-### Check your existing SSH key
-
-Verify that you can connect to your target using SSH. Replace `user` with your username and `target_host` with your target's hostname or IP address:
-
-```bash
-ssh user@target_host
-```
-
-If the connection works, you have SSH key authentication configured. Now check if your existing key has a passphrase. Try to display the public key:
-
-```bash
-ssh-keygen -y -f ~/.ssh/id_ed25519
-```
-
-If you're prompted for a passphrase, your key is protected with one. Arm Performix doesn't support SSH keys with passphrases, so you need to create a separate key without a passphrase for Arm Performix.
-
-## Create a passphrase-free key for Arm Performix (if needed)
-
-If your existing SSH key has a passphrase, generate a new key specifically for Performix:
-
-```bash
-ssh-keygen -t ed25519 -f ~/.ssh/apx_key
-```
-
-Press **Enter** when prompted for a passphrase to leave it empty.
-
-Copy the new public key to your target. If your existing SSH key is at a non-default location (for example, `~/cloud-keys/my-instance.pem`), specify it when copying:
-
-```bash
-ssh-copy-id -i ~/.ssh/apx_key.pub -o "IdentityFile=~/cloud-keys/my-instance.pem" user@target_host
-```
-
-If your existing key is in the default location (`~/.ssh/id_ed25519` or `~/.ssh/id_rsa`), use:
-
-```bash
-ssh-copy-id -i ~/.ssh/apx_key.pub user@target_host
-```
-
-You can now use `~/.ssh/apx_key` as the private key when configuring the Arm Performix target connection.
-
-## Enable passwordless sudo on the target
-
-Performix needs to run commands with elevated privileges on the target system. Because Performix cannot enter sudo passwords interactively, configure passwordless sudo access.
-
-On the target system, edit the sudoers file:
-
-```bash
-sudo visudo
-```
-
-Add the following line, replacing `<username>` with your actual username. Insert it after any existing entries for that user or their groups, since rules in the sudoers file are applied in order and later entries take precedence.
-
-```bash
-<username> ALL=(ALL) NOPASSWD:ALL
-```
-
-Save and exit the editor.
-
-## How do I connect Arm Performix to a target?
-
-After installing Arm Performix and preparing your target, you can connect using either the GUI or the CLI.
-
-### Connect using the Arm Performix GUI
-
-Use the GUI on Windows and macOS hosts, though you can also run it on Linux.
-
-Open the Arm Performix application.
-
-On the home page, select **Connect a target** or select **Targets** in the activity bar to open the Targets view.
-
-Select **Add Target**.
-
-In the **Configure Target** form, provide the following details:
-
-* **Host**: the hostname or IP address of the target machine
-* **Name**: a descriptive name for the target
-* **Port**: the SSH port number (default is 22)
-* **User**: the username for SSH connection
-* **SSH Private Key**: choose **Automatically Detect Key** or **Select Key Manually**
-    * For manual selection, enter the path to your private key (usually `~/.ssh/id_rsa` or `~/.ssh/id_ed25519`)
-* **Host Key Verification**: Choose **Strict** (recommended) or **Ignore**
-    * Strict mode verifies the server identity using your `~/.ssh/known_hosts` file
-
-![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")
-
-
-Select **Add Target**.
-
-The target appears in the targets list and is ready for profiling.
-
-You can select the **Test Connection** button to verify your connection to the Performix Linux target is successful.
-
-![Arm Performix graphical interface displaying connection test results with green checkmark icon indicating success, target name my-target shown in header, host IP address 192.168.1.10 listed below, connection status field showing Connected in green text, and blue Test Connection button at bottom of panel#center](/install-guides/_images/atp-connection-test.png "Successful Arm Performix target connection test")
-
-#### Configure jump nodes (optional)
-
-If your target is behind a bastion host or requires intermediate servers for access, add jump nodes in the GUI:
-
-In the **Jump Node** section, select **Add Jump Node**.
-
-Provide the jump node details:
-
-* **Host**: The hostname or IP address of the jump node
-* **Port**: The SSH port (default is 22)
-* **User**: The username for the jump node
-* **SSH Private Key**: The key file path (if using manual selection)
-
-Select **Add** to save the jump node.
-
-You can add multiple jump nodes. The order matters—your connection uses them in sequence. Use drag and drop to reorder jump nodes.
-
-#### Connect using the Arm Performix GUI to a local machine
-
-Performix already includes a built-in `localhost` target through the CLI. However, as of Performix 2026.01, this target is not exposed in the GUI. If you prefer the command line, you can run recipes directly without configuring the target through the GUI. [Skip to the profile the local machine section](#profile-the-local-machine) below. 
-
-If you want to target your local machine conveniently through the GUI, use `localhost` in place of `target_host` and select **Username and password** as the authentication method, as shown in the following image. Make sure passwordless `sudo` is enabled for your user account.
-
-
-![Arm Performix GUI showing the Configure Target form for a local connection using 'localhost', including Host set to localhost, Name field for a custom label, Port set to 22, User set to the local username, authentication set to Username and password, and Host Key Verification options#center](/install-guides/_images/connect-via-local-host.png "Configure local target using localhost in Arm Performix GUI")
-
-Enter the password for your user when prompted
-
-![Arm Performix GUI displaying a password prompt dialog requesting the user's system password for authentication, including a password input field, confirmation button, and context indicating connection to a localhost target#center](/install-guides/_images/performix-add-passwrd.png "Enter user password for localhost authentication in Arm Performix")
-
-### Connect using the Arm Performix CLI
-
-The CLI is useful for Linux hosts or when you prefer command-line workflows.
-
-The `apx` command-line tool is installed automatically with the GUI. On Linux, you can find it at:
-
-```bash
-/opt/Arm\ Performix/assets/apx/apx 
-```
-
-For convenience, add it to your PATH or create an alias:
+## How do I use Arm Performix
 
-```bash
-export PATH="/opt/Arm Performix/assets/apx:$PATH"
-```
-
-Use the CLI help for command-line usage:
-
-```bash
-apx --help
-```
-
-#### Profile the local machine
-
-If your target is the same machine where you installed Arm Performix (the host machine itself), Arm Performix automatically provides a built-in `localhost` target. You don't need to configure authentication, SSH keys, or host verification for local profiling.
-
-Verify the localhost target is available by listing all configured targets:
-
-```bash
-apx target list
-```
-
-The output is similar to:
-
-```output
-name      default  host_key_policy  value
-localhost yes      localhost
-1 registered target found
-```
-
-Your local machine is now ready to use as a target. Specify `--target=localhost` when running Arm Performix commands.
-
-#### Add a remote target
-
-To profile a workload on a remote machine, add it as a target using the standard syntax. This command registers the remote system with Performix:
-
-```bash
-apx target add <user>@<host>:<port>:<private_ssh_key_path>
-```
-
-Where:
-* `user`: (Optional) SSH username. If not specified, uses your current system username
-* `host`: (Required) Target hostname or IP address
-* `port`: (Optional) SSH port. Default is 22
-* `private_ssh_key_path`: (Optional) Path to your private SSH key
-
-For example, to connect to a target at `192.168.1.10` using the `ubuntu` username:
-
-```bash
-apx target add ubuntu@192.168.1.10
-```
-
-You can also use JSON format to specify the target:
-
-```bash
-apx target add '{
-  "host": "192.168.1.10",
-  "port": 22,
-  "username": "ubuntu",
-  "privateKeyFilename": "~/.ssh/apx_key",
-  "hostKeyPolicy": "accept-new"
-}'
-```
-
-**Authentication options:**
-
-Choose one of the following methods to authenticate with your target:
-
-* **Use an existing SSH key in a non-default location:**
-
-  If your private key is not in `~/.ssh/id_rsa` or `~/.ssh/id_ed25519`, specify its path in the target command:
-  ```bash
-  apx target add user@host:22:/path/to/private_ssh_key
-  ```
-
-* **Automatically detect an existing SSH key:**
-
-  Arm Performix searches common locations (`~/.ssh/id_rsa`, `~/.ssh/id_ed25519`, etc.) for a usable key:
-  ```bash
-  apx target add user@host --find-keys
-  ```
-
-* **Generate and configure a new SSH key pair using password authentication:**
-
-  If your target supports password-based SSH login, Performix can generate a new key pair and configure it automatically:
-  ```bash
-  apx target add user@host --password
-  ```
-  This option:
-    - Generates an RSA 4096-bit key pair on your host (without a passphrase)
-    - Authenticates to the target using the password you provide
-    - Adds the public key to the target's `~/.ssh/authorized_keys` file
-    - Records the target's host key in the known hosts list
-    - Stores the private key securely for future connections
-    - Discards the password immediately after use (not stored)
-
-**Host key verification:**
-
-Specify host key verification with the `--host-key-policy` flag:
-
-* `strict`: (Default) Fail if the host key is unknown or changed
-* `ignore`: Disable host key verification
-* `accept-new`: Accept unknown keys, but warn if they change later
-
-```bash
-apx target add user@host --host-key-policy accept-new
-```
-
-**Naming and default targets:**
-
-Give your target a friendly name using `--name`:
-
-```bash
-apx target add ubuntu@192.168.1.10 --name my-target
-```
-
-Make a target the default for future commands with `--default`:
-
-```bash
-apx target add ubuntu@192.168.1.10 --name my-target --default
-```
-
-After you run this command, `my-target` becomes the default target for future commands.
-
-**Using jump nodes:**
-
-If your target requires jump nodes (bastion hosts), use the `--jump` flag. Specify jump nodes in connection order:
-
-```bash
-apx target add user@final-host --jump user@jumphost1 --jump admin@jumphost2
-```
-
-This connects through `jumphost1`, then `jumphost2`, then `final-host`.
-
-**Verify and manage targets:**
-
-Test the connection to a target:
-
-```bash
-apx target test my-target
-```
-
-List all configured targets:
-
-```bash
-apx target list
-```
-
-Remove a target:
-
-```bash
-apx target remove my-target
-```
+For on using Arm Performix, including connecting to your target, please refer to the [Arm Performix User Guide](https://developer.arm.com/documentation/110163/latest/).
 
 ## How do I uninstall Arm Performix?
 
