Add test_cpu_compat.md to gemstones (#1845)

* add alpha sort to `.pages` file in gemstones * add links to procedure in 9.x release notes files
rocky-linux · Feb 28, 2024 · be50216 · be50216
1 parent 0ce7f09
commit be50216
Show file tree

Hide file tree

Showing 6 changed files with 46 additions and 3 deletions.
diff --git a/docs/gemstones/.pages b/docs/gemstones/.pages
@@ -19,5 +19,7 @@ nav:
     - ... | sed_search_replace*.md
     - ... | setup_local_repo*.md
     - ... | systemd_service_for_python_script*.md
+    - ... | test_cpu_compat*.md
+    - ... | torsocks*.md
     - ... | view_kernel_conf*.md
     - ...
diff --git a/docs/gemstones/test_cpu_compat.md b/docs/gemstones/test_cpu_compat.md
@@ -0,0 +1,35 @@
+---
+title: Test CPU compatibility
+author: Steven Spencer
+contributors: Louis Abel
+tags:
+  - cpu test 
+---
+
+# Introduction
+
+Since the release of Rocky Linux 9, some installations on x86-64 platforms fail with a kernel panic. In most cases, ==this is due to the CPU's incompatibility== with Rocky Linux 9. This procedure will verify CPU compatibility prior to installation.
+
+## Testing
+
+1. Obtain a boot image of Rocky Linux 8, Fedora, or other.
+
+2. Boot this live image on the machine where you want the installation of Rocky Linux 9 to be.
+
+3. After boot completes, open a terminal window and run this procedure:
+
+    ```bash
+    /lib64/ld-linux-x86-64.so.2 --help | grep x86-64
+    ```
+
+    You should receive output similar to this:
+
+    ```bash
+    Usage: /lib64/ld-linux-x86-64.so.2 [OPTION]... EXECUTABLE-FILE [ARGS-FOR-PROGRAM...]
+    This program interpreter self-identifies as: /lib64/ld-linux-x86-64.so.2
+    x86-64-v4
+    x86-64-v3
+    x86-64-v2 (supported, searched)
+    ```
+
+    This output indicates the minimum required x86-64 version (v2). Installation can continue in this case. If "(supported, searched)" is missing next to the "x86-64-v2" entry, then your CPU is **not** compatible with Rocky Linux 9.x. If the test shows that your installation can continue and it also shows x86-64-v3 and x86-64-v4 as "(supported, searched)", your CPU is well supported for 9.x and future versions.
diff --git a/docs/release_notes/9_0.md b/docs/release_notes/9_0.md
@@ -16,7 +16,7 @@ For a complete list of major changes, please see the upstream listing [here](htt
 
     With Rocky Linux 9.0, some older CPUs will not work well, or perhaps at all. The following architectures are considered minimum requirements for a successful install:
 
-    * AMD and Intel 64-bit architectures (x86-64-v2)
+    * AMD and Intel 64-bit architectures (x86-64-v2) [Ensure CPU compatibility with this procedure!](https://docs.rockylinux.org/gemstones/test_cpu_compat/)
     * The 64-bit ARM architecture (ARMv8.0-A)
     * IBM Power Systems, Little Endian (POWER9)
     * 64-bit IBM Z (z14)

diff --git a/docs/release_notes/9_1.md b/docs/release_notes/9_1.md
@@ -30,6 +30,8 @@ More information on the artifacts produced by the Cloud Special Interest Group,
 
 ## Installing
 
+Prior to installing, [ensure your CPU is compatible with this procedure!](https://docs.rockylinux.org/gemstones/test_cpu_compat/)
+
 To install Rocky Linux 9.1, head to the [download page](https://rockylinux.org/download/) and download the version you need for your architecture. 
 
 ## Known Issues

diff --git a/docs/release_notes/9_2.md b/docs/release_notes/9_2.md
@@ -64,6 +64,8 @@ To the already available Workstation/Workstation Lite/KDE/XFCE/MATE live images,
 
 ## Installing
 
+Prior to installing, [ensure the compatibility of your CPU with this procedure!](https://docs.rockylinux.org/gemstones/test_cpu_compat/)
+
 To install Rocky Linux 9.2, head to the [download page](https://rockylinux.org/download/) and download the version you need for your architecture.
 
 ## The Rocky Team Release Highlights

diff --git a/docs/release_notes/9_3.md b/docs/release_notes/9_3.md
@@ -17,17 +17,19 @@ You can upgrade from Rocky Linux 9.x to Rocky Linux 9.3 by doing `sudo dnf -y up
 !!! Note
 
     Rocky Linux does not offer an upgrade path from any version of Rocky Linux 8. We recommend doing a fresh OS install to move to Rocky Linux 9.3.
-    
+
 ## Images
 
 Several images are available along with the normal install images, including cloud and container platforms.
 
-* The 9.3 release brings back cloud and container images for ppc64le that were not released with 9.2 due to issues with QEMU. These images may be divergent from the other architecture's images in some small ways, but we will work to reduce this delta in future releases of the images. 
+* The 9.3 release brings back cloud and container images for ppc64le that were not released with 9.2 due to issues with QEMU. These images may be divergent from the other architecture's images in some small ways, but we will work to reduce this delta in future releases of the images.
 
 You can find more on the artifacts produced by the Cloud Special Interest Group, and information on how to get involved on the [SIG/Cloud Wiki page](https://sig-cloud.rocky.page/).
 
 ## Installing
 
+Prior to installing, [ensure compatibility of your CPU with this procedure!](https://docs.rockylinux.org/gemstones/test_cpu_compat/)
+
 To install Rocky Linux 9.3, head to the [download page](https://rockylinux.org/download/) and download the version you need for your architecture.
 
 ## The Rocky team release highlights