Back to Zing Documentation Home

Zing Installation Issues

If you received an error or warning message during Zing installation or configuration, inspect the message and complete the steps listed for your operating system. In addition, you might want to study the following typical issues and the corresponding solutions:

Error Description Solution
Permissions Denied Error


/usr/bin/ld: Permission denied


ZST installation requires access to /usr/bin/ld. Ensure acceptable permissions are set. For example:

# chmod 755 /usr/bin/ld

Operating System is not supported


You cannot find a Zing Installation for your target operating system.


1. Consult the list of the supported operating systems and environments in the Zing System Requirements document.

2. Сontact [email protected] for any related questions.

Conflict with settings configured for other JVMs

Zing use on machines where there are other installed JVMs that have overlaps in environment and path settings leads to unwanted behaviors.

Ensure your PATH and JAVA_HOME variables are set accurately in the shell or context of your runtime application.

Ensure you have the proper Zing architecture for your OS and kernel. Using incorrect processor type or bitness may fail to operate at all.

See the Zing System Requirements document for more details.

Cannot Apply Zing Trial Keyfiles


You've downloaded Zing and obtained a keyfile from Azul. Now what?


The simplest step is pasting your keyfile into a folder created during Zing installation:

Copy the license file, license, to the /etc/zing/ directory of your target host.

If you want to use any other file location, then you must add -XX:ZingLicenseFile=<filename> to your ZVM instance launch command.

Licenses allow ZVM instance launches up to the end of the day they are due to expire within the local timezone specified in the keyfile.

Free trial keys last 21 days from the time of download (not the time of installation).

To extend your trial after expiry, and request a keyfile renewal, please contact [email protected].

Cannot fetch the license key


Failed to fetch the license key file because the target system does not have wget.


Сontact [email protected] to get a keyfile directly from Azul.

Cannot attach an APT repository


You cannot attache an APT repository, because $(lsb_release -sc) command does not work in your system:

$ sudo apt-add-repository "deb $(lsb_release -sc) main"


Use any of Ubuntu release name constants, such as "xenial", "trusty", or "precise". For example:

$ sudo apt-add-repository "deb trusty main"

Problems with installing Zing on Debian and Amazon Linux


Failed to install Zing on Debian and Amazon Linux when Linux headers are not present.


1. Install Linux Headers.

For Debian, run the following command:

apt-get install linux-headers-$(uname -r)

For Amazon Linux, run:

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

dkms build -m zing_mm -v <zst-version>

dkms install -m zing_mm -v <zst-version>

2. Run the system-config-zing-memory command, once the Linux headers are installed.

ZVM and ZST Compatibility Issue


ZVM stops during startup in case of incompatible ZVM and ZST versions.

Sample Message:

$ /usr/bin/java -version

Error occurred during initialization of VM

Zing VM Error: This Zing VM requires ZST 5.15 or later.

Zing VM Error: Found zst version: 'zst-'.

Zing VM Error: See 'System Requirements guide' for more information.


Review the Zing Component Version Compatibility Reference and install an appropriate Zing component.

Kernel Mismatch on a DKMS RHEL, SLES, or Ubuntu Systems


Error! Your kernel headers for kernel <kernel version> cannot be found at

/lib/modules/<kernel version>/build



Run the following commands to fix the error:


sudo yum install kernel-devel-2.6.32-71.el6.x86_64

sudo dkms build -m zing_mm -v

sudo dkms install -m zing_mm -v


sudo zypper install kernel-devel-3.0.101-0.35-default

sudo dkms build -m zing_mm -v

sudo dkms install -m zing_mm -v

For Ubuntu:

apt-get install kernel-devel-$(uname -r)

Once you resolve the errors listed in the error message, run system-config-zing-memory.

zing-obtain-trial-license fails with openssl 1.1.

When running

sudo zing-obtain-trial-license -f -p TrialLicensePasscode

you may get the following error message:

URLError = [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed

You have to install a separate package "ca-certificates":

sudo apt-get install ca-certificates

Zing ZST support for kernel version is unavailable


What if the kernel I am running on is not listed in the supported kernel list at

Sample error message :

/usr/lib/zing/bin/tar: zm.o_3.10.0-862.25.3.el7.x86_64: Not found in archive

/usr/lib/zing/bin/tar: zm_linux.o_3.10.0-862.25.3.el7.x86_64: Not found in archive

/usr/lib/zing/bin/tar: Exiting with failure status due to previous errors

zing-memory: INFO: Zing ZST support for kernel 3.10.0-862.25.3.el7.x86_64 is unavailable. Please upgrade ZST.

Fatal error: os::safeSystem: command '/etc/init.d/zing-memory restart' failed.


In most cases, the latest Feature and Update releases of ZST have support for required kernels.

The latest release of ZST may happen to miss support for a kernel and display the error message if the kernel is:

  • a custom kernel
  • a part of the Extended Update Support (EUS) Subscription
  • no longer available in the target OS repository

File a bug and Azul team will do their best to add support for the kernel you need.

Please install ZST (Zing System Tools) Error


Zing VM Error: DLERROR: cannot open shared object file: No such file or directory

Zing VM Error: Please install ZST (Zing System Tools)

Use ZVM or higher. See Zing System Tools Libraries Retirement from Containers for details.

If you cannot find any workaround or need additional assistance, contact [email protected].

© Azul Systems, Inc. 2020 All rights reserved.

Privacy Policy | Legal | Terms of Use