4.8.2 Configuring Ksplice Offline Clients

Once you have set up a local yum server that can act as a Ksplice mirror, you can configure your other systems to receive yum and Ksplice updates.

To configure a system as a Ksplice offline client:

  1. In the /etc/yum.repos.d directory, edit the existing repository file, such as public-yum-ol6.repo or ULN-base.repo, and disable all entries by setting enabled=0.

  2. In the /etc/yum.repos.d directory, create the file local-yum.repo, which contains entries such as the following for an Oracle Linux 6 client:

    [ol6_x86_64_ksplice]
    name=Ksplice for $releasever - $basearch
    baseurl=http://local_yum_server/yum/OracleLinux/OL6/ksplice/$basearch/
    gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY
    gpgcheck=1
    enabled=1
    
    [ol6_latest]
    name=Oracle Linux $releasever - $basearch - latest
    baseurl=http://local_yum_server/yum/OracleLinux/OL6/latest/$basearch/
    gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY
    gpgcheck=1
    enabled=1
    
    [ol6_addons]
    name=Oracle Linux $releasever - $basearch - addons
    baseurl=http://local_yum_server/yum/OracleLinux/OL6/addons/$basearch/
    gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY
    gpgcheck=1
    enabled=0
    
    [ol6_oracle]
    name=Oracle Linux $releasever - $basearch - oracle
    baseurl=http://local_yum_server/yum/OracleLinux/OL6/oracle/$basearch/
    gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY
    gpgcheck=1
    enabled=0
    
    [ol6_ga_base]
    name=Oracle Linux $releasever GA - $basearch - base
    baseurl=http://local_yum_server/yum/OracleLinux/OL6/0/base/$basearch/
    gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY
    gpgcheck=1
    enabled=0
    
    [ol6_u1_base]
    name=Oracle Linux $releasever U1 - $basearch - base
    baseurl=http://local_yum_server/yum/OracleLinux/OL6/1/base/$basearch/
    gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY
    gpgcheck=1
    enabled=0
    
    [ol6_u2_base]
    name=Oracle Linux $releasever U2 - $basearch - base
    baseurl=http://local_yum_server/yum/OracleLinux/OL6/2/base/$basearch/
    gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY
    gpgcheck=1
    enabled=0
    
    [ol6_u3_base]
    name=Oracle Linux $releasever U3 - $basearch - base
    baseurl=http://local_yum_server/yum/OracleLinux/OL6/3/base/$basearch/
    gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY
    gpgcheck=1
    enabled=0
    
    [ol6_ga_patch]
    name=Oracle Linux $releasever GA - $basearch - patch
    baseurl=http://local_yum_server/yum/OracleLinux/OL6/0/patch/$basearch/
    gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY
    gpgcheck=1
    enabled=0
    
    [ol6_u1_patch]
    name=Oracle Linux $releasever U1 - $basearch - patch
    baseurl=http://local_yum_server/yum/OracleLinux/OL6/1/patch/$basearch/
    gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY
    gpgcheck=1
    enabled=0
    
    [ol6_u2_patch]
    name=Oracle Linux $releasever U2 - $basearch - patch
    baseurl=http://local_yum_server/yum/OracleLinux/OL6/2/patch/$basearch/
    gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY
    gpgcheck=1
    enabled=0
    
    [ol6_u3_patch]
    name=Oracle Linux $releasever U3 - $basearch - patch
    baseurl=http://local_yum_server/yum/OracleLinux/OL6/3/patch/$basearch/
    gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY
    gpgcheck=1
    enabled=0

    Replace local_yum_server with the IP address or resolvable host name of the local yum server.

    In the sample configuration, only the ol6_latest and ol6_x86_64_ksplice channels are enabled.

    Note

    As an alternative to specifying a gpgkey entry for each repository definition, you can use the following command to import the GPG key:

    # rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY

  3. Install the Ksplice offline client.

    # yum install uptrack-offline

    If yum cannot connect to the local yum server, check that the firewall settings on that server allow incoming TCP connections to port 80.

  4. Install the Ksplice updates that are available for the kernel.

    # yum install uptrack-updates-`uname -r`

    For an Oracle Linux 5 client, use this form of the command instead:

    # yum install uptrack-updates-`uname -r`.`uname -m`

    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 a cron job to perform this task. For example, the following crontab entry for root runs the command once per day at 7am:

    0 7 * * * yum install uptrack-updates-`uname -r`

To display information about Ksplice updates, use the rpm -qa | grep uptrack-updates and uptrack-show commands.