5.2 KiB
Installation
Table of contents
Prerequisites
Before starting, see Supported Architectures and check if your device's architecture is supported.
Fedora, RHEL, CentOS
NOTE: You'll need about 15GB of free disk space for the kpatch-build cache in
~/.kpatch and for ccache.
Install the dependencies for compiling kpatch and running kpatch-build:
source test/integration/lib.sh
# Will request root privileges
kpatch_dependencies
Oracle Linux 7
NOTE: You'll need about 15GB of free disk space for the kpatch-build cache in
~/.kpatch and for ccache.
Install the dependencies for compiling kpatch:
UNAME=$(uname -r)
sudo yum install gcc kernel-devel-${UNAME%.*} elfutils elfutils-devel
Install the dependencies for the "kpatch-build" command:
sudo yum install pesign yum-utils zlib-devel \
binutils-devel newt-devel python-devel perl-ExtUtils-Embed \
audit-libs numactl-devel pciutils-devel bison patchutils
# enable ol7_optional_latest repo
sudo yum-config-manager --enable ol7_optional_latest
sudo yum-builddep kernel-${UNAME%.*}
# manually install kernel debuginfo packages
rpm -ivh https://oss.oracle.com/ol7/debuginfo/kernel-debuginfo-$(uname -r).rpm
rpm -ivh https://oss.oracle.com/ol7/debuginfo/kernel-debuginfo-common-x86_64-$(uname -r).rpm
# optional, but highly recommended - enable EPEL 7
sudo yum install ccache
ccache --max-size=5G
Ubuntu
NOTE: You'll need about 15GB of free disk space for the kpatch-build cache in
~/.kpatch and for ccache.
Install the dependencies for compiling kpatch and running kpatch-build
source test/integration/lib.sh
# required on ppc64le
# e.g., on Ubuntu 18.04 for gcc-7.3
apt-get install gcc-7-plugin-dev
# Will request root privileges
kpatch_dependencies
Debian 9 (Stretch)
Since Stretch the stock kernel can be used without changes, however the version of kpatch in Stretch is too old so you still need to build it manually. Follow the instructions for Debian Jessie (next section) but skip building a custom kernel/rebooting.
Debian 8 (Jessie)
NOTE: You'll need about 15GB of free disk space for the kpatch-build cache in
~/.kpatch and for ccache.
Install the dependencies for compiling kpatch:
apt-get install make gcc libelf-dev build-essential
Install and prepare the kernel sources:
apt-get install linux-source-$(uname -r)
cd /usr/src && tar xvf linux-source-$(uname -r).tar.xz && ln -s linux-source-$(uname -r) linux && cd linux
cp /boot/config-$(uname -r) .config
for OPTION in CONFIG_KALLSYMS_ALL CONFIG_FUNCTION_TRACER ; do sed -i "s/# $OPTION is not set/$OPTION=y/g" .config ; done
sed -i "s/^SUBLEVEL.*/SUBLEVEL =/" Makefile
make -j`getconf _NPROCESSORS_CONF` deb-pkg KDEB_PKGVERSION=$(uname -r).9-1
Install the kernel packages and reboot
dpkg -i /usr/src/*.deb
reboot
Install the dependencies for the "kpatch-build" command:
apt-get install dpkg-dev
apt-get build-dep linux
# required on ppc64le
# e.g., on stretch for gcc-6.3
apt-get install gcc-6-plugin-dev
# optional, but highly recommended
apt-get install ccache
ccache --max-size=5G
Debian 7 (Lenny)
NOTE: You'll need about 15GB of free disk space for the kpatch-build cache in
~/.kpatch and for ccache.
Add backports repositories:
echo "deb http://http.debian.net/debian wheezy-backports main" > /etc/apt/sources.list.d/wheezy-backports.list
echo "deb http://packages.incloudus.com backports-incloudus main" > /etc/apt/sources.list.d/incloudus.list
wget http://packages.incloudus.com/incloudus/incloudus.pub -O- | apt-key add -
aptitude update
Install the linux kernel, symbols and gcc 4.9:
aptitude install -t wheezy-backports -y initramfs-tools
aptitude install -y gcc gcc-4.9 g++-4.9 linux-image-3.14 linux-image-3.14-dbg
Configure gcc 4.9 as the default gcc compiler:
update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.7 20
update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.9 50
update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-4.7 20
update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-4.9 50
Install kpatch and these dependencies:
aptitude install kpatch
Configure ccache (installed by kpatch package):
ccache --max-size=5G
Gentoo
NOTE: You'll need about 15GB of free disk space for the kpatch-build cache in
~/.kpatch and for ccache.
Install Kpatch and Kpatch dependencies:
emerge --ask sys-kernel/kpatch
Install ccache (optional):
emerge --ask dev-util/ccache
Configure ccache:
ccache --max-size=5G
Build
Compile kpatch:
make
Install
OPTIONAL: Install kpatch to /usr/local:
sudo make install
Alternatively, the kpatch and kpatch-build scripts can be run directly from the git tree.