Register clients with SpaceWalk Server

Install Spacewalk

This is the third part of Spacewalk installation and configuration series. In the first two parts, we gone through how to install and configure Spacewalk server and managing Spacewalk channels and repositories.

  1. Install And Configure Spacewalk In CentOS 7
  2. Managing Spacewalk Channels And Repositories

In this tutorial, we will configure clients to take installation packages from the Spacewalk server by registering it with Spacewalk server.


OS : CentOS Linux release 7.0.1406 (Core)

Hostname : client.itzgeek.local

IP Address :

Install Spacewalk clients:

CentOS Base repository does not have packages that are required for registering clients with Spacewalk server, so we would need to configure Spacewalk repo on client machine.

# rpm -Uvh

Install below package.

# yum install yum-rhn-plugin

Once the packages are installed, try to register the clients with spacewalk server.

Register clients with SpaceWalk Server:

It is recommended to use activation keys for registering and configuring client systems with Spacewalk server.

Now, login to Spacewalk server and get an activation that we created in previous tutorial.

Goto System –> Activation Keys.

Register clients with SpaceWalk Server - Activation Keys
Register clients with SpaceWalk Server

On client system’s Terminal, run the following command to register it to the Spacewalk server.

# rhnreg_ks --activationkey 1-3de95eb8d397e65b3831910fdc3e3f61 --serverUrl https://server.itzgeek.local/XMLRPC

Once the above command is executed, goto Spacewalk console, and click on Systems. You will see our client system that we just registered with Spacewalk.

Register Clients with Spacewalk server - System Overview
Register Clients with Spacewalk server – System Overview

Click on client name, you will be taken to client summary page where you can see detailed information about registered client (client.itzgeek.local). You can see that this system has subscribed automatically to base channel (itzgeek_centos7).

Register Clients with Spacewalk server - Client Overview
Register Clients with Spacewalk server – Client Overview

Modifying Subscription (Optional):

GUI Mode:

If you want to make a use of child channels (Ex. To install Nginx), To enable the child channels of the base channel to get Niginx packages.

Go to Systems –> <Your Client> –> Software –> Software Channels –> Software Channel Subscriptions.


Click on Alter Subscription Channels on client over page.

Select the Child channels (Ex. nginx_centos7) and click Change Subscriptions.

Register Clients with Spacewalk server - Change Channel subscription
Register Clients with Spacewalk server – Change Channel subscription

Now, client system is successfully subscribed to Nginx child channel.

Register Clients with Spacewalk server - Subscripton List
Register Clients with Spacewalk server – subscription List

Command Line Mode:

You can also change channel subscription using command Line. To list subscribed channels, run.

# rhn-channel -l

sample output:


To list the available channels, run.

# rhn-channel -L

sample output:

Username: itzgeek

Now, to subscribe to child channel, run.

# rhn-channel -a -c nginx_centos7

You will have to enter username and password of Spacewalk server admin account.
Veryify the subscription using below command.

# rhn-channel -l

sample output:


If you want to remove child channel subscriptions, run the following command.

# rhn-channel -r -c nginx_centos7

That’s it.  You can start to install or update packages from the Spacewalk server. Also, make sure that you have disabled non-Spacewalk repositories.

To do that, run:

# sed -i 's/enabled=1/enabled=0/g' /etc/yum.repos.d/*

To test, install Nginx package on client machine.

# yum install nginx

Sample output:

Loaded plugins: fastestmirror, rhnplugin
This system is receiving updates from RHN Classic or Red Hat Satellite.
Loading mirror speeds from cached hostfile
Resolving Dependencies
--> Running transaction check
---> Package nginx.x86_64 1:1.8.0-1.el7.ngx will be installed
--> Finished Dependency Resolution

Dependencies Resolved

Package      Arch          Version                  Repository            Size
nginx        x86_64        1:1.8.0-1.el7.ngx        nginx_centos7        369 k

Transaction Summary
Install  1 Package

Total download size: 369 k
Installed size: 889 k
Is this ok [y/d/N]:


If you see the above output, the packages are installed from Spacewalk child channel (nginx_centos7).

That’s All. You have successfully registered client systems with Spacewalk server for packages.I plan to cover more topics on Spacewalk server, stay tuned.


Share This Post

  • vl1969

    a stupid question, can I setup and manage server and client on the same host?
    I mean, I am building out a home VM server. single host. no external storage. all will be provisioned from the main machine.
    like so :
    Host : a dual opteron system with 2 6core CPU and 50GB ram
    a system disk (currently a 400GB HDD but thinking on getting a 120GB SSD or 2 64GB in raid1) a BTRFS pool of 2TB HDD to be the data storage.
    running centos7 minimal. + KVM
    the data store will be provision via NFS shares and managed from OpenMediaVault(OMV) VM
    ALL VMs and Physical systems will connect to shares provisioned by OMV

    can I manage all this using spacewalk loaded on the host it self?
    and can I mange the host with the same spacewalk setup on it?


    • If you are using redhat satellite server (skywalk premium), can not set both client and server on same machine, where as in skywalk you can do, but not recommended