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.

1.3.1 Installing the Spacewalk Client Software and Registering a Spacewalk Client

For an Oracle Linux server that is not yet connected to Spacewalk, install the Spacewalk client software and register the server as follows:

  1. 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:

    • Oracle Linux 7: enable the ol7_spacewalk24_client repository.

      Alternatively, you can 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

    • Oracle Linux 6: enable the ol6_spacewalk24_client repository.

      Alternatively, you can 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

    • Oracle Linux 5: enable the ol5_spacewalk24_client repository.

      Alternatively, you can 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

  2. (Oracle Linux 5 only) Remove the pirut, up2date, and up2date-gnome packages.

    Use the rpm -e --nodeps command to remove these packages.

    In your Oracle Linux 5 kickstart profiles in Spacewalk, exclude these packages from installation by inserting a dash character (-) in front of the package name in the kickstart profile on the Software, Package Group screen, for example:

    @Base
    -pirut
    -up2date
    -up2date-gnome

    You must exclude these packages to allow the Spacewalk client software to install correctly.

  3. Install the Spacewalk client software.

    Use the following command to install the Spacewalk client software on all platforms:

    # yum install rhn-client-tools rhn-check rhn-setup rhnsd m2crypto yum-rhn-plugin

    This command replaces the existing packages and deletes a registered server from ULN.

  4. Register the server with Spacewalk using the rhnreg_ks command.

    Note

    Before you can register a server, you must have already created a client activation key, as described in Section 1.2.4, “Creating Activation Keys for Spacewalk Clients”. If enabled, a universal default key can be used. However, using a specific activation key is better.

    The following steps use SSL to encrypt all communication between the client and the Spacewalk server (the recommended configuration).

    1. 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/.

      Alternatively, you can use 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
    2. 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.

  5. Disable access to the Spacewalk Client repository in the yum repository configuration file or delete your Spacewalk Client .repo file.