diff --git a/CHANGELOG.md b/CHANGELOG.md index e899171f572..8de41b0c746 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,6 @@ +- Improved procedure formatting for better clarity in Administration + Guide (bsc#1253660) +- Added missing options to command example in Installation and - Added links to man pages for createrepo_c and reprepro to Administration Guide (bsc#1237181) - Added documentation for new spacecmd subcommand system_needrebootafterupdate diff --git a/modules/administration/pages/troubleshooting/tshoot-registerclones.adoc b/modules/administration/pages/troubleshooting/tshoot-registerclones.adoc index 94b48c71c1d..4446e21172e 100644 --- a/modules/administration/pages/troubleshooting/tshoot-registerclones.adoc +++ b/modules/administration/pages/troubleshooting/tshoot-registerclones.adoc @@ -47,14 +47,15 @@ ____ . *Initial System Configuration* -. On the cloned machine, change the hostname and IP addresses. +.. On the cloned machine, change the hostname and IP addresses. Make sure [path]``/etc/hosts`` contains the changes you made and the correct host entries. . *Resolving Duplicate Machine IDs* -. _For distributions that support systemd:_ - If your machines have the same machine ID, as root, delete the files on each duplicated client and re-create it: +.. _For distributions that support systemd:_ + +... If your machines have the same machine ID, as root, delete the files on each duplicated client and re-create it: + @@ -68,7 +69,7 @@ systemd-machine-id-setup + -. If the cloned machine also has a folder in [path]``/var/log/journal/`` it needs to be renamed accordingly to the new machine ID. If names do not match, [command]``journalctl`` could not retrieve any log and [command]``podman logs`` would not show anything. +... If the cloned machine also has a folder in [path]``/var/log/journal/`` it needs to be renamed accordingly to the new machine ID. If names do not match, [command]``journalctl`` could not retrieve any log and [command]``podman logs`` would not show anything. + @@ -78,8 +79,9 @@ mv /var/log/journal/* /var/log/journal/$(cat /etc/machine-id) + -. _For distributions that do not support systemd:_ - As root, generate a machine ID from dbus: +.. _For distributions that do not support systemd:_ + +... As root, generate a machine ID from dbus: + @@ -89,21 +91,19 @@ rm /var/lib/zypp/AnonymousUniqueId dbus-uuidgen --ensure ---- -. *Fixing Kernel Entries on {rhel} 8.10* - -. If you are cloning a {rhel} 8.10 server that will later be liberated to {sll}, you must perform extra steps to fix the kernel configuration files. - -+ ++ [IMPORTANT] ==== -{rhel} uses the machine ID to generate kernel entries in [path]``/boot/loader/entries``. + +* If you are cloning a {rhel} 8.10 server that will later be liberated to {sll}, you must perform extra steps to fix the kernel configuration files. + + +* {rhel} uses the machine ID to generate kernel entries in [path]``/boot/loader/entries``. Not performing these steps will result in a mix of old and new kernel entries after the liberation, as {sll} kernels will create new entries instead of replacing the old ones. -==== -+ -. After changing the machine ID and before liberating, run: +* After changing the machine ID and before liberating, run: + @@ -113,14 +113,15 @@ sudo for ver in $(rpm -q kernel --qf '%{VERSION}-%{RELEASE}.%{ARCH}\n'); do echo 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[]. -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). - For Salt Minion 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). + +... For Salt Minion clients: + @@ -131,7 +132,7 @@ rm -rf /etc/salt/pki + -For Salt Bundle clients: +... For Salt Bundle clients: + @@ -142,8 +143,9 @@ rm -rf /etc/venv-salt-minion/pki + -. Delete accepted keys from the onboarding page and the system profile from {productname}, and restart the client with. -For Salt Minion clients: +.. Delete accepted keys from the onboarding page and the system profile from {productname}, and restart the client with. + +... For Salt Minion clients: + @@ -153,14 +155,18 @@ service salt-minion restart + -For Salt Bundle clients: +... For Salt Bundle clients: + + ---- service venv-salt-minion restart ---- -. Re-register the clients. -Each client now has a different [path]``/etc/machine-id`` and should be correctly displayed on the [guimenu]``System Overview`` page. + ++ + +.. Re-register the clients. + Each client now has a different [path]``/etc/machine-id`` and should be correctly displayed on the [guimenu]``System Overview`` page. ____