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.