5.0 - Added new workflow for liberating RHEL server

CHANGELOG.md

@@ -1,3 +1,5 @@
+- Added new workflow for liberating RHEL server in Common Workflows 
+  Guides (bsc#1250423)
 - Added information about pachage already being provided for
   Inter-Server Synchronization v2 to Administration guide (bsc#1229977)
 - Added information about requesting access to PTFs (bsc#1213308)

l10n-weblate/common-workflows.cfg

@@ -15,4 +15,5 @@
 [type: asciidoc] modules/common-workflows/pages/workflow-inplace-sles-upgrade.adoc $lang:translations/$lang/modules/common-workflows/pages/workflow-inplace-sles-upgrade.adoc
 [type: asciidoc] modules/common-workflows/pages/workflow-install-from-raw-image.adoc $lang:translations/$lang/modules/common-workflows/pages/workflow-install-from-raw-image.adoc
 [type: asciidoc] modules/common-workflows/pages/workflow-install-from-selfinstall-on-ppc.adoc $lang:translations/$lang/modules/common-workflows/pages/workflow-install-from-selfinstall-on-ppc.adoc
+[type: asciidoc] modules/common-workflows/pages/workflow-liberate-rhel-with-secureboot.adoc $lang:translations/$lang/modules/common-workflows/pages/workflow-liberate-rhel-with-secureboot.adoc
 [type: asciidoc] modules/common-workflows/pages/workflow-product-upgrade-webui.adoc $lang:translations/$lang/modules/common-workflows/pages/workflow-product-upgrade-webui.adoc

modules/administration/pages/troubleshooting/tshoot-registerclones.adoc

@@ -107,6 +107,11 @@ sudo  for ver in $(rpm -q kernel --qf '%{VERSION}-%{RELEASE}.%{ARCH}\n'); do ech
 sudo grub2-mkconfig -o /boot/efi/EFI/redhat/grub.cfg
 ----
 
++
+
+For more information and example on liberating {rhel} 8.10 server, see xref:common-workflows:workflow-liberate-rhel-with-secureboot.adoc[].
+
+
 . *Reconfiguring {salt} Clients*
 
 . If your clients still have the same Salt client ID, delete the [path]``minion_id`` file on each client (FQDN is used when it is regenerated on client restart).

modules/common-workflows/nav-common-workflows-guide.adoc

@@ -24,6 +24,8 @@ endif::[]
 
 ** xref:workflow-install-from-selfinstall-on-ppc.adoc[Install {productname} on {ppc64le}]
 
+** xref:workflow-liberate-rhel-with-secureboot.adoc[Liberate {rhel} with secure boot]
+
 ** xref:workflow-product-upgrade-webui.adoc[Product Upgrade via {webui}]
 
 ifdef::backend-pdf[]

modules/common-workflows/pages/workflow-liberate-rhel-with-secureboot.adoc

@@ -0,0 +1,31 @@
+[[workflow-liberate-rhel-with-secureboot]]
+
+= Liberate {rhel} 8.10 with secureboot
+
+
+To successfully liberate {rhel} 8.10 server with secure boot enabled, ensure that the installed kernel, grub2, and shim-x64 packages meet minimum version requirements to prevent boot failures after the migration.
+
+For a fresh server with secure boot, [literal]`shim-x64-15.8-2.el8_10.x86_64` package is installed during liberation.
+The other components must be updated manually to specific versions.
+
+.Procedure: Preparing a {rhel} 8.10 server for liberation with secure boot
+[role=procedure]
+_____
+. Ensure that the following versions or higher are installed:
+* [literal]`shim-x64-15.8-2.el8_10.x86_64`
+* [literal]`grub2-*-2.02-156.el8.1`
+* [literal]`kernel-4.18.0-553.16.1.el8_10.1`
+. If the current versions are lower then run the following:
++
+----
+dnf install grub2-*-2.02-156.el8.1
+dnf upgrade kernel-4.18.0-553.16.1.el8_10.1
+----
++
+. Reboot the system.
++
+[IMPORTANT]
+====
+These specific version numbers are for a fresh {rhel} 8.10 installation.
+If your server has been updated, the required versions may be different.
+====