RHEL7 PACKAGING GUIDE

This guide covers building packages of the NVIDIA driver for Red Hat Enterprise Linux (RHEL) 7 and related derivatives.

Multiple driver branches are installable from a single package repository using "flavors". The user can choose a specific driver branch or a virtual branch. Only updates on the selected branch will be considered, where the latest and latest-dkms flavors always update to the highest versioned driver release. While the XXX flavors lock driver updates to the specified driver branch. Note: a XXX-dkms flavor is not available for RHEL7.
Simplified switching between driver branches via a yum plugin that complements installation and uninstallation of driver packages.
Special kernel module packages can be optionally built that implement an alternative to DKMS. The new approach does not require gcc to be installed anymore, nor does the EPEL repository need to be enabled. The source files for the driver kmod packages are compiled in advance and then linked at installation time, hence these are called "precompiled drivers".

Prerequisites
Building packages
Create repository
Pre-install actions
Package manager installation
References

Prerequisites

NVIDIA driver runfile

Datacenter location: http://us.download.nvidia.com/tesla/ (not browsable)

ex: http://us.download.nvidia.com/tesla/440.33.01/NVIDIA-Linux-x86_64-440.33.01.run
UDA location: http://download.nvidia.com/XFree86/Linux-x86_64/

ex: http://download.nvidia.com/XFree86/Linux-x86_64/440.64/NVIDIA-Linux-x86_64-440.64.run
GRID runfiles: NVIDIA-Linux-${arch}-${driver}-grid.run are compatible.

ex: NVIDIA-Linux-aarch64-455.04.18-grid.run

CUDA runfiles: cuda_${toolkit}_${driver}_linux.run are not compatible.

However a NVIDIA driver runfile can be extracted intact from a CUDA runfile:

sh cuda_${toolkit}_${driver}_linux.run --tar mxvf
> ex: sh cuda_11.2.2_460.32.03_linux.run --tar mxvf

ls builds/NVIDIA-Linux-${arch}-${driver}.run
> ex: ls builds/NVIDIA-Linux-x86_64-460.32.03.run

Set global variables

notes:

$arch is x86_64, ppc64le, or aarch64 (sbsa)

$major is the first . delimited field in the driver version,
ex: 460 in 460.32.03

$extension is bz2 OR gz depending on the tarballs downloaded

$KERNEL is string including distro tag and architecture,
ex: 4.18.0-193.28.1.el7.aarch64

Supports: NVIDIA-Linux-${arch}-${version}-grid.run

export version="460.32.03"
export VERSION="$version"
export major="460"
export arch="x86_64"
export extension="bz2"
export KERNEL=$(uname -r)
export IGNORE_CC_MISMATCH=1
export RUN_FILE="/path/to/NVIDIA-Linux-*.run"
export OUTPUT="$HOME/rpm-nvidia"
mkdir -p "$OUTPUT"

Install build dependencies

note: Enable EPEL to install DKMS

sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-$(rpm -E %rhel).noarch.rpm

note: store the package list in an array (easy copy & paste)

# Packaging
list=("rpm-build")  
# Kernel modules (dkms-nvidia, precompiled-kmod)
list+=("dkms")
# Kernel headers and source code (precompiled-kmod)
list+=("kernel-headers-$KERNEL" "kernel-devel-$KERNEL")  
# Compilation
list+=("m4" "gcc")
# Misc (nvidia-driver & nvidia-persistenced)
list+=("libappstream-glib" "libtirpc-devel")  
# Python (nvidia-plugin)
list+=("python36")
# Repository metadata
list+=("createrepo" "openssl")  
# Desktop integration (nvidia-settings)
list+=("gtk2-devel" "gtk3-devel" "jansson-devel" "dbus-devel" "desktop-file-utils")
# X.org utilties (nvidia-settings)
list+=("libXext-devel" "libXrandr-devel")
# GLVND (nvidia-settings)
list+=("mesa-libGL-devel" "mesa-libEGL-devel")
# Video extensions (nvidia-settings)
list+=("libXxf86vm-devel" "libXv-devel" "libvdpau-devel")  
# Install all the build dependencies
sudo yum install ${list[@]}

> ex: sudo yum install -y rpm-build dkms m4 gcc \
kernel-headers-$KERNEL kernel-devel-$KERNEL \
libappstream-glib libtirpc-devel python36 createrepo openssl \
gtk2-devel gtk3-devel jansson-devel dbus-devel desktop-file-utils \
libXext-devel libXrandr-devel mesa-libGL-devel mesa-libEGL-devel \
libXxf86vm-devel libXv-devel libvdpau-devel

