Visit Support

Installation Issues

Need help?
Schedule a consultation with an Azul performance expert.
Contact Us

If you received an error or warning message during Azul Zing Builds of OpenJDK (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:

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 Azul Zing Builds of OpenJDK 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 Azul Zing Builds of OpenJDK System Requirements document for more details.

Cannot attach an APT repository


You cannot attach 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 Azul Platform Prime on Debian and Amazon Linux


Failed to install Azul Platform Prime 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.

Zing and ZST Compatibility Issue


Zing stops during startup in case of incompatible Zing 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 xref:ZST-Compatibility.adoc['System Requirements guide'] for more information.


Review the Azul Platform Prime Component Version Compatibility Reference and install an appropriate Azul Platform Prime 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 or /lib/modules/2.6.32-71.el6.x86_64/source


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.

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 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 Zing or higher. See Azul Zing System Tools Libraries Retirement from Containers for details.