Back to Zing Documentation Home

Installing Zing System Tools Using DKMS

This guide describes how to install ZST using the Dynamic Kernel Module Support (DKMS) framework. Use the ZST DKMS package if a ZST package is not yet available for the Linux kernel version of your system on Software Downloads and Documents.

Note

This information is intended for advanced users only.

While this feature is tested and validated for a selected set of operating system versions, there are always risks. Test thoroughly in your staging environment before going into production.

If you are installing on RHEL 8.x/7.x/6.x, Oracle Linux 7.x/6.x, SLES 12 SP4/SP3/SP2, Ubuntu 20.04/18.04/16.04 kernels, use the standard ZST installation packages.

To install Zing using DKMS, perform the steps listed below.

Complete Prerequisites

  1. Locate and install the kernel headers that match the kernel version that will be running the ZST. Install the DKMS package appropriate for your target operating system.

    DKMS is already included in Amazon Linux, Amazon Linux 2, Ubuntu, and Debian but not directly provided by CentOS, RHEL, SLES, Oracle Linux. For those systems, it can be installed from the Fedora EPEL repository. See also Using DKMS on RHEL, CentOS, or Oracle Linux to build ZST for other kernel versions.

  2. Run the commands as root or use sudo.
System Commands to Install Packages

RHEL, CentOS, Oracle Linux (Non-UEK Kernels), and Amazon Linux

# yum install kernel-devel-$(uname -r) dkms

SLES

# zypper install kernel-default-devel-$(uname ‑r) dkms

Oracle Linux (UEK Kernels)

# yum install kernel-uek-devel-$(uname -r) dkms

Ubuntu and Debian

# apt-get install linux-headers-$(uname ‑r) dkms

  1. Depending upon the operating system the required packages include:

    • OpenSSL 0.9.8 or later
    • binutils required to ensure that any core files, generated when a ZVM instance fails abnormally, include the shared libraries that were in use at the time

Install Zing System Tools

The ZST installation package contains a kernel loadable module and supporting scripts and tools.

To install ZST:

  1. Ensure that you have access to https://www.azul.com/software-downloads-and-documents/ to download Zing packages (contact [email protected] to obtain the required credentials).

  2. Login to your system as root or sudo.

  1. Download and install the ZST package.
  1. To install ZST, use the command appropriate for your system:
System Commands to Install Packages

RHEL, Centos, Oracle Linux, and Amazon Linux

# rpm -ivh zing-zst-<zst-api-version>.dkms-<zst_version>.<platform>.rpm

For example:

# rpm -ivh zing-zst-8b.dkms.2.6.32-5.22.5.0.4.el.x86_64.rpm

SLES

# zypper install <zst-api-version>.dkms-<zst_version>.<platform>.rpm

For example:

# sudo zypper install zing-zst-8b.dkms.2.6.32-5.22.5.0.4.sles11.86_64.rpm

Ubuntu and Debian

# dpkg -i zing-zst_<zst-api-version>.dkms-<zst_version>.<platform>.deb

For example:

# sudo dpkg -i zing-zst_8b.dkms.3.2.0.x86.64-server-5.22.5.0.4_amd64.deb

A sample system response is shown below:

Preparing...                          ################################# [100%]
Updating / installing...
1:zing-zst-8b.dkms.2.6.32-5.22.5.0.################################# [100%]

Creating symlink /var/lib/dkms/zing_mm/5.22.5.0-4/source ->
/usr/src/zing_mm-5.22.5.0-4

DKMS: add completed.

Kernel preparation unnecessary for this kernel.  Skipping...

Building module:
cleaning build area...
make -j24 KERNELRELEASE=3.10.0-957.27.2.el7.x86_64 KERNELDIR=/lib/modules/3.10.0-957.27.2.el7.x86_64/build DKMS=1 INTERNAL_BUILD_NAME=zst-5.22.5.0 BUILD_SUFFIX= BUILD_NUMBER=4.....
cleaning build area...

DKMS: build completed.

zing_mm.ko.xz:
Running module version sanity check.
- Original module
- No original module exists within this kernel
- Installation
- Installing to /lib/modules/3.10.0-957.27.2.el7.x86_64/extra/
Adding any weak-modules

depmod....

DKMS: install completed.
zing-memory: INFO: Restarting...
zing-memory: INFO: Stopping...
zing-memory: INFO: stop successful
zing-memory: INFO: Starting...
INFO: Zing Memory reserved using reserve-at-launch policy
INFO: az_pmem_set_device_limit to 500034437120 bytes succeeded
INFO: az_pmem_set_overall_device_limit to 243259146240 bytes succeeded
INFO: az_pmem_fund_limit_transfer (to 7, from 0, bytes 500034437120) succeeded
INFO: az_pmem_fund_limit_transfer (to 1, from 7, bytes 135144669184) succeeded
INFO: az_pmem_fund_limit_transfer (to 3, from 7, bytes 135144669184) succeeded
INFO: az_pmem_fund_limit_transfer (to 0, from 7, bytes 229745098752) succeeded
INFO: Set ContingencyMinimumFreeMemory to 209715200
INFO: Successfully set fund MinimumFreeMemory
INFO: Set PausePreventionMinimumFreeMemory to 209715200
INFO: Successfully set fund MinimumFreeMemory
INFO: Set PausePreventionMinimumFreeMemory to 209715200
INFO: Successfully set fund MinimumFreeMemory
INFO:  You can now run Java processes up to -Xmx219102m or -Xmx213g.
INFO:  Azul pmem initialized successfully.
zing-memory: INFO: start successful
zing-memory: INFO: restart successful

Once you performed all the mentioned steps, you can Install Zing Virtual Machine and Verify Installation.

 

 

 

See Also


© Azul Systems, Inc. 2020 All rights reserved.

Privacy Policy | Legal | Terms of Use