Clone git repositories

note: for RHEL7-derivatives, checkout rhel7 branch

git clone -b rhel7 https://github.com/NVIDIA/yum-packaging-nvidia-driver
git clone -b rhel7 https://github.com/NVIDIA/yum-packaging-dkms-nvidia
git clone -b rhel7 https://github.com/NVIDIA/yum-packaging-nvidia-kmod-common
git clone -b rhel7 https://github.com/NVIDIA/yum-packaging-nvidia-modprobe
git clone -b rhel7 https://github.com/NVIDIA/yum-packaging-nvidia-persistenced
git clone -b rhel7 https://github.com/NVIDIA/yum-packaging-nvidia-settings
git clone -b rhel7 https://github.com/NVIDIA/yum-packaging-nvidia-xconfig
git clone -b rhel7 https://github.com/NVIDIA/yum-packaging-nvidia-plugin
git clone -b rhel7 https://github.com/NVIDIA/yum-packaging-precompiled-kmod

Building packages

nvidia-driver

Generate tarballs from runfile

note: make sure $VERSION variable is set

cd yum-packaging-nvidia-driver
rm -rf temp
./nvidia-generate-tarballs-${arch}.sh

note: please wait, this step will take several minutes to complete

ls *.tar.xz
> nvidia-driver-${version}-${arch}.tar.xz  # x86_64 script does not have -${arch} suffix
> nvidia-driver-${version}-i386.tar.xz     # 32-bit libraries for x86_64 only
> nvidia-kmod-${version}-${arch}.tar.xz    # not used here

rpmbuild (one or more flavors)

cd yum-packaging-nvidia-driver
mkdir BUILD BUILDROOT RPMS SRPMS SOURCES SPECS
cp *.rules SOURCES/
cp *.conf SOURCES/
cp nvidia-driver-${version}-${arch}.tar.xz SOURCES/
cp nvidia-driver.spec SPECS/  
# latest-dkms
rpmbuild \
    --define "%_topdir $(pwd)" \
    --define "debug_package %{nil}" \
    --define "version $version" \
    --define "driver_branch latest-dkms" \
    --define "is_dkms 1" \
    --define "is_latest 1" \
    --define "is_grid 1" \
    --define "epoch 3" \
    --target "${arch}" \
    -v -bb SPECS/nvidia-driver.spec  
# latest
rpmbuild \
    --define "%_topdir $(pwd)" \
    --define "debug_package %{nil}" \
    --define "version $version" \
    --define "driver_branch latest" \
    --define "is_dkms 0" \
    --define "is_latest 1" \
    --define "is_grid 1" \
    --define "epoch 3" \
    --target "${arch}" \
    -v -bb SPECS/nvidia-driver.spec  
# branch-XXX
rpmbuild \
    --define "%_topdir $(pwd)" \
    --define "debug_package %{nil}" \
    --define "version $version" \
    --define "driver_branch branch-$major" \
    --define "is_dkms 0" \
    --define "is_latest 0" \
    --define "is_grid 1" \
    --define "epoch 3" \
    --target "${arch}" \
    -v -bb SPECS/nvidia-driver.spec  
find -name "*.rpm" -exec cp -v {} $OUTPUT/ \;
cd -

dkms-nvidia

nvidia-kmod tarball

Copy tarball from yum-packaging-nvidia-driver

cd yum-packaging-dkms-nvidia
rsync -av ../yum-packaging-nvidia-driver/nvidia-kmod-${version}-${arch}.tar.xz $PWD/
cd -

or

Generate tarball from runfile

cd yum-packaging-dkms-nvidia
sh "$RUN_FILE" --extract-only --target extract
mkdir nvidia-kmod-${version}-${arch}
mv extract/kernel nvidia-kmod-${version}-${arch}/
tar -cJf nvidia-kmod-${version}-${arch}.tar.xz nvidia-kmod-${version}-${arch}
cd -

rpmbuild

cd yum-packaging-dkms-nvidia
mkdir BUILD BUILDROOT RPMS SRPMS SOURCES SPECS
cp dkms-nvidia.conf SOURCES/
cp nvidia-kmod-${version}-${arch}.tar.xz SOURCES/
cp dkms-nvidia.spec SPECS/  
# latest-dkms
rpmbuild \
    --define "%_topdir $(pwd)" \
    --define "debug_package %{nil}" \
    --define "version $version" \
    --define "driver_branch latest-dkms" \
    --define "is_dkms 1" \
    --define "is_latest 1" \
    --define "epoch 3" \
    --target "${arch}" \
    -v -bb SPECS/dkms-nvidia.spec  
