Visit Azul.com Support

Azul Zulu Prime Builds of OpenJDK Installation Instructions

Table of Contents

Looking for Zing? The Azul Zing Virtual Machine is now Azul Zulu Prime Builds of OpenJDK and part of Azul Platform Prime. Learn more.

For system requirements and maximum heap size, see Azul Platform Prime System Requirements. Our software distributions are signed by an OpenPGP key when appropriate. To verify your download, see Product Signing Keys (OpenPGP) for details.

Installing Azul Zulu Prime Builds of OpenJDK

Once you have downloaded the Azul Zulu Prime Builds of OpenJDK (Azul Zulu Prime JVM) installation package, run an installation command appropriate for your operating system to install Azul Platform Prime in the default mode:

  • RHEL, CentOS, Oracle Linux, Amazon Linux

     sudo yum localinstall --nogpgcheck zing<zulu_prime_version>-jdk<version>.rpm 
  • SLES

     sudo zypper --no-gpg-checks install zing<zulu_prime_version>-jdk<version>.rpm 
  • Ubuntu, Debian

     sudo dpkg -i zing<zulu_prime_version>-jdk<version>.deb 
  • Any

     tar xzf zing<zulu_prime_version>-jdk<version>.tar.gz 
  • Any

     ./zing<zulu_prime_version>-jdk<version>.sh 

Start Using Azul Platform Prime

After the Azul Platform Prime is installed, verify the completed installation.

Run a simple Java command, e.g., type:

 $ <zulu_prime_java_installation_directory>/bin/java -version 

where <zulu_prime_java_installation_directory> is the directory where the Azul Zulu Prime JVM is installed, for example:

 $ /opt/zing/zing<zulu_prime_version>-jdk<version>/bin/java -version 

A sample system output should look similar to the following:

 java version "1.8.0_282"
Java Runtime Environment (Zing 21.02.0.0-b3-CA-linux64) (build 1.8.0_282-b3)
Zing 64-Bit Tiered VM (Zing 21.02.0.0-b3-CA-linux64) (build 1.8.0_282-zing_21.02.0.0-b4-product-linux-X86_64, mixed mode) 
Note
Azul Zulu Prime System Tools (ZST) are needed for the following situations or requirements:
  • Heap size (-Xmx) larger than 2500 GBytes. With ZST, Azul Platform Prime supports up to 20 TB (20,000 GB).

  • Static memory reservation for Java heaps at system start.

  • OS versions older than listed in the Azul Zulu Prime JVM Operating System Requirements. See Installing the Azul Zulu Prime System Tools for instructions on how to install the ZST component.

Post Installation Tasks

The following post-installation steps are not directly required when starting to use Azul Zulu Prime JVM, but it is recommended to go through them to avoid later problems in production systems.

Transferring JDK Customizations

If you have applied customizations to the existing non-Azul Zulu Prime JVM installation location, you might need to transfer those to the Azul Zulu Prime JVM.

Those customizations can be, for example, JAR files added to the directory $JAVA_HOME/jre/lib/ext or changes in the security settings below $JAVA_HOME/jre/lib/security. Azul Zulu Prime JVM offers the same directories to store custom JARs and security policies.

Ensuring Sufficient Virtual Memory Areas

Depending on the application activity and its Java object sizes, Azul Zulu Prime JVM requires a larger number of virtual memory areas (VMAs) than the Linux default of 65530. Most applications on Azul Zulu Prime JVM won’t need a change here, but to be on the safe side, set the upper limit to four times the system RAM size in MBytes. vm.max_map_count Linux system parameter defines this limit.

To keep the configuration simple when managing multiple hosts, set it on all hosts to the same value as setting it too large doesn’t cause any harm. A value of 1,000,000 (one million) is recommended for systems with a RAM size of up to 256 GBytes. To set the recommended value, complete the following steps:

  1. Add the following line to the file /etc/sysctl.conf:

     vm.max_map_count=1000000 
  2. To activate the setting without reboot, run:

     sudo sysctl -p 
  3. To check the setting on any system, type:

     cat /proc/sys/vm/max_map_count