You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: modules/administration/pages/troubleshooting/tshoot-hostname-rename.adoc
+25-8Lines changed: 25 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,38 +35,55 @@ This is because the changes have not been made in the database, which prevents t
35
35
36
36
== Rename Server
37
37
38
-
If you need to change the hostname of the {productname} Server, you can do so using the [command]``spacewalk-hostname-rename`` script.
39
-
This script updates the settings in the {postgresql} database and the internal structures of {productname}.
38
+
If you need to change the hostname of the {productname} Server, you can do so using the [command]``mgradm server rename`` command.
39
+
This command updates the settings in the {postgresql} database and the internal structures of {productname}.
40
40
41
41
42
42
43
43
=== Server Configuration
44
44
45
-
The [command]``spacewalk-hostname-rename`` script is part of the [package]``spacewalk-utils`` package.
45
+
The command takes no mandatory parameter, but can take the new hostname if it is not the one from the container host.
46
46
47
-
The only mandatory parameter for the script is the newly configured IP address of the {productname} Server.
48
47
48
+
In case any SSL certificate needs to be generated to match the new hostname, the SSL CA password needs to be provided.
49
+
This is safely achieved using a configuration file
49
50
51
+
.Procedure: Prepare the configuration file for the SSL CA password
52
+
. Write a [path]``config.yaml`` file with content like the following:
53
+
+
54
+
[source,shell]
55
+
----
56
+
ssl:
57
+
password: "<THE CA PASSWORD>"
58
+
----
50
59
51
60
.Procedure: Renaming {productname} Server
52
61
. Change the network settings of the server on the system level locally and remotely at the DNS server.
53
62
You also need to provide configuration settings for reverse name resolution.
54
63
Changing network settings is done in the same way as with renaming any other system.
55
64
. Reboot the {productname} Server to use the new network configuration and to ensure the hostname has changed.
56
-
. On the container host, from the command line, execute the following command to configure the public IP address of the server:
65
+
. 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:
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.
0 commit comments