From 4598708ce2145f9824bc6fe419b84bb6a858d231 Mon Sep 17 00:00:00 2001 From: Cedric Bosdonnat Date: Tue, 23 Sep 2025 10:42:09 +0200 Subject: [PATCH] fix changelog --- CHANGELOG.md | 6 ++-- .../tshoot-hostname-rename.adoc | 34 ++++++++++++++----- 2 files changed, 29 insertions(+), 11 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index e57f252d8b1..fcf6c6e61cc 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,7 @@ -- Package salt-minion superseded with venv-salt-minion; salt-minion - for bootstrapping SLE clients only (bsc#1247323) +- Fix the hostname rename page for containers in Troubleshooting of + Administration Guide (bsc#1229825) +- Documented to use the same CA password during migrating from 4.3 + in Installation and Upgrade Guide (bsc#1247296) - Added note about onboarding CentOS 7 clients with repositories disabled in Client Configuration Guide (bsc#1248467) - Documented to use the same CA password during migrating from 4.3 diff --git a/modules/administration/pages/troubleshooting/tshoot-hostname-rename.adoc b/modules/administration/pages/troubleshooting/tshoot-hostname-rename.adoc index 5d8c3025d17..8bf1c9734ec 100644 --- a/modules/administration/pages/troubleshooting/tshoot-hostname-rename.adoc +++ b/modules/administration/pages/troubleshooting/tshoot-hostname-rename.adoc @@ -37,39 +37,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