Visit Azul.com Support

Upgrading Azul Zulu Prime System Tools

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
The instructions below are applicable only if Azul Zulu Prime System Tools (ZST) is installed on the system. These do not apply if Azul Zulu Prime Builds of OpenJDK (Azul Zulu Prime JVM) was installed using a tarball and being used without the ZST.

To switch to a newer kernel within a major release of a particular OS, you do not need to upgrade your ZST installation if a kernel version is supported by a major release of ZST. With ZST 5.20.5 and higher, the newer kernel is enabled seamlessly once installed on your system.

You need to upgrade your ZST in case the kernel version is not supported.

Sample message:

 
zing-memory: INFO: Starting... /usr/lib/zing/bin/tar: zm.o_3.10.0-514.55.4.el7.x86_64: Not found in archive /usr/lib/zing/bin/tar: zm_linux.o_3.10.0-514.55.4.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-514.55.4.el7.x86_64 is unavailable. Please upgrade ZST.

For any other ZST upgrade cases, use the appropriate Linux packaging upgrade command.

  1. Login to your system as root.

  2. Download the latest ZST .rpm or .deb file.

  3. Ensure there are no running processes using Zing Memory. All currently-running Azul Zulu Prime JVM instances must be terminated before attempting to upgrade ZST. If this is not done, the upgrade and/or memory preallocation might fail or result in incorrect configuration.

     
    $ zing-ps

    See Using the zing-ps Tool.

  4. Identify the installed Azul Zulu Prime JVM packages.

    • For RHEL or SLES:

       
      $ rpm -qa|grep zing

      Sample response:

       
      zing-zst-5e.2.6.32-5.7.0.0.28.el6.x86_64
    • For Ubuntu:

       
      $ dpkg -l|grep zing

      Sample response:

       
      zing-zst_5e.3.2.0.x86.64-generic-5.7.0.0.28
  5. Run the upgrade command on your ZST package:

    • For RHEL:

       
      $ rpm -Uvh <packagename>
    • For SLES:

       
      $ zypper install <packagename>
    • For Ubuntu:

       
      $ dpkg -i <package name>

There is no direct upgrade path for ZST using read only ZST images. You must uninstall the existing ZST read only image and install and configure the new ZST read only image.