Configuring Spacewalk Client Raw See Rendered

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)