Visit Azul.com Support

Get Started with Azul Platform Prime on YUM Systems

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.

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

  • RHEL/CentOS

  • SLES 11 and 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, testing, and evaluation. By downloading Stream Builds, you agree to the Azul Platform Prime Evaluation Agreement. For more information, see the Azul Platform Prime Roadmap.

  1. Import Azul’s public key:

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

  2. Attach the Yum repository:

     
    sudo curl -o /etc/yum.repos.d/zing.repo https://repos.azul.com/zing/<OS-PLACEHOLDER>/zing.repo

    The Yum repository is slightly different for the different operating systems supported by Prime. Replace the <OS-PLACEHOLDER> string in the command line curl command with the appropriate mapping string:

    Operating System OS Placeholder Mapping

    Amazon Linux

    amazonlinux

    Oracle

    oracle

    RHEL/CentOS

    rhel

    SLES 11 and 12

    See separate instructions below.

    The SUSE command is slightly different from the other YUM repository commands.

    For SLES 11, use the following command:

     
    sudo zypper addrepo https://repos.azul.com/zing/sles/11 zing

    For SLES 12, use the following command:

     
    sudo zypper addrepo https://repos.azul.com/zing/sles/12 zing

  3. Run the following command to install Azul Platform Prime:

     
    sudo yum install zing-<JDK-VERSION>

    For SLES 11 and 12, use this command to install Platform Prime:

     
    sudo zypper install zing-<JDK-VERSION>

    Use the following mappings to specify the JDK version:

    JDK Version JDK Version Mapping

    JDK 8

    jdk1.8.0

    JDK 11

    jdk11.0.0

    JDK 13

    jdk13.0.0

    JDK 15

    jdk15.0.0

    JDK 17

    jdk17.0.0

  4. Increase the limit for virtual memory usage (for SLES 11 and 12 only):

     
    sudo ulimit -v unlimited

Installing a Downloaded Stable Build

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

  1. Download the build from Customer Downloads.

  2. Run the following command on the downloaded file.

     
    sudo yum localinstall <yum-installation-file>

    For SLES 11 and 12, run this command:

     
    sudo zypper --no-gpg-checks install <yum-installation-file>

The <yum-installation-file> name has the following format: zing<zulu_prime_version>-jdk<version>.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>.