13.3. Changing the Red Hat Satellite Host Name
If you need to change the host name or IP address of your Red Hat Satellite server, the
spacewalk-utils
package contains the spacewalk-hostname-rename
script.
To use the
spacewalk-hostname-rename
script, you must first ensure that you know your SSL CA passphrase by performing the following command:
# openssl rsa -in path/RHN-ORG-PRIVATE-SSL-KEY
Enter passphrase when prompted.
spacewalk-hostname-rename
requires one mandatory argument, which is the IP address of the Red Hat Satellite server, regardless of whether the IP address will change along with the hostname or not.
The usage of
spacewalk-hostname-rename
is as follows:
spacewalk-hostname-rename <ip address> [ --ssl-country=<country> --ssl-state=<state>\ --ssl-org=<organization/company> --ssl-orgunit=<department> --ssl-email=<email address> --ssl-ca-password=<password>]
If there is a need to generate a new SSL certificate, the script asks for all necessary information through a series of prompts, unless options are passed at the command line (as in the above example). When the system hostname has not changed, the regeneration of a new SSL server certificate is unnecessary. However, if at least one SSL option is specified, then
spacewalk-hostname-rename
generates a new certificate.
For more information about using
spacewalk-hostname-rename
, see the following Red Hat Knowledgebase entry: