How to register a RHEL system via Red Hat Satellite Proxy server during kickstart installation?
Environment
- Red Hat Enterprise Linux
- Red Hat Satellite 5 and Satellite Proxy 5
Issue
- How do I register a system using rhn_ks when I am using Red Hat Satellite Proxy (formerly RHN Proxy) server?
Resolution
RHEL 7 NOTE: Red Hat Enterprise Linux 7 is only available through This content is not included.Red Hat Subscription Management tools or via Red Hat Satellite 5.6 or newer. Customers using Red Hat Network (RHN) Classic Hosted or stand-alone Red Hat Satelite Proxy (i.e. without Red Hat Satellite 5.6) cannot access RHEL 7.
*Red Hat Satellite Proxy server ‘Stand-Alone’ references a component of a Red Hat Satellite deployment which is used as a stand-alone (Satellite-less) offering, and as of October 31, 2017 is now end-of-life.
The process for registering a system with rhnreg_ks via a Red Hat Satellite Proxy 5 server is almost the same as using the utility directly with a Red Hat Satellite 5 server.
The primary difference is that we must specify the --serverURL to ensure that we connect to the proxy.
The rhnreg_ks command is a utility for registering a system with Red Hat Satellite 5. It is designed to be used in a non-interactive environment (a kickstart style install, for example). All the information can be specified on the command line or stdin.
-
The syntax to use the
rhnreg_kscommand to register a system using an activation key is:rhnreg_ks --activationkey=<activationkey> -
The example below will register a system via an Red Hat Satellite Proxy 5 server using the activation key
1-2b48feedf5b5a0e0609ae028d9275c93:rhnreg_ks --serverUrl https://satellite-proxy.example.com/XMLRPC --profilename=my_rhel_system01 --activationkey=1-2b48feedf5b5a0e0609ae028d9275c93 -
You can also specify
username,password, andprofilename.The example below will register a system with the profile name "my_rhel_system01", using anusernameof "myusername" whose password is "mypw1234".rhnreg_ks --serverUrl https://satellite-proxy.example.com/XMLRPC --profilename=my_rhel_system01 --username=myusername --password=mypw1234
Note: If the Satellite's username and password were entered on the command line they may have been saved in the shell's history. The shell's entire history can be cleared by running the command history -c. Its possible to remove a single line from the shell's history by running the command history -d <line>. The exact line in the shell's history can be found by simply running the history command. The clear command can be issued to clear the login credentials from the screen.
- For details on how to create an activation key you can refer to Satellite Documentation
RHEL Systems Registration Guide
- This document is part of a collection covering RHEL System Registration.
- If this is not the right solution for your registration needs or;
- If you wish to make a different registration choice;
- then you can return to the RHEL Systems Registration Guide.
Red Hat Labs Registration Assistant
We also have an online tool to assist you in selecting the most appropriate registration technology for your system. If you would prefer to use this tool, please visit [https://access.redhat.com/labs/registrationassistant/](https://access.redhat.com/labs/registrationassistant/).
This solution has been reviewed for technical accuracy, optimized for search, and integrated with Product Documentation and/or Red Hat Access Labs. Much like when a software package is accepted upstream, this content has moved from the general KCS editing workflow into the responsibility of Customer Content Services as maintainers.