5.2 Installing the Spacewalk Client Software and Registering a Client System Using rhnreg

The software described in this documentation is either no longer supported or is in extended support.
Oracle recommends that you upgrade to a current supported release.

5.2 Installing the Spacewalk Client Software and Registering a Client System Using rhnreg_ks

Note

Starting with Oracle Linux 7 Update 1, you do not need to install the Spacewalk Client 2.4 software before you register an Oracle Linux 7 or Oracle Linux 6 server with Spacewalk. See Section 5.3, “Registering a Client System Using rhnreg_ks Without First Installing the Spacewalk Client Software”.

To install the Spacewalk Client 2.4 software on an Oracle Linux server and register the server as a Spacewalk client:

Enable access to the Spacewalk Client repository.
Download the latest the yum repository configuration file from https://yum.oracle.com/ and save it to the yum repositories directory (by default /etc/yum.repos.d). Edit the configuration file and enable the repository:
- For Oracle Linux 7, enable the ol7_spacewalk24_client repository.
  Alternatively, create a /etc/yum.repos.d/spacewalk24-client.repo file with the following content:
```
[ol7_spacewalk24_client]
name=Spacewalk Client 2.4 for Oracle Linux 7 ($basearch)
baseurl=https://yum.oracle.com/repo/OracleLinux/OL7/spacewalk24/client/$basearch/
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-oracle
gpgcheck=1
enabled=1
```
- For Oracle Linux 6, enable the ol6_spacewalk24_client repository.
  Alternatively, create a /etc/yum.repos.d/spacewalk24-client.repo file with the following content:
```
[ol6_spacewalk24_client]
name=Spacewalk Client 2.4 for Oracle Linux 6 ($basearch)
baseurl=https://yum.oracle.com/repo/OracleLinux/OL6/spacewalk24/client/$basearch/
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-oracle
gpgcheck=1
enabled=1
```
- For Oracle Linux 5, enable the ol5_spacewalk24_client repository.
  Alternatively, create a /etc/yum.repos.d/spacewalk24-client.repo file with the following content:
```
[ol5_spacewalk24_client]
name=Spacewalk Client 2.4 for Oracle Linux 5 ($basearch)
baseurl=https://yum.oracle.com/repo/OracleLinux/OL5/spacewalk24/client/$basearch/
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-oracle
gpgcheck=1
enabled=1
```
For Oracle Linux 5 only, use the rpm -e --nodeps command to remove the pirut, up2date, and up2date-gnome packages.
```
# rpm -e --nodeps pirut up2date up2date-gnome
```
Install the Spacewalk Client software:
```
# yum install rhn-client-tools rhn-check rhn-setup rhnsd m2crypto yum-rhn-plugin
```
This command replaces the existing packages and deletes any previous registration with ULN.
Download the CA certificate file RHN-ORG-TRUSTED-SSL-CERT to the server.
In a browser tab, navigate to http://swksvr_FQDN/pub, where swksvr_FQDN is the fully qualified domain name of the Spacewalk server, and download the CA certificate file RHN-ORG-TRUSTED-SSL-CERT to /usr/share/rhn/.
You can download the file by using wget from the command line, for example:
```
# wget -q -O /usr/share/rhn/RHN-ORG-TRUSTED-SSL-CERT \
  http://swksvr_FQDN/pub/RHN-ORG-TRUSTED-SSL-CERT
```
Alternatively, you can install the package that is automatically generated when you install SSL certificates, for example:
```
# yum install http://swksvr_FQDN/pub/rhn-org-trusted-ssl-cert-1.0-1.noarch.rpm
```
You might need to specify a different URL if you replaced the SSL certificates after installing and configuring the Spacewalk server software.
Register the system with Spacewalk using the rhnreg_ks command, using the --sslCACert option to specify the certificate.
```
# rhnreg_ks --sslCACert=/usr/share/rhn/RHN-ORG-TRUSTED-SSL-CERT \
  --serverUrl=https://swksvr_FQDN/XMLRPC --activationkey=activation_key
```
Specify the Spacewalk server or proxy by its fully qualified domain name.
If you need to re-register a Spacewalk client with a Spacewalk server, additionally specify the --force option.
Disable access to the Spacewalk Client repository in the Oracle Linux yum server repository configuration file, or delete /etc/yum.repos.d/spacewalk24-client.repo.