Pre-Flight
----------
* The Spacewalk server is **spacewalk.example.com**
* CentOS 5.5 i386
* The client to be registered is **client.example.com**
* CentOS 5.5 i386
Preparing the Client for Registration
-------------------------------------
### Install the necessary packages
On CentOS 5
rpm -Uvh http://spacewalk.redhat.com/yum/1.3/RHEL/5/i386/spacewalk-client-repo-1.3-1.el5.noarch.rpm
yum install rhn-client-tools rhn-check rhn-setup rhnsd m2crypto yum-rhn-plugin
### Install the Spacewalk server certificate
You'll find the Spacewalk server certificate in the `/pub` folder:
rpm -Uvh http://spacewalk.example.com/pub/rhn-org-trusted-ssl-cert-1.0-1.noarch.rpm
This installs the certificate file (RHN-ORG-TRUSTED-SSL-CERT) in `/usr/share/rhn`
### Edit `/etc/sysconfig/rhn/up2date`
I only changed the values of `serverURL` and `sslCACert`:
sslCACert=/usr/share/rhn/RHN-ORG-TRUSTED-SSL-CERT
serverURL=https://spacewalk.example.com/XMLRPC
### Install EPEL
You'll get GPG key signing errors (like "Public key for blah is not
installed") otherwise:
rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm
Register the client to the Spacewalk server
-------------------------------------------
Make sure you have two things:
1. A properly configured `/etc/sysconfig/rhn/up2date` file
2. The correct activation key
Then issue:
rhnreg_ks --activationkey=1-d31a1b9465e576d5250de5da356b00a0
Setting up Provisioning
-----------------------
Install these packages:
yum -y install rhncfg rhncfg-actions rhncfg-client osad
Enable the provisioning action on the client:
rhn-actions-control --enable-all
Read the `man` page for more fine-tuning. Now make sure that `osad` and
`rhnsd` are running:
service osad start
chkconfig --level 345 osad on
service rhnsd start
chkconfig --level 345 rhnsd on
You should be all set now.
Setting up Monitoring
---------------------
Install the `rhnmd` package and make sure it's running:
yum -y install rhnmd
service rhnmd start
chkconfig --level 345 rhnmd on
Make sure that the client firewall allows connections from port 4545
(default).
Installing this package creates a new user called `nocpulse`, whose
homedir is `/var/lib/nocpulse`. Now ask for the `nocpulse-identity`
public key from the server and put it in
`/var/lib/nocpulse/.ssh/authorized_keys`. Provided you've set up the
server properly, you should be all set now.
### Errors and Miscellanea
#### "Local permission not set for action type configfiles.deploy" (code 42)
Make sure that you ran `rhn-actions-control`.
#### 'Seeing' Server Commands
osad -N -v -v -v -v
Unregistering a Client
----------------------
Open `/etc/yum/pluginconf.d/rhnplugin.conf` and change
enabled = 1
to
enabled = 0
You may also want to clean up and reinstall RHN-related packages
yum remove rhn*
Sources
-------
* [Registering Clients - Spacewalk Wiki](https://fedorahosted.org/spacewalk/wiki/RegisteringClients)