find -name "*.rpm" -exec cp -v {} $OUTPUT/ \;
cd -

nvidia-kmod-common

rpmbuild

cd yum-packaging-nvidia-kmod-common
mkdir BUILD BUILDROOT RPMS SRPMS SOURCES SPECS
cp 60-nvidia.rules SOURCES/
cp 99-nvidia.conf SOURCES/
cp nvidia.conf SOURCES/
cp nvidia-kmod-common.spec SPECS/  
rpmbuild \
    --define "%_topdir $(pwd)" \
    --define "debug_package %{nil}" \
    --define "version $version" \
    --define "epoch 3" \
    --target "noarch" \
    -v -bb SPECS/nvidia-kmod-common.spec  
find -name "*.rpm" -exec cp -v {} $OUTPUT/ \;
cd -

nvidia-modprobe

rpmbuild (one or more flavors)

cd yum-packaging-nvidia-modprobe
mkdir BUILD BUILDROOT RPMS SRPMS SOURCES SPECS
cp ../nvidia-modprobe-${version}.tar.* SOURCES/
cp *.patch SOURCES/
cp nvidia-modprobe.spec SPECS/  
# latest-dkms
rpmbuild \
    --define "%_topdir $(pwd)" \
    --define "debug_package %{nil}" \
    --define "version $version" \
    --define "driver_branch latest-dkms" \
    --define "is_dkms 1" \
    --define "is_latest 1" \
    --define "epoch 3" \
    --define "extension $extension" \
    -v -bb SPECS/nvidia-modprobe.spec  
# latest
rpmbuild \
    --define "%_topdir $(pwd)" \
    --define "debug_package %{nil}" \
    --define "version $version" \
    --define "driver_branch latest" \
    --define "is_dkms 0" \
    --define "is_latest 1" \
    --define "epoch 3" \
    --define "extension $extension" \
    -v -bb SPECS/nvidia-modprobe.spec  
# branch-XXX
rpmbuild \
    --define "%_topdir $(pwd)" \
    --define "debug_package %{nil}" \
    --define "version $version" \
    --define "driver_branch branch-${major}" \
    --define "is_dkms 0" \
    --define "is_latest 0" \
    --define "epoch 3" \
    --define "extension $extension" \
    -v -bb SPECS/nvidia-modprobe.spec  
find -name "*.rpm" -exec cp -v {} $OUTPUT/ \;
cd -

nvidia-persistenced

rpmbuild (one or more flavors)

cd yum-packaging-nvidia-persistenced
mkdir BUILD BUILDROOT RPMS SRPMS SOURCES SPECS
cp ../nvidia-persistenced-${version}.tar.* SOURCES/
cp *init* SOURCES/
cp *.service SOURCES/
cp nvidia-persistenced.spec SPECS/  
# latest-dkms
rpmbuild \
    --define "%_topdir $(pwd)" \
    --define "debug_package %{nil}" \
    --define "version $version" \
    --define "driver_branch latest-dkms" \
    --define "is_dkms 1" \
    --define "is_latest 1" \
    --define "epoch 3" \
    --define "extension $extension" \
    -v -bb SPECS/nvidia-persistenced.spec  
# latest
rpmbuild \
    --define "%_topdir $(pwd)" \
    --define "debug_package %{nil}" \
    --define "version $version" \
    --define "driver_branch latest" \
    --define "is_dkms 0" \
    --define "is_latest 1" \
    --define "epoch 3" \
    --define "extension $extension" \
    -v -bb SPECS/nvidia-persistenced.spec  
# branch-XXX
rpmbuild \
    --define "%_topdir $(pwd)" \
    --define "debug_package %{nil}" \
    --define "version $version" \
    --define "driver_branch branch-${major}" \
    --define "is_dkms 0" \
    --define "is_latest 0" \
    --define "epoch 3" \
    --define "extension $extension" \
    -v -bb SPECS/nvidia-persistenced.spec  
find -name "*.rpm" -exec cp -v {} $OUTPUT/ \;
cd -

nvidia-settings

rpmbuild

