3.2 Installing the Ksplice Enhanced Client

Note

The Ksplice Enhanced client is available for Oracle Linux 6 and Oracle Linux 7. The enhanced client is not currently available for Oracle Linux 5. The Ksplice Enhanced client is available as either an online client that requires the server to have a direct connection to the Oracle Uptrack server, or alternately an offline client that requires access to a local ULN mirror.

The system on which you install the enhanced Ksplice client must meet the following criteria:

  • The system must have access to the Internet or a host that is running a local ULN mirror.

  • The system must be registered with ULN or must have access to the ULN channels on a mirror.

  • The operating system must be Oracle Linux 6 or Oracle Linux 7 with a supported version of either the Unbreakable Enterprise Kernel or the Red Hat Compatible Kernel installed. You can verify the kernel version by using the uname -a command. See Section 1.2.1, “Supported Kernels”.

  • The kernel that is running currently is assumed to be the one that you want to update. Ksplice applies updates only to the running kernel.

To install the enhanced Ksplice client and Ksplice-aware libraries from ULN:

  1. Using a browser, log in at http://linux.oracle.com with the ULN user name and password that you used to register the system, and perform the following steps:

    1. On the Systems tab, click the link named for your system in the list of registered machines.

    2. On the System Details page, click Manage Subscriptions.

      The enhanced Ksplice client and Ksplice-aware user space packages are available in the following channels on ULN:

      • Ksplice for Oracle Linux 6 (x86_64) (ol6_x86_64_ksplice)

      • Ksplice for Oracle Linux 7 (x86_64) (ol7_x86_64_ksplice)

      • Ksplice aware user space packages for Oracle Linux 6 (x86_64) (ol6_x86_64_userspace_ksplice)

      • Ksplice aware userspace packages for Oracle Linux 7 (x86_64) (ol7_x86_64_userspace_ksplice)

    3. On the System Summary page, select both the User space Ksplice and the Ksplice channels from the list of available channels and then click the right arrow (>) to move them to the list of subscribed channels. Accept the licensing terms for the enhanced Ksplice packages.

    4. Click Save Subscriptions and log out of ULN.

  2. If you use an Internet proxy, configure the HTTP and HTTPS settings for the proxy in the shell as follows:

    • For the sh, ksh, or bash shells, use commands such as the following:

      # http_proxy=http://proxy_URL:http_port
      # https_proxy=http://proxy_URL:https_port
      # export http_proxy https_proxy

      For the csh shell, use commands such as the following:

      # setenv http_proxy=http://proxy_URL:http_port
      # setenv https_proxy=http://proxy_URL:https_port
  3. Log in as root on the system.

  4. If prelink is installed, revert all prelinked binaries and dependent libraries to their original state and use the yum command to remove the prelink package.

    # prelink -au
    # yum remove prelink
    Note

    prelink is installed and enabled by default on Oracle Linux 6 but not on Oracle Linux 7.

  5. Install the ksplice package.

    # yum install -y ksplice

    The access key for Ksplice Uptrack is retrieved from ULN and added to /etc/uptrack/uptrack.conf, as shown in the following example:

    [Auth]
    accesskey = 0e1859ad8aea14b0b4306349142ce9160353297daee30240dab4d61f4ea4e59b

    The packages that are installed on the system include the following:

    ksplice-core

    Contains the shared user space libraries, such as glibc and openssl, that support Ksplice patching.

    ksplice-helper

    Contains a helper library that enables user space executables to be patched by Ksplice.

    ksplice-helper-devel

    Contains the development environment for creating user space libraries that support Ksplice patching.

    ksplice-tools

    Contains the ksplice executable and ksplice(8) manual page.

  6. Update the system to install the Ksplice-aware versions of the user space libraries:

    # yum update

    To install only the libraries and not update any other packages, limit the update to the ol6_x86_64_userspace_ksplice or ol7_x86_64_userspace_ksplice channel, as appropriate:

    # yum --disablerepo=* --enablerepo=ol7_x86_64_userspace_ksplice update

    Alternatively, you can use the following command:

    # yum update *glibc *openssl*

    You can also use this client to perform kernel updates, in the same way that you are able to use the standard uptrack client:

    # yum install uptrack-updates-`uname -r`
  7. To enable the automatic installation of updates, change the entry in the /etc/uptrack/uptrack.conf file from no to yes, as shown in the following example:

    autoinstall = yes
  8. Reboot the system so that it uses the new libraries.

    On Oracle Linux 6:

    # reboot

    On Oracle Linux 7:

    # systemctl reboot

The enhanced client uses the same configuration file (/etc/uptrack/uptrack.conf) as Ksplice Uptrack. See Section 1.6, “Configuring a Ksplice Client”.

To manage the enhanced Ksplice client, you use the ksplice command, see Section 3.3, “Managing the Ksplice Enhanced Client”.