From 198777d1b8a6875a27d0eb8b25ebb496a30dd18e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?C=C3=A9dric=20Bosdonnat?= Date: Fri, 16 May 2025 17:51:36 +0200 Subject: [PATCH 1/2] Fix the documentation on how to rename the server (bsc#1229825) --- CHANGELOG.md | 1 + .../tshoot-hostname-rename.adoc | 33 ++++++++++++++----- 2 files changed, 26 insertions(+), 8 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 8d2cf2d188b..8ec69e5d111 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,4 @@ +- Fix the hostname rename page for containers (bsc#1229825) - Documented TFTP file synchronization after migrating a 4.3 proxy in Installation and Upgrade Guide (bsc#1244427) - Added Role-Based Access Control (RBAC) chapter to Administration Guide diff --git a/modules/administration/pages/troubleshooting/tshoot-hostname-rename.adoc b/modules/administration/pages/troubleshooting/tshoot-hostname-rename.adoc index 08db773a815..81677a127ec 100644 --- a/modules/administration/pages/troubleshooting/tshoot-hostname-rename.adoc +++ b/modules/administration/pages/troubleshooting/tshoot-hostname-rename.adoc @@ -35,38 +35,55 @@ This is because the changes have not been made in the database, which prevents t == Rename Server -If you need to change the hostname of the {productname} Server, you can do so using the [command]``spacewalk-hostname-rename`` script. -This script updates the settings in the {postgresql} database and the internal structures of {productname}. +If you need to change the hostname of the {productname} Server, you can do so using the [command]``mgradm server rename`` command. +This command updates the settings in the {postgresql} database and the internal structures of {productname}. === Server Configuration -The [command]``spacewalk-hostname-rename`` script is part of the [package]``spacewalk-utils`` package. +The command takes no mandatory parameter, but can take the new hostname if it is not the one from the container host. -The only mandatory parameter for the script is the newly configured IP address of the {productname} Server. +In case any SSL certificate needs to be generated to match the new hostname, the SSL CA password needs to be provided. +This is safely achieved using a configuration file +.Procedure: Prepare the configuration file for the SSL CA password +. Write a [path]``config.yaml`` file with content like the following: ++ +[source,shell] +---- +ssl: + password: "" +---- .Procedure: Renaming {productname} Server . Change the network settings of the server on the system level locally and remotely at the DNS server. You also need to provide configuration settings for reverse name resolution. Changing network settings is done in the same way as with renaming any other system. . Reboot the {productname} Server to use the new network configuration and to ensure the hostname has changed. -. On the container host, from the command line, execute the following command to configure the public IP address of the server: +. On the container host, from the command line, execute the following command. Add [command]``-c config.yaml`` if you created the file to store the SSL CA password: + [source,shell] ---- -mgrctl exec -ti -- spacewalk-hostname-rename +mgradm server rename ---- + -If the server is not using the new hostname, the script fails. - Be aware that this script refreshes the pillar data for all {salt} clients: the time it takes to run depends on the number of registered clients. +If the new hostname is not resolvable, the command fails. + +The renaming procedure also takes place during the restart of the server container. +The logs can be found by running this command: + +[source,shell] +---- +mgrctl exec -ti -- journalctl -u uyuni-update-config +---- +Be aware that this command triggers a refresh of the pillar data for all {salt} clients when restarting the server container: the time it takes to run depends on the number of registered clients. === Directly Managed Clients Reconfiguration From e848b8f4678a2bf0174a5e48bb952aad1c6e5556 Mon Sep 17 00:00:00 2001 From: Karl Eichwalder Date: Mon, 23 Jun 2025 07:48:25 +0200 Subject: [PATCH 2/2] Update CHANGELOG.md --- CHANGELOG.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 8ec69e5d111..a6767923fdd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,4 +1,5 @@ -- Fix the hostname rename page for containers (bsc#1229825) +- Fix the hostname rename page for containers in Troubleshooting of + Administration Guide (bsc#1229825) - Documented TFTP file synchronization after migrating a 4.3 proxy in Installation and Upgrade Guide (bsc#1244427) - Added Role-Based Access Control (RBAC) chapter to Administration Guide