cd yum-packaging-nvidia-settings
mkdir BUILD BUILDROOT RPMS SRPMS SOURCES SPECS
cp ../nvidia-settings-${version}.tar.* SOURCES/
cp *.desktop SOURCES/
cp *.patch SOURCES/
cp *.xml SOURCES/
cp nvidia-settings.spec SPECS/  
rpmbuild \
    --define "%_topdir $(pwd)" \
    --define "debug_package %{nil}" \
    --define "version $version" \
    --define "epoch 3" \
    --define "extension $extension" \
    -v -bb SPECS/nvidia-settings.spec  
find -name "*.rpm" -exec cp -v {} $OUTPUT/ \;
cd -

nvidia-xconfig

rpmbuild

cd yum-packaging-nvidia-xconfig
mkdir BUILD BUILDROOT RPMS SRPMS SOURCES SPECS
cp ../nvidia-xconfig-${version}.tar.* SOURCES/
cp *.patch SOURCES/
cp nvidia-xconfig.spec SPECS/  
# latest-dkms
rpmbuild \
    --define "%_topdir $(pwd)" \
    --define "debug_package %{nil}" \
    --define "version $version" \
    --define "driver_branch latest-dkms" \
    --define "is_dkms 1" \
    --define "is_latest 1" \
    --define "epoch 3" \
    --define "extension $extension" \
    -v -bb SPECS/nvidia-xconfig.spec  
# latest
rpmbuild \
    --define "%_topdir $(pwd)" \
    --define "debug_package %{nil}" \
    --define "version $version" \
    --define "driver_branch latest" \
    --define "is_dkms 0" \
    --define "is_latest 1" \
    --define "epoch 3" \
    --define "extension $extension" \
    -v -bb SPECS/nvidia-xconfig.spec  
# branch-XXX
rpmbuild \
    --define "%_topdir $(pwd)" \
    --define "debug_package %{nil}" \
    --define "version $version" \
    --define "driver_branch branch-${major}" \
    --define "is_dkms 0" \
    --define "is_latest 0" \
    --define "epoch 3" \
    --define "extension $extension" \
    -v -bb SPECS/nvidia-xconfig.spec  
find -name "*.rpm" -exec cp -v {} $OUTPUT/ \;
cd -

nvidia-plugin

rpmbuild (yum-plugin-nvidia)

cd yum-packaging-nvidia-plugin
mkdir BUILD BUILDROOT RPMS SRPMS SOURCES SPECS
cp nvidia.conf SOURCES/
cp nvidia-yum.py SOURCES/
cp yum-plugin-nvidia.spec SPECS/  
rpmbuild \
    --define "%_topdir $(pwd)" \
    --define "debug_package %{nil}" \
    -v -bb SPECS/yum-plugin-nvidia.spec  
find -name "*.rpm" -exec cp -v {} $OUTPUT/ \;
cd -

precompiled-kmod

note: this is an optional step

nvidia-kmod tarball

Copy tarball from yum-packaging-nvidia-driver

cd yum-packaging-precompiled-kmod
rsync -av ../yum-packaging-nvidia-driver/nvidia-kmod-${version}-${arch}.tar.xz $PWD/

or

Generate tarball from runfile

cd yum-packaging-precompiled-kmod
sh "$RUN_FILE" --extract-only --target extract
mkdir nvidia-kmod-${version}-${arch}
mv extract/kernel nvidia-kmod-${version}-${arch}/
tar -cJf nvidia-kmod-${version}-${arch}.tar.xz nvidia-kmod-${version}-${arch}

X.509 Certificate

Generate X.509 public_key.der and private_key.priv files.

Example x509-configuration.ini. Replace $USER and $EMAIL values.

cd yum-packaging-precompiled-kmod
openssl req -x509 -new -nodes -utf8 -sha256 -days 36500 -batch \
  -config x509-configuration.ini \
  -outform DER -out public_key.der \
  -keyout private_key.priv

Parse kernel string

export kernel_main=$(echo "$KERNEL" | awk -F "-" '{print $1}')
export kernel_suffix=$(echo "$KERNEL" | awk -F "-" '{print $2}' | sed "s|\.$arch||")
export kernel_dist=$(echo "$kernel_suffix" | awk -F "." '{print $NF}')
export kernel_release=$(echo "$kernel_suffix" | sed "s|\.$kernel_dist||")  
> ex:
kernel_main="4.18.0"
kernel_release="193.28.1"
kernel_dist="el7"

rpmbuild

note: compilation may take up to 10 minutes (depending on hardware)

