Prior to configuring a Ksplice Offline client, you must set up a local ULN mirror that can act as a Ksplice mirror. See Section 1.3.3, “Configuring a Local ULN Mirror to Act as a Ksplice Mirror”. After you set up a local ULN mirror that can act as a Ksplice mirror, you can configure your other systems to receive yum and Ksplice updates.
You can also configure Ksplice Offline Clients by creating software channels in Spacewalk that can act as a Ksplice mirror. For instructions, see "Installing and Configuring Existing Client Systems as Ksplice Offline Clients" in Chapter 12 of the Spacewalk 2.7 for Oracle Linux Client Life Cycle Management Guide.
To configure a system as a Ksplice Offline client by setting up a local ULN mirror:
Import the GPG key:
#
rpm --import /usr/share/rhn/RPM-GPG-KEY
Set up a local ULN mirror:
Disable any existing yum repositories configured in the
/etc/yum.repos.d
directory. You can either edit any existing repository files and disable all entries by settingenabled=0
or you can use yum-config-manager:#
yum-config-manager --disable \*
Alternately, you can rename any of the files in this directory so that they do not use the
.repo
suffix. This causes yum to ignore these entries. For example:#
cd /etc/yum.repos.d
#for i in *.repo; do mv $i $i.disabled; done
In the
/etc/yum.repos.d
directory, create the filelocal-yum.repo
, which contains entries such as the following for an Oracle Linux 6 yum client:[local_ol6_x86_64_ksplice] name=Ksplice for Oracle Linux $releasever - $basearch baseurl=http://
local_uln_mirror
/yum/OracleLinux/OL6/ksplice/$basearch/ gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY gpgcheck=1 enabled=1 [local_ol6_latest] name=Oracle Linux $releasever - $basearch - latest baseurl=http://local_uln_mirror
/yum/OracleLinux/OL6/latest/$basearch/ gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY gpgcheck=1 enabled=1 [local_ol6_UEKR3_latest] name=Unbreakable Enterprise Kernel Release 3 for Oracle Linux $releasever - $basearch - latest baseurl=http://local_uln_mirror
/yum/OracleLinux/OL6/UEKR3/latest/$basearch/ gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY gpgcheck=1 enabled=1 [local_ol6_addons] name=Oracle Linux $releasever - $basearch - addons baseurl=http://local_uln_mirror
/yum/OracleLinux/OL6/addons/$basearch/ gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY gpgcheck=1 enabled=1To distinguish the local repositories from the ULN repositories, prefix the labels of their entries with a string such as
local_
.Replace
local_uln_mirror
with the IP address or resolvable host name of the local ULN mirror.The example configuration enables the
local_ol6_x86_64_ksplice
,local_ol6_latest
,local_ol6_UEKR3_latest
, andlocal_ol6_addons
channels. Note that the Ksplice Offline client package is unable to install user-space updates, so you should not enable any*_userspace_ksplice
channels unless you intend to use the offline version of the Ksplice Enhanced client.
Install the Ksplice Offline client package:
#
yum -y install uptrack-offline
To test the configuration:
Clear the
yum
metadata cache:#
yum clean metadata
Use the yum repolist command to verify the configuration, for example:
#
yum repolist
Loaded plugins: rhnplugin, security This system is receiving updates from ULN. 0 packages excluded due to repository protections repo id repo name status local_ol6_addons Oracle Linux 6 - x86_64 - latest 112 local_ol6_x86_64_ksplice Ksplice for Oracle Linux 6 - x86_64 961 local_ol6_x86_64_latest Oracle Linux 6 - x86_64 - latest 17,976 local_ol6_x86_64_UEKR3_latest Unbreakable Enterprise Kernel Release 3 for Oracle Linux 6 - x86_64 - latest 41If yum cannot connect to the local ULN mirror, check that the firewall settings on the local ULN mirror server allow incoming TCP connections to the HTTP port (usually, port 80).
Install the Ksplice updates that are available for the kernel.
For an Oracle Linux 5 client, use this command:
#
yum -y install uptrack-updates-`uname -r`.`uname -m`
For an Oracle Linux 6 or Oracle Linux 7 client, use this command:
#
yum -y install uptrack-updates-`uname -r`
As new Ksplice updates are made available, you can use this command to pick up these updates and apply them. It is recommended that you set up an
anacron
script to perform this task. For example, the following script nameduptrack-updates
in/etc/cron.daily
on an Oracle Linux 6 system would run once every day:#!/bin/sh yum -y install uptrack-updates-`uname -r` exit 0
NoteThe script must be executable and be owned by
root
. It is important to include the-y
option for the yum command if you intend to script this, as the command hangs and waits for user input if this option is not used.
To display information about Ksplice updates, use the rpm -qa | grep uptrack-updates and uptrack-show commands.