Visit Azul.com Support

Uninstalling Azul Zulu Prime System Tools

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.

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 JVM was installed using a tarball and being used without ZST.

Uninstalling ZST removes all the ZST elements, which includes the following:

  • Zing Memory

  • zing-ps

To uninstall ZST:

  1. Login to your system as root.

  2. Ensure there are no running processes using Zing Memory, type:

     $ zing-ps 
  3. Identify the installed Azul Zulu Prime JVM packages.

    • For RHEL or SLES:

       $ rpm -qa|grep zing 
    • For Ubuntu:

       $ dpkg -l|grep zing 

      Sample response:

       zng-zst-5e.2.6.32-5.7.2.0.10.el6.x86_64
      zing-jdk1.7.0-5.8.0.0-13.x86_64 
  4. Uninstall ZST. Run the appropriate remove or delete command.

    • For RHEL:

       $ yum remove zing-zst-<version> 
    • For SLES:

       $ zypper remove zing-zst-<version> 
  5. For Ubuntu:

     $ dpkg -P zing-zst-<version> 

    This completes the ZST uninstallation.

Uninstalling the ZST from a ZST Node

Uninstalling ZST removes the ZST elements from the ZST node. To uninstall ZST:

  1. Login to your system as root.

  2. Shutdown all the Azul Zulu Prime JVM Java processes.

  3. Ensure there are no running processes using Zing Memory, type:

     $ zing-ps 
  4. Run the shutdown script, zing-zst.shutdown, and confirm at the prompt. For example, including the optional -r option.

     $ /azul/zing_node/zst/scripts/zing-zst.shutdown -r 

    The system responds:

     Uninstalling ZST from the system...
    Do you want to continue? (yes or no) y
    Restoring core pattern
    Removing zing-licensed
    zing-licensed: INFO: Stopping...26109
    zing-licensed: INFO: stop successful
    Removing zing-memory
    zing-httpd: INFO: Stopping...
    zing-httpd: INFO: stop successful
    zing-certd: INFO: Stopping...
    zing-certd: INFO: stop successful
    zing-memory: INFO: Stopping...
    zing-memory: INFO: stop successful
    Removing directories
    Keeping /var/log/zing-httpd, directory is not empty
    Removing ZST Kernel Object
    Removing symlinks
    Removing user and groups created for ZST
    Removing /etc/zing
    Uninstallation complete! 

    If you had enabled zing-core-pattern, the zing-zst.shutdown command restores your original core pattern. The zing-zst.shutdown command has the following options:

    Command-Line Option Description

    -h

    Displays help text.

    -r, --remove-etc-zing-folder

    Removes the /etc/zing folder.

    --batch-mode

    Uninstalls ZST without user interaction. Use it to avoid any confirmation questions during the uninstall procedure.

  5. Unmount the Azul Zulu Prime JVM server read-only directory from the local ZST node.

     # umount -l <zst_node_dir> 

    For example:

     # umount -l /azul/zing_node/zst 

    This command unmounts the local ZST node directory.

  6. Optionally, remove the Azul Zulu Prime JVM log file directory. The /var/log/zing-httpd directory contains log files. If you want to remove those files as well, remove the directory manually.

Uninstalling the ZST from the Azul Zulu Prime JVM Server

Uninstalling ZST removes all the ZST elements, this includes the following:

  • Zing Memory

  • zing-ps

To uninstall ZST:

  1. Uninstall ZST from all the ZST nodes. See the Uninstalling the ZST from a ZST Node section.

  2. Login to your Azul Zulu Prime JVM server as root.

  3. Ensure there are no running processes using Zing Memory, type:

     $ zing-ps 
  4. Uninstall ZST from the Azul Zulu Prime JVM server. Run the remove command.

     $ yum remove zing-zst-<version>
    [source, shell,opts="user,check"] 

This completes the ZST uninstallation.