[Zing Trial or Installation from Repository] Using DKMS on RHEL, CentOS or Oracle Linux to build ZST for other kernel versions

Please note: Since Zing ZVM 19.07 you don't need the Zing ZST component any more on current operating system versions. See also: Do I need root or sudo rights to install Zing?

This page describes the installation using DKMS when Zing was installed from the Azul software repository as described in http://docs.azul.com/zing/index.htm#InstallZing.htm or during the Zing 30 day free trial from http://docs.azul.com/zing/zing-quick-start.htm.

If you are using the manually downloaded version of Zing, please visit the following page instead: Instructions for DKMS with Zing manually downloaded

On Amazon Linux or Debian the method utilizing DKMS as described in this article is already the default, so the instructions described on this page won't add anything and should not be used.

DKMS in general solves the situation when the Zing System Tools (ZST) are not yet available for the Linux Kernel Version of your system. In those situations, DKMS (Dynamic Kernel Module Support) then builds ZST for this specific system. DKMS is usually only required if you see the following error message when starting the Zing Memory Service:

# sudo service zing-memory restart
insmod: ERROR: could not insert module /lib/modules/zing-driver/extra/zing_mm.ko: Invalid parameters
zing-memory: ERROR: insmod /lib/modules/zing-driver/extra/zing_mm.ko failed (error 1)
zing-memory: INFO: Zing ZST support for kernel 3.8.13-118.14.2.el7.x86_64 is unavailable. Please upgrade ZST.

For most installations utilizing DKMS is not necessary as the ZST packages in the Azul software repository are updated every 24 hours in case a Linux vendor releases a new kernel update. If you can delay the upgrade of your system for this period of time until the software repository provides the updated ZST, you don't need the DKMS approach. Though for custom kernels the DKMS approach is still the preferred one.

The dkms tool is already included in Ubuntu, SLES, Debian and Amazon Linux but not directly provided by CentOS, RHEL and Oracle Linux. For those systems it should be installed from the EPEL (Extra Packages for Enterprise Linux) repository as described below. The first line uninstalls the non-DKMS Zing ZST package in case it was already installed before. If you are wondering about the path name "amazonlinux": We are using this Zing repository as it contains the DKMS version of ZST. It is compatible to other RPM based systems like RHEL or CentOS.

The following steps are intended for RHEL / CentOS / Oracle Linux 7.x. For version 6.x replace epel-release-latest-7.noarch.rpm by epel-release-latest-6.noarch.rpm.

If ZST was already installed in its non-DKMS version make a backup of its configuration and then remove the installed ZST:

# mkdir zst-config
# cp -v /etc/zing/pmem.conf.* zst-config
# sudo yum remove zing-zst

Now ZST for DKMS will be installed:

# sudo yum install yum-utils "kernel-devel-uname-r == $(uname -r)"
# sudo curl -O https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
# sudo curl -o /etc/yum.repos.d/zing.repo http://repos.azul.com/zing/amazonlinux/zing.repo
# sudo yum clean metadata dbcache
# sudo yum install epel-release-latest-7.noarch.rpm
# sudo yum-config-manager --disable epel
# sudo yum --enablerepo=epel install dkms
# sudo yum install zing-zst zing-jdk1.8.0

If you are using the Zing 30 day free trial you might still need to acquire the license. For that continue in step 2 (License Zing) as documented in Zing Quick Start Guide.

Afterwards, run the following commands to verify that ZST is completely installed and Zing is working:

# sudo service zing-memory status
# /opt/zing/zing-jdk8/bin/java -version

On later kernel updates triggered by rpm or yum, the dkms-based ZST will the be rebuild automatically and no user interaction is necessary.

If for some reason, the dkms-based ZST has to be rebuild and reinstalled manually, please use the following commands, but replace the version numbers according to your system:

# sudo dkms status
zing_mm, 5.16.0.0-3, 4.4.0-53-generic, x86_64: installed
zing_mm, 5.16.0.0-3, 4.4.0-59-generic, x86_64: installed
# sudo dkms build zing_mm/5.16.0.0-3
# sudo dkms install zing_mm/5.16.0.0-3

In case the EPEL mirrors cannot be reached on later upgrades, please reinstall the EPEL.rpm to receive the updated mirrors list:

# sudo curl -O https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
# sudo yum reinstall epel-release-latest-7.noarch.rpm


This page describes the installation using DKMS when Zing was installed from the Azul software repository as described in http://docs.azul.com/zing/index.htm#InstallZing.htm or during the Zing 30 day free trial from http://docs.azul.com/zing/zing-quick-start.htm.

For the installation of the licensed version of Zing on those systems, please visit instead Instructions for DKMS with Zing manually downloaded.

Add Comment

Comments

0 comments

Please sign in to leave a comment.

Was this article helpful?
0 out of 0 found this helpful