Merge pull request #3205 from paschalis-mpeis/bolt-install-page

bolt-demo: add installation instructions

Author: pareenaverma

content/learning-paths/servers-and-cloud-computing/bolt-demo/_index.md

@@ -9,6 +9,7 @@ who_is_this_for: This is an introductory topic for developers who have compiled
 
 learning_objectives:
     - Identify whether a program is a good candidate for code layout optimization
+    - Install LLVM BOLT on Linux
     - Use LLVM BOLT to perform profile-guided post-link optimization of an AArch64 binary with poor spatial locality
     - Collect profile data using multiple techniques, including BRBE, instrumentation, SPE, and PMU event sampling
     - Evaluate the impact of BOLT optimizations using performance metrics and profiling data
@@ -19,7 +20,6 @@ prerequisites:
     - Linux kernel version 6.17 or later to enable Branch Record Buffer Extension ([BRBE profiling](/learning-paths/servers-and-cloud-computing/bolt-demo/brbe/))
     - Linux kernel version 6.14 or later for Arm Statistical Profiling Extension ([SPE profiling](/learning-paths/servers-and-cloud-computing/bolt-demo/spe/))
     - GCC version 13.3 or later to compile the example program ([GCC](/install-guides/gcc/) )
-    - LLVM BOLT version [21.1.8](https://github.com/llvm/llvm-project/releases/tag/llvmorg-21.1.8) or later (download [zip](https://github.com/llvm/llvm-project/releases/download/llvmorg-21.1.8/LLVM-21.1.8-Linux-ARM64.tar.xz))
     - A system with with sufficient hardware performance counters to use the [TopDown](/install-guides/topdown-tool) methodology. This typically requires running on bare metal rather than a virtualized environment.
 
 

content/learning-paths/servers-and-cloud-computing/bolt-demo/brbe.md

@@ -1,6 +1,6 @@
 ---
 title: Optimize with BRBE profiling
-weight: 5
+weight: 6
 
 ### FIXED, DO NOT MODIFY
 layout: learningpathall

content/learning-paths/servers-and-cloud-computing/bolt-demo/good-candidates.md

@@ -1,6 +1,6 @@
 ---
 title: Identify programs for BOLT optimization
-weight: 4
+weight: 5
 
 ### FIXED, DO NOT MODIFY
 layout: learningpathall

content/learning-paths/servers-and-cloud-computing/bolt-demo/install.md

@@ -0,0 +1,67 @@
+---
+title: Install BOLT on Linux
+weight: 3
+
+### FIXED, DO NOT MODIFY
+layout: learningpathall
+---
+
+## Install BOLT on Linux
+
+This guide requires LLVM BOLT 22.1.0 or later for SPE profiling and required options.
+Package manager versions might be older, so verify the installed version before continuing.
+
+
+## Install BOLT from LLVM releases
+
+Install BOLT from a prebuilt [LLVM release](https://github.com/llvm/llvm-project/releases).
+This method provides a consistent version across systems. It also lets you use newer releases when available.
+The following example uses LLVM 22.1.0.
+
+Download and extract LLVM:
+
+```bash
+wget https://github.com/llvm/llvm-project/releases/download/llvmorg-22.1.0/LLVM-22.1.0-Linux-ARM64.tar.xz
+tar xf LLVM-22.1.0-Linux-ARM64.tar.xz
+```
+
+Add LLVM tools to your PATH:
+
+```bash
+export PATH="$(pwd)/LLVM-22.1.0-Linux-ARM64/bin:$PATH"
+```
+
+
+## Install BOLT using a package manager
+
+Use a package manager if you prefer a system-managed installation. Package versions depend on your Linux distribution.
+
+
+
+{{< tabpane code=true >}}
+
+{{< tab header="Ubuntu/Debian" language="bash">}}
+sudo apt update
+sudo apt install llvm-bolt
+{{< /tab >}}
+
+{{< tab header="Fedora" language="bash">}}
+sudo dnf install llvm-bolt
+{{< /tab >}}
+
+{{< tab header="openSUSE" language="bash">}}
+sudo zypper install llvm-bolt
+{{< /tab >}}
+
+{{< /tabpane >}}
+
+
+BOLT is available on Ubuntu 25.04 and later, Debian 13 and later, Fedora 42 and later, and on openSUSE Tumbleweed.
+
+## Verify the installation
+
+```bash
+llvm-bolt --version
+```
+
+The command prints the BOLT version. If the command fails, check your PATH.

content/learning-paths/servers-and-cloud-computing/bolt-demo/instrumentation.md

@@ -1,6 +1,6 @@
 ---
 title: Optimize with instrumentation profiling
-weight: 6
+weight: 7
 
 ### FIXED, DO NOT MODIFY
 layout: learningpathall

content/learning-paths/servers-and-cloud-computing/bolt-demo/pmu.md

@@ -1,6 +1,6 @@
 ---
 title: Optimize with PMU profiling
-weight: 8
+weight: 9
 
 ### FIXED, DO NOT MODIFY
 
@@ -48,4 +48,4 @@ Finally, `llvm-bolt` uses the generated profile to reorganize functions and basi
 
 You've collected a PMU profile and generated an optimized binary using basic sampling. While PMU provides less detailed control-flow information than BRBE or SPE, it's available on all Arm systems.
 
-Now you're ready to verify how effective the BOLT optimization was by measuring performance improvements.
+Now you're ready to verify how effective the BOLT optimization was by measuring performance improvements.

content/learning-paths/servers-and-cloud-computing/bolt-demo/setup.md

@@ -1,6 +1,6 @@
 ---
-title: Prepare your environment for BOLT
-weight: 3
+title: Prepare your environment
+weight: 4
 
 ### FIXED, DO NOT MODIFY
 layout: learningpathall

content/learning-paths/servers-and-cloud-computing/bolt-demo/spe.md

@@ -1,6 +1,6 @@
 ---
 title: Optimize with SPE profiling
-weight: 7
+weight: 8
 
 ### FIXED, DO NOT MODIFY
 

content/learning-paths/servers-and-cloud-computing/bolt-demo/verify-optimization.md

@@ -1,6 +1,6 @@
 ---
 title: Verify BOLT optimization results
-weight: 9
+weight: 10
 
 ### FIXED, DO NOT MODIFY
 layout: learningpathall