Visit Azul.com Support

Get Started with Azul Platform Prime on YUM Systems

Table of Contents
Need help?
Schedule a consultation with an Azul performance expert.
Contact Us
Looking for Zing?
The Azul Zing Virtual Machine is now Azul Zulu Prime Builds of OpenJDK and part of Azul Platform Prime.
Learn more
Note
 Need a different Linux distro? Go back to Azul Platform Prime Downloads.

These instructions guide you through the Azul Platform Prime installation using the yum package manager on these operating systems:

  • Amazon Linux

  • Oracle

  • CentOS 7 / RHEL

  • CentOS Stream

  • SLES 12

Installing a Stream Build via Linux Package

Stream Builds are produced once a month, do not receive any security backports, and are free for development and evaluation. By downloading Stream Builds, you agree to the Azul Platform Prime Evaluation Agreement. For more information, see the Azul Platform Prime Roadmap.

The following examples contain the commands to install JDK 17 for each platform, see Version Mapping for other versions.

Amazon Linux

 
sudo rpm --import https://repos.azul.com/azul-repo.key
sudo curl -o /etc/yum.repos.d/zing.repo https://repos.azul.com/zing/amazonlinux/zing.repo
sudo yum install zing-jdk<version-number>

Oracle

 
sudo rpm --import https://repos.azul.com/azul-repo.key
sudo curl -o /etc/yum.repos.d/zing.repo https://repos.azul.com/zing/oracle/zing.repo
sudo yum install zing-jdk<version-number>

CentOS 7 / RHEL

 
sudo rpm --import https://repos.azul.com/azul-repo.key
sudo curl -o /etc/yum.repos.d/zing.repo https://repos.azul.com/zing/rhel/zing.repo
sudo yum install zing-jdk<version-number>

CentOS Stream

 
sudo rpm --import https://repos.azul.com/azul-repo.key
sudo curl -o /etc/yum.repos.d/zing.repo https://repos.azul.com/zing/stream/zing.repo
sudo yum install zing-jdk<version-number>

SLES 12 x86_64

 
sudo rpm --import https://repos.azul.com/azul-repo.key
sudo zypper addrepo https://repos.azul.com/zing/sles/12/x86_64 zing
sudo zypper install zing-jdk<version-number>

# For SLES 12 only, increase the limit for virtual memory usage
sudo ulimit -v unlimited

SLES 12 aarch64

 
sudo rpm --import https://repos.azul.com/azul-repo.key
sudo zypper addrepo https://repos.azul.com/zing/sles/12/aarch64 zing
sudo zypper install zing-jdk<version-number>

# For SLES 12 only, increase the limit for virtual memory usage
sudo ulimit -v unlimited

Version mapping

Use the following mappings to specify the JDK version:

JDK Version Version string

JDK 8 x86

1.8.0

JDK 8 arm64

8.0.0

JDK 11

11.0.0

JDK 13

13.0.0

JDK 15

15.0.0

JDK 17

17.0.0

JDK 21

21.0.0

Installing a Downloaded Stable Build

Stable Builds require a license for use, contain only critical fix backports, and are produced on an ongoing basis.

  1. Download the build from the Azul Platform Prime Customer Downloads page.

  2. Import Azul’s public key:

     
    sudo rpm --import https://repos.azul.com/azul-repo.key

  3. Run the following command on the downloaded file.

     
    $ sudo yum localinstall <yum-installation-file>

    For SLES 12, run this command:

     
    $ sudo zypper install <yum-installation-file>

    The <yum-installation-file> name has the following format:

    zing<zulu_prime_version>-jdk<version>-<architecture>.rpm

    For example:

    zing22.08.301.0-1-jdk17.0.5.0.101-linux.x86_64.rpm

Installing a Downloaded Stream Build

Stream Builds are available for development and trial use and include the latest major features. Stream builds are released regularly on a monthly basis.

  1. Download the build from the Azul JDK Downloads page.

  2. Run the following command on the downloaded file.

     
    $ sudo yum localinstall <yum-installation-file>

    For SLES 12, run this command:

     
    $ sudo zypper install <yum-installation-file>

    The <yum-installation-file> name has the following format:

    zing<zulu_prime_version>-jdk<version>-<architecture>.rpm

    For example:

    zing23.01.0.0-3-jdk17.0.6-linux.x86_64.rpm

Running Azul Platform Prime

Once you’ve performed all installation steps, you can start running your Java applications with Azul Platform Prime as follows:

  1. Verify the Java version:

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

    Sample output for Java 8:

     
    java version "1.8.0-zing_19.07.0.0"
Zing Runtime Environment for Java Applications (build 1.8.0-zing_19.07.0.0-b3)
Zing 64-Bit Tiered VM (build 1.8.0-zing_19.07.0.0-b4-product-linux-X86_64, mixed mode)

    You may want to set the JAVA_HOME environment variable to point to the Azul Platform Prime installation directory, e.g. $ export JAVA_HOME=/opt/zing/zing-<jdk-version>.

What to do next

Read more about: