RegisteringClients20
Instructions for registering client systems you wish to manage with Spacewalk 20.
Spacewalk 1.9 instructions are available at RegisteringClients19. Spacewalk 1.8 instructions are available at RegisteringClients18.
-
Create a base channel within Spacewalk (Channels > Manage Software Channels > Create New Channel)
-
Create an activation key with the new base channel. When creating a registration key do not use the generate function, create a human-readable version. eg: fedora-server-channel. This makes your installation more understandable and provides greater logical consistency to the whole system. On the other hand, if you want to prevent people from getting access to your channels, letting Spacewalk to generate random activation key name is the best way to go.
rhnreg_ks is used for registration of clients to Spacewalk. If you need to re-register a client to your Spacewalk server or change registration from one environment or server to another Spacewalk server then use the "--force" flag with rhnreg_ks, otherwise there is no need to use "--force".
-
Install the Spacewalk client yum repository
- For Fedora 18:
rpm -Uvh http://yum.spacewalkproject.org/2.0-client/Fedora/18/x86_64/spacewalk-client-repo-2.0-3.fc18.noarch.rpm
- For Fedora 19:
-
Install client packages
}}} 3. Register your Fedora system to Spacewalk using the activation key you created earlier {{{
rhnreg_ks --serverUrl=http://YourSpacewalk.example.org/XMLRPC --activationkey=
}}}
'''Warning:''' If you are installing these packages on a Red Hat Enterprise Linux installation it will override some of the original base packages and you may well be invalidating your support agreement with Red Hat!
1. Install the Spacewalk yum repository
* RHEL 5 / CentOS 5
{{{
# rpm -Uvh http://yum.spacewalkproject.org/2.0-client/RHEL/5/x86_64/spacewalk-client-repo-2.0-3.el5.noarch.rpm
}}}
* RHEL 6 / SL 6 / CentOS 6
{{{
# rpm -Uvh http://yum.spacewalkproject.org/2.0-client/RHEL/6/x86_64/spacewalk-client-repo-2.0-3.el6.noarch.rpm
}}}
2. The latest client tools bring the upstream development to your client boxes. That means that the packages may have dependencies that are not found in core Red Hat Enterprise Linux. These dependencies can be found in EPEL, just like for the Spacewalk server:
* EPEL 5
{{{
# BASEARCH=$(uname -i)
# rpm -Uvh http://dl.fedoraproject.org/pub/epel/5/$BASEARCH/epel-release-5-4.noarch.rpm
}}}
* EPEL 6
{{{
# BASEARCH=$(uname -i)
# rpm -Uvh http://dl.fedoraproject.org/pub/epel/6/$BASEARCH/epel-release-6-8.noarch.rpm
}}}
3. Install client packages
{{{
# yum install rhn-client-tools rhn-check rhn-setup rhnsd m2crypto yum-rhn-plugin
}}}
4. Register your CentOS or Red Hat Enterprise Linux system to Spacewalk using the activation key you created earlier
{{{
# rhnreg_ks --serverUrl=http://YourSpacewalk.example.org/XMLRPC --activationkey=<key-with-rhel-custom-channel>
}}}
Registering a CentOS 4 server to Spacewalk is exactly the same as it would be for CentOS 5, but rhnreg_ks, rhn_check and other related scripts are located in the package '''up2date''', and not in '''rhn-setup'''.
1. Enable '''spacewalk-tools''' repo for Yum and install '''up2date''' package:
{{{
# rpm -ivh http://stahnma.fedorapeople.org/spacewalk-tools/spacewalk-client-tools-0.0-1.noarch.rpm
# yum install up2date
- Register your CentOS system to Spacewalk using the activation key you created earlier:
# rhnreg_ks --serverUrl=http://YourSpacewalk.example.org/XMLRPC --activationkey=<key-with-centos-custom-channel>
- Add the spacewalk-tools repo to get access to the tools and install them:
For openSUSE 12.3:
# zypper ar -f http://download.opensuse.org/repositories/systemsmanagement:/spacewalk:/1.9/openSUSE_12.3/ spacewalk-tools
# zypper install rhn-client-tools zypp-plugin-spacewalk rhnsd rhn-setup rhn-check yum
For openSUSE 12.2:
# zypper ar -f http://download.opensuse.org/repositories/systemsmanagement:/spacewalk:/1.9/openSUSE_12.2/ spacewalk-tools
# zypper install rhn-client-tools zypp-plugin-spacewalk rhnsd rhn-setup rhn-check yum
For Factory:
# zypper ar -f http://download.opensuse.org/repositories/systemsmanagement:/spacewalk:/1.9/openSUSE_Factory/ spacewalk-tools
# zypper install rhn-client-tools zypp-plugin-spacewalk rhnsd rhn-setup rhn-check yum
-
Register your SUSE system to Spacewalk using the activation key you created earlier
rhnreg_ks --serverUrl=http://YourSpacewalk.example.org/XMLRPC --activationkey=
}}}
All core clients packages are already in Debian and Ubuntu. See:
http://packages.debian.org/sid/apt-transport-spacewalk
http://packages.debian.org/sid/python-rhn
http://packages.debian.org/sid/python-ethtool
http://packages.debian.org/sid/rhnsd
http://packages.debian.org/sid/rhn-client-tools
Install the packages.
{{{
apt-get update
apt-get install apt-transport-spacewalk rhnsd
If you want to run rhnsd. You have to manually create one directory:
mkdir /var/lock/subsys
If you need some additional packages (e.g. rhnpush or osad), add following line to file /etc/apt/sources.list:
deb http://miroslav.suchy.cz/spacewalk/debian spacewalk-unstable ./
But this is not needed for most clients. Note: packages on miroslav.suchy.cz are not signed.
And then register with your Spacewalk server using rhnreg_ks and activation key.
vim /etc/sysconfig/rhn/up2date
rhnreg_ks --activationkey=1-my-debian-key
When updating the Apt cache you can watch the status of communication between Apt and Spacewalk.
apt-get update
Finally, you rhnpush your favourite Debian packages to your Spacewalk server in order to be able to apply them using the Spacewalk WebUI. You can push packages from your Spacewalk server. There is no needed to run rhnpush on Debian machine.
Note that for Debian clients neither Spacewalk proxy, satellite-sync, repo-sync, source packages nor staging content will work.
See Solaris Support.
