8.3. Changing the Red Hat Satellite Hostname

If you need to change the hostname 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:

https://access.redhat.com/site/solutions/30596