cd yum-packaging-precompiled-kmod
mkdir BUILD BUILDROOT RPMS SRPMS SOURCES SPECS
cp nvidia-kmod-${version}-${arch}.tar.xz SOURCES/
cp public_key.der SOURCES/
cp private_key.priv SOURCES/
cp kmod-nvidia.spec SPECS/  
# latest
rpmbuild \
    --define "%_topdir $(pwd)" \
    --define "debug_package %{nil}" \
    --define "kernel $kernel_main" \
    --define "kernel_release $kernel_release" \
    --define "kernel_dist $kernel_dist" \
    --define "driver $version" \
    --define "epoch 3" \
    --define "driver_branch latest"
    --target ${arch}
    -v -bb SPECS/kmod-nvidia.spec  
# branch-XXX
rpmbuild \
    --define "%_topdir $(pwd)" \
    --define "debug_package %{nil}" \
    --define "kernel $kernel" \
    --define "kernel_release $release" \
    --define "kernel_dist $dist" \
    --define "driver $version" \
    --define "epoch 3" \
    --define "driver_branch branch-${major}" \
    --target ${arch}
    -v -bb SPECS/kmod-nvidia.spec  
find -name "*.rpm" -exec cp -v {} $OUTPUT/ \;
cd -

Create repository

Generate metadata

mkdir my-custom-repo
# NVIDIA driver packages
cp -v $OUTPUT/*.rpm my-custom-repo/

createrepo -v --database my-custom-repo

Enable local repo

Create custom.repo file

[custom]
name=custom
baseurl=file:///path/to/my-custom-repo
enabled=1
gpgcheck=0

Copy to system path for yum package manager
```
sudo cp custom.repo /etc/yum.repos.d/
```
Clean yum cache
```
sudo yum clean all
```

Pre-install actions

Remove any existing NVIDIA driver installation

To uninstall a CUDA toolkit runfile installation
```
sudo /usr/local/cuda-X.Y/bin/cuda-uninstall
```
To uninstall a standalone NVIDIA driver runfile installation:
```
sudo /usr/bin/nvidia-uninstall
```

To uninstall an RPM installation:

sudo yum remove "*nvidia-driver*" "*nvidia-settings*"

To disable CUDA repository:

sudo yum-config-manager --set-disabled cuda

Package manager installation

RHEL7 flavors: latest, branch-XXX, latest-dkms

sudo yum install nvidia-driver-${flavor}
> ex: sudo yum install nvidia-driver-latest

Then to install nvidia-settings

sudo yum install cuda-drivers

Select an installation branch

To select an installation branch, choose only one from the three options below:

Always update to the highest versioned driver (precompiled).
```
sudo yum install nvidia-driver-latest
```
Lock the driver updates to the specified driver branch (precompiled).
```
sudo yum install nvidia-driver-branch-XXX
```
note: XXX is the first . delimited field in the driver version, ex: 460 in 460.32.03

Always update to the highest versioned driver (non-precompiled).
```
sudo yum install nvidia-driver-latest-dkms
```
note: DKMS install uses compilation for kmod-nvidia-latest-dkms package (make take up to 10 minutes depending on hardware)

References

Presentations: https://github.com/NVIDIA/yum-packaging-precompiled-kmod#Presentations
Report a bug: https://developer.nvidia.com/nvidia_bug/add

note: If you are not already a member, join the NVIDIA Developer Program: https://developer.nvidia.com/join

RHEL7 PACKAGING GUIDE

Table of Contents

Prerequisites

Download inputs

NVIDIA driver runfile

NVIDIA modprobe tarball

NVIDIA persistenced tarball

NVIDIA setttings tarball

NVIDIA xconfig tarball

Set global variables

Install build dependencies

Clone git repositories

Building packages

nvidia-driver

Generate tarballs from runfile

rpmbuild (one or more flavors)

dkms-nvidia

nvidia-kmod tarball

or

rpmbuild

nvidia-kmod-common

rpmbuild

nvidia-modprobe

rpmbuild (one or more flavors)

nvidia-persistenced

rpmbuild (one or more flavors)

nvidia-settings

rpmbuild

nvidia-xconfig

rpmbuild

nvidia-plugin

rpmbuild (yum-plugin-nvidia)

precompiled-kmod

nvidia-kmod tarball

or

X.509 Certificate

Parse kernel string

rpmbuild

Create repository

Generate metadata

Enable local repo

Pre-install actions

Remove any existing NVIDIA driver installation

Package manager installation

Select an installation branch

References