Visit Azul.com 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

Message:

/usr/bin/ld: Permission denied

Action:

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

Issue:

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

Action:

  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

Issue:

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

Actions:

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

Issue:

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

 
sudo apt-add-repository "deb \http://repos.azul.com/zing/ubuntu $(lsb_release -sc) main"

Actions:

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

 
sudo apt-add-repository "deb \http://repos.azul.com/zing/ubuntu trusty main"
Problems with installing Azul Platform Prime on Debian and Amazon Linux

Issue:

Failed to install Azul Platform Prime on Debian and Amazon Linux when Linux headers are not present.

Actions:

  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

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-5.14.0.0-4'. Zing VM Error: See xref:ZST-Compatibility.adoc['System Requirements guide'] for more information.

Action:

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

Message:

 
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

Action:

Run the following commands to fix the error:

For RHEL:

 
sudo yum install kernel-devel-2.6.32-71.el6.x86_64 sudo dkms build -m zing_mm -v 99.99.99.99-712 sudo dkms install -m zing_mm -v 99.99.99.99-712

For SLES:

 
sudo zypper install kernel-devel-3.0.101-0.35-default sudo dkms build -m zing_mm -v 5.7.7.0-10 sudo dkms install -m zing_mm -v 5.7.7.0-10

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

Question:

What if the kernel I am running on is not listed in the supported kernel list at https://www.azul.com/software-downloads-and-documents/?

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.

Actions:

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

Message:

 
Zing VM Error: DLERROR: libaznix.so: cannot open shared object file: No such file or directory Zing VM Error: Please install ZST (Zing System Tools)

Actions:

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