This page describes a solution intended for use only if you run into problems with newest kernel versions, like developer versions, when following our standard documentation for Zing Trial installations on RHEL, CentOS and Oracle Linux available at http://docs.azul.com/zing/zing-quick-start.htm.
For the installation of the licensed version of Zing on those systems, please visit Using DKMS on RHEL, CentOS or Oracle Linux to build ZST for other kernel versions.
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.
Zing includes a Linux Kernel Module (ZST) for its memory management. As Linux kernel modules need to be built for a specific kernel version, you might run into the following problem when installing Zing on a newer Kernel version than it was available during the release of the installed Zing version:
# /opt/zing/zing-jdk8/bin/java -version
Error occurred during initialization of VM
Error: The Zing memory driver has not been configured yet.
Error: Please run 'system-config-zing-memory' as root.
Error: See 'man zing-installation' for more information.
# 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)
The solution now is to use the Zing ZST package for DKMS. DKMS (Dynamic Kernel Module Support) will automatically build the kernel module on your system during first install and also for each update of the kernel package in the future.
DKMS is already included in Ubuntu, SLES and Debian but not directly provided by CentOS, RHEL and Oracle Linux. For those systems it should be installed from the Fedora EPEL repository as described below. The first line uninstalls the non-DKMS Zing ZST package in case it was already installed before and failed with the error shown above. 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.
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.
# yum remove zing-zst
# yum install yum-utils "kernel-devel-uname-r == $(uname -r)"
# curl -O https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
# curl -o /etc/yum.repos.d/zing.repo http://repos.azul.com/zing/amazonlinux/zing.repo
# yum clean metadata dbcache
# yum install epel-release-latest-7.noarch.rpm
# yum-config-manager --disable epel
# yum --enablerepo=epel install dkms
# yum install zing-zst zing-jdk1.8.0
Afterwards, please continue with step 3 (Run Zing) as documented in Zing Quick Start Guide.
On later kernel updates triggered by rpm or yum, the dkms-based ZST will be rebuild automatically.
If for some reason, the dkms-based ZST has to be rebuild and reinstalled manually, please use the following commands:
# dkms status
zing_mm, 22.214.171.124-3, 4.4.0-53-generic, x86_64: installed
zing_mm, 126.96.36.199-3, 4.4.0-59-generic, x86_64: installed
# dkms build zing_mm/188.8.131.52-3
# dkms install zing_mm/184.108.40.206-3
In case the Fedora EPEL mirrors cannot be reached on later upgrades, please reinstall the EPEL.rpm to receive the updated mirrors list:
curl -O https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
yum reinstall epel-release-latest-7.noarch.rpm
This page describes the installation using DKMS for Zing Trial only on RHEL, CentOS and Oracle Linux on newest kernel versions like developer kernels. For the installation of the licensed version of Zing using DKMS on those systems, please visit Using DKMS on RHEL, CentOS or Oracle Linux to build ZST for other kernel versions.