Kernel 6.x information for Ubuntu

HCL-TECH-SOFTWARE · Dec 17, 2023 · d8e6718 · d8e6718
1 parent 1ccdc3e
commit d8e6718
Show file tree

Hide file tree

Showing 3 changed files with 112 additions and 9 deletions.
diff --git a/docs/index.md b/docs/index.md
@@ -96,7 +96,7 @@ Please note, only distributions declared as "Certified" are tested by HCL.
     </tr>
     <tr>
       <td><a href="linux/ubuntu">Ubuntu</a></td>
-      <td style="background:#9EFF9E;text-align:center;" >22.04</td>
+      <td style="background:#FFD147;text-align:center;" >22.04-03 LTS</td>
       <td style="background:#9EFF9E;text-align:center;" >Yes</td>
       <td style="background:#9EFF9E;text-align:center;" >Yes</td>
     </tr>

diff --git a/docs/linux/almalinux.md b/docs/linux/almalinux.md
@@ -36,7 +36,10 @@ Which versions of this Linux distribution exists in the market and what HCL Domi
 ### AlmaLinux 9.x
 Kernel: 5.14
 
-HCL Domino 14.0 {: .label .label-green } HCL Domino 12.0.x {: .label .label-green }
+HCL Domino 14.0
+{: .label .label-green }
+HCL Domino 12.0.x
+{: .label .label-green }
 
 
 

diff --git a/docs/linux/ubuntu.md b/docs/linux/ubuntu.md
@@ -19,7 +19,7 @@ has_children: false
 {:toc}
 </details>
 
-## Overview
+# Overview
 
 | --- | --- |
 | License         |    |
@@ -29,7 +29,7 @@ has_children: false
 | Support         |    |
 | Read more       | [Wikipedia: Ubuntux](https://en.wikipedia.org/wiki/Ubuntu) |
 
-## Compatibility
+# Compatibility
 
 <table>
   <caption>HCL Domino compatibility with SUSE Linux</caption>
@@ -41,7 +41,7 @@ has_children: false
       <th>Domino 11</th>
     </tr>
     <tr>
-      <td><a href="#ubuntu-2204-lts-jammy-jellyfish">24.04 LTS (Noble Numbat) </a></td>
+      <td><a href="#ubuntu-2204-lts-jammy-jellyfish">Ubuntu 24.04 LTS (Noble Numbat) </a></td>
       <td style="background:#C0C0C0;text-align:center;" >Unknown</td>
       <td style="background:#C0C0C0;text-align:center;" >Unknown</td>
       <td style="background:#C0C0C0;text-align:center;" >Unknown</td>
@@ -54,25 +54,125 @@ has_children: false
     </tr>
     <tr>
       <td><a href="#ubuntu-2204-lts-jammy-jellyfish">Ubuntu 22.04 (Jammy Jellyfish)</a></td>
-      <td style="background:#9EFF9E;text-align:center;" >Kernel 6.x?</td>
+      <td style="background:#FFD147;text-align:center;" >Kernel 6.x</td>
       <td style="background:#9EFF9E;text-align:center;" >Yes</td>
       <td style="background:#9EFF9E;text-align:center;" >Yes</td>
     </tr>
   </tbody>
 </table>
 
 
-## Versions
+# Versions
 
-### Ubuntu 22.04 LTS (Jammy Jellyfish)
+## Ubuntu 22.04 LTS (Jammy Jellyfish)
 
 HCL Domino 14.0
-{: .label .label-red }
+{: .label .label-yellow }
 HCL Domino 12.0.x
 {: .label .label-green }
 HCL Domino 11.0.1
 {: .label .label-green }
 
+Label Yellow
+{: .label .label-yellow }
+Ubuntu introduced a new major 6.x kernel option in 22.04-03 LTS. This kernel is not supported by Domino 14 yet, so downgrading to Kernel 5.x is required.
+
+The 6.x kernel installation depends on the Hardware enablement stack (HWE).
+By default the HWE package is only installed on Desktops, but some providers might have already switched to the later kernel.
+
+The Ubuntu LTS enablement, or Hardware Enablement (HWE), stack provides the newer kernel and X support for existing Ubuntu LTS releases. That stack can be enabled manually, but may also be pre-enabled with an Ubuntu LTS release.
+
+For details check the [Lifecycle document](https://ubuntu.com/kernel/lifecycle).
+
+Once this HWE package is installed, Ubuntu supports the 6.x kernel which will be then installed by default.
+
+### Enable Boot Menu
+
+Make sure to have boot console access to the server and see how the boot menu looks like. In some cases the boot menu might be hidden and needs to be enabled first. e.g. If it is hidden with **GRUB_TIMEOUT_STYLE=hidden** and a timeout for the boot menu set to 0 seconds. 
+
+Enable the boot menu via:
+
+```
+vi /etc/default/grub
+
+GRUB_TIMEOUT_STYLE=countdown
+GRUB_TIMEOUT=10
+
+update-grub
+```
+
+
+### Hardware Enablement Stack (HWE)
+
+Check if Hardware Enablement Stack (HWE) is enabled by querying the status:
+
+```
+hwe-support-status --verbose
+
+You are not running a system with a Hardware Enablement Stack. Your system is supported until April 2027
+```
+
+```
+hwe-support-status --verbose
+
+Your Hardware Enablement Stack (HWE) is supported until April 2027.
+```
+
+### Hardware Enablement Stack (HWE)
+
+If HWE is installed, remove it to avoid future kernel updates to a 6.x kernel.
+Note, this doesn't remove the newer kernel. It just removes the HWE package.
+
+```
+apt-get remove linux-generic-hwe-22.04
+apt autoremove
+```
+
+### Query installed kernels
+
+To check if an older kernel is still installed by running the following command:
+
+```
+apt list --installed | grep linux-image
+
+linux-image-5.15.0-91-generic/jammy-updates,jammy-security,now 5.15.0-91.101 amd64 [installed,automatic]
+linux-image-6.2.0-39-generic/jammy-updates,jammy-security,now 6.2.0-39.40~22.04.1 amd64 [installed,automatic]
+```
+
+### Install a 5.x kernel
+
+In the example above, a 5.15 kernel is already installed.
+If not, then install it manually with the following command:
+
+```
+apt-get install --install-recommends linux-image-5.15.0-91-generic
+```
+
+**Switch to the 5.x kernel from the boot menu**
+
+During boot count down press `ESC` and select the advanced menu if the **5.x kernel** is not listed in the main menu.
+
+Once the new kernel is installed, reboot and switch to the 5.x kernel from the boot menu. Note, it is not possible to remove a running kernel that was booted from.
+
+**Verify**
+
+Check if the the kernel 5.x is active using the following command:
+
+```
+uname -a
+Linux ubuntu-4gb-nbg1-1 5.15.0-91-generic #101-Ubuntu SMP Tue Nov 14 13:30:08 UTC 2023 x86_64 x86_64 x86_64 GNU/Linux
+```
+
+### Remove the 6.2 kernel
+
+Check if kernel 6.x is listed earlier and remove it. The grub menu should be automatically updated:
+
+```
+apt-get remove linux-image-6.2.0-39-generic
+```
+
+Finally reboot and check if the machine still boots up.
+
 ### Ubuntu 23.10 (Mantic Minotaur)
 
 ### Ubuntu 24.04 LTS (Noble Numbat)