From be502160ba2fa1517e2605d8b0aef0db00d19c28 Mon Sep 17 00:00:00 2001 From: sspencerwire Date: Wed, 28 Feb 2024 10:30:00 -0600 Subject: [PATCH] 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 --- docs/gemstones/.pages | 2 ++ docs/gemstones/test_cpu_compat.md | 35 +++++++++++++++++++++++++++++++ docs/release_notes/9_0.md | 2 +- docs/release_notes/9_1.md | 2 ++ docs/release_notes/9_2.md | 2 ++ docs/release_notes/9_3.md | 6 ++++-- 6 files changed, 46 insertions(+), 3 deletions(-) create mode 100644 docs/gemstones/test_cpu_compat.md diff --git a/docs/gemstones/.pages b/docs/gemstones/.pages index 7c7301ada1..8d01da2f82 100644 --- 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 new file mode 100644 index 0000000000..a8cc6bc7bb --- /dev/null +++ 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 index d87f350cb6..f148705908 100644 --- 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 index d33b95bb0c..4d0b9de5a9 100644 --- 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 index 2957825660..9832dd0b6a 100644 --- 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 index f61abb896c..33080ebb91 100644 --- 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